@gusto/embedded-react-sdk 0.47.1 → 0.48.0

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

@@ -1 +1 @@
-{"version":3,"file":"useWorkAddressForm.js","sources":["../../../../../../src/components/Employee/Profile/shared/useWorkAddressForm/useWorkAddressForm.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 { Location } from '@gusto/embedded-api-v-2025-11-15/models/components/location'\nimport type { EmployeeWorkAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeworkaddress'\nimport { useLocationsGet } from '@gusto/embedded-api-v-2025-11-15/react-query/locationsGet'\nimport { useEmployeeAddressesRetrieveWorkAddress } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesRetrieveWorkAddress'\nimport { useEmployeeAddressesCreateWorkAddressMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesCreateWorkAddress'\nimport { useEmployeeAddressesUpdateWorkAddressMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesUpdateWorkAddress'\nimport { RFCDate } from '@gusto/embedded-api-v-2025-11-15/types/rfcdate'\nimport {\n  createWorkAddressSchema,\n  type WorkAddressOptionalFieldsToRequire,\n  type WorkAddressFormData,\n  type WorkAddressFormOutputs,\n} from './workAddressSchema'\nimport { LocationField, EffectiveDateField } from './fields'\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 { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { addressInline } from '@/helpers/formattedStrings'\n\nexport type { WorkAddressOptionalFieldsToRequire } from './workAddressSchema'\n\nexport interface WorkAddressSubmitCallbacks {\n  onWorkAddressCreated?: (workAddress: EmployeeWorkAddress) => void\n  onWorkAddressUpdated?: (workAddress: EmployeeWorkAddress) => void\n}\n\nexport interface WorkAddressSubmitOptions {\n  employeeId?: string\n  effectiveDate?: string\n}\n\nexport interface UseWorkAddressFormProps {\n  /** Company UUID for locations; omit or leave unset while resolving from the employee record. */\n  companyId?: string\n  employeeId: string\n  /**\n   * When set, loads that work address via GET `/v1/work_addresses/{work_address_uuid}` and updates it (PUT).\n   * When omitted, the form is in create mode (POST).\n   */\n  workAddressUuid?: string\n  /**\n   * Pre-loaded address matching `workAddressUuid`. When supplied, the form uses it directly\n   * instead of issuing a GET — useful when the parent already has the row from a list query.\n   */\n  initialAddress?: EmployeeWorkAddress\n  withEffectiveDateField?: boolean\n  optionalFieldsToRequire?: WorkAddressOptionalFieldsToRequire\n  defaultValues?: Partial<WorkAddressFormData>\n  validationMode?: UseFormProps['mode']\n  shouldFocusError?: boolean\n}\n\nexport interface WorkAddressFields {\n  Location: typeof LocationField\n  EffectiveDate: typeof EffectiveDateField | undefined\n}\n\nexport interface UseWorkAddressFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  WorkAddressFormData,\n  WorkAddressFields\n> {\n  data: {\n    /** The address row loaded for update; `null` in create mode. */\n    workAddress: EmployeeWorkAddress | null\n    companyLocations: Location[] | undefined\n  }\n  status: { isPending: boolean; mode: 'create' | 'update' }\n  actions: {\n    onSubmit: (\n      callbacks?: WorkAddressSubmitCallbacks,\n      options?: WorkAddressSubmitOptions,\n    ) => Promise<HookSubmitResult<EmployeeWorkAddress> | undefined>\n  }\n}\n\nexport function useWorkAddressForm({\n  companyId,\n  employeeId,\n  workAddressUuid,\n  initialAddress,\n  withEffectiveDateField = true,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseWorkAddressFormProps): HookLoadingResult | UseWorkAddressFormReady {\n  const locationsQuery = useLocationsGet({ companyId: companyId ?? '' }, { enabled: !!companyId })\n\n  const hasInitialAddressMatch = !!workAddressUuid && initialAddress?.uuid === workAddressUuid\n\n  const retrieveWorkAddressQuery = useEmployeeAddressesRetrieveWorkAddress(\n    { workAddressUuid: workAddressUuid ?? '' },\n    { enabled: !!workAddressUuid && !hasInitialAddressMatch },\n  )\n\n  const companyLocations = locationsQuery.data?.companyLocationsList\n\n  const isCreateMode = !workAddressUuid\n\n  const fetchedWorkAddress = workAddressUuid\n    ? hasInitialAddressMatch\n      ? initialAddress\n      : retrieveWorkAddressQuery.data?.employeeWorkAddress\n    : undefined\n\n  const schemaMode = isCreateMode ? 'create' : 'update'\n\n  const [schema, metadataConfig] = useMemo(\n    () =>\n      createWorkAddressSchema({\n        mode: schemaMode,\n        optionalFieldsToRequire,\n        withEffectiveDateField,\n      }),\n    [schemaMode, optionalFieldsToRequire, withEffectiveDateField],\n  )\n\n  const resolvedDefaults: WorkAddressFormData = useMemo(\n    () => ({\n      locationUuid: fetchedWorkAddress?.locationUuid ?? partnerDefaults?.locationUuid ?? '',\n      effectiveDate: fetchedWorkAddress?.effectiveDate ?? partnerDefaults?.effectiveDate ?? '',\n    }),\n    [fetchedWorkAddress, partnerDefaults],\n  )\n\n  const formMethods = useForm<WorkAddressFormData, unknown, WorkAddressFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const createWorkAddressMutation = useEmployeeAddressesCreateWorkAddressMutation()\n  const updateWorkAddressMutation = useEmployeeAddressesUpdateWorkAddressMutation()\n\n  const isPending = createWorkAddressMutation.isPending || updateWorkAddressMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('WorkAddressForm')\n\n  const queriesForErrors = [locationsQuery, ...(workAddressUuid ? [retrieveWorkAddressQuery] : [])]\n  const errorHandling = composeErrorHandler(queriesForErrors, { submitError, setSubmitError })\n\n  const locationOptions = (companyLocations ?? []).map(location => ({\n    value: location.uuid,\n    label: addressInline(location),\n  }))\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = {\n    locationUuid: withOptions<Location>(\n      baseMetadata.locationUuid,\n      locationOptions,\n      companyLocations ?? [],\n    ),\n    effectiveDate: baseMetadata.effectiveDate,\n  }\n\n  const onSubmit = async (\n    callbacks?: WorkAddressSubmitCallbacks,\n    options?: WorkAddressSubmitOptions,\n  ): Promise<HookSubmitResult<EmployeeWorkAddress> | undefined> => {\n    let submitResult: HookSubmitResult<EmployeeWorkAddress> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: WorkAddressFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const resolvedEmployeeId = options?.employeeId ?? employeeId\n\n            if (!resolvedEmployeeId) {\n              throw new SDKInternalError('employeeId is required to submit work address')\n            }\n\n            const resolvedEffectiveDate =\n              withEffectiveDateField && payload.effectiveDate\n                ? payload.effectiveDate\n                : options?.effectiveDate\n\n            const effectiveDateParam = resolvedEffectiveDate\n              ? new RFCDate(new Date(resolvedEffectiveDate))\n              : undefined\n\n            let updatedWorkAddress: EmployeeWorkAddress\n\n            if (isCreateMode) {\n              const result = await createWorkAddressMutation.mutateAsync({\n                request: {\n                  employeeId: resolvedEmployeeId,\n                  requestBody: {\n                    locationUuid: payload.locationUuid,\n                    effectiveDate: effectiveDateParam,\n                  },\n                },\n              })\n\n              if (!result.employeeWorkAddress) {\n                throw new SDKInternalError('Work address creation failed')\n              }\n\n              updatedWorkAddress = result.employeeWorkAddress\n              callbacks?.onWorkAddressCreated?.(updatedWorkAddress)\n            } else {\n              if (!fetchedWorkAddress || !workAddressUuid) {\n                throw new SDKInternalError(\n                  'Cannot update work address: no matching address on file',\n                )\n              }\n\n              const result = await updateWorkAddressMutation.mutateAsync({\n                request: {\n                  workAddressUuid: fetchedWorkAddress.uuid,\n                  requestBody: {\n                    version: fetchedWorkAddress.version,\n                    locationUuid: payload.locationUuid,\n                    effectiveDate: effectiveDateParam,\n                  },\n                },\n              })\n\n              if (!result.employeeWorkAddress) {\n                throw new SDKInternalError('Work address update failed')\n              }\n\n              updatedWorkAddress = result.employeeWorkAddress\n              callbacks?.onWorkAddressUpdated?.(updatedWorkAddress)\n            }\n\n            submitResult = {\n              mode: isCreateMode ? 'create' : 'update',\n              data: updatedWorkAddress,\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 =\n    (!!companyId && locationsQuery.isLoading) ||\n    (!!workAddressUuid && retrieveWorkAddressQuery.isLoading)\n\n  if (!companyId || isDataLoading || !companyLocations) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  if (workAddressUuid && !fetchedWorkAddress) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      workAddress: fetchedWorkAddress ?? null,\n      companyLocations,\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        Location: LocationField,\n        EffectiveDate: withEffectiveDateField ? EffectiveDateField : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\nexport type UseWorkAddressFormResult = HookLoadingResult | UseWorkAddressFormReady\nexport type WorkAddressFieldsMetadata = UseWorkAddressFormReady['form']['fieldsMetadata']\nexport type WorkAddressFormFields = UseWorkAddressFormReady['form']['Fields']\n"],"names":["useWorkAddressForm","companyId","employeeId","workAddressUuid","initialAddress","withEffectiveDateField","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","locationsQuery","useLocationsGet","hasInitialAddressMatch","retrieveWorkAddressQuery","useEmployeeAddressesRetrieveWorkAddress","companyLocations","isCreateMode","fetchedWorkAddress","schemaMode","schema","metadataConfig","useMemo","createWorkAddressSchema","resolvedDefaults","formMethods","useForm","zodResolver","createWorkAddressMutation","useEmployeeAddressesCreateWorkAddressMutation","updateWorkAddressMutation","useEmployeeAddressesUpdateWorkAddressMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","queriesForErrors","errorHandling","composeErrorHandler","locationOptions","location","addressInline","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","withOptions","onSubmit","callbacks","options","submitResult","resolve","data","payload","resolvedEmployeeId","SDKInternalError","resolvedEffectiveDate","effectiveDateParam","RFCDate","updatedWorkAddress","result","hookFormInternals","useHookFormInternals","isDataLoading","LocationField","EffectiveDateField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"useWorkAddressForm.js","sources":["../../../../../../src/components/Employee/Profile/shared/useWorkAddressForm/useWorkAddressForm.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 { Location } from '@gusto/embedded-api-v-2025-11-15/models/components/location'\nimport type { EmployeeWorkAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeworkaddress'\nimport { useLocationsGet } from '@gusto/embedded-api-v-2025-11-15/react-query/locationsGet'\nimport { useEmployeeAddressesRetrieveWorkAddress } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesRetrieveWorkAddress'\nimport { useEmployeeAddressesCreateWorkAddressMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesCreateWorkAddress'\nimport { useEmployeeAddressesUpdateWorkAddressMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesUpdateWorkAddress'\nimport { RFCDate } from '@gusto/embedded-api-v-2025-11-15/types/rfcdate'\nimport {\n  createWorkAddressSchema,\n  type WorkAddressOptionalFieldsToRequire,\n  type WorkAddressFormData,\n  type WorkAddressFormOutputs,\n} from './workAddressSchema'\nimport { LocationField, EffectiveDateField } from './fields'\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 { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { addressInline } from '@/helpers/formattedStrings'\n\nexport type { WorkAddressOptionalFieldsToRequire } from './workAddressSchema'\n\n/**\n * Optional callbacks passed to {@link UseWorkAddressFormReady.actions.onSubmit | onSubmit}.\n *\n * @remarks\n * Only the callback matching the submit mode fires —\n * `onWorkAddressCreated` on create, `onWorkAddressUpdated` on update.\n *\n * @public\n */\nexport interface WorkAddressSubmitCallbacks {\n  /** Fired after a new work address is successfully created. */\n  onWorkAddressCreated?: (workAddress: EmployeeWorkAddress) => void\n  /** Fired after an existing work address is successfully updated. */\n  onWorkAddressUpdated?: (workAddress: EmployeeWorkAddress) => void\n}\n\n/**\n * Optional overrides passed to {@link UseWorkAddressFormReady.actions.onSubmit | onSubmit}.\n *\n * @public\n */\nexport interface WorkAddressSubmitOptions {\n  /** Override the employee identifier supplied to the hook (e.g. after creating a new employee in the same flow). */\n  employeeId?: string\n  /** Override the effective date submitted with the address. */\n  effectiveDate?: string\n}\n\n/**\n * Configuration options for {@link useWorkAddressForm}.\n *\n * @remarks\n * Presence or absence of `workAddressUuid` selects the API verb — see the\n * `workAddressUuid` field description. `companyId` is required to fetch\n * the location list; pass it when it is known.\n *\n * @public\n */\nexport interface UseWorkAddressFormProps {\n  /** Company UUID for locations; omit or leave unset while resolving from the employee record. */\n  companyId?: string\n  /** UUID of the employee whose work address is being created or edited. */\n  employeeId: string\n  /**\n   * When set, loads that work address via GET `/v1/work_addresses/{work_address_uuid}` and updates it (PUT).\n   * When omitted, the form is in create mode (POST).\n   */\n  workAddressUuid?: string\n  /**\n   * Pre-loaded address matching `workAddressUuid`. When supplied, the form uses it directly\n   * instead of issuing a GET — useful when the parent already has the row from a list query.\n   */\n  initialAddress?: EmployeeWorkAddress\n  /** When `true`, renders `Fields.EffectiveDate`; otherwise it is `undefined`. Defaults to `true`. */\n  withEffectiveDateField?: boolean\n  /** Override fields that are optional on a given mode to be required. See `WorkAddressOptionalFieldsToRequire`. */\n  optionalFieldsToRequire?: WorkAddressOptionalFieldsToRequire\n  /** Pre-fill form values. Server data takes precedence on update. */\n  defaultValues?: Partial<WorkAddressFormData>\n  /** Passed through to react-hook-form. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** 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`. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Pre-bound field components exposed on `useWorkAddressForm().form.Fields`.\n *\n * @remarks\n * `EffectiveDate` is `undefined` when `withEffectiveDateField` is `false`.\n * Always null-check it before rendering.\n *\n * @public\n */\nexport interface WorkAddressFields {\n  /** Location selector. Always available. */\n  Location: typeof LocationField\n  /** Effective-date picker. Only available when `withEffectiveDateField` is `true`. */\n  EffectiveDate: typeof EffectiveDateField | undefined\n}\n\n/**\n * Ready-state shape returned by {@link useWorkAddressForm} once data has loaded.\n *\n * @remarks\n * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with\n * the work-address-specific `data`, `status`, `actions`, and `form.Fields` shape.\n *\n * @public\n */\nexport interface UseWorkAddressFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  WorkAddressFormData,\n  WorkAddressFields\n> {\n  /** Static entity data resolved from the API. */\n  data: {\n    /** The address row loaded for update; `null` in create mode. */\n    workAddress: EmployeeWorkAddress | null\n    /** Company locations available for selection; `undefined` until the locations query resolves. */\n    companyLocations: Location[] | undefined\n  }\n  /** Reactive status flags. */\n  status: { isPending: boolean; mode: 'create' | 'update' }\n  /** Available actions. */\n  actions: {\n    onSubmit: (\n      callbacks?: WorkAddressSubmitCallbacks,\n      options?: WorkAddressSubmitOptions,\n    ) => Promise<HookSubmitResult<EmployeeWorkAddress> | undefined>\n  }\n}\n\n/**\n * Form hook for creating or editing an employee's work address.\n *\n * @remarks\n * When `workAddressUuid` is supplied the hook loads that address and issues a PUT on submit;\n * when omitted it operates in create mode and issues a POST. The hook requires `companyId`\n * to fetch the company's location list — it stays in loading state until `companyId` is known.\n *\n * @param props - See {@link UseWorkAddressFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseWorkAddressFormReady} once ready.\n * @public\n */\nexport function useWorkAddressForm({\n  companyId,\n  employeeId,\n  workAddressUuid,\n  initialAddress,\n  withEffectiveDateField = true,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseWorkAddressFormProps): HookLoadingResult | UseWorkAddressFormReady {\n  const locationsQuery = useLocationsGet({ companyId: companyId ?? '' }, { enabled: !!companyId })\n\n  const hasInitialAddressMatch = !!workAddressUuid && initialAddress?.uuid === workAddressUuid\n\n  const retrieveWorkAddressQuery = useEmployeeAddressesRetrieveWorkAddress(\n    { workAddressUuid: workAddressUuid ?? '' },\n    { enabled: !!workAddressUuid && !hasInitialAddressMatch },\n  )\n\n  const companyLocations = locationsQuery.data?.companyLocationsList\n\n  const isCreateMode = !workAddressUuid\n\n  const fetchedWorkAddress = workAddressUuid\n    ? hasInitialAddressMatch\n      ? initialAddress\n      : retrieveWorkAddressQuery.data?.employeeWorkAddress\n    : undefined\n\n  const schemaMode = isCreateMode ? 'create' : 'update'\n\n  const [schema, metadataConfig] = useMemo(\n    () =>\n      createWorkAddressSchema({\n        mode: schemaMode,\n        optionalFieldsToRequire,\n        withEffectiveDateField,\n      }),\n    [schemaMode, optionalFieldsToRequire, withEffectiveDateField],\n  )\n\n  const resolvedDefaults: WorkAddressFormData = useMemo(\n    () => ({\n      locationUuid: fetchedWorkAddress?.locationUuid ?? partnerDefaults?.locationUuid ?? '',\n      effectiveDate: fetchedWorkAddress?.effectiveDate ?? partnerDefaults?.effectiveDate ?? '',\n    }),\n    [fetchedWorkAddress, partnerDefaults],\n  )\n\n  const formMethods = useForm<WorkAddressFormData, unknown, WorkAddressFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const createWorkAddressMutation = useEmployeeAddressesCreateWorkAddressMutation()\n  const updateWorkAddressMutation = useEmployeeAddressesUpdateWorkAddressMutation()\n\n  const isPending = createWorkAddressMutation.isPending || updateWorkAddressMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('WorkAddressForm')\n\n  const queriesForErrors = [locationsQuery, ...(workAddressUuid ? [retrieveWorkAddressQuery] : [])]\n  const errorHandling = composeErrorHandler(queriesForErrors, { submitError, setSubmitError })\n\n  const locationOptions = (companyLocations ?? []).map(location => ({\n    value: location.uuid,\n    label: addressInline(location),\n  }))\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = {\n    locationUuid: withOptions<Location>(\n      baseMetadata.locationUuid,\n      locationOptions,\n      companyLocations ?? [],\n    ),\n    effectiveDate: baseMetadata.effectiveDate,\n  }\n\n  const onSubmit = async (\n    callbacks?: WorkAddressSubmitCallbacks,\n    options?: WorkAddressSubmitOptions,\n  ): Promise<HookSubmitResult<EmployeeWorkAddress> | undefined> => {\n    let submitResult: HookSubmitResult<EmployeeWorkAddress> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: WorkAddressFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const resolvedEmployeeId = options?.employeeId ?? employeeId\n\n            if (!resolvedEmployeeId) {\n              throw new SDKInternalError('employeeId is required to submit work address')\n            }\n\n            const resolvedEffectiveDate =\n              withEffectiveDateField && payload.effectiveDate\n                ? payload.effectiveDate\n                : options?.effectiveDate\n\n            const effectiveDateParam = resolvedEffectiveDate\n              ? new RFCDate(new Date(resolvedEffectiveDate))\n              : undefined\n\n            let updatedWorkAddress: EmployeeWorkAddress\n\n            if (isCreateMode) {\n              const result = await createWorkAddressMutation.mutateAsync({\n                request: {\n                  employeeId: resolvedEmployeeId,\n                  requestBody: {\n                    locationUuid: payload.locationUuid,\n                    effectiveDate: effectiveDateParam,\n                  },\n                },\n              })\n\n              if (!result.employeeWorkAddress) {\n                throw new SDKInternalError('Work address creation failed')\n              }\n\n              updatedWorkAddress = result.employeeWorkAddress\n              callbacks?.onWorkAddressCreated?.(updatedWorkAddress)\n            } else {\n              if (!fetchedWorkAddress || !workAddressUuid) {\n                throw new SDKInternalError(\n                  'Cannot update work address: no matching address on file',\n                )\n              }\n\n              const result = await updateWorkAddressMutation.mutateAsync({\n                request: {\n                  workAddressUuid: fetchedWorkAddress.uuid,\n                  requestBody: {\n                    version: fetchedWorkAddress.version,\n                    locationUuid: payload.locationUuid,\n                    effectiveDate: effectiveDateParam,\n                  },\n                },\n              })\n\n              if (!result.employeeWorkAddress) {\n                throw new SDKInternalError('Work address update failed')\n              }\n\n              updatedWorkAddress = result.employeeWorkAddress\n              callbacks?.onWorkAddressUpdated?.(updatedWorkAddress)\n            }\n\n            submitResult = {\n              mode: isCreateMode ? 'create' : 'update',\n              data: updatedWorkAddress,\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 =\n    (!!companyId && locationsQuery.isLoading) ||\n    (!!workAddressUuid && retrieveWorkAddressQuery.isLoading)\n\n  if (!companyId || isDataLoading || !companyLocations) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  if (workAddressUuid && !fetchedWorkAddress) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      workAddress: fetchedWorkAddress ?? null,\n      companyLocations,\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        Location: LocationField,\n        EffectiveDate: withEffectiveDateField ? EffectiveDateField : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Discriminated union returned by {@link useWorkAddressForm}.\n *\n * @public\n */\nexport type UseWorkAddressFormResult = HookLoadingResult | UseWorkAddressFormReady\n/**\n * Type of `form.fieldsMetadata` returned by {@link useWorkAddressForm}.\n *\n * @public\n */\nexport type WorkAddressFieldsMetadata = UseWorkAddressFormReady['form']['fieldsMetadata']\n/**\n * Type of `form.Fields` returned by {@link useWorkAddressForm}.\n *\n * @public\n */\nexport type WorkAddressFormFields = UseWorkAddressFormReady['form']['Fields']\n"],"names":["useWorkAddressForm","companyId","employeeId","workAddressUuid","initialAddress","withEffectiveDateField","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","locationsQuery","useLocationsGet","hasInitialAddressMatch","retrieveWorkAddressQuery","useEmployeeAddressesRetrieveWorkAddress","companyLocations","isCreateMode","fetchedWorkAddress","schemaMode","schema","metadataConfig","useMemo","createWorkAddressSchema","resolvedDefaults","formMethods","useForm","zodResolver","createWorkAddressMutation","useEmployeeAddressesCreateWorkAddressMutation","updateWorkAddressMutation","useEmployeeAddressesUpdateWorkAddressMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","queriesForErrors","errorHandling","composeErrorHandler","locationOptions","location","addressInline","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","withOptions","onSubmit","callbacks","options","submitResult","resolve","data","payload","resolvedEmployeeId","SDKInternalError","resolvedEffectiveDate","effectiveDateParam","RFCDate","updatedWorkAddress","result","hookFormInternals","useHookFormInternals","isDataLoading","LocationField","EffectiveDateField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Employee/Profile/shared/useWorkAddressForm/workAddressSchema.d.ts

@@ -1,25 +1,60 @@
 import { z } from 'zod';
 import { OptionalFieldsToRequire } from '../../../../../partner-hook-utils/form/buildFormSchema';
+/**
+ * Validation error codes emitted by the work address form schema. Map these
+ * codes to localized copy in `validationMessages` when composing the hook.
+ *
+ * @public
+ */
 export declare const WorkAddressErrorCodes: {
     readonly REQUIRED: "REQUIRED";
 };
+/**
+ * Union of validation error code strings emitted by the work address form
+ * schema.
+ *
+ * @public
+ */
 export type WorkAddressErrorCode = (typeof WorkAddressErrorCodes)[keyof typeof WorkAddressErrorCodes];
 declare const fieldValidators: {
     locationUuid: z.ZodString;
     effectiveDate: z.ZodISODate;
 };
+/**
+ * Field names accepted by the work address form.
+ *
+ * @public
+ */
 export type WorkAddressField = keyof typeof fieldValidators;
+/**
+ * Shape of the values managed by the work address form.
+ *
+ * @public
+ */
 export type WorkAddressFormData = {
     [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>;
 };
+/**
+ * Shape of the validated values produced by the work address form on submit.
+ *
+ * @public
+ */
 export type WorkAddressFormOutputs = WorkAddressFormData;
 declare const requiredFieldsConfig: {};
+/**
+ * Keys of optional work address fields that can be promoted to required via
+ * the hook's `optionalFieldsToRequire` option.
+ *
+ * @public
+ */
 export type WorkAddressOptionalFieldsToRequire = OptionalFieldsToRequire<typeof requiredFieldsConfig>;
+/** @internal */
 interface WorkAddressSchemaOptions {
     mode?: 'create' | 'update';
     optionalFieldsToRequire?: WorkAddressOptionalFieldsToRequire;
     withEffectiveDateField?: boolean;
 }
+/** @internal */
 export declare function createWorkAddressSchema(options?: WorkAddressSchemaOptions): import('../../../../../partner-hook-utils/form/buildFormSchema').BuildFormSchemaResult<{
     locationUuid: z.ZodString;
     effectiveDate: z.ZodISODate;

package/dist/components/Employee/Profile/shared/useWorkAddressForm/workAddressSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"workAddressSchema.js","sources":["../../../../../../src/components/Employee/Profile/shared/useWorkAddressForm/workAddressSchema.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\nexport const WorkAddressErrorCodes = {\n  REQUIRED: 'REQUIRED',\n} as const\n\nexport type WorkAddressErrorCode =\n  (typeof WorkAddressErrorCodes)[keyof typeof WorkAddressErrorCodes]\n\n// ── Field validators ───────────────────────────────────────────────────\n\nconst fieldValidators = {\n  locationUuid: z.string().min(1, { message: WorkAddressErrorCodes.REQUIRED }),\n  effectiveDate: z.iso.date({ error: () => WorkAddressErrorCodes.REQUIRED }),\n}\n\nexport type WorkAddressField = keyof typeof fieldValidators\n\nexport type WorkAddressFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\nexport type WorkAddressFormOutputs = WorkAddressFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n\nconst requiredFieldsConfig = {} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\nexport type WorkAddressOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\ninterface WorkAddressSchemaOptions {\n  mode?: 'create' | 'update'\n  optionalFieldsToRequire?: WorkAddressOptionalFieldsToRequire\n  withEffectiveDateField?: boolean\n}\n\nexport function createWorkAddressSchema(options: WorkAddressSchemaOptions = {}) {\n  const { mode = 'create', optionalFieldsToRequire, withEffectiveDateField = true } = options\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: WorkAddressErrorCodes.REQUIRED,\n    mode,\n    optionalFieldsToRequire,\n    excludeFields: withEffectiveDateField ? [] : ['effectiveDate'],\n  })\n}\n"],"names":["WorkAddressErrorCodes","fieldValidators","z","requiredFieldsConfig","createWorkAddressSchema","options","mode","optionalFieldsToRequire","withEffectiveDateField","buildFormSchema"],"mappings":";;AASO,MAAMA,IAAwB;AAAA,EACnC,UAAU;AACZ,GAOMC,IAAkB;AAAA,EACtB,cAAcC,EAAE,OAAA,EAAS,IAAI,GAAG,EAAE,SAASF,EAAsB,UAAU;AAAA,EAC3E,eAAeE,EAAE,IAAI,KAAK,EAAE,OAAO,MAAMF,EAAsB,SAAA,CAAU;AAC3E,GAWMG,IAAuB,CAAA;AActB,SAASC,EAAwBC,IAAoC,IAAI;AAC9E,QAAM,EAAE,MAAAC,IAAO,UAAU,yBAAAC,GAAyB,wBAAAC,IAAyB,OAASH;AAEpF,SAAOI,EAAgBR,GAAiB;AAAA,IACtC,sBAAAE;AAAA,IACA,mBAAmBH,EAAsB;AAAA,IACzC,MAAAM;AAAA,IACA,yBAAAC;AAAA,IACA,eAAeC,IAAyB,CAAA,IAAK,CAAC,eAAe;AAAA,EAAA,CAC9D;AACH;"}
+{"version":3,"file":"workAddressSchema.js","sources":["../../../../../../src/components/Employee/Profile/shared/useWorkAddressForm/workAddressSchema.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 work address form schema. Map these\n * codes to localized copy in `validationMessages` when composing the hook.\n *\n * @public\n */\nexport const WorkAddressErrorCodes = {\n  REQUIRED: 'REQUIRED',\n} as const\n\n/**\n * Union of validation error code strings emitted by the work address form\n * schema.\n *\n * @public\n */\nexport type WorkAddressErrorCode =\n  (typeof WorkAddressErrorCodes)[keyof typeof WorkAddressErrorCodes]\n\n// ── Field validators ───────────────────────────────────────────────────\n\nconst fieldValidators = {\n  locationUuid: z.string().min(1, { message: WorkAddressErrorCodes.REQUIRED }),\n  effectiveDate: z.iso.date({ error: () => WorkAddressErrorCodes.REQUIRED }),\n}\n\n/**\n * Field names accepted by the work address form.\n *\n * @public\n */\nexport type WorkAddressField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the work address form.\n *\n * @public\n */\nexport type WorkAddressFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n/**\n * Shape of the validated values produced by the work address form on submit.\n *\n * @public\n */\nexport type WorkAddressFormOutputs = WorkAddressFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n\nconst requiredFieldsConfig = {} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\n/**\n * Keys of optional work address fields that can be promoted to required via\n * the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type WorkAddressOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface WorkAddressSchemaOptions {\n  mode?: 'create' | 'update'\n  optionalFieldsToRequire?: WorkAddressOptionalFieldsToRequire\n  withEffectiveDateField?: boolean\n}\n\n/** @internal */\nexport function createWorkAddressSchema(options: WorkAddressSchemaOptions = {}) {\n  const { mode = 'create', optionalFieldsToRequire, withEffectiveDateField = true } = options\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: WorkAddressErrorCodes.REQUIRED,\n    mode,\n    optionalFieldsToRequire,\n    excludeFields: withEffectiveDateField ? [] : ['effectiveDate'],\n  })\n}\n"],"names":["WorkAddressErrorCodes","fieldValidators","z","requiredFieldsConfig","createWorkAddressSchema","options","mode","optionalFieldsToRequire","withEffectiveDateField","buildFormSchema"],"mappings":";;AAeO,MAAMA,IAAwB;AAAA,EACnC,UAAU;AACZ,GAaMC,IAAkB;AAAA,EACtB,cAAcC,EAAE,OAAA,EAAS,IAAI,GAAG,EAAE,SAASF,EAAsB,UAAU;AAAA,EAC3E,eAAeE,EAAE,IAAI,KAAK,EAAE,OAAO,MAAMF,EAAsB,SAAA,CAAU;AAC3E,GA0BMG,IAAuB,CAAA;AAsBtB,SAASC,EAAwBC,IAAoC,IAAI;AAC9E,QAAM,EAAE,MAAAC,IAAO,UAAU,yBAAAC,GAAyB,wBAAAC,IAAyB,OAASH;AAEpF,SAAOI,EAAgBR,GAAiB;AAAA,IACtC,sBAAAE;AAAA,IACA,mBAAmBH,EAAsB;AAAA,IACzC,MAAAM;AAAA,IACA,yBAAAC;AAAA,IACA,eAAeC,IAAyB,CAAA,IAAK,CAAC,eAAe;AAAA,EAAA,CAC9D;AACH;"}

package/dist/components/Employee/SelfOnboardingFlow/SelfOnboardingComponents.d.ts

@@ -1,21 +1,37 @@
 import { PaymentMethodBankAccount } from '@gusto/embedded-api-v-2025-11-15/models/components/paymentmethodbankaccount';
 import { FlowContextInterface } from '../../Flow/useFlow';
 import { BaseComponentInterface } from '../../Base';
+/**
+ * Props for {@link SelfOnboardingFlow}.
+ *
+ * @public
+ */
 export interface SelfOnboardingFlowProps extends BaseComponentInterface {
+    /** The associated company identifier. */
     companyId: string;
+    /** The associated employee identifier. */
     employeeId: string;
+    /** When true, the Document Signer step checks if the employee has I-9 enabled and routes to the Employment Eligibility and I-9 signature form steps. Defaults to `false`. */
     withEmployeeI9?: boolean;
 }
+/** @internal */
 export interface SelfOnboardingContextInterface extends FlowContextInterface {
     companyId: string;
     employeeId: string;
     withEmployeeI9?: boolean;
     paymentMethod?: PaymentMethodBankAccount;
 }
+/** @internal */
 export declare function Landing(): import("react").JSX.Element;
+/** @internal */
 export declare function Profile(): import("react").JSX.Element;
+/** @internal */
 export declare function FederalTaxes(): import("react").JSX.Element;
+/** @internal */
 export declare function StateTaxes(): import("react").JSX.Element;
+/** @internal */
 export declare function PaymentMethod(): import("react").JSX.Element;
+/** @internal */
 export declare function OnboardingSummary(): import("react").JSX.Element;
+/** @internal */
 export declare function DocumentSigner(): import("react").JSX.Element;

package/dist/components/Employee/SelfOnboardingFlow/SelfOnboardingComponents.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelfOnboardingComponents.js","sources":["../../../../src/components/Employee/SelfOnboardingFlow/SelfOnboardingComponents.tsx"],"sourcesContent":["import type { PaymentMethodBankAccount } from '@gusto/embedded-api-v-2025-11-15/models/components/paymentmethodbankaccount'\nimport { ensureRequired } from '@/helpers/ensureRequired'\nimport type { FlowContextInterface } from '@/components/Flow/useFlow'\nimport { useFlow } from '@/components/Flow/useFlow'\nimport type { BaseComponentInterface } from '@/components/Base'\nimport { Landing as LandingComponent } from '@/components/Employee/Landing'\nimport { Profile as ProfileComponent } from '@/components/Employee/Profile/onboarding/Profile'\nimport { FederalTaxes as FederalTaxesComponent } from '@/components/Employee/FederalTaxes/onboarding/FederalTaxes'\nimport { StateTaxes as StateTaxesComponent } from '@/components/Employee/StateTaxes/onboarding'\nimport { PaymentMethod as PaymentMethodComponent } from '@/components/Employee/PaymentMethod'\nimport { OnboardingSummary as OnboardingSummaryComponent } from '@/components/Employee/OnboardingSummary'\nimport { DocumentSigner as DocumentSignerComponent } from '@/components/Employee/Documents/onboarding/DocumentSigner'\n\nexport interface SelfOnboardingFlowProps extends BaseComponentInterface {\n  companyId: string\n  employeeId: string\n  withEmployeeI9?: boolean\n}\nexport interface SelfOnboardingContextInterface extends FlowContextInterface {\n  companyId: string\n  employeeId: string\n  withEmployeeI9?: boolean\n  paymentMethod?: PaymentMethodBankAccount\n}\n\nexport function Landing() {\n  const { companyId, employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <LandingComponent\n      companyId={ensureRequired(companyId)}\n      employeeId={ensureRequired(employeeId)}\n      onEvent={onEvent}\n    />\n  )\n}\n\nexport function Profile() {\n  const { companyId, employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <ProfileComponent\n      companyId={ensureRequired(companyId)}\n      employeeId={ensureRequired(employeeId)}\n      onEvent={onEvent}\n      isAdmin={false}\n    />\n  )\n}\n\nexport function FederalTaxes() {\n  const { employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return <FederalTaxesComponent employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n\nexport function StateTaxes() {\n  const { employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <StateTaxesComponent\n      employeeId={ensureRequired(employeeId)}\n      onEvent={onEvent}\n      isAdmin={false}\n    />\n  )\n}\n\nexport function PaymentMethod() {\n  const { employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return <PaymentMethodComponent employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n\nexport function OnboardingSummary() {\n  const { employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <OnboardingSummaryComponent\n      employeeId={ensureRequired(employeeId)}\n      onEvent={onEvent}\n      isAdmin={false}\n    />\n  )\n}\n\nexport function DocumentSigner() {\n  const { employeeId, withEmployeeI9 = false, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <DocumentSignerComponent\n      employeeId={ensureRequired(employeeId)}\n      withEmployeeI9={withEmployeeI9}\n      onEvent={onEvent}\n    />\n  )\n}\n"],"names":["Landing","companyId","employeeId","onEvent","useFlow","jsx","LandingComponent","ensureRequired","Profile","ProfileComponent","FederalTaxes","FederalTaxesComponent","StateTaxes","StateTaxesComponent","PaymentMethod","PaymentMethodComponent","OnboardingSummary","OnboardingSummaryComponent","DocumentSigner","withEmployeeI9","DocumentSignerComponent"],"mappings":";;;;;;;;;;AAyBO,SAASA,IAAU;AACxB,QAAM,EAAE,WAAAC,GAAW,YAAAC,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAC3C,SACE,gBAAAC;AAAA,IAACC;AAAAA,IAAA;AAAA,MACC,WAAWC,EAAeN,CAAS;AAAA,MACnC,YAAYM,EAAeL,CAAU;AAAA,MACrC,SAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;AAEO,SAASK,IAAU;AACxB,QAAM,EAAE,WAAAP,GAAW,YAAAC,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAC3C,SACE,gBAAAC;AAAA,IAACI;AAAAA,IAAA;AAAA,MACC,WAAWF,EAAeN,CAAS;AAAA,MACnC,YAAYM,EAAeL,CAAU;AAAA,MACrC,SAAAC;AAAA,MACA,SAAS;AAAA,IAAA;AAAA,EAAA;AAGf;AAEO,SAASO,IAAe;AAC7B,QAAM,EAAE,YAAAR,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,2BAAQO,GAAA,EAAsB,YAAYJ,EAAeL,CAAU,GAAG,SAAAC,GAAkB;AAC1F;AAEO,SAASS,IAAa;AAC3B,QAAM,EAAE,YAAAV,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,SACE,gBAAAC;AAAA,IAACQ;AAAAA,IAAA;AAAA,MACC,YAAYN,EAAeL,CAAU;AAAA,MACrC,SAAAC;AAAA,MACA,SAAS;AAAA,IAAA;AAAA,EAAA;AAGf;AAEO,SAASW,IAAgB;AAC9B,QAAM,EAAE,YAAAZ,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,2BAAQW,GAAA,EAAuB,YAAYR,EAAeL,CAAU,GAAG,SAAAC,GAAkB;AAC3F;AAEO,SAASa,IAAoB;AAClC,QAAM,EAAE,YAAAd,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,SACE,gBAAAC;AAAA,IAACY;AAAAA,IAAA;AAAA,MACC,YAAYV,EAAeL,CAAU;AAAA,MACrC,SAAAC;AAAA,MACA,SAAS;AAAA,IAAA;AAAA,EAAA;AAGf;AAEO,SAASe,IAAiB;AAC/B,QAAM,EAAE,YAAAhB,GAAY,gBAAAiB,IAAiB,IAAO,SAAAhB,EAAA,IAAYC,EAAA;AACxD,SACE,gBAAAC;AAAA,IAACe;AAAAA,IAAA;AAAA,MACC,YAAYb,EAAeL,CAAU;AAAA,MACrC,gBAAAiB;AAAA,MACA,SAAAhB;AAAA,IAAA;AAAA,EAAA;AAGN;"}
+{"version":3,"file":"SelfOnboardingComponents.js","sources":["../../../../src/components/Employee/SelfOnboardingFlow/SelfOnboardingComponents.tsx"],"sourcesContent":["import type { PaymentMethodBankAccount } from '@gusto/embedded-api-v-2025-11-15/models/components/paymentmethodbankaccount'\nimport { ensureRequired } from '@/helpers/ensureRequired'\nimport type { FlowContextInterface } from '@/components/Flow/useFlow'\nimport { useFlow } from '@/components/Flow/useFlow'\nimport type { BaseComponentInterface } from '@/components/Base'\nimport { Landing as LandingComponent } from '@/components/Employee/Landing'\nimport { Profile as ProfileComponent } from '@/components/Employee/Profile/onboarding/Profile'\nimport { FederalTaxes as FederalTaxesComponent } from '@/components/Employee/FederalTaxes/onboarding/FederalTaxes'\nimport { StateTaxes as StateTaxesComponent } from '@/components/Employee/StateTaxes/onboarding'\nimport { PaymentMethod as PaymentMethodComponent } from '@/components/Employee/PaymentMethod'\nimport { OnboardingSummary as OnboardingSummaryComponent } from '@/components/Employee/OnboardingSummary'\nimport { DocumentSigner as DocumentSignerComponent } from '@/components/Employee/Documents/onboarding/DocumentSigner'\n\n/**\n * Props for {@link SelfOnboardingFlow}.\n *\n * @public\n */\nexport interface SelfOnboardingFlowProps extends BaseComponentInterface {\n  /** The associated company identifier. */\n  companyId: string\n  /** The associated employee identifier. */\n  employeeId: string\n  /** When true, the Document Signer step checks if the employee has I-9 enabled and routes to the Employment Eligibility and I-9 signature form steps. Defaults to `false`. */\n  withEmployeeI9?: boolean\n}\n\n/** @internal */\nexport interface SelfOnboardingContextInterface extends FlowContextInterface {\n  companyId: string\n  employeeId: string\n  withEmployeeI9?: boolean\n  paymentMethod?: PaymentMethodBankAccount\n}\n\n/** @internal */\nexport function Landing() {\n  const { companyId, employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <LandingComponent\n      companyId={ensureRequired(companyId)}\n      employeeId={ensureRequired(employeeId)}\n      onEvent={onEvent}\n    />\n  )\n}\n\n/** @internal */\nexport function Profile() {\n  const { companyId, employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <ProfileComponent\n      companyId={ensureRequired(companyId)}\n      employeeId={ensureRequired(employeeId)}\n      onEvent={onEvent}\n      isAdmin={false}\n    />\n  )\n}\n\n/** @internal */\nexport function FederalTaxes() {\n  const { employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return <FederalTaxesComponent employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n\n/** @internal */\nexport function StateTaxes() {\n  const { employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <StateTaxesComponent\n      employeeId={ensureRequired(employeeId)}\n      onEvent={onEvent}\n      isAdmin={false}\n    />\n  )\n}\n\n/** @internal */\nexport function PaymentMethod() {\n  const { employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return <PaymentMethodComponent employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n\n/** @internal */\nexport function OnboardingSummary() {\n  const { employeeId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <OnboardingSummaryComponent\n      employeeId={ensureRequired(employeeId)}\n      onEvent={onEvent}\n      isAdmin={false}\n    />\n  )\n}\n\n/** @internal */\nexport function DocumentSigner() {\n  const { employeeId, withEmployeeI9 = false, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <DocumentSignerComponent\n      employeeId={ensureRequired(employeeId)}\n      withEmployeeI9={withEmployeeI9}\n      onEvent={onEvent}\n    />\n  )\n}\n"],"names":["Landing","companyId","employeeId","onEvent","useFlow","jsx","LandingComponent","ensureRequired","Profile","ProfileComponent","FederalTaxes","FederalTaxesComponent","StateTaxes","StateTaxesComponent","PaymentMethod","PaymentMethodComponent","OnboardingSummary","OnboardingSummaryComponent","DocumentSigner","withEmployeeI9","DocumentSignerComponent"],"mappings":";;;;;;;;;;AAoCO,SAASA,IAAU;AACxB,QAAM,EAAE,WAAAC,GAAW,YAAAC,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAC3C,SACE,gBAAAC;AAAA,IAACC;AAAAA,IAAA;AAAA,MACC,WAAWC,EAAeN,CAAS;AAAA,MACnC,YAAYM,EAAeL,CAAU;AAAA,MACrC,SAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASK,IAAU;AACxB,QAAM,EAAE,WAAAP,GAAW,YAAAC,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAC3C,SACE,gBAAAC;AAAA,IAACI;AAAAA,IAAA;AAAA,MACC,WAAWF,EAAeN,CAAS;AAAA,MACnC,YAAYM,EAAeL,CAAU;AAAA,MACrC,SAAAC;AAAA,MACA,SAAS;AAAA,IAAA;AAAA,EAAA;AAGf;AAGO,SAASO,IAAe;AAC7B,QAAM,EAAE,YAAAR,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,2BAAQO,GAAA,EAAsB,YAAYJ,EAAeL,CAAU,GAAG,SAAAC,GAAkB;AAC1F;AAGO,SAASS,IAAa;AAC3B,QAAM,EAAE,YAAAV,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,SACE,gBAAAC;AAAA,IAACQ;AAAAA,IAAA;AAAA,MACC,YAAYN,EAAeL,CAAU;AAAA,MACrC,SAAAC;AAAA,MACA,SAAS;AAAA,IAAA;AAAA,EAAA;AAGf;AAGO,SAASW,IAAgB;AAC9B,QAAM,EAAE,YAAAZ,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,2BAAQW,GAAA,EAAuB,YAAYR,EAAeL,CAAU,GAAG,SAAAC,GAAkB;AAC3F;AAGO,SAASa,IAAoB;AAClC,QAAM,EAAE,YAAAd,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,SACE,gBAAAC;AAAA,IAACY;AAAAA,IAAA;AAAA,MACC,YAAYV,EAAeL,CAAU;AAAA,MACrC,SAAAC;AAAA,MACA,SAAS;AAAA,IAAA;AAAA,EAAA;AAGf;AAGO,SAASe,IAAiB;AAC/B,QAAM,EAAE,YAAAhB,GAAY,gBAAAiB,IAAiB,IAAO,SAAAhB,EAAA,IAAYC,EAAA;AACxD,SACE,gBAAAC;AAAA,IAACe;AAAAA,IAAA;AAAA,MACC,YAAYb,EAAeL,CAAU;AAAA,MACrC,gBAAAiB;AAAA,MACA,SAAAhB;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Employee/SelfOnboardingFlow/SelfOnboardingFlow.d.ts

@@ -1,2 +1,33 @@
 import { SelfOnboardingFlowProps } from './SelfOnboardingComponents';
+/**
+ * Employee-driven onboarding workflow — landing, profile, taxes, payment method, and document signing.
+ *
+ * @remarks
+ * Hands the employee responsibility for submitting their own profile, tax, payment, and document-signing information. Drives a multi-step flow keyed to the employee being self-onboarded; when `withEmployeeI9` is enabled, the Document Signer step checks whether the employee has I-9 enabled and, if so, routes them through the employment-eligibility form before presenting the I-9 form alongside other required documents.
+ *
+ * Each step is also exported as a standalone block — see {@link Landing}, {@link Profile}, {@link FederalTaxes}, {@link StateTaxes}, {@link PaymentMethod}, {@link DocumentSigner}, {@link EmploymentEligibility}, and {@link OnboardingSummary} — for composing a custom workflow when this orchestration is the wrong fit.
+ *
+ * The flow forwards every event emitted by its sub-components to `onEvent`; see the events table on each sub-component for the full set of events and payloads observable from this flow.
+ *
+ * @param props - See {@link SelfOnboardingFlowProps}.
+ * @returns The multi-step self-onboarding flow.
+ * @public
+ * @group Flow Components
+ *
+ * @example
+ * ```tsx
+ * import { EmployeeOnboarding } from '@gusto/embedded-react-sdk'
+ *
+ * function MyApp() {
+ *   return (
+ *     <EmployeeOnboarding.SelfOnboardingFlow
+ *       companyId="a007e1ab-3595-43c2-ab4b-af7a5af2e365"
+ *       employeeId="4b3f930f-82cd-48a8-b797-798686e12e5e"
+ *       withEmployeeI9
+ *       onEvent={() => {}}
+ *     />
+ *   )
+ * }
+ * ```
+ */
 export declare const SelfOnboardingFlow: ({ companyId, employeeId, withEmployeeI9, onEvent, }: SelfOnboardingFlowProps) => import("react").JSX.Element;

package/dist/components/Employee/SelfOnboardingFlow/SelfOnboardingFlow.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelfOnboardingFlow.js","sources":["../../../../src/components/Employee/SelfOnboardingFlow/SelfOnboardingFlow.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport type {\n  SelfOnboardingContextInterface,\n  SelfOnboardingFlowProps,\n} from './SelfOnboardingComponents'\nimport { Landing } from './SelfOnboardingComponents'\nimport { employeeSelfOnboardingMachine } from './selfOnboardingMachine'\nimport { Flow } from '@/components/Flow/Flow'\n\nexport const SelfOnboardingFlow = ({\n  companyId,\n  employeeId,\n  withEmployeeI9 = false,\n  onEvent,\n}: SelfOnboardingFlowProps) => {\n  const manageEmployees = useMemo(\n    () =>\n      createMachine(\n        'index',\n        employeeSelfOnboardingMachine,\n        (initialContext: SelfOnboardingContextInterface) => ({\n          ...initialContext,\n          component: Landing,\n          companyId,\n          employeeId,\n          withEmployeeI9,\n        }),\n      ),\n    [companyId, employeeId, withEmployeeI9],\n  )\n  return <Flow machine={manageEmployees} onEvent={onEvent} />\n}\n"],"names":["SelfOnboardingFlow","companyId","employeeId","withEmployeeI9","onEvent","manageEmployees","useMemo","createMachine","employeeSelfOnboardingMachine","initialContext","Landing","jsx","Flow"],"mappings":";;;;;;AAUO,MAAMA,IAAqB,CAAC;AAAA,EACjC,WAAAC;AAAA,EACA,YAAAC;AAAA,EACA,gBAAAC,IAAiB;AAAA,EACjB,SAAAC;AACF,MAA+B;AAC7B,QAAMC,IAAkBC;AAAA,IACtB,MACEC;AAAA,MACE;AAAA,MACAC;AAAA,MACA,CAACC,OAAoD;AAAA,QACnD,GAAGA;AAAA,QACH,WAAWC;AAAA,QACX,WAAAT;AAAA,QACA,YAAAC;AAAA,QACA,gBAAAC;AAAA,MAAA;AAAA,IACF;AAAA,IAEJ,CAACF,GAAWC,GAAYC,CAAc;AAAA,EAAA;AAExC,SAAO,gBAAAQ,EAACC,GAAA,EAAK,SAASP,GAAiB,SAAAD,EAAA,CAAkB;AAC3D;"}
+{"version":3,"file":"SelfOnboardingFlow.js","sources":["../../../../src/components/Employee/SelfOnboardingFlow/SelfOnboardingFlow.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport type {\n  SelfOnboardingContextInterface,\n  SelfOnboardingFlowProps,\n} from './SelfOnboardingComponents'\nimport { Landing } from './SelfOnboardingComponents'\nimport { employeeSelfOnboardingMachine } from './selfOnboardingMachine'\nimport { Flow } from '@/components/Flow/Flow'\n\n/**\n * Employee-driven onboarding workflow — landing, profile, taxes, payment method, and document signing.\n *\n * @remarks\n * Hands the employee responsibility for submitting their own profile, tax, payment, and document-signing information. Drives a multi-step flow keyed to the employee being self-onboarded; when `withEmployeeI9` is enabled, the Document Signer step checks whether the employee has I-9 enabled and, if so, routes them through the employment-eligibility form before presenting the I-9 form alongside other required documents.\n *\n * Each step is also exported as a standalone block — see {@link Landing}, {@link Profile}, {@link FederalTaxes}, {@link StateTaxes}, {@link PaymentMethod}, {@link DocumentSigner}, {@link EmploymentEligibility}, and {@link OnboardingSummary} — for composing a custom workflow when this orchestration is the wrong fit.\n *\n * The flow forwards every event emitted by its sub-components to `onEvent`; see the events table on each sub-component for the full set of events and payloads observable from this flow.\n *\n * @param props - See {@link SelfOnboardingFlowProps}.\n * @returns The multi-step self-onboarding flow.\n * @public\n * @group Flow Components\n *\n * @example\n * ```tsx\n * import { EmployeeOnboarding } from '@gusto/embedded-react-sdk'\n *\n * function MyApp() {\n *   return (\n *     <EmployeeOnboarding.SelfOnboardingFlow\n *       companyId=\"a007e1ab-3595-43c2-ab4b-af7a5af2e365\"\n *       employeeId=\"4b3f930f-82cd-48a8-b797-798686e12e5e\"\n *       withEmployeeI9\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport const SelfOnboardingFlow = ({\n  companyId,\n  employeeId,\n  withEmployeeI9 = false,\n  onEvent,\n}: SelfOnboardingFlowProps) => {\n  const manageEmployees = useMemo(\n    () =>\n      createMachine(\n        'index',\n        employeeSelfOnboardingMachine,\n        (initialContext: SelfOnboardingContextInterface) => ({\n          ...initialContext,\n          component: Landing,\n          companyId,\n          employeeId,\n          withEmployeeI9,\n        }),\n      ),\n    [companyId, employeeId, withEmployeeI9],\n  )\n  return <Flow machine={manageEmployees} onEvent={onEvent} />\n}\n"],"names":["SelfOnboardingFlow","companyId","employeeId","withEmployeeI9","onEvent","manageEmployees","useMemo","createMachine","employeeSelfOnboardingMachine","initialContext","Landing","jsx","Flow"],"mappings":";;;;;;AAyCO,MAAMA,IAAqB,CAAC;AAAA,EACjC,WAAAC;AAAA,EACA,YAAAC;AAAA,EACA,gBAAAC,IAAiB;AAAA,EACjB,SAAAC;AACF,MAA+B;AAC7B,QAAMC,IAAkBC;AAAA,IACtB,MACEC;AAAA,MACE;AAAA,MACAC;AAAA,MACA,CAACC,OAAoD;AAAA,QACnD,GAAGA;AAAA,QACH,WAAWC;AAAA,QACX,WAAAT;AAAA,QACA,YAAAC;AAAA,QACA,gBAAAC;AAAA,MAAA;AAAA,IACF;AAAA,IAEJ,CAACF,GAAWC,GAAYC,CAAc;AAAA,EAAA;AAExC,SAAO,gBAAAQ,EAACC,GAAA,EAAK,SAASP,GAAiB,SAAAD,EAAA,CAAkB;AAC3D;"}

package/dist/components/Employee/SelfOnboardingFlow/selfOnboardingMachine.d.ts

@@ -1,3 +1,4 @@
+/** @internal */
 export declare const employeeSelfOnboardingMachine: {
     index: import('robot3').MachineState<any>;
     employeeProfile: import('robot3').MachineState<any>;

package/dist/components/Employee/SelfOnboardingFlow/selfOnboardingMachine.js.map

@@ -1 +1 @@
-{"version":3,"file":"selfOnboardingMachine.js","sources":["../../../../src/components/Employee/SelfOnboardingFlow/selfOnboardingMachine.ts"],"sourcesContent":["import { transition, reduce, state } from 'robot3'\nimport type { SelfOnboardingContextInterface } from './SelfOnboardingComponents'\nimport {\n  Profile,\n  FederalTaxes,\n  StateTaxes,\n  PaymentMethod,\n  OnboardingSummary,\n  DocumentSigner,\n} from './SelfOnboardingComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineTransition } from '@/types/Helpers'\n\nexport const employeeSelfOnboardingMachine = {\n  index: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_SELF_ONBOARDING_START,\n      'employeeProfile',\n      reduce(\n        (ctx: SelfOnboardingContextInterface): SelfOnboardingContextInterface => ({\n          ...ctx,\n          component: Profile,\n        }),\n      ),\n    ),\n  ),\n  employeeProfile: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_PROFILE_DONE,\n      'employeeFederalTaxes',\n      reduce(\n        (ctx: SelfOnboardingContextInterface): SelfOnboardingContextInterface => ({\n          ...ctx,\n          component: FederalTaxes,\n        }),\n      ),\n    ),\n  ),\n  employeeFederalTaxes: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_FEDERAL_TAXES_DONE,\n      'employeeStateTaxes',\n      reduce(\n        (ctx: SelfOnboardingContextInterface): SelfOnboardingContextInterface => ({\n          ...ctx,\n          component: StateTaxes,\n        }),\n      ),\n    ),\n  ),\n  employeeStateTaxes: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_STATE_TAXES_DONE,\n      'employeePaymentMethod',\n      reduce((ctx: SelfOnboardingContextInterface) => ({\n        ...ctx,\n        component: PaymentMethod,\n      })),\n    ),\n  ),\n  employeePaymentMethod: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_PAYMENT_METHOD_DONE,\n      'employeeDocumentSigner',\n      reduce((ctx: SelfOnboardingContextInterface) => ({\n        ...ctx,\n        component: DocumentSigner,\n      })),\n    ),\n  ),\n  employeeDocumentSigner: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_FORMS_DONE,\n      'index',\n      reduce((ctx: SelfOnboardingContextInterface) => ({\n        ...ctx,\n        component: OnboardingSummary,\n      })),\n    ),\n  ),\n}\n"],"names":["employeeSelfOnboardingMachine","state","transition","componentEvents","reduce","ctx","Profile","FederalTaxes","StateTaxes","PaymentMethod","DocumentSigner","OnboardingSummary"],"mappings":";;;AAaO,MAAMA,IAAgC;AAAA,EAC3C,OAAOC;AAAA,IACLC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CAACC,OAAyE;AAAA,UACxE,GAAGA;AAAA,UACH,WAAWC;AAAA,QAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAEF,iBAAiBL;AAAA,IACfC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CAACC,OAAyE;AAAA,UACxE,GAAGA;AAAA,UACH,WAAWE;AAAA,QAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAEF,sBAAsBN;AAAA,IACpBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CAACC,OAAyE;AAAA,UACxE,GAAGA;AAAA,UACH,WAAWG;AAAA,QAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAEF,oBAAoBP;AAAA,IAClBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyC;AAAA,QAC/C,GAAGA;AAAA,QACH,WAAWI;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAAA,EAEF,uBAAuBR;AAAA,IACrBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyC;AAAA,QAC/C,GAAGA;AAAA,QACH,WAAWK;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAAA,EAEF,wBAAwBT;AAAA,IACtBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyC;AAAA,QAC/C,GAAGA;AAAA,QACH,WAAWM;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAEJ;"}
+{"version":3,"file":"selfOnboardingMachine.js","sources":["../../../../src/components/Employee/SelfOnboardingFlow/selfOnboardingMachine.ts"],"sourcesContent":["import { transition, reduce, state } from 'robot3'\nimport type { SelfOnboardingContextInterface } from './SelfOnboardingComponents'\nimport {\n  Profile,\n  FederalTaxes,\n  StateTaxes,\n  PaymentMethod,\n  OnboardingSummary,\n  DocumentSigner,\n} from './SelfOnboardingComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineTransition } from '@/types/Helpers'\n\n/** @internal */\nexport const employeeSelfOnboardingMachine = {\n  index: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_SELF_ONBOARDING_START,\n      'employeeProfile',\n      reduce(\n        (ctx: SelfOnboardingContextInterface): SelfOnboardingContextInterface => ({\n          ...ctx,\n          component: Profile,\n        }),\n      ),\n    ),\n  ),\n  employeeProfile: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_PROFILE_DONE,\n      'employeeFederalTaxes',\n      reduce(\n        (ctx: SelfOnboardingContextInterface): SelfOnboardingContextInterface => ({\n          ...ctx,\n          component: FederalTaxes,\n        }),\n      ),\n    ),\n  ),\n  employeeFederalTaxes: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_FEDERAL_TAXES_DONE,\n      'employeeStateTaxes',\n      reduce(\n        (ctx: SelfOnboardingContextInterface): SelfOnboardingContextInterface => ({\n          ...ctx,\n          component: StateTaxes,\n        }),\n      ),\n    ),\n  ),\n  employeeStateTaxes: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_STATE_TAXES_DONE,\n      'employeePaymentMethod',\n      reduce((ctx: SelfOnboardingContextInterface) => ({\n        ...ctx,\n        component: PaymentMethod,\n      })),\n    ),\n  ),\n  employeePaymentMethod: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_PAYMENT_METHOD_DONE,\n      'employeeDocumentSigner',\n      reduce((ctx: SelfOnboardingContextInterface) => ({\n        ...ctx,\n        component: DocumentSigner,\n      })),\n    ),\n  ),\n  employeeDocumentSigner: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_FORMS_DONE,\n      'index',\n      reduce((ctx: SelfOnboardingContextInterface) => ({\n        ...ctx,\n        component: OnboardingSummary,\n      })),\n    ),\n  ),\n}\n"],"names":["employeeSelfOnboardingMachine","state","transition","componentEvents","reduce","ctx","Profile","FederalTaxes","StateTaxes","PaymentMethod","DocumentSigner","OnboardingSummary"],"mappings":";;;AAcO,MAAMA,IAAgC;AAAA,EAC3C,OAAOC;AAAA,IACLC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CAACC,OAAyE;AAAA,UACxE,GAAGA;AAAA,UACH,WAAWC;AAAA,QAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAEF,iBAAiBL;AAAA,IACfC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CAACC,OAAyE;AAAA,UACxE,GAAGA;AAAA,UACH,WAAWE;AAAA,QAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAEF,sBAAsBN;AAAA,IACpBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CAACC,OAAyE;AAAA,UACxE,GAAGA;AAAA,UACH,WAAWG;AAAA,QAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAEF,oBAAoBP;AAAA,IAClBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyC;AAAA,QAC/C,GAAGA;AAAA,QACH,WAAWI;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAAA,EAEF,uBAAuBR;AAAA,IACrBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyC;AAAA,QAC/C,GAAGA;AAAA,QACH,WAAWK;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAAA,EAEF,wBAAwBT;AAAA,IACtBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyC;AAAA,QAC/C,GAAGA;AAAA,QACH,WAAWM;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAEJ;"}

package/dist/components/Employee/StateTaxes/index.d.ts

@@ -1,3 +1,3 @@
 import "./types/i18next.d.ts"
-export { StateTaxes, StateTaxesCard, StateTaxesEditForm, type StateTaxesProps, type StateTaxesCardProps, type StateTaxesEditFormProps, } from './management';
+export { StateTaxes } from './management';
 export * from './shared';

package/dist/components/Employee/StateTaxes/management/StateTaxes.d.ts

@@ -1,8 +1,32 @@
 import { BaseComponentInterface, CommonComponentInterface } from '../../../Base';
 import { EventType } from '../../../../shared/constants';
 import { OnEventType } from '../../../Base/useBase';
+/**
+ * Props for {@link StateTaxes}.
+ *
+ * @public
+ */
 export interface StateTaxesProps extends CommonComponentInterface<'Employee.Management.StateTaxes'> {
+    /** The associated employee identifier. */
     employeeId: string;
+    /** Event handler fired on flow state changes. */
     onEvent: OnEventType<EventType, unknown>;
 }
+/**
+ * Standalone state-tax management flow for a given employee. Renders the
+ * read-only summary card and the edit form, switching between them as the
+ * partner-emitted events from {@link StateTaxesCard} and {@link StateTaxesEditForm}
+ * drive the internal state machine.
+ *
+ * @remarks
+ *
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `employee/management/stateTaxes/editRequested` | Edit button on the summary card was clicked | `{ employeeId: string }` |
+ * | `employee/management/stateTaxes/editCancelled` | Cancel button on the edit form was clicked | — |
+ * | `employee/management/stateTaxes/updated` | Edit form was submitted successfully | `{ employeeStateTaxesList: EmployeeStateTaxesList[] }` |
+ *
+ * @param props - The component props.
+ * @public
+ */
 export declare function StateTaxes({ dictionary, FallbackComponent, ...props }: StateTaxesProps & BaseComponentInterface<'Employee.Management.StateTaxes'>): import("react").JSX.Element;

package/dist/components/Employee/StateTaxes/management/StateTaxes.js.map

@@ -1 +1 @@
-{"version":3,"file":"StateTaxes.js","sources":["../../../../../src/components/Employee/StateTaxes/management/StateTaxes.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport { StateTaxesCardContextual, type StateTaxesContextInterface } from './StateTaxesComponents'\nimport { stateTaxesStateMachine } from './stateTaxesStateMachine'\nimport { Flow } from '@/components/Flow/Flow'\nimport {\n  BaseBoundaries,\n  type BaseComponentInterface,\n  type CommonComponentInterface,\n} from '@/components/Base'\nimport { type EventType } from '@/shared/constants'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport { useI18n } from '@/i18n'\nimport type { OnEventType } from '@/components/Base/useBase'\n\nexport interface StateTaxesProps extends CommonComponentInterface<'Employee.Management.StateTaxes'> {\n  employeeId: string\n  onEvent: OnEventType<EventType, unknown>\n}\n\nfunction StateTaxesFlow({ employeeId, onEvent }: StateTaxesProps) {\n  useI18n('Employee.Management.StateTaxes')\n\n  const machine = useMemo(\n    () =>\n      createMachine('card', stateTaxesStateMachine, (ctx: StateTaxesContextInterface) => ({\n        ...ctx,\n        component: StateTaxesCardContextual,\n        employeeId,\n      })),\n    [employeeId],\n  )\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n\nexport function StateTaxes({\n  dictionary,\n  FallbackComponent,\n  ...props\n}: StateTaxesProps & BaseComponentInterface<'Employee.Management.StateTaxes'>) {\n  useComponentDictionary('Employee.Management.StateTaxes', dictionary)\n  return (\n    <BaseBoundaries\n      componentName=\"Employee.Management.StateTaxes\"\n      FallbackComponent={FallbackComponent}\n    >\n      <StateTaxesFlow {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["StateTaxesFlow","employeeId","onEvent","useI18n","machine","useMemo","createMachine","stateTaxesStateMachine","ctx","StateTaxesCardContextual","jsx","Flow","StateTaxes","dictionary","FallbackComponent","props","useComponentDictionary","BaseBoundaries"],"mappings":";;;;;;;;;AAoBA,SAASA,EAAe,EAAE,YAAAC,GAAY,SAAAC,KAA4B;AAChE,EAAAC,EAAQ,gCAAgC;AAExC,QAAMC,IAAUC;AAAA,IACd,MACEC,EAAc,QAAQC,GAAwB,CAACC,OAAqC;AAAA,MAClF,GAAGA;AAAA,MACH,WAAWC;AAAA,MACX,YAAAR;AAAA,IAAA,EACA;AAAA,IACJ,CAACA,CAAU;AAAA,EAAA;AAGb,SAAO,gBAAAS,EAACC,GAAA,EAAK,SAAAP,GAAkB,SAAAF,EAAA,CAAkB;AACnD;AAEO,SAASU,EAAW;AAAA,EACzB,YAAAC;AAAA,EACA,mBAAAC;AAAA,EACA,GAAGC;AACL,GAA+E;AAC7E,SAAAC,EAAuB,kCAAkCH,CAAU,GAEjE,gBAAAH;AAAA,IAACO;AAAA,IAAA;AAAA,MACC,eAAc;AAAA,MACd,mBAAAH;AAAA,MAEA,UAAA,gBAAAJ,EAACV,GAAA,EAAgB,GAAGe,EAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAGjC;"}
+{"version":3,"file":"StateTaxes.js","sources":["../../../../../src/components/Employee/StateTaxes/management/StateTaxes.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport { StateTaxesCardContextual, type StateTaxesContextInterface } from './StateTaxesComponents'\nimport { stateTaxesStateMachine } from './stateTaxesStateMachine'\nimport { Flow } from '@/components/Flow/Flow'\nimport {\n  BaseBoundaries,\n  type BaseComponentInterface,\n  type CommonComponentInterface,\n} from '@/components/Base'\nimport { type EventType } from '@/shared/constants'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport { useI18n } from '@/i18n'\nimport type { OnEventType } from '@/components/Base/useBase'\n\n/**\n * Props for {@link StateTaxes}.\n *\n * @public\n */\nexport interface StateTaxesProps extends CommonComponentInterface<'Employee.Management.StateTaxes'> {\n  /** The associated employee identifier. */\n  employeeId: string\n  /** Event handler fired on flow state changes. */\n  onEvent: OnEventType<EventType, unknown>\n}\n\nfunction StateTaxesFlow({ employeeId, onEvent }: StateTaxesProps) {\n  useI18n('Employee.Management.StateTaxes')\n\n  const machine = useMemo(\n    () =>\n      createMachine('card', stateTaxesStateMachine, (ctx: StateTaxesContextInterface) => ({\n        ...ctx,\n        component: StateTaxesCardContextual,\n        employeeId,\n      })),\n    [employeeId],\n  )\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n\n/**\n * Standalone state-tax management flow for a given employee. Renders the\n * read-only summary card and the edit form, switching between them as the\n * partner-emitted events from {@link StateTaxesCard} and {@link StateTaxesEditForm}\n * drive the internal state machine.\n *\n * @remarks\n *\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/management/stateTaxes/editRequested` | Edit button on the summary card was clicked | `{ employeeId: string }` |\n * | `employee/management/stateTaxes/editCancelled` | Cancel button on the edit form was clicked | — |\n * | `employee/management/stateTaxes/updated` | Edit form was submitted successfully | `{ employeeStateTaxesList: EmployeeStateTaxesList[] }` |\n *\n * @param props - The component props.\n * @public\n */\nexport function StateTaxes({\n  dictionary,\n  FallbackComponent,\n  ...props\n}: StateTaxesProps & BaseComponentInterface<'Employee.Management.StateTaxes'>) {\n  useComponentDictionary('Employee.Management.StateTaxes', dictionary)\n  return (\n    <BaseBoundaries\n      componentName=\"Employee.Management.StateTaxes\"\n      FallbackComponent={FallbackComponent}\n    >\n      <StateTaxesFlow {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["StateTaxesFlow","employeeId","onEvent","useI18n","machine","useMemo","createMachine","stateTaxesStateMachine","ctx","StateTaxesCardContextual","jsx","Flow","StateTaxes","dictionary","FallbackComponent","props","useComponentDictionary","BaseBoundaries"],"mappings":";;;;;;;;;AA2BA,SAASA,EAAe,EAAE,YAAAC,GAAY,SAAAC,KAA4B;AAChE,EAAAC,EAAQ,gCAAgC;AAExC,QAAMC,IAAUC;AAAA,IACd,MACEC,EAAc,QAAQC,GAAwB,CAACC,OAAqC;AAAA,MAClF,GAAGA;AAAA,MACH,WAAWC;AAAA,MACX,YAAAR;AAAA,IAAA,EACA;AAAA,IACJ,CAACA,CAAU;AAAA,EAAA;AAGb,SAAO,gBAAAS,EAACC,GAAA,EAAK,SAAAP,GAAkB,SAAAF,EAAA,CAAkB;AACnD;AAmBO,SAASU,EAAW;AAAA,EACzB,YAAAC;AAAA,EACA,mBAAAC;AAAA,EACA,GAAGC;AACL,GAA+E;AAC7E,SAAAC,EAAuB,kCAAkCH,CAAU,GAEjE,gBAAAH;AAAA,IAACO;AAAA,IAAA;AAAA,MACC,eAAc;AAAA,MACd,mBAAAH;AAAA,MAEA,UAAA,gBAAAJ,EAACV,GAAA,EAAgB,GAAGe,EAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAGjC;"}

package/dist/components/Employee/StateTaxes/management/StateTaxesCard/StateTaxesCard.d.ts

@@ -1,15 +1,30 @@
 import { EventType } from '../../../../../shared/constants';
 import { OnEventType } from '../../../../Base/useBase';
+/**
+ * Props for {@link StateTaxesCard}.
+ *
+ * @public
+ */
 export interface StateTaxesCardProps {
+    /** The associated employee identifier. */
     employeeId: string;
+    /** Event handler fired when the Edit button is clicked. */
     onEvent: OnEventType<EventType, unknown>;
 }
 /**
- * Standalone "State taxes" card. Owns its own data fetch via
- * `useStateTaxesSummary` and emits
- * `EMPLOYEE_MANAGEMENT_STATE_TAXES_EDIT_REQUESTED` when the Edit
- * button is clicked. The Edit button is hidden when no state on
- * record has any tax-withholding questions (e.g. WA), matching the
- * product rule that a state with no income tax has nothing to edit.
+ * Standalone read-only summary card showing an employee's per-state tax
+ * withholding answers. Fetches its own data and surfaces an Edit button
+ * that emits an event for the orchestrator to swap in the edit form.
+ *
+ * @remarks
+ * The Edit button is hidden when no state on record has any tax-withholding
+ * questions (e.g. states with no income tax), since there is nothing to edit.
+ *
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `employee/management/stateTaxes/editRequested` | Edit button was clicked | `{ employeeId: string }` |
+ *
+ * @param props - The component props.
+ * @public
  */
 export declare function StateTaxesCard(props: StateTaxesCardProps): import("react").JSX.Element;

package/dist/components/Employee/StateTaxes/management/StateTaxesCard/StateTaxesCard.js

@@ -2,18 +2,19 @@ import { jsx as e, jsxs as C } from "react/jsx-runtime";
 import { useTranslation as h } from "react-i18next";
 import { Flex as d } from "../../../../Common/Flex/Flex.js";
 import { Loading as F } from "../../../../Common/Loading/Loading.js";
-import { BaseBoundaries as Q, BaseLayout as b } from "../../../../Base/Base.js";
-import { useComponentContext as v } from "../../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { useComponentContext as Q } from "../../../../../contexts/ComponentAdapter/useComponentContext.js";
+import "react";
+import { BaseBoundaries as b, BaseLayout as v } from "../../../../Base/Base.js";
 import L from "../../../../../hooks/useNumberFormatter.js";
 import { useI18n as D } from "../../../../../i18n/I18n.js";
 import { componentEvents as N } from "../../../../../shared/constants.js";
 import { useStateTaxesSummary as A } from "../../shared/useStateTaxesSummary/useStateTaxesSummary.js";
-function U(i) {
-  return /* @__PURE__ */ e(Q, { componentName: "Employee.Management.StateTaxes", children: /* @__PURE__ */ e(B, { ...i }) });
+function V(i) {
+  return /* @__PURE__ */ e(b, { componentName: "Employee.Management.StateTaxes", children: /* @__PURE__ */ e(B, { ...i }) });
 }
 function B({ employeeId: i, onEvent: y }) {
   D("Employee.Management.StateTaxes");
-  const { t: n } = h("Employee.Management.StateTaxes"), { t: g } = h("common"), r = v(), f = L("currency"), s = A({ employeeId: i }), m = s.isLoading, c = s.isLoading ? [] : s.data.employeeStateTaxesList, x = c.some((t) => (t.questions?.length ?? 0) > 0), E = (t, o) => {
+  const { t: n } = h("Employee.Management.StateTaxes"), { t: g } = h("common"), r = Q(), f = L("currency"), s = A({ employeeId: i }), m = s.isLoading, c = s.isLoading ? [] : s.data.employeeStateTaxesList, x = c.some((t) => (t.questions?.length ?? 0) > 0), E = (t, o) => {
     if (t.inputQuestionFormat.type === "Select" && t.inputQuestionFormat.options && t.inputQuestionFormat.options.length > 0) {
       const a = t.inputQuestionFormat.options.find((l) => l.value === o);
       if (a?.label)
@@ -29,7 +30,7 @@ function B({ employeeId: i, onEvent: y }) {
   }, S = /* @__PURE__ */ e("span", { "aria-label": n("card.listEmptyPlaceholder"), children: "–" }), T = () => {
     y(N.EMPLOYEE_MANAGEMENT_STATE_TAXES_EDIT_REQUESTED, { employeeId: i });
   };
-  return /* @__PURE__ */ e(b, { error: s.errorHandling.errors, children: /* @__PURE__ */ e(
+  return /* @__PURE__ */ e(v, { error: s.errorHandling.errors, children: /* @__PURE__ */ e(
     r.Box,
     {
       header: /* @__PURE__ */ e(
@@ -46,11 +47,11 @@ function B({ employeeId: i, onEvent: y }) {
           l ? /* @__PURE__ */ e(
             r.DescriptionList,
             {
-              items: t.questions.map((u) => {
-                const p = u.answers[0]?.value;
+              items: t.questions.map((p) => {
+                const u = p.answers[0]?.value;
                 return {
-                  term: u.label,
-                  description: p == null ? S : E(u, p)
+                  term: p.label,
+                  description: u == null ? S : E(p, u)
                 };
               })
             }
@@ -61,6 +62,6 @@ function B({ employeeId: i, onEvent: y }) {
   ) });
 }
 export {
-  U as StateTaxesCard
+  V as StateTaxesCard
 };
 //# sourceMappingURL=StateTaxesCard.js.map

package/dist/components/Employee/StateTaxes/management/StateTaxesCard/StateTaxesCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"StateTaxesCard.js","sources":["../../../../../../src/components/Employee/StateTaxes/management/StateTaxesCard/StateTaxesCard.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport type { EmployeeStateTaxQuestion } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxquestion'\nimport { useStateTaxesSummary } from '../../shared/useStateTaxesSummary'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { Loading } from '@/components/Common'\nimport { BaseBoundaries, BaseLayout } from '@/components/Base/Base'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport useNumberFormatter from '@/hooks/useNumberFormatter'\nimport { useI18n } from '@/i18n'\nimport { componentEvents, type EventType } from '@/shared/constants'\nimport type { OnEventType } from '@/components/Base/useBase'\n\nexport interface StateTaxesCardProps {\n  employeeId: string\n  onEvent: OnEventType<EventType, unknown>\n}\n\n/**\n * Standalone \"State taxes\" card. Owns its own data fetch via\n * `useStateTaxesSummary` and emits\n * `EMPLOYEE_MANAGEMENT_STATE_TAXES_EDIT_REQUESTED` when the Edit\n * button is clicked. The Edit button is hidden when no state on\n * record has any tax-withholding questions (e.g. WA), matching the\n * product rule that a state with no income tax has nothing to edit.\n */\nexport function StateTaxesCard(props: StateTaxesCardProps) {\n  return (\n    <BaseBoundaries componentName=\"Employee.Management.StateTaxes\">\n      <StateTaxesCardContent {...props} />\n    </BaseBoundaries>\n  )\n}\n\nfunction StateTaxesCardContent({ employeeId, onEvent }: StateTaxesCardProps) {\n  useI18n('Employee.Management.StateTaxes')\n  const { t } = useTranslation('Employee.Management.StateTaxes')\n  const { t: tCommon } = useTranslation('common')\n  const Components = useComponentContext()\n  const formatCurrency = useNumberFormatter('currency')\n\n  const summary = useStateTaxesSummary({ employeeId })\n  const isLoading = summary.isLoading\n  const stateTaxes = summary.isLoading ? [] : summary.data.employeeStateTaxesList\n\n  const stateTaxesHaveAnyQuestions = stateTaxes.some(s => (s.questions?.length ?? 0) > 0)\n\n  const formatStateTaxAnswer = (\n    question: EmployeeStateTaxQuestion,\n    answer: string | number | boolean,\n  ) => {\n    if (\n      question.inputQuestionFormat.type === 'Select' &&\n      question.inputQuestionFormat.options &&\n      question.inputQuestionFormat.options.length > 0\n    ) {\n      const option = question.inputQuestionFormat.options.find(opt => opt.value === answer)\n      if (option?.label) {\n        return option.label\n      }\n    }\n\n    if (typeof answer === 'number') {\n      if (question.inputQuestionFormat.type === 'Currency') {\n        return formatCurrency(answer)\n      }\n      return answer\n    }\n\n    if (typeof answer === 'string' && !isNaN(parseFloat(answer))) {\n      const numValue = parseFloat(answer)\n      if (question.inputQuestionFormat.type === 'Currency') {\n        return formatCurrency(numValue)\n      }\n      return answer\n    }\n\n    if (typeof answer === 'boolean') {\n      return answer ? t('card.yes') : t('card.no')\n    }\n\n    return answer\n  }\n\n  const emptyPlaceholder = <span aria-label={t('card.listEmptyPlaceholder')}>–</span>\n\n  const handleEdit = () => {\n    onEvent(componentEvents.EMPLOYEE_MANAGEMENT_STATE_TAXES_EDIT_REQUESTED, { employeeId })\n  }\n\n  return (\n    <BaseLayout error={summary.errorHandling.errors}>\n      <Components.Box\n        header={\n          <Components.BoxHeader\n            title={t('card.title')}\n            action={\n              isLoading || stateTaxesHaveAnyQuestions ? (\n                <Components.Button variant=\"secondary\" onClick={handleEdit} isDisabled={isLoading}>\n                  {t('card.editCta')}\n                </Components.Button>\n              ) : undefined\n            }\n          />\n        }\n      >\n        <Flex flexDirection=\"column\" gap={16}>\n          {isLoading ? (\n            <Loading />\n          ) : stateTaxes.length > 0 ? (\n            <Flex flexDirection=\"column\" gap={24}>\n              {stateTaxes.map((stateTax, index) => {\n                const stateName = stateTax.state\n                  ? tCommon(`statesHash.${stateTax.state}`, stateTax.state)\n                  : ''\n                const hasQuestions = (stateTax.questions?.length ?? 0) > 0\n                return (\n                  <Flex key={stateTax.state ?? index} flexDirection=\"column\" gap={16}>\n                    {stateName ? (\n                      <Components.Heading as=\"h4\">{stateName}</Components.Heading>\n                    ) : null}\n\n                    {hasQuestions ? (\n                      <Components.DescriptionList\n                        items={stateTax.questions!.map(question => {\n                          const answer = question.answers[0]?.value\n                          return {\n                            term: question.label,\n                            description:\n                              answer === null || answer === undefined\n                                ? emptyPlaceholder\n                                : formatStateTaxAnswer(question, answer),\n                          }\n                        })}\n                      />\n                    ) : (\n                      <Components.Text variant=\"supporting\">\n                        {t('card.noWithholdingForState')}\n                      </Components.Text>\n                    )}\n                  </Flex>\n                )\n              })}\n            </Flex>\n          ) : (\n            <Components.Text>{t('card.noStateTaxes')}</Components.Text>\n          )}\n        </Flex>\n      </Components.Box>\n    </BaseLayout>\n  )\n}\n"],"names":["StateTaxesCard","props","jsx","BaseBoundaries","StateTaxesCardContent","employeeId","onEvent","useI18n","t","useTranslation","tCommon","Components","useComponentContext","formatCurrency","useNumberFormatter","summary","useStateTaxesSummary","isLoading","stateTaxes","stateTaxesHaveAnyQuestions","s","formatStateTaxAnswer","question","answer","option","opt","numValue","emptyPlaceholder","handleEdit","componentEvents","BaseLayout","Flex","Loading","stateTax","index","stateName","hasQuestions","jsxs"],"mappings":"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"}
+{"version":3,"file":"StateTaxesCard.js","sources":["../../../../../../src/components/Employee/StateTaxes/management/StateTaxesCard/StateTaxesCard.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport type { EmployeeStateTaxQuestion } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxquestion'\nimport { useStateTaxesSummary } from '../../shared/useStateTaxesSummary'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { Loading } from '@/components/Common'\nimport { BaseBoundaries, BaseLayout } from '@/components/Base/Base'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport useNumberFormatter from '@/hooks/useNumberFormatter'\nimport { useI18n } from '@/i18n'\nimport { componentEvents, type EventType } from '@/shared/constants'\nimport type { OnEventType } from '@/components/Base/useBase'\n\n/**\n * Props for {@link StateTaxesCard}.\n *\n * @public\n */\nexport interface StateTaxesCardProps {\n  /** The associated employee identifier. */\n  employeeId: string\n  /** Event handler fired when the Edit button is clicked. */\n  onEvent: OnEventType<EventType, unknown>\n}\n\n/**\n * Standalone read-only summary card showing an employee's per-state tax\n * withholding answers. Fetches its own data and surfaces an Edit button\n * that emits an event for the orchestrator to swap in the edit form.\n *\n * @remarks\n * The Edit button is hidden when no state on record has any tax-withholding\n * questions (e.g. states with no income tax), since there is nothing to edit.\n *\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/management/stateTaxes/editRequested` | Edit button was clicked | `{ employeeId: string }` |\n *\n * @param props - The component props.\n * @public\n */\nexport function StateTaxesCard(props: StateTaxesCardProps) {\n  return (\n    <BaseBoundaries componentName=\"Employee.Management.StateTaxes\">\n      <StateTaxesCardContent {...props} />\n    </BaseBoundaries>\n  )\n}\n\nfunction StateTaxesCardContent({ employeeId, onEvent }: StateTaxesCardProps) {\n  useI18n('Employee.Management.StateTaxes')\n  const { t } = useTranslation('Employee.Management.StateTaxes')\n  const { t: tCommon } = useTranslation('common')\n  const Components = useComponentContext()\n  const formatCurrency = useNumberFormatter('currency')\n\n  const summary = useStateTaxesSummary({ employeeId })\n  const isLoading = summary.isLoading\n  const stateTaxes = summary.isLoading ? [] : summary.data.employeeStateTaxesList\n\n  const stateTaxesHaveAnyQuestions = stateTaxes.some(s => (s.questions?.length ?? 0) > 0)\n\n  const formatStateTaxAnswer = (\n    question: EmployeeStateTaxQuestion,\n    answer: string | number | boolean,\n  ) => {\n    if (\n      question.inputQuestionFormat.type === 'Select' &&\n      question.inputQuestionFormat.options &&\n      question.inputQuestionFormat.options.length > 0\n    ) {\n      const option = question.inputQuestionFormat.options.find(opt => opt.value === answer)\n      if (option?.label) {\n        return option.label\n      }\n    }\n\n    if (typeof answer === 'number') {\n      if (question.inputQuestionFormat.type === 'Currency') {\n        return formatCurrency(answer)\n      }\n      return answer\n    }\n\n    if (typeof answer === 'string' && !isNaN(parseFloat(answer))) {\n      const numValue = parseFloat(answer)\n      if (question.inputQuestionFormat.type === 'Currency') {\n        return formatCurrency(numValue)\n      }\n      return answer\n    }\n\n    if (typeof answer === 'boolean') {\n      return answer ? t('card.yes') : t('card.no')\n    }\n\n    return answer\n  }\n\n  const emptyPlaceholder = <span aria-label={t('card.listEmptyPlaceholder')}>–</span>\n\n  const handleEdit = () => {\n    onEvent(componentEvents.EMPLOYEE_MANAGEMENT_STATE_TAXES_EDIT_REQUESTED, { employeeId })\n  }\n\n  return (\n    <BaseLayout error={summary.errorHandling.errors}>\n      <Components.Box\n        header={\n          <Components.BoxHeader\n            title={t('card.title')}\n            action={\n              isLoading || stateTaxesHaveAnyQuestions ? (\n                <Components.Button variant=\"secondary\" onClick={handleEdit} isDisabled={isLoading}>\n                  {t('card.editCta')}\n                </Components.Button>\n              ) : undefined\n            }\n          />\n        }\n      >\n        <Flex flexDirection=\"column\" gap={16}>\n          {isLoading ? (\n            <Loading />\n          ) : stateTaxes.length > 0 ? (\n            <Flex flexDirection=\"column\" gap={24}>\n              {stateTaxes.map((stateTax, index) => {\n                const stateName = stateTax.state\n                  ? tCommon(`statesHash.${stateTax.state}`, stateTax.state)\n                  : ''\n                const hasQuestions = (stateTax.questions?.length ?? 0) > 0\n                return (\n                  <Flex key={stateTax.state ?? index} flexDirection=\"column\" gap={16}>\n                    {stateName ? (\n                      <Components.Heading as=\"h4\">{stateName}</Components.Heading>\n                    ) : null}\n\n                    {hasQuestions ? (\n                      <Components.DescriptionList\n                        items={stateTax.questions!.map(question => {\n                          const answer = question.answers[0]?.value\n                          return {\n                            term: question.label,\n                            description:\n                              answer === null || answer === undefined\n                                ? emptyPlaceholder\n                                : formatStateTaxAnswer(question, answer),\n                          }\n                        })}\n                      />\n                    ) : (\n                      <Components.Text variant=\"supporting\">\n                        {t('card.noWithholdingForState')}\n                      </Components.Text>\n                    )}\n                  </Flex>\n                )\n              })}\n            </Flex>\n          ) : (\n            <Components.Text>{t('card.noStateTaxes')}</Components.Text>\n          )}\n        </Flex>\n      </Components.Box>\n    </BaseLayout>\n  )\n}\n"],"names":["StateTaxesCard","props","jsx","BaseBoundaries","StateTaxesCardContent","employeeId","onEvent","useI18n","t","useTranslation","tCommon","Components","useComponentContext","formatCurrency","useNumberFormatter","summary","useStateTaxesSummary","isLoading","stateTaxes","stateTaxesHaveAnyQuestions","s","formatStateTaxAnswer","question","answer","option","opt","numValue","emptyPlaceholder","handleEdit","componentEvents","BaseLayout","Flex","Loading","stateTax","index","stateName","hasQuestions","jsxs"],"mappings":"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"}

package/dist/components/Employee/StateTaxes/management/StateTaxesComponents.d.ts

@@ -1,8 +1,12 @@
 import { FlowContextInterface } from '../../../Flow/useFlow';
+/** @internal */
 export type StateTaxesSuccessAlertCode = 'stateTaxesUpdated';
+/** @internal */
 export interface StateTaxesContextInterface extends FlowContextInterface {
     employeeId?: string;
     successAlert?: StateTaxesSuccessAlertCode | null;
 }
+/** @internal */
 export declare function StateTaxesCardContextual(): import("react").JSX.Element;
+/** @internal */
 export declare function StateTaxesEditFormContextual(): import("react").JSX.Element;

package/dist/components/Employee/StateTaxes/management/StateTaxesComponents.js.map

@@ -1 +1 @@
-{"version":3,"file":"StateTaxesComponents.js","sources":["../../../../../src/components/Employee/StateTaxes/management/StateTaxesComponents.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { StateTaxesCard } from './StateTaxesCard'\nimport { StateTaxesEditForm } from './StateTaxesEditForm'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { componentEvents } from '@/shared/constants'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\nexport type StateTaxesSuccessAlertCode = 'stateTaxesUpdated'\n\nexport interface StateTaxesContextInterface extends FlowContextInterface {\n  employeeId?: string\n  successAlert?: StateTaxesSuccessAlertCode | null\n}\n\nexport function StateTaxesCardContextual() {\n  const { employeeId, onEvent, successAlert } = useFlow<StateTaxesContextInterface>()\n  const { t } = useTranslation('Employee.Management.StateTaxes')\n  const Components = useComponentContext()\n  return (\n    <Flex flexDirection=\"column\" gap={16}>\n      {successAlert ? (\n        <Components.Alert\n          status=\"success\"\n          label={t(`alerts.${successAlert}`)}\n          onDismiss={() => {\n            onEvent(componentEvents.EMPLOYEE_MANAGEMENT_STATE_TAXES_ALERT_DISMISSED, null)\n          }}\n        />\n      ) : null}\n      <StateTaxesCard employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n    </Flex>\n  )\n}\n\nexport function StateTaxesEditFormContextual() {\n  const { employeeId, onEvent } = useFlow<StateTaxesContextInterface>()\n  return <StateTaxesEditForm employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n"],"names":["StateTaxesCardContextual","employeeId","onEvent","successAlert","useFlow","t","useTranslation","Components","useComponentContext","jsxs","Flex","jsx","componentEvents","StateTaxesCard","ensureRequired","StateTaxesEditFormContextual","StateTaxesEditForm"],"mappings":";;;;;;;;;AAgBO,SAASA,IAA2B;AACzC,QAAM,EAAE,YAAAC,GAAY,SAAAC,GAAS,cAAAC,EAAA,IAAiBC,EAAA,GACxC,EAAE,GAAAC,EAAA,IAAMC,EAAe,gCAAgC,GACvDC,IAAaC,EAAA;AACnB,SACE,gBAAAC,EAACC,GAAA,EAAK,eAAc,UAAS,KAAK,IAC/B,UAAA;AAAA,IAAAP,IACC,gBAAAQ;AAAA,MAACJ,EAAW;AAAA,MAAX;AAAA,QACC,QAAO;AAAA,QACP,OAAOF,EAAE,UAAUF,CAAY,EAAE;AAAA,QACjC,WAAW,MAAM;AACf,UAAAD,EAAQU,EAAgB,iDAAiD,IAAI;AAAA,QAC/E;AAAA,MAAA;AAAA,IAAA,IAEA;AAAA,sBACHC,GAAA,EAAe,YAAYC,EAAeb,CAAU,GAAG,SAAAC,EAAA,CAAkB;AAAA,EAAA,GAC5E;AAEJ;AAEO,SAASa,IAA+B;AAC7C,QAAM,EAAE,YAAAd,GAAY,SAAAC,EAAA,IAAYE,EAAA;AAChC,2BAAQY,GAAA,EAAmB,YAAYF,EAAeb,CAAU,GAAG,SAAAC,GAAkB;AACvF;"}
+{"version":3,"file":"StateTaxesComponents.js","sources":["../../../../../src/components/Employee/StateTaxes/management/StateTaxesComponents.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { StateTaxesCard } from './StateTaxesCard'\nimport { StateTaxesEditForm } from './StateTaxesEditForm'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { componentEvents } from '@/shared/constants'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/** @internal */\nexport type StateTaxesSuccessAlertCode = 'stateTaxesUpdated'\n\n/** @internal */\nexport interface StateTaxesContextInterface extends FlowContextInterface {\n  employeeId?: string\n  successAlert?: StateTaxesSuccessAlertCode | null\n}\n\n/** @internal */\nexport function StateTaxesCardContextual() {\n  const { employeeId, onEvent, successAlert } = useFlow<StateTaxesContextInterface>()\n  const { t } = useTranslation('Employee.Management.StateTaxes')\n  const Components = useComponentContext()\n  return (\n    <Flex flexDirection=\"column\" gap={16}>\n      {successAlert ? (\n        <Components.Alert\n          status=\"success\"\n          label={t(`alerts.${successAlert}`)}\n          onDismiss={() => {\n            onEvent(componentEvents.EMPLOYEE_MANAGEMENT_STATE_TAXES_ALERT_DISMISSED, null)\n          }}\n        />\n      ) : null}\n      <StateTaxesCard employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n    </Flex>\n  )\n}\n\n/** @internal */\nexport function StateTaxesEditFormContextual() {\n  const { employeeId, onEvent } = useFlow<StateTaxesContextInterface>()\n  return <StateTaxesEditForm employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n"],"names":["StateTaxesCardContextual","employeeId","onEvent","successAlert","useFlow","t","useTranslation","Components","useComponentContext","jsxs","Flex","jsx","componentEvents","StateTaxesCard","ensureRequired","StateTaxesEditFormContextual","StateTaxesEditForm"],"mappings":";;;;;;;;;AAmBO,SAASA,IAA2B;AACzC,QAAM,EAAE,YAAAC,GAAY,SAAAC,GAAS,cAAAC,EAAA,IAAiBC,EAAA,GACxC,EAAE,GAAAC,EAAA,IAAMC,EAAe,gCAAgC,GACvDC,IAAaC,EAAA;AACnB,SACE,gBAAAC,EAACC,GAAA,EAAK,eAAc,UAAS,KAAK,IAC/B,UAAA;AAAA,IAAAP,IACC,gBAAAQ;AAAA,MAACJ,EAAW;AAAA,MAAX;AAAA,QACC,QAAO;AAAA,QACP,OAAOF,EAAE,UAAUF,CAAY,EAAE;AAAA,QACjC,WAAW,MAAM;AACf,UAAAD,EAAQU,EAAgB,iDAAiD,IAAI;AAAA,QAC/E;AAAA,MAAA;AAAA,IAAA,IAEA;AAAA,sBACHC,GAAA,EAAe,YAAYC,EAAeb,CAAU,GAAG,SAAAC,EAAA,CAAkB;AAAA,EAAA,GAC5E;AAEJ;AAGO,SAASa,IAA+B;AAC7C,QAAM,EAAE,YAAAd,GAAY,SAAAC,EAAA,IAAYE,EAAA;AAChC,2BAAQY,GAAA,EAAmB,YAAYF,EAAeb,CAAU,GAAG,SAAAC,GAAkB;AACvF;"}

package/dist/components/Employee/StateTaxes/management/StateTaxesEditForm.d.ts

@@ -1,17 +1,29 @@
 import { BaseComponentInterface, CommonComponentInterface } from '../../../Base';
+/**
+ * Props for {@link StateTaxesEditForm}.
+ *
+ * @public
+ */
 export type StateTaxesEditFormProps = Omit<CommonComponentInterface<'Employee.Management.StateTaxes'>, 'children'> & {
+    /** The associated employee identifier. */
     employeeId: string;
+    /** Event handler fired when the form is submitted or cancelled. */
     onEvent: BaseComponentInterface['onEvent'];
 };
 /**
- * Standalone state-tax edit screen for the management flow. Wraps the shared
- * {@link useEmployeeStateTaxesForm} hook with scoped events and the
- * `Employee.Management.StateTaxes` namespace; the shared `EmployeeStateTaxesView`
- * resolves its text through `useManagementStateTaxesViewDictionary` so partner
- * overrides on the management namespace don't leak into onboarding.
+ * Standalone edit screen for the state-tax management flow. Renders the shared
+ * state-tax form against the `Employee.Management.StateTaxes` namespace and
+ * emits scoped management events on submit and cancel, so partner copy
+ * overrides on the management namespace do not leak into the onboarding flow.
+ *
+ * @remarks
+ *
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `employee/management/stateTaxes/updated` | Form was submitted successfully | `{ employeeStateTaxesList: EmployeeStateTaxesList[] }` |
+ * | `employee/management/stateTaxes/editCancelled` | Cancel button was clicked | — |
  *
- * Emits `EMPLOYEE_MANAGEMENT_STATE_TAXES_UPDATED` on a successful save and
- * `EMPLOYEE_MANAGEMENT_STATE_TAXES_EDIT_CANCELLED` on Cancel. The orchestrator
- * (the block or the dashboard) handles both by returning to the card surface.
+ * @param props - The component props.
+ * @public
  */
 export declare function StateTaxesEditForm({ FallbackComponent, ...props }: StateTaxesEditFormProps & Pick<BaseComponentInterface, 'FallbackComponent'>): import("react").JSX.Element;