@gusto/embedded-react-sdk 0.50.0 → 0.51.2

package/dist/components/Employee/Profile/shared/useEmployeeDetailsForm/useEmployeeDetailsForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useEmployeeDetailsForm.js","sources":["../../../../../../src/components/Employee/Profile/shared/useEmployeeDetailsForm/useEmployeeDetailsForm.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { useForm } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Employee } from '@gusto/embedded-api-v-2025-11-15/models/components/employee'\nimport { useEmployeesGet } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesGet'\nimport { useEmployeesCreateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesCreate'\nimport { useEmployeesUpdateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesUpdate'\nimport { useEmployeesUpdateOnboardingStatusMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesUpdateOnboardingStatus'\nimport { RFCDate } from '@gusto/embedded-api-v-2025-11-15/types/rfcdate'\nimport {\n  createEmployeeDetailsSchema,\n  type EmployeeDetailsOptionalFieldsToRequire,\n  type EmployeeDetailsFormData,\n  type EmployeeDetailsFormOutputs,\n} from './employeeDetailsSchema'\nimport {\n  FirstNameField,\n  MiddleInitialField,\n  LastNameField,\n  EmailField,\n  DateOfBirthField,\n  SsnField,\n  SelfOnboardingField,\n} from './fields'\nimport { normalizeToISOString } from '@/helpers/dateFormatting'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { EmployeeOnboardingStatus } from '@/shared/constants'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { removeNonDigits } from '@/helpers/formattedStrings'\n\nexport type { EmployeeDetailsOptionalFieldsToRequire } from './employeeDetailsSchema'\n\n/**\n * Optional callbacks passed to {@link UseEmployeeDetailsFormReady.actions.onSubmit | onSubmit}.\n *\n * @remarks\n * Only the callback matching the submit mode fires —\n * `onEmployeeCreated` on create, `onEmployeeUpdated` on update.\n * `onOnboardingStatusUpdated` fires when toggling the self-onboarding\n * switch changes the employee's onboarding status as part of an update.\n *\n * @public\n * @group Utility Types\n */\nexport interface EmployeeDetailsSubmitCallbacks {\n  /** Fired after a new employee is successfully created. */\n  onEmployeeCreated?: (employee: Employee) => void\n  /** Fired after an existing employee is successfully updated. */\n  onEmployeeUpdated?: (employee: Employee) => void\n  /** Fired when an update toggles self-onboarding and the employee's onboarding status changes. */\n  onOnboardingStatusUpdated?: (status: unknown) => void\n}\n\n/**\n * Shared options merged into both branches of {@link UseEmployeeDetailsFormProps}.\n *\n * @public\n */\nexport type UseEmployeeDetailsFormSharedProps = {\n  /** Whether to expose the self-onboarding toggle as `form.Fields.SelfOnboarding`. Defaults to `true`. */\n  withSelfOnboardingField?: boolean\n  /** Fields that are optional by default but should be promoted to required for this form instance. */\n  optionalFieldsToRequire?: EmployeeDetailsOptionalFieldsToRequire\n  /** Initial values applied before any employee data loads. */\n  defaultValues?: Partial<EmployeeDetailsFormData>\n  /** When validation runs. Forwarded to react-hook-form's `mode`. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Whether react-hook-form should focus the first error on validation failure. Defaults to `true`. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Options for {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Discriminated by mode: in create mode supply `companyId` and omit\n * `employeeId`; in update mode supply `employeeId` (and optionally\n * `companyId`).\n *\n * @public\n * @group Utility Types\n */\nexport type UseEmployeeDetailsFormProps =\n  | (UseEmployeeDetailsFormSharedProps & { companyId: string; employeeId?: never })\n  | (UseEmployeeDetailsFormSharedProps & { employeeId: string; companyId?: string })\n\n/**\n * The Field components exposed by {@link useEmployeeDetailsForm} as `form.Fields`.\n *\n * @remarks\n * Each entry is a component bound to a specific form field. `SelfOnboarding`\n * may be `undefined` when the field is not toggleable.\n *\n * @public\n */\nexport interface EmployeeDetailsFields {\n  /** Text input bound to `firstName`. */\n  FirstName: typeof FirstNameField\n  /** Text input bound to `middleInitial`. */\n  MiddleInitial: typeof MiddleInitialField\n  /** Text input bound to `lastName`. */\n  LastName: typeof LastNameField\n  /** Text input bound to `email`. */\n  Email: typeof EmailField\n  /** Date picker bound to `dateOfBirth`. */\n  DateOfBirth: typeof DateOfBirthField\n  /** Text input bound to `ssn`. */\n  Ssn: typeof SsnField\n  /** Switch bound to `selfOnboarding`, or `undefined` when the field is not toggleable. */\n  SelfOnboarding: typeof SelfOnboardingField | undefined\n}\n\n/**\n * The ready-state result returned by {@link useEmployeeDetailsForm} once data has loaded.\n *\n * @remarks\n * Provides the form's `data` snapshot, pending `status`, submit `actions`,\n * error handling, and the `form.Fields` map.\n *\n * @public\n */\nexport interface UseEmployeeDetailsFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  EmployeeDetailsFormData,\n  EmployeeDetailsFields\n> {\n  /** The loaded employee data, or `null` in create mode. */\n  data: {\n    /** The employee being edited, or `null` in create mode. */\n    employee: Employee | null\n  }\n  /** Submit status and form mode. */\n  status: {\n    /** `true` while the create, update, or onboarding-status mutation is in flight. */\n    isPending: boolean\n    /** `'create'` when no `employeeId` was supplied, `'update'` otherwise. */\n    mode: 'create' | 'update'\n  }\n  /** Submit and related actions. */\n  actions: {\n    /** Validates the form and submits the changes. Returns the created or updated employee, or `undefined` when validation fails. */\n    onSubmit: (\n      callbacks?: EmployeeDetailsSubmitCallbacks,\n    ) => Promise<HookSubmitResult<Employee> | undefined>\n  }\n}\n\nconst isCurrentlySelfOnboarding = (employee?: Employee) => {\n  if (!employee?.onboardingStatus) return false\n  const selfOnboardingStatuses: string[] = [\n    EmployeeOnboardingStatus.SELF_ONBOARDING_PENDING_INVITE,\n    EmployeeOnboardingStatus.SELF_ONBOARDING_INVITED,\n    EmployeeOnboardingStatus.SELF_ONBOARDING_INVITED_STARTED,\n    EmployeeOnboardingStatus.SELF_ONBOARDING_INVITED_OVERDUE,\n    EmployeeOnboardingStatus.SELF_ONBOARDING_COMPLETED_BY_EMPLOYEE,\n    EmployeeOnboardingStatus.SELF_ONBOARDING_AWAITING_ADMIN_REVIEW,\n  ]\n  return selfOnboardingStatuses.includes(employee.onboardingStatus)\n}\n\nconst canToggleSelfOnboarding = (employee?: Employee) => {\n  if (!employee) return true\n  return (\n    employee.onboardingStatus === EmployeeOnboardingStatus.ADMIN_ONBOARDING_INCOMPLETE ||\n    employee.onboardingStatus === EmployeeOnboardingStatus.SELF_ONBOARDING_PENDING_INVITE\n  )\n}\n\n/**\n * Headless hook for creating or updating an employee's profile details — name, email, SSN, date of birth, and self-onboarding preference.\n *\n * @remarks\n * Returns a discriminated union: a loading variant while the underlying\n * employee fetch resolves, and a ready variant exposing the form's data,\n * pending status, submit action, error handling, and bound `Fields`.\n * Self-onboarding is only toggleable when the employee's onboarding status\n * allows it; otherwise `form.Fields.SelfOnboarding` is `undefined`.\n *\n * @param input - See {@link UseEmployeeDetailsFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseEmployeeDetailsFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useEmployeeDetailsForm,\n *   SDKFormProvider,\n *   type UseEmployeeDetailsFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function EmployeeDetailsPage({ companyId, employeeId }: { companyId: string; employeeId?: string }) {\n *   const employeeDetails = useEmployeeDetailsForm({ companyId, employeeId })\n *\n *   if (employeeDetails.isLoading) return <div>Loading...</div>\n *\n *   return <EmployeeDetailsReady employeeDetails={employeeDetails} />\n * }\n *\n * function EmployeeDetailsReady({ employeeDetails }: { employeeDetails: UseEmployeeDetailsFormReady }) {\n *   const { Fields } = employeeDetails.form\n *\n *   const handleSubmit = async () => {\n *     await employeeDetails.actions.onSubmit({\n *       onEmployeeCreated: emp => console.log('Created:', emp.uuid),\n *       onEmployeeUpdated: emp => console.log('Updated:', emp.uuid),\n *     })\n *   }\n *\n *   return (\n *     <SDKFormProvider formHookResult={employeeDetails}>\n *       <form onSubmit={e => { e.preventDefault(); void handleSubmit() }}>\n *         <Fields.FirstName label=\"First name\" />\n *         <Fields.LastName label=\"Last name\" />\n *         <Fields.Email label=\"Personal email\" />\n *         <Fields.DateOfBirth label=\"Date of birth\" />\n *         <Fields.Ssn label=\"Social Security number\" />\n *         <button type=\"submit\" disabled={employeeDetails.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useEmployeeDetailsForm({\n  companyId,\n  employeeId,\n  withSelfOnboardingField = true,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseEmployeeDetailsFormProps): HookLoadingResult | UseEmployeeDetailsFormReady {\n  const employeeQuery = useEmployeesGet({ employeeId: employeeId ?? '' }, { enabled: !!employeeId })\n\n  const employee = employeeQuery.data?.employee\n\n  const isCreateMode = !employeeId\n  const isSelfOnboardingToggleable = canToggleSelfOnboarding(employee)\n\n  const mode = isCreateMode ? 'create' : 'update'\n\n  const [schema, metadataConfig] = useMemo(\n    () => createEmployeeDetailsSchema({ mode, optionalFieldsToRequire, hasSsn: employee?.hasSsn }),\n    [mode, optionalFieldsToRequire, employee?.hasSsn],\n  )\n\n  const resolvedDefaults: EmployeeDetailsFormData = {\n    firstName: employee?.firstName ?? partnerDefaults?.firstName ?? '',\n    middleInitial: employee?.middleInitial ?? partnerDefaults?.middleInitial ?? '',\n    lastName: employee?.lastName ?? partnerDefaults?.lastName ?? '',\n    email: employee?.email ?? partnerDefaults?.email ?? '',\n    dateOfBirth: employee?.dateOfBirth ?? normalizeToISOString(partnerDefaults?.dateOfBirth),\n    ssn: partnerDefaults?.ssn ?? '',\n    selfOnboarding: partnerDefaults?.selfOnboarding ?? isCurrentlySelfOnboarding(employee),\n  }\n\n  const formMethods = useForm<EmployeeDetailsFormData, unknown, EmployeeDetailsFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const createEmployeeMutation = useEmployeesCreateMutation()\n  const updateEmployeeMutation = useEmployeesUpdateMutation()\n  const updateOnboardingStatusMutation = useEmployeesUpdateOnboardingStatusMutation()\n\n  const isPending =\n    createEmployeeMutation.isPending ||\n    updateEmployeeMutation.isPending ||\n    updateOnboardingStatusMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('EmployeeDetailsForm')\n\n  const queries = employeeId ? [employeeQuery] : []\n  const errorHandling = composeErrorHandler(queries, { submitError, setSubmitError })\n\n  const fieldsMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n\n  const onSubmit = async (\n    callbacks?: EmployeeDetailsSubmitCallbacks,\n  ): Promise<HookSubmitResult<Employee> | undefined> => {\n    let submitResult: HookSubmitResult<Employee> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: EmployeeDetailsFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const { selfOnboarding, dateOfBirth, ssn, ...body } = payload\n\n            const cleanedSsn = ssn ? removeNonDigits(ssn) : undefined\n            const hasSsnInput = cleanedSsn && cleanedSsn.length > 0\n\n            let updatedEmployee: Employee\n\n            if (isCreateMode) {\n              if (!companyId) {\n                throw new SDKInternalError('companyId is required to create an employee')\n              }\n              const result = await createEmployeeMutation.mutateAsync({\n                request: {\n                  companyId,\n                  requestBody: {\n                    ...body,\n                    selfOnboarding,\n                    dateOfBirth: dateOfBirth ? new RFCDate(new Date(dateOfBirth)) : undefined,\n                    ssn: hasSsnInput ? cleanedSsn : undefined,\n                  },\n                },\n              })\n\n              if (!result.employee) {\n                throw new SDKInternalError('Employee creation failed')\n              }\n\n              updatedEmployee = result.employee\n              callbacks?.onEmployeeCreated?.(updatedEmployee)\n            } else {\n              if (!employee) {\n                throw new SDKInternalError('Employee data is not available')\n              }\n\n              if (isSelfOnboardingToggleable) {\n                const currentIsSelfOnboarding =\n                  employee.onboardingStatus ===\n                  EmployeeOnboardingStatus.SELF_ONBOARDING_PENDING_INVITE\n\n                if (selfOnboarding !== currentIsSelfOnboarding) {\n                  const { employeeOnboardingStatus } =\n                    await updateOnboardingStatusMutation.mutateAsync({\n                      request: {\n                        employeeId: employee.uuid,\n                        requestBody: {\n                          onboardingStatus: selfOnboarding\n                            ? EmployeeOnboardingStatus.SELF_ONBOARDING_PENDING_INVITE\n                            : EmployeeOnboardingStatus.ADMIN_ONBOARDING_INCOMPLETE,\n                        },\n                      },\n                    })\n\n                  callbacks?.onOnboardingStatusUpdated?.(employeeOnboardingStatus)\n                }\n              }\n\n              const result = await updateEmployeeMutation.mutateAsync({\n                request: {\n                  employeeId: employee.uuid,\n                  requestBody: {\n                    version: employee.version as string,\n                    ...body,\n                    dateOfBirth: dateOfBirth || undefined,\n                    ssn: hasSsnInput ? cleanedSsn : undefined,\n                  },\n                },\n              })\n\n              if (!result.employee) {\n                throw new SDKInternalError('Employee update failed')\n              }\n\n              updatedEmployee = result.employee\n              callbacks?.onEmployeeUpdated?.(updatedEmployee)\n            }\n\n            submitResult = {\n              mode: isCreateMode ? 'create' : 'update',\n              data: updatedEmployee,\n            }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  const isDataLoading = employeeId ? employeeQuery.isLoading : false\n\n  if (isDataLoading || (employeeId && !employee)) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      employee: employee ?? null,\n    },\n    status: {\n      isPending,\n      mode: isCreateMode ? ('create' as const) : ('update' as const),\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        FirstName: FirstNameField,\n        MiddleInitial: MiddleInitialField,\n        LastName: LastNameField,\n        Email: EmailField,\n        DateOfBirth: DateOfBirthField,\n        Ssn: SsnField,\n        SelfOnboarding:\n          withSelfOnboardingField && isSelfOnboardingToggleable ? SelfOnboardingField : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Return type of {@link useEmployeeDetailsForm}.\n *\n * @public\n */\nexport type UseEmployeeDetailsFormResult = HookLoadingResult | UseEmployeeDetailsFormReady\n\n/**\n * Shape of `form.fieldsMetadata` returned by {@link useEmployeeDetailsForm}.\n *\n * @public\n */\nexport type EmployeeDetailsFieldsMetadata = UseEmployeeDetailsFormReady['form']['fieldsMetadata']\n\n/**\n * Shape of `form.Fields` returned by {@link useEmployeeDetailsForm}.\n *\n * @public\n */\nexport type EmployeeDetailsFormFields = UseEmployeeDetailsFormReady['form']['Fields']\n"],"names":["isCurrentlySelfOnboarding","employee","EmployeeOnboardingStatus","canToggleSelfOnboarding","useEmployeeDetailsForm","companyId","employeeId","withSelfOnboardingField","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","employeeQuery","useEmployeesGet","isCreateMode","isSelfOnboardingToggleable","mode","schema","metadataConfig","useMemo","createEmployeeDetailsSchema","resolvedDefaults","normalizeToISOString","formMethods","useForm","zodResolver","createEmployeeMutation","useEmployeesCreateMutation","updateEmployeeMutation","useEmployeesUpdateMutation","updateOnboardingStatusMutation","useEmployeesUpdateOnboardingStatusMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","fieldsMetadata","useDeriveFieldsMetadata","onSubmit","callbacks","submitResult","resolve","data","payload","selfOnboarding","dateOfBirth","ssn","body","cleanedSsn","removeNonDigits","hasSsnInput","updatedEmployee","SDKInternalError","result","RFCDate","currentIsSelfOnboarding","employeeOnboardingStatus","hookFormInternals","useHookFormInternals","FirstNameField","MiddleInitialField","LastNameField","EmailField","DateOfBirthField","SsnField","SelfOnboardingField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"useEmployeeDetailsForm.js","sources":["../../../../../../src/components/Employee/Profile/shared/useEmployeeDetailsForm/useEmployeeDetailsForm.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useMemo } from 'react'\nimport { useForm } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Employee } from '@gusto/embedded-api/models/components/employee'\nimport { useEmployeesGet } from '@gusto/embedded-api/react-query/employeesGet'\nimport { useEmployeesCreateMutation } from '@gusto/embedded-api/react-query/employeesCreate'\nimport { useEmployeesUpdateMutation } from '@gusto/embedded-api/react-query/employeesUpdate'\nimport { useEmployeesUpdateOnboardingStatusMutation } from '@gusto/embedded-api/react-query/employeesUpdateOnboardingStatus'\nimport { RFCDate } from '@gusto/embedded-api/types/rfcdate'\nimport {\n  createEmployeeDetailsSchema,\n  type EmployeeDetailsOptionalFieldsToRequire,\n  type EmployeeDetailsFormData,\n  type EmployeeDetailsFormOutputs,\n} from './employeeDetailsSchema'\nimport {\n  FirstNameField,\n  MiddleInitialField,\n  LastNameField,\n  EmailField,\n  DateOfBirthField,\n  SsnField,\n  SelfOnboardingField,\n} from './fields'\nimport type {\n  FirstNameFieldProps,\n  MiddleInitialFieldProps,\n  LastNameFieldProps,\n  EmailFieldProps,\n  DateOfBirthFieldProps,\n  SsnFieldProps,\n  SelfOnboardingFieldProps,\n} from './fields'\nimport { normalizeToISOString } from '@/helpers/dateFormatting'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldMetadata,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { EmployeeOnboardingStatus } from '@/shared/constants'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { removeNonDigits } from '@/helpers/formattedStrings'\n\nexport type { EmployeeDetailsOptionalFieldsToRequire } from './employeeDetailsSchema'\n\n/** @internal */\nfunction buildEmployeeDetailsFieldsMetadata(\n  base: Record<keyof EmployeeDetailsFormData, FieldMetadata>,\n) {\n  return {\n    firstName: base.firstName,\n    middleInitial: base.middleInitial,\n    lastName: base.lastName,\n    email: base.email,\n    dateOfBirth: base.dateOfBirth,\n    ssn: base.ssn,\n    selfOnboarding: base.selfOnboarding,\n  } satisfies FieldsMetadata\n}\n\n/**\n * Optional callbacks passed to {@link UseEmployeeDetailsFormReady.actions.onSubmit | onSubmit}.\n *\n * @remarks\n * Only the callback matching the submit mode fires —\n * `onEmployeeCreated` on create, `onEmployeeUpdated` on update.\n * `onOnboardingStatusUpdated` fires when toggling the self-onboarding\n * switch changes the employee's onboarding status as part of an update.\n *\n * @public\n * @group Utility types\n */\nexport interface EmployeeDetailsSubmitCallbacks {\n  /** Fired after a new employee is successfully created. */\n  onEmployeeCreated?: (employee: Employee) => void\n  /** Fired after an existing employee is successfully updated. */\n  onEmployeeUpdated?: (employee: Employee) => void\n  /** Fired when an update toggles self-onboarding and the employee's onboarding status changes. */\n  onOnboardingStatusUpdated?: (status: unknown) => void\n}\n\n/**\n * Shared options merged into both branches of {@link UseEmployeeDetailsFormProps}.\n *\n * @public\n */\nexport type UseEmployeeDetailsFormSharedProps = {\n  /** Whether to expose the self-onboarding toggle as `form.Fields.SelfOnboarding`. Defaults to `true`. */\n  withSelfOnboardingField?: boolean\n  /** Fields that are optional by default but should be promoted to required for this form instance. */\n  optionalFieldsToRequire?: EmployeeDetailsOptionalFieldsToRequire\n  /** Initial values applied before any employee data loads. */\n  defaultValues?: Partial<EmployeeDetailsFormData>\n  /** When validation runs. Forwarded to react-hook-form's `mode`. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Whether react-hook-form should focus the first error on validation failure. Defaults to `true`. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Options for {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Discriminated by mode: in create mode supply `companyId` and omit\n * `employeeId`; in update mode supply `employeeId` (and optionally\n * `companyId`).\n *\n * @public\n * @group Utility types\n */\nexport type UseEmployeeDetailsFormProps =\n  | (UseEmployeeDetailsFormSharedProps & { companyId: string; employeeId?: never })\n  | (UseEmployeeDetailsFormSharedProps & { employeeId: string; companyId?: string })\n\n/**\n * The Field components exposed by {@link useEmployeeDetailsForm} as `form.Fields`.\n *\n * @remarks\n * Each entry is a component bound to a specific form field. `SelfOnboarding`\n * may be `undefined` when the field is not toggleable.\n *\n * @public\n */\nexport interface EmployeeDetailsFormFields {\n  /** Bound to `firstName`. Text input. */\n  FirstName: ComponentType<FirstNameFieldProps>\n  /** Bound to `middleInitial`. Text input. */\n  MiddleInitial: ComponentType<MiddleInitialFieldProps>\n  /** Bound to `lastName`. Text input. */\n  LastName: ComponentType<LastNameFieldProps>\n  /** Bound to `email`. Text input. */\n  Email: ComponentType<EmailFieldProps>\n  /** Bound to `dateOfBirth`. Date picker. */\n  DateOfBirth: ComponentType<DateOfBirthFieldProps>\n  /** Bound to `ssn`. Text input. */\n  Ssn: ComponentType<SsnFieldProps>\n  /** Bound to `selfOnboarding`. Switch, or `undefined` when the field is not toggleable. */\n  SelfOnboarding: ComponentType<SelfOnboardingFieldProps> | undefined\n}\n\n/**\n * The ready-state result returned by {@link useEmployeeDetailsForm} once data has loaded.\n *\n * @remarks\n * Provides the form's `data` snapshot, pending `status`, submit `actions`,\n * error handling, and the `form.Fields` map.\n *\n * @public\n */\nexport interface UseEmployeeDetailsFormReady extends BaseFormHookReady<\n  EmployeeDetailsFieldsMetadata,\n  EmployeeDetailsFormData,\n  EmployeeDetailsFormFields\n> {\n  /** The loaded employee data, or `null` in create mode. */\n  data: {\n    /** The employee being edited, or `null` in create mode. */\n    employee: Employee | null\n  }\n  /** Submit status and form mode. */\n  status: {\n    /** `true` while the create, update, or onboarding-status mutation is in flight. */\n    isPending: boolean\n    /** `'create'` when no `employeeId` was supplied, `'update'` otherwise. */\n    mode: 'create' | 'update'\n  }\n  /** Submit and related actions. */\n  actions: {\n    /** Validates the form and submits the changes. Returns the created or updated employee, or `undefined` when validation fails. */\n    onSubmit: (\n      callbacks?: EmployeeDetailsSubmitCallbacks,\n    ) => Promise<HookSubmitResult<Employee> | undefined>\n  }\n}\n\nconst isCurrentlySelfOnboarding = (employee?: Employee) => {\n  if (!employee?.onboardingStatus) return false\n  const selfOnboardingStatuses: string[] = [\n    EmployeeOnboardingStatus.SELF_ONBOARDING_PENDING_INVITE,\n    EmployeeOnboardingStatus.SELF_ONBOARDING_INVITED,\n    EmployeeOnboardingStatus.SELF_ONBOARDING_INVITED_STARTED,\n    EmployeeOnboardingStatus.SELF_ONBOARDING_INVITED_OVERDUE,\n    EmployeeOnboardingStatus.SELF_ONBOARDING_COMPLETED_BY_EMPLOYEE,\n    EmployeeOnboardingStatus.SELF_ONBOARDING_AWAITING_ADMIN_REVIEW,\n  ]\n  return selfOnboardingStatuses.includes(employee.onboardingStatus)\n}\n\nconst canToggleSelfOnboarding = (employee?: Employee) => {\n  if (!employee) return true\n  return (\n    employee.onboardingStatus === EmployeeOnboardingStatus.ADMIN_ONBOARDING_INCOMPLETE ||\n    employee.onboardingStatus === EmployeeOnboardingStatus.SELF_ONBOARDING_PENDING_INVITE\n  )\n}\n\n/**\n * Headless hook for creating or updating an employee's profile details — name, email, SSN, date of birth, and self-onboarding preference.\n *\n * @remarks\n * Returns a discriminated union: a loading variant while the underlying\n * employee fetch resolves, and a ready variant exposing the form's data,\n * pending status, submit action, error handling, and bound `Fields`.\n * Self-onboarding is only toggleable when the employee's onboarding status\n * allows it; otherwise `form.Fields.SelfOnboarding` is `undefined`.\n *\n * @param input - See {@link UseEmployeeDetailsFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseEmployeeDetailsFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useEmployeeDetailsForm,\n *   SDKFormProvider,\n *   type UseEmployeeDetailsFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function EmployeeDetailsPage({ companyId, employeeId }: { companyId: string; employeeId?: string }) {\n *   const employeeDetails = useEmployeeDetailsForm({ companyId, employeeId })\n *\n *   if (employeeDetails.isLoading) return <div>Loading...</div>\n *\n *   return <EmployeeDetailsReady employeeDetails={employeeDetails} />\n * }\n *\n * function EmployeeDetailsReady({ employeeDetails }: { employeeDetails: UseEmployeeDetailsFormReady }) {\n *   const { Fields } = employeeDetails.form\n *\n *   const handleSubmit = async () => {\n *     await employeeDetails.actions.onSubmit({\n *       onEmployeeCreated: emp => console.log('Created:', emp.uuid),\n *       onEmployeeUpdated: emp => console.log('Updated:', emp.uuid),\n *     })\n *   }\n *\n *   return (\n *     <SDKFormProvider formHookResult={employeeDetails}>\n *       <form onSubmit={e => { e.preventDefault(); void handleSubmit() }}>\n *         <Fields.FirstName label=\"First name\" />\n *         <Fields.LastName label=\"Last name\" />\n *         <Fields.Email label=\"Personal email\" />\n *         <Fields.DateOfBirth label=\"Date of birth\" />\n *         <Fields.Ssn label=\"Social Security number\" />\n *         <button type=\"submit\" disabled={employeeDetails.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useEmployeeDetailsForm({\n  companyId,\n  employeeId,\n  withSelfOnboardingField = true,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseEmployeeDetailsFormProps): HookLoadingResult | UseEmployeeDetailsFormReady {\n  const employeeQuery = useEmployeesGet({ employeeId: employeeId ?? '' }, { enabled: !!employeeId })\n\n  const employee = employeeQuery.data?.employee\n\n  const isCreateMode = !employeeId\n  const isSelfOnboardingToggleable = canToggleSelfOnboarding(employee)\n\n  const mode = isCreateMode ? 'create' : 'update'\n\n  const [schema, metadataConfig] = useMemo(\n    () => createEmployeeDetailsSchema({ mode, optionalFieldsToRequire, hasSsn: employee?.hasSsn }),\n    [mode, optionalFieldsToRequire, employee?.hasSsn],\n  )\n\n  const resolvedDefaults: EmployeeDetailsFormData = {\n    firstName: employee?.firstName ?? partnerDefaults?.firstName ?? '',\n    middleInitial: employee?.middleInitial ?? partnerDefaults?.middleInitial ?? '',\n    lastName: employee?.lastName ?? partnerDefaults?.lastName ?? '',\n    email: employee?.email ?? partnerDefaults?.email ?? '',\n    dateOfBirth: employee?.dateOfBirth ?? normalizeToISOString(partnerDefaults?.dateOfBirth),\n    ssn: partnerDefaults?.ssn ?? '',\n    selfOnboarding: partnerDefaults?.selfOnboarding ?? isCurrentlySelfOnboarding(employee),\n  }\n\n  const formMethods = useForm<EmployeeDetailsFormData, unknown, EmployeeDetailsFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const createEmployeeMutation = useEmployeesCreateMutation()\n  const updateEmployeeMutation = useEmployeesUpdateMutation()\n  const updateOnboardingStatusMutation = useEmployeesUpdateOnboardingStatusMutation()\n\n  const isPending =\n    createEmployeeMutation.isPending ||\n    updateEmployeeMutation.isPending ||\n    updateOnboardingStatusMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('EmployeeDetailsForm')\n\n  const queries = employeeId ? [employeeQuery] : []\n  const errorHandling = composeErrorHandler(queries, { submitError, setSubmitError })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = buildEmployeeDetailsFieldsMetadata(baseMetadata)\n\n  const onSubmit = async (\n    callbacks?: EmployeeDetailsSubmitCallbacks,\n  ): Promise<HookSubmitResult<Employee> | undefined> => {\n    let submitResult: HookSubmitResult<Employee> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: EmployeeDetailsFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const { selfOnboarding, dateOfBirth, ssn, ...body } = payload\n\n            const cleanedSsn = ssn ? removeNonDigits(ssn) : undefined\n            const hasSsnInput = cleanedSsn && cleanedSsn.length > 0\n\n            let updatedEmployee: Employee\n\n            if (isCreateMode) {\n              if (!companyId) {\n                throw new SDKInternalError('companyId is required to create an employee')\n              }\n              const result = await createEmployeeMutation.mutateAsync({\n                request: {\n                  companyId,\n                  requestBody: {\n                    ...body,\n                    selfOnboarding,\n                    dateOfBirth: dateOfBirth ? new RFCDate(new Date(dateOfBirth)) : undefined,\n                    ssn: hasSsnInput ? cleanedSsn : undefined,\n                  },\n                },\n              })\n\n              if (!result.employee) {\n                throw new SDKInternalError('Employee creation failed')\n              }\n\n              updatedEmployee = result.employee\n              callbacks?.onEmployeeCreated?.(updatedEmployee)\n            } else {\n              if (!employee) {\n                throw new SDKInternalError('Employee data is not available')\n              }\n\n              if (isSelfOnboardingToggleable) {\n                const currentIsSelfOnboarding =\n                  employee.onboardingStatus ===\n                  EmployeeOnboardingStatus.SELF_ONBOARDING_PENDING_INVITE\n\n                if (selfOnboarding !== currentIsSelfOnboarding) {\n                  const { employeeOnboardingStatus } =\n                    await updateOnboardingStatusMutation.mutateAsync({\n                      request: {\n                        employeeId: employee.uuid,\n                        requestBody: {\n                          onboardingStatus: selfOnboarding\n                            ? EmployeeOnboardingStatus.SELF_ONBOARDING_PENDING_INVITE\n                            : EmployeeOnboardingStatus.ADMIN_ONBOARDING_INCOMPLETE,\n                        },\n                      },\n                    })\n\n                  callbacks?.onOnboardingStatusUpdated?.(employeeOnboardingStatus)\n                }\n              }\n\n              const result = await updateEmployeeMutation.mutateAsync({\n                request: {\n                  employeeId: employee.uuid,\n                  requestBody: {\n                    version: employee.version as string,\n                    ...body,\n                    dateOfBirth: dateOfBirth || undefined,\n                    ssn: hasSsnInput ? cleanedSsn : undefined,\n                  },\n                },\n              })\n\n              if (!result.employee) {\n                throw new SDKInternalError('Employee update failed')\n              }\n\n              updatedEmployee = result.employee\n              callbacks?.onEmployeeUpdated?.(updatedEmployee)\n            }\n\n            submitResult = {\n              mode: isCreateMode ? 'create' : 'update',\n              data: updatedEmployee,\n            }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  const isDataLoading = employeeId ? employeeQuery.isLoading : false\n\n  if (isDataLoading || (employeeId && !employee)) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      employee: employee ?? null,\n    },\n    status: {\n      isPending,\n      mode: isCreateMode ? ('create' as const) : ('update' as const),\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        FirstName: FirstNameField,\n        MiddleInitial: MiddleInitialField,\n        LastName: LastNameField,\n        Email: EmailField,\n        DateOfBirth: DateOfBirthField,\n        Ssn: SsnField,\n        SelfOnboarding:\n          withSelfOnboardingField && isSelfOnboardingToggleable ? SelfOnboardingField : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Return type of {@link useEmployeeDetailsForm}.\n *\n * @public\n */\nexport type UseEmployeeDetailsFormResult = HookLoadingResult | UseEmployeeDetailsFormReady\n\n/**\n * Shape of `form.fieldsMetadata` returned by {@link useEmployeeDetailsForm}.\n *\n * @public\n */\nexport type EmployeeDetailsFieldsMetadata = ReturnType<typeof buildEmployeeDetailsFieldsMetadata>\n"],"names":["buildEmployeeDetailsFieldsMetadata","base","isCurrentlySelfOnboarding","employee","EmployeeOnboardingStatus","canToggleSelfOnboarding","useEmployeeDetailsForm","companyId","employeeId","withSelfOnboardingField","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","employeeQuery","useEmployeesGet","isCreateMode","isSelfOnboardingToggleable","mode","schema","metadataConfig","useMemo","createEmployeeDetailsSchema","resolvedDefaults","normalizeToISOString","formMethods","useForm","zodResolver","createEmployeeMutation","useEmployeesCreateMutation","updateEmployeeMutation","useEmployeesUpdateMutation","updateOnboardingStatusMutation","useEmployeesUpdateOnboardingStatusMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","onSubmit","callbacks","submitResult","resolve","data","payload","selfOnboarding","dateOfBirth","ssn","body","cleanedSsn","removeNonDigits","hasSsnInput","updatedEmployee","SDKInternalError","result","RFCDate","currentIsSelfOnboarding","employeeOnboardingStatus","hookFormInternals","useHookFormInternals","FirstNameField","MiddleInitialField","LastNameField","EmailField","DateOfBirthField","SsnField","SelfOnboardingField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Employee/Profile/shared/useEmployeeProfileSummary/index.d.ts

@@ -1,2 +1 @@
-import "./types/i18next.d.ts"
 export { useEmployeeProfileSummary } from './useEmployeeProfileSummary';

package/dist/components/Employee/Profile/shared/useEmployeeProfileSummary/useEmployeeProfileSummary.d.ts

@@ -1,4 +1,4 @@
-import { Employee } from '@gusto/embedded-api-v-2025-11-15/models/components/employee';
+import { Employee } from '@gusto/embedded-api/models/components/employee';
 import { BaseHookReady, HookLoadingResult } from '../../../../../partner-hook-utils/types';
 /**
  * Options for {@link useEmployeeProfileSummary}.

package/dist/components/Employee/Profile/shared/useEmployeeProfileSummary/useEmployeeProfileSummary.js

@@ -1,4 +1,4 @@
-import { useEmployeesGet as n } from "@gusto/embedded-api-v-2025-11-15/react-query/employeesGet";
+import { useEmployeesGet as n } from "@gusto/embedded-api/react-query/employeesGet";
 import { composeErrorHandler as t } from "../../../../../partner-hook-utils/composeErrorHandler.js";
 function m({
   employeeId: r

package/dist/components/Employee/Profile/shared/useEmployeeProfileSummary/useEmployeeProfileSummary.js.map

@@ -1 +1 @@
-{"version":3,"file":"useEmployeeProfileSummary.js","sources":["../../../../../../src/components/Employee/Profile/shared/useEmployeeProfileSummary/useEmployeeProfileSummary.tsx"],"sourcesContent":["import { useEmployeesGet } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesGet'\nimport type { Employee } from '@gusto/embedded-api-v-2025-11-15/models/components/employee'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type { BaseHookReady, HookLoadingResult } from '@/partner-hook-utils/types'\n\n/**\n * Options for {@link useEmployeeProfileSummary}.\n *\n * @public\n */\nexport interface UseEmployeeProfileSummaryParams {\n  /** The associated employee identifier. */\n  employeeId: string\n}\n\ntype UseEmployeeProfileSummaryReady = BaseHookReady<\n  { employee: Employee },\n  { isFetching: boolean; isPending: boolean }\n>\n\n/**\n * Return type of {@link useEmployeeProfileSummary}.\n *\n * @public\n */\nexport type UseEmployeeProfileSummaryResult = HookLoadingResult | UseEmployeeProfileSummaryReady\n\n/**\n * Read-only data hook for the basic-details Profile card.\n *\n * @remarks\n * Fetches a single employee record scoped to the fields the\n * basic-details surface displays. Pair with {@link useEmployeeDetailsForm}\n * to render an edit form against the same record.\n *\n * @param input - See {@link UseEmployeeProfileSummaryParams}.\n * @returns A {@link HookLoadingResult} while loading, or the ready result with the loaded employee once available.\n * @public\n *\n * @example\n * ```tsx\n * import { useEmployeeProfileSummary } from '@gusto/embedded-react-sdk'\n *\n * function ProfileSummary({ employeeId }: { employeeId: string }) {\n *   const summary = useEmployeeProfileSummary({ employeeId })\n *\n *   if (summary.isLoading) return <div>Loading...</div>\n *\n *   const { employee } = summary.data\n *   return <h2>{employee.firstName} {employee.lastName}</h2>\n * }\n * ```\n */\nexport function useEmployeeProfileSummary({\n  employeeId,\n}: UseEmployeeProfileSummaryParams): UseEmployeeProfileSummaryResult {\n  const employeeQuery = useEmployeesGet({ employeeId }, { staleTime: Infinity })\n\n  const errorHandling = composeErrorHandler([employeeQuery])\n\n  const employee = employeeQuery.data?.employee\n\n  if (employeeQuery.isLoading || !employee) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: { employee },\n    status: {\n      isFetching: employeeQuery.isFetching,\n      isPending: false,\n    },\n    errorHandling,\n  }\n}\n"],"names":["useEmployeeProfileSummary","employeeId","employeeQuery","useEmployeesGet","errorHandling","composeErrorHandler","employee"],"mappings":";;AAqDO,SAASA,EAA0B;AAAA,EACxC,YAAAC;AACF,GAAqE;AACnE,QAAMC,IAAgBC,EAAgB,EAAE,YAAAF,EAAA,GAAc,EAAE,WAAW,OAAU,GAEvEG,IAAgBC,EAAoB,CAACH,CAAa,CAAC,GAEnDI,IAAWJ,EAAc,MAAM;AAErC,SAAIA,EAAc,aAAa,CAACI,IACvB,EAAE,WAAW,IAAM,eAAAF,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM,EAAE,UAAAE,EAAA;AAAA,IACR,QAAQ;AAAA,MACN,YAAYJ,EAAc;AAAA,MAC1B,WAAW;AAAA,IAAA;AAAA,IAEb,eAAAE;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useEmployeeProfileSummary.js","sources":["../../../../../../src/components/Employee/Profile/shared/useEmployeeProfileSummary/useEmployeeProfileSummary.tsx"],"sourcesContent":["import { useEmployeesGet } from '@gusto/embedded-api/react-query/employeesGet'\nimport type { Employee } from '@gusto/embedded-api/models/components/employee'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type { BaseHookReady, HookLoadingResult } from '@/partner-hook-utils/types'\n\n/**\n * Options for {@link useEmployeeProfileSummary}.\n *\n * @public\n */\nexport interface UseEmployeeProfileSummaryParams {\n  /** The associated employee identifier. */\n  employeeId: string\n}\n\ntype UseEmployeeProfileSummaryReady = BaseHookReady<\n  { employee: Employee },\n  { isFetching: boolean; isPending: boolean }\n>\n\n/**\n * Return type of {@link useEmployeeProfileSummary}.\n *\n * @public\n */\nexport type UseEmployeeProfileSummaryResult = HookLoadingResult | UseEmployeeProfileSummaryReady\n\n/**\n * Read-only data hook for the basic-details Profile card.\n *\n * @remarks\n * Fetches a single employee record scoped to the fields the\n * basic-details surface displays. Pair with {@link useEmployeeDetailsForm}\n * to render an edit form against the same record.\n *\n * @param input - See {@link UseEmployeeProfileSummaryParams}.\n * @returns A {@link HookLoadingResult} while loading, or the ready result with the loaded employee once available.\n * @public\n *\n * @example\n * ```tsx\n * import { useEmployeeProfileSummary } from '@gusto/embedded-react-sdk'\n *\n * function ProfileSummary({ employeeId }: { employeeId: string }) {\n *   const summary = useEmployeeProfileSummary({ employeeId })\n *\n *   if (summary.isLoading) return <div>Loading...</div>\n *\n *   const { employee } = summary.data\n *   return <h2>{employee.firstName} {employee.lastName}</h2>\n * }\n * ```\n */\nexport function useEmployeeProfileSummary({\n  employeeId,\n}: UseEmployeeProfileSummaryParams): UseEmployeeProfileSummaryResult {\n  const employeeQuery = useEmployeesGet({ employeeId }, { staleTime: Infinity })\n\n  const errorHandling = composeErrorHandler([employeeQuery])\n\n  const employee = employeeQuery.data?.employee\n\n  if (employeeQuery.isLoading || !employee) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: { employee },\n    status: {\n      isFetching: employeeQuery.isFetching,\n      isPending: false,\n    },\n    errorHandling,\n  }\n}\n"],"names":["useEmployeeProfileSummary","employeeId","employeeQuery","useEmployeesGet","errorHandling","composeErrorHandler","employee"],"mappings":";;AAqDO,SAASA,EAA0B;AAAA,EACxC,YAAAC;AACF,GAAqE;AACnE,QAAMC,IAAgBC,EAAgB,EAAE,YAAAF,EAAA,GAAc,EAAE,WAAW,OAAU,GAEvEG,IAAgBC,EAAoB,CAACH,CAAa,CAAC,GAEnDI,IAAWJ,EAAc,MAAM;AAErC,SAAIA,EAAc,aAAa,CAACI,IACvB,EAAE,WAAW,IAAM,eAAAF,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM,EAAE,UAAAE,EAAA;AAAA,IACR,QAAQ;AAAA,MACN,YAAYJ,EAAc;AAAA,MAC1B,WAAW;AAAA,IAAA;AAAA,IAEb,eAAAE;AAAA,EAAA;AAEJ;"}

package/dist/components/Employee/Profile/shared/useHomeAddressForm/fields.d.ts

@@ -30,16 +30,7 @@ export type ZipValidation = (typeof HomeAddressErrorCodes)['REQUIRED' | 'INVALID
  * @public
  */
 export type Street1FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>;
-/**
- * Text input bound to the `street1` field of {@link useHomeAddressForm}.
- *
- * @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
- */
+/** @internal */
 export declare function Street1Field(props: Street1FieldProps): import("react").JSX.Element;
 /**
  * Props accepted by {@link useHomeAddressForm}'s `Fields.Street2` component.
@@ -47,16 +38,7 @@ export declare function Street1Field(props: Street1FieldProps): import("react").
  * @public
  */
 export type Street2FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>;
-/**
- * Text input bound to the `street2` field of {@link useHomeAddressForm}.
- *
- * @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
- */
+/** @internal */
 export declare function Street2Field(props: Street2FieldProps): import("react").JSX.Element;
 /**
  * Props accepted by {@link useHomeAddressForm}'s `Fields.City` component.
@@ -64,16 +46,7 @@ export declare function Street2Field(props: Street2FieldProps): import("react").
  * @public
  */
 export type CityFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>;
-/**
- * Text input bound to the `city` field of {@link useHomeAddressForm}.
- *
- * @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
- */
+/** @internal */
 export declare function CityField(props: CityFieldProps): import("react").JSX.Element;
 /**
  * Props accepted by {@link useHomeAddressForm}'s `Fields.State` component.
@@ -81,17 +54,7 @@ export declare function CityField(props: CityFieldProps): import("react").JSX.El
  * @public
  */
 export type StateFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, string>>;
-/**
- * Select bound to the `state` field of {@link useHomeAddressForm}.
- *
- * @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
- */
+/** @internal */
 export declare function StateField(props: StateFieldProps): import("react").JSX.Element;
 /**
  * Props accepted by {@link useHomeAddressForm}'s `Fields.Zip` component.
@@ -99,18 +62,7 @@ export declare function StateField(props: StateFieldProps): import("react").JSX.
  * @public
  */
 export type ZipFieldProps = HookFieldProps<TextInputHookFieldProps<ZipValidation>>;
-/**
- * Text input bound to the `zip` field of {@link useHomeAddressForm}.
- *
- * @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
- */
+/** @internal */
 export declare function ZipField(props: ZipFieldProps): import("react").JSX.Element;
 /**
  * Props accepted by {@link useHomeAddressForm}'s `Fields.CourtesyWithholding` component.
@@ -118,18 +70,7 @@ export declare function ZipField(props: ZipFieldProps): import("react").JSX.Elem
  * @public
  */
 export type CourtesyWithholdingFieldProps = HookFieldProps<CheckboxHookFieldProps<RequiredValidation>>;
-/**
- * Checkbox bound to the `courtesyWithholding` field of {@link useHomeAddressForm}.
- *
- * @remarks
- * Available on the hook result as `form.Fields.CourtesyWithholding`. When
- * checked, the employer agrees to withhold the employee's home-state taxes
- * as a courtesy even when the work and home states differ.
- *
- * @param props - {@link CourtesyWithholdingFieldProps} — accepts the standard hook field props (label, description, FieldComponent override).
- * @returns The rendered checkbox bound to `courtesyWithholding`.
- * @public
- */
+/** @internal */
 export declare function CourtesyWithholdingField(props: CourtesyWithholdingFieldProps): import("react").JSX.Element;
 /**
  * Props accepted by {@link useHomeAddressForm}'s `Fields.EffectiveDate` component.
@@ -137,16 +78,5 @@ export declare function CourtesyWithholdingField(props: CourtesyWithholdingField
  * @public
  */
 export type EffectiveDateFieldProps = HookFieldProps<DatePickerHookFieldProps<RequiredValidation>>;
-/**
- * Date picker bound to the `effectiveDate` field of {@link useHomeAddressForm}.
- *
- * @remarks
- * Available on the hook result as `form.Fields.EffectiveDate` when
- * `withEffectiveDateField` is `true`; `undefined` otherwise. Always
- * null-check before rendering.
- *
- * @param props - {@link EffectiveDateFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
- * @returns The rendered date picker bound to `effectiveDate`.
- * @public
- */
+/** @internal */
 export declare function EffectiveDateField(props: EffectiveDateFieldProps): import("react").JSX.Element;

package/dist/components/Employee/Profile/shared/useHomeAddressForm/fields.js

@@ -1,8 +1,8 @@
 import { jsx as t } from "react/jsx-runtime";
-import { TextInputHookField as i } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
-import { SelectHookField as r } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
+import { DatePickerHookField as r } from "../../../../../partner-hook-utils/form/fields/DatePickerHookField.js";
 import { CheckboxHookField as n } from "../../../../../partner-hook-utils/form/fields/CheckboxHookField.js";
-import { DatePickerHookField as o } from "../../../../../partner-hook-utils/form/fields/DatePickerHookField.js";
+import { TextInputHookField as i } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
+import { SelectHookField as o } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
 function d(e) {
   return /* @__PURE__ */ t(i, { ...e, name: "street1" });
 }
@@ -13,7 +13,7 @@ function F(e) {
   return /* @__PURE__ */ t(i, { ...e, name: "city" });
 }
 function p(e) {
-  return /* @__PURE__ */ t(r, { ...e, name: "state" });
+  return /* @__PURE__ */ t(o, { ...e, name: "state" });
 }
 function k(e) {
   return /* @__PURE__ */ t(i, { ...e, name: "zip" });
@@ -22,7 +22,7 @@ function s(e) {
   return /* @__PURE__ */ t(n, { ...e, name: "courtesyWithholding" });
 }
 function h(e) {
-  return /* @__PURE__ */ t(o, { ...e, name: "effectiveDate" });
+  return /* @__PURE__ */ t(r, { ...e, name: "effectiveDate" });
 }
 export {
   F as CityField,

package/dist/components/Employee/Profile/shared/useHomeAddressForm/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/Profile/shared/useHomeAddressForm/fields.tsx"],"sourcesContent":["import type { HomeAddressErrorCodes } from './homeAddressSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport type { CheckboxHookFieldProps } from '@/partner-hook-utils/form/fields/CheckboxHookField'\nimport type { DatePickerHookFieldProps } from '@/partner-hook-utils/form/fields/DatePickerHookField'\nimport {\n  TextInputHookField,\n  SelectHookField,\n  CheckboxHookField,\n  DatePickerHookField,\n} 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 useHomeAddressForm} fields that only emit `REQUIRED`.\n *\n * @remarks\n * Used as the `validationMessages` key for the street, city, state, courtesy\n * withholding, and effective date fields. See {@link HomeAddressErrorCodes}.\n *\n * @public\n */\nexport type RequiredValidation = typeof HomeAddressErrorCodes.REQUIRED\n\n/**\n * Validation error codes emitted by the `zip` field of {@link useHomeAddressForm}.\n *\n * @remarks\n * Use these as keys in `validationMessages` on `Fields.Zip`. See\n * {@link HomeAddressErrorCodes}.\n *\n * @public\n */\nexport type ZipValidation = (typeof HomeAddressErrorCodes)['REQUIRED' | 'INVALID_ZIP']\n\n/**\n * Props accepted by {@link useHomeAddressForm}'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 useHomeAddressForm}.\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 useHomeAddressForm}'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 useHomeAddressForm}.\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 useHomeAddressForm}'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 useHomeAddressForm}.\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 useHomeAddressForm}'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 useHomeAddressForm}.\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 useHomeAddressForm}'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 useHomeAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Zip`. Required; also\n * validates ZIP code format and emits `INVALID_ZIP` when the value does\n * 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\n/**\n * Props accepted by {@link useHomeAddressForm}'s `Fields.CourtesyWithholding` component.\n *\n * @public\n */\nexport type CourtesyWithholdingFieldProps = HookFieldProps<\n  CheckboxHookFieldProps<RequiredValidation>\n>\n\n/**\n * Checkbox bound to the `courtesyWithholding` field of {@link useHomeAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.CourtesyWithholding`. When\n * checked, the employer agrees to withhold the employee's home-state taxes\n * as a courtesy even when the work and home states differ.\n *\n * @param props - {@link CourtesyWithholdingFieldProps} — accepts the standard hook field props (label, description, FieldComponent override).\n * @returns The rendered checkbox bound to `courtesyWithholding`.\n * @public\n */\nexport function CourtesyWithholdingField(props: CourtesyWithholdingFieldProps) {\n  return <CheckboxHookField {...props} name=\"courtesyWithholding\" />\n}\n\n/**\n * Props accepted by {@link useHomeAddressForm}'s `Fields.EffectiveDate` component.\n *\n * @public\n */\nexport type EffectiveDateFieldProps = HookFieldProps<DatePickerHookFieldProps<RequiredValidation>>\n\n/**\n * Date picker bound to the `effectiveDate` field of {@link useHomeAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.EffectiveDate` when\n * `withEffectiveDateField` is `true`; `undefined` otherwise. Always\n * null-check before rendering.\n *\n * @param props - {@link EffectiveDateFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered date picker bound to `effectiveDate`.\n * @public\n */\nexport function EffectiveDateField(props: EffectiveDateFieldProps) {\n  return <DatePickerHookField {...props} name=\"effectiveDate\" />\n}\n"],"names":["Street1Field","props","jsx","TextInputHookField","Street2Field","CityField","StateField","SelectHookField","ZipField","CourtesyWithholdingField","CheckboxHookField","EffectiveDateField","DatePickerHookField"],"mappings":";;;;;AAoDO,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;AAqBO,SAASO,EAASP,GAAsB;AAC7C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,OAAM;AACnD;AAuBO,SAASQ,EAAyBR,GAAsC;AAC7E,SAAO,gBAAAC,EAACQ,GAAA,EAAmB,GAAGT,GAAO,MAAK,uBAAsB;AAClE;AAqBO,SAASU,EAAmBV,GAAgC;AACjE,SAAO,gBAAAC,EAACU,GAAA,EAAqB,GAAGX,GAAO,MAAK,iBAAgB;AAC9D;"}
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/Profile/shared/useHomeAddressForm/fields.tsx"],"sourcesContent":["import type { HomeAddressErrorCodes } from './homeAddressSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport type { CheckboxHookFieldProps } from '@/partner-hook-utils/form/fields/CheckboxHookField'\nimport type { DatePickerHookFieldProps } from '@/partner-hook-utils/form/fields/DatePickerHookField'\nimport {\n  TextInputHookField,\n  SelectHookField,\n  CheckboxHookField,\n  DatePickerHookField,\n} 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 useHomeAddressForm} fields that only emit `REQUIRED`.\n *\n * @remarks\n * Used as the `validationMessages` key for the street, city, state, courtesy\n * withholding, and effective date fields. See {@link HomeAddressErrorCodes}.\n *\n * @public\n */\nexport type RequiredValidation = typeof HomeAddressErrorCodes.REQUIRED\n\n/**\n * Validation error codes emitted by the `zip` field of {@link useHomeAddressForm}.\n *\n * @remarks\n * Use these as keys in `validationMessages` on `Fields.Zip`. See\n * {@link HomeAddressErrorCodes}.\n *\n * @public\n */\nexport type ZipValidation = (typeof HomeAddressErrorCodes)['REQUIRED' | 'INVALID_ZIP']\n\n/**\n * Props accepted by {@link useHomeAddressForm}'s `Fields.Street1` component.\n *\n * @public\n */\nexport type Street1FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/** @internal */\nexport function Street1Field(props: Street1FieldProps) {\n  return <TextInputHookField {...props} name=\"street1\" />\n}\n\n/**\n * Props accepted by {@link useHomeAddressForm}'s `Fields.Street2` component.\n *\n * @public\n */\nexport type Street2FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/** @internal */\nexport function Street2Field(props: Street2FieldProps) {\n  return <TextInputHookField {...props} name=\"street2\" />\n}\n\n/**\n * Props accepted by {@link useHomeAddressForm}'s `Fields.City` component.\n *\n * @public\n */\nexport type CityFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/** @internal */\nexport function CityField(props: CityFieldProps) {\n  return <TextInputHookField {...props} name=\"city\" />\n}\n\n/**\n * Props accepted by {@link useHomeAddressForm}'s `Fields.State` component.\n *\n * @public\n */\nexport type StateFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, string>>\n\n/** @internal */\nexport function StateField(props: StateFieldProps) {\n  return <SelectHookField {...props} name=\"state\" />\n}\n\n/**\n * Props accepted by {@link useHomeAddressForm}'s `Fields.Zip` component.\n *\n * @public\n */\nexport type ZipFieldProps = HookFieldProps<TextInputHookFieldProps<ZipValidation>>\n\n/** @internal */\nexport function ZipField(props: ZipFieldProps) {\n  return <TextInputHookField {...props} name=\"zip\" />\n}\n\n/**\n * Props accepted by {@link useHomeAddressForm}'s `Fields.CourtesyWithholding` component.\n *\n * @public\n */\nexport type CourtesyWithholdingFieldProps = HookFieldProps<\n  CheckboxHookFieldProps<RequiredValidation>\n>\n\n/** @internal */\nexport function CourtesyWithholdingField(props: CourtesyWithholdingFieldProps) {\n  return <CheckboxHookField {...props} name=\"courtesyWithholding\" />\n}\n\n/**\n * Props accepted by {@link useHomeAddressForm}'s `Fields.EffectiveDate` component.\n *\n * @public\n */\nexport type EffectiveDateFieldProps = HookFieldProps<DatePickerHookFieldProps<RequiredValidation>>\n\n/** @internal */\nexport function EffectiveDateField(props: EffectiveDateFieldProps) {\n  return <DatePickerHookField {...props} name=\"effectiveDate\" />\n}\n"],"names":["Street1Field","props","jsx","TextInputHookField","Street2Field","CityField","StateField","SelectHookField","ZipField","CourtesyWithholdingField","CheckboxHookField","EffectiveDateField","DatePickerHookField"],"mappings":";;;;;AA2CO,SAASA,EAAaC,GAA0B;AACrD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,WAAU;AACvD;AAUO,SAASG,EAAaH,GAA0B;AACrD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,WAAU;AACvD;AAUO,SAASI,EAAUJ,GAAuB;AAC/C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,QAAO;AACpD;AAUO,SAASK,EAAWL,GAAwB;AACjD,SAAO,gBAAAC,EAACK,GAAA,EAAiB,GAAGN,GAAO,MAAK,SAAQ;AAClD;AAUO,SAASO,EAASP,GAAsB;AAC7C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,OAAM;AACnD;AAYO,SAASQ,EAAyBR,GAAsC;AAC7E,SAAO,gBAAAC,EAACQ,GAAA,EAAmB,GAAGT,GAAO,MAAK,uBAAsB;AAClE;AAUO,SAASU,EAAmBV,GAAgC;AACjE,SAAO,gBAAAC,EAACU,GAAA,EAAqB,GAAGX,GAAO,MAAK,iBAAgB;AAC9D;"}

package/dist/components/Employee/Profile/shared/useHomeAddressForm/homeAddressSchema.d.ts

@@ -30,11 +30,7 @@ export type HomeAddressField = "street1" | "street2" | "city" | "state" | "zip"
  * @interface
  */
 export type HomeAddressFormData = { street1: string; street2: string; city: string; state: string; zip: string; courtesyWithholding: boolean; effectiveDate: string; };
-/**
- * Shape of the validated values produced by the home address form on submit.
- *
- * @public
- */
+/** @internal */
 export type HomeAddressFormOutputs = HomeAddressFormData;
 /**
  * Keys of optional home address fields that can be promoted to required via

package/dist/components/Employee/Profile/shared/useHomeAddressForm/homeAddressSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"homeAddressSchema.js","sources":["../../../../../../src/components/Employee/Profile/shared/useHomeAddressForm/homeAddressSchema.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 home address form schema. Map these\n * codes to localized copy in `validationMessages` when composing the hook.\n *\n * @public\n */\nexport const HomeAddressErrorCodes = {\n  REQUIRED: 'REQUIRED',\n  INVALID_ZIP: 'INVALID_ZIP',\n} as const\n\n/**\n * Union of validation error code strings emitted by the home address form\n * schema.\n *\n * @public\n */\nexport type HomeAddressErrorCode =\n  (typeof HomeAddressErrorCodes)[keyof typeof HomeAddressErrorCodes]\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: HomeAddressErrorCodes.INVALID_ZIP }),\n  courtesyWithholding: z.boolean(),\n  effectiveDate: z.iso.date({ error: () => HomeAddressErrorCodes.REQUIRED }),\n}\n\n/**\n * Field names accepted by the home address form.\n *\n * @public\n */\nexport type HomeAddressField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the home address form.\n *\n * @public\n * @interface\n */\nexport type HomeAddressFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n/**\n * Shape of the validated values produced by the home address form on submit.\n *\n * @public\n */\nexport type HomeAddressFormOutputs = HomeAddressFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n\nconst requiredFieldsConfig = {\n  street2: 'never',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\n/**\n * Keys of optional home address fields that can be promoted to required via\n * the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type HomeAddressOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface HomeAddressSchemaOptions {\n  mode?: 'create' | 'update'\n  optionalFieldsToRequire?: HomeAddressOptionalFieldsToRequire\n  withEffectiveDateField?: boolean\n}\n\n/** @internal */\nexport function createHomeAddressSchema(options: HomeAddressSchemaOptions = {}) {\n  const { mode = 'create', optionalFieldsToRequire, withEffectiveDateField = true } = options\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: HomeAddressErrorCodes.REQUIRED,\n    mode,\n    optionalFieldsToRequire,\n    excludeFields: withEffectiveDateField ? [] : ['effectiveDate'],\n  })\n}\n"],"names":["HomeAddressErrorCodes","ZIP_REGEX","fieldValidators","z","requiredFieldsConfig","createHomeAddressSchema","options","mode","optionalFieldsToRequire","withEffectiveDateField","buildFormSchema"],"mappings":";;AAeO,MAAMA,IAAwB;AAAA,EACnC,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,OAAA,EAAS,MAAMF,GAAW,EAAE,SAASD,EAAsB,aAAa;AAAA,EAC/E,qBAAqBG,EAAE,QAAA;AAAA,EACvB,eAAeA,EAAE,IAAI,KAAK,EAAE,OAAO,MAAMH,EAAsB,SAAA,CAAU;AAC3E,GA2BMI,IAAuB;AAAA,EAC3B,SAAS;AACX;AAsBO,SAASC,EAAwBC,IAAoC,IAAI;AAC9E,QAAM,EAAE,MAAAC,IAAO,UAAU,yBAAAC,GAAyB,wBAAAC,IAAyB,OAASH;AAEpF,SAAOI,EAAgBR,GAAiB;AAAA,IACtC,sBAAAE;AAAA,IACA,mBAAmBJ,EAAsB;AAAA,IACzC,MAAAO;AAAA,IACA,yBAAAC;AAAA,IACA,eAAeC,IAAyB,CAAA,IAAK,CAAC,eAAe;AAAA,EAAA,CAC9D;AACH;"}
+{"version":3,"file":"homeAddressSchema.js","sources":["../../../../../../src/components/Employee/Profile/shared/useHomeAddressForm/homeAddressSchema.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 home address form schema. Map these\n * codes to localized copy in `validationMessages` when composing the hook.\n *\n * @public\n */\nexport const HomeAddressErrorCodes = {\n  REQUIRED: 'REQUIRED',\n  INVALID_ZIP: 'INVALID_ZIP',\n} as const\n\n/**\n * Union of validation error code strings emitted by the home address form\n * schema.\n *\n * @public\n */\nexport type HomeAddressErrorCode =\n  (typeof HomeAddressErrorCodes)[keyof typeof HomeAddressErrorCodes]\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: HomeAddressErrorCodes.INVALID_ZIP }),\n  courtesyWithholding: z.boolean(),\n  effectiveDate: z.iso.date({ error: () => HomeAddressErrorCodes.REQUIRED }),\n}\n\n/**\n * Field names accepted by the home address form.\n *\n * @public\n */\nexport type HomeAddressField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the home address form.\n *\n * @public\n * @interface\n */\nexport type HomeAddressFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n/** @internal */\nexport type HomeAddressFormOutputs = HomeAddressFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n\nconst requiredFieldsConfig = {\n  street2: 'never',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\n/**\n * Keys of optional home address fields that can be promoted to required via\n * the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type HomeAddressOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface HomeAddressSchemaOptions {\n  mode?: 'create' | 'update'\n  optionalFieldsToRequire?: HomeAddressOptionalFieldsToRequire\n  withEffectiveDateField?: boolean\n}\n\n/** @internal */\nexport function createHomeAddressSchema(options: HomeAddressSchemaOptions = {}) {\n  const { mode = 'create', optionalFieldsToRequire, withEffectiveDateField = true } = options\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: HomeAddressErrorCodes.REQUIRED,\n    mode,\n    optionalFieldsToRequire,\n    excludeFields: withEffectiveDateField ? [] : ['effectiveDate'],\n  })\n}\n"],"names":["HomeAddressErrorCodes","ZIP_REGEX","fieldValidators","z","requiredFieldsConfig","createHomeAddressSchema","options","mode","optionalFieldsToRequire","withEffectiveDateField","buildFormSchema"],"mappings":";;AAeO,MAAMA,IAAwB;AAAA,EACnC,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,OAAA,EAAS,MAAMF,GAAW,EAAE,SAASD,EAAsB,aAAa;AAAA,EAC/E,qBAAqBG,EAAE,QAAA;AAAA,EACvB,eAAeA,EAAE,IAAI,KAAK,EAAE,OAAO,MAAMH,EAAsB,SAAA,CAAU;AAC3E,GAuBMI,IAAuB;AAAA,EAC3B,SAAS;AACX;AAsBO,SAASC,EAAwBC,IAAoC,IAAI;AAC9E,QAAM,EAAE,MAAAC,IAAO,UAAU,yBAAAC,GAAyB,wBAAAC,IAAyB,OAASH;AAEpF,SAAOI,EAAgBR,GAAiB;AAAA,IACtC,sBAAAE;AAAA,IACA,mBAAmBJ,EAAsB;AAAA,IACzC,MAAAO;AAAA,IACA,yBAAAC;AAAA,IACA,eAAeC,IAAyB,CAAA,IAAK,CAAC,eAAe;AAAA,EAAA,CAC9D;AACH;"}

package/dist/components/Employee/Profile/shared/useHomeAddressForm/index.d.ts

@@ -1,8 +1,6 @@
-import "./types/i18next.d.ts"
 export { useHomeAddressForm } from './useHomeAddressForm';
 export { useCurrentHomeAddressForm } from './useCurrentHomeAddressForm';
-export type { HomeAddressSubmitOptions, HomeAddressOptionalFieldsToRequire, UseHomeAddressFormProps, UseHomeAddressFormResult, UseHomeAddressFormReady, HomeAddressFieldsMetadata, HomeAddressFormFields, HomeAddressFields, } from './useHomeAddressForm';
+export type { HomeAddressSubmitOptions, HomeAddressOptionalFieldsToRequire, UseHomeAddressFormProps, UseHomeAddressFormResult, UseHomeAddressFormReady, HomeAddressFieldsMetadata, HomeAddressFormFields, } from './useHomeAddressForm';
 export type { UseCurrentHomeAddressFormProps } from './useCurrentHomeAddressForm';
-export { createHomeAddressSchema, HomeAddressErrorCodes, type HomeAddressErrorCode, type HomeAddressFormData, type HomeAddressFormOutputs, type HomeAddressField, } from './homeAddressSchema';
-export { Street1Field, Street2Field, CityField, StateField, ZipField, CourtesyWithholdingField, EffectiveDateField, } from './fields';
+export { HomeAddressErrorCodes, type HomeAddressErrorCode, type HomeAddressFormData, type HomeAddressField, } from './homeAddressSchema';
 export type { RequiredValidation as HomeAddressRequiredValidation, ZipValidation, Street1FieldProps, Street2FieldProps, CityFieldProps, StateFieldProps, ZipFieldProps, CourtesyWithholdingFieldProps, EffectiveDateFieldProps as HomeAddressEffectiveDateFieldProps, } from './fields';

package/dist/components/Employee/Profile/shared/useHomeAddressForm/useCurrentHomeAddressForm.js

@@ -1,4 +1,4 @@
-import { useEmployeeAddressesGet as a } from "@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesGet";
+import { useEmployeeAddressesGet as a } from "@gusto/embedded-api/react-query/employeeAddressesGet";
 import { useHomeAddressForm as m } from "./useHomeAddressForm.js";
 import { composeErrorHandler as n } from "../../../../../partner-hook-utils/composeErrorHandler.js";
 function p(i) {

package/dist/components/Employee/Profile/shared/useHomeAddressForm/useCurrentHomeAddressForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCurrentHomeAddressForm.js","sources":["../../../../../../src/components/Employee/Profile/shared/useHomeAddressForm/useCurrentHomeAddressForm.tsx"],"sourcesContent":["import { useEmployeeAddressesGet } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesGet'\nimport { useHomeAddressForm } from './useHomeAddressForm'\nimport type { UseHomeAddressFormProps, UseHomeAddressFormResult } from './useHomeAddressForm'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\n\n/**\n * Options for {@link useCurrentHomeAddressForm}.\n *\n * @remarks\n * Same shape as {@link UseHomeAddressFormProps} minus `homeAddressUuid` —\n * the hook resolves the current home address itself.\n *\n * @public\n */\nexport type UseCurrentHomeAddressFormProps = Omit<UseHomeAddressFormProps, 'homeAddressUuid'>\n\n/**\n * Convenience wrapper around {@link useHomeAddressForm} that auto-resolves the employee's current home address.\n *\n * @remarks\n * Lists the employee's home addresses and selects the active one (or the\n * first when none are active) as the row to edit. When the employee has no\n * home address on file the hook operates in create mode. The returned\n * shape is identical to {@link useHomeAddressForm}, so the same `Fields`,\n * `actions.onSubmit`, and `errorHandling` apply.\n *\n * @param props - See {@link UseCurrentHomeAddressFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseHomeAddressFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import { useCurrentHomeAddressForm } from '@gusto/embedded-react-sdk'\n *\n * function HomeAddressEditor({ employeeId }: { employeeId: string }) {\n *   const homeAddress = useCurrentHomeAddressForm({ employeeId })\n *\n *   if (homeAddress.isLoading) return <div>Loading...</div>\n *\n *   const { Fields } = homeAddress.form\n *   return (\n *     <form onSubmit={e => { e.preventDefault(); void homeAddress.actions.onSubmit() }}>\n *       <Fields.Street1 label=\"Street\" />\n *       <Fields.City label=\"City\" />\n *       <Fields.State label=\"State\" />\n *       <Fields.Zip label=\"ZIP\" />\n *       <button type=\"submit\">Save</button>\n *     </form>\n *   )\n * }\n * ```\n */\nexport function useCurrentHomeAddressForm(\n  props: UseCurrentHomeAddressFormProps,\n): UseHomeAddressFormResult {\n  const { employeeId, ...rest } = props\n\n  const listQuery = useEmployeeAddressesGet({ employeeId }, { enabled: !!employeeId })\n\n  const homeAddresses = listQuery.data?.employeeAddressList\n  const currentHomeAddress = homeAddresses?.find(a => a.active) ?? homeAddresses?.[0]\n\n  const base = useHomeAddressForm({\n    ...rest,\n    employeeId,\n    homeAddressUuid: currentHomeAddress?.uuid,\n  })\n\n  const listInitiallyBlocking = listQuery.isLoading && !listQuery.data\n\n  if (listInitiallyBlocking) {\n    return {\n      isLoading: true as const,\n      errorHandling: composeErrorHandler([listQuery]),\n    }\n  }\n\n  if (base.isLoading) {\n    return {\n      ...base,\n      errorHandling: composeErrorHandler([listQuery, { errorHandling: base.errorHandling }]),\n    }\n  }\n\n  return {\n    ...base,\n    errorHandling: composeErrorHandler([listQuery, { errorHandling: base.errorHandling }]),\n  }\n}\n"],"names":["useCurrentHomeAddressForm","props","employeeId","rest","listQuery","useEmployeeAddressesGet","homeAddresses","currentHomeAddress","a","base","useHomeAddressForm","composeErrorHandler"],"mappings":";;;AAoDO,SAASA,EACdC,GAC0B;AAC1B,QAAM,EAAE,YAAAC,GAAY,GAAGC,EAAA,IAASF,GAE1BG,IAAYC,EAAwB,EAAE,YAAAH,EAAA,GAAc,EAAE,SAAS,CAAC,CAACA,GAAY,GAE7EI,IAAgBF,EAAU,MAAM,qBAChCG,IAAqBD,GAAe,KAAK,CAAAE,MAAKA,EAAE,MAAM,KAAKF,IAAgB,CAAC,GAE5EG,IAAOC,EAAmB;AAAA,IAC9B,GAAGP;AAAA,IACH,YAAAD;AAAA,IACA,iBAAiBK,GAAoB;AAAA,EAAA,CACtC;AAID,SAF8BH,EAAU,aAAa,CAACA,EAAU,OAGvD;AAAA,IACL,WAAW;AAAA,IACX,eAAeO,EAAoB,CAACP,CAAS,CAAC;AAAA,EAAA,IAI9CK,EAAK,YACA;AAAA,IACL,GAAGA;AAAA,IACH,eAAeE,EAAoB,CAACP,GAAW,EAAE,eAAeK,EAAK,eAAe,CAAC;AAAA,EAAA,IAIlF;AAAA,IACL,GAAGA;AAAA,IACH,eAAeE,EAAoB,CAACP,GAAW,EAAE,eAAeK,EAAK,eAAe,CAAC;AAAA,EAAA;AAEzF;"}
+{"version":3,"file":"useCurrentHomeAddressForm.js","sources":["../../../../../../src/components/Employee/Profile/shared/useHomeAddressForm/useCurrentHomeAddressForm.tsx"],"sourcesContent":["import { useEmployeeAddressesGet } from '@gusto/embedded-api/react-query/employeeAddressesGet'\nimport { useHomeAddressForm } from './useHomeAddressForm'\nimport type { UseHomeAddressFormProps, UseHomeAddressFormResult } from './useHomeAddressForm'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\n\n/**\n * Options for {@link useCurrentHomeAddressForm}.\n *\n * @remarks\n * Same shape as {@link UseHomeAddressFormProps} minus `homeAddressUuid` —\n * the hook resolves the current home address itself.\n *\n * @public\n */\nexport type UseCurrentHomeAddressFormProps = Omit<UseHomeAddressFormProps, 'homeAddressUuid'>\n\n/**\n * Convenience wrapper around {@link useHomeAddressForm} that auto-resolves the employee's current home address.\n *\n * @remarks\n * Lists the employee's home addresses and selects the active one (or the\n * first when none are active) as the row to edit. When the employee has no\n * home address on file the hook operates in create mode. The returned\n * shape is identical to {@link useHomeAddressForm}, so the same `Fields`,\n * `actions.onSubmit`, and `errorHandling` apply.\n *\n * @param props - See {@link UseCurrentHomeAddressFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseHomeAddressFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import { useCurrentHomeAddressForm } from '@gusto/embedded-react-sdk'\n *\n * function HomeAddressEditor({ employeeId }: { employeeId: string }) {\n *   const homeAddress = useCurrentHomeAddressForm({ employeeId })\n *\n *   if (homeAddress.isLoading) return <div>Loading...</div>\n *\n *   const { Fields } = homeAddress.form\n *   return (\n *     <form onSubmit={e => { e.preventDefault(); void homeAddress.actions.onSubmit() }}>\n *       <Fields.Street1 label=\"Street\" />\n *       <Fields.City label=\"City\" />\n *       <Fields.State label=\"State\" />\n *       <Fields.Zip label=\"ZIP\" />\n *       <button type=\"submit\">Save</button>\n *     </form>\n *   )\n * }\n * ```\n */\nexport function useCurrentHomeAddressForm(\n  props: UseCurrentHomeAddressFormProps,\n): UseHomeAddressFormResult {\n  const { employeeId, ...rest } = props\n\n  const listQuery = useEmployeeAddressesGet({ employeeId }, { enabled: !!employeeId })\n\n  const homeAddresses = listQuery.data?.employeeAddressList\n  const currentHomeAddress = homeAddresses?.find(a => a.active) ?? homeAddresses?.[0]\n\n  const base = useHomeAddressForm({\n    ...rest,\n    employeeId,\n    homeAddressUuid: currentHomeAddress?.uuid,\n  })\n\n  const listInitiallyBlocking = listQuery.isLoading && !listQuery.data\n\n  if (listInitiallyBlocking) {\n    return {\n      isLoading: true as const,\n      errorHandling: composeErrorHandler([listQuery]),\n    }\n  }\n\n  if (base.isLoading) {\n    return {\n      ...base,\n      errorHandling: composeErrorHandler([listQuery, { errorHandling: base.errorHandling }]),\n    }\n  }\n\n  return {\n    ...base,\n    errorHandling: composeErrorHandler([listQuery, { errorHandling: base.errorHandling }]),\n  }\n}\n"],"names":["useCurrentHomeAddressForm","props","employeeId","rest","listQuery","useEmployeeAddressesGet","homeAddresses","currentHomeAddress","a","base","useHomeAddressForm","composeErrorHandler"],"mappings":";;;AAoDO,SAASA,EACdC,GAC0B;AAC1B,QAAM,EAAE,YAAAC,GAAY,GAAGC,EAAA,IAASF,GAE1BG,IAAYC,EAAwB,EAAE,YAAAH,EAAA,GAAc,EAAE,SAAS,CAAC,CAACA,GAAY,GAE7EI,IAAgBF,EAAU,MAAM,qBAChCG,IAAqBD,GAAe,KAAK,CAAAE,MAAKA,EAAE,MAAM,KAAKF,IAAgB,CAAC,GAE5EG,IAAOC,EAAmB;AAAA,IAC9B,GAAGP;AAAA,IACH,YAAAD;AAAA,IACA,iBAAiBK,GAAoB;AAAA,EAAA,CACtC;AAID,SAF8BH,EAAU,aAAa,CAACA,EAAU,OAGvD;AAAA,IACL,WAAW;AAAA,IACX,eAAeO,EAAoB,CAACP,CAAS,CAAC;AAAA,EAAA,IAI9CK,EAAK,YACA;AAAA,IACL,GAAGA;AAAA,IACH,eAAeE,EAAoB,CAACP,GAAW,EAAE,eAAeK,EAAK,eAAe,CAAC;AAAA,EAAA,IAIlF;AAAA,IACL,GAAGA;AAAA,IACH,eAAeE,EAAoB,CAACP,GAAW,EAAE,eAAeK,EAAK,eAAe,CAAC;AAAA,EAAA;AAEzF;"}

package/dist/components/Employee/Profile/shared/useHomeAddressForm/useHomeAddressForm.d.ts

@@ -1,8 +1,9 @@
+import { ComponentType } from 'react';
 import { UseFormProps } from 'react-hook-form';
-import { EmployeeAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeaddress';
+import { EmployeeAddress } from '@gusto/embedded-api/models/components/employeeaddress';
 import { HomeAddressOptionalFieldsToRequire, HomeAddressFormData } from './homeAddressSchema';
-import { Street1Field, Street2Field, CityField, StateField, ZipField, CourtesyWithholdingField, EffectiveDateField } from './fields';
-import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+import { Street1FieldProps, Street2FieldProps, CityFieldProps, StateFieldProps, ZipFieldProps, CourtesyWithholdingFieldProps, EffectiveDateFieldProps } from './fields';
+import { BaseFormHookReady, FieldMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
 export type { HomeAddressOptionalFieldsToRequire } from './homeAddressSchema';
 /**
  * Optional overrides passed to {@link UseHomeAddressFormReady.actions.onSubmit | onSubmit}.
@@ -57,21 +58,21 @@ export interface UseHomeAddressFormProps {
  *
  * @public
  */
-export interface HomeAddressFields {
-    /** Street address line 1 text input. Always available. */
-    Street1: typeof Street1Field;
-    /** Street address line 2 text input. Always available. */
-    Street2: typeof Street2Field;
-    /** City text input. Always available. */
-    City: typeof CityField;
-    /** State selector. Always available. */
-    State: typeof StateField;
-    /** ZIP code text input. Always available. */
-    Zip: typeof ZipField;
-    /** Courtesy withholding checkbox. Always available. */
-    CourtesyWithholding: typeof CourtesyWithholdingField;
-    /** Effective-date picker. Only available when `withEffectiveDateField` is `true`. */
-    EffectiveDate: typeof EffectiveDateField | undefined;
+export interface HomeAddressFormFields {
+    /** Bound to `street1`. Street address line 1 text input. Always available. */
+    Street1: ComponentType<Street1FieldProps>;
+    /** Bound to `street2`. Street address line 2 text input. Always available. */
+    Street2: ComponentType<Street2FieldProps>;
+    /** Bound to `city`. City text input. Always available. */
+    City: ComponentType<CityFieldProps>;
+    /** Bound to `state`. State selector. Always available. */
+    State: ComponentType<StateFieldProps>;
+    /** Bound to `zip`. ZIP code text input. Always available. */
+    Zip: ComponentType<ZipFieldProps>;
+    /** Bound to `courtesyWithholding`. Courtesy withholding checkbox. Always available. */
+    CourtesyWithholding: ComponentType<CourtesyWithholdingFieldProps>;
+    /** Bound to `effectiveDate`. Effective-date picker. Only available when `withEffectiveDateField` is `true`. */
+    EffectiveDate: ComponentType<EffectiveDateFieldProps> | undefined;
 }
 /**
  * Ready-state shape returned by {@link useHomeAddressForm} once data has loaded.
@@ -82,7 +83,7 @@ export interface HomeAddressFields {
  *
  * @public
  */
-export interface UseHomeAddressFormReady extends BaseFormHookReady<FieldsMetadata, HomeAddressFormData, HomeAddressFields> {
+export interface UseHomeAddressFormReady extends BaseFormHookReady<HomeAddressFieldsMetadata, HomeAddressFormData, HomeAddressFormFields> {
     /** Static entity data resolved from the API. */
     data: {
         /** The address row loaded for update; `null` in create mode. */
@@ -158,10 +159,4 @@ export type UseHomeAddressFormResult = HookLoadingResult | UseHomeAddressFormRea
  *
  * @public
  */
-export type HomeAddressFieldsMetadata = UseHomeAddressFormReady['form']['fieldsMetadata'];
-/**
- * Type of `form.Fields` returned by {@link useHomeAddressForm}.
- *
- * @public
- */
-export type HomeAddressFormFields = UseHomeAddressFormReady['form']['Fields'];
+export type HomeAddressFieldsMetadata = { street1: FieldMetadata; street2: FieldMetadata; city: FieldMetadata; state: import("../../../../../partner-hook-utils/types").FieldMetadataWithOptions<"AL" | "AK" | "AZ" | "AR" | "CA" | "CO" | "CT" | "DE" | "DC" | "FL" | "GA" | "HI" | "ID" | "IL" | "IN" | "IA" | "KS" | "KY" | "LA" | "ME" | "MD" | "MA" | "MI" | "MN" | "MS" | "MO" | "MT" | "NE" | "NV" | "NH" | "NJ" | "NM" | "NY" | "NC" | "ND" | "OH" | "OK" | "OR" | "PA" | "RI" | "SC" | "SD" | "TN" | "TX" | "UT" | "VT" | "VA" | "WA" | "WV" | "WI" | "WY">; zip: FieldMetadata; courtesyWithholding: FieldMetadata; effectiveDate: FieldMetadata; };