@gusto/embedded-react-sdk 0.47.1 → 0.48.0

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

@@ -1 +1 @@
-{"version":3,"file":"federalTaxesSchema.js","sources":["../../../../../../src/components/Employee/FederalTaxes/shared/useFederalTaxesForm/federalTaxesSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport { FilingStatus } from '@gusto/embedded-api-v-2025-11-15/models/operations/putv1employeesemployeeidfederaltaxes'\nimport {\n  buildFormSchema,\n  type RequiredFieldConfig,\n  type OptionalFieldsToRequire,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { coerceNaN, coerceStringBoolean } from '@/partner-hook-utils/form/preprocessors'\n\n// ── Error codes ────────────────────────────────────────────────────────\n\nexport const FederalTaxesErrorCodes = {\n  REQUIRED: 'REQUIRED',\n} as const\n\nexport type FederalTaxesErrorCode =\n  (typeof FederalTaxesErrorCodes)[keyof typeof FederalTaxesErrorCodes]\n\n// ── Filing status options ──────────────────────────────────────────────\n\nexport const FILING_STATUS_VALUES = [\n  FilingStatus.Single,\n  FilingStatus.Married,\n  FilingStatus.HeadOfHousehold,\n  FilingStatus.ExemptFromWithholding,\n] as const\n\nexport type FilingStatusValue = (typeof FILING_STATUS_VALUES)[number]\n\n// ── Field validators ───────────────────────────────────────────────────\n\n// `filingStatus` is typed as `string` (not `z.enum`) so the initial empty form state is valid\n// for parsing while still failing the required check via `buildFormSchema`. The actual value is\n// constrained at the UI layer via the Select's options, and cast back to `FilingStatus` at\n// submission time.\nconst fieldValidators = {\n  filingStatus: z.string(),\n  twoJobs: z.preprocess(coerceStringBoolean, z.boolean()),\n  dependentsAmount: z.preprocess(coerceNaN(0), z.number()),\n  otherIncome: z.preprocess(coerceNaN(0), z.number()),\n  deductions: z.preprocess(coerceNaN(0), z.number()),\n  extraWithholding: z.preprocess(coerceNaN(0), z.number()),\n}\n\nexport type FederalTaxesField = keyof typeof fieldValidators\n\nexport type FederalTaxesFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\nexport type FederalTaxesFormOutputs = FederalTaxesFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n\n// Only `filingStatus` is required by the API on update. The remaining fields are\n// optional by default so partners can decide their own UX; the bundled\n// `<FederalTaxes>` component promotes them to required via `optionalFieldsToRequire`\n// to preserve the original (all-required) behavior.\nconst requiredFieldsConfig = {\n  twoJobs: 'never',\n  dependentsAmount: 'never',\n  otherIncome: 'never',\n  deductions: 'never',\n  extraWithholding: 'never',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\nexport type FederalTaxesOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\ninterface FederalTaxesSchemaOptions {\n  optionalFieldsToRequire?: FederalTaxesOptionalFieldsToRequire\n}\n\nexport function createFederalTaxesSchema(options: FederalTaxesSchemaOptions = {}) {\n  const { optionalFieldsToRequire } = options\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: FederalTaxesErrorCodes.REQUIRED,\n    mode: 'update',\n    optionalFieldsToRequire,\n  })\n}\n"],"names":["FederalTaxesErrorCodes","FILING_STATUS_VALUES","FilingStatus","fieldValidators","z","coerceStringBoolean","coerceNaN","requiredFieldsConfig","createFederalTaxesSchema","options","optionalFieldsToRequire","buildFormSchema"],"mappings":";;;;AAWO,MAAMA,IAAyB;AAAA,EACpC,UAAU;AACZ,GAOaC,IAAuB;AAAA,EAClCC,EAAa;AAAA,EACbA,EAAa;AAAA,EACbA,EAAa;AAAA,EACbA,EAAa;AACf,GAUMC,IAAkB;AAAA,EACtB,cAAcC,EAAE,OAAA;AAAA,EAChB,SAASA,EAAE,WAAWC,GAAqBD,EAAE,SAAS;AAAA,EACtD,kBAAkBA,EAAE,WAAWE,EAAU,CAAC,GAAGF,EAAE,QAAQ;AAAA,EACvD,aAAaA,EAAE,WAAWE,EAAU,CAAC,GAAGF,EAAE,QAAQ;AAAA,EAClD,YAAYA,EAAE,WAAWE,EAAU,CAAC,GAAGF,EAAE,QAAQ;AAAA,EACjD,kBAAkBA,EAAE,WAAWE,EAAU,CAAC,GAAGF,EAAE,QAAQ;AACzD,GAeMG,IAAuB;AAAA,EAC3B,SAAS;AAAA,EACT,kBAAkB;AAAA,EAClB,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,kBAAkB;AACpB;AAYO,SAASC,EAAyBC,IAAqC,IAAI;AAChF,QAAM,EAAE,yBAAAC,MAA4BD;AAEpC,SAAOE,EAAgBR,GAAiB;AAAA,IACtC,sBAAAI;AAAA,IACA,mBAAmBP,EAAuB;AAAA,IAC1C,MAAM;AAAA,IACN,yBAAAU;AAAA,EAAA,CACD;AACH;"}
+{"version":3,"file":"federalTaxesSchema.js","sources":["../../../../../../src/components/Employee/FederalTaxes/shared/useFederalTaxesForm/federalTaxesSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport { FilingStatus } from '@gusto/embedded-api-v-2025-11-15/models/operations/putv1employeesemployeeidfederaltaxes'\nimport {\n  buildFormSchema,\n  type RequiredFieldConfig,\n  type OptionalFieldsToRequire,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { coerceNaN, coerceStringBoolean } from '@/partner-hook-utils/form/preprocessors'\n\n// ── Error codes ────────────────────────────────────────────────────────\n\n/**\n * Validation error codes emitted by the federal taxes form schema. Map these\n * codes to localized copy in `validationMessages` when composing the hook.\n *\n * @public\n */\nexport const FederalTaxesErrorCodes = {\n  REQUIRED: 'REQUIRED',\n} as const\n\n/**\n * Union of validation error code strings emitted by the federal taxes form\n * schema.\n *\n * @public\n */\nexport type FederalTaxesErrorCode =\n  (typeof FederalTaxesErrorCodes)[keyof typeof FederalTaxesErrorCodes]\n\n// ── Filing status options ──────────────────────────────────────────────\n\n/**\n * Supported W-4 filing status values: single, married filing jointly, head of\n * household, and exempt from withholding.\n *\n * @public\n */\nexport const FILING_STATUS_VALUES = [\n  FilingStatus.Single,\n  FilingStatus.Married,\n  FilingStatus.HeadOfHousehold,\n  FilingStatus.ExemptFromWithholding,\n] as const\n\n/**\n * Union of filing status values that the form accepts.\n *\n * @public\n */\nexport type FilingStatusValue = (typeof FILING_STATUS_VALUES)[number]\n\n// ── Field validators ───────────────────────────────────────────────────\n\n// `filingStatus` is typed as `string` (not `z.enum`) so the initial empty form state is valid\n// for parsing while still failing the required check via `buildFormSchema`. The actual value is\n// constrained at the UI layer via the Select's options, and cast back to `FilingStatus` at\n// submission time.\nconst fieldValidators = {\n  filingStatus: z.string(),\n  twoJobs: z.preprocess(coerceStringBoolean, z.boolean()),\n  dependentsAmount: z.preprocess(coerceNaN(0), z.number()),\n  otherIncome: z.preprocess(coerceNaN(0), z.number()),\n  deductions: z.preprocess(coerceNaN(0), z.number()),\n  extraWithholding: z.preprocess(coerceNaN(0), z.number()),\n}\n\n/**\n * Field names accepted by the federal taxes form.\n *\n * @public\n */\nexport type FederalTaxesField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the federal taxes form.\n *\n * @public\n */\nexport type FederalTaxesFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n/**\n * Shape of the validated values produced by the federal taxes form on submit.\n *\n * @public\n */\nexport type FederalTaxesFormOutputs = FederalTaxesFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n\n// Only `filingStatus` is required by the API on update. The remaining fields are\n// optional by default so partners can decide their own UX; the bundled\n// `<FederalTaxes>` component promotes them to required via `optionalFieldsToRequire`\n// to preserve the original (all-required) behavior.\nconst requiredFieldsConfig = {\n  twoJobs: 'never',\n  dependentsAmount: 'never',\n  otherIncome: 'never',\n  deductions: 'never',\n  extraWithholding: 'never',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\n/**\n * Keys of optional federal taxes fields that can be promoted to required via\n * the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type FederalTaxesOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface FederalTaxesSchemaOptions {\n  optionalFieldsToRequire?: FederalTaxesOptionalFieldsToRequire\n}\n\n/** @internal */\nexport function createFederalTaxesSchema(options: FederalTaxesSchemaOptions = {}) {\n  const { optionalFieldsToRequire } = options\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: FederalTaxesErrorCodes.REQUIRED,\n    mode: 'update',\n    optionalFieldsToRequire,\n  })\n}\n"],"names":["FederalTaxesErrorCodes","FILING_STATUS_VALUES","FilingStatus","fieldValidators","z","coerceStringBoolean","coerceNaN","requiredFieldsConfig","createFederalTaxesSchema","options","optionalFieldsToRequire","buildFormSchema"],"mappings":";;;;AAiBO,MAAMA,IAAyB;AAAA,EACpC,UAAU;AACZ,GAmBaC,IAAuB;AAAA,EAClCC,EAAa;AAAA,EACbA,EAAa;AAAA,EACbA,EAAa;AAAA,EACbA,EAAa;AACf,GAeMC,IAAkB;AAAA,EACtB,cAAcC,EAAE,OAAA;AAAA,EAChB,SAASA,EAAE,WAAWC,GAAqBD,EAAE,SAAS;AAAA,EACtD,kBAAkBA,EAAE,WAAWE,EAAU,CAAC,GAAGF,EAAE,QAAQ;AAAA,EACvD,aAAaA,EAAE,WAAWE,EAAU,CAAC,GAAGF,EAAE,QAAQ;AAAA,EAClD,YAAYA,EAAE,WAAWE,EAAU,CAAC,GAAGF,EAAE,QAAQ;AAAA,EACjD,kBAAkBA,EAAE,WAAWE,EAAU,CAAC,GAAGF,EAAE,QAAQ;AACzD,GA8BMG,IAAuB;AAAA,EAC3B,SAAS;AAAA,EACT,kBAAkB;AAAA,EAClB,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,kBAAkB;AACpB;AAoBO,SAASC,EAAyBC,IAAqC,IAAI;AAChF,QAAM,EAAE,yBAAAC,MAA4BD;AAEpC,SAAOE,EAAgBR,GAAiB;AAAA,IACtC,sBAAAI;AAAA,IACA,mBAAmBP,EAAuB;AAAA,IAC1C,MAAM;AAAA,IACN,yBAAAU;AAAA,EAAA,CACD;AACH;"}

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

@@ -3,16 +3,128 @@ import { SelectHookFieldProps } from '../../../../../partner-hook-utils/form/fie
 import { RadioGroupHookFieldProps } from '../../../../../partner-hook-utils/form/fields/RadioGroupHookField';
 import { NumberInputHookFieldProps } from '../../../../../partner-hook-utils/form/fields/NumberInputHookField';
 import { HookFieldProps } from '../../../../../partner-hook-utils/types';
+/**
+ * The required-field error code produced by {@link useFederalTaxesForm} fields.
+ *
+ * @remarks
+ * Used as the `validationMessages` key for every federal taxes field. See
+ * {@link FederalTaxesErrorCodes}.
+ *
+ * @public
+ */
 export type RequiredValidation = typeof FederalTaxesErrorCodes.REQUIRED;
+/**
+ * Props accepted by {@link useFederalTaxesForm}'s `Fields.FilingStatus` component.
+ *
+ * @public
+ */
 export type FilingStatusFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, FilingStatusValue>>;
+/**
+ * Select bound to the `filingStatus` field of {@link useFederalTaxesForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.FilingStatus`. Options are
+ * populated from `FILING_STATUS_VALUES` (`Single`, `Married`,
+ * `Head of Household`, `Exempt from withholding`). The default option label is
+ * the raw filing status value — pass `getOptionLabel` to localize.
+ *
+ * @param props - {@link FilingStatusFieldProps} — accepts the standard hook field props plus `getOptionLabel` for filing-status display.
+ * @returns The rendered select bound to `filingStatus`.
+ * @public
+ */
 export declare function FilingStatusField(props: FilingStatusFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useFederalTaxesForm}'s `Fields.TwoJobs` component.
+ *
+ * @public
+ */
 export type TwoJobsFieldProps = HookFieldProps<RadioGroupHookFieldProps<RequiredValidation, boolean>>;
+/**
+ * Radio group bound to the `twoJobs` field of {@link useFederalTaxesForm} for the W-4 multiple-jobs question (Step 2c).
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.TwoJobs`. Two options for
+ * `true` and `false`. The default labels are `Yes` and `No` — pass
+ * `getOptionLabel` to localize. The form submits a boolean value.
+ *
+ * @param props - {@link TwoJobsFieldProps} — accepts the standard hook field props plus `getOptionLabel` for option display.
+ * @returns The rendered radio group bound to `twoJobs`.
+ * @public
+ */
 export declare function TwoJobsField(props: TwoJobsFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useFederalTaxesForm}'s `Fields.DependentsAmount` component.
+ *
+ * @public
+ */
 export type DependentsAmountFieldProps = HookFieldProps<NumberInputHookFieldProps<RequiredValidation>>;
+/**
+ * Currency-formatted number input bound to the `dependentsAmount` field of {@link useFederalTaxesForm} for the W-4 dependents total (Step 3).
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.DependentsAmount`. The field
+ * renders with `format="currency"` and `min={0}`. Empty values coerce to `0`
+ * and pass the required check.
+ *
+ * @param props - {@link DependentsAmountFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered currency-formatted number input bound to `dependentsAmount`.
+ * @public
+ */
 export declare function DependentsAmountField(props: DependentsAmountFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useFederalTaxesForm}'s `Fields.OtherIncome` component.
+ *
+ * @public
+ */
 export type OtherIncomeFieldProps = HookFieldProps<NumberInputHookFieldProps<RequiredValidation>>;
+/**
+ * Currency-formatted number input bound to the `otherIncome` field of {@link useFederalTaxesForm} for the W-4 other-income field (Step 4a).
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.OtherIncome`. The field
+ * renders with `format="currency"` and `min={0}`. Empty values coerce to `0`
+ * and pass the required check.
+ *
+ * @param props - {@link OtherIncomeFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered currency-formatted number input bound to `otherIncome`.
+ * @public
+ */
 export declare function OtherIncomeField(props: OtherIncomeFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useFederalTaxesForm}'s `Fields.Deductions` component.
+ *
+ * @public
+ */
 export type DeductionsFieldProps = HookFieldProps<NumberInputHookFieldProps<RequiredValidation>>;
+/**
+ * Currency-formatted number input bound to the `deductions` field of {@link useFederalTaxesForm} for the W-4 deductions field (Step 4b).
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.Deductions`. The field
+ * renders with `format="currency"` and `min={0}`. Empty values coerce to `0`
+ * and pass the required check.
+ *
+ * @param props - {@link DeductionsFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered currency-formatted number input bound to `deductions`.
+ * @public
+ */
 export declare function DeductionsField(props: DeductionsFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useFederalTaxesForm}'s `Fields.ExtraWithholding` component.
+ *
+ * @public
+ */
 export type ExtraWithholdingFieldProps = HookFieldProps<NumberInputHookFieldProps<RequiredValidation>>;
+/**
+ * Currency-formatted number input bound to the `extraWithholding` field of {@link useFederalTaxesForm} for the W-4 extra-withholding field (Step 4c).
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.ExtraWithholding`. The field
+ * renders with `format="currency"` and `min={0}`. Empty values coerce to `0`
+ * and pass the required check.
+ *
+ * @param props - {@link ExtraWithholdingFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered currency-formatted number input bound to `extraWithholding`.
+ * @public
+ */
 export declare function ExtraWithholdingField(props: ExtraWithholdingFieldProps): import("react").JSX.Element;

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

@@ -1,12 +1,12 @@
 import { jsx as e } from "react/jsx-runtime";
 import { NumberInputHookField as o } from "../../../../../partner-hook-utils/form/fields/NumberInputHookField.js";
-import { RadioGroupHookField as t } from "../../../../../partner-hook-utils/form/fields/RadioGroupHookField.js";
-import { SelectHookField as r } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
+import { SelectHookField as t } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
+import { RadioGroupHookField as r } from "../../../../../partner-hook-utils/form/fields/RadioGroupHookField.js";
 function d(n) {
-  return /* @__PURE__ */ e(r, { ...n, name: "filingStatus" });
+  return /* @__PURE__ */ e(t, { ...n, name: "filingStatus" });
 }
 function a(n) {
-  return /* @__PURE__ */ e(t, { ...n, name: "twoJobs" });
+  return /* @__PURE__ */ e(r, { ...n, name: "twoJobs" });
 }
 function f(n) {
   return /* @__PURE__ */ e(o, { ...n, name: "dependentsAmount", format: "currency", min: 0 });

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

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/FederalTaxes/shared/useFederalTaxesForm/fields.tsx"],"sourcesContent":["import type { FederalTaxesErrorCodes, FilingStatusValue } from './federalTaxesSchema'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport type { RadioGroupHookFieldProps } from '@/partner-hook-utils/form/fields/RadioGroupHookField'\nimport type { NumberInputHookFieldProps } from '@/partner-hook-utils/form/fields/NumberInputHookField'\nimport {\n  SelectHookField,\n  RadioGroupHookField,\n  NumberInputHookField,\n} from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\nexport type RequiredValidation = typeof FederalTaxesErrorCodes.REQUIRED\n\nexport type FilingStatusFieldProps = HookFieldProps<\n  SelectHookFieldProps<RequiredValidation, FilingStatusValue>\n>\n\nexport function FilingStatusField(props: FilingStatusFieldProps) {\n  return <SelectHookField {...props} name=\"filingStatus\" />\n}\n\nexport type TwoJobsFieldProps = HookFieldProps<\n  RadioGroupHookFieldProps<RequiredValidation, boolean>\n>\n\nexport function TwoJobsField(props: TwoJobsFieldProps) {\n  return <RadioGroupHookField {...props} name=\"twoJobs\" />\n}\n\nexport type DependentsAmountFieldProps = HookFieldProps<\n  NumberInputHookFieldProps<RequiredValidation>\n>\n\nexport function DependentsAmountField(props: DependentsAmountFieldProps) {\n  return <NumberInputHookField {...props} name=\"dependentsAmount\" format=\"currency\" min={0} />\n}\n\nexport type OtherIncomeFieldProps = HookFieldProps<NumberInputHookFieldProps<RequiredValidation>>\n\nexport function OtherIncomeField(props: OtherIncomeFieldProps) {\n  return <NumberInputHookField {...props} name=\"otherIncome\" format=\"currency\" min={0} />\n}\n\nexport type DeductionsFieldProps = HookFieldProps<NumberInputHookFieldProps<RequiredValidation>>\n\nexport function DeductionsField(props: DeductionsFieldProps) {\n  return <NumberInputHookField {...props} name=\"deductions\" format=\"currency\" min={0} />\n}\n\nexport type ExtraWithholdingFieldProps = HookFieldProps<\n  NumberInputHookFieldProps<RequiredValidation>\n>\n\nexport function ExtraWithholdingField(props: ExtraWithholdingFieldProps) {\n  return <NumberInputHookField {...props} name=\"extraWithholding\" format=\"currency\" min={0} />\n}\n"],"names":["FilingStatusField","props","jsx","SelectHookField","TwoJobsField","RadioGroupHookField","DependentsAmountField","NumberInputHookField","OtherIncomeField","DeductionsField","ExtraWithholdingField"],"mappings":";;;;AAiBO,SAASA,EAAkBC,GAA+B;AAC/D,SAAO,gBAAAC,EAACC,GAAA,EAAiB,GAAGF,GAAO,MAAK,gBAAe;AACzD;AAMO,SAASG,EAAaH,GAA0B;AACrD,SAAO,gBAAAC,EAACG,GAAA,EAAqB,GAAGJ,GAAO,MAAK,WAAU;AACxD;AAMO,SAASK,EAAsBL,GAAmC;AACvE,SAAO,gBAAAC,EAACK,KAAsB,GAAGN,GAAO,MAAK,oBAAmB,QAAO,YAAW,KAAK,EAAA,CAAG;AAC5F;AAIO,SAASO,EAAiBP,GAA8B;AAC7D,SAAO,gBAAAC,EAACK,KAAsB,GAAGN,GAAO,MAAK,eAAc,QAAO,YAAW,KAAK,EAAA,CAAG;AACvF;AAIO,SAASQ,EAAgBR,GAA6B;AAC3D,SAAO,gBAAAC,EAACK,KAAsB,GAAGN,GAAO,MAAK,cAAa,QAAO,YAAW,KAAK,EAAA,CAAG;AACtF;AAMO,SAASS,EAAsBT,GAAmC;AACvE,SAAO,gBAAAC,EAACK,KAAsB,GAAGN,GAAO,MAAK,oBAAmB,QAAO,YAAW,KAAK,EAAA,CAAG;AAC5F;"}
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/FederalTaxes/shared/useFederalTaxesForm/fields.tsx"],"sourcesContent":["import type { FederalTaxesErrorCodes, FilingStatusValue } from './federalTaxesSchema'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport type { RadioGroupHookFieldProps } from '@/partner-hook-utils/form/fields/RadioGroupHookField'\nimport type { NumberInputHookFieldProps } from '@/partner-hook-utils/form/fields/NumberInputHookField'\nimport {\n  SelectHookField,\n  RadioGroupHookField,\n  NumberInputHookField,\n} from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n/**\n * The required-field error code produced by {@link useFederalTaxesForm} fields.\n *\n * @remarks\n * Used as the `validationMessages` key for every federal taxes field. See\n * {@link FederalTaxesErrorCodes}.\n *\n * @public\n */\nexport type RequiredValidation = typeof FederalTaxesErrorCodes.REQUIRED\n\n/**\n * Props accepted by {@link useFederalTaxesForm}'s `Fields.FilingStatus` component.\n *\n * @public\n */\nexport type FilingStatusFieldProps = HookFieldProps<\n  SelectHookFieldProps<RequiredValidation, FilingStatusValue>\n>\n\n/**\n * Select bound to the `filingStatus` field of {@link useFederalTaxesForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.FilingStatus`. Options are\n * populated from `FILING_STATUS_VALUES` (`Single`, `Married`,\n * `Head of Household`, `Exempt from withholding`). The default option label is\n * the raw filing status value — pass `getOptionLabel` to localize.\n *\n * @param props - {@link FilingStatusFieldProps} — accepts the standard hook field props plus `getOptionLabel` for filing-status display.\n * @returns The rendered select bound to `filingStatus`.\n * @public\n */\nexport function FilingStatusField(props: FilingStatusFieldProps) {\n  return <SelectHookField {...props} name=\"filingStatus\" />\n}\n\n/**\n * Props accepted by {@link useFederalTaxesForm}'s `Fields.TwoJobs` component.\n *\n * @public\n */\nexport type TwoJobsFieldProps = HookFieldProps<\n  RadioGroupHookFieldProps<RequiredValidation, boolean>\n>\n\n/**\n * Radio group bound to the `twoJobs` field of {@link useFederalTaxesForm} for the W-4 multiple-jobs question (Step 2c).\n *\n * @remarks\n * Available on the hook result as `form.Fields.TwoJobs`. Two options for\n * `true` and `false`. The default labels are `Yes` and `No` — pass\n * `getOptionLabel` to localize. The form submits a boolean value.\n *\n * @param props - {@link TwoJobsFieldProps} — accepts the standard hook field props plus `getOptionLabel` for option display.\n * @returns The rendered radio group bound to `twoJobs`.\n * @public\n */\nexport function TwoJobsField(props: TwoJobsFieldProps) {\n  return <RadioGroupHookField {...props} name=\"twoJobs\" />\n}\n\n/**\n * Props accepted by {@link useFederalTaxesForm}'s `Fields.DependentsAmount` component.\n *\n * @public\n */\nexport type DependentsAmountFieldProps = HookFieldProps<\n  NumberInputHookFieldProps<RequiredValidation>\n>\n\n/**\n * Currency-formatted number input bound to the `dependentsAmount` field of {@link useFederalTaxesForm} for the W-4 dependents total (Step 3).\n *\n * @remarks\n * Available on the hook result as `form.Fields.DependentsAmount`. The field\n * renders with `format=\"currency\"` and `min={0}`. Empty values coerce to `0`\n * and pass the required check.\n *\n * @param props - {@link DependentsAmountFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered currency-formatted number input bound to `dependentsAmount`.\n * @public\n */\nexport function DependentsAmountField(props: DependentsAmountFieldProps) {\n  return <NumberInputHookField {...props} name=\"dependentsAmount\" format=\"currency\" min={0} />\n}\n\n/**\n * Props accepted by {@link useFederalTaxesForm}'s `Fields.OtherIncome` component.\n *\n * @public\n */\nexport type OtherIncomeFieldProps = HookFieldProps<NumberInputHookFieldProps<RequiredValidation>>\n\n/**\n * Currency-formatted number input bound to the `otherIncome` field of {@link useFederalTaxesForm} for the W-4 other-income field (Step 4a).\n *\n * @remarks\n * Available on the hook result as `form.Fields.OtherIncome`. The field\n * renders with `format=\"currency\"` and `min={0}`. Empty values coerce to `0`\n * and pass the required check.\n *\n * @param props - {@link OtherIncomeFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered currency-formatted number input bound to `otherIncome`.\n * @public\n */\nexport function OtherIncomeField(props: OtherIncomeFieldProps) {\n  return <NumberInputHookField {...props} name=\"otherIncome\" format=\"currency\" min={0} />\n}\n\n/**\n * Props accepted by {@link useFederalTaxesForm}'s `Fields.Deductions` component.\n *\n * @public\n */\nexport type DeductionsFieldProps = HookFieldProps<NumberInputHookFieldProps<RequiredValidation>>\n\n/**\n * Currency-formatted number input bound to the `deductions` field of {@link useFederalTaxesForm} for the W-4 deductions field (Step 4b).\n *\n * @remarks\n * Available on the hook result as `form.Fields.Deductions`. The field\n * renders with `format=\"currency\"` and `min={0}`. Empty values coerce to `0`\n * and pass the required check.\n *\n * @param props - {@link DeductionsFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered currency-formatted number input bound to `deductions`.\n * @public\n */\nexport function DeductionsField(props: DeductionsFieldProps) {\n  return <NumberInputHookField {...props} name=\"deductions\" format=\"currency\" min={0} />\n}\n\n/**\n * Props accepted by {@link useFederalTaxesForm}'s `Fields.ExtraWithholding` component.\n *\n * @public\n */\nexport type ExtraWithholdingFieldProps = HookFieldProps<\n  NumberInputHookFieldProps<RequiredValidation>\n>\n\n/**\n * Currency-formatted number input bound to the `extraWithholding` field of {@link useFederalTaxesForm} for the W-4 extra-withholding field (Step 4c).\n *\n * @remarks\n * Available on the hook result as `form.Fields.ExtraWithholding`. The field\n * renders with `format=\"currency\"` and `min={0}`. Empty values coerce to `0`\n * and pass the required check.\n *\n * @param props - {@link ExtraWithholdingFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered currency-formatted number input bound to `extraWithholding`.\n * @public\n */\nexport function ExtraWithholdingField(props: ExtraWithholdingFieldProps) {\n  return <NumberInputHookField {...props} name=\"extraWithholding\" format=\"currency\" min={0} />\n}\n"],"names":["FilingStatusField","props","jsx","SelectHookField","TwoJobsField","RadioGroupHookField","DependentsAmountField","NumberInputHookField","OtherIncomeField","DeductionsField","ExtraWithholdingField"],"mappings":";;;;AA4CO,SAASA,EAAkBC,GAA+B;AAC/D,SAAO,gBAAAC,EAACC,GAAA,EAAiB,GAAGF,GAAO,MAAK,gBAAe;AACzD;AAuBO,SAASG,EAAaH,GAA0B;AACrD,SAAO,gBAAAC,EAACG,GAAA,EAAqB,GAAGJ,GAAO,MAAK,WAAU;AACxD;AAuBO,SAASK,EAAsBL,GAAmC;AACvE,SAAO,gBAAAC,EAACK,KAAsB,GAAGN,GAAO,MAAK,oBAAmB,QAAO,YAAW,KAAK,EAAA,CAAG;AAC5F;AAqBO,SAASO,EAAiBP,GAA8B;AAC7D,SAAO,gBAAAC,EAACK,KAAsB,GAAGN,GAAO,MAAK,eAAc,QAAO,YAAW,KAAK,EAAA,CAAG;AACvF;AAqBO,SAASQ,EAAgBR,GAA6B;AAC3D,SAAO,gBAAAC,EAACK,KAAsB,GAAGN,GAAO,MAAK,cAAa,QAAO,YAAW,KAAK,EAAA,CAAG;AACtF;AAuBO,SAASS,EAAsBT,GAAmC;AACvE,SAAO,gBAAAC,EAACK,KAAsB,GAAGN,GAAO,MAAK,oBAAmB,QAAO,YAAW,KAAK,EAAA,CAAG;AAC5F;"}

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

@@ -2,4 +2,5 @@ import "./types/i18next.d.ts"
 export { useFederalTaxesForm } from './useFederalTaxesForm';
 export type { FederalTaxesOptionalFieldsToRequire, UseFederalTaxesFormProps, UseFederalTaxesFormResult, UseFederalTaxesFormReady, FederalTaxesFieldsMetadata, FederalTaxesFormFields, FederalTaxesFields, } from './useFederalTaxesForm';
 export { createFederalTaxesSchema, FederalTaxesErrorCodes, FILING_STATUS_VALUES, type FederalTaxesErrorCode, type FederalTaxesFormData, type FederalTaxesFormOutputs, type FederalTaxesField, type FilingStatusValue, } from './federalTaxesSchema';
+export { FilingStatusField, TwoJobsField, DependentsAmountField, OtherIncomeField, DeductionsField, ExtraWithholdingField, } from './fields';
 export type { RequiredValidation as FederalTaxesRequiredValidation, FilingStatusFieldProps, TwoJobsFieldProps, DependentsAmountFieldProps, OtherIncomeFieldProps, DeductionsFieldProps, ExtraWithholdingFieldProps, } from './fields';

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