@gusto/embedded-react-sdk 0.47.0 → 0.48.0

package/dist/components/Employee/FederalTaxes/shared/useFederalTaxesForm/useFederalTaxesForm.d.ts

@@ -4,34 +4,146 @@ import { FederalTaxesOptionalFieldsToRequire, FederalTaxesFormData } from './fed
 import { FilingStatusField, TwoJobsField, DependentsAmountField, OtherIncomeField, DeductionsField, ExtraWithholdingField } from './fields';
 import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
 export type { FederalTaxesOptionalFieldsToRequire } from './federalTaxesSchema';
+/**
+ * Configuration options for {@link useFederalTaxesForm}.
+ *
+ * @remarks
+ * The federal tax record is created automatically with the employee, so the
+ * hook is always in update mode and only `employeeId` is required.
+ *
+ * @public
+ */
 export interface UseFederalTaxesFormProps {
+    /** UUID of the employee whose federal tax record is being updated. */
     employeeId: string;
+    /** Override fields that are optional on update to be required. By default only `filingStatus` is required; pass `{ update: ['twoJobs', 'dependentsAmount', 'otherIncome', 'deductions', 'extraWithholding'] }` to require any subset. See {@link FederalTaxesOptionalFieldsToRequire}. */
     optionalFieldsToRequire?: FederalTaxesOptionalFieldsToRequire;
+    /** Pre-fill form values. Server data takes precedence when the employee already has values on file. */
     defaultValues?: Partial<FederalTaxesFormData>;
+    /** Passed through to react-hook-form. Defaults to `'onSubmit'`. */
     validationMode?: UseFormProps['mode'];
+    /** Auto-focus the first invalid field on submit. Set to `false` when using `composeSubmitHandler` so submit-time focus is coordinated across multiple forms. Defaults to `true`. */
     shouldFocusError?: boolean;
 }
+/**
+ * Pre-bound field components exposed on `useFederalTaxesForm().form.Fields`.
+ *
+ * @public
+ */
 export interface FederalTaxesFields {
+    /** Filing status select. */
     FilingStatus: typeof FilingStatusField;
+    /** Multiple-jobs (Step 2c) radio group. */
     TwoJobs: typeof TwoJobsField;
+    /** Dependents amount (Step 3) currency input. */
     DependentsAmount: typeof DependentsAmountField;
+    /** Other income (Step 4a) currency input. */
     OtherIncome: typeof OtherIncomeField;
+    /** Deductions (Step 4b) currency input. */
     Deductions: typeof DeductionsField;
+    /** Extra withholding (Step 4c) currency input. */
     ExtraWithholding: typeof ExtraWithholdingField;
 }
+/**
+ * Ready-state shape returned by {@link useFederalTaxesForm} once data has loaded.
+ *
+ * @remarks
+ * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with
+ * the federal-taxes specific `data`, `status`, and `actions`.
+ *
+ * @public
+ */
 export interface UseFederalTaxesFormReady extends BaseFormHookReady<FieldsMetadata, FederalTaxesFormData, FederalTaxesFields> {
+    /** The loaded federal tax record. */
     data: {
+        /** The current federal tax record for the employee. */
         employeeFederalTax: EmployeeFederalTax;
     };
+    /** Submission state. `mode` is always `'update'` — the federal tax record is created with the employee, so this hook has no create mode. */
     status: {
+        /** `true` while the update mutation is in flight. */
         isPending: boolean;
+        /** Always `'update'` — the federal tax record is created when the employee is created. */
         mode: 'update';
     };
+    /** Submit actions exposed by the hook. */
     actions: {
+        /** Validates the form, runs the update mutation, and resolves to a {@link HookSubmitResult} containing the updated record. Resolves to `undefined` on validation failure or mutation error. */
         onSubmit: () => Promise<HookSubmitResult<EmployeeFederalTax> | undefined>;
     };
 }
+/**
+ * Headless hook for updating an employee's federal tax (W-4) withholding information — filing status, multiple-jobs flag, dependents, other income, deductions, and extra withholding.
+ *
+ * @remarks
+ * The federal tax record is created automatically with the employee, so this hook is always in update mode. Only the revised 2020 W-4 format is supported for updates. By default only `filingStatus` is required; promote any of `twoJobs`, `dependentsAmount`, `otherIncome`, `deductions`, or `extraWithholding` to required via `optionalFieldsToRequire.update`.
+ *
+ * @param props - See {@link UseFederalTaxesFormProps}.
+ * @returns A {@link HookLoadingResult} while data is loading, or a {@link UseFederalTaxesFormReady} once the federal tax record is loaded.
+ * @public
+ *
+ * @example
+ * ```tsx
+ * import { useFederalTaxesForm, SDKFormProvider } from '@gusto/embedded-react-sdk'
+ *
+ * function FederalTaxesPage({ employeeId }: { employeeId: string }) {
+ *   const federalTaxes = useFederalTaxesForm({ employeeId })
+ *
+ *   if (federalTaxes.isLoading) return <div>Loading...</div>
+ *
+ *   const { Fields } = federalTaxes.form
+ *
+ *   return (
+ *     <SDKFormProvider formHookResult={federalTaxes}>
+ *       <form
+ *         onSubmit={e => {
+ *           e.preventDefault()
+ *           void federalTaxes.actions.onSubmit()
+ *         }}
+ *       >
+ *         <Fields.FilingStatus label="Federal filing status" />
+ *         <Fields.TwoJobs label="Multiple jobs (2c)" />
+ *         <Fields.DependentsAmount label="Dependents" />
+ *         <Fields.OtherIncome label="Other income" />
+ *         <Fields.Deductions label="Deductions" />
+ *         <Fields.ExtraWithholding label="Extra withholding" />
+ *         <button type="submit" disabled={federalTaxes.status.isPending}>Save</button>
+ *       </form>
+ *     </SDKFormProvider>
+ *   )
+ * }
+ * ```
+ */
 export declare function useFederalTaxesForm({ employeeId, optionalFieldsToRequire, defaultValues: partnerDefaults, validationMode, shouldFocusError, }: UseFederalTaxesFormProps): HookLoadingResult | UseFederalTaxesFormReady;
+/**
+ * Discriminated union returned by {@link useFederalTaxesForm} — either the loading state or the ready state.
+ *
+ * @remarks
+ * Use this type when threading the hook result through helpers (e.g.
+ * presentational components). Discriminate on `isLoading` to narrow to
+ * {@link UseFederalTaxesFormReady}.
+ *
+ * @public
+ */
 export type UseFederalTaxesFormResult = HookLoadingResult | UseFederalTaxesFormReady;
+/**
+ * Metadata for each {@link useFederalTaxesForm} field, exposed on `form.fieldsMetadata`.
+ *
+ * @remarks
+ * Includes per-field `isDisabled`, `isRequired`, and the dynamic option list
+ * for select and radio fields (`filingStatus`, `twoJobs`).
+ *
+ * @public
+ */
 export type FederalTaxesFieldsMetadata = UseFederalTaxesFormReady['form']['fieldsMetadata'];
+/**
+ * Pre-bound field components exposed on `useFederalTaxesForm().form.Fields`.
+ *
+ * @remarks
+ * Alias for the `Fields` shape on {@link UseFederalTaxesFormReady}. Use this
+ * type when typing a presentational component that consumes the hook's
+ * fields.
+ *
+ * @public
+ */
 export type FederalTaxesFormFields = UseFederalTaxesFormReady['form']['Fields'];

package/dist/components/Employee/FederalTaxes/shared/useFederalTaxesForm/useFederalTaxesForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFederalTaxesForm.js","sources":["../../../../../../src/components/Employee/FederalTaxes/shared/useFederalTaxesForm/useFederalTaxesForm.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 { EmployeeFederalTax } from '@gusto/embedded-api-v-2025-11-15/models/components/employeefederaltax'\nimport type { EmployeeFederalTaxRev2020 } from '@gusto/embedded-api-v-2025-11-15/models/components/employeefederaltaxrev2020'\nimport { useEmployeeTaxSetupGetFederalTaxes } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupGetFederalTaxes'\nimport { useEmployeeTaxSetupUpdateFederalTaxesMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupUpdateFederalTaxes'\nimport type {\n  FilingStatus,\n  PutV1EmployeesEmployeeIdFederalTaxesRequestBody,\n} from '@gusto/embedded-api-v-2025-11-15/models/operations/putv1employeesemployeeidfederaltaxes'\nimport {\n  createFederalTaxesSchema,\n  FILING_STATUS_VALUES,\n  type FederalTaxesOptionalFieldsToRequire,\n  type FederalTaxesFormData,\n  type FederalTaxesFormOutputs,\n  type FilingStatusValue,\n} from './federalTaxesSchema'\nimport {\n  FilingStatusField,\n  TwoJobsField,\n  DependentsAmountField,\n  OtherIncomeField,\n  DeductionsField,\n  ExtraWithholdingField,\n} 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'\n\nexport type { FederalTaxesOptionalFieldsToRequire } from './federalTaxesSchema'\n\nexport interface UseFederalTaxesFormProps {\n  employeeId: string\n  optionalFieldsToRequire?: FederalTaxesOptionalFieldsToRequire\n  defaultValues?: Partial<FederalTaxesFormData>\n  validationMode?: UseFormProps['mode']\n  shouldFocusError?: boolean\n}\n\nexport interface FederalTaxesFields {\n  FilingStatus: typeof FilingStatusField\n  TwoJobs: typeof TwoJobsField\n  DependentsAmount: typeof DependentsAmountField\n  OtherIncome: typeof OtherIncomeField\n  Deductions: typeof DeductionsField\n  ExtraWithholding: typeof ExtraWithholdingField\n}\n\nexport interface UseFederalTaxesFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  FederalTaxesFormData,\n  FederalTaxesFields\n> {\n  data: {\n    employeeFederalTax: EmployeeFederalTax\n  }\n  status: { isPending: boolean; mode: 'update' }\n  actions: {\n    onSubmit: () => Promise<HookSubmitResult<EmployeeFederalTax> | undefined>\n  }\n}\n\nfunction isRev2020(federalTax: EmployeeFederalTax): federalTax is EmployeeFederalTaxRev2020 {\n  return federalTax.w4DataType === 'rev_2020_w4'\n}\n\nfunction toFilingStatus(value: string | null | undefined): FilingStatusValue | '' {\n  if (!value) return ''\n  return FILING_STATUS_VALUES.find(allowed => allowed === value) ?? ''\n}\n\nfunction toNumber(value: string | null | undefined): number | undefined {\n  if (value === null || value === undefined || value === '') return undefined\n  const parsed = Number(value)\n  return Number.isNaN(parsed) ? undefined : parsed\n}\n\nexport function useFederalTaxesForm({\n  employeeId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseFederalTaxesFormProps): HookLoadingResult | UseFederalTaxesFormReady {\n  const federalTaxesQuery = useEmployeeTaxSetupGetFederalTaxes({ employeeUuid: employeeId })\n\n  const employeeFederalTax = federalTaxesQuery.data?.employeeFederalTax\n\n  const [schema, metadataConfig] = useMemo(\n    () => createFederalTaxesSchema({ optionalFieldsToRequire }),\n    [optionalFieldsToRequire],\n  )\n\n  const filingStatusOptions = useMemo(\n    () => FILING_STATUS_VALUES.map(value => ({ value, label: value })),\n    [],\n  )\n\n  const twoJobsOptions = useMemo(\n    () => [\n      { label: 'Yes', value: 'true' },\n      { label: 'No', value: 'false' },\n    ],\n    [],\n  )\n\n  const resolvedDefaults: FederalTaxesFormData = useMemo(() => {\n    const rev2020Source =\n      employeeFederalTax && isRev2020(employeeFederalTax) ? employeeFederalTax : undefined\n\n    const fromServerFilingStatus = toFilingStatus(rev2020Source?.filingStatus)\n\n    return {\n      filingStatus: fromServerFilingStatus || partnerDefaults?.filingStatus || '',\n      twoJobs: rev2020Source?.twoJobs ?? partnerDefaults?.twoJobs ?? false,\n      dependentsAmount:\n        toNumber(rev2020Source?.dependentsAmount) ?? partnerDefaults?.dependentsAmount ?? 0,\n      otherIncome: toNumber(rev2020Source?.otherIncome) ?? partnerDefaults?.otherIncome ?? 0,\n      deductions: toNumber(rev2020Source?.deductions) ?? partnerDefaults?.deductions ?? 0,\n      extraWithholding:\n        toNumber(rev2020Source?.extraWithholding) ?? partnerDefaults?.extraWithholding ?? 0,\n    }\n  }, [employeeFederalTax, partnerDefaults])\n\n  const formMethods = useForm<FederalTaxesFormData, unknown, FederalTaxesFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const { mutateAsync: updateFederalTaxes, isPending } =\n    useEmployeeTaxSetupUpdateFederalTaxesMutation()\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('FederalTaxesForm')\n\n  const errorHandling = composeErrorHandler([federalTaxesQuery], { submitError, setSubmitError })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = {\n    filingStatus: withOptions<FilingStatusValue>(\n      baseMetadata.filingStatus,\n      filingStatusOptions,\n      FILING_STATUS_VALUES,\n    ),\n    twoJobs: withOptions<boolean>(baseMetadata.twoJobs, twoJobsOptions, [true, false]),\n    dependentsAmount: baseMetadata.dependentsAmount,\n    otherIncome: baseMetadata.otherIncome,\n    deductions: baseMetadata.deductions,\n    extraWithholding: baseMetadata.extraWithholding,\n  }\n\n  const onSubmit = async (): Promise<HookSubmitResult<EmployeeFederalTax> | undefined> => {\n    let submitResult: HookSubmitResult<EmployeeFederalTax> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: FederalTaxesFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            if (!employeeFederalTax) {\n              throw new SDKInternalError('Federal taxes record was not loaded before submit')\n            }\n\n            const requestBody: PutV1EmployeesEmployeeIdFederalTaxesRequestBody = {\n              filingStatus: payload.filingStatus as FilingStatus,\n              twoJobs: payload.twoJobs,\n              dependentsAmount: payload.dependentsAmount,\n              otherIncome: payload.otherIncome,\n              deductions: payload.deductions,\n              extraWithholding: payload.extraWithholding,\n              w4DataType: 'rev_2020_w4',\n              version: employeeFederalTax.version,\n            }\n\n            const response = await updateFederalTaxes({\n              request: {\n                employeeUuid: employeeId,\n                requestBody,\n              },\n            })\n\n            if (!response.employeeFederalTax) {\n              throw new SDKInternalError('Federal taxes update did not return an updated record')\n            }\n\n            submitResult = { mode: 'update', data: response.employeeFederalTax }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (federalTaxesQuery.isLoading || !employeeFederalTax) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      employeeFederalTax,\n    },\n    status: {\n      isPending,\n      mode: 'update' as const,\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        FilingStatus: FilingStatusField,\n        TwoJobs: TwoJobsField,\n        DependentsAmount: DependentsAmountField,\n        OtherIncome: OtherIncomeField,\n        Deductions: DeductionsField,\n        ExtraWithholding: ExtraWithholdingField,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\nexport type UseFederalTaxesFormResult = HookLoadingResult | UseFederalTaxesFormReady\nexport type FederalTaxesFieldsMetadata = UseFederalTaxesFormReady['form']['fieldsMetadata']\nexport type FederalTaxesFormFields = UseFederalTaxesFormReady['form']['Fields']\n"],"names":["isRev2020","federalTax","toFilingStatus","value","FILING_STATUS_VALUES","allowed","toNumber","parsed","useFederalTaxesForm","employeeId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","federalTaxesQuery","useEmployeeTaxSetupGetFederalTaxes","employeeFederalTax","schema","metadataConfig","useMemo","createFederalTaxesSchema","filingStatusOptions","twoJobsOptions","resolvedDefaults","rev2020Source","formMethods","useForm","zodResolver","updateFederalTaxes","isPending","useEmployeeTaxSetupUpdateFederalTaxesMutation","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","withOptions","onSubmit","submitResult","resolve","data","payload","SDKInternalError","requestBody","response","hookFormInternals","useHookFormInternals","FilingStatusField","TwoJobsField","DependentsAmountField","OtherIncomeField","DeductionsField","ExtraWithholdingField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"useFederalTaxesForm.js","sources":["../../../../../../src/components/Employee/FederalTaxes/shared/useFederalTaxesForm/useFederalTaxesForm.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 { EmployeeFederalTax } from '@gusto/embedded-api-v-2025-11-15/models/components/employeefederaltax'\nimport type { EmployeeFederalTaxRev2020 } from '@gusto/embedded-api-v-2025-11-15/models/components/employeefederaltaxrev2020'\nimport { useEmployeeTaxSetupGetFederalTaxes } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupGetFederalTaxes'\nimport { useEmployeeTaxSetupUpdateFederalTaxesMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupUpdateFederalTaxes'\nimport type {\n  FilingStatus,\n  PutV1EmployeesEmployeeIdFederalTaxesRequestBody,\n} from '@gusto/embedded-api-v-2025-11-15/models/operations/putv1employeesemployeeidfederaltaxes'\nimport {\n  createFederalTaxesSchema,\n  FILING_STATUS_VALUES,\n  type FederalTaxesOptionalFieldsToRequire,\n  type FederalTaxesFormData,\n  type FederalTaxesFormOutputs,\n  type FilingStatusValue,\n} from './federalTaxesSchema'\nimport {\n  FilingStatusField,\n  TwoJobsField,\n  DependentsAmountField,\n  OtherIncomeField,\n  DeductionsField,\n  ExtraWithholdingField,\n} 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'\n\nexport type { FederalTaxesOptionalFieldsToRequire } from './federalTaxesSchema'\n\n/**\n * Configuration options for {@link useFederalTaxesForm}.\n *\n * @remarks\n * The federal tax record is created automatically with the employee, so the\n * hook is always in update mode and only `employeeId` is required.\n *\n * @public\n */\nexport interface UseFederalTaxesFormProps {\n  /** UUID of the employee whose federal tax record is being updated. */\n  employeeId: string\n  /** Override fields that are optional on update to be required. By default only `filingStatus` is required; pass `{ update: ['twoJobs', 'dependentsAmount', 'otherIncome', 'deductions', 'extraWithholding'] }` to require any subset. See {@link FederalTaxesOptionalFieldsToRequire}. */\n  optionalFieldsToRequire?: FederalTaxesOptionalFieldsToRequire\n  /** Pre-fill form values. Server data takes precedence when the employee already has values on file. */\n  defaultValues?: Partial<FederalTaxesFormData>\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 `useFederalTaxesForm().form.Fields`.\n *\n * @public\n */\nexport interface FederalTaxesFields {\n  /** Filing status select. */\n  FilingStatus: typeof FilingStatusField\n  /** Multiple-jobs (Step 2c) radio group. */\n  TwoJobs: typeof TwoJobsField\n  /** Dependents amount (Step 3) currency input. */\n  DependentsAmount: typeof DependentsAmountField\n  /** Other income (Step 4a) currency input. */\n  OtherIncome: typeof OtherIncomeField\n  /** Deductions (Step 4b) currency input. */\n  Deductions: typeof DeductionsField\n  /** Extra withholding (Step 4c) currency input. */\n  ExtraWithholding: typeof ExtraWithholdingField\n}\n\n/**\n * Ready-state shape returned by {@link useFederalTaxesForm} once data has loaded.\n *\n * @remarks\n * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with\n * the federal-taxes specific `data`, `status`, and `actions`.\n *\n * @public\n */\nexport interface UseFederalTaxesFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  FederalTaxesFormData,\n  FederalTaxesFields\n> {\n  /** The loaded federal tax record. */\n  data: {\n    /** The current federal tax record for the employee. */\n    employeeFederalTax: EmployeeFederalTax\n  }\n  /** Submission state. `mode` is always `'update'` — the federal tax record is created with the employee, so this hook has no create mode. */\n  status: {\n    /** `true` while the update mutation is in flight. */\n    isPending: boolean\n    /** Always `'update'` — the federal tax record is created when the employee is created. */\n    mode: 'update'\n  }\n  /** Submit actions exposed by the hook. */\n  actions: {\n    /** Validates the form, runs the update mutation, and resolves to a {@link HookSubmitResult} containing the updated record. Resolves to `undefined` on validation failure or mutation error. */\n    onSubmit: () => Promise<HookSubmitResult<EmployeeFederalTax> | undefined>\n  }\n}\n\nfunction isRev2020(federalTax: EmployeeFederalTax): federalTax is EmployeeFederalTaxRev2020 {\n  return federalTax.w4DataType === 'rev_2020_w4'\n}\n\nfunction toFilingStatus(value: string | null | undefined): FilingStatusValue | '' {\n  if (!value) return ''\n  return FILING_STATUS_VALUES.find(allowed => allowed === value) ?? ''\n}\n\nfunction toNumber(value: string | null | undefined): number | undefined {\n  if (value === null || value === undefined || value === '') return undefined\n  const parsed = Number(value)\n  return Number.isNaN(parsed) ? undefined : parsed\n}\n\n/**\n * Headless hook for updating an employee's federal tax (W-4) withholding information — filing status, multiple-jobs flag, dependents, other income, deductions, and extra withholding.\n *\n * @remarks\n * The federal tax record is created automatically with the employee, so this hook is always in update mode. Only the revised 2020 W-4 format is supported for updates. By default only `filingStatus` is required; promote any of `twoJobs`, `dependentsAmount`, `otherIncome`, `deductions`, or `extraWithholding` to required via `optionalFieldsToRequire.update`.\n *\n * @param props - See {@link UseFederalTaxesFormProps}.\n * @returns A {@link HookLoadingResult} while data is loading, or a {@link UseFederalTaxesFormReady} once the federal tax record is loaded.\n * @public\n *\n * @example\n * ```tsx\n * import { useFederalTaxesForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n *\n * function FederalTaxesPage({ employeeId }: { employeeId: string }) {\n *   const federalTaxes = useFederalTaxesForm({ employeeId })\n *\n *   if (federalTaxes.isLoading) return <div>Loading...</div>\n *\n *   const { Fields } = federalTaxes.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={federalTaxes}>\n *       <form\n *         onSubmit={e => {\n *           e.preventDefault()\n *           void federalTaxes.actions.onSubmit()\n *         }}\n *       >\n *         <Fields.FilingStatus label=\"Federal filing status\" />\n *         <Fields.TwoJobs label=\"Multiple jobs (2c)\" />\n *         <Fields.DependentsAmount label=\"Dependents\" />\n *         <Fields.OtherIncome label=\"Other income\" />\n *         <Fields.Deductions label=\"Deductions\" />\n *         <Fields.ExtraWithholding label=\"Extra withholding\" />\n *         <button type=\"submit\" disabled={federalTaxes.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useFederalTaxesForm({\n  employeeId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseFederalTaxesFormProps): HookLoadingResult | UseFederalTaxesFormReady {\n  const federalTaxesQuery = useEmployeeTaxSetupGetFederalTaxes({ employeeUuid: employeeId })\n\n  const employeeFederalTax = federalTaxesQuery.data?.employeeFederalTax\n\n  const [schema, metadataConfig] = useMemo(\n    () => createFederalTaxesSchema({ optionalFieldsToRequire }),\n    [optionalFieldsToRequire],\n  )\n\n  const filingStatusOptions = useMemo(\n    () => FILING_STATUS_VALUES.map(value => ({ value, label: value })),\n    [],\n  )\n\n  const twoJobsOptions = useMemo(\n    () => [\n      { label: 'Yes', value: 'true' },\n      { label: 'No', value: 'false' },\n    ],\n    [],\n  )\n\n  const resolvedDefaults: FederalTaxesFormData = useMemo(() => {\n    const rev2020Source =\n      employeeFederalTax && isRev2020(employeeFederalTax) ? employeeFederalTax : undefined\n\n    const fromServerFilingStatus = toFilingStatus(rev2020Source?.filingStatus)\n\n    return {\n      filingStatus: fromServerFilingStatus || partnerDefaults?.filingStatus || '',\n      twoJobs: rev2020Source?.twoJobs ?? partnerDefaults?.twoJobs ?? false,\n      dependentsAmount:\n        toNumber(rev2020Source?.dependentsAmount) ?? partnerDefaults?.dependentsAmount ?? 0,\n      otherIncome: toNumber(rev2020Source?.otherIncome) ?? partnerDefaults?.otherIncome ?? 0,\n      deductions: toNumber(rev2020Source?.deductions) ?? partnerDefaults?.deductions ?? 0,\n      extraWithholding:\n        toNumber(rev2020Source?.extraWithholding) ?? partnerDefaults?.extraWithholding ?? 0,\n    }\n  }, [employeeFederalTax, partnerDefaults])\n\n  const formMethods = useForm<FederalTaxesFormData, unknown, FederalTaxesFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const { mutateAsync: updateFederalTaxes, isPending } =\n    useEmployeeTaxSetupUpdateFederalTaxesMutation()\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('FederalTaxesForm')\n\n  const errorHandling = composeErrorHandler([federalTaxesQuery], { submitError, setSubmitError })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = {\n    filingStatus: withOptions<FilingStatusValue>(\n      baseMetadata.filingStatus,\n      filingStatusOptions,\n      FILING_STATUS_VALUES,\n    ),\n    twoJobs: withOptions<boolean>(baseMetadata.twoJobs, twoJobsOptions, [true, false]),\n    dependentsAmount: baseMetadata.dependentsAmount,\n    otherIncome: baseMetadata.otherIncome,\n    deductions: baseMetadata.deductions,\n    extraWithholding: baseMetadata.extraWithholding,\n  }\n\n  const onSubmit = async (): Promise<HookSubmitResult<EmployeeFederalTax> | undefined> => {\n    let submitResult: HookSubmitResult<EmployeeFederalTax> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: FederalTaxesFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            if (!employeeFederalTax) {\n              throw new SDKInternalError('Federal taxes record was not loaded before submit')\n            }\n\n            const requestBody: PutV1EmployeesEmployeeIdFederalTaxesRequestBody = {\n              filingStatus: payload.filingStatus as FilingStatus,\n              twoJobs: payload.twoJobs,\n              dependentsAmount: payload.dependentsAmount,\n              otherIncome: payload.otherIncome,\n              deductions: payload.deductions,\n              extraWithholding: payload.extraWithholding,\n              w4DataType: 'rev_2020_w4',\n              version: employeeFederalTax.version,\n            }\n\n            const response = await updateFederalTaxes({\n              request: {\n                employeeUuid: employeeId,\n                requestBody,\n              },\n            })\n\n            if (!response.employeeFederalTax) {\n              throw new SDKInternalError('Federal taxes update did not return an updated record')\n            }\n\n            submitResult = { mode: 'update', data: response.employeeFederalTax }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (federalTaxesQuery.isLoading || !employeeFederalTax) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      employeeFederalTax,\n    },\n    status: {\n      isPending,\n      mode: 'update' as const,\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        FilingStatus: FilingStatusField,\n        TwoJobs: TwoJobsField,\n        DependentsAmount: DependentsAmountField,\n        OtherIncome: OtherIncomeField,\n        Deductions: DeductionsField,\n        ExtraWithholding: ExtraWithholdingField,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Discriminated union returned by {@link useFederalTaxesForm} — either the loading state or the ready state.\n *\n * @remarks\n * Use this type when threading the hook result through helpers (e.g.\n * presentational components). Discriminate on `isLoading` to narrow to\n * {@link UseFederalTaxesFormReady}.\n *\n * @public\n */\nexport type UseFederalTaxesFormResult = HookLoadingResult | UseFederalTaxesFormReady\n\n/**\n * Metadata for each {@link useFederalTaxesForm} field, exposed on `form.fieldsMetadata`.\n *\n * @remarks\n * Includes per-field `isDisabled`, `isRequired`, and the dynamic option list\n * for select and radio fields (`filingStatus`, `twoJobs`).\n *\n * @public\n */\nexport type FederalTaxesFieldsMetadata = UseFederalTaxesFormReady['form']['fieldsMetadata']\n\n/**\n * Pre-bound field components exposed on `useFederalTaxesForm().form.Fields`.\n *\n * @remarks\n * Alias for the `Fields` shape on {@link UseFederalTaxesFormReady}. Use this\n * type when typing a presentational component that consumes the hook's\n * fields.\n *\n * @public\n */\nexport type FederalTaxesFormFields = UseFederalTaxesFormReady['form']['Fields']\n"],"names":["isRev2020","federalTax","toFilingStatus","value","FILING_STATUS_VALUES","allowed","toNumber","parsed","useFederalTaxesForm","employeeId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","federalTaxesQuery","useEmployeeTaxSetupGetFederalTaxes","employeeFederalTax","schema","metadataConfig","useMemo","createFederalTaxesSchema","filingStatusOptions","twoJobsOptions","resolvedDefaults","rev2020Source","formMethods","useForm","zodResolver","updateFederalTaxes","isPending","useEmployeeTaxSetupUpdateFederalTaxesMutation","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","withOptions","onSubmit","submitResult","resolve","data","payload","SDKInternalError","requestBody","response","hookFormInternals","useHookFormInternals","FilingStatusField","TwoJobsField","DependentsAmountField","OtherIncomeField","DeductionsField","ExtraWithholdingField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Employee/FederalTaxes/shared/useFederalTaxesSummary/index.d.ts

@@ -1,3 +1,2 @@
 import "./types/i18next.d.ts"
 export { useFederalTaxesSummary } from './useFederalTaxesSummary';
-export type { UseFederalTaxesSummaryParams, UseFederalTaxesSummaryReady, UseFederalTaxesSummaryResult, } from './useFederalTaxesSummary';

package/dist/components/Employee/FederalTaxes/shared/useFederalTaxesSummary/useFederalTaxesSummary.d.ts

@@ -1,20 +1,33 @@
 import { GetV1EmployeesEmployeeIdFederalTaxesResponse } from '@gusto/embedded-api-v-2025-11-15/models/operations/getv1employeesemployeeidfederaltaxes';
 import { BaseHookReady, HookLoadingResult } from '../../../../../partner-hook-utils/types';
 type EmployeeFederalTax = NonNullable<GetV1EmployeesEmployeeIdFederalTaxesResponse['employeeFederalTax']>;
+/**
+ * Parameters accepted by {@link useFederalTaxesSummary}.
+ *
+ * @public
+ */
 export interface UseFederalTaxesSummaryParams {
+    /** UUID of the employee whose federal tax record is being read. */
     employeeId: string;
 }
-export type UseFederalTaxesSummaryReady = BaseHookReady<{
+type UseFederalTaxesSummaryReady = BaseHookReady<{
     employeeFederalTax: EmployeeFederalTax | undefined;
 }, {
     isFetching: boolean;
     isPending: boolean;
 }>;
+/**
+ * Discriminated union returned by {@link useFederalTaxesSummary} — either the loading state or the ready state carrying the loaded federal tax record.
+ *
+ * @public
+ */
 export type UseFederalTaxesSummaryResult = HookLoadingResult | UseFederalTaxesSummaryReady;
 /**
  * Read-only data hook for the Federal Taxes management card. Wraps
  * `useEmployeeTaxSetupGetFederalTaxes` and returns the loaded federal-tax
  * record. Mutations live in `useFederalTaxesForm`.
+ *
+ * @public
  */
 export declare function useFederalTaxesSummary({ employeeId, }: UseFederalTaxesSummaryParams): UseFederalTaxesSummaryResult;
 export {};

package/dist/components/Employee/FederalTaxes/shared/useFederalTaxesSummary/useFederalTaxesSummary.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFederalTaxesSummary.js","sources":["../../../../../../src/components/Employee/FederalTaxes/shared/useFederalTaxesSummary/useFederalTaxesSummary.tsx"],"sourcesContent":["import { useEmployeeTaxSetupGetFederalTaxes } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupGetFederalTaxes'\nimport type { GetV1EmployeesEmployeeIdFederalTaxesResponse } from '@gusto/embedded-api-v-2025-11-15/models/operations/getv1employeesemployeeidfederaltaxes'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type { BaseHookReady, HookLoadingResult } from '@/partner-hook-utils/types'\n\ntype EmployeeFederalTax = NonNullable<\n  GetV1EmployeesEmployeeIdFederalTaxesResponse['employeeFederalTax']\n>\n\nexport interface UseFederalTaxesSummaryParams {\n  employeeId: string\n}\n\nexport type UseFederalTaxesSummaryReady = BaseHookReady<\n  { employeeFederalTax: EmployeeFederalTax | undefined },\n  { isFetching: boolean; isPending: boolean }\n>\n\nexport type UseFederalTaxesSummaryResult = HookLoadingResult | UseFederalTaxesSummaryReady\n\n/**\n * Read-only data hook for the Federal Taxes management card. Wraps\n * `useEmployeeTaxSetupGetFederalTaxes` and returns the loaded federal-tax\n * record. Mutations live in `useFederalTaxesForm`.\n */\nexport function useFederalTaxesSummary({\n  employeeId,\n}: UseFederalTaxesSummaryParams): UseFederalTaxesSummaryResult {\n  const federalTaxesQuery = useEmployeeTaxSetupGetFederalTaxes(\n    { employeeUuid: employeeId },\n    { staleTime: Infinity },\n  )\n\n  const errorHandling = composeErrorHandler([federalTaxesQuery])\n\n  if (federalTaxesQuery.isLoading) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: { employeeFederalTax: federalTaxesQuery.data?.employeeFederalTax },\n    status: {\n      isFetching: federalTaxesQuery.isFetching,\n      isPending: false,\n    },\n    errorHandling,\n  }\n}\n"],"names":["useFederalTaxesSummary","employeeId","federalTaxesQuery","useEmployeeTaxSetupGetFederalTaxes","errorHandling","composeErrorHandler"],"mappings":";;AAyBO,SAASA,EAAuB;AAAA,EACrC,YAAAC;AACF,GAA+D;AAC7D,QAAMC,IAAoBC;AAAA,IACxB,EAAE,cAAcF,EAAA;AAAA,IAChB,EAAE,WAAW,MAAA;AAAA,EAAS,GAGlBG,IAAgBC,EAAoB,CAACH,CAAiB,CAAC;AAE7D,SAAIA,EAAkB,YACb,EAAE,WAAW,IAAM,eAAAE,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM,EAAE,oBAAoBF,EAAkB,MAAM,mBAAA;AAAA,IACpD,QAAQ;AAAA,MACN,YAAYA,EAAkB;AAAA,MAC9B,WAAW;AAAA,IAAA;AAAA,IAEb,eAAAE;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useFederalTaxesSummary.js","sources":["../../../../../../src/components/Employee/FederalTaxes/shared/useFederalTaxesSummary/useFederalTaxesSummary.tsx"],"sourcesContent":["import { useEmployeeTaxSetupGetFederalTaxes } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupGetFederalTaxes'\nimport type { GetV1EmployeesEmployeeIdFederalTaxesResponse } from '@gusto/embedded-api-v-2025-11-15/models/operations/getv1employeesemployeeidfederaltaxes'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type { BaseHookReady, HookLoadingResult } from '@/partner-hook-utils/types'\n\ntype EmployeeFederalTax = NonNullable<\n  GetV1EmployeesEmployeeIdFederalTaxesResponse['employeeFederalTax']\n>\n\n/**\n * Parameters accepted by {@link useFederalTaxesSummary}.\n *\n * @public\n */\nexport interface UseFederalTaxesSummaryParams {\n  /** UUID of the employee whose federal tax record is being read. */\n  employeeId: string\n}\n\ntype UseFederalTaxesSummaryReady = BaseHookReady<\n  { employeeFederalTax: EmployeeFederalTax | undefined },\n  { isFetching: boolean; isPending: boolean }\n>\n\n/**\n * Discriminated union returned by {@link useFederalTaxesSummary} — either the loading state or the ready state carrying the loaded federal tax record.\n *\n * @public\n */\nexport type UseFederalTaxesSummaryResult = HookLoadingResult | UseFederalTaxesSummaryReady\n\n/**\n * Read-only data hook for the Federal Taxes management card. Wraps\n * `useEmployeeTaxSetupGetFederalTaxes` and returns the loaded federal-tax\n * record. Mutations live in `useFederalTaxesForm`.\n *\n * @public\n */\nexport function useFederalTaxesSummary({\n  employeeId,\n}: UseFederalTaxesSummaryParams): UseFederalTaxesSummaryResult {\n  const federalTaxesQuery = useEmployeeTaxSetupGetFederalTaxes(\n    { employeeUuid: employeeId },\n    { staleTime: Infinity },\n  )\n\n  const errorHandling = composeErrorHandler([federalTaxesQuery])\n\n  if (federalTaxesQuery.isLoading) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: { employeeFederalTax: federalTaxesQuery.data?.employeeFederalTax },\n    status: {\n      isFetching: federalTaxesQuery.isFetching,\n      isPending: false,\n    },\n    errorHandling,\n  }\n}\n"],"names":["useFederalTaxesSummary","employeeId","federalTaxesQuery","useEmployeeTaxSetupGetFederalTaxes","errorHandling","composeErrorHandler"],"mappings":";;AAsCO,SAASA,EAAuB;AAAA,EACrC,YAAAC;AACF,GAA+D;AAC7D,QAAMC,IAAoBC;AAAA,IACxB,EAAE,cAAcF,EAAA;AAAA,IAChB,EAAE,WAAW,MAAA;AAAA,EAAS,GAGlBG,IAAgBC,EAAoB,CAACH,CAAiB,CAAC;AAE7D,SAAIA,EAAkB,YACb,EAAE,WAAW,IAAM,eAAAE,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM,EAAE,oBAAoBF,EAAkB,MAAM,mBAAA;AAAA,IACpD,QAAQ;AAAA,MACN,YAAYA,EAAkB;AAAA,MAC9B,WAAW;AAAA,IAAA;AAAA,IAEb,eAAAE;AAAA,EAAA;AAEJ;"}

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

@@ -1,8 +1,29 @@
 import { BaseComponentInterface, CommonComponentInterface } from '../../../Base';
 import { EventType } from '../../../../shared/constants';
 import { OnEventType } from '../../../Base/useBase';
+/**
+ * Props for {@link HomeAddress}.
+ *
+ * @public
+ */
 export interface HomeAddressProps extends CommonComponentInterface<'Employee.Management.HomeAddress'> {
+    /** The associated employee identifier. */
     employeeId: string;
+    /** Event handler fired on flow state changes. */
     onEvent: OnEventType<EventType, unknown>;
 }
+/**
+ * Standalone employee home address management flow.
+ *
+ * @remarks
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `employee/management/homeAddress/editRequested` | Manage button on the home address card clicked | `{ employeeId: string }` |
+ * | `employee/management/homeAddress/editCancelled` | User backed out of the edit form | — |
+ * | `employee/management/homeAddress/created` | A new home address was created | {@link EmployeeAddress} |
+ * | `employee/management/homeAddress/updated` | An existing home address was updated | {@link EmployeeAddress} |
+ * | `employee/management/homeAddress/deleted` | A home address was deleted | {@link EmployeeAddress} |
+ *
+ * @public
+ */
 export declare function HomeAddress({ dictionary, FallbackComponent, ...props }: HomeAddressProps & BaseComponentInterface<'Employee.Management.HomeAddress'>): import("react").JSX.Element;

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

@@ -1 +1 @@
-{"version":3,"file":"HomeAddress.js","sources":["../../../../../src/components/Employee/HomeAddress/management/HomeAddress.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport { CardContextual, type HomeAddressContextInterface } from './HomeAddressComponents'\nimport { homeAddressStateMachine } from './homeAddressStateMachine'\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 HomeAddressProps extends CommonComponentInterface<'Employee.Management.HomeAddress'> {\n  employeeId: string\n  onEvent: OnEventType<EventType, unknown>\n}\n\nfunction HomeAddressFlow({ employeeId, onEvent }: HomeAddressProps) {\n  useI18n('Employee.Management.HomeAddress')\n\n  const machine = useMemo(\n    () =>\n      createMachine('card', homeAddressStateMachine, (ctx: HomeAddressContextInterface) => ({\n        ...ctx,\n        component: CardContextual,\n        employeeId,\n      })),\n    [employeeId],\n  )\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n\nexport function HomeAddress({\n  dictionary,\n  FallbackComponent,\n  ...props\n}: HomeAddressProps & BaseComponentInterface<'Employee.Management.HomeAddress'>) {\n  useComponentDictionary('Employee.Management.HomeAddress', dictionary)\n  return (\n    <BaseBoundaries\n      componentName=\"Employee.Management.HomeAddress\"\n      FallbackComponent={FallbackComponent}\n    >\n      <HomeAddressFlow {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["HomeAddressFlow","employeeId","onEvent","useI18n","machine","useMemo","createMachine","homeAddressStateMachine","ctx","CardContextual","jsx","Flow","HomeAddress","dictionary","FallbackComponent","props","useComponentDictionary","BaseBoundaries"],"mappings":";;;;;;;;;AAoBA,SAASA,EAAgB,EAAE,YAAAC,GAAY,SAAAC,KAA6B;AAClE,EAAAC,EAAQ,iCAAiC;AAEzC,QAAMC,IAAUC;AAAA,IACd,MACEC,EAAc,QAAQC,GAAyB,CAACC,OAAsC;AAAA,MACpF,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,EAAY;AAAA,EAC1B,YAAAC;AAAA,EACA,mBAAAC;AAAA,EACA,GAAGC;AACL,GAAiF;AAC/E,SAAAC,EAAuB,mCAAmCH,CAAU,GAElE,gBAAAH;AAAA,IAACO;AAAA,IAAA;AAAA,MACC,eAAc;AAAA,MACd,mBAAAH;AAAA,MAEA,UAAA,gBAAAJ,EAACV,GAAA,EAAiB,GAAGe,EAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAGlC;"}
+{"version":3,"file":"HomeAddress.js","sources":["../../../../../src/components/Employee/HomeAddress/management/HomeAddress.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport { CardContextual, type HomeAddressContextInterface } from './HomeAddressComponents'\nimport { homeAddressStateMachine } from './homeAddressStateMachine'\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 HomeAddress}.\n *\n * @public\n */\nexport interface HomeAddressProps extends CommonComponentInterface<'Employee.Management.HomeAddress'> {\n  /** The associated employee identifier. */\n  employeeId: string\n  /** Event handler fired on flow state changes. */\n  onEvent: OnEventType<EventType, unknown>\n}\n\nfunction HomeAddressFlow({ employeeId, onEvent }: HomeAddressProps) {\n  useI18n('Employee.Management.HomeAddress')\n\n  const machine = useMemo(\n    () =>\n      createMachine('card', homeAddressStateMachine, (ctx: HomeAddressContextInterface) => ({\n        ...ctx,\n        component: CardContextual,\n        employeeId,\n      })),\n    [employeeId],\n  )\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n\n/**\n * Standalone employee home address management flow.\n *\n * @remarks\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/management/homeAddress/editRequested` | Manage button on the home address card clicked | `{ employeeId: string }` |\n * | `employee/management/homeAddress/editCancelled` | User backed out of the edit form | — |\n * | `employee/management/homeAddress/created` | A new home address was created | {@link EmployeeAddress} |\n * | `employee/management/homeAddress/updated` | An existing home address was updated | {@link EmployeeAddress} |\n * | `employee/management/homeAddress/deleted` | A home address was deleted | {@link EmployeeAddress} |\n *\n * @public\n */\nexport function HomeAddress({\n  dictionary,\n  FallbackComponent,\n  ...props\n}: HomeAddressProps & BaseComponentInterface<'Employee.Management.HomeAddress'>) {\n  useComponentDictionary('Employee.Management.HomeAddress', dictionary)\n  return (\n    <BaseBoundaries\n      componentName=\"Employee.Management.HomeAddress\"\n      FallbackComponent={FallbackComponent}\n    >\n      <HomeAddressFlow {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["HomeAddressFlow","employeeId","onEvent","useI18n","machine","useMemo","createMachine","homeAddressStateMachine","ctx","CardContextual","jsx","Flow","HomeAddress","dictionary","FallbackComponent","props","useComponentDictionary","BaseBoundaries"],"mappings":";;;;;;;;;AA2BA,SAASA,EAAgB,EAAE,YAAAC,GAAY,SAAAC,KAA6B;AAClE,EAAAC,EAAQ,iCAAiC;AAEzC,QAAMC,IAAUC;AAAA,IACd,MACEC,EAAc,QAAQC,GAAyB,CAACC,OAAsC;AAAA,MACpF,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;AAgBO,SAASU,EAAY;AAAA,EAC1B,YAAAC;AAAA,EACA,mBAAAC;AAAA,EACA,GAAGC;AACL,GAAiF;AAC/E,SAAAC,EAAuB,mCAAmCH,CAAU,GAElE,gBAAAH;AAAA,IAACO;AAAA,IAAA;AAAA,MACC,eAAc;AAAA,MACd,mBAAAH;AAAA,MAEA,UAAA,gBAAAJ,EAACV,GAAA,EAAiB,GAAGe,EAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAGlC;"}

package/dist/components/Employee/HomeAddress/management/HomeAddressCard/HomeAddressCard.d.ts

@@ -1,14 +1,26 @@
 import { EventType } from '../../../../../shared/constants';
 import { OnEventType } from '../../../../Base/useBase';
+/**
+ * Props for {@link HomeAddressCard}.
+ *
+ * @public
+ */
 export interface HomeAddressCardProps {
+    /** The associated employee identifier. */
     employeeId: string;
+    /** Event handler fired when the card's Manage button is clicked. */
     onEvent: OnEventType<EventType, unknown>;
 }
 /**
- * Standalone "Home address" card. Owns its own data fetch via
- * `useHomeAddressSummary` and emits
- * `EMPLOYEE_MANAGEMENT_HOME_ADDRESS_EDIT_REQUESTED` when the Manage
- * button is clicked. The card has no alert API — alert rendering
- * (when introduced) is the orchestrator's responsibility.
+ * Standalone employee home address summary card.
+ *
+ * @remarks
+ * Fetches the employee's active home address and renders it alongside a Manage button.
+ *
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `employee/management/homeAddress/editRequested` | Manage button clicked | `{ employeeId: string }` |
+ *
+ * @public
  */
 export declare function HomeAddressCard(props: HomeAddressCardProps): import("react").JSX.Element;

package/dist/components/Employee/HomeAddress/management/HomeAddressCard/HomeAddressCard.js

@@ -2,21 +2,22 @@ import { jsx as e, jsxs as c } from "react/jsx-runtime";
 import { useTranslation as l } from "react-i18next";
 import { Flex as a } from "../../../../Common/Flex/Flex.js";
 import { Loading as p } from "../../../../Common/Loading/Loading.js";
-import { BaseBoundaries as u, BaseLayout as g } from "../../../../Base/Base.js";
-import { useComponentContext as E } from "../../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { useComponentContext as u } from "../../../../../contexts/ComponentAdapter/useComponentContext.js";
+import "react";
+import { BaseBoundaries as g, BaseLayout as E } from "../../../../Base/Base.js";
 import { getStreet as f, getCityStateZip as h } from "../../../../../helpers/formattedStrings.js";
 import { useI18n as x } from "../../../../../i18n/I18n.js";
 import { componentEvents as A } from "../../../../../shared/constants.js";
 import { useHomeAddressSummary as H } from "../../shared/useHomeAddressSummary/useHomeAddressSummary.js";
-function j(o) {
-  return /* @__PURE__ */ e(u, { componentName: "Employee.Management.HomeAddress", children: /* @__PURE__ */ e(C, { ...o }) });
+function O(o) {
+  return /* @__PURE__ */ e(g, { componentName: "Employee.Management.HomeAddress", children: /* @__PURE__ */ e(C, { ...o }) });
 }
 function C({ employeeId: o, onEvent: s }) {
   x("Employee.Management.HomeAddress");
-  const { t } = l("Employee.Management.HomeAddress"), r = E(), n = H({ employeeId: o }), m = n.isLoading, i = n.isLoading ? void 0 : n.data.currentHomeAddress, d = () => {
+  const { t } = l("Employee.Management.HomeAddress"), r = u(), n = H({ employeeId: o }), m = n.isLoading, i = n.isLoading ? void 0 : n.data.currentHomeAddress, d = () => {
     s(A.EMPLOYEE_MANAGEMENT_HOME_ADDRESS_EDIT_REQUESTED, { employeeId: o });
   };
-  return /* @__PURE__ */ e(g, { error: n.errorHandling.errors, children: /* @__PURE__ */ e(
+  return /* @__PURE__ */ e(E, { error: n.errorHandling.errors, children: /* @__PURE__ */ e(
     r.Box,
     {
       header: /* @__PURE__ */ e(
@@ -34,6 +35,6 @@ function C({ employeeId: o, onEvent: s }) {
   ) });
 }
 export {
-  j as HomeAddressCard
+  O as HomeAddressCard
 };
 //# sourceMappingURL=HomeAddressCard.js.map

package/dist/components/Employee/HomeAddress/management/HomeAddressCard/HomeAddressCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"HomeAddressCard.js","sources":["../../../../../../src/components/Employee/HomeAddress/management/HomeAddressCard/HomeAddressCard.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { useHomeAddressSummary } from '../../shared/useHomeAddressSummary'\nimport { Loading } from '@/components/Common'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { BaseBoundaries, BaseLayout } from '@/components/Base/Base'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { getStreet, getCityStateZip } from '@/helpers/formattedStrings'\nimport { useI18n } from '@/i18n'\nimport { componentEvents, type EventType } from '@/shared/constants'\nimport type { OnEventType } from '@/components/Base/useBase'\n\nexport interface HomeAddressCardProps {\n  employeeId: string\n  onEvent: OnEventType<EventType, unknown>\n}\n\n/**\n * Standalone \"Home address\" card. Owns its own data fetch via\n * `useHomeAddressSummary` and emits\n * `EMPLOYEE_MANAGEMENT_HOME_ADDRESS_EDIT_REQUESTED` when the Manage\n * button is clicked. The card has no alert API — alert rendering\n * (when introduced) is the orchestrator's responsibility.\n */\nexport function HomeAddressCard(props: HomeAddressCardProps) {\n  return (\n    <BaseBoundaries componentName=\"Employee.Management.HomeAddress\">\n      <HomeAddressCardContent {...props} />\n    </BaseBoundaries>\n  )\n}\n\nfunction HomeAddressCardContent({ employeeId, onEvent }: HomeAddressCardProps) {\n  useI18n('Employee.Management.HomeAddress')\n  const { t } = useTranslation('Employee.Management.HomeAddress')\n  const Components = useComponentContext()\n\n  const summary = useHomeAddressSummary({ employeeId })\n\n  const isLoading = summary.isLoading\n  const currentHomeAddress = summary.isLoading ? undefined : summary.data.currentHomeAddress\n\n  const handleManage = () => {\n    onEvent(componentEvents.EMPLOYEE_MANAGEMENT_HOME_ADDRESS_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              <Components.Button variant=\"secondary\" onClick={handleManage} isDisabled={isLoading}>\n                {t('card.manageCta')}\n              </Components.Button>\n            }\n          />\n        }\n      >\n        <Flex flexDirection=\"column\" gap={16}>\n          {isLoading ? (\n            <Loading />\n          ) : currentHomeAddress ? (\n            <Flex flexDirection=\"column\" gap={0}>\n              <Components.Text weight=\"medium\">\n                {getStreet(currentHomeAddress).replace(',', '')}\n              </Components.Text>\n              <Components.Text variant=\"supporting\">\n                {getCityStateZip(currentHomeAddress)}\n              </Components.Text>\n            </Flex>\n          ) : (\n            <Components.Text>{t('card.noAddress')}</Components.Text>\n          )}\n        </Flex>\n      </Components.Box>\n    </BaseLayout>\n  )\n}\n"],"names":["HomeAddressCard","props","jsx","BaseBoundaries","HomeAddressCardContent","employeeId","onEvent","useI18n","useTranslation","Components","useComponentContext","summary","useHomeAddressSummary","isLoading","currentHomeAddress","handleManage","componentEvents","BaseLayout","Flex","Loading","jsxs","getStreet","getCityStateZip"],"mappings":";;;;;;;;;;AAuBO,SAASA,EAAgBC,GAA6B;AAC3D,SACE,gBAAAC,EAACC,KAAe,eAAc,mCAC5B,4BAACC,GAAA,EAAwB,GAAGH,GAAO,EAAA,CACrC;AAEJ;AAEA,SAASG,EAAuB,EAAE,YAAAC,GAAY,SAAAC,KAAiC;AAC7E,EAAAC,EAAQ,iCAAiC;AACzC,QAAM,EAAE,EAAA,IAAMC,EAAe,iCAAiC,GACxDC,IAAaC,EAAA,GAEbC,IAAUC,EAAsB,EAAE,YAAAP,GAAY,GAE9CQ,IAAYF,EAAQ,WACpBG,IAAqBH,EAAQ,YAAY,SAAYA,EAAQ,KAAK,oBAElEI,IAAe,MAAM;AACzB,IAAAT,EAAQU,EAAgB,iDAAiD,EAAE,YAAAX,EAAA,CAAY;AAAA,EACzF;AAEA,SACE,gBAAAH,EAACe,GAAA,EAAW,OAAON,EAAQ,cAAc,QACvC,UAAA,gBAAAT;AAAA,IAACO,EAAW;AAAA,IAAX;AAAA,MACC,QACE,gBAAAP;AAAA,QAACO,EAAW;AAAA,QAAX;AAAA,UACC,OAAO,EAAE,YAAY;AAAA,UACrB,QACE,gBAAAP,EAACO,EAAW,QAAX,EAAkB,SAAQ,aAAY,SAASM,GAAc,YAAYF,GACvE,UAAA,EAAE,gBAAgB,EAAA,CACrB;AAAA,QAAA;AAAA,MAAA;AAAA,MAKN,4BAACK,GAAA,EAAK,eAAc,UAAS,KAAK,IAC/B,UAAAL,IACC,gBAAAX,EAACiB,GAAA,EAAQ,IACPL,IACF,gBAAAM,EAACF,GAAA,EAAK,eAAc,UAAS,KAAK,GAChC,UAAA;AAAA,QAAA,gBAAAhB,EAACO,EAAW,MAAX,EAAgB,QAAO,UACrB,UAAAY,EAAUP,CAAkB,EAAE,QAAQ,KAAK,EAAE,EAAA,CAChD;AAAA,QACA,gBAAAZ,EAACO,EAAW,MAAX,EAAgB,SAAQ,cACtB,UAAAa,EAAgBR,CAAkB,EAAA,CACrC;AAAA,MAAA,GACF,sBAECL,EAAW,MAAX,EAAiB,UAAA,EAAE,gBAAgB,GAAE,EAAA,CAE1C;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;"}
+{"version":3,"file":"HomeAddressCard.js","sources":["../../../../../../src/components/Employee/HomeAddress/management/HomeAddressCard/HomeAddressCard.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { useHomeAddressSummary } from '../../shared/useHomeAddressSummary'\nimport { Loading } from '@/components/Common'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { BaseBoundaries, BaseLayout } from '@/components/Base/Base'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { getStreet, getCityStateZip } from '@/helpers/formattedStrings'\nimport { useI18n } from '@/i18n'\nimport { componentEvents, type EventType } from '@/shared/constants'\nimport type { OnEventType } from '@/components/Base/useBase'\n\n/**\n * Props for {@link HomeAddressCard}.\n *\n * @public\n */\nexport interface HomeAddressCardProps {\n  /** The associated employee identifier. */\n  employeeId: string\n  /** Event handler fired when the card's Manage button is clicked. */\n  onEvent: OnEventType<EventType, unknown>\n}\n\n/**\n * Standalone employee home address summary card.\n *\n * @remarks\n * Fetches the employee's active home address and renders it alongside a Manage button.\n *\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/management/homeAddress/editRequested` | Manage button clicked | `{ employeeId: string }` |\n *\n * @public\n */\nexport function HomeAddressCard(props: HomeAddressCardProps) {\n  return (\n    <BaseBoundaries componentName=\"Employee.Management.HomeAddress\">\n      <HomeAddressCardContent {...props} />\n    </BaseBoundaries>\n  )\n}\n\nfunction HomeAddressCardContent({ employeeId, onEvent }: HomeAddressCardProps) {\n  useI18n('Employee.Management.HomeAddress')\n  const { t } = useTranslation('Employee.Management.HomeAddress')\n  const Components = useComponentContext()\n\n  const summary = useHomeAddressSummary({ employeeId })\n\n  const isLoading = summary.isLoading\n  const currentHomeAddress = summary.isLoading ? undefined : summary.data.currentHomeAddress\n\n  const handleManage = () => {\n    onEvent(componentEvents.EMPLOYEE_MANAGEMENT_HOME_ADDRESS_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              <Components.Button variant=\"secondary\" onClick={handleManage} isDisabled={isLoading}>\n                {t('card.manageCta')}\n              </Components.Button>\n            }\n          />\n        }\n      >\n        <Flex flexDirection=\"column\" gap={16}>\n          {isLoading ? (\n            <Loading />\n          ) : currentHomeAddress ? (\n            <Flex flexDirection=\"column\" gap={0}>\n              <Components.Text weight=\"medium\">\n                {getStreet(currentHomeAddress).replace(',', '')}\n              </Components.Text>\n              <Components.Text variant=\"supporting\">\n                {getCityStateZip(currentHomeAddress)}\n              </Components.Text>\n            </Flex>\n          ) : (\n            <Components.Text>{t('card.noAddress')}</Components.Text>\n          )}\n        </Flex>\n      </Components.Box>\n    </BaseLayout>\n  )\n}\n"],"names":["HomeAddressCard","props","jsx","BaseBoundaries","HomeAddressCardContent","employeeId","onEvent","useI18n","useTranslation","Components","useComponentContext","summary","useHomeAddressSummary","isLoading","currentHomeAddress","handleManage","componentEvents","BaseLayout","Flex","Loading","jsxs","getStreet","getCityStateZip"],"mappings":";;;;;;;;;;;AAmCO,SAASA,EAAgBC,GAA6B;AAC3D,SACE,gBAAAC,EAACC,KAAe,eAAc,mCAC5B,4BAACC,GAAA,EAAwB,GAAGH,GAAO,EAAA,CACrC;AAEJ;AAEA,SAASG,EAAuB,EAAE,YAAAC,GAAY,SAAAC,KAAiC;AAC7E,EAAAC,EAAQ,iCAAiC;AACzC,QAAM,EAAE,EAAA,IAAMC,EAAe,iCAAiC,GACxDC,IAAaC,EAAA,GAEbC,IAAUC,EAAsB,EAAE,YAAAP,GAAY,GAE9CQ,IAAYF,EAAQ,WACpBG,IAAqBH,EAAQ,YAAY,SAAYA,EAAQ,KAAK,oBAElEI,IAAe,MAAM;AACzB,IAAAT,EAAQU,EAAgB,iDAAiD,EAAE,YAAAX,EAAA,CAAY;AAAA,EACzF;AAEA,SACE,gBAAAH,EAACe,GAAA,EAAW,OAAON,EAAQ,cAAc,QACvC,UAAA,gBAAAT;AAAA,IAACO,EAAW;AAAA,IAAX;AAAA,MACC,QACE,gBAAAP;AAAA,QAACO,EAAW;AAAA,QAAX;AAAA,UACC,OAAO,EAAE,YAAY;AAAA,UACrB,QACE,gBAAAP,EAACO,EAAW,QAAX,EAAkB,SAAQ,aAAY,SAASM,GAAc,YAAYF,GACvE,UAAA,EAAE,gBAAgB,EAAA,CACrB;AAAA,QAAA;AAAA,MAAA;AAAA,MAKN,4BAACK,GAAA,EAAK,eAAc,UAAS,KAAK,IAC/B,UAAAL,IACC,gBAAAX,EAACiB,GAAA,EAAQ,IACPL,IACF,gBAAAM,EAACF,GAAA,EAAK,eAAc,UAAS,KAAK,GAChC,UAAA;AAAA,QAAA,gBAAAhB,EAACO,EAAW,MAAX,EAAgB,QAAO,UACrB,UAAAY,EAAUP,CAAkB,EAAE,QAAQ,KAAK,EAAE,EAAA,CAChD;AAAA,QACA,gBAAAZ,EAACO,EAAW,MAAX,EAAgB,SAAQ,cACtB,UAAAa,EAAgBR,CAAkB,EAAA,CACrC;AAAA,MAAA,GACF,sBAECL,EAAW,MAAX,EAAiB,UAAA,EAAE,gBAAgB,GAAE,EAAA,CAE1C;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;"}

package/dist/components/Employee/HomeAddress/management/HomeAddressComponents.d.ts

@@ -1,6 +1,9 @@
 import { FlowContextInterface } from '../../../Flow/useFlow';
+/** @internal */
 export interface HomeAddressContextInterface extends FlowContextInterface {
     employeeId?: string;
 }
+/** @internal */
 export declare function CardContextual(): import("react").JSX.Element;
+/** @internal */
 export declare function HomeAddressEditFormContextual(): import("react").JSX.Element;

package/dist/components/Employee/HomeAddress/management/HomeAddressComponents.js.map

@@ -1 +1 @@
-{"version":3,"file":"HomeAddressComponents.js","sources":["../../../../../src/components/Employee/HomeAddress/management/HomeAddressComponents.tsx"],"sourcesContent":["import { HomeAddressCard } from './HomeAddressCard'\nimport { HomeAddressEditForm } from './HomeAddressEditForm'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\nexport interface HomeAddressContextInterface extends FlowContextInterface {\n  employeeId?: string\n}\n\nexport function CardContextual() {\n  const { employeeId, onEvent } = useFlow<HomeAddressContextInterface>()\n  return <HomeAddressCard employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n\nexport function HomeAddressEditFormContextual() {\n  const { employeeId, onEvent } = useFlow<HomeAddressContextInterface>()\n  return <HomeAddressEditForm employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n"],"names":["CardContextual","employeeId","onEvent","useFlow","HomeAddressCard","ensureRequired","HomeAddressEditFormContextual","HomeAddressEditForm"],"mappings":";;;;;AASO,SAASA,IAAiB;AAC/B,QAAM,EAAE,YAAAC,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,2BAAQC,GAAA,EAAgB,YAAYC,EAAeJ,CAAU,GAAG,SAAAC,GAAkB;AACpF;AAEO,SAASI,IAAgC;AAC9C,QAAM,EAAE,YAAAL,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,2BAAQI,GAAA,EAAoB,YAAYF,EAAeJ,CAAU,GAAG,SAAAC,GAAkB;AACxF;"}
+{"version":3,"file":"HomeAddressComponents.js","sources":["../../../../../src/components/Employee/HomeAddress/management/HomeAddressComponents.tsx"],"sourcesContent":["import { HomeAddressCard } from './HomeAddressCard'\nimport { HomeAddressEditForm } from './HomeAddressEditForm'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/** @internal */\nexport interface HomeAddressContextInterface extends FlowContextInterface {\n  employeeId?: string\n}\n\n/** @internal */\nexport function CardContextual() {\n  const { employeeId, onEvent } = useFlow<HomeAddressContextInterface>()\n  return <HomeAddressCard employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n\n/** @internal */\nexport function HomeAddressEditFormContextual() {\n  const { employeeId, onEvent } = useFlow<HomeAddressContextInterface>()\n  return <HomeAddressEditForm employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n"],"names":["CardContextual","employeeId","onEvent","useFlow","HomeAddressCard","ensureRequired","HomeAddressEditFormContextual","HomeAddressEditForm"],"mappings":";;;;;AAWO,SAASA,IAAiB;AAC/B,QAAM,EAAE,YAAAC,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,2BAAQC,GAAA,EAAgB,YAAYC,EAAeJ,CAAU,GAAG,SAAAC,GAAkB;AACpF;AAGO,SAASI,IAAgC;AAC9C,QAAM,EAAE,YAAAL,GAAY,SAAAC,EAAA,IAAYC,EAAA;AAChC,2BAAQI,GAAA,EAAoB,YAAYF,EAAeJ,CAAU,GAAG,SAAAC,GAAkB;AACxF;"}

package/dist/components/Employee/HomeAddress/management/HomeAddressEditForm.d.ts

@@ -1,6 +1,26 @@
 import { BaseComponentInterface, CommonComponentInterface } from '../../../Base/Base';
+/**
+ * Props for {@link HomeAddressEditForm}.
+ *
+ * @public
+ */
 export interface HomeAddressEditFormProps extends CommonComponentInterface<'Employee.Management.HomeAddress'> {
+    /** The associated employee identifier. */
     employeeId: string;
+    /** Event handler fired on form save, cancel, and delete actions. */
     onEvent: BaseComponentInterface['onEvent'];
 }
+/**
+ * Standalone employee home address edit form for creating, updating, and deleting addresses.
+ *
+ * @remarks
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `employee/management/homeAddress/created` | A new home address was created | {@link EmployeeAddress} |
+ * | `employee/management/homeAddress/updated` | An existing home address was updated | {@link EmployeeAddress} |
+ * | `employee/management/homeAddress/deleted` | A home address was deleted | {@link EmployeeAddress} |
+ * | `employee/management/homeAddress/editCancelled` | User backed out of the edit form | — |
+ *
+ * @public
+ */
 export declare function HomeAddressEditForm({ FallbackComponent, ...props }: HomeAddressEditFormProps & BaseComponentInterface): import("react").JSX.Element;

package/dist/components/Employee/HomeAddress/management/HomeAddressEditForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"HomeAddressEditForm.js","sources":["../../../../../src/components/Employee/HomeAddress/management/HomeAddressEditForm.tsx"],"sourcesContent":["import type { EmployeeAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeaddress'\nimport { HomeAddressView } from './HomeAddressView'\nimport {\n  isUseHomeAddressManagementSuccess,\n  useHomeAddressManagement,\n} from './useHomeAddressManagement'\nimport {\n  BaseBoundaries,\n  BaseLayout,\n  type BaseComponentInterface,\n  type CommonComponentInterface,\n} from '@/components/Base/Base'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport type { HookSubmitResult } from '@/partner-hook-utils/types'\nimport { componentEvents } from '@/shared/constants'\n\nexport interface HomeAddressEditFormProps extends CommonComponentInterface<'Employee.Management.HomeAddress'> {\n  employeeId: string\n  onEvent: BaseComponentInterface['onEvent']\n}\n\nfunction HomeAddressEditFormRoot({ employeeId, onEvent, dictionary }: HomeAddressEditFormProps) {\n  useI18n('Employee.Management.HomeAddress')\n  useComponentDictionary('Employee.Management.HomeAddress', dictionary)\n\n  const management = useHomeAddressManagement({ employeeId, onEvent })\n\n  if (management.isLoading) {\n    return <BaseLayout isLoading error={management.errorHandling.errors} />\n  }\n\n  if (!isUseHomeAddressManagementSuccess(management)) {\n    return <BaseLayout error={management.errorHandling.errors} />\n  }\n\n  const handleSaved = (result: HookSubmitResult<EmployeeAddress>) => {\n    if (result.mode === 'create') {\n      onEvent(componentEvents.EMPLOYEE_MANAGEMENT_HOME_ADDRESS_CREATED, result.data)\n    } else {\n      onEvent(componentEvents.EMPLOYEE_MANAGEMENT_HOME_ADDRESS_UPDATED, result.data)\n    }\n  }\n\n  return (\n    <BaseLayout error={management.errorHandling.errors}>\n      <HomeAddressView\n        editHomeAddressForm={management.data.editHomeAddressForm}\n        createHomeAddressForm={management.data.createHomeAddressForm}\n        employeeHomeAddresses={management.data.employeeHomeAddresses}\n        employeeDisplayName={management.data.employeeDisplayName}\n        editingHomeAddressUuid={management.data.editingHomeAddressUuid}\n        onEditAddressTargetChange={management.actions.setEditAddressTarget}\n        onSaved={handleSaved}\n        onConfirmDelete={management.actions.confirmDeleteHomeAddress}\n        onBack={() => {\n          onEvent(componentEvents.EMPLOYEE_MANAGEMENT_HOME_ADDRESS_EDIT_CANCELLED)\n        }}\n        isDeletePending={management.status.isDeletePending}\n      />\n    </BaseLayout>\n  )\n}\n\nexport function HomeAddressEditForm({\n  FallbackComponent,\n  ...props\n}: HomeAddressEditFormProps & BaseComponentInterface) {\n  return (\n    <BaseBoundaries\n      componentName=\"Employee.Management.HomeAddress\"\n      FallbackComponent={FallbackComponent}\n    >\n      <HomeAddressEditFormRoot {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["HomeAddressEditFormRoot","employeeId","onEvent","dictionary","useI18n","useComponentDictionary","management","useHomeAddressManagement","BaseLayout","isUseHomeAddressManagementSuccess","jsx","handleSaved","result","componentEvents","HomeAddressView","HomeAddressEditForm","FallbackComponent","props","BaseBoundaries"],"mappings":";;;;;;AAqBA,SAASA,EAAwB,EAAE,YAAAC,GAAY,SAAAC,GAAS,YAAAC,KAAwC;AAC9F,EAAAC,EAAQ,iCAAiC,GACzCC,EAAuB,mCAAmCF,CAAU;AAEpE,QAAMG,IAAaC,EAAyB,EAAE,YAAAN,GAAY,SAAAC,GAAS;AAEnE,MAAII,EAAW;AACb,6BAAQE,GAAA,EAAW,WAAS,IAAC,OAAOF,EAAW,cAAc,QAAQ;AAGvE,MAAI,CAACG,EAAkCH,CAAU;AAC/C,WAAO,gBAAAI,EAACF,GAAA,EAAW,OAAOF,EAAW,cAAc,QAAQ;AAG7D,QAAMK,IAAc,CAACC,MAA8C;AACjE,IAAIA,EAAO,SAAS,WAClBV,EAAQW,EAAgB,0CAA0CD,EAAO,IAAI,IAE7EV,EAAQW,EAAgB,0CAA0CD,EAAO,IAAI;AAAA,EAEjF;AAEA,SACE,gBAAAF,EAACF,GAAA,EAAW,OAAOF,EAAW,cAAc,QAC1C,UAAA,gBAAAI;AAAA,IAACI;AAAA,IAAA;AAAA,MACC,qBAAqBR,EAAW,KAAK;AAAA,MACrC,uBAAuBA,EAAW,KAAK;AAAA,MACvC,uBAAuBA,EAAW,KAAK;AAAA,MACvC,qBAAqBA,EAAW,KAAK;AAAA,MACrC,wBAAwBA,EAAW,KAAK;AAAA,MACxC,2BAA2BA,EAAW,QAAQ;AAAA,MAC9C,SAASK;AAAA,MACT,iBAAiBL,EAAW,QAAQ;AAAA,MACpC,QAAQ,MAAM;AACZ,QAAAJ,EAAQW,EAAgB,+CAA+C;AAAA,MACzE;AAAA,MACA,iBAAiBP,EAAW,OAAO;AAAA,IAAA;AAAA,EAAA,GAEvC;AAEJ;AAEO,SAASS,EAAoB;AAAA,EAClC,mBAAAC;AAAA,EACA,GAAGC;AACL,GAAsD;AACpD,SACE,gBAAAP;AAAA,IAACQ;AAAA,IAAA;AAAA,MACC,eAAc;AAAA,MACd,mBAAAF;AAAA,MAEA,UAAA,gBAAAN,EAACV,GAAA,EAAyB,GAAGiB,EAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAG1C;"}
+{"version":3,"file":"HomeAddressEditForm.js","sources":["../../../../../src/components/Employee/HomeAddress/management/HomeAddressEditForm.tsx"],"sourcesContent":["import type { EmployeeAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeaddress'\nimport { HomeAddressView } from './HomeAddressView'\nimport {\n  isUseHomeAddressManagementSuccess,\n  useHomeAddressManagement,\n} from './useHomeAddressManagement'\nimport {\n  BaseBoundaries,\n  BaseLayout,\n  type BaseComponentInterface,\n  type CommonComponentInterface,\n} from '@/components/Base/Base'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport type { HookSubmitResult } from '@/partner-hook-utils/types'\nimport { componentEvents } from '@/shared/constants'\n\n/**\n * Props for {@link HomeAddressEditForm}.\n *\n * @public\n */\nexport interface HomeAddressEditFormProps extends CommonComponentInterface<'Employee.Management.HomeAddress'> {\n  /** The associated employee identifier. */\n  employeeId: string\n  /** Event handler fired on form save, cancel, and delete actions. */\n  onEvent: BaseComponentInterface['onEvent']\n}\n\nfunction HomeAddressEditFormRoot({ employeeId, onEvent, dictionary }: HomeAddressEditFormProps) {\n  useI18n('Employee.Management.HomeAddress')\n  useComponentDictionary('Employee.Management.HomeAddress', dictionary)\n\n  const management = useHomeAddressManagement({ employeeId, onEvent })\n\n  if (management.isLoading) {\n    return <BaseLayout isLoading error={management.errorHandling.errors} />\n  }\n\n  if (!isUseHomeAddressManagementSuccess(management)) {\n    return <BaseLayout error={management.errorHandling.errors} />\n  }\n\n  const handleSaved = (result: HookSubmitResult<EmployeeAddress>) => {\n    if (result.mode === 'create') {\n      onEvent(componentEvents.EMPLOYEE_MANAGEMENT_HOME_ADDRESS_CREATED, result.data)\n    } else {\n      onEvent(componentEvents.EMPLOYEE_MANAGEMENT_HOME_ADDRESS_UPDATED, result.data)\n    }\n  }\n\n  return (\n    <BaseLayout error={management.errorHandling.errors}>\n      <HomeAddressView\n        editHomeAddressForm={management.data.editHomeAddressForm}\n        createHomeAddressForm={management.data.createHomeAddressForm}\n        employeeHomeAddresses={management.data.employeeHomeAddresses}\n        employeeDisplayName={management.data.employeeDisplayName}\n        editingHomeAddressUuid={management.data.editingHomeAddressUuid}\n        onEditAddressTargetChange={management.actions.setEditAddressTarget}\n        onSaved={handleSaved}\n        onConfirmDelete={management.actions.confirmDeleteHomeAddress}\n        onBack={() => {\n          onEvent(componentEvents.EMPLOYEE_MANAGEMENT_HOME_ADDRESS_EDIT_CANCELLED)\n        }}\n        isDeletePending={management.status.isDeletePending}\n      />\n    </BaseLayout>\n  )\n}\n\n/**\n * Standalone employee home address edit form for creating, updating, and deleting addresses.\n *\n * @remarks\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/management/homeAddress/created` | A new home address was created | {@link EmployeeAddress} |\n * | `employee/management/homeAddress/updated` | An existing home address was updated | {@link EmployeeAddress} |\n * | `employee/management/homeAddress/deleted` | A home address was deleted | {@link EmployeeAddress} |\n * | `employee/management/homeAddress/editCancelled` | User backed out of the edit form | — |\n *\n * @public\n */\nexport function HomeAddressEditForm({\n  FallbackComponent,\n  ...props\n}: HomeAddressEditFormProps & BaseComponentInterface) {\n  return (\n    <BaseBoundaries\n      componentName=\"Employee.Management.HomeAddress\"\n      FallbackComponent={FallbackComponent}\n    >\n      <HomeAddressEditFormRoot {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["HomeAddressEditFormRoot","employeeId","onEvent","dictionary","useI18n","useComponentDictionary","management","useHomeAddressManagement","BaseLayout","isUseHomeAddressManagementSuccess","jsx","handleSaved","result","componentEvents","HomeAddressView","HomeAddressEditForm","FallbackComponent","props","BaseBoundaries"],"mappings":";;;;;;AA4BA,SAASA,EAAwB,EAAE,YAAAC,GAAY,SAAAC,GAAS,YAAAC,KAAwC;AAC9F,EAAAC,EAAQ,iCAAiC,GACzCC,EAAuB,mCAAmCF,CAAU;AAEpE,QAAMG,IAAaC,EAAyB,EAAE,YAAAN,GAAY,SAAAC,GAAS;AAEnE,MAAII,EAAW;AACb,6BAAQE,GAAA,EAAW,WAAS,IAAC,OAAOF,EAAW,cAAc,QAAQ;AAGvE,MAAI,CAACG,EAAkCH,CAAU;AAC/C,WAAO,gBAAAI,EAACF,GAAA,EAAW,OAAOF,EAAW,cAAc,QAAQ;AAG7D,QAAMK,IAAc,CAACC,MAA8C;AACjE,IAAIA,EAAO,SAAS,WAClBV,EAAQW,EAAgB,0CAA0CD,EAAO,IAAI,IAE7EV,EAAQW,EAAgB,0CAA0CD,EAAO,IAAI;AAAA,EAEjF;AAEA,SACE,gBAAAF,EAACF,GAAA,EAAW,OAAOF,EAAW,cAAc,QAC1C,UAAA,gBAAAI;AAAA,IAACI;AAAA,IAAA;AAAA,MACC,qBAAqBR,EAAW,KAAK;AAAA,MACrC,uBAAuBA,EAAW,KAAK;AAAA,MACvC,uBAAuBA,EAAW,KAAK;AAAA,MACvC,qBAAqBA,EAAW,KAAK;AAAA,MACrC,wBAAwBA,EAAW,KAAK;AAAA,MACxC,2BAA2BA,EAAW,QAAQ;AAAA,MAC9C,SAASK;AAAA,MACT,iBAAiBL,EAAW,QAAQ;AAAA,MACpC,QAAQ,MAAM;AACZ,QAAAJ,EAAQW,EAAgB,+CAA+C;AAAA,MACzE;AAAA,MACA,iBAAiBP,EAAW,OAAO;AAAA,IAAA;AAAA,EAAA,GAEvC;AAEJ;AAeO,SAASS,EAAoB;AAAA,EAClC,mBAAAC;AAAA,EACA,GAAGC;AACL,GAAsD;AACpD,SACE,gBAAAP;AAAA,IAACQ;AAAA,IAAA;AAAA,MACC,eAAc;AAAA,MACd,mBAAAF;AAAA,MAEA,UAAA,gBAAAN,EAACV,GAAA,EAAyB,GAAGiB,EAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAG1C;"}

package/dist/components/Employee/HomeAddress/management/HomeAddressView.d.ts

@@ -1,6 +1,7 @@
 import { EmployeeAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeaddress';
 import { UseHomeAddressFormReady } from '../../Profile/shared/useHomeAddressForm';
 import { HookSubmitResult } from '../../../../partner-hook-utils/types';
+/** @internal */
 export interface HomeAddressViewProps {
     editHomeAddressForm: UseHomeAddressFormReady;
     createHomeAddressForm: UseHomeAddressFormReady;
@@ -16,4 +17,5 @@ export interface HomeAddressViewProps {
     onBack: () => void;
     isDeletePending?: boolean;
 }
+/** @internal */
 export declare function HomeAddressView({ editHomeAddressForm, createHomeAddressForm, employeeHomeAddresses, employeeDisplayName, editingHomeAddressUuid, onEditAddressTargetChange, onSaved, onConfirmDelete, onBack, isDeletePending, }: HomeAddressViewProps): import("react").JSX.Element;

package/dist/components/Employee/HomeAddress/management/HomeAddressView.js

@@ -12,10 +12,10 @@ import { Flex as a, FlexItem as we } from "../../../Common/Flex/Flex.js";
 import { Grid as $ } from "../../../Common/Grid/Grid.js";
 import { EmptyData as Ue } from "../../../Common/EmptyData/EmptyData.js";
 import { ActionsLayout as We } from "../../../Common/ActionsLayout/ActionsLayout.js";
+import { HamburgerMenu as Be } from "../../../Common/HamburgerMenu/HamburgerMenu.js";
 import { useComponentContext as Y } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
-import { formatDateLongWithYear as k, normalizeToDate as Be, addDays as Fe } from "../../../../helpers/dateFormatting.js";
+import { formatDateLongWithYear as k, normalizeToDate as Fe, addDays as Ve } from "../../../../helpers/dateFormatting.js";
 import { formatStreetForDisplay as j, getCityStateZip as K } from "../../../../helpers/formattedStrings.js";
-import { HamburgerMenu as Ve } from "../../../Common/HamburgerMenu/HamburgerMenu.js";
 import { useDataView as Qe } from "../../../Common/DataView/useDataView.js";
 import { DataView as Oe } from "../../../Common/DataView/DataView.js";
 function q({
@@ -125,9 +125,9 @@ function dt({
     if (l === -1 || l >= x.length - 1) return "—";
     const d = x[l + 1]?.effectiveDate;
     if (!d) return "—";
-    const f = Be(d.toString());
+    const f = Fe(d.toString());
     if (!f) return "—";
-    const h = Fe(f, -1), be = h.getFullYear(), Ee = String(h.getMonth() + 1).padStart(2, "0"), Me = String(h.getDate()).padStart(2, "0");
+    const h = Ve(f, -1), be = h.getFullYear(), Ee = String(h.getMonth() + 1).padStart(2, "0"), Me = String(h.getDate()).padStart(2, "0");
     return k(`${be}-${Ee}-${Me}`);
   }, De = Qe({
     data: pe,
@@ -149,7 +149,7 @@ function dt({
       }
     ],
     itemMenu: (i) => /* @__PURE__ */ t(
-      Ve,
+      Be,
       {
         triggerLabel: e("rowMenuAriaLabel"),
         items: [