@gusto/embedded-react-sdk 0.47.1 → 0.48.0

package/dist/components/Employee/Documents/shared/useSignEmployeeForm/fields.js

@@ -1,8 +1,8 @@
 import { jsx as e } from "react/jsx-runtime";
 import { CheckboxHookField as t } from "../../../../../partner-hook-utils/form/fields/CheckboxHookField.js";
 import { TextInputHookField as n } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
-import { SelectHookField as a } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
 import { RadioGroupHookField as p } from "../../../../../partner-hook-utils/form/fields/RadioGroupHookField.js";
+import { SelectHookField as a } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
 function c(r) {
   return /* @__PURE__ */ e(n, { ...r, name: "signature" });
 }

package/dist/components/Employee/Documents/shared/useSignEmployeeForm/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/Documents/shared/useSignEmployeeForm/fields.tsx"],"sourcesContent":["import type { SignEmployeeFormErrorCodes } from './signEmployeeFormSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { CheckboxHookFieldProps } from '@/partner-hook-utils/form/fields/CheckboxHookField'\nimport type { RadioGroupHookFieldProps } from '@/partner-hook-utils/form/fields/RadioGroupHookField'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport {\n  TextInputHookField,\n  CheckboxHookField,\n  RadioGroupHookField,\n  SelectHookField,\n} from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n// ── Validation types ──────────────────────────────────────────────────\n\nexport type RequiredValidation = typeof SignEmployeeFormErrorCodes.REQUIRED\n\n// ── Shared preparer field prop types ──────────────────────────────────\n\nexport type PreparerTextFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\nexport type PreparerSelectFieldProps = HookFieldProps<\n  SelectHookFieldProps<RequiredValidation, string>\n>\nexport type PreparerCheckboxFieldProps = HookFieldProps<CheckboxHookFieldProps<RequiredValidation>>\n\n// ── Base fields (always present) ──────────────────────────────────────\n\nexport type SignatureFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\nexport function SignatureField(props: SignatureFieldProps) {\n  return <TextInputHookField {...props} name=\"signature\" />\n}\n\nexport type ConfirmSignatureFieldProps = HookFieldProps<CheckboxHookFieldProps<RequiredValidation>>\n\nexport function ConfirmSignatureField(props: ConfirmSignatureFieldProps) {\n  return <CheckboxHookField {...props} name=\"confirmSignature\" />\n}\n\n// ── I-9 fields ────────────────────────────────────────────────────────\n\nexport type UsedPreparerFieldProps = HookFieldProps<RadioGroupHookFieldProps<RequiredValidation>>\n\nexport function UsedPreparerField(props: UsedPreparerFieldProps) {\n  return <RadioGroupHookField {...props} name=\"usedPreparer\" />\n}\n\n// ── Preparer 1 fields ─────────────────────────────────────────────────\n\nexport function Preparer1FirstName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerFirstName\" />\n}\nexport function Preparer1LastName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerLastName\" />\n}\nexport function Preparer1Street1(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerStreet1\" />\n}\nexport function Preparer1Street2(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerStreet2\" />\n}\nexport function Preparer1City(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerCity\" />\n}\nexport function Preparer1State(props: PreparerSelectFieldProps) {\n  return <SelectHookField {...props} name=\"preparerState\" />\n}\nexport function Preparer1Zip(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerZip\" />\n}\nexport function Preparer1Signature(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerSignature\" />\n}\nexport function Preparer1ConfirmSignature(props: PreparerCheckboxFieldProps) {\n  return <CheckboxHookField {...props} name=\"preparerAgree\" />\n}\n\n// ── Preparer 2 fields ─────────────────────────────────────────────────\n\nexport function Preparer2FirstName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2FirstName\" />\n}\nexport function Preparer2LastName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2LastName\" />\n}\nexport function Preparer2Street1(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2Street1\" />\n}\nexport function Preparer2Street2(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2Street2\" />\n}\nexport function Preparer2City(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2City\" />\n}\nexport function Preparer2State(props: PreparerSelectFieldProps) {\n  return <SelectHookField {...props} name=\"preparer2State\" />\n}\nexport function Preparer2Zip(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2Zip\" />\n}\nexport function Preparer2Signature(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2Signature\" />\n}\nexport function Preparer2ConfirmSignature(props: PreparerCheckboxFieldProps) {\n  return <CheckboxHookField {...props} name=\"preparer2Agree\" />\n}\n\n// ── Preparer 3 fields ─────────────────────────────────────────────────\n\nexport function Preparer3FirstName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3FirstName\" />\n}\nexport function Preparer3LastName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3LastName\" />\n}\nexport function Preparer3Street1(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3Street1\" />\n}\nexport function Preparer3Street2(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3Street2\" />\n}\nexport function Preparer3City(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3City\" />\n}\nexport function Preparer3State(props: PreparerSelectFieldProps) {\n  return <SelectHookField {...props} name=\"preparer3State\" />\n}\nexport function Preparer3Zip(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3Zip\" />\n}\nexport function Preparer3Signature(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3Signature\" />\n}\nexport function Preparer3ConfirmSignature(props: PreparerCheckboxFieldProps) {\n  return <CheckboxHookField {...props} name=\"preparer3Agree\" />\n}\n\n// ── Preparer 4 fields ─────────────────────────────────────────────────\n\nexport function Preparer4FirstName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4FirstName\" />\n}\nexport function Preparer4LastName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4LastName\" />\n}\nexport function Preparer4Street1(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4Street1\" />\n}\nexport function Preparer4Street2(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4Street2\" />\n}\nexport function Preparer4City(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4City\" />\n}\nexport function Preparer4State(props: PreparerSelectFieldProps) {\n  return <SelectHookField {...props} name=\"preparer4State\" />\n}\nexport function Preparer4Zip(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4Zip\" />\n}\nexport function Preparer4Signature(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4Signature\" />\n}\nexport function Preparer4ConfirmSignature(props: PreparerCheckboxFieldProps) {\n  return <CheckboxHookField {...props} name=\"preparer4Agree\" />\n}\n"],"names":["SignatureField","props","jsx","TextInputHookField","ConfirmSignatureField","CheckboxHookField","UsedPreparerField","RadioGroupHookField","Preparer1FirstName","Preparer1LastName","Preparer1Street1","Preparer1Street2","Preparer1City","Preparer1State","SelectHookField","Preparer1Zip","Preparer1Signature","Preparer1ConfirmSignature","Preparer2FirstName","Preparer2LastName","Preparer2Street1","Preparer2Street2","Preparer2City","Preparer2State","Preparer2Zip","Preparer2Signature","Preparer2ConfirmSignature","Preparer3FirstName","Preparer3LastName","Preparer3Street1","Preparer3Street2","Preparer3City","Preparer3State","Preparer3Zip","Preparer3Signature","Preparer3ConfirmSignature","Preparer4FirstName","Preparer4LastName","Preparer4Street1","Preparer4Street2","Preparer4City","Preparer4State","Preparer4Zip","Preparer4Signature","Preparer4ConfirmSignature"],"mappings":"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"}
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/Documents/shared/useSignEmployeeForm/fields.tsx"],"sourcesContent":["import type { SignEmployeeFormErrorCodes } from './signEmployeeFormSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { CheckboxHookFieldProps } from '@/partner-hook-utils/form/fields/CheckboxHookField'\nimport type { RadioGroupHookFieldProps } from '@/partner-hook-utils/form/fields/RadioGroupHookField'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport {\n  TextInputHookField,\n  CheckboxHookField,\n  RadioGroupHookField,\n  SelectHookField,\n} from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n// ── Validation types ──────────────────────────────────────────────────\n\n/**\n * The required-field error code emitted by every field of {@link useSignEmployeeForm}.\n *\n * @remarks\n * Use this as the `validationMessages` key for any sign-employee-form field.\n * See {@link SignEmployeeFormErrorCodes}.\n *\n * @public\n */\nexport type RequiredValidation = typeof SignEmployeeFormErrorCodes.REQUIRED\n\n// ── Shared preparer field prop types ──────────────────────────────────\n\n/**\n * Props accepted by the text-input preparer fields of {@link useSignEmployeeForm} (name, address, signature).\n *\n * @public\n */\nexport type PreparerTextFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n/**\n * Props accepted by the state-select preparer field of {@link useSignEmployeeForm}.\n *\n * @public\n */\nexport type PreparerSelectFieldProps = HookFieldProps<\n  SelectHookFieldProps<RequiredValidation, string>\n>\n/**\n * Props accepted by the confirmation checkbox preparer field of {@link useSignEmployeeForm}.\n *\n * @public\n */\nexport type PreparerCheckboxFieldProps = HookFieldProps<CheckboxHookFieldProps<RequiredValidation>>\n\n// ── Base fields (always present) ──────────────────────────────────────\n\n/**\n * Props accepted by {@link useSignEmployeeForm}'s `Fields.Signature` component.\n *\n * @public\n */\nexport type SignatureFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Text input bound to the `signature` field of {@link useSignEmployeeForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Signature`. The employee types\n * their full legal name; required.\n *\n * @param props - {@link SignatureFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `signature`.\n * @public\n */\nexport function SignatureField(props: SignatureFieldProps) {\n  return <TextInputHookField {...props} name=\"signature\" />\n}\n\n/**\n * Props accepted by {@link useSignEmployeeForm}'s `Fields.ConfirmSignature` component.\n *\n * @public\n */\nexport type ConfirmSignatureFieldProps = HookFieldProps<CheckboxHookFieldProps<RequiredValidation>>\n\n/**\n * Checkbox bound to the `confirmSignature` field of {@link useSignEmployeeForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.ConfirmSignature`. Captures the\n * employee's electronic-signature consent; must be checked to submit.\n *\n * @param props - {@link ConfirmSignatureFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered checkbox bound to `confirmSignature`.\n * @public\n */\nexport function ConfirmSignatureField(props: ConfirmSignatureFieldProps) {\n  return <CheckboxHookField {...props} name=\"confirmSignature\" />\n}\n\n// ── I-9 fields ────────────────────────────────────────────────────────\n\n/**\n * Props accepted by {@link useSignEmployeeForm}'s `Fields.UsedPreparer` component.\n *\n * @public\n */\nexport type UsedPreparerFieldProps = HookFieldProps<RadioGroupHookFieldProps<RequiredValidation>>\n\n/**\n * Radio group bound to the `usedPreparer` field of {@link useSignEmployeeForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.UsedPreparer` only when the\n * form being signed is an I-9; `undefined` otherwise. Selecting `'yes'`\n * automatically reveals the first preparer field group; switching back to\n * `'no'` removes all preparer sections.\n *\n * @param props - {@link UsedPreparerFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered radio group bound to `usedPreparer`.\n * @public\n */\nexport function UsedPreparerField(props: UsedPreparerFieldProps) {\n  return <RadioGroupHookField {...props} name=\"usedPreparer\" />\n}\n\n// ── Preparer 1 fields ─────────────────────────────────────────────────\n\n/**\n * Text input bound to the first preparer's first name.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparerFirstName`.\n * @public\n */\nexport function Preparer1FirstName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerFirstName\" />\n}\n/**\n * Text input bound to the first preparer's last name.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparerLastName`.\n * @public\n */\nexport function Preparer1LastName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerLastName\" />\n}\n/**\n * Text input bound to the first preparer's street address line 1.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparerStreet1`.\n * @public\n */\nexport function Preparer1Street1(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerStreet1\" />\n}\n/**\n * Text input bound to the first preparer's street address line 2 (optional).\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparerStreet2`.\n * @public\n */\nexport function Preparer1Street2(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerStreet2\" />\n}\n/**\n * Text input bound to the first preparer's city.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparerCity`.\n * @public\n */\nexport function Preparer1City(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerCity\" />\n}\n/**\n * Select bound to the first preparer's state. Options are US state abbreviations.\n *\n * @param props - {@link PreparerSelectFieldProps}.\n * @returns The rendered select bound to `preparerState`.\n * @public\n */\nexport function Preparer1State(props: PreparerSelectFieldProps) {\n  return <SelectHookField {...props} name=\"preparerState\" />\n}\n/**\n * Text input bound to the first preparer's ZIP code.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparerZip`.\n * @public\n */\nexport function Preparer1Zip(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerZip\" />\n}\n/**\n * Text input bound to the first preparer's typed signature.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparerSignature`.\n * @public\n */\nexport function Preparer1Signature(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparerSignature\" />\n}\n/**\n * Checkbox bound to the first preparer's electronic-signature consent.\n *\n * @param props - {@link PreparerCheckboxFieldProps}.\n * @returns The rendered checkbox bound to `preparerAgree`.\n * @public\n */\nexport function Preparer1ConfirmSignature(props: PreparerCheckboxFieldProps) {\n  return <CheckboxHookField {...props} name=\"preparerAgree\" />\n}\n\n// ── Preparer 2 fields ─────────────────────────────────────────────────\n\n/**\n * Text input bound to the second preparer's first name.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer2FirstName`.\n * @public\n */\nexport function Preparer2FirstName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2FirstName\" />\n}\n/**\n * Text input bound to the second preparer's last name.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer2LastName`.\n * @public\n */\nexport function Preparer2LastName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2LastName\" />\n}\n/**\n * Text input bound to the second preparer's street address line 1.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer2Street1`.\n * @public\n */\nexport function Preparer2Street1(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2Street1\" />\n}\n/**\n * Text input bound to the second preparer's street address line 2 (optional).\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer2Street2`.\n * @public\n */\nexport function Preparer2Street2(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2Street2\" />\n}\n/**\n * Text input bound to the second preparer's city.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer2City`.\n * @public\n */\nexport function Preparer2City(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2City\" />\n}\n/**\n * Select bound to the second preparer's state. Options are US state abbreviations.\n *\n * @param props - {@link PreparerSelectFieldProps}.\n * @returns The rendered select bound to `preparer2State`.\n * @public\n */\nexport function Preparer2State(props: PreparerSelectFieldProps) {\n  return <SelectHookField {...props} name=\"preparer2State\" />\n}\n/**\n * Text input bound to the second preparer's ZIP code.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer2Zip`.\n * @public\n */\nexport function Preparer2Zip(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2Zip\" />\n}\n/**\n * Text input bound to the second preparer's typed signature.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer2Signature`.\n * @public\n */\nexport function Preparer2Signature(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer2Signature\" />\n}\n/**\n * Checkbox bound to the second preparer's electronic-signature consent.\n *\n * @param props - {@link PreparerCheckboxFieldProps}.\n * @returns The rendered checkbox bound to `preparer2Agree`.\n * @public\n */\nexport function Preparer2ConfirmSignature(props: PreparerCheckboxFieldProps) {\n  return <CheckboxHookField {...props} name=\"preparer2Agree\" />\n}\n\n// ── Preparer 3 fields ─────────────────────────────────────────────────\n\n/**\n * Text input bound to the third preparer's first name.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer3FirstName`.\n * @public\n */\nexport function Preparer3FirstName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3FirstName\" />\n}\n/**\n * Text input bound to the third preparer's last name.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer3LastName`.\n * @public\n */\nexport function Preparer3LastName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3LastName\" />\n}\n/**\n * Text input bound to the third preparer's street address line 1.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer3Street1`.\n * @public\n */\nexport function Preparer3Street1(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3Street1\" />\n}\n/**\n * Text input bound to the third preparer's street address line 2 (optional).\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer3Street2`.\n * @public\n */\nexport function Preparer3Street2(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3Street2\" />\n}\n/**\n * Text input bound to the third preparer's city.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer3City`.\n * @public\n */\nexport function Preparer3City(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3City\" />\n}\n/**\n * Select bound to the third preparer's state. Options are US state abbreviations.\n *\n * @param props - {@link PreparerSelectFieldProps}.\n * @returns The rendered select bound to `preparer3State`.\n * @public\n */\nexport function Preparer3State(props: PreparerSelectFieldProps) {\n  return <SelectHookField {...props} name=\"preparer3State\" />\n}\n/**\n * Text input bound to the third preparer's ZIP code.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer3Zip`.\n * @public\n */\nexport function Preparer3Zip(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3Zip\" />\n}\n/**\n * Text input bound to the third preparer's typed signature.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer3Signature`.\n * @public\n */\nexport function Preparer3Signature(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer3Signature\" />\n}\n/**\n * Checkbox bound to the third preparer's electronic-signature consent.\n *\n * @param props - {@link PreparerCheckboxFieldProps}.\n * @returns The rendered checkbox bound to `preparer3Agree`.\n * @public\n */\nexport function Preparer3ConfirmSignature(props: PreparerCheckboxFieldProps) {\n  return <CheckboxHookField {...props} name=\"preparer3Agree\" />\n}\n\n// ── Preparer 4 fields ─────────────────────────────────────────────────\n\n/**\n * Text input bound to the fourth preparer's first name.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer4FirstName`.\n * @public\n */\nexport function Preparer4FirstName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4FirstName\" />\n}\n/**\n * Text input bound to the fourth preparer's last name.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer4LastName`.\n * @public\n */\nexport function Preparer4LastName(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4LastName\" />\n}\n/**\n * Text input bound to the fourth preparer's street address line 1.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer4Street1`.\n * @public\n */\nexport function Preparer4Street1(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4Street1\" />\n}\n/**\n * Text input bound to the fourth preparer's street address line 2 (optional).\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer4Street2`.\n * @public\n */\nexport function Preparer4Street2(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4Street2\" />\n}\n/**\n * Text input bound to the fourth preparer's city.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer4City`.\n * @public\n */\nexport function Preparer4City(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4City\" />\n}\n/**\n * Select bound to the fourth preparer's state. Options are US state abbreviations.\n *\n * @param props - {@link PreparerSelectFieldProps}.\n * @returns The rendered select bound to `preparer4State`.\n * @public\n */\nexport function Preparer4State(props: PreparerSelectFieldProps) {\n  return <SelectHookField {...props} name=\"preparer4State\" />\n}\n/**\n * Text input bound to the fourth preparer's ZIP code.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer4Zip`.\n * @public\n */\nexport function Preparer4Zip(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4Zip\" />\n}\n/**\n * Text input bound to the fourth preparer's typed signature.\n *\n * @param props - {@link PreparerTextFieldProps}.\n * @returns The rendered text input bound to `preparer4Signature`.\n * @public\n */\nexport function Preparer4Signature(props: PreparerTextFieldProps) {\n  return <TextInputHookField {...props} name=\"preparer4Signature\" />\n}\n/**\n * Checkbox bound to the fourth preparer's electronic-signature consent.\n *\n * @param props - {@link PreparerCheckboxFieldProps}.\n * @returns The rendered checkbox bound to `preparer4Agree`.\n * @public\n */\nexport function Preparer4ConfirmSignature(props: PreparerCheckboxFieldProps) {\n  return <CheckboxHookField {...props} name=\"preparer4Agree\" />\n}\n"],"names":["SignatureField","props","jsx","TextInputHookField","ConfirmSignatureField","CheckboxHookField","UsedPreparerField","RadioGroupHookField","Preparer1FirstName","Preparer1LastName","Preparer1Street1","Preparer1Street2","Preparer1City","Preparer1State","SelectHookField","Preparer1Zip","Preparer1Signature","Preparer1ConfirmSignature","Preparer2FirstName","Preparer2LastName","Preparer2Street1","Preparer2Street2","Preparer2City","Preparer2State","Preparer2Zip","Preparer2Signature","Preparer2ConfirmSignature","Preparer3FirstName","Preparer3LastName","Preparer3Street1","Preparer3Street2","Preparer3City","Preparer3State","Preparer3Zip","Preparer3Signature","Preparer3ConfirmSignature","Preparer4FirstName","Preparer4LastName","Preparer4Street1","Preparer4Street2","Preparer4City","Preparer4State","Preparer4Zip","Preparer4Signature","Preparer4ConfirmSignature"],"mappings":"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"}

package/dist/components/Employee/Documents/shared/useSignEmployeeForm/index.d.ts

@@ -2,4 +2,5 @@ import "./types/i18next.d.ts"
 export { useSignEmployeeForm } from './useSignEmployeeForm';
 export type { UseSignEmployeeFormProps, UseSignEmployeeFormResult, UseSignEmployeeFormReady, SignEmployeeFormFieldComponents, SignEmployeeFormFieldsMetadata, SignEmployeeFormFields, PreparerFieldGroup, } from './useSignEmployeeForm';
 export { createSignEmployeeFormSchema, SignEmployeeFormErrorCodes, MAX_PREPARERS, PREPARER_FIELDS_BY_INDEX, preparerFieldName, type SignEmployeeFormErrorCode, type SignEmployeeFormData, type SignEmployeeFormOutputs, type SignEmployeeFormField, type PreparerIndex, type PreparerFieldSuffix, } from './signEmployeeFormSchema';
-export type { RequiredValidation as SignEmployeeFormRequiredValidation, SignatureFieldProps, ConfirmSignatureFieldProps, UsedPreparerFieldProps, PreparerTextFieldProps, PreparerCheckboxFieldProps, } from './fields';
+export { SignatureField, ConfirmSignatureField, UsedPreparerField } from './fields';
+export type { RequiredValidation as SignEmployeeFormRequiredValidation, SignatureFieldProps, ConfirmSignatureFieldProps, UsedPreparerFieldProps, PreparerTextFieldProps, PreparerSelectFieldProps, PreparerCheckboxFieldProps, } from './fields';

package/dist/components/Employee/Documents/shared/useSignEmployeeForm/signEmployeeFormSchema.d.ts

@@ -1,12 +1,50 @@
 import { z } from 'zod';
+/**
+ * Validation error codes emitted by the I-9 sign-employee form schema. Map
+ * these codes to localized copy in `validationMessages` when composing the
+ * hook.
+ *
+ * @public
+ */
 export declare const SignEmployeeFormErrorCodes: {
     readonly REQUIRED: "REQUIRED";
 };
+/**
+ * Union of validation error code strings emitted by the I-9 sign-employee
+ * form schema.
+ *
+ * @public
+ */
 export type SignEmployeeFormErrorCode = (typeof SignEmployeeFormErrorCodes)[keyof typeof SignEmployeeFormErrorCodes];
+/**
+ * Maximum number of I-9 preparers and translators the form supports.
+ *
+ * @public
+ */
 export declare const MAX_PREPARERS = 4;
+/**
+ * One-based preparer index used to reference preparer field groups (1–4).
+ *
+ * @public
+ */
 export type PreparerIndex = 1 | 2 | 3 | 4;
+/**
+ * Suffix segment of a preparer field name — the part that follows
+ * `preparer` (or `preparerN`) in the field key.
+ *
+ * @public
+ */
 export type PreparerFieldSuffix = 'FirstName' | 'LastName' | 'Street1' | 'Street2' | 'City' | 'State' | 'Zip' | 'Signature' | 'Agree';
+/** @internal */
 export declare function preparerFieldName(index: PreparerIndex, field: PreparerFieldSuffix): string;
+/**
+ * Per-preparer field name maps indexed by preparer position (0-based). Use
+ * these to look up the form field name for a given preparer slot — for
+ * example `PREPARERS_BY_INDEX[1].firstName` resolves to
+ * `'preparer2FirstName'`.
+ *
+ * @public
+ */
 export declare const PREPARERS_BY_INDEX: ({
     readonly firstName: "preparerFirstName";
     readonly lastName: "preparerLastName";
@@ -48,6 +86,12 @@ export declare const PREPARERS_BY_INDEX: ({
     readonly signature: "preparer4Signature";
     readonly agree: "preparer4Agree";
 })[];
+/**
+ * Flat list of preparer field names per preparer slot (0-based), useful for
+ * iterating every field that belongs to a single preparer.
+ *
+ * @public
+ */
 export declare const PREPARER_FIELDS_BY_INDEX: SignEmployeeFormField[][];
 declare const fieldValidators: {
     signature: z.ZodString;
@@ -93,15 +137,33 @@ declare const fieldValidators: {
     preparer4Signature: z.ZodString;
     preparer4Agree: z.ZodBoolean;
 };
+/**
+ * Field names accepted by the I-9 sign-employee form.
+ *
+ * @public
+ */
 export type SignEmployeeFormField = keyof typeof fieldValidators;
+/**
+ * Shape of the values managed by the I-9 sign-employee form.
+ *
+ * @public
+ */
 export type SignEmployeeFormData = {
     [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>;
 };
+/**
+ * Shape of the validated values produced by the I-9 sign-employee form on
+ * submit.
+ *
+ * @public
+ */
 export type SignEmployeeFormOutputs = SignEmployeeFormData;
+/** @internal */
 interface SignEmployeeFormSchemaOptions {
     isI9?: boolean;
     preparerCount?: number;
 }
+/** @internal */
 export declare function createSignEmployeeFormSchema(options?: SignEmployeeFormSchemaOptions): import('../../../../../partner-hook-utils/form/buildFormSchema').BuildFormSchemaResult<{
     signature: z.ZodString;
     confirmSignature: z.ZodBoolean;

package/dist/components/Employee/Documents/shared/useSignEmployeeForm/signEmployeeFormSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"signEmployeeFormSchema.js","sources":["../../../../../../src/components/Employee/Documents/shared/useSignEmployeeForm/signEmployeeFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type RequiredFieldConfig,\n} from '@/partner-hook-utils/form/buildFormSchema'\n\n// ── Error codes ────────────────────────────────────────────────────────\n\nexport const SignEmployeeFormErrorCodes = {\n  REQUIRED: 'REQUIRED',\n} as const\n\nexport type SignEmployeeFormErrorCode =\n  (typeof SignEmployeeFormErrorCodes)[keyof typeof SignEmployeeFormErrorCodes]\n\n// ── Preparer naming helpers ────────────────────────────────────────────\n\nexport const MAX_PREPARERS = 4\n\nexport type PreparerIndex = 1 | 2 | 3 | 4\n\nexport type PreparerFieldSuffix =\n  | 'FirstName'\n  | 'LastName'\n  | 'Street1'\n  | 'Street2'\n  | 'City'\n  | 'State'\n  | 'Zip'\n  | 'Signature'\n  | 'Agree'\n\nexport function preparerFieldName(index: PreparerIndex, field: PreparerFieldSuffix): string {\n  return index === 1 ? `preparer${field}` : `preparer${index}${field}`\n}\n\n// ── Preparer field name constants ──────────────────────────────────────\n\ntype PreparerFieldMap = Record<\n  | 'firstName'\n  | 'lastName'\n  | 'street1'\n  | 'street2'\n  | 'city'\n  | 'state'\n  | 'zip'\n  | 'signature'\n  | 'agree',\n  SignEmployeeFormField\n>\n\nconst PREPARER_1 = {\n  firstName: 'preparerFirstName',\n  lastName: 'preparerLastName',\n  street1: 'preparerStreet1',\n  street2: 'preparerStreet2',\n  city: 'preparerCity',\n  state: 'preparerState',\n  zip: 'preparerZip',\n  signature: 'preparerSignature',\n  agree: 'preparerAgree',\n} as const\n\nconst PREPARER_2 = {\n  firstName: 'preparer2FirstName',\n  lastName: 'preparer2LastName',\n  street1: 'preparer2Street1',\n  street2: 'preparer2Street2',\n  city: 'preparer2City',\n  state: 'preparer2State',\n  zip: 'preparer2Zip',\n  signature: 'preparer2Signature',\n  agree: 'preparer2Agree',\n} as const\n\nconst PREPARER_3 = {\n  firstName: 'preparer3FirstName',\n  lastName: 'preparer3LastName',\n  street1: 'preparer3Street1',\n  street2: 'preparer3Street2',\n  city: 'preparer3City',\n  state: 'preparer3State',\n  zip: 'preparer3Zip',\n  signature: 'preparer3Signature',\n  agree: 'preparer3Agree',\n} as const\n\nconst PREPARER_4 = {\n  firstName: 'preparer4FirstName',\n  lastName: 'preparer4LastName',\n  street1: 'preparer4Street1',\n  street2: 'preparer4Street2',\n  city: 'preparer4City',\n  state: 'preparer4State',\n  zip: 'preparer4Zip',\n  signature: 'preparer4Signature',\n  agree: 'preparer4Agree',\n} as const\n\nexport const PREPARERS_BY_INDEX = [\n  PREPARER_1,\n  PREPARER_2,\n  PREPARER_3,\n  PREPARER_4,\n] satisfies PreparerFieldMap[]\n\n// ── Per-preparer field name lists (used for excludeFields) ──────────────\n\ntype ValuesOf<T> = T[keyof T]\n\nconst PREPARER_1_FIELDS: SignEmployeeFormField[] = Object.values(PREPARER_1) as ValuesOf<\n  typeof PREPARER_1\n>[]\nconst PREPARER_2_FIELDS: SignEmployeeFormField[] = Object.values(PREPARER_2) as ValuesOf<\n  typeof PREPARER_2\n>[]\nconst PREPARER_3_FIELDS: SignEmployeeFormField[] = Object.values(PREPARER_3) as ValuesOf<\n  typeof PREPARER_3\n>[]\nconst PREPARER_4_FIELDS: SignEmployeeFormField[] = Object.values(PREPARER_4) as ValuesOf<\n  typeof PREPARER_4\n>[]\n\nexport const PREPARER_FIELDS_BY_INDEX: SignEmployeeFormField[][] = [\n  PREPARER_1_FIELDS,\n  PREPARER_2_FIELDS,\n  PREPARER_3_FIELDS,\n  PREPARER_4_FIELDS,\n]\n\nconst ALL_PREPARER_FIELDS = PREPARER_FIELDS_BY_INDEX.flat()\n\n// ── Field validators ───────────────────────────────────────────────────\n\nconst agreeValidator = z.boolean().refine(val => val, {\n  message: SignEmployeeFormErrorCodes.REQUIRED,\n})\n\nconst fieldValidators = {\n  signature: z.string(),\n  confirmSignature: agreeValidator,\n  usedPreparer: z.enum(['yes', 'no']),\n\n  // Preparer 1\n  [PREPARER_1.firstName]: z.string(),\n  [PREPARER_1.lastName]: z.string(),\n  [PREPARER_1.street1]: z.string(),\n  [PREPARER_1.street2]: z.string(),\n  [PREPARER_1.city]: z.string(),\n  [PREPARER_1.state]: z.string(),\n  [PREPARER_1.zip]: z.string(),\n  [PREPARER_1.signature]: z.string(),\n  [PREPARER_1.agree]: agreeValidator,\n\n  // Preparer 2\n  [PREPARER_2.firstName]: z.string(),\n  [PREPARER_2.lastName]: z.string(),\n  [PREPARER_2.street1]: z.string(),\n  [PREPARER_2.street2]: z.string(),\n  [PREPARER_2.city]: z.string(),\n  [PREPARER_2.state]: z.string(),\n  [PREPARER_2.zip]: z.string(),\n  [PREPARER_2.signature]: z.string(),\n  [PREPARER_2.agree]: agreeValidator,\n\n  // Preparer 3\n  [PREPARER_3.firstName]: z.string(),\n  [PREPARER_3.lastName]: z.string(),\n  [PREPARER_3.street1]: z.string(),\n  [PREPARER_3.street2]: z.string(),\n  [PREPARER_3.city]: z.string(),\n  [PREPARER_3.state]: z.string(),\n  [PREPARER_3.zip]: z.string(),\n  [PREPARER_3.signature]: z.string(),\n  [PREPARER_3.agree]: agreeValidator,\n\n  // Preparer 4\n  [PREPARER_4.firstName]: z.string(),\n  [PREPARER_4.lastName]: z.string(),\n  [PREPARER_4.street1]: z.string(),\n  [PREPARER_4.street2]: z.string(),\n  [PREPARER_4.city]: z.string(),\n  [PREPARER_4.state]: z.string(),\n  [PREPARER_4.zip]: z.string(),\n  [PREPARER_4.signature]: z.string(),\n  [PREPARER_4.agree]: agreeValidator,\n}\n\nexport type SignEmployeeFormField = keyof typeof fieldValidators\n\nexport type SignEmployeeFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\nexport type SignEmployeeFormOutputs = SignEmployeeFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n\nconst requiredFieldsConfig = {\n  [PREPARER_1.street2]: 'never',\n  [PREPARER_2.street2]: 'never',\n  [PREPARER_3.street2]: 'never',\n  [PREPARER_4.street2]: 'never',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\ninterface SignEmployeeFormSchemaOptions {\n  isI9?: boolean\n  preparerCount?: number\n}\n\nexport function createSignEmployeeFormSchema(options: SignEmployeeFormSchemaOptions = {}) {\n  const { isI9 = false, preparerCount = 0 } = options\n\n  const excludeFields: SignEmployeeFormField[] = []\n\n  if (!isI9) {\n    excludeFields.push('usedPreparer', ...ALL_PREPARER_FIELDS)\n  } else {\n    for (let index = 0; index < MAX_PREPARERS; index++) {\n      if (index + 1 > preparerCount) {\n        const preparerFields = PREPARER_FIELDS_BY_INDEX[index]\n        if (preparerFields) excludeFields.push(...preparerFields)\n      }\n    }\n  }\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: SignEmployeeFormErrorCodes.REQUIRED,\n    mode: 'create',\n    excludeFields,\n  })\n}\n"],"names":["SignEmployeeFormErrorCodes","MAX_PREPARERS","preparerFieldName","index","field","PREPARER_1","PREPARER_2","PREPARER_3","PREPARER_4","PREPARERS_BY_INDEX","PREPARER_1_FIELDS","PREPARER_2_FIELDS","PREPARER_3_FIELDS","PREPARER_4_FIELDS","PREPARER_FIELDS_BY_INDEX","ALL_PREPARER_FIELDS","agreeValidator","z","val","fieldValidators","requiredFieldsConfig","createSignEmployeeFormSchema","options","isI9","preparerCount","excludeFields","preparerFields","buildFormSchema"],"mappings":"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"}
+{"version":3,"file":"signEmployeeFormSchema.js","sources":["../../../../../../src/components/Employee/Documents/shared/useSignEmployeeForm/signEmployeeFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type RequiredFieldConfig,\n} from '@/partner-hook-utils/form/buildFormSchema'\n\n// ── Error codes ────────────────────────────────────────────────────────\n\n/**\n * Validation error codes emitted by the I-9 sign-employee form schema. Map\n * these codes to localized copy in `validationMessages` when composing the\n * hook.\n *\n * @public\n */\nexport const SignEmployeeFormErrorCodes = {\n  REQUIRED: 'REQUIRED',\n} as const\n\n/**\n * Union of validation error code strings emitted by the I-9 sign-employee\n * form schema.\n *\n * @public\n */\nexport type SignEmployeeFormErrorCode =\n  (typeof SignEmployeeFormErrorCodes)[keyof typeof SignEmployeeFormErrorCodes]\n\n// ── Preparer naming helpers ────────────────────────────────────────────\n\n/**\n * Maximum number of I-9 preparers and translators the form supports.\n *\n * @public\n */\nexport const MAX_PREPARERS = 4\n\n/**\n * One-based preparer index used to reference preparer field groups (1–4).\n *\n * @public\n */\nexport type PreparerIndex = 1 | 2 | 3 | 4\n\n/**\n * Suffix segment of a preparer field name — the part that follows\n * `preparer` (or `preparerN`) in the field key.\n *\n * @public\n */\nexport type PreparerFieldSuffix =\n  | 'FirstName'\n  | 'LastName'\n  | 'Street1'\n  | 'Street2'\n  | 'City'\n  | 'State'\n  | 'Zip'\n  | 'Signature'\n  | 'Agree'\n\n/** @internal */\nexport function preparerFieldName(index: PreparerIndex, field: PreparerFieldSuffix): string {\n  return index === 1 ? `preparer${field}` : `preparer${index}${field}`\n}\n\n// ── Preparer field name constants ──────────────────────────────────────\n\ntype PreparerFieldMap = Record<\n  | 'firstName'\n  | 'lastName'\n  | 'street1'\n  | 'street2'\n  | 'city'\n  | 'state'\n  | 'zip'\n  | 'signature'\n  | 'agree',\n  SignEmployeeFormField\n>\n\nconst PREPARER_1 = {\n  firstName: 'preparerFirstName',\n  lastName: 'preparerLastName',\n  street1: 'preparerStreet1',\n  street2: 'preparerStreet2',\n  city: 'preparerCity',\n  state: 'preparerState',\n  zip: 'preparerZip',\n  signature: 'preparerSignature',\n  agree: 'preparerAgree',\n} as const\n\nconst PREPARER_2 = {\n  firstName: 'preparer2FirstName',\n  lastName: 'preparer2LastName',\n  street1: 'preparer2Street1',\n  street2: 'preparer2Street2',\n  city: 'preparer2City',\n  state: 'preparer2State',\n  zip: 'preparer2Zip',\n  signature: 'preparer2Signature',\n  agree: 'preparer2Agree',\n} as const\n\nconst PREPARER_3 = {\n  firstName: 'preparer3FirstName',\n  lastName: 'preparer3LastName',\n  street1: 'preparer3Street1',\n  street2: 'preparer3Street2',\n  city: 'preparer3City',\n  state: 'preparer3State',\n  zip: 'preparer3Zip',\n  signature: 'preparer3Signature',\n  agree: 'preparer3Agree',\n} as const\n\nconst PREPARER_4 = {\n  firstName: 'preparer4FirstName',\n  lastName: 'preparer4LastName',\n  street1: 'preparer4Street1',\n  street2: 'preparer4Street2',\n  city: 'preparer4City',\n  state: 'preparer4State',\n  zip: 'preparer4Zip',\n  signature: 'preparer4Signature',\n  agree: 'preparer4Agree',\n} as const\n\n/**\n * Per-preparer field name maps indexed by preparer position (0-based). Use\n * these to look up the form field name for a given preparer slot — for\n * example `PREPARERS_BY_INDEX[1].firstName` resolves to\n * `'preparer2FirstName'`.\n *\n * @public\n */\nexport const PREPARERS_BY_INDEX = [\n  PREPARER_1,\n  PREPARER_2,\n  PREPARER_3,\n  PREPARER_4,\n] satisfies PreparerFieldMap[]\n\n// ── Per-preparer field name lists (used for excludeFields) ──────────────\n\ntype ValuesOf<T> = T[keyof T]\n\nconst PREPARER_1_FIELDS: SignEmployeeFormField[] = Object.values(PREPARER_1) as ValuesOf<\n  typeof PREPARER_1\n>[]\nconst PREPARER_2_FIELDS: SignEmployeeFormField[] = Object.values(PREPARER_2) as ValuesOf<\n  typeof PREPARER_2\n>[]\nconst PREPARER_3_FIELDS: SignEmployeeFormField[] = Object.values(PREPARER_3) as ValuesOf<\n  typeof PREPARER_3\n>[]\nconst PREPARER_4_FIELDS: SignEmployeeFormField[] = Object.values(PREPARER_4) as ValuesOf<\n  typeof PREPARER_4\n>[]\n\n/**\n * Flat list of preparer field names per preparer slot (0-based), useful for\n * iterating every field that belongs to a single preparer.\n *\n * @public\n */\nexport const PREPARER_FIELDS_BY_INDEX: SignEmployeeFormField[][] = [\n  PREPARER_1_FIELDS,\n  PREPARER_2_FIELDS,\n  PREPARER_3_FIELDS,\n  PREPARER_4_FIELDS,\n]\n\nconst ALL_PREPARER_FIELDS = PREPARER_FIELDS_BY_INDEX.flat()\n\n// ── Field validators ───────────────────────────────────────────────────\n\nconst agreeValidator = z.boolean().refine(val => val, {\n  message: SignEmployeeFormErrorCodes.REQUIRED,\n})\n\nconst fieldValidators = {\n  signature: z.string(),\n  confirmSignature: agreeValidator,\n  usedPreparer: z.enum(['yes', 'no']),\n\n  // Preparer 1\n  [PREPARER_1.firstName]: z.string(),\n  [PREPARER_1.lastName]: z.string(),\n  [PREPARER_1.street1]: z.string(),\n  [PREPARER_1.street2]: z.string(),\n  [PREPARER_1.city]: z.string(),\n  [PREPARER_1.state]: z.string(),\n  [PREPARER_1.zip]: z.string(),\n  [PREPARER_1.signature]: z.string(),\n  [PREPARER_1.agree]: agreeValidator,\n\n  // Preparer 2\n  [PREPARER_2.firstName]: z.string(),\n  [PREPARER_2.lastName]: z.string(),\n  [PREPARER_2.street1]: z.string(),\n  [PREPARER_2.street2]: z.string(),\n  [PREPARER_2.city]: z.string(),\n  [PREPARER_2.state]: z.string(),\n  [PREPARER_2.zip]: z.string(),\n  [PREPARER_2.signature]: z.string(),\n  [PREPARER_2.agree]: agreeValidator,\n\n  // Preparer 3\n  [PREPARER_3.firstName]: z.string(),\n  [PREPARER_3.lastName]: z.string(),\n  [PREPARER_3.street1]: z.string(),\n  [PREPARER_3.street2]: z.string(),\n  [PREPARER_3.city]: z.string(),\n  [PREPARER_3.state]: z.string(),\n  [PREPARER_3.zip]: z.string(),\n  [PREPARER_3.signature]: z.string(),\n  [PREPARER_3.agree]: agreeValidator,\n\n  // Preparer 4\n  [PREPARER_4.firstName]: z.string(),\n  [PREPARER_4.lastName]: z.string(),\n  [PREPARER_4.street1]: z.string(),\n  [PREPARER_4.street2]: z.string(),\n  [PREPARER_4.city]: z.string(),\n  [PREPARER_4.state]: z.string(),\n  [PREPARER_4.zip]: z.string(),\n  [PREPARER_4.signature]: z.string(),\n  [PREPARER_4.agree]: agreeValidator,\n}\n\n/**\n * Field names accepted by the I-9 sign-employee form.\n *\n * @public\n */\nexport type SignEmployeeFormField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the I-9 sign-employee form.\n *\n * @public\n */\nexport type SignEmployeeFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n/**\n * Shape of the validated values produced by the I-9 sign-employee form on\n * submit.\n *\n * @public\n */\nexport type SignEmployeeFormOutputs = SignEmployeeFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n\nconst requiredFieldsConfig = {\n  [PREPARER_1.street2]: 'never',\n  [PREPARER_2.street2]: 'never',\n  [PREPARER_3.street2]: 'never',\n  [PREPARER_4.street2]: 'never',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\n/** @internal */\ninterface SignEmployeeFormSchemaOptions {\n  isI9?: boolean\n  preparerCount?: number\n}\n\n/** @internal */\nexport function createSignEmployeeFormSchema(options: SignEmployeeFormSchemaOptions = {}) {\n  const { isI9 = false, preparerCount = 0 } = options\n\n  const excludeFields: SignEmployeeFormField[] = []\n\n  if (!isI9) {\n    excludeFields.push('usedPreparer', ...ALL_PREPARER_FIELDS)\n  } else {\n    for (let index = 0; index < MAX_PREPARERS; index++) {\n      if (index + 1 > preparerCount) {\n        const preparerFields = PREPARER_FIELDS_BY_INDEX[index]\n        if (preparerFields) excludeFields.push(...preparerFields)\n      }\n    }\n  }\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: SignEmployeeFormErrorCodes.REQUIRED,\n    mode: 'create',\n    excludeFields,\n  })\n}\n"],"names":["SignEmployeeFormErrorCodes","MAX_PREPARERS","preparerFieldName","index","field","PREPARER_1","PREPARER_2","PREPARER_3","PREPARER_4","PREPARERS_BY_INDEX","PREPARER_1_FIELDS","PREPARER_2_FIELDS","PREPARER_3_FIELDS","PREPARER_4_FIELDS","PREPARER_FIELDS_BY_INDEX","ALL_PREPARER_FIELDS","agreeValidator","z","val","fieldValidators","requiredFieldsConfig","createSignEmployeeFormSchema","options","isI9","preparerCount","excludeFields","preparerFields","buildFormSchema"],"mappings":"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"}

package/dist/components/Employee/Documents/shared/useSignEmployeeForm/useSignEmployeeForm.d.ts

@@ -13,44 +13,174 @@ declare const preparer1Fields: {
     Signature: typeof Preparer1Signature;
     ConfirmSignature: typeof Preparer1ConfirmSignature;
 };
+/**
+ * Field group exposed for each I-9 preparer/translator on {@link useSignEmployeeForm}.
+ *
+ * @remarks
+ * Each preparer (1–4) exposes the same nine sub-fields covering name,
+ * address, signature, and consent. Render the sub-fields directly on the
+ * group, e.g. `<Fields.Preparer1.FirstName />`.
+ *
+ * @public
+ */
 export type PreparerFieldGroup = typeof preparer1Fields;
+/**
+ * Props for {@link useSignEmployeeForm}.
+ *
+ * @public
+ */
 export interface UseSignEmployeeFormProps {
+    /** The associated employee identifier. */
     employeeId: string;
+    /** The UUID of the employee form to sign. */
     formId: string;
 }
+/**
+ * Field components exposed by {@link useSignEmployeeForm} on `form.Fields`.
+ *
+ * @remarks
+ * `Signature` and `ConfirmSignature` are always present. `UsedPreparer` and
+ * the `Preparer1`–`Preparer4` field groups are only defined when the form
+ * being signed is an I-9 and the preparer count has reached that index —
+ * always null-check before rendering.
+ *
+ * @public
+ */
 export interface SignEmployeeFormFieldComponents {
+    /** Text input for the employee's typed signature; always present. */
     Signature: typeof SignatureField;
+    /** Checkbox for the employee's electronic-signature consent; always present. */
     ConfirmSignature: typeof ConfirmSignatureField;
+    /** Radio group asking whether a preparer/translator assisted; defined only for I-9 forms. */
     UsedPreparer: typeof UsedPreparerField | undefined;
+    /** First preparer field group; defined only for I-9 forms when `preparers.count >= 1`. */
     Preparer1: PreparerFieldGroup | undefined;
+    /** Second preparer field group; defined only for I-9 forms when `preparers.count >= 2`. */
     Preparer2: PreparerFieldGroup | undefined;
+    /** Third preparer field group; defined only for I-9 forms when `preparers.count >= 3`. */
     Preparer3: PreparerFieldGroup | undefined;
+    /** Fourth preparer field group; defined only for I-9 forms when `preparers.count >= 4`. */
     Preparer4: PreparerFieldGroup | undefined;
 }
+/**
+ * Ready-state shape returned by {@link useSignEmployeeForm} once the form metadata and PDF have loaded.
+ *
+ * @public
+ */
 export interface UseSignEmployeeFormReady extends BaseFormHookReady<FieldsMetadata, SignEmployeeFormData, SignEmployeeFormFieldComponents> {
+    /** Loaded data — the form entity and a preview PDF URL. */
     data: {
+        /** The employee form entity fetched from the API (includes `uuid`, `name`, `title`). */
         form: Form;
+        /** URL to the form's signed PDF for preview, or `undefined` while it is still being generated. */
         pdfUrl: string | null | undefined;
     };
+    /** Submit-state flags. */
     status: {
+        /** `true` while the sign mutation is in flight. */
         isPending: boolean;
+        /** Always `'create'`; the hook always submits as a signing operation. */
         mode: 'create';
     };
+    /** Imperative actions exposed by the hook. */
     actions: {
+        /** Validates the form and submits the signature. Resolves with the signed form on success. */
         onSubmit: () => Promise<HookSubmitResult<Form> | undefined>;
+        /** Adds an additional preparer/translator section (up to 4). Defined only for I-9 forms. */
         addPreparer?: () => void;
+        /** Removes the last preparer/translator section and unregisters its fields. Defined only for I-9 forms. */
         removePreparer?: () => void;
     };
+    /** Form bindings — `Fields`, `fieldsMetadata`, and I-9 preparer state. */
     form: BaseFormHookReady<FieldsMetadata, SignEmployeeFormData, SignEmployeeFormFieldComponents>['form'] & {
+        /** Preparer-section state. Defined only for I-9 forms. */
         preparers?: {
+            /** Current number of preparer sections, between 0 and 4. */
             count: number;
+            /** `true` when fewer than 4 preparers are active. */
             canAdd: boolean;
+            /** `true` when at least 1 preparer is active. */
             canRemove: boolean;
         };
     };
 }
+/**
+ * Headless hook for signing an employee form — captures a typed signature, electronic consent, and (for I-9 forms) preparer/translator certification.
+ *
+ * @remarks
+ * The hook fetches the form metadata and PDF, then exposes the
+ * {@link BaseFormHookReady} contract with `Fields`, `fieldsMetadata`,
+ * `onSubmit`, and error handling. The hook inspects the form's `name` to
+ * detect I-9 forms; when the form is an I-9, `Fields.UsedPreparer` and the
+ * `Fields.Preparer1`–`Preparer4` field groups become defined, along with
+ * `actions.addPreparer` / `actions.removePreparer` and `form.preparers`
+ * state. Selecting `usedPreparer: 'yes'` automatically reveals the first
+ * preparer section; switching back to `'no'` removes all preparer sections
+ * and unregisters their fields.
+ *
+ * Unlike the CRUD-oriented form hooks (`useEmployeeDetailsForm`,
+ * `useCompensationForm`, `useWorkAddressForm`), this hook does not accept
+ * `defaultValues`, `requiredFields`, or `validationMode` — the form shape is
+ * fixed and all fields except preparer street-2 are required.
+ *
+ * @param props - See {@link UseSignEmployeeFormProps}.
+ * @returns A {@link HookLoadingResult} while loading, or a {@link UseSignEmployeeFormReady} once the form is loaded.
+ * @public
+ *
+ * @example
+ * ```tsx
+ * import { useSignEmployeeForm, SDKFormProvider } from '@gusto/embedded-react-sdk'
+ *
+ * function SignFormPage({ employeeId, formId }: { employeeId: string; formId: string }) {
+ *   const signForm = useSignEmployeeForm({ employeeId, formId })
+ *
+ *   if (signForm.isLoading) return <div>Loading...</div>
+ *
+ *   const { Fields } = signForm.form
+ *
+ *   return (
+ *     <SDKFormProvider formHookResult={signForm}>
+ *       <form
+ *         onSubmit={e => {
+ *           e.preventDefault()
+ *           void signForm.actions.onSubmit()
+ *         }}
+ *       >
+ *         <Fields.Signature
+ *           label="Signature"
+ *           description="Type your full, legal name."
+ *           validationMessages={{ REQUIRED: 'Signature is required' }}
+ *         />
+ *         <Fields.ConfirmSignature
+ *           label="I agree to sign electronically"
+ *           validationMessages={{ REQUIRED: 'You must agree to sign electronically' }}
+ *         />
+ *         <button type="submit" disabled={signForm.status.isPending}>
+ *           Sign form
+ *         </button>
+ *       </form>
+ *     </SDKFormProvider>
+ *   )
+ * }
+ * ```
+ */
 export declare function useSignEmployeeForm({ employeeId, formId, }: UseSignEmployeeFormProps): HookLoadingResult | UseSignEmployeeFormReady;
+/**
+ * Result of {@link useSignEmployeeForm} — a discriminated union on `isLoading`.
+ *
+ * @public
+ */
 export type UseSignEmployeeFormResult = HookLoadingResult | UseSignEmployeeFormReady;
+/**
+ * Shape of the `form.fieldsMetadata` object returned by {@link useSignEmployeeForm}.
+ *
+ * @public
+ */
 export type SignEmployeeFormFieldsMetadata = UseSignEmployeeFormReady['form']['fieldsMetadata'];
+/**
+ * Shape of the `form.Fields` object returned by {@link useSignEmployeeForm}.
+ *
+ * @public
+ */
 export type SignEmployeeFormFields = UseSignEmployeeFormReady['form']['Fields'];
 export {};

package/dist/components/Employee/Documents/shared/useSignEmployeeForm/useSignEmployeeForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSignEmployeeForm.js","sources":["../../../../../../src/components/Employee/Documents/shared/useSignEmployeeForm/useSignEmployeeForm.tsx"],"sourcesContent":["import { useMemo, useCallback, useState, useEffect } from 'react'\nimport { useForm } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Form } from '@gusto/embedded-api-v-2025-11-15/models/components/form'\nimport { useEmployeeFormsGet } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeFormsGet'\nimport { useEmployeeFormsGetPdf } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeFormsGetPdf'\nimport { useEmployeeFormsSignMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeFormsSign'\nimport {\n  createSignEmployeeFormSchema,\n  MAX_PREPARERS,\n  PREPARER_FIELDS_BY_INDEX,\n  PREPARERS_BY_INDEX,\n  type SignEmployeeFormData,\n  type SignEmployeeFormOutputs,\n} from './signEmployeeFormSchema'\nimport {\n  SignatureField,\n  ConfirmSignatureField,\n  UsedPreparerField,\n  Preparer1FirstName,\n  Preparer1LastName,\n  Preparer1Street1,\n  Preparer1Street2,\n  Preparer1City,\n  Preparer1State,\n  Preparer1Zip,\n  Preparer1Signature,\n  Preparer1ConfirmSignature,\n  Preparer2FirstName,\n  Preparer2LastName,\n  Preparer2Street1,\n  Preparer2Street2,\n  Preparer2City,\n  Preparer2State,\n  Preparer2Zip,\n  Preparer2Signature,\n  Preparer2ConfirmSignature,\n  Preparer3FirstName,\n  Preparer3LastName,\n  Preparer3Street1,\n  Preparer3Street2,\n  Preparer3City,\n  Preparer3State,\n  Preparer3Zip,\n  Preparer3Signature,\n  Preparer3ConfirmSignature,\n  Preparer4FirstName,\n  Preparer4LastName,\n  Preparer4Street1,\n  Preparer4Street2,\n  Preparer4City,\n  Preparer4State,\n  Preparer4Zip,\n  Preparer4Signature,\n  Preparer4ConfirmSignature,\n} from './fields'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { I9_FORM_NAME, STATES_ABBR } from '@/shared/constants'\n\nconst stateOptions = STATES_ABBR.map(abbr => ({ label: abbr, value: abbr }))\n\n// ── Preparer field groups ──────────────────────────────────────────────\n\nconst preparer1Fields = {\n  FirstName: Preparer1FirstName,\n  LastName: Preparer1LastName,\n  Street1: Preparer1Street1,\n  Street2: Preparer1Street2,\n  City: Preparer1City,\n  State: Preparer1State,\n  Zip: Preparer1Zip,\n  Signature: Preparer1Signature,\n  ConfirmSignature: Preparer1ConfirmSignature,\n}\n\nconst preparer2Fields = {\n  FirstName: Preparer2FirstName,\n  LastName: Preparer2LastName,\n  Street1: Preparer2Street1,\n  Street2: Preparer2Street2,\n  City: Preparer2City,\n  State: Preparer2State,\n  Zip: Preparer2Zip,\n  Signature: Preparer2Signature,\n  ConfirmSignature: Preparer2ConfirmSignature,\n}\n\nconst preparer3Fields = {\n  FirstName: Preparer3FirstName,\n  LastName: Preparer3LastName,\n  Street1: Preparer3Street1,\n  Street2: Preparer3Street2,\n  City: Preparer3City,\n  State: Preparer3State,\n  Zip: Preparer3Zip,\n  Signature: Preparer3Signature,\n  ConfirmSignature: Preparer3ConfirmSignature,\n}\n\nconst preparer4Fields = {\n  FirstName: Preparer4FirstName,\n  LastName: Preparer4LastName,\n  Street1: Preparer4Street1,\n  Street2: Preparer4Street2,\n  City: Preparer4City,\n  State: Preparer4State,\n  Zip: Preparer4Zip,\n  Signature: Preparer4Signature,\n  ConfirmSignature: Preparer4ConfirmSignature,\n}\n\nexport type PreparerFieldGroup = typeof preparer1Fields\n\n// ── Types ──────────────────────────────────────────────────────────────\n\nexport interface UseSignEmployeeFormProps {\n  employeeId: string\n  formId: string\n}\n\nexport interface SignEmployeeFormFieldComponents {\n  Signature: typeof SignatureField\n  ConfirmSignature: typeof ConfirmSignatureField\n  UsedPreparer: typeof UsedPreparerField | undefined\n  Preparer1: PreparerFieldGroup | undefined\n  Preparer2: PreparerFieldGroup | undefined\n  Preparer3: PreparerFieldGroup | undefined\n  Preparer4: PreparerFieldGroup | undefined\n}\n\nexport interface UseSignEmployeeFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  SignEmployeeFormData,\n  SignEmployeeFormFieldComponents\n> {\n  data: {\n    form: Form\n    pdfUrl: string | null | undefined\n  }\n  status: { isPending: boolean; mode: 'create' }\n  actions: {\n    onSubmit: () => Promise<HookSubmitResult<Form> | undefined>\n    addPreparer?: () => void\n    removePreparer?: () => void\n  }\n  form: BaseFormHookReady<\n    FieldsMetadata,\n    SignEmployeeFormData,\n    SignEmployeeFormFieldComponents\n  >['form'] & {\n    preparers?: { count: number; canAdd: boolean; canRemove: boolean }\n  }\n}\n\n// ── Hook ───────────────────────────────────────────────────────────────\n\nexport function useSignEmployeeForm({\n  employeeId,\n  formId,\n}: UseSignEmployeeFormProps): HookLoadingResult | UseSignEmployeeFormReady {\n  const formQuery = useEmployeeFormsGet({ employeeId, formId })\n  const pdfQuery = useEmployeeFormsGetPdf({ employeeId, formId })\n\n  const form = formQuery.data?.form\n  const pdfUrl = pdfQuery.data?.formPdf?.documentUrl\n  const isI9 = form?.name === I9_FORM_NAME\n\n  const [preparerCount, setPreparerCount] = useState(0)\n\n  const [schema, metadataConfig] = useMemo(\n    () => createSignEmployeeFormSchema({ isI9, preparerCount }),\n    [isI9, preparerCount],\n  )\n\n  const formMethods = useForm<SignEmployeeFormData, unknown, SignEmployeeFormOutputs>({\n    resolver: zodResolver(schema),\n    defaultValues: {\n      signature: '',\n      confirmSignature: false,\n      usedPreparer: 'no',\n    },\n  })\n\n  const { mutateAsync: signForm, isPending } = useEmployeeFormsSignMutation()\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('SignEmployeeForm')\n\n  // The signed PDF is a preview convenience: `pdfUrl` is optional and both the\n  // viewer and the download link already degrade gracefully when it's absent.\n  // A failed — or not-yet-ready — PDF fetch must NOT surface as a page-level\n  // signing error. In particular the global post-mutation invalidation forces a\n  // `getPdf` refetch the instant a sign succeeds, which races backend generation\n  // of the signed PDF; surfacing that transient failure as \"there was a problem\n  // with your submission\" is misleading when the signature actually went through\n  // (SDK-947). Only the form query feeds the error surface.\n  const queries = [formQuery]\n  const errorHandling = composeErrorHandler(queries, { submitError, setSubmitError })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n\n  const fieldsMetadata = useMemo(\n    () => ({\n      ...baseMetadata,\n      ...(isI9\n        ? {\n            usedPreparer: withOptions(baseMetadata.usedPreparer, [\n              { label: 'No, I completed this myself', value: 'no' },\n              { label: 'Yes, I used a preparer/translator', value: 'yes' },\n            ]),\n            preparerState: withOptions(baseMetadata.preparerState, stateOptions, STATES_ABBR),\n            preparer2State: withOptions(baseMetadata.preparer2State, stateOptions, STATES_ABBR),\n            preparer3State: withOptions(baseMetadata.preparer3State, stateOptions, STATES_ABBR),\n            preparer4State: withOptions(baseMetadata.preparer4State, stateOptions, STATES_ABBR),\n          }\n        : {}),\n    }),\n    [baseMetadata, isI9],\n  )\n\n  const addPreparer = useCallback(() => {\n    setPreparerCount(prev => Math.min(prev + 1, MAX_PREPARERS))\n  }, [])\n\n  const removePreparer = useCallback(() => {\n    setPreparerCount(prev => {\n      if (prev <= 0) return prev\n      const preparerFields = PREPARER_FIELDS_BY_INDEX[prev - 1]\n      if (!preparerFields) return prev\n      for (const name of preparerFields) {\n        formMethods.unregister(name)\n      }\n      return prev - 1\n    })\n  }, [formMethods.unregister])\n\n  const usedPreparer = isI9 ? formMethods.watch('usedPreparer') : undefined\n\n  useEffect(() => {\n    if (!isI9) return\n    if (usedPreparer === 'yes' && preparerCount === 0) {\n      addPreparer()\n    }\n    if (usedPreparer === 'no' && preparerCount > 0) {\n      for (let i = preparerCount; i > 0; i--) {\n        removePreparer()\n      }\n    }\n  }, [usedPreparer, isI9, preparerCount, addPreparer, removePreparer])\n\n  const onSubmit = async (): Promise<HookSubmitResult<Form> | undefined> => {\n    let submitResult: HookSubmitResult<Form> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: SignEmployeeFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const requestBody: Record<string, unknown> = {\n              signatureText: payload.signature,\n              agree: payload.confirmSignature,\n            }\n\n            if (isI9) {\n              Object.assign(requestBody, buildPreparerPayload(payload, preparerCount))\n            }\n\n            const result = await signForm({\n              request: {\n                employeeId,\n                formId: form!.uuid,\n                requestBody: requestBody as {\n                  signatureText: string\n                  agree: boolean\n                  signedByIpAddress: string\n                },\n              },\n            })\n\n            if (result.form) {\n              submitResult = { mode: 'create', data: result.form }\n            }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  const isDataLoading = formQuery.isLoading || pdfQuery.isLoading\n\n  if (isDataLoading || !form) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: { form, pdfUrl },\n    status: { isPending, mode: 'create' as const },\n    actions: {\n      onSubmit,\n      ...(isI9 ? { addPreparer, removePreparer } : {}),\n    },\n    errorHandling,\n    form: {\n      Fields: {\n        Signature: SignatureField,\n        ConfirmSignature: ConfirmSignatureField,\n        UsedPreparer: isI9 ? UsedPreparerField : undefined,\n        Preparer1: isI9 && preparerCount >= 1 ? preparer1Fields : undefined,\n        Preparer2: isI9 && preparerCount >= 2 ? preparer2Fields : undefined,\n        Preparer3: isI9 && preparerCount >= 3 ? preparer3Fields : undefined,\n        Preparer4: isI9 && preparerCount >= 4 ? preparer4Fields : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n      ...(isI9\n        ? {\n            preparers: {\n              count: preparerCount,\n              canAdd: preparerCount < MAX_PREPARERS,\n              canRemove: preparerCount > 0,\n            },\n          }\n        : {}),\n    },\n  }\n}\n\n// ── Helpers ─────────────────────────────────────────────────────────────\n\nfunction buildPreparerPayload(payload: SignEmployeeFormOutputs, count: number) {\n  if (payload.usedPreparer !== 'yes' || count === 0) {\n    return { preparer: false }\n  }\n\n  const result: Record<string, unknown> = { preparer: true }\n\n  for (let index = 0; index < count; index++) {\n    if (index > 0) {\n      result[`preparer${String(index + 1)}`] = true\n    }\n\n    const preparer = PREPARERS_BY_INDEX[index]\n    if (!preparer) continue\n\n    result[preparer.firstName] = payload[preparer.firstName]\n    result[preparer.lastName] = payload[preparer.lastName]\n    result[preparer.street1] = payload[preparer.street1]\n    if (payload[preparer.street2]) {\n      result[preparer.street2] = payload[preparer.street2]\n    }\n    result[preparer.city] = payload[preparer.city]\n    result[preparer.state] = payload[preparer.state]\n    result[preparer.zip] = payload[preparer.zip]\n    result[preparer.signature] = payload[preparer.signature]\n    result[preparer.agree] = 'true'\n  }\n\n  return result\n}\n\nexport type UseSignEmployeeFormResult = HookLoadingResult | UseSignEmployeeFormReady\nexport type SignEmployeeFormFieldsMetadata = UseSignEmployeeFormReady['form']['fieldsMetadata']\nexport type SignEmployeeFormFields = UseSignEmployeeFormReady['form']['Fields']\n"],"names":["stateOptions","STATES_ABBR","abbr","preparer1Fields","Preparer1FirstName","Preparer1LastName","Preparer1Street1","Preparer1Street2","Preparer1City","Preparer1State","Preparer1Zip","Preparer1Signature","Preparer1ConfirmSignature","preparer2Fields","Preparer2FirstName","Preparer2LastName","Preparer2Street1","Preparer2Street2","Preparer2City","Preparer2State","Preparer2Zip","Preparer2Signature","Preparer2ConfirmSignature","preparer3Fields","Preparer3FirstName","Preparer3LastName","Preparer3Street1","Preparer3Street2","Preparer3City","Preparer3State","Preparer3Zip","Preparer3Signature","Preparer3ConfirmSignature","preparer4Fields","Preparer4FirstName","Preparer4LastName","Preparer4Street1","Preparer4Street2","Preparer4City","Preparer4State","Preparer4Zip","Preparer4Signature","Preparer4ConfirmSignature","useSignEmployeeForm","employeeId","formId","formQuery","useEmployeeFormsGet","pdfQuery","useEmployeeFormsGetPdf","form","pdfUrl","isI9","I9_FORM_NAME","preparerCount","setPreparerCount","useState","schema","metadataConfig","useMemo","createSignEmployeeFormSchema","formMethods","useForm","zodResolver","signForm","isPending","useEmployeeFormsSignMutation","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","withOptions","addPreparer","useCallback","prev","MAX_PREPARERS","removePreparer","preparerFields","PREPARER_FIELDS_BY_INDEX","name","usedPreparer","useEffect","i","onSubmit","submitResult","resolve","data","payload","requestBody","buildPreparerPayload","result","hookFormInternals","useHookFormInternals","SignatureField","ConfirmSignatureField","UsedPreparerField","createGetFormSubmissionValues","count","index","preparer","PREPARERS_BY_INDEX"],"mappings":"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"}
+{"version":3,"file":"useSignEmployeeForm.js","sources":["../../../../../../src/components/Employee/Documents/shared/useSignEmployeeForm/useSignEmployeeForm.tsx"],"sourcesContent":["import { useMemo, useCallback, useState, useEffect } from 'react'\nimport { useForm } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Form } from '@gusto/embedded-api-v-2025-11-15/models/components/form'\nimport { useEmployeeFormsGet } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeFormsGet'\nimport { useEmployeeFormsGetPdf } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeFormsGetPdf'\nimport { useEmployeeFormsSignMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeFormsSign'\nimport {\n  createSignEmployeeFormSchema,\n  MAX_PREPARERS,\n  PREPARER_FIELDS_BY_INDEX,\n  PREPARERS_BY_INDEX,\n  type SignEmployeeFormData,\n  type SignEmployeeFormOutputs,\n} from './signEmployeeFormSchema'\nimport {\n  SignatureField,\n  ConfirmSignatureField,\n  UsedPreparerField,\n  Preparer1FirstName,\n  Preparer1LastName,\n  Preparer1Street1,\n  Preparer1Street2,\n  Preparer1City,\n  Preparer1State,\n  Preparer1Zip,\n  Preparer1Signature,\n  Preparer1ConfirmSignature,\n  Preparer2FirstName,\n  Preparer2LastName,\n  Preparer2Street1,\n  Preparer2Street2,\n  Preparer2City,\n  Preparer2State,\n  Preparer2Zip,\n  Preparer2Signature,\n  Preparer2ConfirmSignature,\n  Preparer3FirstName,\n  Preparer3LastName,\n  Preparer3Street1,\n  Preparer3Street2,\n  Preparer3City,\n  Preparer3State,\n  Preparer3Zip,\n  Preparer3Signature,\n  Preparer3ConfirmSignature,\n  Preparer4FirstName,\n  Preparer4LastName,\n  Preparer4Street1,\n  Preparer4Street2,\n  Preparer4City,\n  Preparer4State,\n  Preparer4Zip,\n  Preparer4Signature,\n  Preparer4ConfirmSignature,\n} from './fields'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { I9_FORM_NAME, STATES_ABBR } from '@/shared/constants'\n\nconst stateOptions = STATES_ABBR.map(abbr => ({ label: abbr, value: abbr }))\n\n// ── Preparer field groups ──────────────────────────────────────────────\n\nconst preparer1Fields = {\n  FirstName: Preparer1FirstName,\n  LastName: Preparer1LastName,\n  Street1: Preparer1Street1,\n  Street2: Preparer1Street2,\n  City: Preparer1City,\n  State: Preparer1State,\n  Zip: Preparer1Zip,\n  Signature: Preparer1Signature,\n  ConfirmSignature: Preparer1ConfirmSignature,\n}\n\nconst preparer2Fields = {\n  FirstName: Preparer2FirstName,\n  LastName: Preparer2LastName,\n  Street1: Preparer2Street1,\n  Street2: Preparer2Street2,\n  City: Preparer2City,\n  State: Preparer2State,\n  Zip: Preparer2Zip,\n  Signature: Preparer2Signature,\n  ConfirmSignature: Preparer2ConfirmSignature,\n}\n\nconst preparer3Fields = {\n  FirstName: Preparer3FirstName,\n  LastName: Preparer3LastName,\n  Street1: Preparer3Street1,\n  Street2: Preparer3Street2,\n  City: Preparer3City,\n  State: Preparer3State,\n  Zip: Preparer3Zip,\n  Signature: Preparer3Signature,\n  ConfirmSignature: Preparer3ConfirmSignature,\n}\n\nconst preparer4Fields = {\n  FirstName: Preparer4FirstName,\n  LastName: Preparer4LastName,\n  Street1: Preparer4Street1,\n  Street2: Preparer4Street2,\n  City: Preparer4City,\n  State: Preparer4State,\n  Zip: Preparer4Zip,\n  Signature: Preparer4Signature,\n  ConfirmSignature: Preparer4ConfirmSignature,\n}\n\n/**\n * Field group exposed for each I-9 preparer/translator on {@link useSignEmployeeForm}.\n *\n * @remarks\n * Each preparer (1–4) exposes the same nine sub-fields covering name,\n * address, signature, and consent. Render the sub-fields directly on the\n * group, e.g. `<Fields.Preparer1.FirstName />`.\n *\n * @public\n */\nexport type PreparerFieldGroup = typeof preparer1Fields\n\n// ── Types ──────────────────────────────────────────────────────────────\n\n/**\n * Props for {@link useSignEmployeeForm}.\n *\n * @public\n */\nexport interface UseSignEmployeeFormProps {\n  /** The associated employee identifier. */\n  employeeId: string\n  /** The UUID of the employee form to sign. */\n  formId: string\n}\n\n/**\n * Field components exposed by {@link useSignEmployeeForm} on `form.Fields`.\n *\n * @remarks\n * `Signature` and `ConfirmSignature` are always present. `UsedPreparer` and\n * the `Preparer1`–`Preparer4` field groups are only defined when the form\n * being signed is an I-9 and the preparer count has reached that index —\n * always null-check before rendering.\n *\n * @public\n */\nexport interface SignEmployeeFormFieldComponents {\n  /** Text input for the employee's typed signature; always present. */\n  Signature: typeof SignatureField\n  /** Checkbox for the employee's electronic-signature consent; always present. */\n  ConfirmSignature: typeof ConfirmSignatureField\n  /** Radio group asking whether a preparer/translator assisted; defined only for I-9 forms. */\n  UsedPreparer: typeof UsedPreparerField | undefined\n  /** First preparer field group; defined only for I-9 forms when `preparers.count >= 1`. */\n  Preparer1: PreparerFieldGroup | undefined\n  /** Second preparer field group; defined only for I-9 forms when `preparers.count >= 2`. */\n  Preparer2: PreparerFieldGroup | undefined\n  /** Third preparer field group; defined only for I-9 forms when `preparers.count >= 3`. */\n  Preparer3: PreparerFieldGroup | undefined\n  /** Fourth preparer field group; defined only for I-9 forms when `preparers.count >= 4`. */\n  Preparer4: PreparerFieldGroup | undefined\n}\n\n/**\n * Ready-state shape returned by {@link useSignEmployeeForm} once the form metadata and PDF have loaded.\n *\n * @public\n */\nexport interface UseSignEmployeeFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  SignEmployeeFormData,\n  SignEmployeeFormFieldComponents\n> {\n  /** Loaded data — the form entity and a preview PDF URL. */\n  data: {\n    /** The employee form entity fetched from the API (includes `uuid`, `name`, `title`). */\n    form: Form\n    /** URL to the form's signed PDF for preview, or `undefined` while it is still being generated. */\n    pdfUrl: string | null | undefined\n  }\n  /** Submit-state flags. */\n  status: {\n    /** `true` while the sign mutation is in flight. */\n    isPending: boolean\n    /** Always `'create'`; the hook always submits as a signing operation. */\n    mode: 'create'\n  }\n  /** Imperative actions exposed by the hook. */\n  actions: {\n    /** Validates the form and submits the signature. Resolves with the signed form on success. */\n    onSubmit: () => Promise<HookSubmitResult<Form> | undefined>\n    /** Adds an additional preparer/translator section (up to 4). Defined only for I-9 forms. */\n    addPreparer?: () => void\n    /** Removes the last preparer/translator section and unregisters its fields. Defined only for I-9 forms. */\n    removePreparer?: () => void\n  }\n  /** Form bindings — `Fields`, `fieldsMetadata`, and I-9 preparer state. */\n  form: BaseFormHookReady<\n    FieldsMetadata,\n    SignEmployeeFormData,\n    SignEmployeeFormFieldComponents\n  >['form'] & {\n    /** Preparer-section state. Defined only for I-9 forms. */\n    preparers?: {\n      /** Current number of preparer sections, between 0 and 4. */\n      count: number\n      /** `true` when fewer than 4 preparers are active. */\n      canAdd: boolean\n      /** `true` when at least 1 preparer is active. */\n      canRemove: boolean\n    }\n  }\n}\n\n// ── Hook ───────────────────────────────────────────────────────────────\n\n/**\n * Headless hook for signing an employee form — captures a typed signature, electronic consent, and (for I-9 forms) preparer/translator certification.\n *\n * @remarks\n * The hook fetches the form metadata and PDF, then exposes the\n * {@link BaseFormHookReady} contract with `Fields`, `fieldsMetadata`,\n * `onSubmit`, and error handling. The hook inspects the form's `name` to\n * detect I-9 forms; when the form is an I-9, `Fields.UsedPreparer` and the\n * `Fields.Preparer1`–`Preparer4` field groups become defined, along with\n * `actions.addPreparer` / `actions.removePreparer` and `form.preparers`\n * state. Selecting `usedPreparer: 'yes'` automatically reveals the first\n * preparer section; switching back to `'no'` removes all preparer sections\n * and unregisters their fields.\n *\n * Unlike the CRUD-oriented form hooks (`useEmployeeDetailsForm`,\n * `useCompensationForm`, `useWorkAddressForm`), this hook does not accept\n * `defaultValues`, `requiredFields`, or `validationMode` — the form shape is\n * fixed and all fields except preparer street-2 are required.\n *\n * @param props - See {@link UseSignEmployeeFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseSignEmployeeFormReady} once the form is loaded.\n * @public\n *\n * @example\n * ```tsx\n * import { useSignEmployeeForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n *\n * function SignFormPage({ employeeId, formId }: { employeeId: string; formId: string }) {\n *   const signForm = useSignEmployeeForm({ employeeId, formId })\n *\n *   if (signForm.isLoading) return <div>Loading...</div>\n *\n *   const { Fields } = signForm.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={signForm}>\n *       <form\n *         onSubmit={e => {\n *           e.preventDefault()\n *           void signForm.actions.onSubmit()\n *         }}\n *       >\n *         <Fields.Signature\n *           label=\"Signature\"\n *           description=\"Type your full, legal name.\"\n *           validationMessages={{ REQUIRED: 'Signature is required' }}\n *         />\n *         <Fields.ConfirmSignature\n *           label=\"I agree to sign electronically\"\n *           validationMessages={{ REQUIRED: 'You must agree to sign electronically' }}\n *         />\n *         <button type=\"submit\" disabled={signForm.status.isPending}>\n *           Sign form\n *         </button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useSignEmployeeForm({\n  employeeId,\n  formId,\n}: UseSignEmployeeFormProps): HookLoadingResult | UseSignEmployeeFormReady {\n  const formQuery = useEmployeeFormsGet({ employeeId, formId })\n  const pdfQuery = useEmployeeFormsGetPdf({ employeeId, formId })\n\n  const form = formQuery.data?.form\n  const pdfUrl = pdfQuery.data?.formPdf?.documentUrl\n  const isI9 = form?.name === I9_FORM_NAME\n\n  const [preparerCount, setPreparerCount] = useState(0)\n\n  const [schema, metadataConfig] = useMemo(\n    () => createSignEmployeeFormSchema({ isI9, preparerCount }),\n    [isI9, preparerCount],\n  )\n\n  const formMethods = useForm<SignEmployeeFormData, unknown, SignEmployeeFormOutputs>({\n    resolver: zodResolver(schema),\n    defaultValues: {\n      signature: '',\n      confirmSignature: false,\n      usedPreparer: 'no',\n    },\n  })\n\n  const { mutateAsync: signForm, isPending } = useEmployeeFormsSignMutation()\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('SignEmployeeForm')\n\n  // The signed PDF is a preview convenience: `pdfUrl` is optional and both the\n  // viewer and the download link already degrade gracefully when it's absent.\n  // A failed — or not-yet-ready — PDF fetch must NOT surface as a page-level\n  // signing error. In particular the global post-mutation invalidation forces a\n  // `getPdf` refetch the instant a sign succeeds, which races backend generation\n  // of the signed PDF; surfacing that transient failure as \"there was a problem\n  // with your submission\" is misleading when the signature actually went through\n  // (SDK-947). Only the form query feeds the error surface.\n  const queries = [formQuery]\n  const errorHandling = composeErrorHandler(queries, { submitError, setSubmitError })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n\n  const fieldsMetadata = useMemo(\n    () => ({\n      ...baseMetadata,\n      ...(isI9\n        ? {\n            usedPreparer: withOptions(baseMetadata.usedPreparer, [\n              { label: 'No, I completed this myself', value: 'no' },\n              { label: 'Yes, I used a preparer/translator', value: 'yes' },\n            ]),\n            preparerState: withOptions(baseMetadata.preparerState, stateOptions, STATES_ABBR),\n            preparer2State: withOptions(baseMetadata.preparer2State, stateOptions, STATES_ABBR),\n            preparer3State: withOptions(baseMetadata.preparer3State, stateOptions, STATES_ABBR),\n            preparer4State: withOptions(baseMetadata.preparer4State, stateOptions, STATES_ABBR),\n          }\n        : {}),\n    }),\n    [baseMetadata, isI9],\n  )\n\n  const addPreparer = useCallback(() => {\n    setPreparerCount(prev => Math.min(prev + 1, MAX_PREPARERS))\n  }, [])\n\n  const removePreparer = useCallback(() => {\n    setPreparerCount(prev => {\n      if (prev <= 0) return prev\n      const preparerFields = PREPARER_FIELDS_BY_INDEX[prev - 1]\n      if (!preparerFields) return prev\n      for (const name of preparerFields) {\n        formMethods.unregister(name)\n      }\n      return prev - 1\n    })\n  }, [formMethods.unregister])\n\n  const usedPreparer = isI9 ? formMethods.watch('usedPreparer') : undefined\n\n  useEffect(() => {\n    if (!isI9) return\n    if (usedPreparer === 'yes' && preparerCount === 0) {\n      addPreparer()\n    }\n    if (usedPreparer === 'no' && preparerCount > 0) {\n      for (let i = preparerCount; i > 0; i--) {\n        removePreparer()\n      }\n    }\n  }, [usedPreparer, isI9, preparerCount, addPreparer, removePreparer])\n\n  const onSubmit = async (): Promise<HookSubmitResult<Form> | undefined> => {\n    let submitResult: HookSubmitResult<Form> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: SignEmployeeFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const requestBody: Record<string, unknown> = {\n              signatureText: payload.signature,\n              agree: payload.confirmSignature,\n            }\n\n            if (isI9) {\n              Object.assign(requestBody, buildPreparerPayload(payload, preparerCount))\n            }\n\n            const result = await signForm({\n              request: {\n                employeeId,\n                formId: form!.uuid,\n                requestBody: requestBody as {\n                  signatureText: string\n                  agree: boolean\n                  signedByIpAddress: string\n                },\n              },\n            })\n\n            if (result.form) {\n              submitResult = { mode: 'create', data: result.form }\n            }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  const isDataLoading = formQuery.isLoading || pdfQuery.isLoading\n\n  if (isDataLoading || !form) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: { form, pdfUrl },\n    status: { isPending, mode: 'create' as const },\n    actions: {\n      onSubmit,\n      ...(isI9 ? { addPreparer, removePreparer } : {}),\n    },\n    errorHandling,\n    form: {\n      Fields: {\n        Signature: SignatureField,\n        ConfirmSignature: ConfirmSignatureField,\n        UsedPreparer: isI9 ? UsedPreparerField : undefined,\n        Preparer1: isI9 && preparerCount >= 1 ? preparer1Fields : undefined,\n        Preparer2: isI9 && preparerCount >= 2 ? preparer2Fields : undefined,\n        Preparer3: isI9 && preparerCount >= 3 ? preparer3Fields : undefined,\n        Preparer4: isI9 && preparerCount >= 4 ? preparer4Fields : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n      ...(isI9\n        ? {\n            preparers: {\n              count: preparerCount,\n              canAdd: preparerCount < MAX_PREPARERS,\n              canRemove: preparerCount > 0,\n            },\n          }\n        : {}),\n    },\n  }\n}\n\n// ── Helpers ─────────────────────────────────────────────────────────────\n\nfunction buildPreparerPayload(payload: SignEmployeeFormOutputs, count: number) {\n  if (payload.usedPreparer !== 'yes' || count === 0) {\n    return { preparer: false }\n  }\n\n  const result: Record<string, unknown> = { preparer: true }\n\n  for (let index = 0; index < count; index++) {\n    if (index > 0) {\n      result[`preparer${String(index + 1)}`] = true\n    }\n\n    const preparer = PREPARERS_BY_INDEX[index]\n    if (!preparer) continue\n\n    result[preparer.firstName] = payload[preparer.firstName]\n    result[preparer.lastName] = payload[preparer.lastName]\n    result[preparer.street1] = payload[preparer.street1]\n    if (payload[preparer.street2]) {\n      result[preparer.street2] = payload[preparer.street2]\n    }\n    result[preparer.city] = payload[preparer.city]\n    result[preparer.state] = payload[preparer.state]\n    result[preparer.zip] = payload[preparer.zip]\n    result[preparer.signature] = payload[preparer.signature]\n    result[preparer.agree] = 'true'\n  }\n\n  return result\n}\n\n/**\n * Result of {@link useSignEmployeeForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UseSignEmployeeFormResult = HookLoadingResult | UseSignEmployeeFormReady\n/**\n * Shape of the `form.fieldsMetadata` object returned by {@link useSignEmployeeForm}.\n *\n * @public\n */\nexport type SignEmployeeFormFieldsMetadata = UseSignEmployeeFormReady['form']['fieldsMetadata']\n/**\n * Shape of the `form.Fields` object returned by {@link useSignEmployeeForm}.\n *\n * @public\n */\nexport type SignEmployeeFormFields = UseSignEmployeeFormReady['form']['Fields']\n"],"names":["stateOptions","STATES_ABBR","abbr","preparer1Fields","Preparer1FirstName","Preparer1LastName","Preparer1Street1","Preparer1Street2","Preparer1City","Preparer1State","Preparer1Zip","Preparer1Signature","Preparer1ConfirmSignature","preparer2Fields","Preparer2FirstName","Preparer2LastName","Preparer2Street1","Preparer2Street2","Preparer2City","Preparer2State","Preparer2Zip","Preparer2Signature","Preparer2ConfirmSignature","preparer3Fields","Preparer3FirstName","Preparer3LastName","Preparer3Street1","Preparer3Street2","Preparer3City","Preparer3State","Preparer3Zip","Preparer3Signature","Preparer3ConfirmSignature","preparer4Fields","Preparer4FirstName","Preparer4LastName","Preparer4Street1","Preparer4Street2","Preparer4City","Preparer4State","Preparer4Zip","Preparer4Signature","Preparer4ConfirmSignature","useSignEmployeeForm","employeeId","formId","formQuery","useEmployeeFormsGet","pdfQuery","useEmployeeFormsGetPdf","form","pdfUrl","isI9","I9_FORM_NAME","preparerCount","setPreparerCount","useState","schema","metadataConfig","useMemo","createSignEmployeeFormSchema","formMethods","useForm","zodResolver","signForm","isPending","useEmployeeFormsSignMutation","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","withOptions","addPreparer","useCallback","prev","MAX_PREPARERS","removePreparer","preparerFields","PREPARER_FIELDS_BY_INDEX","name","usedPreparer","useEffect","i","onSubmit","submitResult","resolve","data","payload","requestBody","buildPreparerPayload","result","hookFormInternals","useHookFormInternals","SignatureField","ConfirmSignatureField","UsedPreparerField","createGetFormSubmissionValues","count","index","preparer","PREPARERS_BY_INDEX"],"mappings":"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"}

package/dist/components/Employee/EmployeeList/management/ManagementEmployeeList.d.ts

@@ -1,9 +1,36 @@
 import { BaseComponentInterface, CommonComponentInterface } from '../../../Base/Base';
-type EmployeeTab = 'active' | 'onboarding' | 'dismissed';
-interface ManagementEmployeeListProps extends CommonComponentInterface<'Employee.ManagementEmployeeList'> {
+/**
+ * The tab currently selected on {@link ManagementEmployeeList}.
+ *
+ * @public
+ */
+export type EmployeeTab = 'active' | 'onboarding' | 'dismissed';
+/**
+ * Props for {@link ManagementEmployeeList}.
+ *
+ * @public
+ */
+export interface ManagementEmployeeListProps extends CommonComponentInterface<'Employee.ManagementEmployeeList'> {
+    /** The associated company identifier. */
     companyId: string;
+    /** Tab to render first: Active, Onboarding, or Dismissed. Defaults to `'active'`. */
     initialTab?: EmployeeTab;
+    /** Event handler fired on flow state changes. */
     onEvent: BaseComponentInterface['onEvent'];
 }
+/**
+ * Renders a tabbed list of a company's employees split across Active, Onboarding, and Dismissed
+ * tabs, with per-row actions tailored to each tab (edit, delete, dismiss, rehire).
+ *
+ * @remarks
+ *
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `employee/create` | Fired when the user clicks "Add employee". | — |
+ * | `employee/update` | Fired when the user selects "Edit" on a row. | `{ employeeId: string }` |
+ * | `employee/dismiss` | Fired when the user selects "Dismiss" on a row in the Active tab. | `{ employeeId: string }` |
+ * | `employee/deleted` | Fired after a row's delete action completes. | `{ employeeId: string }` |
+ *
+ * @public
+ */
 export declare function ManagementEmployeeList({ FallbackComponent, ...props }: ManagementEmployeeListProps & BaseComponentInterface): import("react").JSX.Element;
-export {};