@gusto/embedded-react-sdk 0.47.0 → 0.48.0

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/splitFieldFactory.d.ts

@@ -8,6 +8,8 @@ import { FormHookResult, ValidationMessages } from '../../../../../partner-hook-
  * (Amount mode, `value < 0`), `INVALID_PERCENTAGE` (Percentage mode, non-integer
  * or out of `0..100`). Supply translations for all three via `validationMessages`.
  * The sum-to-100 invariant is surfaced separately via `status.hasPercentageImbalance`.
+ *
+ * @public
  */
 export type SplitFieldValidation = typeof SplitPaymentsFormErrorCodes.REQUIRED | typeof SplitPaymentsFormErrorCodes.INVALID_AMOUNT | typeof SplitPaymentsFormErrorCodes.INVALID_PERCENTAGE;
 /**
@@ -16,21 +18,42 @@ export type SplitFieldValidation = typeof SplitPaymentsFormErrorCodes.REQUIRED |
  * formats values as currency in Amount mode and as a percentage in
  * Percentage mode. The remainder split is auto-disabled and treated as not
  * required by the hook; the rest are required.
+ *
+ * @public
  */
 export interface SplitFieldProps {
+    /** Label shown above the input. */
     label: string;
+    /** Optional descriptive text rendered below the label. */
     description?: ReactNode;
+    /** Pass-through of the parent form hook result for cross-field validation context. */
     formHookResult?: FormHookResult;
+    /** Override the default localized validation message(s). */
     validationMessages?: ValidationMessages<SplitFieldValidation>;
+    /** Forwarded to the underlying number input. */
     min?: NumberInputProps['min'];
+    /** Forwarded to the underlying number input. */
     max?: NumberInputProps['max'];
+    /** Forwarded to the underlying number input. */
     placeholder?: NumberInputProps['placeholder'];
+    /** Override the rendered number input component. */
     FieldComponent?: ComponentType<NumberInputProps>;
 }
+/**
+ * Single per-account entry surfaced on `form.Fields.splits`. Each entry
+ * carries identifying metadata for the underlying bank account plus the bound
+ * Field component for its split amount.
+ *
+ * @public
+ */
 export interface SplitFieldEntry {
+    /** Bank account uuid that this split targets. */
     uuid: string;
+    /** Display name of the bank account, when available. */
     name: string | null;
+    /** Last-four masking string for the bank account number, when available. */
     hiddenAccountNumber: string | null;
+    /** Bound Field component for this split's amount input. */
     Field: ComponentType<SplitFieldProps>;
 }
 interface BuildSplitFieldsInput {
@@ -43,6 +66,8 @@ interface BuildSplitFieldsInput {
  * memoizing on the stable set of split uuids so Field identity stays stable
  * across mode toggles and reorders — those changes are observed inside each
  * Field rather than baked into the closure.
+ *
+ * @internal
  */
 export declare function buildSplitFieldEntries(splits: BuildSplitFieldsInput[]): SplitFieldEntry[];
 export {};

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/splitFieldFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"splitFieldFactory.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/splitFieldFactory.tsx"],"sourcesContent":["import type { ComponentType, ReactNode } from 'react'\nimport { useWatch, type Control } from 'react-hook-form'\nimport type {\n  SplitPaymentsFormErrorCodes,\n  SplitPaymentsFormData,\n} from './useSplitPaymentsFormSchema'\nimport { NumberInputHookField } from '@/partner-hook-utils/form/fields'\nimport type { NumberInputProps } from '@/components/Common/UI/NumberInput/NumberInputTypes'\nimport type { FormHookResult, ValidationMessages } from '@/partner-hook-utils/types'\nimport { SPLIT_BY } from '@/shared/constants'\n\n/**\n * Validation codes a bound split-amount Field can emit at submit time:\n * `REQUIRED` (every non-remainder split must have a value), `INVALID_AMOUNT`\n * (Amount mode, `value < 0`), `INVALID_PERCENTAGE` (Percentage mode, non-integer\n * or out of `0..100`). Supply translations for all three via `validationMessages`.\n * The sum-to-100 invariant is surfaced separately via `status.hasPercentageImbalance`.\n */\nexport type SplitFieldValidation =\n  | typeof SplitPaymentsFormErrorCodes.REQUIRED\n  | typeof SplitPaymentsFormErrorCodes.INVALID_AMOUNT\n  | typeof SplitPaymentsFormErrorCodes.INVALID_PERCENTAGE\n\n/**\n * Props accepted by a bound split-amount Field exposed on\n * `form.Fields.splits[i].Field`. The Field is pre-bound to its split; it\n * formats values as currency in Amount mode and as a percentage in\n * Percentage mode. The remainder split is auto-disabled and treated as not\n * required by the hook; the rest are required.\n */\nexport interface SplitFieldProps {\n  label: string\n  description?: ReactNode\n  formHookResult?: FormHookResult\n  validationMessages?: ValidationMessages<SplitFieldValidation>\n  min?: NumberInputProps['min']\n  max?: NumberInputProps['max']\n  placeholder?: NumberInputProps['placeholder']\n  FieldComponent?: ComponentType<NumberInputProps>\n}\n\nexport interface SplitFieldEntry {\n  uuid: string\n  name: string | null\n  hiddenAccountNumber: string | null\n  Field: ComponentType<SplitFieldProps>\n}\n\ninterface BuildSplitFieldsInput {\n  uuid: string\n  name: string | null\n  hiddenAccountNumber: string | null\n}\n\nfunction createBoundSplitField(uuid: string): ComponentType<SplitFieldProps> {\n  function BoundSplitField({\n    label,\n    description,\n    formHookResult,\n    validationMessages,\n    min,\n    max,\n    placeholder,\n    FieldComponent,\n  }: SplitFieldProps) {\n    const externalControl = formHookResult?.form.hookFormInternals.formMethods.control as\n      | Control<SplitPaymentsFormData>\n      | undefined\n    const splitBy = useWatch({ control: externalControl, name: 'splitBy' })\n    const format: NumberInputProps['format'] = splitBy === SPLIT_BY.amount ? 'currency' : 'percent'\n\n    return (\n      <NumberInputHookField<SplitFieldValidation>\n        name={`splitAmount.${uuid}`}\n        formHookResult={formHookResult}\n        label={label}\n        description={description}\n        validationMessages={validationMessages}\n        format={format}\n        min={min}\n        max={max}\n        placeholder={placeholder}\n        FieldComponent={FieldComponent}\n      />\n    )\n  }\n  BoundSplitField.displayName = `SplitField(${uuid})`\n  return BoundSplitField\n}\n\n/**\n * Build the per-split bound Field components. The caller is responsible for\n * memoizing on the stable set of split uuids so Field identity stays stable\n * across mode toggles and reorders — those changes are observed inside each\n * Field rather than baked into the closure.\n */\nexport function buildSplitFieldEntries(splits: BuildSplitFieldsInput[]): SplitFieldEntry[] {\n  return splits.map(split => ({\n    uuid: split.uuid,\n    name: split.name,\n    hiddenAccountNumber: split.hiddenAccountNumber,\n    Field: createBoundSplitField(split.uuid),\n  }))\n}\n"],"names":["createBoundSplitField","uuid","BoundSplitField","label","description","formHookResult","validationMessages","min","max","placeholder","FieldComponent","externalControl","format","useWatch","SPLIT_BY","jsx","NumberInputHookField","buildSplitFieldEntries","splits","split"],"mappings":";;;;AAsDA,SAASA,EAAsBC,GAA8C;AAC3E,WAASC,EAAgB;AAAA,IACvB,OAAAC;AAAA,IACA,aAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,oBAAAC;AAAA,IACA,KAAAC;AAAA,IACA,KAAAC;AAAA,IACA,aAAAC;AAAA,IACA,gBAAAC;AAAA,EAAA,GACkB;AAClB,UAAMC,IAAkBN,GAAgB,KAAK,kBAAkB,YAAY,SAIrEO,IADUC,EAAS,EAAE,SAASF,GAAiB,MAAM,WAAW,MACfG,EAAS,SAAS,aAAa;AAEtF,WACE,gBAAAC;AAAA,MAACC;AAAA,MAAA;AAAA,QACC,MAAM,eAAef,CAAI;AAAA,QACzB,gBAAAI;AAAA,QACA,OAAAF;AAAA,QACA,aAAAC;AAAA,QACA,oBAAAE;AAAA,QACA,QAAAM;AAAA,QACA,KAAAL;AAAA,QACA,KAAAC;AAAA,QACA,aAAAC;AAAA,QACA,gBAAAC;AAAA,MAAA;AAAA,IAAA;AAAA,EAGN;AACA,SAAAR,EAAgB,cAAc,cAAcD,CAAI,KACzCC;AACT;AAQO,SAASe,EAAuBC,GAAoD;AACzF,SAAOA,EAAO,IAAI,CAAAC,OAAU;AAAA,IAC1B,MAAMA,EAAM;AAAA,IACZ,MAAMA,EAAM;AAAA,IACZ,qBAAqBA,EAAM;AAAA,IAC3B,OAAOnB,EAAsBmB,EAAM,IAAI;AAAA,EAAA,EACvC;AACJ;"}
+{"version":3,"file":"splitFieldFactory.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/splitFieldFactory.tsx"],"sourcesContent":["import type { ComponentType, ReactNode } from 'react'\nimport { useWatch, type Control } from 'react-hook-form'\nimport type {\n  SplitPaymentsFormErrorCodes,\n  SplitPaymentsFormData,\n} from './useSplitPaymentsFormSchema'\nimport { NumberInputHookField } from '@/partner-hook-utils/form/fields'\nimport type { NumberInputProps } from '@/components/Common/UI/NumberInput/NumberInputTypes'\nimport type { FormHookResult, ValidationMessages } from '@/partner-hook-utils/types'\nimport { SPLIT_BY } from '@/shared/constants'\n\n/**\n * Validation codes a bound split-amount Field can emit at submit time:\n * `REQUIRED` (every non-remainder split must have a value), `INVALID_AMOUNT`\n * (Amount mode, `value < 0`), `INVALID_PERCENTAGE` (Percentage mode, non-integer\n * or out of `0..100`). Supply translations for all three via `validationMessages`.\n * The sum-to-100 invariant is surfaced separately via `status.hasPercentageImbalance`.\n *\n * @public\n */\nexport type SplitFieldValidation =\n  | typeof SplitPaymentsFormErrorCodes.REQUIRED\n  | typeof SplitPaymentsFormErrorCodes.INVALID_AMOUNT\n  | typeof SplitPaymentsFormErrorCodes.INVALID_PERCENTAGE\n\n/**\n * Props accepted by a bound split-amount Field exposed on\n * `form.Fields.splits[i].Field`. The Field is pre-bound to its split; it\n * formats values as currency in Amount mode and as a percentage in\n * Percentage mode. The remainder split is auto-disabled and treated as not\n * required by the hook; the rest are required.\n *\n * @public\n */\nexport interface SplitFieldProps {\n  /** Label shown above the input. */\n  label: string\n  /** Optional descriptive text rendered below the label. */\n  description?: ReactNode\n  /** Pass-through of the parent form hook result for cross-field validation context. */\n  formHookResult?: FormHookResult\n  /** Override the default localized validation message(s). */\n  validationMessages?: ValidationMessages<SplitFieldValidation>\n  /** Forwarded to the underlying number input. */\n  min?: NumberInputProps['min']\n  /** Forwarded to the underlying number input. */\n  max?: NumberInputProps['max']\n  /** Forwarded to the underlying number input. */\n  placeholder?: NumberInputProps['placeholder']\n  /** Override the rendered number input component. */\n  FieldComponent?: ComponentType<NumberInputProps>\n}\n\n/**\n * Single per-account entry surfaced on `form.Fields.splits`. Each entry\n * carries identifying metadata for the underlying bank account plus the bound\n * Field component for its split amount.\n *\n * @public\n */\nexport interface SplitFieldEntry {\n  /** Bank account uuid that this split targets. */\n  uuid: string\n  /** Display name of the bank account, when available. */\n  name: string | null\n  /** Last-four masking string for the bank account number, when available. */\n  hiddenAccountNumber: string | null\n  /** Bound Field component for this split's amount input. */\n  Field: ComponentType<SplitFieldProps>\n}\n\ninterface BuildSplitFieldsInput {\n  uuid: string\n  name: string | null\n  hiddenAccountNumber: string | null\n}\n\nfunction createBoundSplitField(uuid: string): ComponentType<SplitFieldProps> {\n  function BoundSplitField({\n    label,\n    description,\n    formHookResult,\n    validationMessages,\n    min,\n    max,\n    placeholder,\n    FieldComponent,\n  }: SplitFieldProps) {\n    const externalControl = formHookResult?.form.hookFormInternals.formMethods.control as\n      | Control<SplitPaymentsFormData>\n      | undefined\n    const splitBy = useWatch({ control: externalControl, name: 'splitBy' })\n    const format: NumberInputProps['format'] = splitBy === SPLIT_BY.amount ? 'currency' : 'percent'\n\n    return (\n      <NumberInputHookField<SplitFieldValidation>\n        name={`splitAmount.${uuid}`}\n        formHookResult={formHookResult}\n        label={label}\n        description={description}\n        validationMessages={validationMessages}\n        format={format}\n        min={min}\n        max={max}\n        placeholder={placeholder}\n        FieldComponent={FieldComponent}\n      />\n    )\n  }\n  BoundSplitField.displayName = `SplitField(${uuid})`\n  return BoundSplitField\n}\n\n/**\n * Build the per-split bound Field components. The caller is responsible for\n * memoizing on the stable set of split uuids so Field identity stays stable\n * across mode toggles and reorders — those changes are observed inside each\n * Field rather than baked into the closure.\n *\n * @internal\n */\nexport function buildSplitFieldEntries(splits: BuildSplitFieldsInput[]): SplitFieldEntry[] {\n  return splits.map(split => ({\n    uuid: split.uuid,\n    name: split.name,\n    hiddenAccountNumber: split.hiddenAccountNumber,\n    Field: createBoundSplitField(split.uuid),\n  }))\n}\n"],"names":["createBoundSplitField","uuid","BoundSplitField","label","description","formHookResult","validationMessages","min","max","placeholder","FieldComponent","externalControl","format","useWatch","SPLIT_BY","jsx","NumberInputHookField","buildSplitFieldEntries","splits","split"],"mappings":";;;;AA6EA,SAASA,EAAsBC,GAA8C;AAC3E,WAASC,EAAgB;AAAA,IACvB,OAAAC;AAAA,IACA,aAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,oBAAAC;AAAA,IACA,KAAAC;AAAA,IACA,KAAAC;AAAA,IACA,aAAAC;AAAA,IACA,gBAAAC;AAAA,EAAA,GACkB;AAClB,UAAMC,IAAkBN,GAAgB,KAAK,kBAAkB,YAAY,SAIrEO,IADUC,EAAS,EAAE,SAASF,GAAiB,MAAM,WAAW,MACfG,EAAS,SAAS,aAAa;AAEtF,WACE,gBAAAC;AAAA,MAACC;AAAA,MAAA;AAAA,QACC,MAAM,eAAef,CAAI;AAAA,QACzB,gBAAAI;AAAA,QACA,OAAAF;AAAA,QACA,aAAAC;AAAA,QACA,oBAAAE;AAAA,QACA,QAAAM;AAAA,QACA,KAAAL;AAAA,QACA,KAAAC;AAAA,QACA,aAAAC;AAAA,QACA,gBAAAC;AAAA,MAAA;AAAA,IAAA;AAAA,EAGN;AACA,SAAAR,EAAgB,cAAc,cAAcD,CAAI,KACzCC;AACT;AAUO,SAASe,EAAuBC,GAAoD;AACzF,SAAOA,EAAO,IAAI,CAAAC,OAAU;AAAA,IAC1B,MAAMA,EAAM;AAAA,IACZ,MAAMA,EAAM;AAAA,IACZ,qBAAqBA,EAAM;AAAA,IAC3B,OAAOnB,EAAsBmB,EAAM,IAAI;AAAA,EAAA,EACvC;AACJ;"}

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsForm.d.ts

@@ -6,49 +6,93 @@ import { SplitByValue, SplitPaymentsFormData, SplitPaymentsFormOptionalFieldsToR
 import { SplitByFieldProps } from './fields';
 import { SplitFieldEntry } from './splitFieldFactory';
 import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+/**
+ * A single split entry — pairs a bank account identifier with its current split allocation.
+ *
+ * @remarks
+ * Surfaced on `data.splits` from {@link useSplitPaymentsForm}. Derived from
+ * `paymentMethod.splits` when present, otherwise from the employee's bank
+ * accounts (one entry per account, no allocated amount). Carries the raw
+ * domain data — use it for label construction or lookups by uuid.
+ *
+ * @public
+ */
 export interface WorkingSplit {
+    /** UUID of the underlying bank account. */
     uuid: string;
+    /** Account nickname, when available. */
     name: string | null;
+    /** Masked account number suffix, when available. */
     hiddenAccountNumber: string | null;
+    /** Allocation amount — `null` for the remainder split in Amount mode and for splits that haven't been allocated yet. */
     splitAmount: number | null;
+    /** Ordering value — splits are processed in ascending priority; the highest priority is the remainder. */
     priority: number;
 }
+/**
+ * Props for {@link useSplitPaymentsForm}.
+ *
+ * @public
+ */
 export interface UseSplitPaymentsFormProps {
+    /** Employee whose payment splits are being edited. */
     employeeId: string;
+    /** Override optional fields to be required. Currently a no-op — `splitBy` and `priority` are always required, and per-split `splitAmount` required-ness is automatic. */
     optionalFieldsToRequire?: SplitPaymentsFormOptionalFieldsToRequire;
+    /** When validation runs. Passed through to react-hook-form. Defaults to `'onSubmit'`. */
     validationMode?: UseFormProps['mode'];
+    /** Auto-focus the first invalid field on submit. Set to `false` when using `composeSubmitHandler`. Defaults to `true`. */
     shouldFocusError?: boolean;
 }
+/**
+ * Field components exposed by {@link useSplitPaymentsForm} on `form.Fields`.
+ *
+ * @public
+ */
 export interface SplitPaymentsFormFields {
+    /** Bound to `splitBy` — see {@link SplitByField}. */
     SplitBy: ComponentType<SplitByFieldProps>;
+    /** One entry per bank account, each carrying a pre-bound `Field` component for the per-split amount. */
     splits: SplitFieldEntry[];
 }
+/**
+ * Ready-state return value of {@link useSplitPaymentsForm}.
+ *
+ * @public
+ */
 export interface UseSplitPaymentsFormReady extends BaseFormHookReady<FieldsMetadata, SplitPaymentsFormData, SplitPaymentsFormFields> {
+    /** Server-fetched data and derived working values. */
     data: {
+        /** The employee's current payment method. */
         paymentMethod: EmployeePaymentMethod;
+        /** All bank accounts available to allocate splits across. */
         bankAccounts: EmployeeBankAccount[];
+        /** The current working split entries, one per bank account. */
         splits: WorkingSplit[];
         /** UUID of the split that absorbs the remainder in Amount mode (always the last by priority). */
         remainderId: string;
     };
+    /** Submission state and reactive form-level flags. */
     status: {
+        /** `true` while the update mutation is in flight. */
         isPending: boolean;
+        /** Always `'update'` — the hook always edits an existing payment method. */
         mode: 'update';
         /** Current `splitBy` value, reactively tracked. */
         splitBy: SplitByValue;
         /** Live sum of `splitAmount` values; useful for displaying the current total in Percentage mode. */
         percentageTotal: number;
         /**
-         * Mirrors the schema-emitted `PERCENTAGE_TOTAL_MISMATCH` error at the
-         * synthetic form path. Tracks `formState.errors` directly and follows
-         * the standard react-hook-form validation lifecycle: with the default
-         * `validationMode: 'onSubmit'`, becomes `true` after the first failed
-         * Save attempt and clears live as the user corrects the total. Only
-         * surfaces in Percentage mode.
+         * `true` after a failed Percentage-mode Save when the splits don't sum to
+         * 100; clears live as the user corrects the total. Follows the standard
+         * react-hook-form validation lifecycle (controlled by `validationMode`).
+         * Only surfaces in Percentage mode.
          */
         hasPercentageImbalance: boolean;
     };
+    /** Actions that mutate the form or submit it. */
     actions: {
+        /** Submit the form. Returns the updated payment method on success or `undefined` on validation/mutation failure. */
         onSubmit: () => Promise<HookSubmitResult<EmployeePaymentMethod> | undefined>;
         /**
          * Reorder splits by uuid (Amount mode). Pass the ordered list of split
@@ -59,7 +103,80 @@ export interface UseSplitPaymentsFormReady extends BaseFormHookReady<FieldsMetad
         reorderSplits: (orderedUuids: string[]) => void;
     };
 }
+/**
+ * Headless React Hook Form hook for splitting an employee's Direct Deposit across multiple bank accounts.
+ *
+ * @remarks
+ * Supports two split modes: Percentage (whole-number shares that sum to 100)
+ * and Amount (dollar amounts, with the last-priority split absorbing the
+ * remainder). Always operates in update mode against the employee's existing
+ * payment method.
+ *
+ * The Percentage sum-to-100 invariant is surfaced via
+ * `status.hasPercentageImbalance` (not as a per-field error). With the default
+ * `validationMode: 'onSubmit'`, the imbalance flag appears after the first
+ * failed Save and clears live as the user corrects the total.
+ *
+ * @param props - See {@link UseSplitPaymentsFormProps}.
+ * @returns A loading-state result while the payment method and bank accounts are loading, or a {@link UseSplitPaymentsFormReady} once ready.
+ * @public
+ *
+ * @example
+ * ```tsx
+ * import {
+ *   useSplitPaymentsForm,
+ *   SDKFormProvider,
+ *   type SplitByValue,
+ *   type UseSplitPaymentsFormReady,
+ * } from '@gusto/embedded-react-sdk'
+ *
+ * function SplitPaycheckScreen({ employeeId }: { employeeId: string }) {
+ *   const splitForm = useSplitPaymentsForm({ employeeId })
+ *
+ *   if (splitForm.isLoading) return null
+ *   return <SplitPaycheckReady splitForm={splitForm} />
+ * }
+ *
+ * function SplitPaycheckReady({ splitForm }: { splitForm: UseSplitPaymentsFormReady }) {
+ *   const { Fields } = splitForm.form
+ *   const { hasPercentageImbalance, percentageTotal } = splitForm.status
+ *
+ *   return (
+ *     <SDKFormProvider formHookResult={splitForm}>
+ *       <form
+ *         onSubmit={e => {
+ *           e.preventDefault()
+ *           void splitForm.actions.onSubmit()
+ *         }}
+ *       >
+ *         {hasPercentageImbalance && (
+ *           <div role="alert">Splits must total 100%. Currently {percentageTotal}%.</div>
+ *         )}
+ *         <Fields.SplitBy label="Split by" getOptionLabel={(value: SplitByValue) => value} />
+ *         {Fields.splits.map(split => (
+ *           <split.Field
+ *             key={split.uuid}
+ *             label={split.name ?? 'Account'}
+ *             min={0}
+ *           />
+ *         ))}
+ *         <button type="submit" disabled={splitForm.status.isPending}>Save</button>
+ *       </form>
+ *     </SDKFormProvider>
+ *   )
+ * }
+ * ```
+ */
 export declare function useSplitPaymentsForm({ employeeId, optionalFieldsToRequire, validationMode, shouldFocusError, }: UseSplitPaymentsFormProps): HookLoadingResult | UseSplitPaymentsFormReady;
+/**
+ * Return type of {@link useSplitPaymentsForm} — a discriminated union on `isLoading`.
+ *
+ * @public
+ */
 export type UseSplitPaymentsFormResult = HookLoadingResult | UseSplitPaymentsFormReady;
+/**
+ * Per-field metadata exposed on `form.fieldsMetadata` for {@link useSplitPaymentsForm}.
+ *
+ * @public
+ */
 export type SplitPaymentsFormFieldsMetadata = UseSplitPaymentsFormReady['form']['fieldsMetadata'];
-export type SplitPaymentsFormFieldsType = UseSplitPaymentsFormReady['form']['Fields'];

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSplitPaymentsForm.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsForm.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useCallback, useEffect, useMemo, useRef } from 'react'\nimport { useForm, useFormState, useWatch } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { EmployeeBankAccount } from '@gusto/embedded-api-v-2025-11-15/models/components/employeebankaccount'\nimport type { EmployeePaymentMethod } from '@gusto/embedded-api-v-2025-11-15/models/components/employeepaymentmethod'\nimport { useEmployeePaymentMethodGet } from '@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodGet'\nimport { useEmployeePaymentMethodsGetBankAccounts } from '@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodsGetBankAccounts'\nimport { useEmployeePaymentMethodUpdateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodUpdate'\nimport {\n  PERCENTAGE_TOTAL_PATH,\n  SPLIT_BY_VALUES,\n  SplitPaymentsFormErrorCodes,\n  type SplitByValue,\n  type SplitPaymentsFormData,\n  type SplitPaymentsFormOptionalFieldsToRequire,\n  type SplitPaymentsFormOutputs,\n  createSplitPaymentsFormSchema,\n} from './useSplitPaymentsFormSchema'\nimport { SplitByField, type SplitByFieldProps } from './fields'\nimport { buildSplitFieldEntries, type SplitFieldEntry } from './splitFieldFactory'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { centsToDollars, dollarsToCents } from '@/helpers/currencyHelpers'\nimport { PAYMENT_METHODS, SPLIT_BY } from '@/shared/constants'\n\nexport interface WorkingSplit {\n  uuid: string\n  name: string | null\n  hiddenAccountNumber: string | null\n  splitAmount: number | null\n  priority: number\n}\n\nexport interface UseSplitPaymentsFormProps {\n  employeeId: string\n  optionalFieldsToRequire?: SplitPaymentsFormOptionalFieldsToRequire\n  validationMode?: UseFormProps['mode']\n  shouldFocusError?: boolean\n}\n\nexport interface SplitPaymentsFormFields {\n  SplitBy: ComponentType<SplitByFieldProps>\n  splits: SplitFieldEntry[]\n}\n\nexport interface UseSplitPaymentsFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  SplitPaymentsFormData,\n  SplitPaymentsFormFields\n> {\n  data: {\n    paymentMethod: EmployeePaymentMethod\n    bankAccounts: EmployeeBankAccount[]\n    splits: WorkingSplit[]\n    /** UUID of the split that absorbs the remainder in Amount mode (always the last by priority). */\n    remainderId: string\n  }\n  status: {\n    isPending: boolean\n    mode: 'update'\n    /** Current `splitBy` value, reactively tracked. */\n    splitBy: SplitByValue\n    /** Live sum of `splitAmount` values; useful for displaying the current total in Percentage mode. */\n    percentageTotal: number\n    /**\n     * Mirrors the schema-emitted `PERCENTAGE_TOTAL_MISMATCH` error at the\n     * synthetic form path. Tracks `formState.errors` directly and follows\n     * the standard react-hook-form validation lifecycle: with the default\n     * `validationMode: 'onSubmit'`, becomes `true` after the first failed\n     * Save attempt and clears live as the user corrects the total. Only\n     * surfaces in Percentage mode.\n     */\n    hasPercentageImbalance: boolean\n  }\n  actions: {\n    onSubmit: () => Promise<HookSubmitResult<EmployeePaymentMethod> | undefined>\n    /**\n     * Reorder splits by uuid (Amount mode). Pass the ordered list of split\n     * uuids; the last uuid becomes the remainder. The hook writes the new\n     * priority map and re-anchors the remainder's `splitAmount` to `null`\n     * (clearing the previous remainder to `0`).\n     */\n    reorderSplits: (orderedUuids: string[]) => void\n  }\n}\n\nconst buildWorkingSplits = (\n  paymentMethod: EmployeePaymentMethod,\n  bankAccounts: EmployeeBankAccount[],\n): WorkingSplit[] => {\n  if (paymentMethod.splits && paymentMethod.splits.length > 0) {\n    return paymentMethod.splits.map(split => ({\n      uuid: split.uuid,\n      name: split.name ?? null,\n      hiddenAccountNumber: split.hiddenAccountNumber ?? null,\n      splitAmount: split.splitAmount ?? null,\n      priority: split.priority ?? 0,\n    }))\n  }\n  return bankAccounts.map((account, index) => ({\n    uuid: account.uuid,\n    name: account.name ?? null,\n    hiddenAccountNumber: account.hiddenAccountNumber ?? null,\n    splitAmount: null,\n    priority: index + 1,\n  }))\n}\n\nexport function useSplitPaymentsForm({\n  employeeId,\n  optionalFieldsToRequire,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseSplitPaymentsFormProps): HookLoadingResult | UseSplitPaymentsFormReady {\n  const paymentMethodQuery = useEmployeePaymentMethodGet({ employeeId })\n  const bankAccountsQuery = useEmployeePaymentMethodsGetBankAccounts({ employeeId })\n\n  const paymentMethod = paymentMethodQuery.data?.employeePaymentMethod\n  const bankAccounts = bankAccountsQuery.data?.employeeBankAccounts\n\n  const splits = useMemo<WorkingSplit[]>(\n    () => (paymentMethod && bankAccounts ? buildWorkingSplits(paymentMethod, bankAccounts) : []),\n    [paymentMethod, bankAccounts],\n  )\n\n  const [schema, metadataConfig] = useMemo(\n    () => createSplitPaymentsFormSchema({ optionalFieldsToRequire }),\n    [optionalFieldsToRequire],\n  )\n\n  const resolvedDefaults: SplitPaymentsFormData = useMemo(() => {\n    const isAmountSplit = paymentMethod?.splitBy === SPLIT_BY.amount\n    const splitAmount: Record<string, number | null> = {}\n    const priority: Record<string, number> = {}\n    splits.forEach(split => {\n      splitAmount[split.uuid] = isAmountSplit\n        ? centsToDollars(split.splitAmount)\n        : split.splitAmount\n      priority[split.uuid] = split.priority\n    })\n    return {\n      splitBy: (paymentMethod?.splitBy ?? SPLIT_BY.percentage) as SplitByValue,\n      splitAmount,\n      priority,\n    }\n  }, [paymentMethod, splits])\n\n  const formMethods = useForm<SplitPaymentsFormData, unknown, SplitPaymentsFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const updateMutation = useEmployeePaymentMethodUpdateMutation()\n  const isPending = updateMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('SplitPaymentsForm')\n\n  const errorHandling = composeErrorHandler([paymentMethodQuery, bankAccountsQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const watchedSplitBy = useWatch({ control: formMethods.control, name: 'splitBy' })\n  const watchedPriority = useWatch({ control: formMethods.control, name: 'priority' })\n  const watchedSplitAmount = useWatch({ control: formMethods.control, name: 'splitAmount' })\n\n  const percentageTotal = useMemo(() => {\n    if (watchedSplitBy !== SPLIT_BY.percentage) return 0\n    return Object.values(watchedSplitAmount).reduce<number>(\n      (acc, v) => acc + (typeof v === 'number' && Number.isFinite(v) ? v : 0),\n      0,\n    )\n  }, [watchedSplitBy, watchedSplitAmount])\n\n  // Subscribe to the schema-emitted imbalance error. The schema places it at\n  // a synthetic path (`PERCENTAGE_TOTAL_PATH`) so it does not collide with\n  // per-uuid `splitAmount.<uuid>` errors. Following the standard validation\n  // lifecycle means `validationMode` (onSubmit / onChange / onBlur / ...)\n  // controls when the alert can appear. We subscribe to the full errors map\n  // because `name` only tracks registered field paths and our synthetic key\n  // is not a registered field. The derivation is also gated on Percentage\n  // mode so a stale error from a prior Percentage submit can't leak into\n  // Amount mode after a toggle.\n  const { errors: validationErrors, isSubmitted } = useFormState({\n    control: formMethods.control,\n  })\n  const hasPercentageImbalance =\n    watchedSplitBy === SPLIT_BY.percentage &&\n    (validationErrors as Record<string, { message?: string } | undefined>)[PERCENTAGE_TOTAL_PATH]\n      ?.message === SplitPaymentsFormErrorCodes.PERCENTAGE_TOTAL_MISMATCH\n\n  // Re-sync the synthetic PERCENTAGE_TOTAL_PATH error whenever any\n  // `splitAmount` value changes (in Percentage mode, after the first\n  // submit attempt). RHF's per-field reValidate after a failed submit\n  // scopes the resolver merge to the changed field's name, so an error\n  // at our form-level synthetic path is otherwise left stuck once the\n  // user has typed the total back to 100. Targeting the synthetic name\n  // re-runs the resolver and lets RHF set/unset that single path through\n  // its normal merge — preserving per-field error lifecycles unchanged.\n  const { trigger } = formMethods\n  useEffect(() => {\n    if (!isSubmitted) return\n    if (watchedSplitBy !== SPLIT_BY.percentage) return\n    // `trigger`'s type is keyed to registered field paths, but the\n    // synthetic `percentageTotal` resolves through RHF's get/set/unset\n    // helpers at runtime — cast at the boundary to keep the contract\n    // honest above.\n    void trigger(PERCENTAGE_TOTAL_PATH as Parameters<typeof trigger>[0])\n  }, [isSubmitted, watchedSplitBy, watchedSplitAmount, trigger])\n\n  const remainderId = useMemo(() => {\n    if (!Object.keys(watchedPriority).length) return ''\n    return Object.entries(watchedPriority).reduce((maxId, [uuid, priority]) => {\n      if (!maxId) return uuid\n      const currentMax = watchedPriority[maxId] ?? 0\n      return priority > currentMax ? uuid : maxId\n    }, '')\n  }, [watchedPriority])\n\n  // Reset splitAmount values when the user toggles splitBy. Skip the first\n  // post-load run so values loaded from `paymentMethod.splits` are preserved\n  // on mount — only the user's explicit toggle should clear them.\n  const splitsRef = useRef(splits)\n  splitsRef.current = splits\n  const remainderIdRef = useRef(remainderId)\n  remainderIdRef.current = remainderId\n  const previousSplitByRef = useRef<SplitByValue | null>(null)\n  const { setValue, resetField } = formMethods\n\n  useEffect(() => {\n    if (!splitsRef.current.length) return\n    if (previousSplitByRef.current === null) {\n      previousSplitByRef.current = watchedSplitBy as SplitByValue\n      return\n    }\n    if (previousSplitByRef.current === watchedSplitBy) return\n    previousSplitByRef.current = watchedSplitBy as SplitByValue\n\n    if (watchedSplitBy === SPLIT_BY.amount) {\n      const newValues = splitsRef.current.reduce<Record<string, number | null>>((acc, curr) => {\n        acc[curr.uuid] = curr.uuid === remainderIdRef.current ? null : 0\n        return acc\n      }, {})\n      setValue('splitAmount', newValues)\n    } else {\n      const newValues = splitsRef.current.reduce<Record<string, number | null>>(\n        (acc, curr, index) => {\n          acc[curr.uuid] = index === 0 ? 100 : 0\n          return acc\n        },\n        {},\n      )\n      setValue('splitAmount', newValues)\n    }\n  }, [watchedSplitBy, setValue])\n\n  const reorderSplits = useCallback(\n    (orderedUuids: string[]) => {\n      const currentSplits = splitsRef.current\n      const knownUuids = new Set(currentSplits.map(s => s.uuid))\n      if (\n        orderedUuids.length !== knownUuids.size ||\n        !orderedUuids.every(uuid => knownUuids.has(uuid))\n      ) {\n        return\n      }\n\n      const newPriorities = orderedUuids.reduce<Record<string, number>>((acc, uuid, index) => {\n        acc[uuid] = index + 1\n        return acc\n      }, {})\n      const newRemainderId = orderedUuids[orderedUuids.length - 1]\n      if (!newRemainderId) return\n\n      setValue('priority', newPriorities)\n      const previousRemainder = remainderIdRef.current\n      if (previousRemainder && previousRemainder !== newRemainderId) {\n        resetField(`splitAmount.${previousRemainder}`)\n        setValue(`splitAmount.${previousRemainder}`, 0)\n      }\n      setValue(`splitAmount.${newRemainderId}`, null)\n    },\n    [setValue, resetField],\n  )\n\n  const splitByOptions = SPLIT_BY_VALUES.map(value => ({ value, label: value }))\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const dynamicSplitMetadata = useMemo<FieldsMetadata>(() => {\n    const entries: FieldsMetadata = {}\n    const isAmountSplit = watchedSplitBy === SPLIT_BY.amount\n    for (const split of splits) {\n      const path = `splitAmount.${split.uuid}`\n      const isRemainder = isAmountSplit && split.uuid === remainderId\n      // Every split — including the remainder — is \"required\" from the\n      // user's perspective: the remainder always carries a value at submit\n      // (the API absorbs leftover). The form-state `null` is a modeling\n      // detail, not a UX choice, so we don't surface it as \"(optional)\" on\n      // the label. `isDisabled` already conveys the non-interactivity.\n      entries[path] = {\n        name: path,\n        isRequired: true,\n        isDisabled: isRemainder,\n      }\n    }\n    return entries\n  }, [splits, watchedSplitBy, remainderId])\n  const fieldsMetadata: FieldsMetadata = {\n    splitBy: withOptions<SplitByValue>(baseMetadata.splitBy, splitByOptions, [...SPLIT_BY_VALUES]),\n    splitAmount: baseMetadata.splitAmount,\n    priority: baseMetadata.priority,\n    ...dynamicSplitMetadata,\n  }\n\n  const splitFieldEntries = useMemo(\n    () =>\n      buildSplitFieldEntries(\n        splits.map(s => ({\n          uuid: s.uuid,\n          name: s.name,\n          hiddenAccountNumber: s.hiddenAccountNumber,\n        })),\n      ),\n    [splits],\n  )\n\n  const onSubmit = async (): Promise<HookSubmitResult<EmployeePaymentMethod> | undefined> => {\n    if (!paymentMethod) {\n      throw new SDKInternalError('Cannot submit split payments form before data is loaded')\n    }\n    const currentPaymentMethod = paymentMethod\n    const currentSplits = splits\n    let submitResult: HookSubmitResult<EmployeePaymentMethod> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: SplitPaymentsFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const isAmountSplit = payload.splitBy === SPLIT_BY.amount\n            const body = {\n              ...currentPaymentMethod,\n              version: currentPaymentMethod.version as string,\n              splitBy: payload.splitBy,\n              splits: currentSplits.map(split => {\n                const splitAmountValue = payload.splitAmount[split.uuid] ?? null\n                return {\n                  uuid: split.uuid,\n                  name: split.name ?? undefined,\n                  hiddenAccountNumber: split.hiddenAccountNumber ?? undefined,\n                  splitAmount: isAmountSplit ? dollarsToCents(splitAmountValue) : splitAmountValue,\n                  priority: payload.priority[split.uuid],\n                }\n              }),\n            }\n\n            const response = await updateMutation.mutateAsync({\n              request: {\n                employeeId,\n                requestBody: { ...body, type: PAYMENT_METHODS.directDeposit },\n              },\n            })\n\n            if (!response.employeePaymentMethod) {\n              throw new SDKInternalError('Payment method update failed')\n            }\n\n            submitResult = { mode: 'update' as const, data: response.employeePaymentMethod }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (\n    paymentMethodQuery.isLoading ||\n    bankAccountsQuery.isLoading ||\n    !paymentMethod ||\n    !bankAccounts\n  ) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      paymentMethod,\n      bankAccounts,\n      splits,\n      remainderId,\n    },\n    status: {\n      isPending,\n      mode: 'update' as const,\n      splitBy: watchedSplitBy as SplitByValue,\n      percentageTotal,\n      hasPercentageImbalance,\n    },\n    actions: { onSubmit, reorderSplits },\n    errorHandling,\n    form: {\n      Fields: { SplitBy: SplitByField, splits: splitFieldEntries },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\nexport type UseSplitPaymentsFormResult = HookLoadingResult | UseSplitPaymentsFormReady\nexport type SplitPaymentsFormFieldsMetadata = UseSplitPaymentsFormReady['form']['fieldsMetadata']\nexport type SplitPaymentsFormFieldsType = UseSplitPaymentsFormReady['form']['Fields']\n"],"names":["buildWorkingSplits","paymentMethod","bankAccounts","split","account","index","useSplitPaymentsForm","employeeId","optionalFieldsToRequire","validationMode","shouldFocusError","paymentMethodQuery","useEmployeePaymentMethodGet","bankAccountsQuery","useEmployeePaymentMethodsGetBankAccounts","splits","useMemo","schema","metadataConfig","createSplitPaymentsFormSchema","resolvedDefaults","isAmountSplit","SPLIT_BY","splitAmount","priority","centsToDollars","formMethods","useForm","zodResolver","updateMutation","useEmployeePaymentMethodUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","watchedSplitBy","useWatch","watchedPriority","watchedSplitAmount","percentageTotal","acc","v","validationErrors","isSubmitted","useFormState","hasPercentageImbalance","PERCENTAGE_TOTAL_PATH","SplitPaymentsFormErrorCodes","trigger","useEffect","remainderId","maxId","uuid","currentMax","splitsRef","useRef","remainderIdRef","previousSplitByRef","setValue","resetField","newValues","curr","reorderSplits","useCallback","orderedUuids","currentSplits","knownUuids","s","newPriorities","newRemainderId","previousRemainder","splitByOptions","SPLIT_BY_VALUES","value","baseMetadata","useDeriveFieldsMetadata","dynamicSplitMetadata","entries","path","isRemainder","fieldsMetadata","withOptions","splitFieldEntries","buildSplitFieldEntries","onSubmit","SDKInternalError","currentPaymentMethod","submitResult","resolve","data","payload","body","splitAmountValue","dollarsToCents","response","PAYMENT_METHODS","hookFormInternals","useHookFormInternals","SplitByField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"useSplitPaymentsForm.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsForm.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useCallback, useEffect, useMemo, useRef } from 'react'\nimport { useForm, useFormState, useWatch } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { EmployeeBankAccount } from '@gusto/embedded-api-v-2025-11-15/models/components/employeebankaccount'\nimport type { EmployeePaymentMethod } from '@gusto/embedded-api-v-2025-11-15/models/components/employeepaymentmethod'\nimport { useEmployeePaymentMethodGet } from '@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodGet'\nimport { useEmployeePaymentMethodsGetBankAccounts } from '@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodsGetBankAccounts'\nimport { useEmployeePaymentMethodUpdateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodUpdate'\nimport {\n  PERCENTAGE_TOTAL_PATH,\n  SPLIT_BY_VALUES,\n  SplitPaymentsFormErrorCodes,\n  type SplitByValue,\n  type SplitPaymentsFormData,\n  type SplitPaymentsFormOptionalFieldsToRequire,\n  type SplitPaymentsFormOutputs,\n  createSplitPaymentsFormSchema,\n} from './useSplitPaymentsFormSchema'\nimport { SplitByField, type SplitByFieldProps } from './fields'\nimport { buildSplitFieldEntries, type SplitFieldEntry } from './splitFieldFactory'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { centsToDollars, dollarsToCents } from '@/helpers/currencyHelpers'\nimport { PAYMENT_METHODS, SPLIT_BY } from '@/shared/constants'\n\n/**\n * A single split entry — pairs a bank account identifier with its current split allocation.\n *\n * @remarks\n * Surfaced on `data.splits` from {@link useSplitPaymentsForm}. Derived from\n * `paymentMethod.splits` when present, otherwise from the employee's bank\n * accounts (one entry per account, no allocated amount). Carries the raw\n * domain data — use it for label construction or lookups by uuid.\n *\n * @public\n */\nexport interface WorkingSplit {\n  /** UUID of the underlying bank account. */\n  uuid: string\n  /** Account nickname, when available. */\n  name: string | null\n  /** Masked account number suffix, when available. */\n  hiddenAccountNumber: string | null\n  /** Allocation amount — `null` for the remainder split in Amount mode and for splits that haven't been allocated yet. */\n  splitAmount: number | null\n  /** Ordering value — splits are processed in ascending priority; the highest priority is the remainder. */\n  priority: number\n}\n\n/**\n * Props for {@link useSplitPaymentsForm}.\n *\n * @public\n */\nexport interface UseSplitPaymentsFormProps {\n  /** Employee whose payment splits are being edited. */\n  employeeId: string\n  /** Override optional fields to be required. Currently a no-op — `splitBy` and `priority` are always required, and per-split `splitAmount` required-ness is automatic. */\n  optionalFieldsToRequire?: SplitPaymentsFormOptionalFieldsToRequire\n  /** When validation runs. Passed through to react-hook-form. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Auto-focus the first invalid field on submit. Set to `false` when using `composeSubmitHandler`. Defaults to `true`. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Field components exposed by {@link useSplitPaymentsForm} on `form.Fields`.\n *\n * @public\n */\nexport interface SplitPaymentsFormFields {\n  /** Bound to `splitBy` — see {@link SplitByField}. */\n  SplitBy: ComponentType<SplitByFieldProps>\n  /** One entry per bank account, each carrying a pre-bound `Field` component for the per-split amount. */\n  splits: SplitFieldEntry[]\n}\n\n/**\n * Ready-state return value of {@link useSplitPaymentsForm}.\n *\n * @public\n */\nexport interface UseSplitPaymentsFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  SplitPaymentsFormData,\n  SplitPaymentsFormFields\n> {\n  /** Server-fetched data and derived working values. */\n  data: {\n    /** The employee's current payment method. */\n    paymentMethod: EmployeePaymentMethod\n    /** All bank accounts available to allocate splits across. */\n    bankAccounts: EmployeeBankAccount[]\n    /** The current working split entries, one per bank account. */\n    splits: WorkingSplit[]\n    /** UUID of the split that absorbs the remainder in Amount mode (always the last by priority). */\n    remainderId: string\n  }\n  /** Submission state and reactive form-level flags. */\n  status: {\n    /** `true` while the update mutation is in flight. */\n    isPending: boolean\n    /** Always `'update'` — the hook always edits an existing payment method. */\n    mode: 'update'\n    /** Current `splitBy` value, reactively tracked. */\n    splitBy: SplitByValue\n    /** Live sum of `splitAmount` values; useful for displaying the current total in Percentage mode. */\n    percentageTotal: number\n    /**\n     * `true` after a failed Percentage-mode Save when the splits don't sum to\n     * 100; clears live as the user corrects the total. Follows the standard\n     * react-hook-form validation lifecycle (controlled by `validationMode`).\n     * Only surfaces in Percentage mode.\n     */\n    hasPercentageImbalance: boolean\n  }\n  /** Actions that mutate the form or submit it. */\n  actions: {\n    /** Submit the form. Returns the updated payment method on success or `undefined` on validation/mutation failure. */\n    onSubmit: () => Promise<HookSubmitResult<EmployeePaymentMethod> | undefined>\n    /**\n     * Reorder splits by uuid (Amount mode). Pass the ordered list of split\n     * uuids; the last uuid becomes the remainder. The hook writes the new\n     * priority map and re-anchors the remainder's `splitAmount` to `null`\n     * (clearing the previous remainder to `0`).\n     */\n    reorderSplits: (orderedUuids: string[]) => void\n  }\n}\n\nconst buildWorkingSplits = (\n  paymentMethod: EmployeePaymentMethod,\n  bankAccounts: EmployeeBankAccount[],\n): WorkingSplit[] => {\n  if (paymentMethod.splits && paymentMethod.splits.length > 0) {\n    return paymentMethod.splits.map(split => ({\n      uuid: split.uuid,\n      name: split.name ?? null,\n      hiddenAccountNumber: split.hiddenAccountNumber ?? null,\n      splitAmount: split.splitAmount ?? null,\n      priority: split.priority ?? 0,\n    }))\n  }\n  return bankAccounts.map((account, index) => ({\n    uuid: account.uuid,\n    name: account.name ?? null,\n    hiddenAccountNumber: account.hiddenAccountNumber ?? null,\n    splitAmount: null,\n    priority: index + 1,\n  }))\n}\n\n/**\n * Headless React Hook Form hook for splitting an employee's Direct Deposit across multiple bank accounts.\n *\n * @remarks\n * Supports two split modes: Percentage (whole-number shares that sum to 100)\n * and Amount (dollar amounts, with the last-priority split absorbing the\n * remainder). Always operates in update mode against the employee's existing\n * payment method.\n *\n * The Percentage sum-to-100 invariant is surfaced via\n * `status.hasPercentageImbalance` (not as a per-field error). With the default\n * `validationMode: 'onSubmit'`, the imbalance flag appears after the first\n * failed Save and clears live as the user corrects the total.\n *\n * @param props - See {@link UseSplitPaymentsFormProps}.\n * @returns A loading-state result while the payment method and bank accounts are loading, or a {@link UseSplitPaymentsFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useSplitPaymentsForm,\n *   SDKFormProvider,\n *   type SplitByValue,\n *   type UseSplitPaymentsFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function SplitPaycheckScreen({ employeeId }: { employeeId: string }) {\n *   const splitForm = useSplitPaymentsForm({ employeeId })\n *\n *   if (splitForm.isLoading) return null\n *   return <SplitPaycheckReady splitForm={splitForm} />\n * }\n *\n * function SplitPaycheckReady({ splitForm }: { splitForm: UseSplitPaymentsFormReady }) {\n *   const { Fields } = splitForm.form\n *   const { hasPercentageImbalance, percentageTotal } = splitForm.status\n *\n *   return (\n *     <SDKFormProvider formHookResult={splitForm}>\n *       <form\n *         onSubmit={e => {\n *           e.preventDefault()\n *           void splitForm.actions.onSubmit()\n *         }}\n *       >\n *         {hasPercentageImbalance && (\n *           <div role=\"alert\">Splits must total 100%. Currently {percentageTotal}%.</div>\n *         )}\n *         <Fields.SplitBy label=\"Split by\" getOptionLabel={(value: SplitByValue) => value} />\n *         {Fields.splits.map(split => (\n *           <split.Field\n *             key={split.uuid}\n *             label={split.name ?? 'Account'}\n *             min={0}\n *           />\n *         ))}\n *         <button type=\"submit\" disabled={splitForm.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useSplitPaymentsForm({\n  employeeId,\n  optionalFieldsToRequire,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseSplitPaymentsFormProps): HookLoadingResult | UseSplitPaymentsFormReady {\n  const paymentMethodQuery = useEmployeePaymentMethodGet({ employeeId })\n  const bankAccountsQuery = useEmployeePaymentMethodsGetBankAccounts({ employeeId })\n\n  const paymentMethod = paymentMethodQuery.data?.employeePaymentMethod\n  const bankAccounts = bankAccountsQuery.data?.employeeBankAccounts\n\n  const splits = useMemo<WorkingSplit[]>(\n    () => (paymentMethod && bankAccounts ? buildWorkingSplits(paymentMethod, bankAccounts) : []),\n    [paymentMethod, bankAccounts],\n  )\n\n  const [schema, metadataConfig] = useMemo(\n    () => createSplitPaymentsFormSchema({ optionalFieldsToRequire }),\n    [optionalFieldsToRequire],\n  )\n\n  const resolvedDefaults: SplitPaymentsFormData = useMemo(() => {\n    const isAmountSplit = paymentMethod?.splitBy === SPLIT_BY.amount\n    const splitAmount: Record<string, number | null> = {}\n    const priority: Record<string, number> = {}\n    splits.forEach(split => {\n      splitAmount[split.uuid] = isAmountSplit\n        ? centsToDollars(split.splitAmount)\n        : split.splitAmount\n      priority[split.uuid] = split.priority\n    })\n    return {\n      splitBy: (paymentMethod?.splitBy ?? SPLIT_BY.percentage) as SplitByValue,\n      splitAmount,\n      priority,\n    }\n  }, [paymentMethod, splits])\n\n  const formMethods = useForm<SplitPaymentsFormData, unknown, SplitPaymentsFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const updateMutation = useEmployeePaymentMethodUpdateMutation()\n  const isPending = updateMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('SplitPaymentsForm')\n\n  const errorHandling = composeErrorHandler([paymentMethodQuery, bankAccountsQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const watchedSplitBy = useWatch({ control: formMethods.control, name: 'splitBy' })\n  const watchedPriority = useWatch({ control: formMethods.control, name: 'priority' })\n  const watchedSplitAmount = useWatch({ control: formMethods.control, name: 'splitAmount' })\n\n  const percentageTotal = useMemo(() => {\n    if (watchedSplitBy !== SPLIT_BY.percentage) return 0\n    return Object.values(watchedSplitAmount).reduce<number>(\n      (acc, v) => acc + (typeof v === 'number' && Number.isFinite(v) ? v : 0),\n      0,\n    )\n  }, [watchedSplitBy, watchedSplitAmount])\n\n  // Subscribe to the schema-emitted imbalance error. The schema places it at\n  // a synthetic path (`PERCENTAGE_TOTAL_PATH`) so it does not collide with\n  // per-uuid `splitAmount.<uuid>` errors. Following the standard validation\n  // lifecycle means `validationMode` (onSubmit / onChange / onBlur / ...)\n  // controls when the alert can appear. We subscribe to the full errors map\n  // because `name` only tracks registered field paths and our synthetic key\n  // is not a registered field. The derivation is also gated on Percentage\n  // mode so a stale error from a prior Percentage submit can't leak into\n  // Amount mode after a toggle.\n  const { errors: validationErrors, isSubmitted } = useFormState({\n    control: formMethods.control,\n  })\n  const hasPercentageImbalance =\n    watchedSplitBy === SPLIT_BY.percentage &&\n    (validationErrors as Record<string, { message?: string } | undefined>)[PERCENTAGE_TOTAL_PATH]\n      ?.message === SplitPaymentsFormErrorCodes.PERCENTAGE_TOTAL_MISMATCH\n\n  // Re-sync the synthetic PERCENTAGE_TOTAL_PATH error whenever any\n  // `splitAmount` value changes (in Percentage mode, after the first\n  // submit attempt). RHF's per-field reValidate after a failed submit\n  // scopes the resolver merge to the changed field's name, so an error\n  // at our form-level synthetic path is otherwise left stuck once the\n  // user has typed the total back to 100. Targeting the synthetic name\n  // re-runs the resolver and lets RHF set/unset that single path through\n  // its normal merge — preserving per-field error lifecycles unchanged.\n  const { trigger } = formMethods\n  useEffect(() => {\n    if (!isSubmitted) return\n    if (watchedSplitBy !== SPLIT_BY.percentage) return\n    // `trigger`'s type is keyed to registered field paths, but the\n    // synthetic `percentageTotal` resolves through RHF's get/set/unset\n    // helpers at runtime — cast at the boundary to keep the contract\n    // honest above.\n    void trigger(PERCENTAGE_TOTAL_PATH as Parameters<typeof trigger>[0])\n  }, [isSubmitted, watchedSplitBy, watchedSplitAmount, trigger])\n\n  const remainderId = useMemo(() => {\n    if (!Object.keys(watchedPriority).length) return ''\n    return Object.entries(watchedPriority).reduce((maxId, [uuid, priority]) => {\n      if (!maxId) return uuid\n      const currentMax = watchedPriority[maxId] ?? 0\n      return priority > currentMax ? uuid : maxId\n    }, '')\n  }, [watchedPriority])\n\n  // Reset splitAmount values when the user toggles splitBy. Skip the first\n  // post-load run so values loaded from `paymentMethod.splits` are preserved\n  // on mount — only the user's explicit toggle should clear them.\n  const splitsRef = useRef(splits)\n  splitsRef.current = splits\n  const remainderIdRef = useRef(remainderId)\n  remainderIdRef.current = remainderId\n  const previousSplitByRef = useRef<SplitByValue | null>(null)\n  const { setValue, resetField } = formMethods\n\n  useEffect(() => {\n    if (!splitsRef.current.length) return\n    if (previousSplitByRef.current === null) {\n      previousSplitByRef.current = watchedSplitBy as SplitByValue\n      return\n    }\n    if (previousSplitByRef.current === watchedSplitBy) return\n    previousSplitByRef.current = watchedSplitBy as SplitByValue\n\n    if (watchedSplitBy === SPLIT_BY.amount) {\n      const newValues = splitsRef.current.reduce<Record<string, number | null>>((acc, curr) => {\n        acc[curr.uuid] = curr.uuid === remainderIdRef.current ? null : 0\n        return acc\n      }, {})\n      setValue('splitAmount', newValues)\n    } else {\n      const newValues = splitsRef.current.reduce<Record<string, number | null>>(\n        (acc, curr, index) => {\n          acc[curr.uuid] = index === 0 ? 100 : 0\n          return acc\n        },\n        {},\n      )\n      setValue('splitAmount', newValues)\n    }\n  }, [watchedSplitBy, setValue])\n\n  const reorderSplits = useCallback(\n    (orderedUuids: string[]) => {\n      const currentSplits = splitsRef.current\n      const knownUuids = new Set(currentSplits.map(s => s.uuid))\n      if (\n        orderedUuids.length !== knownUuids.size ||\n        !orderedUuids.every(uuid => knownUuids.has(uuid))\n      ) {\n        return\n      }\n\n      const newPriorities = orderedUuids.reduce<Record<string, number>>((acc, uuid, index) => {\n        acc[uuid] = index + 1\n        return acc\n      }, {})\n      const newRemainderId = orderedUuids[orderedUuids.length - 1]\n      if (!newRemainderId) return\n\n      setValue('priority', newPriorities)\n      const previousRemainder = remainderIdRef.current\n      if (previousRemainder && previousRemainder !== newRemainderId) {\n        resetField(`splitAmount.${previousRemainder}`)\n        setValue(`splitAmount.${previousRemainder}`, 0)\n      }\n      setValue(`splitAmount.${newRemainderId}`, null)\n    },\n    [setValue, resetField],\n  )\n\n  const splitByOptions = SPLIT_BY_VALUES.map(value => ({ value, label: value }))\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const dynamicSplitMetadata = useMemo<FieldsMetadata>(() => {\n    const entries: FieldsMetadata = {}\n    const isAmountSplit = watchedSplitBy === SPLIT_BY.amount\n    for (const split of splits) {\n      const path = `splitAmount.${split.uuid}`\n      const isRemainder = isAmountSplit && split.uuid === remainderId\n      // Every split — including the remainder — is \"required\" from the\n      // user's perspective: the remainder always carries a value at submit\n      // (the API absorbs leftover). The form-state `null` is a modeling\n      // detail, not a UX choice, so we don't surface it as \"(optional)\" on\n      // the label. `isDisabled` already conveys the non-interactivity.\n      entries[path] = {\n        name: path,\n        isRequired: true,\n        isDisabled: isRemainder,\n      }\n    }\n    return entries\n  }, [splits, watchedSplitBy, remainderId])\n  const fieldsMetadata: FieldsMetadata = {\n    splitBy: withOptions<SplitByValue>(baseMetadata.splitBy, splitByOptions, [...SPLIT_BY_VALUES]),\n    splitAmount: baseMetadata.splitAmount,\n    priority: baseMetadata.priority,\n    ...dynamicSplitMetadata,\n  }\n\n  const splitFieldEntries = useMemo(\n    () =>\n      buildSplitFieldEntries(\n        splits.map(s => ({\n          uuid: s.uuid,\n          name: s.name,\n          hiddenAccountNumber: s.hiddenAccountNumber,\n        })),\n      ),\n    [splits],\n  )\n\n  const onSubmit = async (): Promise<HookSubmitResult<EmployeePaymentMethod> | undefined> => {\n    if (!paymentMethod) {\n      throw new SDKInternalError('Cannot submit split payments form before data is loaded')\n    }\n    const currentPaymentMethod = paymentMethod\n    const currentSplits = splits\n    let submitResult: HookSubmitResult<EmployeePaymentMethod> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: SplitPaymentsFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const isAmountSplit = payload.splitBy === SPLIT_BY.amount\n            const body = {\n              ...currentPaymentMethod,\n              version: currentPaymentMethod.version as string,\n              splitBy: payload.splitBy,\n              splits: currentSplits.map(split => {\n                const splitAmountValue = payload.splitAmount[split.uuid] ?? null\n                return {\n                  uuid: split.uuid,\n                  name: split.name ?? undefined,\n                  hiddenAccountNumber: split.hiddenAccountNumber ?? undefined,\n                  splitAmount: isAmountSplit ? dollarsToCents(splitAmountValue) : splitAmountValue,\n                  priority: payload.priority[split.uuid],\n                }\n              }),\n            }\n\n            const response = await updateMutation.mutateAsync({\n              request: {\n                employeeId,\n                requestBody: { ...body, type: PAYMENT_METHODS.directDeposit },\n              },\n            })\n\n            if (!response.employeePaymentMethod) {\n              throw new SDKInternalError('Payment method update failed')\n            }\n\n            submitResult = { mode: 'update' as const, data: response.employeePaymentMethod }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (\n    paymentMethodQuery.isLoading ||\n    bankAccountsQuery.isLoading ||\n    !paymentMethod ||\n    !bankAccounts\n  ) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      paymentMethod,\n      bankAccounts,\n      splits,\n      remainderId,\n    },\n    status: {\n      isPending,\n      mode: 'update' as const,\n      splitBy: watchedSplitBy as SplitByValue,\n      percentageTotal,\n      hasPercentageImbalance,\n    },\n    actions: { onSubmit, reorderSplits },\n    errorHandling,\n    form: {\n      Fields: { SplitBy: SplitByField, splits: splitFieldEntries },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Return type of {@link useSplitPaymentsForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UseSplitPaymentsFormResult = HookLoadingResult | UseSplitPaymentsFormReady\n\n/**\n * Per-field metadata exposed on `form.fieldsMetadata` for {@link useSplitPaymentsForm}.\n *\n * @public\n */\nexport type SplitPaymentsFormFieldsMetadata = UseSplitPaymentsFormReady['form']['fieldsMetadata']\n"],"names":["buildWorkingSplits","paymentMethod","bankAccounts","split","account","index","useSplitPaymentsForm","employeeId","optionalFieldsToRequire","validationMode","shouldFocusError","paymentMethodQuery","useEmployeePaymentMethodGet","bankAccountsQuery","useEmployeePaymentMethodsGetBankAccounts","splits","useMemo","schema","metadataConfig","createSplitPaymentsFormSchema","resolvedDefaults","isAmountSplit","SPLIT_BY","splitAmount","priority","centsToDollars","formMethods","useForm","zodResolver","updateMutation","useEmployeePaymentMethodUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","watchedSplitBy","useWatch","watchedPriority","watchedSplitAmount","percentageTotal","acc","v","validationErrors","isSubmitted","useFormState","hasPercentageImbalance","PERCENTAGE_TOTAL_PATH","SplitPaymentsFormErrorCodes","trigger","useEffect","remainderId","maxId","uuid","currentMax","splitsRef","useRef","remainderIdRef","previousSplitByRef","setValue","resetField","newValues","curr","reorderSplits","useCallback","orderedUuids","currentSplits","knownUuids","s","newPriorities","newRemainderId","previousRemainder","splitByOptions","SPLIT_BY_VALUES","value","baseMetadata","useDeriveFieldsMetadata","dynamicSplitMetadata","entries","path","isRemainder","fieldsMetadata","withOptions","splitFieldEntries","buildSplitFieldEntries","onSubmit","SDKInternalError","currentPaymentMethod","submitResult","resolve","data","payload","body","splitAmountValue","dollarsToCents","response","PAYMENT_METHODS","hookFormInternals","useHookFormInternals","SplitByField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsFormSchema.d.ts

@@ -1,5 +1,11 @@
 import { z } from 'zod';
 import { OptionalFieldsToRequire } from '../../../../../partner-hook-utils/form/buildFormSchema';
+/**
+ * Validation error codes emitted by the split payments form schema. Map these
+ * codes to localized copy in `validationMessages` when composing the hook.
+ *
+ * @public
+ */
 export declare const SplitPaymentsFormErrorCodes: {
     readonly REQUIRED: "REQUIRED";
     readonly INVALID_PERCENTAGE: "INVALID_PERCENTAGE";
@@ -11,10 +17,29 @@ export declare const SplitPaymentsFormErrorCodes: {
  * Synthetic form path where the schema emits the percentage-sum-to-100
  * invariant. The hook subscribes to errors at this path to drive
  * `status.hasPercentageImbalance`.
+ *
+ * @internal
  */
 export declare const PERCENTAGE_TOTAL_PATH: "percentageTotal";
+/**
+ * Union of validation error code strings emitted by the split payments form
+ * schema.
+ *
+ * @public
+ */
 export type SplitPaymentsFormErrorCode = (typeof SplitPaymentsFormErrorCodes)[keyof typeof SplitPaymentsFormErrorCodes];
+/**
+ * Supported split-by modes: split by percentage of net pay, or by fixed dollar
+ * amount per account.
+ *
+ * @public
+ */
 export declare const SPLIT_BY_VALUES: readonly ["Percentage", "Amount"];
+/**
+ * Union of split-by mode values that the form accepts.
+ *
+ * @public
+ */
 export type SplitByValue = (typeof SPLIT_BY_VALUES)[number];
 declare const fieldValidators: {
     splitBy: z.ZodEnum<{
@@ -24,24 +49,45 @@ declare const fieldValidators: {
     splitAmount: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>>;
     priority: z.ZodRecord<z.ZodString, z.ZodNumber>;
 };
+/**
+ * Field names accepted by the split payments form.
+ *
+ * @public
+ */
 export type SplitPaymentsFormField = keyof typeof fieldValidators;
+/**
+ * Shape of the values managed by the split payments form. `splitAmount` and
+ * `priority` are keyed by bank account uuid.
+ *
+ * @public
+ */
 export type SplitPaymentsFormData = {
+    /** Selected split mode — by percentage or by fixed amount. */
     splitBy: SplitByValue;
+    /** Per-account split values keyed by bank account uuid (percent or dollars depending on `splitBy`). */
     splitAmount: Record<string, number | null>;
+    /** Per-account priority values keyed by bank account uuid; the highest priority receives the remainder. */
     priority: Record<string, number>;
 };
+/**
+ * Shape of the validated values produced by the split payments form on submit.
+ *
+ * @public
+ */
 export type SplitPaymentsFormOutputs = SplitPaymentsFormData;
 declare const requiredFieldsConfig: {};
+/**
+ * Keys of optional split payments fields that can be promoted to required via
+ * the hook's `optionalFieldsToRequire` option.
+ *
+ * @public
+ */
 export type SplitPaymentsFormOptionalFieldsToRequire = OptionalFieldsToRequire<typeof requiredFieldsConfig>;
+/** @internal */
 interface SplitPaymentsFormSchemaOptions {
     optionalFieldsToRequire?: SplitPaymentsFormOptionalFieldsToRequire;
 }
-/**
- * Resolves the remainder uuid (highest priority value) from a priority map.
- * Exported so the hook can mirror the same selection rule when deriving
- * dynamic field metadata.
- */
-export declare function resolveRemainderUuid(priority: Record<string, number>): string;
+/** @internal */
 export declare function createSplitPaymentsFormSchema(options?: SplitPaymentsFormSchemaOptions): import('../../../../../partner-hook-utils/form/buildFormSchema').BuildFormSchemaResult<{
     splitBy: z.ZodEnum<{
         Percentage: "Percentage";

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsFormSchema.js

@@ -87,7 +87,6 @@ export {
   m as PERCENTAGE_TOTAL_PATH,
   c as SPLIT_BY_VALUES,
   u as SplitPaymentsFormErrorCodes,
-  C as createSplitPaymentsFormSchema,
-  A as resolveRemainderUuid
+  C as createSplitPaymentsFormSchema
 };
 //# sourceMappingURL=useSplitPaymentsFormSchema.js.map

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsFormSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSplitPaymentsFormSchema.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type OptionalFieldsToRequire,\n  type RequiredFieldConfig,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { SPLIT_BY } from '@/shared/constants'\n\nexport const SplitPaymentsFormErrorCodes = {\n  REQUIRED: 'REQUIRED',\n  INVALID_PERCENTAGE: 'INVALID_PERCENTAGE',\n  INVALID_AMOUNT: 'INVALID_AMOUNT',\n  DUPLICATE_PRIORITIES: 'DUPLICATE_PRIORITIES',\n  PERCENTAGE_TOTAL_MISMATCH: 'PERCENTAGE_TOTAL_MISMATCH',\n} as const\n\n/**\n * Synthetic form path where the schema emits the percentage-sum-to-100\n * invariant. The hook subscribes to errors at this path to drive\n * `status.hasPercentageImbalance`.\n */\nexport const PERCENTAGE_TOTAL_PATH = 'percentageTotal' as const\n\nexport type SplitPaymentsFormErrorCode =\n  (typeof SplitPaymentsFormErrorCodes)[keyof typeof SplitPaymentsFormErrorCodes]\n\nexport const SPLIT_BY_VALUES = [SPLIT_BY.percentage, SPLIT_BY.amount] as const\nexport type SplitByValue = (typeof SPLIT_BY_VALUES)[number]\n\n// Cleared NumberInput emits `NaN`. Normalize NaN to `null` at the schema\n// boundary so it (a) doesn't trip Zod's built-in \"expected number, received\n// NaN\" message, and (b) flows through the same REQUIRED branch in\n// `superRefine` as an explicitly null value.\nconst splitAmountValueSchema = z.preprocess(\n  v => (typeof v === 'number' && Number.isNaN(v) ? null : v),\n  z.number().nullable(),\n)\n\nconst fieldValidators = {\n  splitBy: z.enum(SPLIT_BY_VALUES),\n  splitAmount: z.record(z.string(), splitAmountValueSchema),\n  priority: z.record(z.string(), z.number()),\n}\n\nexport type SplitPaymentsFormField = keyof typeof fieldValidators\n\nexport type SplitPaymentsFormData = {\n  splitBy: SplitByValue\n  splitAmount: Record<string, number | null>\n  priority: Record<string, number>\n}\nexport type SplitPaymentsFormOutputs = SplitPaymentsFormData\n\nconst requiredFieldsConfig = {} satisfies RequiredFieldConfig<typeof fieldValidators>\n\nexport type SplitPaymentsFormOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\ninterface SplitPaymentsFormSchemaOptions {\n  optionalFieldsToRequire?: SplitPaymentsFormOptionalFieldsToRequire\n}\n\n/**\n * Resolves the remainder uuid (highest priority value) from a priority map.\n * Exported so the hook can mirror the same selection rule when deriving\n * dynamic field metadata.\n */\nexport function resolveRemainderUuid(priority: Record<string, number>): string {\n  return Object.entries(priority).reduce<string>((maxId, [uuid, value]) => {\n    if (!maxId) return uuid\n    const currentMax = priority[maxId] ?? 0\n    return value > currentMax ? uuid : maxId\n  }, '')\n}\n\nexport function createSplitPaymentsFormSchema(options: SplitPaymentsFormSchemaOptions = {}) {\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: SplitPaymentsFormErrorCodes.REQUIRED,\n    mode: 'update',\n    optionalFieldsToRequire: options.optionalFieldsToRequire,\n    superRefine: (data, ctx) => {\n      if (data.splitBy === SPLIT_BY.percentage) {\n        let anyInvalid = false\n        let total = 0\n        for (const [uuid, value] of Object.entries(data.splitAmount)) {\n          if (value === null) {\n            anyInvalid = true\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.REQUIRED,\n            })\n            continue\n          }\n          if (!Number.isInteger(value) || value < 0 || value > 100) {\n            anyInvalid = true\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.INVALID_PERCENTAGE,\n            })\n            continue\n          }\n          total += value\n        }\n        // Only enforce sum-to-100 when every split is otherwise valid. While\n        // any value is missing or out of range, the per-field error is the\n        // right thing to surface; an additional sum mismatch would be noise.\n        // Emitted at the synthetic form path so the hook can drive a\n        // form-level alert via `status.hasPercentageImbalance` without\n        // polluting per-field errors.\n        if (!anyInvalid && total !== 100) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: [PERCENTAGE_TOTAL_PATH],\n            message: SplitPaymentsFormErrorCodes.PERCENTAGE_TOTAL_MISMATCH,\n          })\n        }\n      } else {\n        const remainderUuid = resolveRemainderUuid(data.priority)\n        for (const [uuid, value] of Object.entries(data.splitAmount)) {\n          if (value === null) {\n            if (uuid === remainderUuid) continue\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.REQUIRED,\n            })\n            continue\n          }\n          if (value < 0) {\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.INVALID_AMOUNT,\n            })\n          }\n        }\n        const priorities = Object.values(data.priority)\n        if (new Set(priorities).size !== priorities.length) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['priority'],\n            message: SplitPaymentsFormErrorCodes.DUPLICATE_PRIORITIES,\n          })\n        }\n      }\n    },\n  })\n}\n"],"names":["SplitPaymentsFormErrorCodes","PERCENTAGE_TOTAL_PATH","SPLIT_BY_VALUES","SPLIT_BY","splitAmountValueSchema","z","v","fieldValidators","requiredFieldsConfig","resolveRemainderUuid","priority","maxId","uuid","value","currentMax","createSplitPaymentsFormSchema","options","buildFormSchema","data","ctx","anyInvalid","total","remainderUuid","priorities"],"mappings":";;;AAQO,MAAMA,IAA8B;AAAA,EACzC,UAAU;AAAA,EACV,oBAAoB;AAAA,EACpB,gBAAgB;AAAA,EAChB,sBAAsB;AAAA,EACtB,2BAA2B;AAC7B,GAOaC,IAAwB,mBAKxBC,IAAkB,CAACC,EAAS,YAAYA,EAAS,MAAM,GAO9DC,IAAyBC,EAAE;AAAA,EAC/B,CAAAC,MAAM,OAAOA,KAAM,YAAY,OAAO,MAAMA,CAAC,IAAI,OAAOA;AAAA,EACxDD,EAAE,OAAA,EAAS,SAAA;AACb,GAEME,IAAkB;AAAA,EACtB,SAASF,EAAE,KAAKH,CAAe;AAAA,EAC/B,aAAaG,EAAE,OAAOA,EAAE,OAAA,GAAUD,CAAsB;AAAA,EACxD,UAAUC,EAAE,OAAOA,EAAE,UAAUA,EAAE,QAAQ;AAC3C,GAWMG,IAAuB,CAAA;AAetB,SAASC,EAAqBC,GAA0C;AAC7E,SAAO,OAAO,QAAQA,CAAQ,EAAE,OAAe,CAACC,GAAO,CAACC,GAAMC,CAAK,MAAM;AACvE,QAAI,CAACF,EAAO,QAAOC;AACnB,UAAME,IAAaJ,EAASC,CAAK,KAAK;AACtC,WAAOE,IAAQC,IAAaF,IAAOD;AAAA,EACrC,GAAG,EAAE;AACP;AAEO,SAASI,EAA8BC,IAA0C,IAAI;AAC1F,SAAOC,EAAgBV,GAAiB;AAAA,IACtC,sBAAAC;AAAA,IACA,mBAAmBR,EAA4B;AAAA,IAC/C,MAAM;AAAA,IACN,yBAAyBgB,EAAQ;AAAA,IACjC,aAAa,CAACE,GAAMC,MAAQ;AAC1B,UAAID,EAAK,YAAYf,EAAS,YAAY;AACxC,YAAIiB,IAAa,IACbC,IAAQ;AACZ,mBAAW,CAACT,GAAMC,CAAK,KAAK,OAAO,QAAQK,EAAK,WAAW,GAAG;AAC5D,cAAIL,MAAU,MAAM;AAClB,YAAAO,IAAa,IACbD,EAAI,SAAS;AAAA,cACX,MAAMd,EAAE,aAAa;AAAA,cACrB,MAAM,CAAC,eAAeO,CAAI;AAAA,cAC1B,SAASZ,EAA4B;AAAA,YAAA,CACtC;AACD;AAAA,UACF;AACA,cAAI,CAAC,OAAO,UAAUa,CAAK,KAAKA,IAAQ,KAAKA,IAAQ,KAAK;AACxD,YAAAO,IAAa,IACbD,EAAI,SAAS;AAAA,cACX,MAAMd,EAAE,aAAa;AAAA,cACrB,MAAM,CAAC,eAAeO,CAAI;AAAA,cAC1B,SAASZ,EAA4B;AAAA,YAAA,CACtC;AACD;AAAA,UACF;AACA,UAAAqB,KAASR;AAAA,QACX;AAOA,QAAI,CAACO,KAAcC,MAAU,OAC3BF,EAAI,SAAS;AAAA,UACX,MAAMd,EAAE,aAAa;AAAA,UACrB,MAAM,CAACJ,CAAqB;AAAA,UAC5B,SAASD,EAA4B;AAAA,QAAA,CACtC;AAAA,MAEL,OAAO;AACL,cAAMsB,IAAgBb,EAAqBS,EAAK,QAAQ;AACxD,mBAAW,CAACN,GAAMC,CAAK,KAAK,OAAO,QAAQK,EAAK,WAAW,GAAG;AAC5D,cAAIL,MAAU,MAAM;AAClB,gBAAID,MAASU,EAAe;AAC5B,YAAAH,EAAI,SAAS;AAAA,cACX,MAAMd,EAAE,aAAa;AAAA,cACrB,MAAM,CAAC,eAAeO,CAAI;AAAA,cAC1B,SAASZ,EAA4B;AAAA,YAAA,CACtC;AACD;AAAA,UACF;AACA,UAAIa,IAAQ,KACVM,EAAI,SAAS;AAAA,YACX,MAAMd,EAAE,aAAa;AAAA,YACrB,MAAM,CAAC,eAAeO,CAAI;AAAA,YAC1B,SAASZ,EAA4B;AAAA,UAAA,CACtC;AAAA,QAEL;AACA,cAAMuB,IAAa,OAAO,OAAOL,EAAK,QAAQ;AAC9C,QAAI,IAAI,IAAIK,CAAU,EAAE,SAASA,EAAW,UAC1CJ,EAAI,SAAS;AAAA,UACX,MAAMd,EAAE,aAAa;AAAA,UACrB,MAAM,CAAC,UAAU;AAAA,UACjB,SAASL,EAA4B;AAAA,QAAA,CACtC;AAAA,MAEL;AAAA,IACF;AAAA,EAAA,CACD;AACH;"}
+{"version":3,"file":"useSplitPaymentsFormSchema.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type OptionalFieldsToRequire,\n  type RequiredFieldConfig,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { SPLIT_BY } from '@/shared/constants'\n\n/**\n * Validation error codes emitted by the split payments form schema. Map these\n * codes to localized copy in `validationMessages` when composing the hook.\n *\n * @public\n */\nexport const SplitPaymentsFormErrorCodes = {\n  REQUIRED: 'REQUIRED',\n  INVALID_PERCENTAGE: 'INVALID_PERCENTAGE',\n  INVALID_AMOUNT: 'INVALID_AMOUNT',\n  DUPLICATE_PRIORITIES: 'DUPLICATE_PRIORITIES',\n  PERCENTAGE_TOTAL_MISMATCH: 'PERCENTAGE_TOTAL_MISMATCH',\n} as const\n\n/**\n * Synthetic form path where the schema emits the percentage-sum-to-100\n * invariant. The hook subscribes to errors at this path to drive\n * `status.hasPercentageImbalance`.\n *\n * @internal\n */\nexport const PERCENTAGE_TOTAL_PATH = 'percentageTotal' as const\n\n/**\n * Union of validation error code strings emitted by the split payments form\n * schema.\n *\n * @public\n */\nexport type SplitPaymentsFormErrorCode =\n  (typeof SplitPaymentsFormErrorCodes)[keyof typeof SplitPaymentsFormErrorCodes]\n\n/**\n * Supported split-by modes: split by percentage of net pay, or by fixed dollar\n * amount per account.\n *\n * @public\n */\nexport const SPLIT_BY_VALUES = [SPLIT_BY.percentage, SPLIT_BY.amount] as const\n/**\n * Union of split-by mode values that the form accepts.\n *\n * @public\n */\nexport type SplitByValue = (typeof SPLIT_BY_VALUES)[number]\n\n// Cleared NumberInput emits `NaN`. Normalize NaN to `null` at the schema\n// boundary so it (a) doesn't trip Zod's built-in \"expected number, received\n// NaN\" message, and (b) flows through the same REQUIRED branch in\n// `superRefine` as an explicitly null value.\nconst splitAmountValueSchema = z.preprocess(\n  v => (typeof v === 'number' && Number.isNaN(v) ? null : v),\n  z.number().nullable(),\n)\n\nconst fieldValidators = {\n  splitBy: z.enum(SPLIT_BY_VALUES),\n  splitAmount: z.record(z.string(), splitAmountValueSchema),\n  priority: z.record(z.string(), z.number()),\n}\n\n/**\n * Field names accepted by the split payments form.\n *\n * @public\n */\nexport type SplitPaymentsFormField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the split payments form. `splitAmount` and\n * `priority` are keyed by bank account uuid.\n *\n * @public\n */\nexport type SplitPaymentsFormData = {\n  /** Selected split mode — by percentage or by fixed amount. */\n  splitBy: SplitByValue\n  /** Per-account split values keyed by bank account uuid (percent or dollars depending on `splitBy`). */\n  splitAmount: Record<string, number | null>\n  /** Per-account priority values keyed by bank account uuid; the highest priority receives the remainder. */\n  priority: Record<string, number>\n}\n/**\n * Shape of the validated values produced by the split payments form on submit.\n *\n * @public\n */\nexport type SplitPaymentsFormOutputs = SplitPaymentsFormData\n\nconst requiredFieldsConfig = {} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n/**\n * Keys of optional split payments fields that can be promoted to required via\n * the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type SplitPaymentsFormOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface SplitPaymentsFormSchemaOptions {\n  optionalFieldsToRequire?: SplitPaymentsFormOptionalFieldsToRequire\n}\n\n/**\n * Resolves the remainder uuid (highest priority value) from a priority map.\n * Exported so the hook can mirror the same selection rule when deriving\n * dynamic field metadata.\n */\nfunction resolveRemainderUuid(priority: Record<string, number>): string {\n  return Object.entries(priority).reduce<string>((maxId, [uuid, value]) => {\n    if (!maxId) return uuid\n    const currentMax = priority[maxId] ?? 0\n    return value > currentMax ? uuid : maxId\n  }, '')\n}\n\n/** @internal */\nexport function createSplitPaymentsFormSchema(options: SplitPaymentsFormSchemaOptions = {}) {\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: SplitPaymentsFormErrorCodes.REQUIRED,\n    mode: 'update',\n    optionalFieldsToRequire: options.optionalFieldsToRequire,\n    superRefine: (data, ctx) => {\n      if (data.splitBy === SPLIT_BY.percentage) {\n        let anyInvalid = false\n        let total = 0\n        for (const [uuid, value] of Object.entries(data.splitAmount)) {\n          if (value === null) {\n            anyInvalid = true\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.REQUIRED,\n            })\n            continue\n          }\n          if (!Number.isInteger(value) || value < 0 || value > 100) {\n            anyInvalid = true\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.INVALID_PERCENTAGE,\n            })\n            continue\n          }\n          total += value\n        }\n        // Only enforce sum-to-100 when every split is otherwise valid. While\n        // any value is missing or out of range, the per-field error is the\n        // right thing to surface; an additional sum mismatch would be noise.\n        // Emitted at the synthetic form path so the hook can drive a\n        // form-level alert via `status.hasPercentageImbalance` without\n        // polluting per-field errors.\n        if (!anyInvalid && total !== 100) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: [PERCENTAGE_TOTAL_PATH],\n            message: SplitPaymentsFormErrorCodes.PERCENTAGE_TOTAL_MISMATCH,\n          })\n        }\n      } else {\n        const remainderUuid = resolveRemainderUuid(data.priority)\n        for (const [uuid, value] of Object.entries(data.splitAmount)) {\n          if (value === null) {\n            if (uuid === remainderUuid) continue\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.REQUIRED,\n            })\n            continue\n          }\n          if (value < 0) {\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.INVALID_AMOUNT,\n            })\n          }\n        }\n        const priorities = Object.values(data.priority)\n        if (new Set(priorities).size !== priorities.length) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['priority'],\n            message: SplitPaymentsFormErrorCodes.DUPLICATE_PRIORITIES,\n          })\n        }\n      }\n    },\n  })\n}\n"],"names":["SplitPaymentsFormErrorCodes","PERCENTAGE_TOTAL_PATH","SPLIT_BY_VALUES","SPLIT_BY","splitAmountValueSchema","z","v","fieldValidators","requiredFieldsConfig","resolveRemainderUuid","priority","maxId","uuid","value","currentMax","createSplitPaymentsFormSchema","options","buildFormSchema","data","ctx","anyInvalid","total","remainderUuid","priorities"],"mappings":";;;AAcO,MAAMA,IAA8B;AAAA,EACzC,UAAU;AAAA,EACV,oBAAoB;AAAA,EACpB,gBAAgB;AAAA,EAChB,sBAAsB;AAAA,EACtB,2BAA2B;AAC7B,GASaC,IAAwB,mBAiBxBC,IAAkB,CAACC,EAAS,YAAYA,EAAS,MAAM,GAY9DC,IAAyBC,EAAE;AAAA,EAC/B,CAAAC,MAAM,OAAOA,KAAM,YAAY,OAAO,MAAMA,CAAC,IAAI,OAAOA;AAAA,EACxDD,EAAE,OAAA,EAAS,SAAA;AACb,GAEME,IAAkB;AAAA,EACtB,SAASF,EAAE,KAAKH,CAAe;AAAA,EAC/B,aAAaG,EAAE,OAAOA,EAAE,OAAA,GAAUD,CAAsB;AAAA,EACxD,UAAUC,EAAE,OAAOA,EAAE,UAAUA,EAAE,QAAQ;AAC3C,GA8BMG,IAAuB,CAAA;AAsB7B,SAASC,EAAqBC,GAA0C;AACtE,SAAO,OAAO,QAAQA,CAAQ,EAAE,OAAe,CAACC,GAAO,CAACC,GAAMC,CAAK,MAAM;AACvE,QAAI,CAACF,EAAO,QAAOC;AACnB,UAAME,IAAaJ,EAASC,CAAK,KAAK;AACtC,WAAOE,IAAQC,IAAaF,IAAOD;AAAA,EACrC,GAAG,EAAE;AACP;AAGO,SAASI,EAA8BC,IAA0C,IAAI;AAC1F,SAAOC,EAAgBV,GAAiB;AAAA,IACtC,sBAAAC;AAAA,IACA,mBAAmBR,EAA4B;AAAA,IAC/C,MAAM;AAAA,IACN,yBAAyBgB,EAAQ;AAAA,IACjC,aAAa,CAACE,GAAMC,MAAQ;AAC1B,UAAID,EAAK,YAAYf,EAAS,YAAY;AACxC,YAAIiB,IAAa,IACbC,IAAQ;AACZ,mBAAW,CAACT,GAAMC,CAAK,KAAK,OAAO,QAAQK,EAAK,WAAW,GAAG;AAC5D,cAAIL,MAAU,MAAM;AAClB,YAAAO,IAAa,IACbD,EAAI,SAAS;AAAA,cACX,MAAMd,EAAE,aAAa;AAAA,cACrB,MAAM,CAAC,eAAeO,CAAI;AAAA,cAC1B,SAASZ,EAA4B;AAAA,YAAA,CACtC;AACD;AAAA,UACF;AACA,cAAI,CAAC,OAAO,UAAUa,CAAK,KAAKA,IAAQ,KAAKA,IAAQ,KAAK;AACxD,YAAAO,IAAa,IACbD,EAAI,SAAS;AAAA,cACX,MAAMd,EAAE,aAAa;AAAA,cACrB,MAAM,CAAC,eAAeO,CAAI;AAAA,cAC1B,SAASZ,EAA4B;AAAA,YAAA,CACtC;AACD;AAAA,UACF;AACA,UAAAqB,KAASR;AAAA,QACX;AAOA,QAAI,CAACO,KAAcC,MAAU,OAC3BF,EAAI,SAAS;AAAA,UACX,MAAMd,EAAE,aAAa;AAAA,UACrB,MAAM,CAACJ,CAAqB;AAAA,UAC5B,SAASD,EAA4B;AAAA,QAAA,CACtC;AAAA,MAEL,OAAO;AACL,cAAMsB,IAAgBb,EAAqBS,EAAK,QAAQ;AACxD,mBAAW,CAACN,GAAMC,CAAK,KAAK,OAAO,QAAQK,EAAK,WAAW,GAAG;AAC5D,cAAIL,MAAU,MAAM;AAClB,gBAAID,MAASU,EAAe;AAC5B,YAAAH,EAAI,SAAS;AAAA,cACX,MAAMd,EAAE,aAAa;AAAA,cACrB,MAAM,CAAC,eAAeO,CAAI;AAAA,cAC1B,SAASZ,EAA4B;AAAA,YAAA,CACtC;AACD;AAAA,UACF;AACA,UAAIa,IAAQ,KACVM,EAAI,SAAS;AAAA,YACX,MAAMd,EAAE,aAAa;AAAA,YACrB,MAAM,CAAC,eAAeO,CAAI;AAAA,YAC1B,SAASZ,EAA4B;AAAA,UAAA,CACtC;AAAA,QAEL;AACA,cAAMuB,IAAa,OAAO,OAAOL,EAAK,QAAQ;AAC9C,QAAI,IAAI,IAAIK,CAAU,EAAE,SAASA,EAAW,UAC1CJ,EAAI,SAAS;AAAA,UACX,MAAMd,EAAE,aAAa;AAAA,UACrB,MAAM,CAAC,UAAU;AAAA,UACjB,SAASL,EAA4B;AAAA,QAAA,CACtC;AAAA,MAEL;AAAA,IACF;AAAA,EAAA,CACD;AACH;"}

package/dist/components/Employee/Paystubs/management/PaystubsCard/PaystubsCard.d.ts

@@ -1,7 +1,14 @@
 import { EventType } from '../../../../../shared/constants';
 import { OnEventType } from '../../../../Base/useBase';
+/**
+ * Props for {@link PaystubsCard}.
+ *
+ * @public
+ */
 export interface PaystubsCardProps {
+    /** The associated employee identifier. */
     employeeId: string;
+    /** Event handler fired when paystub interactions occur. */
     onEvent: OnEventType<EventType, unknown>;
 }
 /**
@@ -12,5 +19,7 @@ export interface PaystubsCardProps {
  * download success. The card has no edit transitions and no alert API —
  * paystubs is a read-only surface whose only action is a download side
  * effect that opens the PDF in a new tab.
+ *
+ * @public
  */
 export declare function PaystubsCard(props: PaystubsCardProps): import("react").JSX.Element;