@gusto/embedded-react-sdk 0.50.0 → 0.51.0

package/dist/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/fieldComponents.js

@@ -1,11 +1,11 @@
 import { jsx as i } from "react/jsx-runtime";
 import { useTranslation as r } from "react-i18next";
 import { EmployeeStateTaxesErrorCodes as c } from "./employeeStateTaxesSchema.js";
-import { TextInputHookField as d } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
-import { SelectHookField as m } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
+import { DatePickerHookField as d } from "../../../../../partner-hook-utils/form/fields/DatePickerHookField.js";
 import { NumberInputHookField as l } from "../../../../../partner-hook-utils/form/fields/NumberInputHookField.js";
-import { DatePickerHookField as u } from "../../../../../partner-hook-utils/form/fields/DatePickerHookField.js";
-import { RadioGroupHookField as f } from "../../../../../partner-hook-utils/form/fields/RadioGroupHookField.js";
+import { TextInputHookField as m } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
+import { RadioGroupHookField as u } from "../../../../../partner-hook-utils/form/fields/RadioGroupHookField.js";
+import { SelectHookField as f } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
 function F() {
   const { t: o } = r("Employee.StateTaxesView");
   return { [c.REQUIRED]: o("validations.required") };
@@ -26,21 +26,21 @@ function P({ meta: o, ...e }) {
     placeholder: e.placeholder ?? n("selectPlaceholder"),
     FieldComponent: e.FieldComponent
   };
-  return /* @__PURE__ */ i(m, { ...s });
+  return /* @__PURE__ */ i(f, { ...s });
 }
 function H({ meta: o, ...e }) {
   const t = {
     ...a(o, e),
     FieldComponent: e.FieldComponent
   };
-  return /* @__PURE__ */ i(f, { ...t });
+  return /* @__PURE__ */ i(u, { ...t });
 }
 function R({ meta: o, ...e }) {
   const t = {
     ...a(o, e),
     placeholder: e.placeholder
   };
-  return /* @__PURE__ */ i(d, { ...t });
+  return /* @__PURE__ */ i(m, { ...t });
 }
 function v({ meta: o, ...e }) {
   const t = {
@@ -63,7 +63,7 @@ function E({ meta: o, ...e }) {
     ...a(o, e),
     FieldComponent: e.FieldComponent
   };
-  return /* @__PURE__ */ i(u, { ...t });
+  return /* @__PURE__ */ i(d, { ...t });
 }
 export {
   D as CurrencyStateTaxField,

package/dist/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/fieldMapping.d.ts

@@ -1,4 +1,4 @@
-import { EmployeeStateTaxQuestion } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxquestion';
+import { EmployeeStateTaxQuestion } from '@gusto/embedded-api-v-2026-02-01/models/components/employeestatetaxquestion';
 /**
  * UI input variant for a state-tax question — determines which field type renders for a given question from the employee state-taxes API.
  *

package/dist/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/fieldMapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"fieldMapping.js","sources":["../../../../../../src/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/fieldMapping.ts"],"sourcesContent":["import type { EmployeeStateTaxQuestion } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxquestion'\n\n/**\n * UI input variant for a state-tax question — determines which field type renders for a given question from the employee state-taxes API.\n *\n * @public\n */\nexport type StateTaxQuestionVariant = 'select' | 'radio' | 'text' | 'number' | 'currency' | 'date'\n\n/**\n * Per-key mapping rules that promote API `Select`s to other variants for\n * UX reasons.\n *\n * `file_new_hire_report` is internally a Radio per the canonical Ruby\n * helper (`FileNewHireReportHelper.display_field_for_file_new_hire_report`),\n * but the converter at\n * `convert_employee_state_field_to_gws_flow_questions.rb` emits it as\n * `Select` because there's no Radio output type. The existing component at\n * `src/components/Employee/StateTaxes/StateForm.tsx` intends to override\n * `questionType` to `'Radio'` for this question but the comparison checks\n * `'fileNewHireReport'` (camelCase) against an API `key` of\n * `'file_new_hire_report'` (snake_case), so the override never fires today.\n *\n * This map fixes that bug and surfaces it as a Radio in the new hook.\n */\nconst SELECT_TO_RADIO_PROMOTION_KEYS = new Set<string>(['file_new_hire_report'])\n\n/** @internal */\nexport function getQuestionVariant(question: EmployeeStateTaxQuestion): StateTaxQuestionVariant {\n  if (SELECT_TO_RADIO_PROMOTION_KEYS.has(question.key)) {\n    return 'radio'\n  }\n\n  switch (question.inputQuestionFormat.type.toLowerCase()) {\n    case 'select':\n      return 'select'\n    case 'number':\n      return 'number'\n    case 'currency':\n      return 'currency'\n    case 'date':\n      return 'date'\n    case 'text':\n      return 'text'\n    default:\n      return 'text'\n  }\n}\n"],"names":["SELECT_TO_RADIO_PROMOTION_KEYS","getQuestionVariant","question"],"mappings":"AAyBA,MAAMA,IAAiC,oBAAI,IAAY,CAAC,sBAAsB,CAAC;AAGxE,SAASC,EAAmBC,GAA6D;AAC9F,MAAIF,EAA+B,IAAIE,EAAS,GAAG;AACjD,WAAO;AAGT,UAAQA,EAAS,oBAAoB,KAAK,YAAA,GAAY;AAAA,IACpD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EAAA;AAEb;"}
+{"version":3,"file":"fieldMapping.js","sources":["../../../../../../src/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/fieldMapping.ts"],"sourcesContent":["import type { EmployeeStateTaxQuestion } from '@gusto/embedded-api-v-2026-02-01/models/components/employeestatetaxquestion'\n\n/**\n * UI input variant for a state-tax question — determines which field type renders for a given question from the employee state-taxes API.\n *\n * @public\n */\nexport type StateTaxQuestionVariant = 'select' | 'radio' | 'text' | 'number' | 'currency' | 'date'\n\n/**\n * Per-key mapping rules that promote API `Select`s to other variants for\n * UX reasons.\n *\n * `file_new_hire_report` is internally a Radio per the canonical Ruby\n * helper (`FileNewHireReportHelper.display_field_for_file_new_hire_report`),\n * but the converter at\n * `convert_employee_state_field_to_gws_flow_questions.rb` emits it as\n * `Select` because there's no Radio output type. The existing component at\n * `src/components/Employee/StateTaxes/StateForm.tsx` intends to override\n * `questionType` to `'Radio'` for this question but the comparison checks\n * `'fileNewHireReport'` (camelCase) against an API `key` of\n * `'file_new_hire_report'` (snake_case), so the override never fires today.\n *\n * This map fixes that bug and surfaces it as a Radio in the new hook.\n */\nconst SELECT_TO_RADIO_PROMOTION_KEYS = new Set<string>(['file_new_hire_report'])\n\n/** @internal */\nexport function getQuestionVariant(question: EmployeeStateTaxQuestion): StateTaxQuestionVariant {\n  if (SELECT_TO_RADIO_PROMOTION_KEYS.has(question.key)) {\n    return 'radio'\n  }\n\n  switch (question.inputQuestionFormat.type.toLowerCase()) {\n    case 'select':\n      return 'select'\n    case 'number':\n      return 'number'\n    case 'currency':\n      return 'currency'\n    case 'date':\n      return 'date'\n    case 'text':\n      return 'text'\n    default:\n      return 'text'\n  }\n}\n"],"names":["SELECT_TO_RADIO_PROMOTION_KEYS","getQuestionVariant","question"],"mappings":"AAyBA,MAAMA,IAAiC,oBAAI,IAAY,CAAC,sBAAsB,CAAC;AAGxE,SAASC,EAAmBC,GAA6D;AAC9F,MAAIF,EAA+B,IAAIE,EAAS,GAAG;AACjD,WAAO;AAGT,UAAQA,EAAS,oBAAoB,KAAK,YAAA,GAAY;AAAA,IACpD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EAAA;AAEb;"}

package/dist/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/fields.d.ts

@@ -1,5 +1,5 @@
 import { ComponentType } from 'react';
-import { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxeslist';
+import { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2026-02-01/models/components/employeestatetaxeslist';
 import { CurrencyStateTaxFieldProps, DateStateTaxFieldProps, NumberStateTaxFieldProps, RadioStateTaxFieldProps, SelectStateTaxFieldProps, TextStateTaxFieldProps } from './fieldProps';
 export type { BaseStateTaxFieldProps, StateTaxValidationMessages, CurrencyStateTaxFieldProps, DateStateTaxFieldProps, NumberStateTaxFieldProps, RadioStateTaxFieldProps, SelectStateTaxFieldProps, TextStateTaxFieldProps, } from './fieldProps';
 /**
@@ -162,6 +162,6 @@ export declare function createStateFields(employeeStateTaxes: EmployeeStateTaxes
  * @param isAdmin - When `true`, admin-only questions are included; when `false`, they are filtered out.
  * @returns An array of {@link StateTaxFieldsGroup} — one entry per state, each with a `questions` array of bound field components.
  * @public
- * @group Utility Hooks
+ * @group Utility hooks
  */
 export declare function useStateFields(employeeStateTaxes: EmployeeStateTaxesList[], isAdmin: boolean): StateTaxFieldsGroup[];

package/dist/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/fields.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useMemo } from 'react'\nimport type { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxeslist'\nimport { getQuestionVariant, type StateTaxQuestionVariant } from './fieldMapping'\nimport {\n  CurrencyStateTaxField,\n  DateStateTaxField,\n  NumberStateTaxField,\n  RadioStateTaxField,\n  SelectStateTaxField,\n  TextStateTaxField,\n} from './fieldComponents'\nimport type { BoundFieldMeta } from './fieldMeta'\nimport type {\n  CurrencyStateTaxFieldProps,\n  DateStateTaxFieldProps,\n  NumberStateTaxFieldProps,\n  RadioStateTaxFieldProps,\n  SelectStateTaxFieldProps,\n  TextStateTaxFieldProps,\n} from './fieldProps'\nimport { snakeCaseToCamelCase } from '@/helpers/formattedStrings'\n\nexport type {\n  BaseStateTaxFieldProps,\n  StateTaxValidationMessages,\n  CurrencyStateTaxFieldProps,\n  DateStateTaxFieldProps,\n  NumberStateTaxFieldProps,\n  RadioStateTaxFieldProps,\n  SelectStateTaxFieldProps,\n  TextStateTaxFieldProps,\n} from './fieldProps'\n\n// ── Discriminated union surfaced to partners ───────────────────────────\n\n/**\n * Metadata shared by every {@link StateTaxQuestionFieldEntry} variant,\n * independent of which input the question renders.\n *\n * @public\n */\nexport interface SharedQuestionMetadata {\n  /** Stable identifier for this question (camelCase form of the API key). */\n  questionId: string\n  /** API-supplied label; default text for the rendered Field. */\n  label: string\n  /** API-supplied description (raw HTML, sanitized internally before render). */\n  description: string | null\n}\n\n/**\n * A state-tax question that renders as a select (dropdown). Includes read-only\n * question metadata from the API and a bound select field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface SelectStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the select variant. */\n  type: 'select'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<SelectStateTaxFieldProps>\n}\n\n/**\n * A state-tax question that renders as a radio group. Includes read-only\n * question metadata from the API and a bound radio field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface RadioStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the radio variant. */\n  type: 'radio'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<RadioStateTaxFieldProps>\n}\n\n/**\n * A state-tax question that renders as a single-line text input. Includes\n * read-only question metadata from the API and a bound text field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface TextStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the text variant. */\n  type: 'text'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<TextStateTaxFieldProps>\n}\n\n/**\n * A state-tax question that renders as a decimal number input. Includes\n * read-only question metadata from the API and a bound number field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface NumberStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the number variant. */\n  type: 'number'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<NumberStateTaxFieldProps>\n}\n\n/**\n * A state-tax question that renders as a currency-formatted number input. Includes\n * read-only question metadata from the API and a bound currency field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface CurrencyStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the currency variant. */\n  type: 'currency'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<CurrencyStateTaxFieldProps>\n}\n\n/**\n * A state-tax question that renders as a date picker. Includes read-only\n * question metadata from the API and a bound date field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface DateStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the date variant. */\n  type: 'date'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<DateStateTaxFieldProps>\n}\n\n/**\n * One question entry within a {@link StateTaxFieldsGroup}, discriminated by\n * `type` to identify which input variant the question uses. Each entry carries\n * a `Field` component pre-bound to its API-supplied metadata so callers can\n * render the input directly.\n *\n * @public\n * @group Fields\n * @groupWith {@link StateTaxFieldsGroup}\n */\nexport type StateTaxQuestionFieldEntry =\n  | SelectStateTaxQuestion\n  | RadioStateTaxQuestion\n  | TextStateTaxQuestion\n  | NumberStateTaxQuestion\n  | CurrencyStateTaxQuestion\n  | DateStateTaxQuestion\n\n/**\n * Group of state-tax questions for a single jurisdiction returned by\n * {@link useStateFields}.\n *\n * @public\n * @group Fields\n * @groupWith {@link StateTaxFields}\n */\nexport interface StateTaxFieldsGroup {\n  /** Two-letter state code. */\n  state: string\n  /** Ordered list of question entries for this state, post admin-only filtering. */\n  questions: StateTaxQuestionFieldEntry[]\n}\n\n/**\n * Iterable, render-ready group + question entries with bound Field components,\n * grouped by state.\n *\n * @public\n *\n * @example\n * The value exposed on `form.Fields`: one entry per state, each carrying its\n * questions as pre-bound `Field` components you render directly.\n *\n * ```tsx\n * function StateTaxQuestions({ fields }: { fields: StateTaxFields }) {\n *   return fields.map(group => (\n *     <section key={group.state}>\n *       <h3>{group.state}</h3>\n *       {group.questions.map(question => (\n *         <question.Field key={question.questionId} />\n *       ))}\n *     </section>\n *   ))\n * }\n * ```\n */\nexport type StateTaxFields = StateTaxFieldsGroup[]\n\n// ── Factory ────────────────────────────────────────────────────────────\n\n/** @internal */\nexport interface CreateStateFieldsOptions {\n  isAdmin: boolean\n}\n\n/** @internal */\nexport function createStateFields(\n  employeeStateTaxes: EmployeeStateTaxesList[],\n  options: CreateStateFieldsOptions,\n): StateTaxFieldsGroup[] {\n  const { isAdmin } = options\n  const groups: StateTaxFieldsGroup[] = []\n\n  for (const stateGroup of employeeStateTaxes) {\n    if (!stateGroup.state || !stateGroup.questions) continue\n\n    const questions: StateTaxQuestionFieldEntry[] = []\n    for (const question of stateGroup.questions) {\n      if (question.isQuestionForAdminOnly && !isAdmin) continue\n\n      const formKey = snakeCaseToCamelCase(question.key)\n      const meta: BoundFieldMeta = {\n        name: `states.${stateGroup.state}.${formKey}`,\n        apiLabel: question.label,\n        apiDescription: question.description,\n      }\n      const variant = getQuestionVariant(question)\n      const shared: SharedQuestionMetadata = {\n        questionId: formKey,\n        label: question.label,\n        description: question.description,\n      }\n\n      questions.push(buildEntry(variant, meta, shared))\n    }\n\n    if (questions.length === 0) continue\n\n    groups.push({\n      state: stateGroup.state,\n      questions,\n    })\n  }\n\n  return groups\n}\n\nfunction buildEntry(\n  variant: StateTaxQuestionVariant,\n  meta: BoundFieldMeta,\n  shared: SharedQuestionMetadata,\n): StateTaxQuestionFieldEntry {\n  switch (variant) {\n    case 'select':\n      return {\n        type: 'select',\n        Field: function BoundSelectStateTaxField(props: SelectStateTaxFieldProps) {\n          return <SelectStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n    case 'radio':\n      return {\n        type: 'radio',\n        Field: function BoundRadioStateTaxField(props: RadioStateTaxFieldProps) {\n          return <RadioStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n    case 'text':\n      return {\n        type: 'text',\n        Field: function BoundTextStateTaxField(props: TextStateTaxFieldProps) {\n          return <TextStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n    case 'number':\n      return {\n        type: 'number',\n        Field: function BoundNumberStateTaxField(props: NumberStateTaxFieldProps) {\n          return <NumberStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n    case 'currency':\n      return {\n        type: 'currency',\n        Field: function BoundCurrencyStateTaxField(props: CurrencyStateTaxFieldProps) {\n          return <CurrencyStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n    case 'date':\n      return {\n        type: 'date',\n        Field: function BoundDateStateTaxField(props: DateStateTaxFieldProps) {\n          return <DateStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n  }\n}\n\n/**\n * Memoizes the bound field components for a state-taxes form, avoiding unnecessary rebuilds when the data refetches but the underlying questions haven't changed.\n *\n * @param employeeStateTaxes - Array of state-tax groups returned by the employee state-taxes API.\n * @param isAdmin - When `true`, admin-only questions are included; when `false`, they are filtered out.\n * @returns An array of {@link StateTaxFieldsGroup} — one entry per state, each with a `questions` array of bound field components.\n * @public\n * @group Utility Hooks\n */\nexport function useStateFields(\n  employeeStateTaxes: EmployeeStateTaxesList[],\n  isAdmin: boolean,\n): StateTaxFieldsGroup[] {\n  return useMemo(\n    () => createStateFields(employeeStateTaxes, { isAdmin }),\n    [employeeStateTaxes, isAdmin],\n  )\n}\n"],"names":["createStateFields","employeeStateTaxes","options","isAdmin","groups","stateGroup","questions","question","formKey","snakeCaseToCamelCase","meta","variant","getQuestionVariant","shared","buildEntry","props","jsx","SelectStateTaxField","RadioStateTaxField","TextStateTaxField","NumberStateTaxField","CurrencyStateTaxField","DateStateTaxField","useStateFields","useMemo"],"mappings":";;;;;AA+MO,SAASA,EACdC,GACAC,GACuB;AACvB,QAAM,EAAE,SAAAC,MAAYD,GACdE,IAAgC,CAAA;AAEtC,aAAWC,KAAcJ,GAAoB;AAC3C,QAAI,CAACI,EAAW,SAAS,CAACA,EAAW,UAAW;AAEhD,UAAMC,IAA0C,CAAA;AAChD,eAAWC,KAAYF,EAAW,WAAW;AAC3C,UAAIE,EAAS,0BAA0B,CAACJ,EAAS;AAEjD,YAAMK,IAAUC,EAAqBF,EAAS,GAAG,GAC3CG,IAAuB;AAAA,QAC3B,MAAM,UAAUL,EAAW,KAAK,IAAIG,CAAO;AAAA,QAC3C,UAAUD,EAAS;AAAA,QACnB,gBAAgBA,EAAS;AAAA,MAAA,GAErBI,IAAUC,EAAmBL,CAAQ,GACrCM,IAAiC;AAAA,QACrC,YAAYL;AAAA,QACZ,OAAOD,EAAS;AAAA,QAChB,aAAaA,EAAS;AAAA,MAAA;AAGxB,MAAAD,EAAU,KAAKQ,EAAWH,GAASD,GAAMG,CAAM,CAAC;AAAA,IAClD;AAEA,IAAIP,EAAU,WAAW,KAEzBF,EAAO,KAAK;AAAA,MACV,OAAOC,EAAW;AAAA,MAClB,WAAAC;AAAA,IAAA,CACD;AAAA,EACH;AAEA,SAAOF;AACT;AAEA,SAASU,EACPH,GACAD,GACAG,GAC4B;AAC5B,UAAQF,GAAA;AAAA,IACN,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAkCI,GAAiC;AACxE,iBAAO,gBAAAC,EAACC,GAAA,EAAoB,MAAAP,GAAa,GAAGK,EAAA,CAAO;AAAA,QACrD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,IAEP,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAiCE,GAAgC;AACtE,iBAAO,gBAAAC,EAACE,GAAA,EAAmB,MAAAR,GAAa,GAAGK,EAAA,CAAO;AAAA,QACpD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,IAEP,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAgCE,GAA+B;AACpE,iBAAO,gBAAAC,EAACG,GAAA,EAAkB,MAAAT,GAAa,GAAGK,EAAA,CAAO;AAAA,QACnD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,IAEP,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAkCE,GAAiC;AACxE,iBAAO,gBAAAC,EAACI,GAAA,EAAoB,MAAAV,GAAa,GAAGK,EAAA,CAAO;AAAA,QACrD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,IAEP,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAoCE,GAAmC;AAC5E,iBAAO,gBAAAC,EAACK,GAAA,EAAsB,MAAAX,GAAa,GAAGK,EAAA,CAAO;AAAA,QACvD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,IAEP,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAgCE,GAA+B;AACpE,iBAAO,gBAAAC,EAACM,GAAA,EAAkB,MAAAZ,GAAa,GAAGK,EAAA,CAAO;AAAA,QACnD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,EACL;AAEN;AAWO,SAASU,EACdtB,GACAE,GACuB;AACvB,SAAOqB;AAAA,IACL,MAAMxB,EAAkBC,GAAoB,EAAE,SAAAE,GAAS;AAAA,IACvD,CAACF,GAAoBE,CAAO;AAAA,EAAA;AAEhC;"}
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/fields.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useMemo } from 'react'\nimport type { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2026-02-01/models/components/employeestatetaxeslist'\nimport { getQuestionVariant, type StateTaxQuestionVariant } from './fieldMapping'\nimport {\n  CurrencyStateTaxField,\n  DateStateTaxField,\n  NumberStateTaxField,\n  RadioStateTaxField,\n  SelectStateTaxField,\n  TextStateTaxField,\n} from './fieldComponents'\nimport type { BoundFieldMeta } from './fieldMeta'\nimport type {\n  CurrencyStateTaxFieldProps,\n  DateStateTaxFieldProps,\n  NumberStateTaxFieldProps,\n  RadioStateTaxFieldProps,\n  SelectStateTaxFieldProps,\n  TextStateTaxFieldProps,\n} from './fieldProps'\nimport { snakeCaseToCamelCase } from '@/helpers/formattedStrings'\n\nexport type {\n  BaseStateTaxFieldProps,\n  StateTaxValidationMessages,\n  CurrencyStateTaxFieldProps,\n  DateStateTaxFieldProps,\n  NumberStateTaxFieldProps,\n  RadioStateTaxFieldProps,\n  SelectStateTaxFieldProps,\n  TextStateTaxFieldProps,\n} from './fieldProps'\n\n// ── Discriminated union surfaced to partners ───────────────────────────\n\n/**\n * Metadata shared by every {@link StateTaxQuestionFieldEntry} variant,\n * independent of which input the question renders.\n *\n * @public\n */\nexport interface SharedQuestionMetadata {\n  /** Stable identifier for this question (camelCase form of the API key). */\n  questionId: string\n  /** API-supplied label; default text for the rendered Field. */\n  label: string\n  /** API-supplied description (raw HTML, sanitized internally before render). */\n  description: string | null\n}\n\n/**\n * A state-tax question that renders as a select (dropdown). Includes read-only\n * question metadata from the API and a bound select field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface SelectStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the select variant. */\n  type: 'select'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<SelectStateTaxFieldProps>\n}\n\n/**\n * A state-tax question that renders as a radio group. Includes read-only\n * question metadata from the API and a bound radio field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface RadioStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the radio variant. */\n  type: 'radio'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<RadioStateTaxFieldProps>\n}\n\n/**\n * A state-tax question that renders as a single-line text input. Includes\n * read-only question metadata from the API and a bound text field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface TextStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the text variant. */\n  type: 'text'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<TextStateTaxFieldProps>\n}\n\n/**\n * A state-tax question that renders as a decimal number input. Includes\n * read-only question metadata from the API and a bound number field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface NumberStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the number variant. */\n  type: 'number'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<NumberStateTaxFieldProps>\n}\n\n/**\n * A state-tax question that renders as a currency-formatted number input. Includes\n * read-only question metadata from the API and a bound currency field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface CurrencyStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the currency variant. */\n  type: 'currency'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<CurrencyStateTaxFieldProps>\n}\n\n/**\n * A state-tax question that renders as a date picker. Includes read-only\n * question metadata from the API and a bound date field, exposed as\n * `<question.Field />`.\n *\n * @public\n * @group Fields\n */\nexport interface DateStateTaxQuestion extends SharedQuestionMetadata {\n  /** Discriminant identifying the date variant. */\n  type: 'date'\n  /** Field component pre-bound to this question's API-supplied metadata. */\n  Field: ComponentType<DateStateTaxFieldProps>\n}\n\n/**\n * One question entry within a {@link StateTaxFieldsGroup}, discriminated by\n * `type` to identify which input variant the question uses. Each entry carries\n * a `Field` component pre-bound to its API-supplied metadata so callers can\n * render the input directly.\n *\n * @public\n * @group Fields\n * @groupWith {@link StateTaxFieldsGroup}\n */\nexport type StateTaxQuestionFieldEntry =\n  | SelectStateTaxQuestion\n  | RadioStateTaxQuestion\n  | TextStateTaxQuestion\n  | NumberStateTaxQuestion\n  | CurrencyStateTaxQuestion\n  | DateStateTaxQuestion\n\n/**\n * Group of state-tax questions for a single jurisdiction returned by\n * {@link useStateFields}.\n *\n * @public\n * @group Fields\n * @groupWith {@link StateTaxFields}\n */\nexport interface StateTaxFieldsGroup {\n  /** Two-letter state code. */\n  state: string\n  /** Ordered list of question entries for this state, post admin-only filtering. */\n  questions: StateTaxQuestionFieldEntry[]\n}\n\n/**\n * Iterable, render-ready group + question entries with bound Field components,\n * grouped by state.\n *\n * @public\n *\n * @example\n * The value exposed on `form.Fields`: one entry per state, each carrying its\n * questions as pre-bound `Field` components you render directly.\n *\n * ```tsx\n * function StateTaxQuestions({ fields }: { fields: StateTaxFields }) {\n *   return fields.map(group => (\n *     <section key={group.state}>\n *       <h3>{group.state}</h3>\n *       {group.questions.map(question => (\n *         <question.Field key={question.questionId} />\n *       ))}\n *     </section>\n *   ))\n * }\n * ```\n */\nexport type StateTaxFields = StateTaxFieldsGroup[]\n\n// ── Factory ────────────────────────────────────────────────────────────\n\n/** @internal */\nexport interface CreateStateFieldsOptions {\n  isAdmin: boolean\n}\n\n/** @internal */\nexport function createStateFields(\n  employeeStateTaxes: EmployeeStateTaxesList[],\n  options: CreateStateFieldsOptions,\n): StateTaxFieldsGroup[] {\n  const { isAdmin } = options\n  const groups: StateTaxFieldsGroup[] = []\n\n  for (const stateGroup of employeeStateTaxes) {\n    if (!stateGroup.state || !stateGroup.questions) continue\n\n    const questions: StateTaxQuestionFieldEntry[] = []\n    for (const question of stateGroup.questions) {\n      if (question.isQuestionForAdminOnly && !isAdmin) continue\n\n      const formKey = snakeCaseToCamelCase(question.key)\n      const meta: BoundFieldMeta = {\n        name: `states.${stateGroup.state}.${formKey}`,\n        apiLabel: question.label,\n        apiDescription: question.description,\n      }\n      const variant = getQuestionVariant(question)\n      const shared: SharedQuestionMetadata = {\n        questionId: formKey,\n        label: question.label,\n        description: question.description,\n      }\n\n      questions.push(buildEntry(variant, meta, shared))\n    }\n\n    if (questions.length === 0) continue\n\n    groups.push({\n      state: stateGroup.state,\n      questions,\n    })\n  }\n\n  return groups\n}\n\nfunction buildEntry(\n  variant: StateTaxQuestionVariant,\n  meta: BoundFieldMeta,\n  shared: SharedQuestionMetadata,\n): StateTaxQuestionFieldEntry {\n  switch (variant) {\n    case 'select':\n      return {\n        type: 'select',\n        Field: function BoundSelectStateTaxField(props: SelectStateTaxFieldProps) {\n          return <SelectStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n    case 'radio':\n      return {\n        type: 'radio',\n        Field: function BoundRadioStateTaxField(props: RadioStateTaxFieldProps) {\n          return <RadioStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n    case 'text':\n      return {\n        type: 'text',\n        Field: function BoundTextStateTaxField(props: TextStateTaxFieldProps) {\n          return <TextStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n    case 'number':\n      return {\n        type: 'number',\n        Field: function BoundNumberStateTaxField(props: NumberStateTaxFieldProps) {\n          return <NumberStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n    case 'currency':\n      return {\n        type: 'currency',\n        Field: function BoundCurrencyStateTaxField(props: CurrencyStateTaxFieldProps) {\n          return <CurrencyStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n    case 'date':\n      return {\n        type: 'date',\n        Field: function BoundDateStateTaxField(props: DateStateTaxFieldProps) {\n          return <DateStateTaxField meta={meta} {...props} />\n        },\n        ...shared,\n      }\n  }\n}\n\n/**\n * Memoizes the bound field components for a state-taxes form, avoiding unnecessary rebuilds when the data refetches but the underlying questions haven't changed.\n *\n * @param employeeStateTaxes - Array of state-tax groups returned by the employee state-taxes API.\n * @param isAdmin - When `true`, admin-only questions are included; when `false`, they are filtered out.\n * @returns An array of {@link StateTaxFieldsGroup} — one entry per state, each with a `questions` array of bound field components.\n * @public\n * @group Utility hooks\n */\nexport function useStateFields(\n  employeeStateTaxes: EmployeeStateTaxesList[],\n  isAdmin: boolean,\n): StateTaxFieldsGroup[] {\n  return useMemo(\n    () => createStateFields(employeeStateTaxes, { isAdmin }),\n    [employeeStateTaxes, isAdmin],\n  )\n}\n"],"names":["createStateFields","employeeStateTaxes","options","isAdmin","groups","stateGroup","questions","question","formKey","snakeCaseToCamelCase","meta","variant","getQuestionVariant","shared","buildEntry","props","jsx","SelectStateTaxField","RadioStateTaxField","TextStateTaxField","NumberStateTaxField","CurrencyStateTaxField","DateStateTaxField","useStateFields","useMemo"],"mappings":";;;;;AA+MO,SAASA,EACdC,GACAC,GACuB;AACvB,QAAM,EAAE,SAAAC,MAAYD,GACdE,IAAgC,CAAA;AAEtC,aAAWC,KAAcJ,GAAoB;AAC3C,QAAI,CAACI,EAAW,SAAS,CAACA,EAAW,UAAW;AAEhD,UAAMC,IAA0C,CAAA;AAChD,eAAWC,KAAYF,EAAW,WAAW;AAC3C,UAAIE,EAAS,0BAA0B,CAACJ,EAAS;AAEjD,YAAMK,IAAUC,EAAqBF,EAAS,GAAG,GAC3CG,IAAuB;AAAA,QAC3B,MAAM,UAAUL,EAAW,KAAK,IAAIG,CAAO;AAAA,QAC3C,UAAUD,EAAS;AAAA,QACnB,gBAAgBA,EAAS;AAAA,MAAA,GAErBI,IAAUC,EAAmBL,CAAQ,GACrCM,IAAiC;AAAA,QACrC,YAAYL;AAAA,QACZ,OAAOD,EAAS;AAAA,QAChB,aAAaA,EAAS;AAAA,MAAA;AAGxB,MAAAD,EAAU,KAAKQ,EAAWH,GAASD,GAAMG,CAAM,CAAC;AAAA,IAClD;AAEA,IAAIP,EAAU,WAAW,KAEzBF,EAAO,KAAK;AAAA,MACV,OAAOC,EAAW;AAAA,MAClB,WAAAC;AAAA,IAAA,CACD;AAAA,EACH;AAEA,SAAOF;AACT;AAEA,SAASU,EACPH,GACAD,GACAG,GAC4B;AAC5B,UAAQF,GAAA;AAAA,IACN,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAkCI,GAAiC;AACxE,iBAAO,gBAAAC,EAACC,GAAA,EAAoB,MAAAP,GAAa,GAAGK,EAAA,CAAO;AAAA,QACrD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,IAEP,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAiCE,GAAgC;AACtE,iBAAO,gBAAAC,EAACE,GAAA,EAAmB,MAAAR,GAAa,GAAGK,EAAA,CAAO;AAAA,QACpD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,IAEP,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAgCE,GAA+B;AACpE,iBAAO,gBAAAC,EAACG,GAAA,EAAkB,MAAAT,GAAa,GAAGK,EAAA,CAAO;AAAA,QACnD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,IAEP,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAkCE,GAAiC;AACxE,iBAAO,gBAAAC,EAACI,GAAA,EAAoB,MAAAV,GAAa,GAAGK,EAAA,CAAO;AAAA,QACrD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,IAEP,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAoCE,GAAmC;AAC5E,iBAAO,gBAAAC,EAACK,GAAA,EAAsB,MAAAX,GAAa,GAAGK,EAAA,CAAO;AAAA,QACvD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,IAEP,KAAK;AACH,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,SAAgCE,GAA+B;AACpE,iBAAO,gBAAAC,EAACM,GAAA,EAAkB,MAAAZ,GAAa,GAAGK,EAAA,CAAO;AAAA,QACnD;AAAA,QACA,GAAGF;AAAA,MAAA;AAAA,EACL;AAEN;AAWO,SAASU,EACdtB,GACAE,GACuB;AACvB,SAAOqB;AAAA,IACL,MAAMxB,EAAkBC,GAAoB,EAAE,SAAAE,GAAS;AAAA,IACvD,CAACF,GAAoBE,CAAO;AAAA,EAAA;AAEhC;"}

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

@@ -1,6 +1,5 @@
-import "./types/i18next.d.ts"
 export { useEmployeeStateTaxesForm } from './useEmployeeStateTaxesForm';
 export type { UseEmployeeStateTaxesFormProps, UseEmployeeStateTaxesFormResult, UseEmployeeStateTaxesFormReady, EmployeeStateTaxesFieldsMetadata, EmployeeStateTaxesFormFields, } from './useEmployeeStateTaxesForm';
-export { createEmployeeStateTaxesSchema, EmployeeStateTaxesErrorCodes, type EmployeeStateTaxesErrorCode, type EmployeeStateTaxesFormData, type EmployeeStateTaxesFormOutputs, type EmployeeStateTaxesSchemaOptions, type EmployeeStateTaxesQuestionMeta, type EmployeeStateTaxesMetadataConfig, type StateTaxValue, } from './employeeStateTaxesSchema';
+export { createEmployeeStateTaxesSchema, EmployeeStateTaxesErrorCodes, type EmployeeStateTaxesErrorCode, type EmployeeStateTaxesFormData, type EmployeeStateTaxesSchemaOptions, type EmployeeStateTaxesQuestionMeta, type EmployeeStateTaxesMetadataConfig, type StateTaxValue, } from './employeeStateTaxesSchema';
 export { createStateFields, useStateFields, type CreateStateFieldsOptions, type StateTaxFields, type StateTaxFieldsGroup, type StateTaxQuestionFieldEntry, type SharedQuestionMetadata, type SelectStateTaxQuestion, type RadioStateTaxQuestion, type TextStateTaxQuestion, type NumberStateTaxQuestion, type CurrencyStateTaxQuestion, type DateStateTaxQuestion, type BaseStateTaxFieldProps, type StateTaxValidationMessages, type SelectStateTaxFieldProps, type RadioStateTaxFieldProps, type TextStateTaxFieldProps, type NumberStateTaxFieldProps, type CurrencyStateTaxFieldProps, type DateStateTaxFieldProps, } from './fields';
 export { getQuestionVariant, type StateTaxQuestionVariant } from './fieldMapping';

package/dist/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/useEmployeeStateTaxesForm.d.ts

@@ -1,8 +1,8 @@
 import { UseFormProps } from 'react-hook-form';
-import { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxeslist';
+import { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2026-02-01/models/components/employeestatetaxeslist';
 import { EmployeeStateTaxesFormData } from './employeeStateTaxesSchema';
 import { StateTaxFields } from './fields';
-import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+import { BaseFormHookReady, FieldMetadata, FieldMetadataWithOptions, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
 /**
  * Options accepted by {@link useEmployeeStateTaxesForm}.
  *
@@ -28,7 +28,7 @@ export interface UseEmployeeStateTaxesFormProps {
  *
  * @public
  */
-export interface UseEmployeeStateTaxesFormReady extends BaseFormHookReady<FieldsMetadata, EmployeeStateTaxesFormData, StateTaxFields> {
+export interface UseEmployeeStateTaxesFormReady extends BaseFormHookReady<EmployeeStateTaxesFieldsMetadata, EmployeeStateTaxesFormData, StateTaxFields> {
     /** Current per-state tax records returned by the server. */
     data: {
         employeeStateTaxes: EmployeeStateTaxesList[];
@@ -122,12 +122,19 @@ export type UseEmployeeStateTaxesFormResult = HookLoadingResult | UseEmployeeSta
  */
 export declare function useEmployeeStateTaxesForm({ employeeId, isAdmin, validationMode, shouldFocusError, }: UseEmployeeStateTaxesFormProps): UseEmployeeStateTaxesFormResult;
 /**
- * Static field metadata keyed by full form path (`states.<STATE>.<camelKey>`),
- * with `isRequired` / `isDisabled` and option lists.
+ * Field metadata for {@link useEmployeeStateTaxesForm}, keyed by full form path.
+ *
+ * @remarks
+ * The set of keys is determined at runtime: one entry per state tax question,
+ * keyed as `states.<STATE>.<camelCaseQuestionKey>`. Each entry is a
+ * {@link FieldMetadata}, or a {@link FieldMetadataWithOptions} for questions the
+ * API exposes as a select or radio. Both the questions and their options are
+ * driven by the API response per state, so neither the keys nor which entries
+ * carry options are known ahead of time.
  *
  * @public
  */
-export type EmployeeStateTaxesFieldsMetadata = UseEmployeeStateTaxesFormReady['form']['fieldsMetadata'];
+export type EmployeeStateTaxesFieldsMetadata = Record<`states.${string}.${string}`, FieldMetadata | FieldMetadataWithOptions>;
 /**
  * The array of per-state field groups exposed by
  * {@link useEmployeeStateTaxesForm} on `form.Fields`.

package/dist/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/useEmployeeStateTaxesForm.js

@@ -1,8 +1,8 @@
 import { useMemo as l } from "react";
 import { useForm as D } from "react-hook-form";
 import { zodResolver as L } from "@hookform/resolvers/zod";
-import { useEmployeeTaxSetupGetStateTaxes as O } from "@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupGetStateTaxes";
-import { useEmployeeTaxSetupUpdateStateTaxesMutation as M } from "@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupUpdateStateTaxes";
+import { useEmployeeTaxSetupGetStateTaxes as O } from "@gusto/embedded-api-v-2026-02-01/react-query/employeeTaxSetupGetStateTaxes";
+import { useEmployeeTaxSetupUpdateStateTaxesMutation as M } from "@gusto/embedded-api-v-2026-02-01/react-query/employeeTaxSetupUpdateStateTaxes";
 import { createEmployeeStateTaxesSchema as U } from "./employeeStateTaxesSchema.js";
 import { createStateFields as _ } from "./fields.js";
 import { getQuestionVariant as Q } from "./fieldMapping.js";
@@ -46,10 +46,7 @@ function ue({
   } = P("EmployeeStateTaxesForm"), c = I([s], {
     submitError: F,
     setSubmitError: g
-  }), N = z(
-    d,
-    a.control
-  ), h = async () => {
+  }), N = z(d, a.control), h = async () => {
     let f;
     return await new Promise((p) => {
       a.handleSubmit(

package/dist/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/useEmployeeStateTaxesForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useEmployeeStateTaxesForm.js","sources":["../../../../../../src/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/useEmployeeStateTaxesForm.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 { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxeslist'\nimport type {\n  EmployeeStateTaxesRequest,\n  States as EmployeeStateTaxesRequestState,\n} from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxesrequest'\nimport { useEmployeeTaxSetupGetStateTaxes } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupGetStateTaxes'\nimport { useEmployeeTaxSetupUpdateStateTaxesMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupUpdateStateTaxes'\nimport {\n  createEmployeeStateTaxesSchema,\n  type EmployeeStateTaxesFormData,\n  type EmployeeStateTaxesFormOutputs,\n  type EmployeeStateTaxesMetadataConfig,\n} from './employeeStateTaxesSchema'\nimport type { StateTaxFields } from './fields'\nimport { createStateFields } from './fields'\nimport { getQuestionVariant } from './fieldMapping'\nimport { snakeCaseToCamelCase } from '@/helpers/formattedStrings'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\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\nconst DEFAULT_TAX_VALID_FROM = '2010-01-01'\n\n/**\n * Options accepted by {@link useEmployeeStateTaxesForm}.\n *\n * @public\n */\nexport interface UseEmployeeStateTaxesFormProps {\n  /** The UUID of the employee whose state taxes are being updated. */\n  employeeId: string\n  /**\n   * When `true`, admin-only questions are visible and submitted. When\n   * `false`, they are filtered out and the surfaced answer for those\n   * questions is preserved unchanged on submit.\n   */\n  isAdmin?: boolean\n  /** When validation runs. Passed through to react-hook-form. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Auto-focus the first invalid field on submit. Defaults to `true`. Set to `false` when composing with other forms. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Ready-state return value of {@link useEmployeeStateTaxesForm} — the\n * `isLoading: false` branch of {@link UseEmployeeStateTaxesFormResult}.\n *\n * @public\n */\nexport interface UseEmployeeStateTaxesFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  EmployeeStateTaxesFormData,\n  StateTaxFields\n> {\n  /** Current per-state tax records returned by the server. */\n  data: {\n    employeeStateTaxes: EmployeeStateTaxesList[]\n  }\n  /** Submission status. `mode` is always `'update'` since state-tax records are created with the employee. */\n  status: { isPending: boolean; mode: 'update' }\n  /** Form actions. */\n  actions: {\n    /** Validates and submits the form, resolving to the updated records on success or `undefined` when validation blocked the submit. */\n    onSubmit: () => Promise<HookSubmitResult<EmployeeStateTaxesList[]> | undefined>\n  }\n}\n\n/**\n * Discriminated union returned by {@link useEmployeeStateTaxesForm}. Loading\n * branch carries only `errorHandling`; ready branch carries form data,\n * fields, status, and actions.\n *\n * @public\n */\nexport type UseEmployeeStateTaxesFormResult = HookLoadingResult | UseEmployeeStateTaxesFormReady\n\n/**\n * Headless form hook for updating an employee's state tax withholding answers.\n * The set of questions is driven by the API response per state, so\n * `form.Fields` is an array of state groups with discriminated, render-ready\n * `Field` components rather than a fixed named object.\n *\n * @remarks\n * The state-tax record(s) are created automatically with the employee, so this\n * hook is always in update mode. When the form has no states with submittable\n * answers (e.g. an employee in a no-income-tax state), submit resolves with\n * the existing record list without making a network request.\n *\n * @param props - Hook options.\n * @returns A loading result while data is fetching, or a ready result with\n * form data, fields, status, actions, and error handling.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useEmployeeStateTaxesForm,\n *   SDKFormProvider,\n *   type UseEmployeeStateTaxesFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function StateTaxesPage({ employeeId }: { employeeId: string }) {\n *   const stateTaxes = useEmployeeStateTaxesForm({ employeeId })\n *\n *   if (stateTaxes.isLoading) return <div>Loading...</div>\n *\n *   return <StateTaxesFormReady stateTaxes={stateTaxes} />\n * }\n *\n * function StateTaxesFormReady({\n *   stateTaxes,\n * }: {\n *   stateTaxes: UseEmployeeStateTaxesFormReady\n * }) {\n *   const handleSubmit = async () => {\n *     const result = await stateTaxes.actions.onSubmit()\n *     if (result) console.log('Updated state tax records:', result.data)\n *   }\n *\n *   return (\n *     <SDKFormProvider formHookResult={stateTaxes}>\n *       <form\n *         onSubmit={e => {\n *           e.preventDefault()\n *           void handleSubmit()\n *         }}\n *       >\n *         {stateTaxes.form.Fields.map(group => (\n *           <section key={group.state}>\n *             <h2>{group.state}</h2>\n *             {group.questions.map(question => (\n *               <question.Field key={question.questionId} />\n *             ))}\n *           </section>\n *         ))}\n *         <button type=\"submit\" disabled={stateTaxes.status.isPending}>\n *           Save\n *         </button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useEmployeeStateTaxesForm({\n  employeeId,\n  isAdmin = false,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseEmployeeStateTaxesFormProps): UseEmployeeStateTaxesFormResult {\n  const stateTaxesQuery = useEmployeeTaxSetupGetStateTaxes({ employeeUuid: employeeId })\n\n  const employeeStateTaxes = useMemo<EmployeeStateTaxesList[]>(\n    () => stateTaxesQuery.data?.employeeStateTaxesList ?? [],\n    [stateTaxesQuery.data?.employeeStateTaxesList],\n  )\n\n  const [schema, metadataConfig] = useMemo(\n    () => createEmployeeStateTaxesSchema(employeeStateTaxes, { isAdmin }),\n    [employeeStateTaxes, isAdmin],\n  )\n\n  const fieldsArray = useMemo(\n    () => createStateFields(employeeStateTaxes, { isAdmin }),\n    [employeeStateTaxes, isAdmin],\n  )\n\n  const resolvedDefaults = useMemo(\n    () => deriveDefaultValues(employeeStateTaxes, isAdmin),\n    [employeeStateTaxes, isAdmin],\n  )\n\n  const formMethods = useForm<EmployeeStateTaxesFormData, unknown, EmployeeStateTaxesFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const { mutateAsync: updateStateTaxes, isPending } = useEmployeeTaxSetupUpdateStateTaxesMutation()\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('EmployeeStateTaxesForm')\n\n  const errorHandling = composeErrorHandler([stateTaxesQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const fieldsMetadata = useDeriveFieldsMetadata(\n    metadataConfig as EmployeeStateTaxesMetadataConfig,\n    formMethods.control,\n  ) as FieldsMetadata\n\n  const onSubmit = async (): Promise<HookSubmitResult<EmployeeStateTaxesList[]> | undefined> => {\n    let submitResult: HookSubmitResult<EmployeeStateTaxesList[]> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async data => {\n          await baseSubmitHandler(data, async payload => {\n            const requestStates = serializeStatesPayload(payload, employeeStateTaxes, isAdmin)\n\n            if (requestStates.length === 0) {\n              submitResult = { mode: 'update', data: employeeStateTaxes }\n              return\n            }\n\n            const requestBody: EmployeeStateTaxesRequest = { states: requestStates }\n            const response = await updateStateTaxes({\n              request: { employeeUuid: employeeId, employeeStateTaxesRequest: requestBody },\n            })\n\n            const updated = response.employeeStateTaxesList\n            if (!updated) {\n              throw new SDKInternalError('State taxes update did not return an updated record')\n            }\n\n            submitResult = { mode: 'update', data: updated }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (stateTaxesQuery.isLoading || !stateTaxesQuery.data?.employeeStateTaxesList) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: { employeeStateTaxes },\n    status: { isPending, mode: 'update' as const },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: fieldsArray,\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema) as () =>\n        Record<string, unknown> | undefined,\n    },\n  }\n}\n\n// ── Defaults derivation ────────────────────────────────────────────────\n\nfunction deriveDefaultValues(\n  employeeStateTaxes: EmployeeStateTaxesList[],\n  isAdmin: boolean,\n): EmployeeStateTaxesFormData {\n  const states: Record<string, Record<string, unknown>> = {}\n\n  for (const stateGroup of employeeStateTaxes) {\n    if (!stateGroup.state || !stateGroup.questions) continue\n\n    const stateValues: Record<string, unknown> = {}\n    for (const question of stateGroup.questions) {\n      if (question.isQuestionForAdminOnly && !isAdmin) continue\n      const formKey = snakeCaseToCamelCase(question.key)\n      const wireValue = question.answers[0]?.value\n      stateValues[formKey] = resolveDefaultForQuestion(question, wireValue)\n    }\n\n    if (Object.keys(stateValues).length > 0) {\n      states[stateGroup.state] = stateValues\n    }\n  }\n\n  return { states: states as EmployeeStateTaxesFormData['states'] }\n}\n\nfunction resolveDefaultForQuestion(\n  question: EmployeeStateTaxesList['questions'] extends Array<infer Q> | undefined ? Q : never,\n  wireValue: string | number | boolean | null | undefined,\n): unknown {\n  if (question.key === 'file_new_hire_report') {\n    if (wireValue === undefined || wireValue === null) return true\n    return wireValue\n  }\n\n  const variant = getQuestionVariant(question)\n\n  switch (variant) {\n    case 'date': {\n      if (wireValue === undefined || wireValue === null || wireValue === '') return undefined\n      if (typeof wireValue === 'string') {\n        const trimmed = wireValue.trim()\n        if (trimmed === '') return undefined\n        const parsed = new Date(trimmed)\n        return Number.isNaN(parsed.getTime()) ? undefined : parsed\n      }\n      return wireValue\n    }\n    case 'number':\n    case 'currency': {\n      if (wireValue === undefined || wireValue === null || wireValue === '') return undefined\n      const parsed = typeof wireValue === 'number' ? wireValue : Number(wireValue)\n      return Number.isNaN(parsed) ? undefined : parsed\n    }\n    default:\n      return wireValue\n  }\n}\n\n// ── Submit serialization ───────────────────────────────────────────────\n\ntype SerializedQuestion = {\n  key: string\n  answers: Array<{\n    validFrom: string\n    validUpTo: string | null\n    value: string | number | boolean\n  }>\n}\n\nfunction serializeStatesPayload(\n  payload: EmployeeStateTaxesFormOutputs,\n  employeeStateTaxes: EmployeeStateTaxesList[],\n  isAdmin: boolean,\n): EmployeeStateTaxesRequestState[] {\n  const { states: statesPayload } = payload\n  if (Object.keys(statesPayload).length === 0) return []\n\n  const result: EmployeeStateTaxesRequestState[] = []\n\n  for (const state of employeeStateTaxes) {\n    const stateName = state.state\n    if (!stateName || state.questions === undefined) continue\n\n    const serialized: SerializedQuestion[] = []\n    for (const question of state.questions) {\n      if (question.isQuestionForAdminOnly && !isAdmin) continue\n\n      const formValue = (statesPayload[stateName] as Record<string, unknown> | undefined)?.[\n        snakeCaseToCamelCase(question.key)\n      ]\n\n      let serializedValue: string | number | boolean\n      if (formValue === undefined || formValue === null) {\n        serializedValue = ''\n      } else if (typeof formValue === 'number' && Number.isNaN(formValue)) {\n        serializedValue = ''\n      } else if (formValue instanceof Date) {\n        if (Number.isNaN(formValue.getTime())) {\n          serializedValue = ''\n        } else {\n          serializedValue = formValue.toISOString().split('T')[0] ?? ''\n        }\n      } else {\n        serializedValue = formValue as string | number | boolean\n      }\n\n      serialized.push({\n        key: question.key,\n        answers: [\n          {\n            validFrom: question.answers[0]?.validFrom ?? DEFAULT_TAX_VALID_FROM,\n            validUpTo: question.answers[0]?.validUpTo ?? null,\n            value: serializedValue,\n          },\n        ],\n      })\n    }\n\n    result.push({ state: stateName, questions: serialized })\n  }\n\n  return result\n}\n\n/**\n * Static field metadata keyed by full form path (`states.<STATE>.<camelKey>`),\n * with `isRequired` / `isDisabled` and option lists.\n *\n * @public\n */\nexport type EmployeeStateTaxesFieldsMetadata =\n  UseEmployeeStateTaxesFormReady['form']['fieldsMetadata']\n\n/**\n * The array of per-state field groups exposed by\n * {@link useEmployeeStateTaxesForm} on `form.Fields`.\n *\n * @public\n */\nexport type EmployeeStateTaxesFormFields = UseEmployeeStateTaxesFormReady['form']['Fields']\n"],"names":["DEFAULT_TAX_VALID_FROM","useEmployeeStateTaxesForm","employeeId","isAdmin","validationMode","shouldFocusError","stateTaxesQuery","useEmployeeTaxSetupGetStateTaxes","employeeStateTaxes","useMemo","schema","metadataConfig","createEmployeeStateTaxesSchema","fieldsArray","createStateFields","resolvedDefaults","deriveDefaultValues","formMethods","useForm","zodResolver","updateStateTaxes","isPending","useEmployeeTaxSetupUpdateStateTaxesMutation","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","fieldsMetadata","useDeriveFieldsMetadata","onSubmit","submitResult","resolve","data","payload","requestStates","serializeStatesPayload","updated","SDKInternalError","hookFormInternals","useHookFormInternals","createGetFormSubmissionValues","states","stateGroup","stateValues","question","formKey","snakeCaseToCamelCase","wireValue","resolveDefaultForQuestion","getQuestionVariant","trimmed","parsed","statesPayload","result","state","stateName","serialized","formValue","serializedValue"],"mappings":"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"}
+{"version":3,"file":"useEmployeeStateTaxesForm.js","sources":["../../../../../../src/components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/useEmployeeStateTaxesForm.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 { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2026-02-01/models/components/employeestatetaxeslist'\nimport type {\n  EmployeeStateTaxesRequest,\n  States as EmployeeStateTaxesRequestState,\n} from '@gusto/embedded-api-v-2026-02-01/models/components/employeestatetaxesrequest'\nimport { useEmployeeTaxSetupGetStateTaxes } from '@gusto/embedded-api-v-2026-02-01/react-query/employeeTaxSetupGetStateTaxes'\nimport { useEmployeeTaxSetupUpdateStateTaxesMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/employeeTaxSetupUpdateStateTaxes'\nimport {\n  createEmployeeStateTaxesSchema,\n  type EmployeeStateTaxesFormData,\n  type EmployeeStateTaxesFormOutputs,\n} from './employeeStateTaxesSchema'\nimport type { StateTaxFields } from './fields'\nimport { createStateFields } from './fields'\nimport { getQuestionVariant } from './fieldMapping'\nimport { snakeCaseToCamelCase } from '@/helpers/formattedStrings'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldMetadata,\n  FieldMetadataWithOptions,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\n\nconst DEFAULT_TAX_VALID_FROM = '2010-01-01'\n\n/**\n * Options accepted by {@link useEmployeeStateTaxesForm}.\n *\n * @public\n */\nexport interface UseEmployeeStateTaxesFormProps {\n  /** The UUID of the employee whose state taxes are being updated. */\n  employeeId: string\n  /**\n   * When `true`, admin-only questions are visible and submitted. When\n   * `false`, they are filtered out and the surfaced answer for those\n   * questions is preserved unchanged on submit.\n   */\n  isAdmin?: boolean\n  /** When validation runs. Passed through to react-hook-form. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Auto-focus the first invalid field on submit. Defaults to `true`. Set to `false` when composing with other forms. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Ready-state return value of {@link useEmployeeStateTaxesForm} — the\n * `isLoading: false` branch of {@link UseEmployeeStateTaxesFormResult}.\n *\n * @public\n */\nexport interface UseEmployeeStateTaxesFormReady extends BaseFormHookReady<\n  EmployeeStateTaxesFieldsMetadata,\n  EmployeeStateTaxesFormData,\n  StateTaxFields\n> {\n  /** Current per-state tax records returned by the server. */\n  data: {\n    employeeStateTaxes: EmployeeStateTaxesList[]\n  }\n  /** Submission status. `mode` is always `'update'` since state-tax records are created with the employee. */\n  status: { isPending: boolean; mode: 'update' }\n  /** Form actions. */\n  actions: {\n    /** Validates and submits the form, resolving to the updated records on success or `undefined` when validation blocked the submit. */\n    onSubmit: () => Promise<HookSubmitResult<EmployeeStateTaxesList[]> | undefined>\n  }\n}\n\n/**\n * Discriminated union returned by {@link useEmployeeStateTaxesForm}. Loading\n * branch carries only `errorHandling`; ready branch carries form data,\n * fields, status, and actions.\n *\n * @public\n */\nexport type UseEmployeeStateTaxesFormResult = HookLoadingResult | UseEmployeeStateTaxesFormReady\n\n/**\n * Headless form hook for updating an employee's state tax withholding answers.\n * The set of questions is driven by the API response per state, so\n * `form.Fields` is an array of state groups with discriminated, render-ready\n * `Field` components rather than a fixed named object.\n *\n * @remarks\n * The state-tax record(s) are created automatically with the employee, so this\n * hook is always in update mode. When the form has no states with submittable\n * answers (e.g. an employee in a no-income-tax state), submit resolves with\n * the existing record list without making a network request.\n *\n * @param props - Hook options.\n * @returns A loading result while data is fetching, or a ready result with\n * form data, fields, status, actions, and error handling.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useEmployeeStateTaxesForm,\n *   SDKFormProvider,\n *   type UseEmployeeStateTaxesFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function StateTaxesPage({ employeeId }: { employeeId: string }) {\n *   const stateTaxes = useEmployeeStateTaxesForm({ employeeId })\n *\n *   if (stateTaxes.isLoading) return <div>Loading...</div>\n *\n *   return <StateTaxesFormReady stateTaxes={stateTaxes} />\n * }\n *\n * function StateTaxesFormReady({\n *   stateTaxes,\n * }: {\n *   stateTaxes: UseEmployeeStateTaxesFormReady\n * }) {\n *   const handleSubmit = async () => {\n *     const result = await stateTaxes.actions.onSubmit()\n *     if (result) console.log('Updated state tax records:', result.data)\n *   }\n *\n *   return (\n *     <SDKFormProvider formHookResult={stateTaxes}>\n *       <form\n *         onSubmit={e => {\n *           e.preventDefault()\n *           void handleSubmit()\n *         }}\n *       >\n *         {stateTaxes.form.Fields.map(group => (\n *           <section key={group.state}>\n *             <h2>{group.state}</h2>\n *             {group.questions.map(question => (\n *               <question.Field key={question.questionId} />\n *             ))}\n *           </section>\n *         ))}\n *         <button type=\"submit\" disabled={stateTaxes.status.isPending}>\n *           Save\n *         </button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useEmployeeStateTaxesForm({\n  employeeId,\n  isAdmin = false,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseEmployeeStateTaxesFormProps): UseEmployeeStateTaxesFormResult {\n  const stateTaxesQuery = useEmployeeTaxSetupGetStateTaxes({ employeeUuid: employeeId })\n\n  const employeeStateTaxes = useMemo<EmployeeStateTaxesList[]>(\n    () => stateTaxesQuery.data?.employeeStateTaxesList ?? [],\n    [stateTaxesQuery.data?.employeeStateTaxesList],\n  )\n\n  const [schema, metadataConfig] = useMemo(\n    () => createEmployeeStateTaxesSchema(employeeStateTaxes, { isAdmin }),\n    [employeeStateTaxes, isAdmin],\n  )\n\n  const fieldsArray = useMemo(\n    () => createStateFields(employeeStateTaxes, { isAdmin }),\n    [employeeStateTaxes, isAdmin],\n  )\n\n  const resolvedDefaults = useMemo(\n    () => deriveDefaultValues(employeeStateTaxes, isAdmin),\n    [employeeStateTaxes, isAdmin],\n  )\n\n  const formMethods = useForm<EmployeeStateTaxesFormData, unknown, EmployeeStateTaxesFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const { mutateAsync: updateStateTaxes, isPending } = useEmployeeTaxSetupUpdateStateTaxesMutation()\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('EmployeeStateTaxesForm')\n\n  const errorHandling = composeErrorHandler([stateTaxesQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const fieldsMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n\n  const onSubmit = async (): Promise<HookSubmitResult<EmployeeStateTaxesList[]> | undefined> => {\n    let submitResult: HookSubmitResult<EmployeeStateTaxesList[]> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async data => {\n          await baseSubmitHandler(data, async payload => {\n            const requestStates = serializeStatesPayload(payload, employeeStateTaxes, isAdmin)\n\n            if (requestStates.length === 0) {\n              submitResult = { mode: 'update', data: employeeStateTaxes }\n              return\n            }\n\n            const requestBody: EmployeeStateTaxesRequest = { states: requestStates }\n            const response = await updateStateTaxes({\n              request: { employeeUuid: employeeId, employeeStateTaxesRequest: requestBody },\n            })\n\n            const updated = response.employeeStateTaxesList\n            if (!updated) {\n              throw new SDKInternalError('State taxes update did not return an updated record')\n            }\n\n            submitResult = { mode: 'update', data: updated }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (stateTaxesQuery.isLoading || !stateTaxesQuery.data?.employeeStateTaxesList) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: { employeeStateTaxes },\n    status: { isPending, mode: 'update' as const },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: fieldsArray,\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n// ── Defaults derivation ────────────────────────────────────────────────\n\nfunction deriveDefaultValues(\n  employeeStateTaxes: EmployeeStateTaxesList[],\n  isAdmin: boolean,\n): EmployeeStateTaxesFormData {\n  const states: Record<string, Record<string, unknown>> = {}\n\n  for (const stateGroup of employeeStateTaxes) {\n    if (!stateGroup.state || !stateGroup.questions) continue\n\n    const stateValues: Record<string, unknown> = {}\n    for (const question of stateGroup.questions) {\n      if (question.isQuestionForAdminOnly && !isAdmin) continue\n      const formKey = snakeCaseToCamelCase(question.key)\n      const wireValue = question.answers[0]?.value\n      stateValues[formKey] = resolveDefaultForQuestion(question, wireValue)\n    }\n\n    if (Object.keys(stateValues).length > 0) {\n      states[stateGroup.state] = stateValues\n    }\n  }\n\n  return { states: states as EmployeeStateTaxesFormData['states'] }\n}\n\nfunction resolveDefaultForQuestion(\n  question: EmployeeStateTaxesList['questions'] extends Array<infer Q> | undefined ? Q : never,\n  wireValue: string | number | boolean | null | undefined,\n): unknown {\n  if (question.key === 'file_new_hire_report') {\n    if (wireValue === undefined || wireValue === null) return true\n    return wireValue\n  }\n\n  const variant = getQuestionVariant(question)\n\n  switch (variant) {\n    case 'date': {\n      if (wireValue === undefined || wireValue === null || wireValue === '') return undefined\n      if (typeof wireValue === 'string') {\n        const trimmed = wireValue.trim()\n        if (trimmed === '') return undefined\n        const parsed = new Date(trimmed)\n        return Number.isNaN(parsed.getTime()) ? undefined : parsed\n      }\n      return wireValue\n    }\n    case 'number':\n    case 'currency': {\n      if (wireValue === undefined || wireValue === null || wireValue === '') return undefined\n      const parsed = typeof wireValue === 'number' ? wireValue : Number(wireValue)\n      return Number.isNaN(parsed) ? undefined : parsed\n    }\n    default:\n      return wireValue\n  }\n}\n\n// ── Submit serialization ───────────────────────────────────────────────\n\ntype SerializedQuestion = {\n  key: string\n  answers: Array<{\n    validFrom: string\n    validUpTo: string | null\n    value: string | number | boolean\n  }>\n}\n\nfunction serializeStatesPayload(\n  payload: EmployeeStateTaxesFormOutputs,\n  employeeStateTaxes: EmployeeStateTaxesList[],\n  isAdmin: boolean,\n): EmployeeStateTaxesRequestState[] {\n  const { states: statesPayload } = payload\n  if (Object.keys(statesPayload).length === 0) return []\n\n  const result: EmployeeStateTaxesRequestState[] = []\n\n  for (const state of employeeStateTaxes) {\n    const stateName = state.state\n    if (!stateName || state.questions === undefined) continue\n\n    const serialized: SerializedQuestion[] = []\n    for (const question of state.questions) {\n      if (question.isQuestionForAdminOnly && !isAdmin) continue\n\n      const formValue = (statesPayload[stateName] as Record<string, unknown> | undefined)?.[\n        snakeCaseToCamelCase(question.key)\n      ]\n\n      let serializedValue: string | number | boolean\n      if (formValue === undefined || formValue === null) {\n        serializedValue = ''\n      } else if (typeof formValue === 'number' && Number.isNaN(formValue)) {\n        serializedValue = ''\n      } else if (formValue instanceof Date) {\n        if (Number.isNaN(formValue.getTime())) {\n          serializedValue = ''\n        } else {\n          serializedValue = formValue.toISOString().split('T')[0] ?? ''\n        }\n      } else {\n        serializedValue = formValue as string | number | boolean\n      }\n\n      serialized.push({\n        key: question.key,\n        answers: [\n          {\n            validFrom: question.answers[0]?.validFrom ?? DEFAULT_TAX_VALID_FROM,\n            validUpTo: question.answers[0]?.validUpTo ?? null,\n            value: serializedValue,\n          },\n        ],\n      })\n    }\n\n    result.push({ state: stateName, questions: serialized })\n  }\n\n  return result\n}\n\n/**\n * Field metadata for {@link useEmployeeStateTaxesForm}, keyed by full form path.\n *\n * @remarks\n * The set of keys is determined at runtime: one entry per state tax question,\n * keyed as `states.<STATE>.<camelCaseQuestionKey>`. Each entry is a\n * {@link FieldMetadata}, or a {@link FieldMetadataWithOptions} for questions the\n * API exposes as a select or radio. Both the questions and their options are\n * driven by the API response per state, so neither the keys nor which entries\n * carry options are known ahead of time.\n *\n * @public\n */\nexport type EmployeeStateTaxesFieldsMetadata = Record<\n  `states.${string}.${string}`,\n  FieldMetadata | FieldMetadataWithOptions\n>\n\n/**\n * The array of per-state field groups exposed by\n * {@link useEmployeeStateTaxesForm} on `form.Fields`.\n *\n * @public\n */\nexport type EmployeeStateTaxesFormFields = UseEmployeeStateTaxesFormReady['form']['Fields']\n"],"names":["DEFAULT_TAX_VALID_FROM","useEmployeeStateTaxesForm","employeeId","isAdmin","validationMode","shouldFocusError","stateTaxesQuery","useEmployeeTaxSetupGetStateTaxes","employeeStateTaxes","useMemo","schema","metadataConfig","createEmployeeStateTaxesSchema","fieldsArray","createStateFields","resolvedDefaults","deriveDefaultValues","formMethods","useForm","zodResolver","updateStateTaxes","isPending","useEmployeeTaxSetupUpdateStateTaxesMutation","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","fieldsMetadata","useDeriveFieldsMetadata","onSubmit","submitResult","resolve","data","payload","requestStates","serializeStatesPayload","updated","SDKInternalError","hookFormInternals","useHookFormInternals","createGetFormSubmissionValues","states","stateGroup","stateValues","question","formKey","snakeCaseToCamelCase","wireValue","resolveDefaultForQuestion","getQuestionVariant","trimmed","parsed","statesPayload","result","state","stateName","serialized","formValue","serializedValue"],"mappings":"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"}

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

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

package/dist/components/Employee/StateTaxes/shared/useStateTaxesSummary/useStateTaxesSummary.d.ts

@@ -1,4 +1,4 @@
-import { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxeslist';
+import { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2026-02-01/models/components/employeestatetaxeslist';
 import { BaseHookReady, HookLoadingResult } from '../../../../../partner-hook-utils/types';
 /** @internal */
 export interface UseStateTaxesSummaryParams {

package/dist/components/Employee/StateTaxes/shared/useStateTaxesSummary/useStateTaxesSummary.js

@@ -1,4 +1,4 @@
-import { useEmployeeTaxSetupGetStateTaxes as i } from "@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupGetStateTaxes";
+import { useEmployeeTaxSetupGetStateTaxes as i } from "@gusto/embedded-api-v-2026-02-01/react-query/employeeTaxSetupGetStateTaxes";
 import { composeErrorHandler as o } from "../../../../../partner-hook-utils/composeErrorHandler.js";
 function m({
   employeeId: s

package/dist/components/Employee/StateTaxes/shared/useStateTaxesSummary/useStateTaxesSummary.js.map

@@ -1 +1 @@
-{"version":3,"file":"useStateTaxesSummary.js","sources":["../../../../../../src/components/Employee/StateTaxes/shared/useStateTaxesSummary/useStateTaxesSummary.tsx"],"sourcesContent":["import { useEmployeeTaxSetupGetStateTaxes } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeTaxSetupGetStateTaxes'\nimport type { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxeslist'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type { BaseHookReady, HookLoadingResult } from '@/partner-hook-utils/types'\n\n/** @internal */\nexport interface UseStateTaxesSummaryParams {\n  employeeId: string\n}\n\ntype UseStateTaxesSummaryReady = BaseHookReady<\n  { employeeStateTaxesList: EmployeeStateTaxesList[] },\n  { isFetching: boolean; isPending: boolean }\n>\n\n/** @internal */\nexport type UseStateTaxesSummaryResult = HookLoadingResult | UseStateTaxesSummaryReady\n\n/** @internal */\nexport function useStateTaxesSummary({\n  employeeId,\n}: UseStateTaxesSummaryParams): UseStateTaxesSummaryResult {\n  const stateTaxesQuery = useEmployeeTaxSetupGetStateTaxes(\n    { employeeUuid: employeeId },\n    { staleTime: Infinity },\n  )\n\n  const errorHandling = composeErrorHandler([stateTaxesQuery])\n\n  const employeeStateTaxesList = stateTaxesQuery.data?.employeeStateTaxesList\n\n  if (stateTaxesQuery.isLoading || !employeeStateTaxesList) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: { employeeStateTaxesList },\n    status: {\n      isFetching: stateTaxesQuery.isFetching,\n      isPending: false,\n    },\n    errorHandling,\n  }\n}\n"],"names":["useStateTaxesSummary","employeeId","stateTaxesQuery","useEmployeeTaxSetupGetStateTaxes","errorHandling","composeErrorHandler","employeeStateTaxesList"],"mappings":";;AAmBO,SAASA,EAAqB;AAAA,EACnC,YAAAC;AACF,GAA2D;AACzD,QAAMC,IAAkBC;AAAA,IACtB,EAAE,cAAcF,EAAA;AAAA,IAChB,EAAE,WAAW,MAAA;AAAA,EAAS,GAGlBG,IAAgBC,EAAoB,CAACH,CAAe,CAAC,GAErDI,IAAyBJ,EAAgB,MAAM;AAErD,SAAIA,EAAgB,aAAa,CAACI,IACzB,EAAE,WAAW,IAAM,eAAAF,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM,EAAE,wBAAAE,EAAA;AAAA,IACR,QAAQ;AAAA,MACN,YAAYJ,EAAgB;AAAA,MAC5B,WAAW;AAAA,IAAA;AAAA,IAEb,eAAAE;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useStateTaxesSummary.js","sources":["../../../../../../src/components/Employee/StateTaxes/shared/useStateTaxesSummary/useStateTaxesSummary.tsx"],"sourcesContent":["import { useEmployeeTaxSetupGetStateTaxes } from '@gusto/embedded-api-v-2026-02-01/react-query/employeeTaxSetupGetStateTaxes'\nimport type { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2026-02-01/models/components/employeestatetaxeslist'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type { BaseHookReady, HookLoadingResult } from '@/partner-hook-utils/types'\n\n/** @internal */\nexport interface UseStateTaxesSummaryParams {\n  employeeId: string\n}\n\ntype UseStateTaxesSummaryReady = BaseHookReady<\n  { employeeStateTaxesList: EmployeeStateTaxesList[] },\n  { isFetching: boolean; isPending: boolean }\n>\n\n/** @internal */\nexport type UseStateTaxesSummaryResult = HookLoadingResult | UseStateTaxesSummaryReady\n\n/** @internal */\nexport function useStateTaxesSummary({\n  employeeId,\n}: UseStateTaxesSummaryParams): UseStateTaxesSummaryResult {\n  const stateTaxesQuery = useEmployeeTaxSetupGetStateTaxes(\n    { employeeUuid: employeeId },\n    { staleTime: Infinity },\n  )\n\n  const errorHandling = composeErrorHandler([stateTaxesQuery])\n\n  const employeeStateTaxesList = stateTaxesQuery.data?.employeeStateTaxesList\n\n  if (stateTaxesQuery.isLoading || !employeeStateTaxesList) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: { employeeStateTaxesList },\n    status: {\n      isFetching: stateTaxesQuery.isFetching,\n      isPending: false,\n    },\n    errorHandling,\n  }\n}\n"],"names":["useStateTaxesSummary","employeeId","stateTaxesQuery","useEmployeeTaxSetupGetStateTaxes","errorHandling","composeErrorHandler","employeeStateTaxesList"],"mappings":";;AAmBO,SAASA,EAAqB;AAAA,EACnC,YAAAC;AACF,GAA2D;AACzD,QAAMC,IAAkBC;AAAA,IACtB,EAAE,cAAcF,EAAA;AAAA,IAChB,EAAE,WAAW,MAAA;AAAA,EAAS,GAGlBG,IAAgBC,EAAoB,CAACH,CAAe,CAAC,GAErDI,IAAyBJ,EAAgB,MAAM;AAErD,SAAIA,EAAgB,aAAa,CAACI,IACzB,EAAE,WAAW,IAAM,eAAAF,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM,EAAE,wBAAAE,EAAA;AAAA,IACR,QAAQ;AAAA,MACN,YAAYJ,EAAgB;AAAA,MAC5B,WAAW;AAAA,IAAA;AAAA,IAEb,eAAAE;AAAA,EAAA;AAEJ;"}

package/dist/components/Employee/Terminations/TerminateEmployee/TerminateEmployee.d.ts

@@ -45,7 +45,7 @@ export interface TerminateEmployeeFormData {
  * @param props - See {@link TerminateEmployeeProps}.
  * @returns The termination form.
  * @public
- * @group Block Components
+ * @group Block components
  *
  * @example
  * ```tsx

package/dist/components/Employee/Terminations/TerminateEmployee/TerminateEmployee.js

@@ -1,14 +1,14 @@
 import { jsx as y } from "react/jsx-runtime";
 import { useQueryClient as S } from "@tanstack/react-query";
-import { useEmployeesGetSuspense as Y } from "@gusto/embedded-api-v-2025-11-15/react-query/employeesGet";
-import { useEmployeeEmploymentsGetTerminationsSuspense as q, invalidateAllEmployeeEmploymentsGetTerminations as I } from "@gusto/embedded-api-v-2025-11-15/react-query/employeeEmploymentsGetTerminations";
-import { useEmployeeEmploymentsCreateTerminationMutation as b } from "@gusto/embedded-api-v-2025-11-15/react-query/employeeEmploymentsCreateTermination";
-import { useEmployeeEmploymentsUpdateTerminationMutation as B } from "@gusto/embedded-api-v-2025-11-15/react-query/employeeEmploymentsUpdateTermination";
-import { usePayrollsCreateOffCycleMutation as G } from "@gusto/embedded-api-v-2025-11-15/react-query/payrollsCreateOffCycle";
-import { usePaySchedulesGetUnprocessedTerminationPeriods as k, invalidateAllPaySchedulesGetUnprocessedTerminationPeriods as x } from "@gusto/embedded-api-v-2025-11-15/react-query/paySchedulesGetUnprocessedTerminationPeriods";
-import { invalidateAllPayrollsList as W } from "@gusto/embedded-api-v-2025-11-15/react-query/payrollsList";
-import { OffCycleReason as F } from "@gusto/embedded-api-v-2025-11-15/models/operations/postv1companiescompanyidpayrolls";
-import { RFCDate as p } from "@gusto/embedded-api-v-2025-11-15/types/rfcdate";
+import { useEmployeesGetSuspense as Y } from "@gusto/embedded-api-v-2026-02-01/react-query/employeesGet";
+import { useEmployeeEmploymentsGetTerminationsSuspense as q, invalidateAllEmployeeEmploymentsGetTerminations as I } from "@gusto/embedded-api-v-2026-02-01/react-query/employeeEmploymentsGetTerminations";
+import { useEmployeeEmploymentsCreateTerminationMutation as b } from "@gusto/embedded-api-v-2026-02-01/react-query/employeeEmploymentsCreateTermination";
+import { useEmployeeEmploymentsUpdateTerminationMutation as B } from "@gusto/embedded-api-v-2026-02-01/react-query/employeeEmploymentsUpdateTermination";
+import { usePayrollsCreateOffCycleMutation as G } from "@gusto/embedded-api-v-2026-02-01/react-query/payrollsCreateOffCycle";
+import { usePaySchedulesGetUnprocessedTerminationPeriods as k, invalidateAllPaySchedulesGetUnprocessedTerminationPeriods as x } from "@gusto/embedded-api-v-2026-02-01/react-query/paySchedulesGetUnprocessedTerminationPeriods";
+import { invalidateAllPayrollsList as W } from "@gusto/embedded-api-v-2026-02-01/react-query/payrollsList";
+import { OffCycleReason as F } from "@gusto/embedded-api-v-2026-02-01/models/operations/postv1companiescompanyidpayrolls";
+import { RFCDate as p } from "@gusto/embedded-api-v-2026-02-01/types/rfcdate";
 import { TerminateEmployeePresentation as H } from "./TerminateEmployeePresentation.js";
 import { BaseComponent as j } from "../../../Base/Base.js";
 import { useBase as Q } from "../../../Base/useBase.js";

package/dist/components/Employee/Terminations/TerminateEmployee/TerminateEmployee.js.map

@@ -1 +1 @@
-{"version":3,"file":"TerminateEmployee.js","sources":["../../../../../src/components/Employee/Terminations/TerminateEmployee/TerminateEmployee.tsx"],"sourcesContent":["import { useQueryClient } from '@tanstack/react-query'\nimport { useEmployeesGetSuspense } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesGet'\nimport {\n  useEmployeeEmploymentsGetTerminationsSuspense,\n  invalidateAllEmployeeEmploymentsGetTerminations,\n} from '@gusto/embedded-api-v-2025-11-15/react-query/employeeEmploymentsGetTerminations'\nimport { useEmployeeEmploymentsCreateTerminationMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeEmploymentsCreateTermination'\nimport { useEmployeeEmploymentsUpdateTerminationMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeEmploymentsUpdateTermination'\nimport { usePayrollsCreateOffCycleMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/payrollsCreateOffCycle'\nimport {\n  usePaySchedulesGetUnprocessedTerminationPeriods,\n  invalidateAllPaySchedulesGetUnprocessedTerminationPeriods,\n} from '@gusto/embedded-api-v-2025-11-15/react-query/paySchedulesGetUnprocessedTerminationPeriods'\nimport { invalidateAllPayrollsList } from '@gusto/embedded-api-v-2025-11-15/react-query/payrollsList'\nimport { OffCycleReason } from '@gusto/embedded-api-v-2025-11-15/models/operations/postv1companiescompanyidpayrolls'\nimport { RFCDate } from '@gusto/embedded-api-v-2025-11-15/types/rfcdate'\nimport type { PayrollOption } from '../types'\nimport { TerminateEmployeePresentation } from './TerminateEmployeePresentation'\nimport type { BaseComponentInterface } from '@/components/Base/Base'\nimport { BaseComponent } from '@/components/Base/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { componentEvents } from '@/shared/constants'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { firstLastName } from '@/helpers/formattedStrings'\n\n/**\n * Props for {@link TerminateEmployee}.\n *\n * @public\n */\nexport interface TerminateEmployeeProps extends BaseComponentInterface<'Employee.Terminations.TerminateEmployee'> {\n  /** The employee identifier to terminate. */\n  employeeId: string\n  /** The associated company identifier. */\n  companyId: string\n}\n\n/**\n * Form values collected by {@link TerminateEmployee}.\n *\n * @public\n */\nexport interface TerminateEmployeeFormData {\n  /** The effective date of the termination — the employee's last day of work. */\n  lastDayOfWork: Date\n  /** How to process the employee's final paycheck. */\n  payrollOption: PayrollOption\n}\n\n/**\n * Standalone form for capturing an employee's termination details — last day of work and how to process final payroll.\n *\n * @remarks\n * The main termination form used inside {@link TerminationFlow}. Detects existing\n * terminations and pre-populates for editing when one is active, or routes to\n * the summary view (via the `employee/termination/viewSummary` event) when the\n * employee is already terminated.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/termination/created` | Fired when a new termination is created | `{ employeeId: string, effectiveDate: string, payrollOption: PayrollOption }` |\n * | `employee/termination/updated` | Fired when an existing termination is updated | `{ employeeId: string, effectiveDate: string, payrollOption: PayrollOption }` |\n * | `employee/termination/done` | Fired when the termination form is completed | `{ employeeId: string, effectiveDate: string, payrollOption: PayrollOption, payrollUuid?: string }` |\n * | `employee/termination/viewSummary` | Fired when redirecting to view an existing termination | `{ employeeId: string, effectiveDate: string }` |\n * | `employee/termination/payrollCreated` | Fired after a dismissal-payroll period was successfully created | `{ payrolls: PayrollUnprocessed[] }` |\n * | `employee/termination/payrollFailed` | Fired if creating a dismissal payroll fails | `{ employeeId: string, error: unknown }` |\n * | `CANCEL` | Fired when the user clicks Cancel | — |\n *\n * @param props - See {@link TerminateEmployeeProps}.\n * @returns The termination form.\n * @public\n * @group Block Components\n *\n * @example\n * ```tsx\n * import { EmployeeManagement } from '@gusto/embedded-react-sdk'\n *\n * function MyComponent() {\n *   return (\n *     <EmployeeManagement.TerminateEmployee\n *       companyId=\"a007e1ab-3595-43c2-ab4b-af7a5af2e365\"\n *       employeeId=\"4b3f930f-82cd-48a8-b797-798686e12e5e\"\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport function TerminateEmployee(props: TerminateEmployeeProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nconst Root = ({ employeeId, companyId, dictionary }: TerminateEmployeeProps) => {\n  useComponentDictionary('Employee.Terminations.TerminateEmployee', dictionary)\n  useI18n('Employee.Terminations.TerminateEmployee')\n\n  const queryClient = useQueryClient()\n  const { onEvent, baseSubmitHandler } = useBase()\n\n  const {\n    data: { employee },\n  } = useEmployeesGetSuspense({ employeeId })\n\n  const { data: terminationsData } = useEmployeeEmploymentsGetTerminationsSuspense({ employeeId })\n\n  const { mutateAsync: createTermination, isPending: isCreatingTermination } =\n    useEmployeeEmploymentsCreateTerminationMutation()\n\n  const { mutateAsync: updateTermination, isPending: isUpdatingTermination } =\n    useEmployeeEmploymentsUpdateTerminationMutation()\n\n  const { mutateAsync: createOffCyclePayroll, isPending: isCreatingPayroll } =\n    usePayrollsCreateOffCycleMutation()\n\n  const { refetch: fetchTerminationPeriods } = usePaySchedulesGetUnprocessedTerminationPeriods(\n    { companyId },\n    { enabled: false },\n  )\n\n  // If employee is already terminated, redirect to summary with existing termination data\n  // Don't pass payrollOption to avoid showing the success alert\n  if (employee?.terminated && terminationsData.terminations?.[0]) {\n    onEvent(componentEvents.EMPLOYEE_TERMINATION_VIEW_SUMMARY, {\n      employeeId,\n      effectiveDate: terminationsData.terminations[0].effectiveDate!,\n      termination: terminationsData.terminations[0],\n    })\n    return null\n  }\n\n  const employeeName = firstLastName({\n    first_name: employee?.firstName,\n    last_name: employee?.lastName,\n  })\n\n  const existingTermination = terminationsData.terminations?.[0]\n\n  const handleSubmit = async (formData: TerminateEmployeeFormData) => {\n    const { lastDayOfWork, payrollOption } = formData\n    const effectiveDate = lastDayOfWork.toISOString().split('T')[0]!\n\n    await baseSubmitHandler({ effectiveDate, payrollOption }, async () => {\n      const runTerminationPayroll = payrollOption === 'dismissalPayroll'\n\n      const result = existingTermination\n        ? await updateTermination({\n            request: {\n              employeeId,\n              requestBody: {\n                version: existingTermination.version!,\n                effectiveDate,\n                runTerminationPayroll,\n              },\n            },\n          })\n        : await createTermination({\n            request: {\n              employeeId,\n              requestBody: {\n                effectiveDate,\n                runTerminationPayroll,\n              },\n            },\n          })\n\n      await invalidateAllEmployeeEmploymentsGetTerminations(queryClient)\n\n      let firstPayrollUuid: string | undefined\n\n      if (runTerminationPayroll) {\n        try {\n          const { data: terminationPeriodsData } = await fetchTerminationPeriods()\n\n          const employeePeriods =\n            terminationPeriodsData?.unprocessedTerminationPayPeriods?.filter(\n              period => period.employeeUuid === employeeId,\n            ) ?? []\n\n          const createdPayrolls = []\n\n          for (const terminationPeriod of employeePeriods) {\n            if (terminationPeriod.startDate && terminationPeriod.endDate) {\n              const payrollResult = await createOffCyclePayroll({\n                request: {\n                  companyId,\n                  requestBody: {\n                    offCycle: true,\n                    offCycleReason: OffCycleReason.DismissedEmployee,\n                    startDate: new RFCDate(terminationPeriod.startDate),\n                    endDate: new RFCDate(terminationPeriod.endDate),\n                    employeeUuids: [employeeId],\n                    checkDate: terminationPeriod.checkDate\n                      ? new RFCDate(terminationPeriod.checkDate)\n                      : undefined,\n                  },\n                },\n              })\n\n              if (payrollResult.payrollUnprocessed) {\n                createdPayrolls.push(payrollResult.payrollUnprocessed)\n              }\n            }\n          }\n\n          if (createdPayrolls.length > 0) {\n            firstPayrollUuid = createdPayrolls[0]?.payrollUuid ?? createdPayrolls[0]?.uuid\n\n            await invalidateAllPayrollsList(queryClient)\n            await invalidateAllPaySchedulesGetUnprocessedTerminationPeriods(queryClient)\n\n            onEvent(componentEvents.EMPLOYEE_TERMINATION_PAYROLL_CREATED, {\n              payrolls: createdPayrolls,\n            })\n          }\n        } catch (payrollError) {\n          onEvent(componentEvents.EMPLOYEE_TERMINATION_PAYROLL_FAILED, {\n            error: payrollError,\n            employeeId,\n          })\n        }\n      }\n\n      const eventType = existingTermination\n        ? componentEvents.EMPLOYEE_TERMINATION_UPDATED\n        : componentEvents.EMPLOYEE_TERMINATION_CREATED\n\n      onEvent(eventType, {\n        termination: result.termination,\n        payrollOption,\n        runTerminationPayroll,\n      })\n\n      onEvent(componentEvents.EMPLOYEE_TERMINATION_DONE, {\n        employeeId,\n        effectiveDate,\n        payrollOption,\n        payrollUuid: firstPayrollUuid,\n        termination: result.termination,\n        ...(payrollOption === 'anotherWay' && { manualHandling: true }),\n      })\n    })\n  }\n\n  const handleCancel = () => {\n    onEvent(componentEvents.CANCEL)\n  }\n\n  const isPending = isCreatingTermination || isUpdatingTermination || isCreatingPayroll\n\n  return (\n    <TerminateEmployeePresentation\n      employeeName={employeeName}\n      existingTermination={existingTermination}\n      onSubmit={handleSubmit}\n      onCancel={handleCancel}\n      isLoading={isPending}\n    />\n  )\n}\n"],"names":["TerminateEmployee","props","jsx","BaseComponent","Root","employeeId","companyId","dictionary","useComponentDictionary","useI18n","queryClient","useQueryClient","onEvent","baseSubmitHandler","useBase","employee","useEmployeesGetSuspense","terminationsData","useEmployeeEmploymentsGetTerminationsSuspense","createTermination","isCreatingTermination","useEmployeeEmploymentsCreateTerminationMutation","updateTermination","isUpdatingTermination","useEmployeeEmploymentsUpdateTerminationMutation","createOffCyclePayroll","isCreatingPayroll","usePayrollsCreateOffCycleMutation","fetchTerminationPeriods","usePaySchedulesGetUnprocessedTerminationPeriods","componentEvents","employeeName","firstLastName","existingTermination","TerminateEmployeePresentation","formData","lastDayOfWork","payrollOption","effectiveDate","runTerminationPayroll","result","invalidateAllEmployeeEmploymentsGetTerminations","firstPayrollUuid","terminationPeriodsData","employeePeriods","period","createdPayrolls","terminationPeriod","payrollResult","OffCycleReason","RFCDate","invalidateAllPayrollsList","invalidateAllPaySchedulesGetUnprocessedTerminationPeriods","payrollError","eventType"],"mappings":";;;;;;;;;;;;;;;;;AAyFO,SAASA,GAAkBC,GAA+B;AAC/D,SACE,gBAAAC,EAACC,GAAA,EAAe,GAAGF,GACjB,UAAA,gBAAAC,EAACE,KAAM,GAAGH,GAAQ,UAAAA,EAAM,SAAA,CAAS,EAAA,CACnC;AAEJ;AAEA,MAAMG,IAAO,CAAC,EAAE,YAAAC,GAAY,WAAAC,GAAW,YAAAC,QAAyC;AAC9E,EAAAC,EAAuB,2CAA2CD,CAAU,GAC5EE,EAAQ,yCAAyC;AAEjD,QAAMC,IAAcC,EAAA,GACd,EAAE,SAAAC,GAAS,mBAAAC,EAAA,IAAsBC,EAAA,GAEjC;AAAA,IACJ,MAAM,EAAE,UAAAC,EAAA;AAAA,EAAS,IACfC,EAAwB,EAAE,YAAAX,GAAY,GAEpC,EAAE,MAAMY,EAAA,IAAqBC,EAA8C,EAAE,YAAAb,GAAY,GAEzF,EAAE,aAAac,GAAmB,WAAWC,EAAA,IACjDC,EAAA,GAEI,EAAE,aAAaC,GAAmB,WAAWC,EAAA,IACjDC,EAAA,GAEI,EAAE,aAAaC,GAAuB,WAAWC,EAAA,IACrDC,EAAA,GAEI,EAAE,SAASC,EAAA,IAA4BC;AAAA,IAC3C,EAAE,WAAAvB,EAAA;AAAA,IACF,EAAE,SAAS,GAAA;AAAA,EAAM;AAKnB,MAAIS,GAAU,cAAcE,EAAiB,eAAe,CAAC;AAC3D,WAAAL,EAAQkB,EAAgB,mCAAmC;AAAA,MACzD,YAAAzB;AAAA,MACA,eAAeY,EAAiB,aAAa,CAAC,EAAE;AAAA,MAChD,aAAaA,EAAiB,aAAa,CAAC;AAAA,IAAA,CAC7C,GACM;AAGT,QAAMc,IAAeC,EAAc;AAAA,IACjC,YAAYjB,GAAU;AAAA,IACtB,WAAWA,GAAU;AAAA,EAAA,CACtB,GAEKkB,IAAsBhB,EAAiB,eAAe,CAAC;AAkH7D,SACE,gBAAAf;AAAA,IAACgC;AAAA,IAAA;AAAA,MACC,cAAAH;AAAA,MACA,qBAAAE;AAAA,MACA,UApHiB,OAAOE,MAAwC;AAClE,cAAM,EAAE,eAAAC,GAAe,eAAAC,EAAA,IAAkBF,GACnCG,IAAgBF,EAAc,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC;AAE9D,cAAMvB,EAAkB,EAAE,eAAAyB,GAAe,eAAAD,EAAA,GAAiB,YAAY;AACpE,gBAAME,IAAwBF,MAAkB,oBAE1CG,IAASP,IACX,MAAMX,EAAkB;AAAA,YACtB,SAAS;AAAA,cACP,YAAAjB;AAAA,cACA,aAAa;AAAA,gBACX,SAAS4B,EAAoB;AAAA,gBAC7B,eAAAK;AAAA,gBACA,uBAAAC;AAAA,cAAA;AAAA,YACF;AAAA,UACF,CACD,IACD,MAAMpB,EAAkB;AAAA,YACtB,SAAS;AAAA,cACP,YAAAd;AAAA,cACA,aAAa;AAAA,gBACX,eAAAiC;AAAA,gBACA,uBAAAC;AAAA,cAAA;AAAA,YACF;AAAA,UACF,CACD;AAEL,gBAAME,EAAgD/B,CAAW;AAEjE,cAAIgC;AAEJ,cAAIH;AACF,gBAAI;AACF,oBAAM,EAAE,MAAMI,EAAA,IAA2B,MAAMf,EAAA,GAEzCgB,IACJD,GAAwB,kCAAkC;AAAA,gBACxD,CAAAE,MAAUA,EAAO,iBAAiBxC;AAAA,cAAA,KAC/B,CAAA,GAEDyC,IAAkB,CAAA;AAExB,yBAAWC,KAAqBH;AAC9B,oBAAIG,EAAkB,aAAaA,EAAkB,SAAS;AAC5D,wBAAMC,IAAgB,MAAMvB,EAAsB;AAAA,oBAChD,SAAS;AAAA,sBACP,WAAAnB;AAAA,sBACA,aAAa;AAAA,wBACX,UAAU;AAAA,wBACV,gBAAgB2C,EAAe;AAAA,wBAC/B,WAAW,IAAIC,EAAQH,EAAkB,SAAS;AAAA,wBAClD,SAAS,IAAIG,EAAQH,EAAkB,OAAO;AAAA,wBAC9C,eAAe,CAAC1C,CAAU;AAAA,wBAC1B,WAAW0C,EAAkB,YACzB,IAAIG,EAAQH,EAAkB,SAAS,IACvC;AAAA,sBAAA;AAAA,oBACN;AAAA,kBACF,CACD;AAED,kBAAIC,EAAc,sBAChBF,EAAgB,KAAKE,EAAc,kBAAkB;AAAA,gBAEzD;AAGF,cAAIF,EAAgB,SAAS,MAC3BJ,IAAmBI,EAAgB,CAAC,GAAG,eAAeA,EAAgB,CAAC,GAAG,MAE1E,MAAMK,EAA0BzC,CAAW,GAC3C,MAAM0C,EAA0D1C,CAAW,GAE3EE,EAAQkB,EAAgB,sCAAsC;AAAA,gBAC5D,UAAUgB;AAAA,cAAA,CACX;AAAA,YAEL,SAASO,GAAc;AACrB,cAAAzC,EAAQkB,EAAgB,qCAAqC;AAAA,gBAC3D,OAAOuB;AAAA,gBACP,YAAAhD;AAAA,cAAA,CACD;AAAA,YACH;AAGF,gBAAMiD,IAAYrB,IACdH,EAAgB,+BAChBA,EAAgB;AAEpB,UAAAlB,EAAQ0C,GAAW;AAAA,YACjB,aAAad,EAAO;AAAA,YACpB,eAAAH;AAAA,YACA,uBAAAE;AAAA,UAAA,CACD,GAED3B,EAAQkB,EAAgB,2BAA2B;AAAA,YACjD,YAAAzB;AAAA,YACA,eAAAiC;AAAA,YACA,eAAAD;AAAA,YACA,aAAaK;AAAA,YACb,aAAaF,EAAO;AAAA,YACpB,GAAIH,MAAkB,gBAAgB,EAAE,gBAAgB,GAAA;AAAA,UAAK,CAC9D;AAAA,QACH,CAAC;AAAA,MACH;AAAA,MAaI,UAXiB,MAAM;AACzB,QAAAzB,EAAQkB,EAAgB,MAAM;AAAA,MAChC;AAAA,MAUI,WARcV,KAAyBG,KAAyBG;AAAA,IAQrD;AAAA,EAAA;AAGjB;"}
+{"version":3,"file":"TerminateEmployee.js","sources":["../../../../../src/components/Employee/Terminations/TerminateEmployee/TerminateEmployee.tsx"],"sourcesContent":["import { useQueryClient } from '@tanstack/react-query'\nimport { useEmployeesGetSuspense } from '@gusto/embedded-api-v-2026-02-01/react-query/employeesGet'\nimport {\n  useEmployeeEmploymentsGetTerminationsSuspense,\n  invalidateAllEmployeeEmploymentsGetTerminations,\n} from '@gusto/embedded-api-v-2026-02-01/react-query/employeeEmploymentsGetTerminations'\nimport { useEmployeeEmploymentsCreateTerminationMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/employeeEmploymentsCreateTermination'\nimport { useEmployeeEmploymentsUpdateTerminationMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/employeeEmploymentsUpdateTermination'\nimport { usePayrollsCreateOffCycleMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/payrollsCreateOffCycle'\nimport {\n  usePaySchedulesGetUnprocessedTerminationPeriods,\n  invalidateAllPaySchedulesGetUnprocessedTerminationPeriods,\n} from '@gusto/embedded-api-v-2026-02-01/react-query/paySchedulesGetUnprocessedTerminationPeriods'\nimport { invalidateAllPayrollsList } from '@gusto/embedded-api-v-2026-02-01/react-query/payrollsList'\nimport { OffCycleReason } from '@gusto/embedded-api-v-2026-02-01/models/operations/postv1companiescompanyidpayrolls'\nimport { RFCDate } from '@gusto/embedded-api-v-2026-02-01/types/rfcdate'\nimport type { PayrollOption } from '../types'\nimport { TerminateEmployeePresentation } from './TerminateEmployeePresentation'\nimport type { BaseComponentInterface } from '@/components/Base/Base'\nimport { BaseComponent } from '@/components/Base/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { componentEvents } from '@/shared/constants'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { firstLastName } from '@/helpers/formattedStrings'\n\n/**\n * Props for {@link TerminateEmployee}.\n *\n * @public\n */\nexport interface TerminateEmployeeProps extends BaseComponentInterface<'Employee.Terminations.TerminateEmployee'> {\n  /** The employee identifier to terminate. */\n  employeeId: string\n  /** The associated company identifier. */\n  companyId: string\n}\n\n/**\n * Form values collected by {@link TerminateEmployee}.\n *\n * @public\n */\nexport interface TerminateEmployeeFormData {\n  /** The effective date of the termination — the employee's last day of work. */\n  lastDayOfWork: Date\n  /** How to process the employee's final paycheck. */\n  payrollOption: PayrollOption\n}\n\n/**\n * Standalone form for capturing an employee's termination details — last day of work and how to process final payroll.\n *\n * @remarks\n * The main termination form used inside {@link TerminationFlow}. Detects existing\n * terminations and pre-populates for editing when one is active, or routes to\n * the summary view (via the `employee/termination/viewSummary` event) when the\n * employee is already terminated.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/termination/created` | Fired when a new termination is created | `{ employeeId: string, effectiveDate: string, payrollOption: PayrollOption }` |\n * | `employee/termination/updated` | Fired when an existing termination is updated | `{ employeeId: string, effectiveDate: string, payrollOption: PayrollOption }` |\n * | `employee/termination/done` | Fired when the termination form is completed | `{ employeeId: string, effectiveDate: string, payrollOption: PayrollOption, payrollUuid?: string }` |\n * | `employee/termination/viewSummary` | Fired when redirecting to view an existing termination | `{ employeeId: string, effectiveDate: string }` |\n * | `employee/termination/payrollCreated` | Fired after a dismissal-payroll period was successfully created | `{ payrolls: PayrollUnprocessed[] }` |\n * | `employee/termination/payrollFailed` | Fired if creating a dismissal payroll fails | `{ employeeId: string, error: unknown }` |\n * | `CANCEL` | Fired when the user clicks Cancel | — |\n *\n * @param props - See {@link TerminateEmployeeProps}.\n * @returns The termination form.\n * @public\n * @group Block components\n *\n * @example\n * ```tsx\n * import { EmployeeManagement } from '@gusto/embedded-react-sdk'\n *\n * function MyComponent() {\n *   return (\n *     <EmployeeManagement.TerminateEmployee\n *       companyId=\"a007e1ab-3595-43c2-ab4b-af7a5af2e365\"\n *       employeeId=\"4b3f930f-82cd-48a8-b797-798686e12e5e\"\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport function TerminateEmployee(props: TerminateEmployeeProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nconst Root = ({ employeeId, companyId, dictionary }: TerminateEmployeeProps) => {\n  useComponentDictionary('Employee.Terminations.TerminateEmployee', dictionary)\n  useI18n('Employee.Terminations.TerminateEmployee')\n\n  const queryClient = useQueryClient()\n  const { onEvent, baseSubmitHandler } = useBase()\n\n  const {\n    data: { employee },\n  } = useEmployeesGetSuspense({ employeeId })\n\n  const { data: terminationsData } = useEmployeeEmploymentsGetTerminationsSuspense({ employeeId })\n\n  const { mutateAsync: createTermination, isPending: isCreatingTermination } =\n    useEmployeeEmploymentsCreateTerminationMutation()\n\n  const { mutateAsync: updateTermination, isPending: isUpdatingTermination } =\n    useEmployeeEmploymentsUpdateTerminationMutation()\n\n  const { mutateAsync: createOffCyclePayroll, isPending: isCreatingPayroll } =\n    usePayrollsCreateOffCycleMutation()\n\n  const { refetch: fetchTerminationPeriods } = usePaySchedulesGetUnprocessedTerminationPeriods(\n    { companyId },\n    { enabled: false },\n  )\n\n  // If employee is already terminated, redirect to summary with existing termination data\n  // Don't pass payrollOption to avoid showing the success alert\n  if (employee?.terminated && terminationsData.terminations?.[0]) {\n    onEvent(componentEvents.EMPLOYEE_TERMINATION_VIEW_SUMMARY, {\n      employeeId,\n      effectiveDate: terminationsData.terminations[0].effectiveDate!,\n      termination: terminationsData.terminations[0],\n    })\n    return null\n  }\n\n  const employeeName = firstLastName({\n    first_name: employee?.firstName,\n    last_name: employee?.lastName,\n  })\n\n  const existingTermination = terminationsData.terminations?.[0]\n\n  const handleSubmit = async (formData: TerminateEmployeeFormData) => {\n    const { lastDayOfWork, payrollOption } = formData\n    const effectiveDate = lastDayOfWork.toISOString().split('T')[0]!\n\n    await baseSubmitHandler({ effectiveDate, payrollOption }, async () => {\n      const runTerminationPayroll = payrollOption === 'dismissalPayroll'\n\n      const result = existingTermination\n        ? await updateTermination({\n            request: {\n              employeeId,\n              requestBody: {\n                version: existingTermination.version!,\n                effectiveDate,\n                runTerminationPayroll,\n              },\n            },\n          })\n        : await createTermination({\n            request: {\n              employeeId,\n              requestBody: {\n                effectiveDate,\n                runTerminationPayroll,\n              },\n            },\n          })\n\n      await invalidateAllEmployeeEmploymentsGetTerminations(queryClient)\n\n      let firstPayrollUuid: string | undefined\n\n      if (runTerminationPayroll) {\n        try {\n          const { data: terminationPeriodsData } = await fetchTerminationPeriods()\n\n          const employeePeriods =\n            terminationPeriodsData?.unprocessedTerminationPayPeriods?.filter(\n              period => period.employeeUuid === employeeId,\n            ) ?? []\n\n          const createdPayrolls = []\n\n          for (const terminationPeriod of employeePeriods) {\n            if (terminationPeriod.startDate && terminationPeriod.endDate) {\n              const payrollResult = await createOffCyclePayroll({\n                request: {\n                  companyId,\n                  requestBody: {\n                    offCycle: true,\n                    offCycleReason: OffCycleReason.DismissedEmployee,\n                    startDate: new RFCDate(terminationPeriod.startDate),\n                    endDate: new RFCDate(terminationPeriod.endDate),\n                    employeeUuids: [employeeId],\n                    checkDate: terminationPeriod.checkDate\n                      ? new RFCDate(terminationPeriod.checkDate)\n                      : undefined,\n                  },\n                },\n              })\n\n              if (payrollResult.payrollUnprocessed) {\n                createdPayrolls.push(payrollResult.payrollUnprocessed)\n              }\n            }\n          }\n\n          if (createdPayrolls.length > 0) {\n            firstPayrollUuid = createdPayrolls[0]?.payrollUuid ?? createdPayrolls[0]?.uuid\n\n            await invalidateAllPayrollsList(queryClient)\n            await invalidateAllPaySchedulesGetUnprocessedTerminationPeriods(queryClient)\n\n            onEvent(componentEvents.EMPLOYEE_TERMINATION_PAYROLL_CREATED, {\n              payrolls: createdPayrolls,\n            })\n          }\n        } catch (payrollError) {\n          onEvent(componentEvents.EMPLOYEE_TERMINATION_PAYROLL_FAILED, {\n            error: payrollError,\n            employeeId,\n          })\n        }\n      }\n\n      const eventType = existingTermination\n        ? componentEvents.EMPLOYEE_TERMINATION_UPDATED\n        : componentEvents.EMPLOYEE_TERMINATION_CREATED\n\n      onEvent(eventType, {\n        termination: result.termination,\n        payrollOption,\n        runTerminationPayroll,\n      })\n\n      onEvent(componentEvents.EMPLOYEE_TERMINATION_DONE, {\n        employeeId,\n        effectiveDate,\n        payrollOption,\n        payrollUuid: firstPayrollUuid,\n        termination: result.termination,\n        ...(payrollOption === 'anotherWay' && { manualHandling: true }),\n      })\n    })\n  }\n\n  const handleCancel = () => {\n    onEvent(componentEvents.CANCEL)\n  }\n\n  const isPending = isCreatingTermination || isUpdatingTermination || isCreatingPayroll\n\n  return (\n    <TerminateEmployeePresentation\n      employeeName={employeeName}\n      existingTermination={existingTermination}\n      onSubmit={handleSubmit}\n      onCancel={handleCancel}\n      isLoading={isPending}\n    />\n  )\n}\n"],"names":["TerminateEmployee","props","jsx","BaseComponent","Root","employeeId","companyId","dictionary","useComponentDictionary","useI18n","queryClient","useQueryClient","onEvent","baseSubmitHandler","useBase","employee","useEmployeesGetSuspense","terminationsData","useEmployeeEmploymentsGetTerminationsSuspense","createTermination","isCreatingTermination","useEmployeeEmploymentsCreateTerminationMutation","updateTermination","isUpdatingTermination","useEmployeeEmploymentsUpdateTerminationMutation","createOffCyclePayroll","isCreatingPayroll","usePayrollsCreateOffCycleMutation","fetchTerminationPeriods","usePaySchedulesGetUnprocessedTerminationPeriods","componentEvents","employeeName","firstLastName","existingTermination","TerminateEmployeePresentation","formData","lastDayOfWork","payrollOption","effectiveDate","runTerminationPayroll","result","invalidateAllEmployeeEmploymentsGetTerminations","firstPayrollUuid","terminationPeriodsData","employeePeriods","period","createdPayrolls","terminationPeriod","payrollResult","OffCycleReason","RFCDate","invalidateAllPayrollsList","invalidateAllPaySchedulesGetUnprocessedTerminationPeriods","payrollError","eventType"],"mappings":"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"}

package/dist/components/Employee/Terminations/TerminateEmployee/TerminateEmployeePresentation.d.ts

@@ -1,4 +1,4 @@
-import { Termination } from '@gusto/embedded-api-v-2025-11-15/models/components/termination';
+import { Termination } from '@gusto/embedded-api-v-2026-02-01/models/components/termination';
 import { TerminateEmployeeFormData } from './TerminateEmployee';
 interface TerminateEmployeePresentationProps {
     employeeName: string;

package/dist/components/Employee/Terminations/TerminateEmployee/TerminateEmployeePresentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"TerminateEmployeePresentation.js","sources":["../../../../../src/components/Employee/Terminations/TerminateEmployee/TerminateEmployeePresentation.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport z from 'zod'\nimport { FormProvider, useForm } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Termination } from '@gusto/embedded-api-v-2025-11-15/models/components/termination'\nimport type { PayrollOption } from '../types'\nimport type { TerminateEmployeeFormData } from './TerminateEmployee'\nimport { Flex, ActionsLayout, DatePickerField, RadioGroupField } from '@/components/Common'\nimport { Form as HtmlForm } from '@/components/Common/Form'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useI18n } from '@/i18n'\n\ninterface TerminateEmployeePresentationProps {\n  employeeName: string\n  existingTermination?: Termination\n  onSubmit: (data: TerminateEmployeeFormData) => void\n  onCancel: () => void\n  isLoading: boolean\n}\n\nconst terminateEmployeeSchema = z.object({\n  lastDayOfWork: z.date({ error: 'validation.lastDayRequired' }),\n  payrollOption: z.enum(['dismissalPayroll', 'regularPayroll', 'anotherWay'], {\n    error: 'validation.payrollOptionRequired',\n  }),\n})\n\n/** @internal */\nexport function TerminateEmployeePresentation({\n  employeeName,\n  existingTermination,\n  onSubmit,\n  onCancel,\n  isLoading,\n}: TerminateEmployeePresentationProps) {\n  const { Alert, Heading, Text, Button } = useComponentContext()\n  useI18n('Employee.Terminations.TerminateEmployee')\n  const { t } = useTranslation('Employee.Terminations.TerminateEmployee')\n\n  const getPayrollOptionFromTermination = (termination: Termination): PayrollOption => {\n    if (termination.runTerminationPayroll === true) {\n      return 'dismissalPayroll'\n    }\n    return 'regularPayroll'\n  }\n\n  const initialValues: Partial<TerminateEmployeeFormData> = {\n    lastDayOfWork: existingTermination?.effectiveDate\n      ? new Date(existingTermination.effectiveDate)\n      : undefined,\n    payrollOption: existingTermination\n      ? getPayrollOptionFromTermination(existingTermination)\n      : 'dismissalPayroll',\n  }\n  const formMethods = useForm<TerminateEmployeeFormData>({\n    resolver: zodResolver(terminateEmployeeSchema),\n    defaultValues: initialValues,\n  })\n\n  const selectedPayrollOption = formMethods.watch('payrollOption')\n\n  const payrollOptions = [\n    {\n      value: 'dismissalPayroll' as const,\n      label: t('form.payrollOption.options.dismissalPayroll.label'),\n      description: t('form.payrollOption.options.dismissalPayroll.description'),\n    },\n    {\n      value: 'regularPayroll' as const,\n      label: t('form.payrollOption.options.regularPayroll.label'),\n      description: t('form.payrollOption.options.regularPayroll.description'),\n    },\n    {\n      value: 'anotherWay' as const,\n      label: t('form.payrollOption.options.anotherWay.label'),\n      description: t('form.payrollOption.options.anotherWay.description'),\n    },\n  ]\n\n  return (\n    <FormProvider {...formMethods}>\n      <HtmlForm onSubmit={formMethods.handleSubmit(onSubmit)}>\n        <Flex flexDirection=\"column\" gap={24}>\n          <Flex flexDirection=\"column\" gap={4}>\n            <Heading as=\"h2\">{t('title', { employeeName })}</Heading>\n            <Text variant=\"supporting\">{t('subtitle')}</Text>\n          </Flex>\n\n          <Flex flexDirection=\"column\" gap={24}>\n            <DatePickerField\n              name=\"lastDayOfWork\"\n              label={t('form.lastDayOfEmployment.label')}\n              description={t('form.lastDayOfEmployment.description')}\n              isRequired\n              errorMessage={t('validation.lastDayRequired')}\n            />\n\n            <RadioGroupField<PayrollOption>\n              name=\"payrollOption\"\n              label={t('form.payrollOption.label')}\n              description={t('form.payrollOption.description')}\n              options={payrollOptions}\n              isRequired\n              errorMessage={t('validation.payrollOptionRequired')}\n            />\n            <Alert status=\"warning\" label={t(`alert.${selectedPayrollOption}.label`)}>\n              <Text>{t(`alert.${selectedPayrollOption}.text`, { employeeName })}</Text>\n            </Alert>\n          </Flex>\n\n          <ActionsLayout>\n            <Button variant=\"secondary\" onClick={onCancel} isDisabled={isLoading}>\n              {t('actions.cancel')}\n            </Button>\n            <Button type=\"submit\" variant=\"primary\" isLoading={isLoading}>\n              {t('actions.submit')}\n            </Button>\n          </ActionsLayout>\n        </Flex>\n      </HtmlForm>\n    </FormProvider>\n  )\n}\n"],"names":["terminateEmployeeSchema","z","TerminateEmployeePresentation","employeeName","existingTermination","onSubmit","onCancel","isLoading","Alert","Heading","Text","Button","useComponentContext","useI18n","t","useTranslation","getPayrollOptionFromTermination","termination","initialValues","formMethods","useForm","zodResolver","selectedPayrollOption","payrollOptions","FormProvider","jsx","HtmlForm","jsxs","Flex","DatePickerField","RadioGroupField","ActionsLayout"],"mappings":"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"}
+{"version":3,"file":"TerminateEmployeePresentation.js","sources":["../../../../../src/components/Employee/Terminations/TerminateEmployee/TerminateEmployeePresentation.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport z from 'zod'\nimport { FormProvider, useForm } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Termination } from '@gusto/embedded-api-v-2026-02-01/models/components/termination'\nimport type { PayrollOption } from '../types'\nimport type { TerminateEmployeeFormData } from './TerminateEmployee'\nimport { Flex, ActionsLayout, DatePickerField, RadioGroupField } from '@/components/Common'\nimport { Form as HtmlForm } from '@/components/Common/Form'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useI18n } from '@/i18n'\n\ninterface TerminateEmployeePresentationProps {\n  employeeName: string\n  existingTermination?: Termination\n  onSubmit: (data: TerminateEmployeeFormData) => void\n  onCancel: () => void\n  isLoading: boolean\n}\n\nconst terminateEmployeeSchema = z.object({\n  lastDayOfWork: z.date({ error: 'validation.lastDayRequired' }),\n  payrollOption: z.enum(['dismissalPayroll', 'regularPayroll', 'anotherWay'], {\n    error: 'validation.payrollOptionRequired',\n  }),\n})\n\n/** @internal */\nexport function TerminateEmployeePresentation({\n  employeeName,\n  existingTermination,\n  onSubmit,\n  onCancel,\n  isLoading,\n}: TerminateEmployeePresentationProps) {\n  const { Alert, Heading, Text, Button } = useComponentContext()\n  useI18n('Employee.Terminations.TerminateEmployee')\n  const { t } = useTranslation('Employee.Terminations.TerminateEmployee')\n\n  const getPayrollOptionFromTermination = (termination: Termination): PayrollOption => {\n    if (termination.runTerminationPayroll === true) {\n      return 'dismissalPayroll'\n    }\n    return 'regularPayroll'\n  }\n\n  const initialValues: Partial<TerminateEmployeeFormData> = {\n    lastDayOfWork: existingTermination?.effectiveDate\n      ? new Date(existingTermination.effectiveDate)\n      : undefined,\n    payrollOption: existingTermination\n      ? getPayrollOptionFromTermination(existingTermination)\n      : 'dismissalPayroll',\n  }\n  const formMethods = useForm<TerminateEmployeeFormData>({\n    resolver: zodResolver(terminateEmployeeSchema),\n    defaultValues: initialValues,\n  })\n\n  const selectedPayrollOption = formMethods.watch('payrollOption')\n\n  const payrollOptions = [\n    {\n      value: 'dismissalPayroll' as const,\n      label: t('form.payrollOption.options.dismissalPayroll.label'),\n      description: t('form.payrollOption.options.dismissalPayroll.description'),\n    },\n    {\n      value: 'regularPayroll' as const,\n      label: t('form.payrollOption.options.regularPayroll.label'),\n      description: t('form.payrollOption.options.regularPayroll.description'),\n    },\n    {\n      value: 'anotherWay' as const,\n      label: t('form.payrollOption.options.anotherWay.label'),\n      description: t('form.payrollOption.options.anotherWay.description'),\n    },\n  ]\n\n  return (\n    <FormProvider {...formMethods}>\n      <HtmlForm onSubmit={formMethods.handleSubmit(onSubmit)}>\n        <Flex flexDirection=\"column\" gap={24}>\n          <Flex flexDirection=\"column\" gap={4}>\n            <Heading as=\"h2\">{t('title', { employeeName })}</Heading>\n            <Text variant=\"supporting\">{t('subtitle')}</Text>\n          </Flex>\n\n          <Flex flexDirection=\"column\" gap={24}>\n            <DatePickerField\n              name=\"lastDayOfWork\"\n              label={t('form.lastDayOfEmployment.label')}\n              description={t('form.lastDayOfEmployment.description')}\n              isRequired\n              errorMessage={t('validation.lastDayRequired')}\n            />\n\n            <RadioGroupField<PayrollOption>\n              name=\"payrollOption\"\n              label={t('form.payrollOption.label')}\n              description={t('form.payrollOption.description')}\n              options={payrollOptions}\n              isRequired\n              errorMessage={t('validation.payrollOptionRequired')}\n            />\n            <Alert status=\"warning\" label={t(`alert.${selectedPayrollOption}.label`)}>\n              <Text>{t(`alert.${selectedPayrollOption}.text`, { employeeName })}</Text>\n            </Alert>\n          </Flex>\n\n          <ActionsLayout>\n            <Button variant=\"secondary\" onClick={onCancel} isDisabled={isLoading}>\n              {t('actions.cancel')}\n            </Button>\n            <Button type=\"submit\" variant=\"primary\" isLoading={isLoading}>\n              {t('actions.submit')}\n            </Button>\n          </ActionsLayout>\n        </Flex>\n      </HtmlForm>\n    </FormProvider>\n  )\n}\n"],"names":["terminateEmployeeSchema","z","TerminateEmployeePresentation","employeeName","existingTermination","onSubmit","onCancel","isLoading","Alert","Heading","Text","Button","useComponentContext","useI18n","t","useTranslation","getPayrollOptionFromTermination","termination","initialValues","formMethods","useForm","zodResolver","selectedPayrollOption","payrollOptions","FormProvider","jsx","HtmlForm","jsxs","Flex","DatePickerField","RadioGroupField","ActionsLayout"],"mappings":"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"}

package/dist/components/Employee/Terminations/TerminationFlow/TerminationFlow.d.ts

@@ -3,7 +3,11 @@ import { TerminationFlowProps } from './TerminationFlowComponents';
  * Guided flow to terminate an employee and arrange their final paycheck.
  *
  * @remarks
- * Provides a complete experience for terminating an employee — guides the user through selecting a termination date, choosing how to process final payroll, reviewing termination details, and managing the offboarding process. Drives a multi-step flow with breadcrumb navigation between the termination form, the summary, and the dismissal payroll flow (when the partner selects the dismissal payroll option).
+ * This is the flow for ending employment. It sets the termination date, decides how the final
+ * paycheck is handled, and can launch the dismissal payroll as one option. To run the final payroll
+ * on its own for an already-terminated employee, use {@link Payroll.DismissalFlow} directly.
+ *
+ * Provides a complete experience for terminating an employee — guides the user through selecting a termination date, choosing how to process final payroll, reviewing termination details, and managing the offboarding process. Drives a multi-step flow with breadcrumb navigation between the termination form, the summary, and the dismissal payroll flow (when the dismissal payroll option is selected).
  *
  * On mount, the flow detects existing terminations: if an active termination exists, the form is pre-populated for editing; if the employee is already terminated, the user is routed to the summary view.
  *
@@ -36,7 +40,7 @@ import { TerminationFlowProps } from './TerminationFlowComponents';
  * @param props - See {@link TerminationFlowProps}.
  * @returns The multi-step termination workflow.
  * @public
- * @group Flow Components
+ * @group Flow components
  *
  * @example
  * ```tsx title="App.tsx"