@gusto/embedded-react-sdk 0.51.2 → 0.52.1

package/dist/models/external.d.ts

@@ -20,8 +20,8 @@ export type { Compensation } from '@gusto/embedded-api/models/components/compens
 export { PaymentUnit } from '@gusto/embedded-api/models/components/compensation';
 /** `ContractorPaymentMethod1` entity from the Gusto Embedded API. */
 export { ContractorPaymentMethod1 } from '@gusto/embedded-api/models/components/contractor';
-export type { Address, Contractor, ContractorMemberPortalInvitationStatus, UpcomingEmployment, } from '@gusto/embedded-api/models/components/contractor';
-export { ContractorOnboardingStatus1, ContractorStatus, ContractorType, WageType, } from '@gusto/embedded-api/models/components/contractor';
+export type { Address, Contractor, MemberPortalInvitationStatus, UpcomingEmployment, } from '@gusto/embedded-api/models/components/contractor';
+export { ContractorStatus, ContractorType, ContractorWageType, OnboardingStatus, } from '@gusto/embedded-api/models/components/contractor';
 /** `ContractorAddress` entity from the Gusto Embedded API. */
 export type { ContractorAddress } from '@gusto/embedded-api/models/components/contractoraddress';
 /** `ContractorBankAccount` entity from the Gusto Embedded API. */
@@ -32,13 +32,13 @@ export { ContractorCreateRequestBodyType, ContractorCreateRequestBodyWageType, }
 export type { ContractorPaymentForGroup } from '@gusto/embedded-api/models/components/contractorpaymentforgroup';
 export { ContractorPaymentForGroupPaymentMethod, ContractorPaymentForGroupStatus, ContractorPaymentForGroupWageType, } from '@gusto/embedded-api/models/components/contractorpaymentforgroup';
 export type { ContractorPaymentForGroupPreview } from '@gusto/embedded-api/models/components/contractorpaymentforgrouppreview';
-export { ContractorPaymentForGroupPreviewPaymentMethod, ContractorPaymentForGroupPreviewStatus, ContractorPaymentForGroupPreviewWageType, } from '@gusto/embedded-api/models/components/contractorpaymentforgrouppreview';
+export { ContractorPaymentForGroupPreviewPaymentMethod, ContractorPaymentForGroupPreviewStatus, WageType, } from '@gusto/embedded-api/models/components/contractorpaymentforgrouppreview';
 /** `ContractorPaymentGroupTotals` entity from the Gusto Embedded API. */
 export type { ContractorPaymentGroupTotals } from '@gusto/embedded-api/models/components/contractorpaymentgroup';
 export type { ContractorPaymentGroup } from '@gusto/embedded-api/models/components/contractorpaymentgroup';
 export { ContractorPaymentGroupStatus } from '@gusto/embedded-api/models/components/contractorpaymentgroup';
-/** `ContractorPaymentGroupPreviewTotals` entity from the Gusto Embedded API. */
-export type { ContractorPaymentGroupPreviewTotals } from '@gusto/embedded-api/models/components/contractorpaymentgrouppreview';
+/** `Totals` entity from the Gusto Embedded API. */
+export type { Totals } from '@gusto/embedded-api/models/components/contractorpaymentgrouppreview';
 export type { ContractorPaymentGroupPreview } from '@gusto/embedded-api/models/components/contractorpaymentgrouppreview';
 export { ContractorPaymentGroupPreviewStatus } from '@gusto/embedded-api/models/components/contractorpaymentgrouppreview';
 /** `ContractorPaymentGroupWithBlockersTotals` entity from the Gusto Embedded API. */
@@ -53,9 +53,9 @@ export { ContractorPaymentMethodSplitBy } from '@gusto/embedded-api/models/compo
 export { ContractorPaymentMethodType } from '@gusto/embedded-api/models/components/contractorpaymentmethod';
 /** `ContractorPaymentReceipt` entity from the Gusto Embedded API. */
 export type { ContractorPaymentReceipt } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
-/** `ContractorPayments` entity from the Gusto Embedded API. */
-export type { ContractorPayments } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
-export type { ContractorPaymentReceiptLicensee, ContractorPaymentReceiptTotals, } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
+/** `ContractorPaymentReceiptContractorPayments` entity from the Gusto Embedded API. */
+export type { ContractorPaymentReceiptContractorPayments } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
+export type { ContractorPaymentReceiptTotals, Licensee, } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
 export { ContractorPaymentReceiptPaymentMethod } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
 export type { ContractorUpdateRequestBody } from '@gusto/embedded-api/models/components/contractorupdaterequestbody';
 export { ContractorUpdateRequestBodyType, ContractorUpdateRequestBodyWageType, } from '@gusto/embedded-api/models/components/contractorupdaterequestbody';
@@ -66,7 +66,7 @@ export type { Document } from '@gusto/embedded-api/models/components/document';
 export type { Fields } from '@gusto/embedded-api/models/components/document';
 /** `Pages` entity from the Gusto Embedded API. */
 export type { Pages } from '@gusto/embedded-api/models/components/document';
-export { RecipientType } from '@gusto/embedded-api/models/components/document';
+export { DocumentRecipientType } from '@gusto/embedded-api/models/components/document';
 /** `DocumentSigned` entity from the Gusto Embedded API. */
 export type { DocumentSigned } from '@gusto/embedded-api/models/components/documentsigned';
 /** `DocumentSignedFields` entity from the Gusto Embedded API. */
@@ -74,11 +74,11 @@ export type { DocumentSignedFields } from '@gusto/embedded-api/models/components
 /** `DocumentSignedPages` entity from the Gusto Embedded API. */
 export type { DocumentSignedPages } from '@gusto/embedded-api/models/components/documentsigned';
 export { DocumentSignedRecipientType } from '@gusto/embedded-api/models/components/documentsigned';
-/** `EmployeeCurrentEmploymentStatus` entity from the Gusto Embedded API. */
-export { EmployeeCurrentEmploymentStatus } from '@gusto/embedded-api/models/components/employee';
+/** `CurrentEmploymentStatus` entity from the Gusto Embedded API. */
+export { CurrentEmploymentStatus } from '@gusto/embedded-api/models/components/employee';
 /** `EmployeeOnboardingStatus1` entity from the Gusto Embedded API. */
 export { EmployeeOnboardingStatus1 } from '@gusto/embedded-api/models/components/employee';
-export type { Employee, EmployeeMemberPortalInvitationStatus, EmployeeOnboardingDocumentsConfig, } from '@gusto/embedded-api/models/components/employee';
+export type { Employee, EmployeeMemberPortalInvitationStatus, OnboardingDocumentsConfig, } from '@gusto/embedded-api/models/components/employee';
 export { EmployeePaymentMethod1, EmployeeStatus, } from '@gusto/embedded-api/models/components/employee';
 /** `EmployeeAddress` entity from the Gusto Embedded API. */
 export type { EmployeeAddress } from '@gusto/embedded-api/models/components/employeeaddress';
@@ -89,9 +89,12 @@ export type { EmployeeCustomField } from '@gusto/embedded-api/models/components/
 export type { EmployeeFederalTax } from '@gusto/embedded-api/models/components/employeefederaltax';
 export type { EmployeeFederalTaxPre2020 } from '@gusto/embedded-api/models/components/employeefederaltaxpre2020';
 export type { EmployeeFederalTaxRev2020 } from '@gusto/embedded-api/models/components/employeefederaltaxrev2020';
+/** `Blockers` entity from the Gusto Embedded API. */
+export type { Blockers } from '@gusto/embedded-api/models/components/employeeonboardingstatus';
 /** `EmployeeOnboardingStatusOnboardingStep` entity from the Gusto Embedded API. */
 export type { EmployeeOnboardingStatusOnboardingStep } from '@gusto/embedded-api/models/components/employeeonboardingstatus';
 export type { EmployeeOnboardingStatus } from '@gusto/embedded-api/models/components/employeeonboardingstatus';
+export { EmployeeOnboardingStatusCategory, Field, } from '@gusto/embedded-api/models/components/employeeonboardingstatus';
 /** `EmployeePaymentMethod` entity from the Gusto Embedded API. */
 export type { EmployeePaymentMethod } from '@gusto/embedded-api/models/components/employeepaymentmethod';
 /** `EmployeePaymentMethodSplitBy` entity from the Gusto Embedded API. */
@@ -111,8 +114,8 @@ export type { Questions } from '@gusto/embedded-api/models/components/employeest
 export type { States } from '@gusto/embedded-api/models/components/employeestatetaxesrequest';
 /** `EmployeeStateTaxInputQuestionFormat` entity from the Gusto Embedded API. */
 export type { EmployeeStateTaxInputQuestionFormat } from '@gusto/embedded-api/models/components/employeestatetaxinputquestionformat';
-/** `Options` entity from the Gusto Embedded API. */
-export type { Options } from '@gusto/embedded-api/models/components/employeestatetaxinputquestionformat';
+/** `EmployeeStateTaxInputQuestionFormatOptions` entity from the Gusto Embedded API. */
+export type { EmployeeStateTaxInputQuestionFormatOptions } from '@gusto/embedded-api/models/components/employeestatetaxinputquestionformat';
 /** `EmployeeStateTaxQuestion` entity from the Gusto Embedded API. */
 export type { EmployeeStateTaxQuestion } from '@gusto/embedded-api/models/components/employeestatetaxquestion';
 /** `EmployeeWorkAddress` entity from the Gusto Embedded API. */
@@ -179,34 +182,6 @@ export { PaymentSpeed } from '@gusto/embedded-api/models/components/paymentconfi
 export type { PaymentMethodBankAccount } from '@gusto/embedded-api/models/components/paymentmethodbankaccount';
 export type { PayPeriod, PayPeriodPayroll } from '@gusto/embedded-api/models/components/payperiod';
 export { PayrollType } from '@gusto/embedded-api/models/components/payperiod';
-/** `EmployeeCompensations` entity from the Gusto Embedded API. */
-export type { EmployeeCompensations } from '@gusto/embedded-api/models/components/payroll';
-/** `OffCycleReasonType` entity from the Gusto Embedded API. */
-export { OffCycleReasonType } from '@gusto/embedded-api/models/components/payroll';
-/** `Payroll` entity from the Gusto Embedded API. */
-export type { Payroll } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShow` entity from the Gusto Embedded API. */
-export type { PayrollShow } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowBenefits` entity from the Gusto Embedded API. */
-export type { PayrollShowBenefits } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowDeductions` entity from the Gusto Embedded API. */
-export type { PayrollShowDeductions } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowFixedCompensations` entity from the Gusto Embedded API. */
-export type { PayrollShowFixedCompensations } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowHourlyCompensations` entity from the Gusto Embedded API. */
-export type { PayrollShowHourlyCompensations } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowPaidTimeOff` entity from the Gusto Embedded API. */
-export type { PayrollShowPaidTimeOff } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowPaymentMethod` entity from the Gusto Embedded API. */
-export { PayrollShowPaymentMethod } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowReimbursements` entity from the Gusto Embedded API. */
-export type { PayrollShowReimbursements } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowTaxes` entity from the Gusto Embedded API. */
-export type { PayrollShowTaxes } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollWithholdingPayPeriodType` entity from the Gusto Embedded API. */
-export { PayrollWithholdingPayPeriodType } from '@gusto/embedded-api/models/components/payroll';
-export type { PayrollPrepared } from '@gusto/embedded-api/models/components/payroll';
-export { PayrollShowAmountType } from '@gusto/embedded-api/models/components/payroll';
 /** `PayrollCompanyTaxesType` entity from the Gusto Embedded API. */
 export type { PayrollCompanyTaxesType } from '@gusto/embedded-api/models/components/payrollcompanytaxestype';
 /** `PayrollCreditBlockerTypeUnblockOptions` entity from the Gusto Embedded API. */
@@ -227,19 +202,22 @@ export type { PayrollCreditBlockerUnblockOptionWaitForReverseWireMetadata } from
 export type { PayrollCreditBlockerUnblockOptionWaitForReverseWire } from '@gusto/embedded-api/models/components/payrollcreditblockerunblockoptionwaitforreversewire';
 /** `Deductions` entity from the Gusto Embedded API. */
 export type { Deductions } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+/** `FixedCompensations` entity from the Gusto Embedded API. */
+export type { FixedCompensations } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+/** `HourlyCompensations` entity from the Gusto Embedded API. */
+export type { HourlyCompensations } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
 /** `PayrollEmployeeCompensationsType` entity from the Gusto Embedded API. */
 export type { PayrollEmployeeCompensationsType } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
-/** `PayrollEmployeeCompensationsTypeFixedCompensations` entity from the Gusto Embedded API. */
-export type { PayrollEmployeeCompensationsTypeFixedCompensations } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
-/** `PayrollEmployeeCompensationsTypeHourlyCompensations` entity from the Gusto Embedded API. */
-export type { PayrollEmployeeCompensationsTypeHourlyCompensations } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
 /** `PayrollEmployeeCompensationsTypePaidTimeOff` entity from the Gusto Embedded API. */
 export type { PayrollEmployeeCompensationsTypePaidTimeOff } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
 /** `PayrollEmployeeCompensationsTypePaymentMethod` entity from the Gusto Embedded API. */
 export { PayrollEmployeeCompensationsTypePaymentMethod } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
-/** `PayrollEmployeeCompensationsTypeReimbursements` entity from the Gusto Embedded API. */
-export type { PayrollEmployeeCompensationsTypeReimbursements } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
-export { AmountType } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+/** `Reimbursements` entity from the Gusto Embedded API. */
+export type { Reimbursements } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+/** `State` entity from the Gusto Embedded API. */
+export type { State } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+export type { CustomWithholdings, Federal, } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+export { AmountType, OverrideType, PayrollEmployeeCompensationsTypeAmountType, PayrollEmployeeCompensationsTypeCustomWithholdingsAmountType, PayrollEmployeeCompensationsTypeOverrideType, } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
 /** `PayrollFixedCompensationTypesType` entity from the Gusto Embedded API. */
 export type { PayrollFixedCompensationTypesType } from '@gusto/embedded-api/models/components/payrollfixedcompensationtypestype';
 export type { PayrollPaymentSpeedChangedType } from '@gusto/embedded-api/models/components/payrollpaymentspeedchangedtype';
@@ -255,8 +233,38 @@ export type { PayrollReceipt } from '@gusto/embedded-api/models/components/payro
 export type { PayrollReceiptEmployeeCompensations } from '@gusto/embedded-api/models/components/payrollreceipt';
 /** `Taxes` entity from the Gusto Embedded API. */
 export type { Taxes } from '@gusto/embedded-api/models/components/payrollreceipt';
-export type { Licensee, Totals } from '@gusto/embedded-api/models/components/payrollreceipt';
+export type { PayrollReceiptLicensee, PayrollReceiptTotals, } from '@gusto/embedded-api/models/components/payrollreceipt';
 export { PayrollReceiptPaymentMethod } from '@gusto/embedded-api/models/components/payrollreceipt';
+/** `EmployeeCompensations` entity from the Gusto Embedded API. */
+export type { EmployeeCompensations } from '@gusto/embedded-api/models/components/payrollshow';
+/** `OffCycleReasonType` entity from the Gusto Embedded API. */
+export { OffCycleReasonType } from '@gusto/embedded-api/models/components/payrollshow';
+/** `Payroll` entity from the Gusto Embedded API. */
+export type { Payroll } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShow` entity from the Gusto Embedded API. */
+export type { PayrollShow } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowBenefits` entity from the Gusto Embedded API. */
+export type { PayrollShowBenefits } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowDeductions` entity from the Gusto Embedded API. */
+export type { PayrollShowDeductions } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowFixedCompensations` entity from the Gusto Embedded API. */
+export type { PayrollShowFixedCompensations } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowHourlyCompensations` entity from the Gusto Embedded API. */
+export type { PayrollShowHourlyCompensations } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowPaidTimeOff` entity from the Gusto Embedded API. */
+export type { PayrollShowPaidTimeOff } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowPaymentMethod` entity from the Gusto Embedded API. */
+export { PayrollShowPaymentMethod } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowReimbursements` entity from the Gusto Embedded API. */
+export type { PayrollShowReimbursements } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowState` entity from the Gusto Embedded API. */
+export type { PayrollShowState } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowTaxes` entity from the Gusto Embedded API. */
+export type { PayrollShowTaxes } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollWithholdingPayPeriodType` entity from the Gusto Embedded API. */
+export { PayrollWithholdingPayPeriodType } from '@gusto/embedded-api/models/components/payrollshow';
+export type { PayrollPrepared, PayrollShowCustomWithholdings, PayrollShowFederal, } from '@gusto/embedded-api/models/components/payrollshow';
+export { PayrollShowAmountType, PayrollShowEmployeeCompensationsAmountType, PayrollShowEmployeeCompensationsCustomWithholdingsAmountType, PayrollShowEmployeeCompensationsOverrideType, PayrollShowOverrideType, } from '@gusto/embedded-api/models/components/payrollshow';
 /** `UnblockOptions` entity from the Gusto Embedded API. */
 export type { UnblockOptions } from '@gusto/embedded-api/models/components/payrollsubmissionblockertype';
 export type { PayrollSubmissionBlockerType } from '@gusto/embedded-api/models/components/payrollsubmissionblockertype';
@@ -270,29 +278,31 @@ export type { PayrollUpdateEmployeeCompensations } from '@gusto/embedded-api/mod
 export type { PayrollUpdatePaidTimeOff } from '@gusto/embedded-api/models/components/payrollupdate';
 /** `PayrollUpdateReimbursements` entity from the Gusto Embedded API. */
 export type { PayrollUpdateReimbursements } from '@gusto/embedded-api/models/components/payrollupdate';
-export type { PayrollUpdateDeductions, PayrollUpdateFixedCompensations, PayrollUpdateHourlyCompensations, } from '@gusto/embedded-api/models/components/payrollupdate';
-export { PayrollUpdateAmountType, PayrollUpdatePaymentMethod, } from '@gusto/embedded-api/models/components/payrollupdate';
+/** `PayrollUpdateState` entity from the Gusto Embedded API. */
+export type { PayrollUpdateState } from '@gusto/embedded-api/models/components/payrollupdate';
+export type { PayrollUpdateCustomWithholdings, PayrollUpdateDeductions, PayrollUpdateFederal, PayrollUpdateFixedCompensations, PayrollUpdateHourlyCompensations, } from '@gusto/embedded-api/models/components/payrollupdate';
+export { PayrollUpdateAmountType, PayrollUpdateEmployeeCompensationsAmountType, PayrollUpdateEmployeeCompensationsCustomWithholdingsAmountType, PayrollUpdateEmployeeCompensationsOverrideType, PayrollUpdateOverrideType, PayrollUpdatePaymentMethod, } from '@gusto/embedded-api/models/components/payrollupdate';
 export type { PayScheduleAutoPayrollEnablementBlocker, PayScheduleAutoPayrollEnablementBlockerMetadata, } from '@gusto/embedded-api/models/components/payscheduleautopayrollenablementblocker';
 export { PayScheduleFrequency } from '@gusto/embedded-api/models/components/payschedulefrequency';
 export type { PaySchedulePreviewPayPeriod } from '@gusto/embedded-api/models/components/payschedulepreviewpayperiod';
 export type { PayScheduleShow } from '@gusto/embedded-api/models/components/payscheduleshow';
 export type { RecoveryCase } from '@gusto/embedded-api/models/components/recoverycase';
 export { RecoveryCaseStatus } from '@gusto/embedded-api/models/components/recoverycase';
-/** `HomeAddress` entity from the Gusto Embedded API. */
-export type { HomeAddress } from '@gusto/embedded-api/models/components/signatory';
 /** `IdentityVerificationStatus` entity from the Gusto Embedded API. */
 export { IdentityVerificationStatus } from '@gusto/embedded-api/models/components/signatory';
+/** `SignatoryHomeAddress` entity from the Gusto Embedded API. */
+export type { SignatoryHomeAddress } from '@gusto/embedded-api/models/components/signatory';
 export type { Signatory } from '@gusto/embedded-api/models/components/signatory';
 /** `ApplicableIf` entity from the Gusto Embedded API. */
 export type { ApplicableIf } from '@gusto/embedded-api/models/components/taxrequirement';
 /** `TaxRequirement` entity from the Gusto Embedded API. */
 export type { TaxRequirement } from '@gusto/embedded-api/models/components/taxrequirement';
+/** `Options` entity from the Gusto Embedded API. */
+export type { Options } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
 /** `TaxRequirementMetadata` entity from the Gusto Embedded API. */
 export type { TaxRequirementMetadata } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
-/** `TaxRequirementMetadataOptions` entity from the Gusto Embedded API. */
-export type { TaxRequirementMetadataOptions } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
 export type { Validation } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
-export { RateType, TaxRequirementMetadataType, TaxRequirementMetadataValidationType, } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
+export { RateType, TaxRequirementMetadataType, Type, } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
 /** `TaxRequirementSet` entity from the Gusto Embedded API. */
 export type { TaxRequirementSet } from '@gusto/embedded-api/models/components/taxrequirementset';
 /** `TaxRequirementsState` entity from the Gusto Embedded API. */

package/dist/partner-hook-utils/composeErrorHandler.d.ts

@@ -1,7 +1,14 @@
 import { UseQueryResult } from '@tanstack/react-query';
 import { HookErrorHandling } from './types';
 import { SDKError } from '../types/sdkError';
-type QueryWithRefetch = Pick<UseQueryResult, 'error' | 'refetch'>;
+/**
+ * The subset of a TanStack Query result — its `error` and `refetch` — that
+ * {@link composeErrorHandler} reads from an additional query passed as a source.
+ *
+ * @public
+ * @childOf {@link composeErrorHandler}
+ */
+export type QueryWithRefetch = Pick<UseQueryResult, 'error' | 'refetch'>;
 /**
  * Submit-side error state to merge into a composed {@link HookErrorHandling}.
  *
@@ -11,6 +18,7 @@ type QueryWithRefetch = Pick<UseQueryResult, 'error' | 'refetch'>;
  * and can be cleared together with `clearSubmitError`.
  *
  * @public
+ * @childOf {@link composeErrorHandler}
  */
 export type SubmitStateForErrorHandling = {
     /** The current submit error, or `null` when cleared. */
@@ -24,6 +32,7 @@ export type SubmitStateForErrorHandling = {
  * an `errorHandling` object.
  *
  * @public
+ * @childOf {@link composeErrorHandler}
  */
 export type MixedErrorSource = QueryWithRefetch | {
     errorHandling: HookErrorHandling;
@@ -32,7 +41,7 @@ export type MixedErrorSource = QueryWithRefetch | {
  * Merges multiple error sources into a single {@link HookErrorHandling}.
  *
  * @remarks
- * Accepts any mix of `@gusto/embedded-api-v-2026-02-01` React Query results and SDK hook
+ * Accepts any mix of `@gusto/embedded-api-v-2026-06-15` React Query results and SDK hook
  * results that already expose an `errorHandling` object (including the value returned by
  * {@link composeSubmitHandler}). Query errors are normalized to `SDKError`, nested hook
  * errors are flattened in, and an optional submit-state argument adds a submit error to
@@ -50,11 +59,12 @@ export type MixedErrorSource = QueryWithRefetch | {
  * @param submitState - Optional screen-level submit state to fold into the result.
  * @returns A single `HookErrorHandling` covering every source.
  * @public
+ * @group Form composition
  *
  * @example
  * ```tsx
  * import { composeErrorHandler, useEmployeeDetailsForm } from '@gusto/embedded-react-sdk'
- * import { useEmployeeFormsList } from '@gusto/embedded-api-v-2026-02-01/react-query/employeeFormsList'
+ * import { useEmployeeFormsList } from '@gusto/embedded-api-v-2026-06-15/react-query/employeeFormsList'
  *
  * function EmployeeProfileView({ companyId, employeeId }: { companyId: string; employeeId: string }) {
  *   const employeeDetails = useEmployeeDetailsForm({ companyId, employeeId })
@@ -78,4 +88,3 @@ export type MixedErrorSource = QueryWithRefetch | {
  * ```
  */
 export declare function composeErrorHandler(sources: MixedErrorSource[], submitState?: SubmitStateForErrorHandling): HookErrorHandling;
-export {};

package/dist/partner-hook-utils/composeErrorHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"composeErrorHandler.js","sources":["../../src/partner-hook-utils/composeErrorHandler.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query'\nimport { collectErrors } from './collectErrors'\nimport type { HookErrorHandling } from './types'\nimport type { SDKError } from '@/types/sdkError'\n\ntype QueryWithRefetch = Pick<UseQueryResult, 'error' | 'refetch'>\n\n/**\n * Submit-side error state to merge into a composed {@link HookErrorHandling}.\n *\n * @remarks\n * Pass to {@link composeErrorHandler} when a screen has its own submit state outside of\n * any SDK form hook, so submit errors appear in the same error surface as query errors\n * and can be cleared together with `clearSubmitError`.\n *\n * @public\n */\nexport type SubmitStateForErrorHandling = {\n  /** The current submit error, or `null` when cleared. */\n  submitError: SDKError | null\n  /** Sets or clears the submit error. */\n  setSubmitError: (error: SDKError | null) => void\n}\n\n/**\n * Accepted input shape for {@link composeErrorHandler}: either a React Query result\n * (anything with `error` and `refetch`) or another SDK hook result that exposes\n * an `errorHandling` object.\n *\n * @public\n */\nexport type MixedErrorSource = QueryWithRefetch | { errorHandling: HookErrorHandling }\n\nfunction isHookResultWithErrorHandling(\n  source: MixedErrorSource,\n): source is { errorHandling: HookErrorHandling } {\n  return 'errorHandling' in source\n}\n\n/**\n * Merges multiple error sources into a single {@link HookErrorHandling}.\n *\n * @remarks\n * Accepts any mix of `@gusto/embedded-api-v-2026-02-01` React Query results and SDK hook\n * results that already expose an `errorHandling` object (including the value returned by\n * {@link composeSubmitHandler}). Query errors are normalized to `SDKError`, nested hook\n * errors are flattened in, and an optional submit-state argument adds a submit error to\n * the same list.\n *\n * The returned `retryQueries` refetches every failed query and delegates into each nested\n * hook so their retries fire too. `clearSubmitError` clears the optional submit state and\n * delegates into each nested hook.\n *\n * Pairs with {@link composeSubmitHandler} by name only — this composes error state and\n * recovery, not a submit callback.\n *\n * @param sources - Error sources to merge. Each entry is either a React Query result or\n *   an object with an `errorHandling` property.\n * @param submitState - Optional screen-level submit state to fold into the result.\n * @returns A single `HookErrorHandling` covering every source.\n * @public\n *\n * @example\n * ```tsx\n * import { composeErrorHandler, useEmployeeDetailsForm } from '@gusto/embedded-react-sdk'\n * import { useEmployeeFormsList } from '@gusto/embedded-api-v-2026-02-01/react-query/employeeFormsList'\n *\n * function EmployeeProfileView({ companyId, employeeId }: { companyId: string; employeeId: string }) {\n *   const employeeDetails = useEmployeeDetailsForm({ companyId, employeeId })\n *   const formsListQuery = useEmployeeFormsList({ employeeId })\n *\n *   const errorHandling = composeErrorHandler([employeeDetails, formsListQuery])\n *\n *   if (errorHandling.errors.length > 0) {\n *     return (\n *       <div role=\"alert\">\n *         {errorHandling.errors.map((error, i) => (\n *           <p key={i}>{error.message}</p>\n *         ))}\n *         <button onClick={errorHandling.retryQueries}>Retry</button>\n *       </div>\n *     )\n *   }\n *\n *   return null\n * }\n * ```\n */\nexport function composeErrorHandler(\n  sources: MixedErrorSource[],\n  submitState?: SubmitStateForErrorHandling,\n): HookErrorHandling {\n  const queries: QueryWithRefetch[] = []\n  const errorHandlingsFromNestedHooks: HookErrorHandling[] = []\n\n  for (const source of sources) {\n    if (isHookResultWithErrorHandling(source)) {\n      errorHandlingsFromNestedHooks.push(source.errorHandling)\n    } else {\n      queries.push(source)\n    }\n  }\n\n  const nestedErrors = errorHandlingsFromNestedHooks.flatMap(handling => handling.errors)\n\n  let errors: SDKError[]\n  if (errorHandlingsFromNestedHooks.length === 0) {\n    errors = collectErrors(queries, submitState?.submitError ?? null)\n  } else {\n    const standaloneQueryErrors = collectErrors(queries, null)\n    errors = [...nestedErrors, ...standaloneQueryErrors]\n    if (submitState?.submitError) {\n      errors.push(submitState.submitError)\n    }\n  }\n\n  const retryQueries = () => {\n    for (const handling of errorHandlingsFromNestedHooks) {\n      handling.retryQueries()\n    }\n    queries.filter(q => q.error != null).forEach(q => void q.refetch())\n  }\n\n  const clearSubmitError = () => {\n    for (const handling of errorHandlingsFromNestedHooks) {\n      handling.clearSubmitError()\n    }\n    submitState?.setSubmitError(null)\n  }\n\n  return { errors, retryQueries, clearSubmitError }\n}\n"],"names":["isHookResultWithErrorHandling","source","composeErrorHandler","sources","submitState","queries","errorHandlingsFromNestedHooks","nestedErrors","handling","errors","collectErrors","standaloneQueryErrors","q"],"mappings":";AAiCA,SAASA,EACPC,GACgD;AAChD,SAAO,mBAAmBA;AAC5B;AAmDO,SAASC,EACdC,GACAC,GACmB;AACnB,QAAMC,IAA8B,CAAA,GAC9BC,IAAqD,CAAA;AAE3D,aAAWL,KAAUE;AACnB,IAAIH,EAA8BC,CAAM,IACtCK,EAA8B,KAAKL,EAAO,aAAa,IAEvDI,EAAQ,KAAKJ,CAAM;AAIvB,QAAMM,IAAeD,EAA8B,QAAQ,CAAAE,MAAYA,EAAS,MAAM;AAEtF,MAAIC;AACJ,MAAIH,EAA8B,WAAW;AAC3C,IAAAG,IAASC,EAAcL,GAASD,GAAa,eAAe,IAAI;AAAA,OAC3D;AACL,UAAMO,IAAwBD,EAAcL,GAAS,IAAI;AACzD,IAAAI,IAAS,CAAC,GAAGF,GAAc,GAAGI,CAAqB,GAC/CP,GAAa,eACfK,EAAO,KAAKL,EAAY,WAAW;AAAA,EAEvC;AAgBA,SAAO,EAAE,QAAAK,GAAQ,cAdI,MAAM;AACzB,eAAWD,KAAYF;AACrB,MAAAE,EAAS,aAAA;AAEX,IAAAH,EAAQ,OAAO,CAAAO,MAAKA,EAAE,SAAS,IAAI,EAAE,QAAQ,CAAAA,MAAA;AAAK,MAAKA,EAAE,QAAA;AAAA,KAAS;AAAA,EACpE,GAS+B,kBAPN,MAAM;AAC7B,eAAWJ,KAAYF;AACrB,MAAAE,EAAS,iBAAA;AAEX,IAAAJ,GAAa,eAAe,IAAI;AAAA,EAClC,EAE+B;AACjC;"}
+{"version":3,"file":"composeErrorHandler.js","sources":["../../src/partner-hook-utils/composeErrorHandler.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query'\nimport { collectErrors } from './collectErrors'\nimport type { HookErrorHandling } from './types'\nimport type { SDKError } from '@/types/sdkError'\n\n/**\n * The subset of a TanStack Query result — its `error` and `refetch` — that\n * {@link composeErrorHandler} reads from an additional query passed as a source.\n *\n * @public\n * @childOf {@link composeErrorHandler}\n */\nexport type QueryWithRefetch = Pick<UseQueryResult, 'error' | 'refetch'>\n\n/**\n * Submit-side error state to merge into a composed {@link HookErrorHandling}.\n *\n * @remarks\n * Pass to {@link composeErrorHandler} when a screen has its own submit state outside of\n * any SDK form hook, so submit errors appear in the same error surface as query errors\n * and can be cleared together with `clearSubmitError`.\n *\n * @public\n * @childOf {@link composeErrorHandler}\n */\nexport type SubmitStateForErrorHandling = {\n  /** The current submit error, or `null` when cleared. */\n  submitError: SDKError | null\n  /** Sets or clears the submit error. */\n  setSubmitError: (error: SDKError | null) => void\n}\n\n/**\n * Accepted input shape for {@link composeErrorHandler}: either a React Query result\n * (anything with `error` and `refetch`) or another SDK hook result that exposes\n * an `errorHandling` object.\n *\n * @public\n * @childOf {@link composeErrorHandler}\n */\nexport type MixedErrorSource = QueryWithRefetch | { errorHandling: HookErrorHandling }\n\nfunction isHookResultWithErrorHandling(\n  source: MixedErrorSource,\n): source is { errorHandling: HookErrorHandling } {\n  return 'errorHandling' in source\n}\n\n/**\n * Merges multiple error sources into a single {@link HookErrorHandling}.\n *\n * @remarks\n * Accepts any mix of `@gusto/embedded-api-v-2026-06-15` React Query results and SDK hook\n * results that already expose an `errorHandling` object (including the value returned by\n * {@link composeSubmitHandler}). Query errors are normalized to `SDKError`, nested hook\n * errors are flattened in, and an optional submit-state argument adds a submit error to\n * the same list.\n *\n * The returned `retryQueries` refetches every failed query and delegates into each nested\n * hook so their retries fire too. `clearSubmitError` clears the optional submit state and\n * delegates into each nested hook.\n *\n * Pairs with {@link composeSubmitHandler} by name only — this composes error state and\n * recovery, not a submit callback.\n *\n * @param sources - Error sources to merge. Each entry is either a React Query result or\n *   an object with an `errorHandling` property.\n * @param submitState - Optional screen-level submit state to fold into the result.\n * @returns A single `HookErrorHandling` covering every source.\n * @public\n * @group Form composition\n *\n * @example\n * ```tsx\n * import { composeErrorHandler, useEmployeeDetailsForm } from '@gusto/embedded-react-sdk'\n * import { useEmployeeFormsList } from '@gusto/embedded-api-v-2026-06-15/react-query/employeeFormsList'\n *\n * function EmployeeProfileView({ companyId, employeeId }: { companyId: string; employeeId: string }) {\n *   const employeeDetails = useEmployeeDetailsForm({ companyId, employeeId })\n *   const formsListQuery = useEmployeeFormsList({ employeeId })\n *\n *   const errorHandling = composeErrorHandler([employeeDetails, formsListQuery])\n *\n *   if (errorHandling.errors.length > 0) {\n *     return (\n *       <div role=\"alert\">\n *         {errorHandling.errors.map((error, i) => (\n *           <p key={i}>{error.message}</p>\n *         ))}\n *         <button onClick={errorHandling.retryQueries}>Retry</button>\n *       </div>\n *     )\n *   }\n *\n *   return null\n * }\n * ```\n */\nexport function composeErrorHandler(\n  sources: MixedErrorSource[],\n  submitState?: SubmitStateForErrorHandling,\n): HookErrorHandling {\n  const queries: QueryWithRefetch[] = []\n  const errorHandlingsFromNestedHooks: HookErrorHandling[] = []\n\n  for (const source of sources) {\n    if (isHookResultWithErrorHandling(source)) {\n      errorHandlingsFromNestedHooks.push(source.errorHandling)\n    } else {\n      queries.push(source)\n    }\n  }\n\n  const nestedErrors = errorHandlingsFromNestedHooks.flatMap(handling => handling.errors)\n\n  let errors: SDKError[]\n  if (errorHandlingsFromNestedHooks.length === 0) {\n    errors = collectErrors(queries, submitState?.submitError ?? null)\n  } else {\n    const standaloneQueryErrors = collectErrors(queries, null)\n    errors = [...nestedErrors, ...standaloneQueryErrors]\n    if (submitState?.submitError) {\n      errors.push(submitState.submitError)\n    }\n  }\n\n  const retryQueries = () => {\n    for (const handling of errorHandlingsFromNestedHooks) {\n      handling.retryQueries()\n    }\n    queries.filter(q => q.error != null).forEach(q => void q.refetch())\n  }\n\n  const clearSubmitError = () => {\n    for (const handling of errorHandlingsFromNestedHooks) {\n      handling.clearSubmitError()\n    }\n    submitState?.setSubmitError(null)\n  }\n\n  return { errors, retryQueries, clearSubmitError }\n}\n"],"names":["isHookResultWithErrorHandling","source","composeErrorHandler","sources","submitState","queries","errorHandlingsFromNestedHooks","nestedErrors","handling","errors","collectErrors","standaloneQueryErrors","q"],"mappings":";AA0CA,SAASA,EACPC,GACgD;AAChD,SAAO,mBAAmBA;AAC5B;AAoDO,SAASC,EACdC,GACAC,GACmB;AACnB,QAAMC,IAA8B,CAAA,GAC9BC,IAAqD,CAAA;AAE3D,aAAWL,KAAUE;AACnB,IAAIH,EAA8BC,CAAM,IACtCK,EAA8B,KAAKL,EAAO,aAAa,IAEvDI,EAAQ,KAAKJ,CAAM;AAIvB,QAAMM,IAAeD,EAA8B,QAAQ,CAAAE,MAAYA,EAAS,MAAM;AAEtF,MAAIC;AACJ,MAAIH,EAA8B,WAAW;AAC3C,IAAAG,IAASC,EAAcL,GAASD,GAAa,eAAe,IAAI;AAAA,OAC3D;AACL,UAAMO,IAAwBD,EAAcL,GAAS,IAAI;AACzD,IAAAI,IAAS,CAAC,GAAGF,GAAc,GAAGI,CAAqB,GAC/CP,GAAa,eACfK,EAAO,KAAKL,EAAY,WAAW;AAAA,EAEvC;AAgBA,SAAO,EAAE,QAAAK,GAAQ,cAdI,MAAM;AACzB,eAAWD,KAAYF;AACrB,MAAAE,EAAS,aAAA;AAEX,IAAAH,EAAQ,OAAO,CAAAO,MAAKA,EAAE,SAAS,IAAI,EAAE,QAAQ,CAAAA,MAAA;AAAK,MAAKA,EAAE,QAAA;AAAA,KAAS;AAAA,EACpE,GAS+B,kBAPN,MAAM;AAC7B,eAAWJ,KAAYF;AACrB,MAAAE,EAAS,iBAAA;AAEX,IAAAJ,GAAa,eAAe,IAAI;AAAA,EAClC,EAE+B;AACjC;"}

package/dist/partner-hook-utils/form/SDKFormProvider.d.ts

@@ -2,9 +2,17 @@ import { ReactNode } from 'react';
 import { FieldValues } from 'react-hook-form';
 import { FieldMetadata, FieldMetadataWithOptions, HookFormInternals } from '../types';
 import { SDKError } from '../../types/sdkError';
-interface SDKFormProviderProps<TFormData extends FieldValues = FieldValues, TFieldsMetadata extends {
+/**
+ * Props for {@link SDKFormProvider}.
+ *
+ * @typeParam TFormData - Shape of the form values managed by the wrapped form hook.
+ * @typeParam TFieldsMetadata - The form hook's field-metadata map.
+ * @public
+ */
+export interface SDKFormProviderProps<TFormData extends FieldValues = FieldValues, TFieldsMetadata extends {
     [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions;
 } = Record<string, FieldMetadata | FieldMetadataWithOptions>> {
+    /** The form hook result whose fields, metadata, and errors are shared with descendant field components. */
     formHookResult: {
         errorHandling: {
             errors: SDKError[];
@@ -14,6 +22,7 @@ interface SDKFormProviderProps<TFormData extends FieldValues = FieldValues, TFie
             hookFormInternals: HookFormInternals<TFormData>;
         };
     };
+    /** Field components (or any content) that consume the provided form context. */
     children: ReactNode;
 }
 /**
@@ -22,6 +31,7 @@ interface SDKFormProviderProps<TFormData extends FieldValues = FieldValues, TFie
  * Server-side field errors are automatically synced onto their corresponding fields.
  *
  * @public
+ * @group Providers
  *
  * @example
  * ```tsx
@@ -47,4 +57,3 @@ interface SDKFormProviderProps<TFormData extends FieldValues = FieldValues, TFie
 export declare function SDKFormProvider<TFormData extends FieldValues = FieldValues, TFieldsMetadata extends {
     [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions;
 } = Record<string, FieldMetadata | FieldMetadataWithOptions>>({ formHookResult, children }: SDKFormProviderProps<TFormData, TFieldsMetadata>): import("react").JSX.Element;
-export {};

package/dist/partner-hook-utils/form/SDKFormProvider.js

@@ -20,7 +20,13 @@ function F(o, t) {
 }
 function M({ formHookResult: o, children: t }) {
   const { errorHandling: e, form: r } = o, i = e.errors.flatMap((s) => s.fieldErrors);
-  return F(i, r), /* @__PURE__ */ n(l, { metadata: r.fieldsMetadata, errors: e.errors, children: /* @__PURE__ */ n(f, { registry: r.hookFormInternals._fieldElementRegistry, children: /* @__PURE__ */ n(d, { ...r.hookFormInternals.formMethods, children: t }) }) });
+  return F(i, r), /* @__PURE__ */ n(l, { metadata: r.fieldsMetadata, errors: e.errors, children: /* @__PURE__ */ n(
+    f,
+    {
+      registry: r.hookFormInternals._fieldElementRegistry,
+      children: /* @__PURE__ */ n(d, { ...r.hookFormInternals.formMethods, children: t })
+    }
+  ) });
 }
 export {
   M as SDKFormProvider

package/dist/partner-hook-utils/form/SDKFormProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"SDKFormProvider.js","sources":["../../../src/partner-hook-utils/form/SDKFormProvider.tsx"],"sourcesContent":["import { type ReactNode, useEffect } from 'react'\nimport type { FieldPath, FieldValues } from 'react-hook-form'\nimport { FormProvider } from 'react-hook-form'\nimport type { FieldMetadata, FieldMetadataWithOptions, HookFormInternals } from '../types'\nimport { FormFieldsMetadataProvider } from './FormFieldsMetadataProvider'\nimport { FieldElementRegistryProvider } from '@/components/Common/Fields/hooks/FieldElementRegistryProvider'\nimport { normalizeErrorKeyForForm } from '@/helpers/formattedStrings'\nimport type { SDKError, SDKFieldError } from '@/types/sdkError'\n\nfunction useSyncFieldErrors<\n  TFormData extends FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  },\n>(\n  fieldErrors: SDKFieldError[],\n  form: {\n    fieldsMetadata: TFieldsMetadata\n    hookFormInternals: HookFormInternals<TFormData>\n  },\n) {\n  const { fieldsMetadata } = form\n  const { setError } = form.hookFormInternals.formMethods\n\n  useEffect(() => {\n    if (!fieldErrors.length) return\n    const knownFields = new Set(Object.keys(fieldsMetadata))\n    for (const fieldError of fieldErrors) {\n      const normalizedField = normalizeErrorKeyForForm(fieldError.field)\n      if (knownFields.has(normalizedField)) {\n        setError(normalizedField as FieldPath<TFormData>, {\n          type: 'custom',\n          message: fieldError.message,\n        })\n      }\n    }\n  }, [fieldErrors, setError, fieldsMetadata])\n}\n\ninterface SDKFormProviderProps<\n  TFormData extends FieldValues = FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  } = Record<string, FieldMetadata | FieldMetadataWithOptions>,\n> {\n  formHookResult: {\n    errorHandling: { errors: SDKError[] }\n    form: {\n      fieldsMetadata: TFieldsMetadata\n      hookFormInternals: HookFormInternals<TFormData>\n    }\n  }\n  children: ReactNode\n}\n\n/**\n * Provides form context to field components so they can read metadata, control,\n * and error state without an explicit `formHookResult` prop on each field.\n * Server-side field errors are automatically synced onto their corresponding fields.\n *\n * @public\n *\n * @example\n * ```tsx\n * const formHookResult = useEmployeeDetailsForm({ employeeId })\n * const { Fields } = formHookResult.form\n *\n * // SDKFormProvider supplies context only — wire up submission and render the\n * // <form> element yourself.\n * const handleSubmit = () =>\n *   formHookResult.actions.onSubmit({ onEmployeeUpdated: (emp) => { ... } })\n *\n * return (\n *   <SDKFormProvider formHookResult={formHookResult}>\n *     <form onSubmit={handleSubmit}>\n *       <Fields.FirstName label=\"First name\" />\n *       <Fields.LastName label=\"Last name\" />\n *       <button type=\"submit\">Save</button>\n *     </form>\n *   </SDKFormProvider>\n * )\n * ```\n */\nexport function SDKFormProvider<\n  TFormData extends FieldValues = FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  } = Record<string, FieldMetadata | FieldMetadataWithOptions>,\n>({ formHookResult, children }: SDKFormProviderProps<TFormData, TFieldsMetadata>) {\n  const { errorHandling, form } = formHookResult\n  const allFieldErrors = errorHandling.errors.flatMap(e => e.fieldErrors)\n  useSyncFieldErrors(allFieldErrors, form)\n\n  return (\n    <FormFieldsMetadataProvider metadata={form.fieldsMetadata} errors={errorHandling.errors}>\n      <FieldElementRegistryProvider registry={form.hookFormInternals._fieldElementRegistry}>\n        <FormProvider {...form.hookFormInternals.formMethods}>{children}</FormProvider>\n      </FieldElementRegistryProvider>\n    </FormFieldsMetadataProvider>\n  )\n}\n"],"names":["useSyncFieldErrors","fieldErrors","form","fieldsMetadata","setError","useEffect","knownFields","fieldError","normalizedField","normalizeErrorKeyForForm","SDKFormProvider","formHookResult","children","errorHandling","allFieldErrors","e","jsx","FormFieldsMetadataProvider","FieldElementRegistryProvider","FormProvider"],"mappings":";;;;;;AASA,SAASA,EAMPC,GACAC,GAIA;AACA,QAAM,EAAE,gBAAAC,MAAmBD,GACrB,EAAE,UAAAE,EAAA,IAAaF,EAAK,kBAAkB;AAE5C,EAAAG,EAAU,MAAM;AACd,QAAI,CAACJ,EAAY,OAAQ;AACzB,UAAMK,IAAc,IAAI,IAAI,OAAO,KAAKH,CAAc,CAAC;AACvD,eAAWI,KAAcN,GAAa;AACpC,YAAMO,IAAkBC,EAAyBF,EAAW,KAAK;AACjE,MAAID,EAAY,IAAIE,CAAe,KACjCJ,EAASI,GAAyC;AAAA,QAChD,MAAM;AAAA,QACN,SAASD,EAAW;AAAA,MAAA,CACrB;AAAA,IAEL;AAAA,EACF,GAAG,CAACN,GAAaG,GAAUD,CAAc,CAAC;AAC5C;AA8CO,SAASO,EAKd,EAAE,gBAAAC,GAAgB,UAAAC,KAA8D;AAChF,QAAM,EAAE,eAAAC,GAAe,MAAAX,EAAA,IAASS,GAC1BG,IAAiBD,EAAc,OAAO,QAAQ,CAAAE,MAAKA,EAAE,WAAW;AACtE,SAAAf,EAAmBc,GAAgBZ,CAAI,GAGrC,gBAAAc,EAACC,KAA2B,UAAUf,EAAK,gBAAgB,QAAQW,EAAc,QAC/E,UAAA,gBAAAG,EAACE,GAAA,EAA6B,UAAUhB,EAAK,kBAAkB,uBAC7D,4BAACiB,GAAA,EAAc,GAAGjB,EAAK,kBAAkB,aAAc,UAAAU,EAAA,CAAS,EAAA,CAClE,EAAA,CACF;AAEJ;"}
+{"version":3,"file":"SDKFormProvider.js","sources":["../../../src/partner-hook-utils/form/SDKFormProvider.tsx"],"sourcesContent":["import { type ReactNode, useEffect } from 'react'\nimport type { FieldPath, FieldValues } from 'react-hook-form'\nimport { FormProvider } from 'react-hook-form'\nimport type { FieldMetadata, FieldMetadataWithOptions, HookFormInternals } from '../types'\nimport { FormFieldsMetadataProvider } from './FormFieldsMetadataProvider'\nimport { FieldElementRegistryProvider } from '@/components/Common/Fields/hooks/FieldElementRegistryProvider'\nimport type { FieldElementRegistry } from '@/components/Common/Fields/hooks/fieldElementRegistry'\nimport { normalizeErrorKeyForForm } from '@/helpers/formattedStrings'\nimport type { SDKError, SDKFieldError } from '@/types/sdkError'\n\nfunction useSyncFieldErrors<\n  TFormData extends FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  },\n>(\n  fieldErrors: SDKFieldError[],\n  form: {\n    fieldsMetadata: TFieldsMetadata\n    hookFormInternals: HookFormInternals<TFormData>\n  },\n) {\n  const { fieldsMetadata } = form\n  const { setError } = form.hookFormInternals.formMethods\n\n  useEffect(() => {\n    if (!fieldErrors.length) return\n    const knownFields = new Set(Object.keys(fieldsMetadata))\n    for (const fieldError of fieldErrors) {\n      const normalizedField = normalizeErrorKeyForForm(fieldError.field)\n      if (knownFields.has(normalizedField)) {\n        setError(normalizedField as FieldPath<TFormData>, {\n          type: 'custom',\n          message: fieldError.message,\n        })\n      }\n    }\n  }, [fieldErrors, setError, fieldsMetadata])\n}\n\n/**\n * Props for {@link SDKFormProvider}.\n *\n * @typeParam TFormData - Shape of the form values managed by the wrapped form hook.\n * @typeParam TFieldsMetadata - The form hook's field-metadata map.\n * @public\n */\nexport interface SDKFormProviderProps<\n  TFormData extends FieldValues = FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  } = Record<string, FieldMetadata | FieldMetadataWithOptions>,\n> {\n  /** The form hook result whose fields, metadata, and errors are shared with descendant field components. */\n  formHookResult: {\n    errorHandling: { errors: SDKError[] }\n    form: {\n      fieldsMetadata: TFieldsMetadata\n      hookFormInternals: HookFormInternals<TFormData>\n    }\n  }\n  /** Field components (or any content) that consume the provided form context. */\n  children: ReactNode\n}\n\n/**\n * Provides form context to field components so they can read metadata, control,\n * and error state without an explicit `formHookResult` prop on each field.\n * Server-side field errors are automatically synced onto their corresponding fields.\n *\n * @public\n * @group Providers\n *\n * @example\n * ```tsx\n * const formHookResult = useEmployeeDetailsForm({ employeeId })\n * const { Fields } = formHookResult.form\n *\n * // SDKFormProvider supplies context only — wire up submission and render the\n * // <form> element yourself.\n * const handleSubmit = () =>\n *   formHookResult.actions.onSubmit({ onEmployeeUpdated: (emp) => { ... } })\n *\n * return (\n *   <SDKFormProvider formHookResult={formHookResult}>\n *     <form onSubmit={handleSubmit}>\n *       <Fields.FirstName label=\"First name\" />\n *       <Fields.LastName label=\"Last name\" />\n *       <button type=\"submit\">Save</button>\n *     </form>\n *   </SDKFormProvider>\n * )\n * ```\n */\nexport function SDKFormProvider<\n  TFormData extends FieldValues = FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  } = Record<string, FieldMetadata | FieldMetadataWithOptions>,\n>({ formHookResult, children }: SDKFormProviderProps<TFormData, TFieldsMetadata>) {\n  const { errorHandling, form } = formHookResult\n  const allFieldErrors = errorHandling.errors.flatMap(e => e.fieldErrors)\n  useSyncFieldErrors(allFieldErrors, form)\n\n  return (\n    <FormFieldsMetadataProvider metadata={form.fieldsMetadata} errors={errorHandling.errors}>\n      <FieldElementRegistryProvider\n        registry={form.hookFormInternals._fieldElementRegistry as FieldElementRegistry | undefined}\n      >\n        <FormProvider {...form.hookFormInternals.formMethods}>{children}</FormProvider>\n      </FieldElementRegistryProvider>\n    </FormFieldsMetadataProvider>\n  )\n}\n"],"names":["useSyncFieldErrors","fieldErrors","form","fieldsMetadata","setError","useEffect","knownFields","fieldError","normalizedField","normalizeErrorKeyForForm","SDKFormProvider","formHookResult","children","errorHandling","allFieldErrors","e","FormFieldsMetadataProvider","jsx","FieldElementRegistryProvider","FormProvider"],"mappings":";;;;;;AAUA,SAASA,EAMPC,GACAC,GAIA;AACA,QAAM,EAAE,gBAAAC,MAAmBD,GACrB,EAAE,UAAAE,EAAA,IAAaF,EAAK,kBAAkB;AAE5C,EAAAG,EAAU,MAAM;AACd,QAAI,CAACJ,EAAY,OAAQ;AACzB,UAAMK,IAAc,IAAI,IAAI,OAAO,KAAKH,CAAc,CAAC;AACvD,eAAWI,KAAcN,GAAa;AACpC,YAAMO,IAAkBC,EAAyBF,EAAW,KAAK;AACjE,MAAID,EAAY,IAAIE,CAAe,KACjCJ,EAASI,GAAyC;AAAA,QAChD,MAAM;AAAA,QACN,SAASD,EAAW;AAAA,MAAA,CACrB;AAAA,IAEL;AAAA,EACF,GAAG,CAACN,GAAaG,GAAUD,CAAc,CAAC;AAC5C;AAwDO,SAASO,EAKd,EAAE,gBAAAC,GAAgB,UAAAC,KAA8D;AAChF,QAAM,EAAE,eAAAC,GAAe,MAAAX,EAAA,IAASS,GAC1BG,IAAiBD,EAAc,OAAO,QAAQ,CAAAE,MAAKA,EAAE,WAAW;AACtE,SAAAf,EAAmBc,GAAgBZ,CAAI,qBAGpCc,GAAA,EAA2B,UAAUd,EAAK,gBAAgB,QAAQW,EAAc,QAC/E,UAAA,gBAAAI;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,UAAUhB,EAAK,kBAAkB;AAAA,MAEjC,4BAACiB,GAAA,EAAc,GAAGjB,EAAK,kBAAkB,aAAc,UAAAU,EAAA,CAAS;AAAA,IAAA;AAAA,EAAA,GAEpE;AAEJ;"}

package/dist/partner-hook-utils/form/composeSubmitHandler.d.ts

@@ -10,8 +10,12 @@ import { HookErrorHandling, HookFormInternals } from '../types';
  * allowing hooks with specific form data generics to be passed without casts.
  * `_fieldElementRegistry` is reused directly since its type doesn't depend on
  * the form's generic.
+ *
+ * @public
+ * @childOf {@link composeSubmitHandler}
  */
-interface ComposableFormHookResult {
+export interface ComposableFormHookResult {
+    /** The form surface: the react-hook-form internals used to validate and focus fields. */
     form: {
         hookFormInternals: Pick<HookFormInternals, '_fieldElementRegistry'> & {
             formMethods: {
@@ -23,6 +27,7 @@ interface ComposableFormHookResult {
             };
         };
     };
+    /** The error-handling surface aggregated across the composed forms. */
     errorHandling: HookErrorHandling;
 }
 /**
@@ -35,7 +40,8 @@ interface ComposableFormHookResult {
  *   but no `errorHandling` (fields surface their own inline errors via react-hook-form).
  *
  * @typeParam T - The shape of the form values when a raw `UseFormReturn` is passed.
- * @internal
+ * @public
+ * @childOf {@link composeSubmitHandler}
  */
 export type ComposeSubmitInput<T extends FieldValues = FieldValues> = ComposableFormHookResult | UseFormReturn<T>;
 /**
@@ -43,6 +49,7 @@ export type ComposeSubmitInput<T extends FieldValues = FieldValues> = Composable
  * coordinates validation across the composed forms, and aggregated error state.
  *
  * @public
+ * @childOf {@link composeSubmitHandler}
  */
 export interface ComposeSubmitHandlerResult {
     /** Submit handler to pass to a form's `onSubmit`. Validates all composed forms before calling `onAllValid`. */
@@ -68,13 +75,14 @@ export interface ComposeSubmitHandlerResult {
  *
  * The returned `errorHandling` is the same shape every SDK hook returns, so the whole result
  * can be passed back into {@link composeErrorHandler} when you need to add extra
- * `@gusto/embedded-api-v-2026-02-01` queries or screen-level submit state.
+ * `@gusto/embedded-api-v-2026-06-15` queries or screen-level submit state.
  *
  * @typeParam TForms - Tuple of form value shapes, one per slot of `forms`.
  * @param forms - Form hook results and/or raw `UseFormReturn` instances to coordinate.
  * @param onAllValid - Async callback invoked once every form has passed validation.
  * @returns A {@link ComposeSubmitHandlerResult} with a unified `handleSubmit` and aggregated `errorHandling`.
  * @public
+ * @group Form composition
  *
  * @example
  * ```tsx
@@ -95,4 +103,3 @@ export interface ComposeSubmitHandlerResult {
 export declare function composeSubmitHandler<TForms extends readonly FieldValues[]>(forms: readonly [...{
     [K in keyof TForms]: ComposeSubmitInput<TForms[K]>;
 }], onAllValid: () => Promise<void>): ComposeSubmitHandlerResult;
-export {};

package/dist/partner-hook-utils/form/composeSubmitHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"composeSubmitHandler.js","sources":["../../../src/partner-hook-utils/form/composeSubmitHandler.ts"],"sourcesContent":["import type { SyntheticEvent } from 'react'\nimport type { FieldValues, UseFormReturn } from 'react-hook-form'\nimport { composeErrorHandler } from '../composeErrorHandler'\nimport type { HookErrorHandling, HookFormInternals } from '../types'\n\n/**\n * Minimal shape required for a form hook result to participate in `composeSubmitHandler`.\n * Any hook returning `BaseFormHookReady` satisfies this interface.\n *\n * `formMethods` is declared with method-call syntax (rather than reused from\n * `HookFormInternals`) so TypeScript applies bivariant parameter checking,\n * allowing hooks with specific form data generics to be passed without casts.\n * `_fieldElementRegistry` is reused directly since its type doesn't depend on\n * the form's generic.\n */\ninterface ComposableFormHookResult {\n  form: {\n    hookFormInternals: Pick<HookFormInternals, '_fieldElementRegistry'> & {\n      formMethods: {\n        handleSubmit(\n          onValid: () => void,\n          onInvalid?: (errors: Record<string, unknown>) => void,\n        ): () => Promise<void>\n        setFocus(name: string): void\n        formState: { errors: Record<string, unknown> }\n      }\n    }\n  }\n  errorHandling: HookErrorHandling\n}\n\n/**\n * Accepted input for a single slot of `composeSubmitHandler`'s `forms` array.\n *\n * @remarks\n * - SDK form hook results (anything matching `ComposableFormHookResult`) are composed directly.\n * - A raw `react-hook-form` `UseFormReturn<T>` is supported for screen-local auxiliary forms\n *   that don't warrant a dedicated SDK hook. Raw forms contribute validation/focus behavior\n *   but no `errorHandling` (fields surface their own inline errors via react-hook-form).\n *\n * @typeParam T - The shape of the form values when a raw `UseFormReturn` is passed.\n * @internal\n */\nexport type ComposeSubmitInput<T extends FieldValues = FieldValues> =\n  ComposableFormHookResult | UseFormReturn<T>\n\ninterface FormValidationResult {\n  input: ComposeSubmitInput\n  formMethods: FormMethods\n  valid: boolean\n  errors: Record<string, unknown>\n}\n\n/**\n * Result returned by {@link composeSubmitHandler}: a single submit handler that\n * coordinates validation across the composed forms, and aggregated error state.\n *\n * @public\n */\nexport interface ComposeSubmitHandlerResult {\n  /** Submit handler to pass to a form's `onSubmit`. Validates all composed forms before calling `onAllValid`. */\n  handleSubmit: (e: SyntheticEvent) => Promise<void>\n  /** Aggregated error state across all composed SDK form hooks. Pass to {@link composeErrorHandler} for screen-level error surfaces. */\n  errorHandling: HookErrorHandling\n}\n\ntype FormMethods = ComposableFormHookResult['form']['hookFormInternals']['formMethods']\n\nfunction isRawUseForm<T extends FieldValues>(\n  input: ComposeSubmitInput<T>,\n): input is UseFormReturn<T> {\n  return 'handleSubmit' in input && typeof input.handleSubmit === 'function'\n}\n\nfunction extractFormMethods<T extends FieldValues>(input: ComposeSubmitInput<T>): FormMethods {\n  if (isRawUseForm(input)) return input as unknown as FormMethods\n  return input.form.hookFormInternals.formMethods\n}\n\n/**\n * Picks the visually first invalid field across all composed forms using live\n * `getBoundingClientRect()` positions, then focuses its DOM element. Falls back\n * to array-order (first form's first error) when no element can be resolved —\n * raw `UseFormReturn` inputs have no registry, and forms rendered without\n * `SDKFormProvider` or a HookField wrapper won't have their fields registered\n * either, so we let react-hook-form's `setFocus` attempt it instead.\n *\n * Consumes `results` (captured from each form's `onInvalid` callback) rather\n * than reading `formState.errors` — the latter is a proxy that returns `{}`\n * when accessed outside a component subscription.\n */\nfunction focusFirstInvalidAcrossForms(results: FormValidationResult[]): void {\n  type Candidate = {\n    formMethods: FormMethods\n    name: string\n    element: HTMLElement\n  }\n  const candidates: Candidate[] = []\n  for (const { input, formMethods, errors } of results) {\n    if (isRawUseForm(input)) continue\n    const registry = input.form.hookFormInternals._fieldElementRegistry\n    if (!registry) continue\n    for (const name of Object.keys(errors)) {\n      const element = registry.get(name)\n      if (element) {\n        candidates.push({ formMethods, name, element })\n      }\n    }\n  }\n\n  if (candidates.length > 0) {\n    candidates.sort((a, b) => {\n      const ar = a.element.getBoundingClientRect()\n      const br = b.element.getBoundingClientRect()\n      return ar.top - br.top || ar.left - br.left\n    })\n    const winner = candidates[0]!\n    // Focus the DOM element directly. Bypasses react-hook-form's `setFocus`,\n    // which depends on `_fields[name]._f.ref` and isn't reliably populated\n    // when fields are rendered through libraries like react-aria-components.\n    winner.element.focus()\n    return\n  }\n\n  for (const { formMethods, errors } of results) {\n    const firstErrorField = Object.keys(errors)[0]\n    if (firstErrorField) {\n      formMethods.setFocus(firstErrorField)\n      return\n    }\n  }\n}\n\n/**\n * Coordinates validation and submission across multiple form hooks on the same page.\n *\n * @remarks\n * Validates all forms simultaneously via `handleSubmit()`, then focuses the visually first\n * invalid field across all forms (sorted by `getBoundingClientRect()`). Only calls\n * `onAllValid` when every form passes.\n *\n * Uses `handleSubmit` rather than `trigger` so that react-hook-form sets\n * `formState.isSubmitted = true`, which enables `reValidateMode` (default: `onChange`).\n * Without this, errors set by manual `trigger()` calls would never clear as the user types.\n *\n * Each hook passed to `forms` should be initialized with `shouldFocusError: false` so that\n * react-hook-form's built-in per-form focus is disabled and `composeSubmitHandler` can manage\n * cross-form focus instead.\n *\n * The returned `errorHandling` is the same shape every SDK hook returns, so the whole result\n * can be passed back into {@link composeErrorHandler} when you need to add extra\n * `@gusto/embedded-api-v-2026-02-01` queries or screen-level submit state.\n *\n * @typeParam TForms - Tuple of form value shapes, one per slot of `forms`.\n * @param forms - Form hook results and/or raw `UseFormReturn` instances to coordinate.\n * @param onAllValid - Async callback invoked once every form has passed validation.\n * @returns A {@link ComposeSubmitHandlerResult} with a unified `handleSubmit` and aggregated `errorHandling`.\n * @public\n *\n * @example\n * ```tsx\n * const detailsForm = useEmployeeDetailsForm({ employeeId, shouldFocusError: false })\n * const addressForm = useHomeAddressForm({ employeeId, shouldFocusError: false })\n *\n * const { handleSubmit, errorHandling } = composeSubmitHandler(\n *   [detailsForm, addressForm],\n *   async () => {\n *     await detailsForm.actions.onSubmit()\n *     await addressForm.actions.onSubmit()\n *   },\n * )\n *\n * return <form onSubmit={handleSubmit}>...</form>\n * ```\n */\nexport function composeSubmitHandler<TForms extends readonly FieldValues[]>(\n  forms: readonly [...{ [K in keyof TForms]: ComposeSubmitInput<TForms[K]> }],\n  onAllValid: () => Promise<void>,\n): ComposeSubmitHandlerResult {\n  const errorSources = forms.filter((form): form is ComposableFormHookResult => !isRawUseForm(form))\n\n  const handleSubmit = async (e: SyntheticEvent) => {\n    e.preventDefault()\n\n    const validationResults = await Promise.all(\n      forms.map(\n        input =>\n          new Promise<FormValidationResult>(resolve => {\n            const formMethods = extractFormMethods(input)\n            void formMethods.handleSubmit(\n              () => {\n                resolve({ input, formMethods, valid: true, errors: {} })\n              },\n              errors => {\n                resolve({ input, formMethods, valid: false, errors })\n              },\n            )()\n          }),\n      ),\n    )\n\n    const allValid = validationResults.every(r => r.valid)\n\n    if (!allValid) {\n      focusFirstInvalidAcrossForms(validationResults)\n      return\n    }\n\n    await onAllValid()\n  }\n\n  const errorHandling = composeErrorHandler(errorSources)\n\n  return { handleSubmit, errorHandling }\n}\n"],"names":["isRawUseForm","input","extractFormMethods","focusFirstInvalidAcrossForms","results","candidates","formMethods","errors","registry","name","element","a","b","ar","br","firstErrorField","composeSubmitHandler","forms","onAllValid","errorSources","form","handleSubmit","e","validationResults","resolve","r","errorHandling","composeErrorHandler"],"mappings":";AAoEA,SAASA,EACPC,GAC2B;AAC3B,SAAO,kBAAkBA,KAAS,OAAOA,EAAM,gBAAiB;AAClE;AAEA,SAASC,EAA0CD,GAA2C;AAC5F,SAAID,EAAaC,CAAK,IAAUA,IACzBA,EAAM,KAAK,kBAAkB;AACtC;AAcA,SAASE,EAA6BC,GAAuC;AAM3E,QAAMC,IAA0B,CAAA;AAChC,aAAW,EAAE,OAAAJ,GAAO,aAAAK,GAAa,QAAAC,EAAA,KAAYH,GAAS;AACpD,QAAIJ,EAAaC,CAAK,EAAG;AACzB,UAAMO,IAAWP,EAAM,KAAK,kBAAkB;AAC9C,QAAKO;AACL,iBAAWC,KAAQ,OAAO,KAAKF,CAAM,GAAG;AACtC,cAAMG,IAAUF,EAAS,IAAIC,CAAI;AACjC,QAAIC,KACFL,EAAW,KAAK,EAAE,aAAAC,GAAa,MAAAG,GAAM,SAAAC,GAAS;AAAA,MAElD;AAAA,EACF;AAEA,MAAIL,EAAW,SAAS,GAAG;AACzB,IAAAA,EAAW,KAAK,CAACM,GAAGC,MAAM;AACxB,YAAMC,IAAKF,EAAE,QAAQ,sBAAA,GACfG,IAAKF,EAAE,QAAQ,sBAAA;AACrB,aAAOC,EAAG,MAAMC,EAAG,OAAOD,EAAG,OAAOC,EAAG;AAAA,IACzC,CAAC,GACcT,EAAW,CAAC,EAIpB,QAAQ,MAAA;AACf;AAAA,EACF;AAEA,aAAW,EAAE,aAAAC,GAAa,QAAAC,EAAA,KAAYH,GAAS;AAC7C,UAAMW,IAAkB,OAAO,KAAKR,CAAM,EAAE,CAAC;AAC7C,QAAIQ,GAAiB;AACnB,MAAAT,EAAY,SAASS,CAAe;AACpC;AAAA,IACF;AAAA,EACF;AACF;AA4CO,SAASC,EACdC,GACAC,GAC4B;AAC5B,QAAMC,IAAeF,EAAM,OAAO,CAACG,MAA2C,CAACpB,EAAaoB,CAAI,CAAC,GAE3FC,IAAe,OAAOC,MAAsB;AAChD,IAAAA,EAAE,eAAA;AAEF,UAAMC,IAAoB,MAAM,QAAQ;AAAA,MACtCN,EAAM;AAAA,QACJ,CAAAhB,MACE,IAAI,QAA8B,CAAAuB,MAAW;AAC3C,gBAAMlB,IAAcJ,EAAmBD,CAAK;AAC5C,UAAKK,EAAY;AAAA,YACf,MAAM;AACJ,cAAAkB,EAAQ,EAAE,OAAAvB,GAAO,aAAAK,GAAa,OAAO,IAAM,QAAQ,CAAA,GAAI;AAAA,YACzD;AAAA,YACA,CAAAC,MAAU;AACR,cAAAiB,EAAQ,EAAE,OAAAvB,GAAO,aAAAK,GAAa,OAAO,IAAO,QAAAC,GAAQ;AAAA,YACtD;AAAA,UAAA,EACF;AAAA,QACF,CAAC;AAAA,MAAA;AAAA,IACL;AAKF,QAAI,CAFagB,EAAkB,MAAM,CAAAE,MAAKA,EAAE,KAAK,GAEtC;AACb,MAAAtB,EAA6BoB,CAAiB;AAC9C;AAAA,IACF;AAEA,UAAML,EAAA;AAAA,EACR,GAEMQ,IAAgBC,EAAoBR,CAAY;AAEtD,SAAO,EAAE,cAAAE,GAAc,eAAAK,EAAA;AACzB;"}
+{"version":3,"file":"composeSubmitHandler.js","sources":["../../../src/partner-hook-utils/form/composeSubmitHandler.ts"],"sourcesContent":["import type { SyntheticEvent } from 'react'\nimport type { FieldValues, UseFormReturn } from 'react-hook-form'\nimport { composeErrorHandler } from '../composeErrorHandler'\nimport type { HookErrorHandling, HookFormInternals } from '../types'\nimport type { FieldElementRegistry } from '@/components/Common/Fields/hooks/fieldElementRegistry'\n\n/**\n * Minimal shape required for a form hook result to participate in `composeSubmitHandler`.\n * Any hook returning `BaseFormHookReady` satisfies this interface.\n *\n * `formMethods` is declared with method-call syntax (rather than reused from\n * `HookFormInternals`) so TypeScript applies bivariant parameter checking,\n * allowing hooks with specific form data generics to be passed without casts.\n * `_fieldElementRegistry` is reused directly since its type doesn't depend on\n * the form's generic.\n *\n * @public\n * @childOf {@link composeSubmitHandler}\n */\nexport interface ComposableFormHookResult {\n  /** The form surface: the react-hook-form internals used to validate and focus fields. */\n  form: {\n    hookFormInternals: Pick<HookFormInternals, '_fieldElementRegistry'> & {\n      formMethods: {\n        handleSubmit(\n          onValid: () => void,\n          onInvalid?: (errors: Record<string, unknown>) => void,\n        ): () => Promise<void>\n        setFocus(name: string): void\n        formState: { errors: Record<string, unknown> }\n      }\n    }\n  }\n  /** The error-handling surface aggregated across the composed forms. */\n  errorHandling: HookErrorHandling\n}\n\n/**\n * Accepted input for a single slot of `composeSubmitHandler`'s `forms` array.\n *\n * @remarks\n * - SDK form hook results (anything matching `ComposableFormHookResult`) are composed directly.\n * - A raw `react-hook-form` `UseFormReturn<T>` is supported for screen-local auxiliary forms\n *   that don't warrant a dedicated SDK hook. Raw forms contribute validation/focus behavior\n *   but no `errorHandling` (fields surface their own inline errors via react-hook-form).\n *\n * @typeParam T - The shape of the form values when a raw `UseFormReturn` is passed.\n * @public\n * @childOf {@link composeSubmitHandler}\n */\nexport type ComposeSubmitInput<T extends FieldValues = FieldValues> =\n  ComposableFormHookResult | UseFormReturn<T>\n\ninterface FormValidationResult {\n  input: ComposeSubmitInput\n  formMethods: FormMethods\n  valid: boolean\n  errors: Record<string, unknown>\n}\n\n/**\n * Result returned by {@link composeSubmitHandler}: a single submit handler that\n * coordinates validation across the composed forms, and aggregated error state.\n *\n * @public\n * @childOf {@link composeSubmitHandler}\n */\nexport interface ComposeSubmitHandlerResult {\n  /** Submit handler to pass to a form's `onSubmit`. Validates all composed forms before calling `onAllValid`. */\n  handleSubmit: (e: SyntheticEvent) => Promise<void>\n  /** Aggregated error state across all composed SDK form hooks. Pass to {@link composeErrorHandler} for screen-level error surfaces. */\n  errorHandling: HookErrorHandling\n}\n\ntype FormMethods = ComposableFormHookResult['form']['hookFormInternals']['formMethods']\n\nfunction isRawUseForm<T extends FieldValues>(\n  input: ComposeSubmitInput<T>,\n): input is UseFormReturn<T> {\n  return 'handleSubmit' in input && typeof input.handleSubmit === 'function'\n}\n\nfunction extractFormMethods<T extends FieldValues>(input: ComposeSubmitInput<T>): FormMethods {\n  if (isRawUseForm(input)) return input as unknown as FormMethods\n  return input.form.hookFormInternals.formMethods\n}\n\n/**\n * Picks the visually first invalid field across all composed forms using live\n * `getBoundingClientRect()` positions, then focuses its DOM element. Falls back\n * to array-order (first form's first error) when no element can be resolved —\n * raw `UseFormReturn` inputs have no registry, and forms rendered without\n * `SDKFormProvider` or a HookField wrapper won't have their fields registered\n * either, so we let react-hook-form's `setFocus` attempt it instead.\n *\n * Consumes `results` (captured from each form's `onInvalid` callback) rather\n * than reading `formState.errors` — the latter is a proxy that returns `{}`\n * when accessed outside a component subscription.\n */\nfunction focusFirstInvalidAcrossForms(results: FormValidationResult[]): void {\n  type Candidate = {\n    formMethods: FormMethods\n    name: string\n    element: HTMLElement\n  }\n  const candidates: Candidate[] = []\n  for (const { input, formMethods, errors } of results) {\n    if (isRawUseForm(input)) continue\n    const registry = input.form.hookFormInternals._fieldElementRegistry as\n      FieldElementRegistry | undefined\n    if (!registry) continue\n    for (const name of Object.keys(errors)) {\n      const element = registry.get(name)\n      if (element) {\n        candidates.push({ formMethods, name, element })\n      }\n    }\n  }\n\n  if (candidates.length > 0) {\n    candidates.sort((a, b) => {\n      const ar = a.element.getBoundingClientRect()\n      const br = b.element.getBoundingClientRect()\n      return ar.top - br.top || ar.left - br.left\n    })\n    const winner = candidates[0]!\n    // Focus the DOM element directly. Bypasses react-hook-form's `setFocus`,\n    // which depends on `_fields[name]._f.ref` and isn't reliably populated\n    // when fields are rendered through libraries like react-aria-components.\n    winner.element.focus()\n    return\n  }\n\n  for (const { formMethods, errors } of results) {\n    const firstErrorField = Object.keys(errors)[0]\n    if (firstErrorField) {\n      formMethods.setFocus(firstErrorField)\n      return\n    }\n  }\n}\n\n/**\n * Coordinates validation and submission across multiple form hooks on the same page.\n *\n * @remarks\n * Validates all forms simultaneously via `handleSubmit()`, then focuses the visually first\n * invalid field across all forms (sorted by `getBoundingClientRect()`). Only calls\n * `onAllValid` when every form passes.\n *\n * Uses `handleSubmit` rather than `trigger` so that react-hook-form sets\n * `formState.isSubmitted = true`, which enables `reValidateMode` (default: `onChange`).\n * Without this, errors set by manual `trigger()` calls would never clear as the user types.\n *\n * Each hook passed to `forms` should be initialized with `shouldFocusError: false` so that\n * react-hook-form's built-in per-form focus is disabled and `composeSubmitHandler` can manage\n * cross-form focus instead.\n *\n * The returned `errorHandling` is the same shape every SDK hook returns, so the whole result\n * can be passed back into {@link composeErrorHandler} when you need to add extra\n * `@gusto/embedded-api-v-2026-06-15` queries or screen-level submit state.\n *\n * @typeParam TForms - Tuple of form value shapes, one per slot of `forms`.\n * @param forms - Form hook results and/or raw `UseFormReturn` instances to coordinate.\n * @param onAllValid - Async callback invoked once every form has passed validation.\n * @returns A {@link ComposeSubmitHandlerResult} with a unified `handleSubmit` and aggregated `errorHandling`.\n * @public\n * @group Form composition\n *\n * @example\n * ```tsx\n * const detailsForm = useEmployeeDetailsForm({ employeeId, shouldFocusError: false })\n * const addressForm = useHomeAddressForm({ employeeId, shouldFocusError: false })\n *\n * const { handleSubmit, errorHandling } = composeSubmitHandler(\n *   [detailsForm, addressForm],\n *   async () => {\n *     await detailsForm.actions.onSubmit()\n *     await addressForm.actions.onSubmit()\n *   },\n * )\n *\n * return <form onSubmit={handleSubmit}>...</form>\n * ```\n */\nexport function composeSubmitHandler<TForms extends readonly FieldValues[]>(\n  forms: readonly [...{ [K in keyof TForms]: ComposeSubmitInput<TForms[K]> }],\n  onAllValid: () => Promise<void>,\n): ComposeSubmitHandlerResult {\n  const errorSources = forms.filter((form): form is ComposableFormHookResult => !isRawUseForm(form))\n\n  const handleSubmit = async (e: SyntheticEvent) => {\n    e.preventDefault()\n\n    const validationResults = await Promise.all(\n      forms.map(\n        input =>\n          new Promise<FormValidationResult>(resolve => {\n            const formMethods = extractFormMethods(input)\n            void formMethods.handleSubmit(\n              () => {\n                resolve({ input, formMethods, valid: true, errors: {} })\n              },\n              errors => {\n                resolve({ input, formMethods, valid: false, errors })\n              },\n            )()\n          }),\n      ),\n    )\n\n    const allValid = validationResults.every(r => r.valid)\n\n    if (!allValid) {\n      focusFirstInvalidAcrossForms(validationResults)\n      return\n    }\n\n    await onAllValid()\n  }\n\n  const errorHandling = composeErrorHandler(errorSources)\n\n  return { handleSubmit, errorHandling }\n}\n"],"names":["isRawUseForm","input","extractFormMethods","focusFirstInvalidAcrossForms","results","candidates","formMethods","errors","registry","name","element","a","b","ar","br","firstErrorField","composeSubmitHandler","forms","onAllValid","errorSources","form","handleSubmit","e","validationResults","resolve","r","errorHandling","composeErrorHandler"],"mappings":";AA4EA,SAASA,EACPC,GAC2B;AAC3B,SAAO,kBAAkBA,KAAS,OAAOA,EAAM,gBAAiB;AAClE;AAEA,SAASC,EAA0CD,GAA2C;AAC5F,SAAID,EAAaC,CAAK,IAAUA,IACzBA,EAAM,KAAK,kBAAkB;AACtC;AAcA,SAASE,EAA6BC,GAAuC;AAM3E,QAAMC,IAA0B,CAAA;AAChC,aAAW,EAAE,OAAAJ,GAAO,aAAAK,GAAa,QAAAC,EAAA,KAAYH,GAAS;AACpD,QAAIJ,EAAaC,CAAK,EAAG;AACzB,UAAMO,IAAWP,EAAM,KAAK,kBAAkB;AAE9C,QAAKO;AACL,iBAAWC,KAAQ,OAAO,KAAKF,CAAM,GAAG;AACtC,cAAMG,IAAUF,EAAS,IAAIC,CAAI;AACjC,QAAIC,KACFL,EAAW,KAAK,EAAE,aAAAC,GAAa,MAAAG,GAAM,SAAAC,GAAS;AAAA,MAElD;AAAA,EACF;AAEA,MAAIL,EAAW,SAAS,GAAG;AACzB,IAAAA,EAAW,KAAK,CAACM,GAAGC,MAAM;AACxB,YAAMC,IAAKF,EAAE,QAAQ,sBAAA,GACfG,IAAKF,EAAE,QAAQ,sBAAA;AACrB,aAAOC,EAAG,MAAMC,EAAG,OAAOD,EAAG,OAAOC,EAAG;AAAA,IACzC,CAAC,GACcT,EAAW,CAAC,EAIpB,QAAQ,MAAA;AACf;AAAA,EACF;AAEA,aAAW,EAAE,aAAAC,GAAa,QAAAC,EAAA,KAAYH,GAAS;AAC7C,UAAMW,IAAkB,OAAO,KAAKR,CAAM,EAAE,CAAC;AAC7C,QAAIQ,GAAiB;AACnB,MAAAT,EAAY,SAASS,CAAe;AACpC;AAAA,IACF;AAAA,EACF;AACF;AA6CO,SAASC,EACdC,GACAC,GAC4B;AAC5B,QAAMC,IAAeF,EAAM,OAAO,CAACG,MAA2C,CAACpB,EAAaoB,CAAI,CAAC,GAE3FC,IAAe,OAAOC,MAAsB;AAChD,IAAAA,EAAE,eAAA;AAEF,UAAMC,IAAoB,MAAM,QAAQ;AAAA,MACtCN,EAAM;AAAA,QACJ,CAAAhB,MACE,IAAI,QAA8B,CAAAuB,MAAW;AAC3C,gBAAMlB,IAAcJ,EAAmBD,CAAK;AAC5C,UAAKK,EAAY;AAAA,YACf,MAAM;AACJ,cAAAkB,EAAQ,EAAE,OAAAvB,GAAO,aAAAK,GAAa,OAAO,IAAM,QAAQ,CAAA,GAAI;AAAA,YACzD;AAAA,YACA,CAAAC,MAAU;AACR,cAAAiB,EAAQ,EAAE,OAAAvB,GAAO,aAAAK,GAAa,OAAO,IAAO,QAAAC,GAAQ;AAAA,YACtD;AAAA,UAAA,EACF;AAAA,QACF,CAAC;AAAA,MAAA;AAAA,IACL;AAKF,QAAI,CAFagB,EAAkB,MAAM,CAAAE,MAAKA,EAAE,KAAK,GAEtC;AACb,MAAAtB,EAA6BoB,CAAiB;AAC9C;AAAA,IACF;AAEA,UAAML,EAAA;AAAA,EACR,GAEMQ,IAAgBC,EAAoBR,CAAY;AAEtD,SAAO,EAAE,cAAAE,GAAc,eAAAK,EAAA;AACzB;"}

package/dist/partner-hook-utils/form/fields/CheckboxHookField.d.ts

@@ -8,6 +8,7 @@ import { CheckboxProps } from '../../../components/Common/UI/Checkbox/CheckboxTy
  *
  * @typeParam TErrorCode - Validation error code keys mapped via `validationMessages`.
  * @public
+ * @group Hook field props
  */
 export interface CheckboxHookFieldProps<TErrorCode extends string = never> extends BaseFieldProps {
     /** The field name; must match the corresponding key in the form schema. */

package/dist/partner-hook-utils/form/fields/CheckboxHookField.js.map

@@ -1 +1 @@
-{"version":3,"file":"CheckboxHookField.js","sources":["../../../../src/partner-hook-utils/form/fields/CheckboxHookField.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useHookFieldResolution } from '../useHookFieldResolution'\nimport type { BaseFieldProps, ValidationMessages, FormHookResult } from '../../types'\nimport { withFieldElementRegistry } from './withFieldElementRegistry'\nimport { CheckboxField } from '@/components/Common'\nimport type { CheckboxProps } from '@/components/Common/UI/Checkbox/CheckboxTypes'\n\n/**\n * Props accepted by a checkbox field surfaced through a form hook.\n * Exposes `validationMessages` for custom error text alongside the shared base\n * field attributes (`label`, `description`).\n *\n * @typeParam TErrorCode - Validation error code keys mapped via `validationMessages`.\n * @public\n */\nexport interface CheckboxHookFieldProps<TErrorCode extends string = never> extends BaseFieldProps {\n  /** The field name; must match the corresponding key in the form schema. */\n  name: string\n  /** Form hook result to connect to; falls back to the nearest `SDKFormProvider` when omitted. */\n  formHookResult?: FormHookResult\n  /** Custom error text keyed by validation error code. */\n  validationMessages?: ValidationMessages<TErrorCode>\n  /** Replaces the default checkbox UI component; must accept the same props as `CheckboxProps`. */\n  FieldComponent?: ComponentType<CheckboxProps>\n}\n\n/**\n * Checkbox field connected to a partner form hook result via `useHookFieldResolution`.\n *\n * @typeParam TErrorCode - Validation error code keys mapped via `validationMessages`.\n * @param props - Field configuration including `name`, `formHookResult`, and label content.\n * @returns The rendered checkbox field wrapped in the field element registry.\n * @internal\n */\nexport function CheckboxHookField<TErrorCode extends string>({\n  name,\n  formHookResult,\n  label,\n  description,\n  validationMessages,\n  FieldComponent,\n}: CheckboxHookFieldProps<TErrorCode>) {\n  const { metadata, control, errorMessage, fieldElementRegistry } = useHookFieldResolution(\n    name,\n    formHookResult,\n    validationMessages,\n  )\n  const fieldMetadata = metadata[name]\n\n  return withFieldElementRegistry(\n    fieldElementRegistry,\n    <CheckboxField\n      name={name}\n      control={control}\n      label={label}\n      description={description}\n      errorMessage={errorMessage}\n      isRequired={fieldMetadata?.isRequired}\n      isDisabled={fieldMetadata?.isDisabled}\n      FieldComponent={FieldComponent}\n    />,\n  )\n}\n"],"names":["CheckboxHookField","name","formHookResult","label","description","validationMessages","FieldComponent","metadata","control","errorMessage","fieldElementRegistry","useHookFieldResolution","fieldMetadata","withFieldElementRegistry","jsx","CheckboxField"],"mappings":";;;;;;;AAkCO,SAASA,EAA6C;AAAA,EAC3D,MAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,oBAAAC;AAAA,EACA,gBAAAC;AACF,GAAuC;AACrC,QAAM,EAAE,UAAAC,GAAU,SAAAC,GAAS,cAAAC,GAAc,sBAAAC,MAAyBC;AAAA,IAChEV;AAAA,IACAC;AAAA,IACAG;AAAA,EAAA,GAEIO,IAAgBL,EAASN,CAAI;AAEnC,SAAOY;AAAA,IACLH;AAAA,IACA,gBAAAI;AAAA,MAACC;AAAA,MAAA;AAAA,QACC,MAAAd;AAAA,QACA,SAAAO;AAAA,QACA,OAAAL;AAAA,QACA,aAAAC;AAAA,QACA,cAAAK;AAAA,QACA,YAAYG,GAAe;AAAA,QAC3B,YAAYA,GAAe;AAAA,QAC3B,gBAAAN;AAAA,MAAA;AAAA,IAAA;AAAA,EACF;AAEJ;"}
+{"version":3,"file":"CheckboxHookField.js","sources":["../../../../src/partner-hook-utils/form/fields/CheckboxHookField.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useHookFieldResolution } from '../useHookFieldResolution'\nimport type { BaseFieldProps, ValidationMessages, FormHookResult } from '../../types'\nimport { withFieldElementRegistry } from './withFieldElementRegistry'\nimport { CheckboxField } from '@/components/Common'\nimport type { CheckboxProps } from '@/components/Common/UI/Checkbox/CheckboxTypes'\n\n/**\n * Props accepted by a checkbox field surfaced through a form hook.\n * Exposes `validationMessages` for custom error text alongside the shared base\n * field attributes (`label`, `description`).\n *\n * @typeParam TErrorCode - Validation error code keys mapped via `validationMessages`.\n * @public\n * @group Hook field props\n */\nexport interface CheckboxHookFieldProps<TErrorCode extends string = never> extends BaseFieldProps {\n  /** The field name; must match the corresponding key in the form schema. */\n  name: string\n  /** Form hook result to connect to; falls back to the nearest `SDKFormProvider` when omitted. */\n  formHookResult?: FormHookResult\n  /** Custom error text keyed by validation error code. */\n  validationMessages?: ValidationMessages<TErrorCode>\n  /** Replaces the default checkbox UI component; must accept the same props as `CheckboxProps`. */\n  FieldComponent?: ComponentType<CheckboxProps>\n}\n\n/**\n * Checkbox field connected to a partner form hook result via `useHookFieldResolution`.\n *\n * @typeParam TErrorCode - Validation error code keys mapped via `validationMessages`.\n * @param props - Field configuration including `name`, `formHookResult`, and label content.\n * @returns The rendered checkbox field wrapped in the field element registry.\n * @internal\n */\nexport function CheckboxHookField<TErrorCode extends string>({\n  name,\n  formHookResult,\n  label,\n  description,\n  validationMessages,\n  FieldComponent,\n}: CheckboxHookFieldProps<TErrorCode>) {\n  const { metadata, control, errorMessage, fieldElementRegistry } = useHookFieldResolution(\n    name,\n    formHookResult,\n    validationMessages,\n  )\n  const fieldMetadata = metadata[name]\n\n  return withFieldElementRegistry(\n    fieldElementRegistry,\n    <CheckboxField\n      name={name}\n      control={control}\n      label={label}\n      description={description}\n      errorMessage={errorMessage}\n      isRequired={fieldMetadata?.isRequired}\n      isDisabled={fieldMetadata?.isDisabled}\n      FieldComponent={FieldComponent}\n    />,\n  )\n}\n"],"names":["CheckboxHookField","name","formHookResult","label","description","validationMessages","FieldComponent","metadata","control","errorMessage","fieldElementRegistry","useHookFieldResolution","fieldMetadata","withFieldElementRegistry","jsx","CheckboxField"],"mappings":";;;;;;;AAmCO,SAASA,EAA6C;AAAA,EAC3D,MAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,oBAAAC;AAAA,EACA,gBAAAC;AACF,GAAuC;AACrC,QAAM,EAAE,UAAAC,GAAU,SAAAC,GAAS,cAAAC,GAAc,sBAAAC,MAAyBC;AAAA,IAChEV;AAAA,IACAC;AAAA,IACAG;AAAA,EAAA,GAEIO,IAAgBL,EAASN,CAAI;AAEnC,SAAOY;AAAA,IACLH;AAAA,IACA,gBAAAI;AAAA,MAACC;AAAA,MAAA;AAAA,QACC,MAAAd;AAAA,QACA,SAAAO;AAAA,QACA,OAAAL;AAAA,QACA,aAAAC;AAAA,QACA,cAAAK;AAAA,QACA,YAAYG,GAAe;AAAA,QAC3B,YAAYA,GAAe;AAAA,QAC3B,gBAAAN;AAAA,MAAA;AAAA,IAAA;AAAA,EACF;AAEJ;"}

package/dist/partner-hook-utils/form/fields/DatePickerHookField.d.ts

@@ -10,6 +10,7 @@ import { DatePickerProps } from '../../../components/Common/UI/DatePicker/DatePi
  *
  * @typeParam TErrorCode - Validation error code keys mapped via `validationMessages`.
  * @public
+ * @group Hook field props
  */
 export interface DatePickerHookFieldProps<TErrorCode extends string = never> extends BaseFieldProps, Pick<DatePickerProps, 'portalContainer' | 'minDate' | 'maxDate'> {
     /** The field name; must match the corresponding key in the form schema. */

package/dist/partner-hook-utils/form/fields/DatePickerHookField.js.map

@@ -1 +1 @@
-{"version":3,"file":"DatePickerHookField.js","sources":["../../../../src/partner-hook-utils/form/fields/DatePickerHookField.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useHookFieldResolution } from '../useHookFieldResolution'\nimport type { BaseFieldProps, ValidationMessages, FormHookResult } from '../../types'\nimport { withFieldElementRegistry } from './withFieldElementRegistry'\nimport { DatePickerField } from '@/components/Common/Fields/DatePickerField'\nimport type { DatePickerProps } from '@/components/Common/UI/DatePicker/DatePickerTypes'\nimport { normalizeToDate } from '@/helpers/dateFormatting'\n\n/**\n * Props accepted by a date picker field surfaced through a form hook.\n * Exposes `minDate` and `maxDate` bounds (override server-provided constraints when\n * supplied), `portalContainer` for correct stacking inside modals, and\n * `validationMessages` for custom error text alongside the shared base field\n * attributes (`label`, `description`).\n *\n * @typeParam TErrorCode - Validation error code keys mapped via `validationMessages`.\n * @public\n */\nexport interface DatePickerHookFieldProps<TErrorCode extends string = never>\n  extends BaseFieldProps, Pick<DatePickerProps, 'portalContainer' | 'minDate' | 'maxDate'> {\n  /** The field name; must match the corresponding key in the form schema. */\n  name: string\n  /** Form hook result to connect to; falls back to the nearest `SDKFormProvider` when omitted. */\n  formHookResult?: FormHookResult\n  /** Custom error text keyed by validation error code. */\n  validationMessages?: ValidationMessages<TErrorCode>\n  /** Replaces the default date picker UI component; must accept the same props as `DatePickerProps`. */\n  FieldComponent?: ComponentType<DatePickerProps>\n  /** When used inside a modal, pass the modal backdrop ref's element so the calendar popover stacks correctly. */\n  portalContainer?: DatePickerProps['portalContainer']\n}\n\n/**\n * Date picker field connected to a partner form hook result via `useHookFieldResolution`.\n *\n * @typeParam TErrorCode - Validation error code keys mapped via `validationMessages`.\n * @param props - Field configuration including `name`, `formHookResult`, label content, and optional date bounds.\n * @returns The rendered date picker field wrapped in the field element registry.\n * @internal\n */\nexport function DatePickerHookField<TErrorCode extends string>({\n  name,\n  formHookResult,\n  label,\n  description,\n  validationMessages,\n  FieldComponent,\n  portalContainer,\n  minDate,\n  maxDate,\n}: DatePickerHookFieldProps<TErrorCode>) {\n  const { metadata, control, errorMessage, fieldElementRegistry } = useHookFieldResolution(\n    name,\n    formHookResult,\n    validationMessages,\n  )\n  const fieldMetadata = metadata[name]\n\n  return withFieldElementRegistry(\n    fieldElementRegistry,\n    <DatePickerField\n      name={name}\n      control={control}\n      label={label}\n      description={description}\n      errorMessage={errorMessage}\n      isRequired={fieldMetadata?.isRequired}\n      isDisabled={fieldMetadata?.isDisabled}\n      FieldComponent={FieldComponent}\n      portalContainer={portalContainer}\n      minDate={\n        minDate ??\n        (fieldMetadata?.minDate ? (normalizeToDate(fieldMetadata.minDate) ?? undefined) : undefined)\n      }\n      maxDate={\n        maxDate ??\n        (fieldMetadata?.maxDate ? (normalizeToDate(fieldMetadata.maxDate) ?? undefined) : undefined)\n      }\n    />,\n  )\n}\n"],"names":["DatePickerHookField","name","formHookResult","label","description","validationMessages","FieldComponent","portalContainer","minDate","maxDate","metadata","control","errorMessage","fieldElementRegistry","useHookFieldResolution","fieldMetadata","withFieldElementRegistry","jsx","DatePickerField","normalizeToDate"],"mappings":";;;;;AAwCO,SAASA,EAA+C;AAAA,EAC7D,MAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,oBAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,iBAAAC;AAAA,EACA,SAAAC;AAAA,EACA,SAAAC;AACF,GAAyC;AACvC,QAAM,EAAE,UAAAC,GAAU,SAAAC,GAAS,cAAAC,GAAc,sBAAAC,MAAyBC;AAAA,IAChEb;AAAA,IACAC;AAAA,IACAG;AAAA,EAAA,GAEIU,IAAgBL,EAAST,CAAI;AAEnC,SAAOe;AAAA,IACLH;AAAA,IACA,gBAAAI;AAAA,MAACC;AAAA,MAAA;AAAA,QACC,MAAAjB;AAAA,QACA,SAAAU;AAAA,QACA,OAAAR;AAAA,QACA,aAAAC;AAAA,QACA,cAAAQ;AAAA,QACA,YAAYG,GAAe;AAAA,QAC3B,YAAYA,GAAe;AAAA,QAC3B,gBAAAT;AAAA,QACA,iBAAAC;AAAA,QACA,SACEC,MACCO,GAAe,UAAWI,EAAgBJ,EAAc,OAAO,KAAK,SAAa;AAAA,QAEpF,SACEN,MACCM,GAAe,UAAWI,EAAgBJ,EAAc,OAAO,KAAK,SAAa;AAAA,MAAA;AAAA,IAAA;AAAA,EAEtF;AAEJ;"}
+{"version":3,"file":"DatePickerHookField.js","sources":["../../../../src/partner-hook-utils/form/fields/DatePickerHookField.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useHookFieldResolution } from '../useHookFieldResolution'\nimport type { BaseFieldProps, ValidationMessages, FormHookResult } from '../../types'\nimport { withFieldElementRegistry } from './withFieldElementRegistry'\nimport { DatePickerField } from '@/components/Common/Fields/DatePickerField'\nimport type { DatePickerProps } from '@/components/Common/UI/DatePicker/DatePickerTypes'\nimport { normalizeToDate } from '@/helpers/dateFormatting'\n\n/**\n * Props accepted by a date picker field surfaced through a form hook.\n * Exposes `minDate` and `maxDate` bounds (override server-provided constraints when\n * supplied), `portalContainer` for correct stacking inside modals, and\n * `validationMessages` for custom error text alongside the shared base field\n * attributes (`label`, `description`).\n *\n * @typeParam TErrorCode - Validation error code keys mapped via `validationMessages`.\n * @public\n * @group Hook field props\n */\nexport interface DatePickerHookFieldProps<TErrorCode extends string = never>\n  extends BaseFieldProps, Pick<DatePickerProps, 'portalContainer' | 'minDate' | 'maxDate'> {\n  /** The field name; must match the corresponding key in the form schema. */\n  name: string\n  /** Form hook result to connect to; falls back to the nearest `SDKFormProvider` when omitted. */\n  formHookResult?: FormHookResult\n  /** Custom error text keyed by validation error code. */\n  validationMessages?: ValidationMessages<TErrorCode>\n  /** Replaces the default date picker UI component; must accept the same props as `DatePickerProps`. */\n  FieldComponent?: ComponentType<DatePickerProps>\n  /** When used inside a modal, pass the modal backdrop ref's element so the calendar popover stacks correctly. */\n  portalContainer?: DatePickerProps['portalContainer']\n}\n\n/**\n * Date picker field connected to a partner form hook result via `useHookFieldResolution`.\n *\n * @typeParam TErrorCode - Validation error code keys mapped via `validationMessages`.\n * @param props - Field configuration including `name`, `formHookResult`, label content, and optional date bounds.\n * @returns The rendered date picker field wrapped in the field element registry.\n * @internal\n */\nexport function DatePickerHookField<TErrorCode extends string>({\n  name,\n  formHookResult,\n  label,\n  description,\n  validationMessages,\n  FieldComponent,\n  portalContainer,\n  minDate,\n  maxDate,\n}: DatePickerHookFieldProps<TErrorCode>) {\n  const { metadata, control, errorMessage, fieldElementRegistry } = useHookFieldResolution(\n    name,\n    formHookResult,\n    validationMessages,\n  )\n  const fieldMetadata = metadata[name]\n\n  return withFieldElementRegistry(\n    fieldElementRegistry,\n    <DatePickerField\n      name={name}\n      control={control}\n      label={label}\n      description={description}\n      errorMessage={errorMessage}\n      isRequired={fieldMetadata?.isRequired}\n      isDisabled={fieldMetadata?.isDisabled}\n      FieldComponent={FieldComponent}\n      portalContainer={portalContainer}\n      minDate={\n        minDate ??\n        (fieldMetadata?.minDate ? (normalizeToDate(fieldMetadata.minDate) ?? undefined) : undefined)\n      }\n      maxDate={\n        maxDate ??\n        (fieldMetadata?.maxDate ? (normalizeToDate(fieldMetadata.maxDate) ?? undefined) : undefined)\n      }\n    />,\n  )\n}\n"],"names":["DatePickerHookField","name","formHookResult","label","description","validationMessages","FieldComponent","portalContainer","minDate","maxDate","metadata","control","errorMessage","fieldElementRegistry","useHookFieldResolution","fieldMetadata","withFieldElementRegistry","jsx","DatePickerField","normalizeToDate"],"mappings":";;;;;AAyCO,SAASA,EAA+C;AAAA,EAC7D,MAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,oBAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,iBAAAC;AAAA,EACA,SAAAC;AAAA,EACA,SAAAC;AACF,GAAyC;AACvC,QAAM,EAAE,UAAAC,GAAU,SAAAC,GAAS,cAAAC,GAAc,sBAAAC,MAAyBC;AAAA,IAChEb;AAAA,IACAC;AAAA,IACAG;AAAA,EAAA,GAEIU,IAAgBL,EAAST,CAAI;AAEnC,SAAOe;AAAA,IACLH;AAAA,IACA,gBAAAI;AAAA,MAACC;AAAA,MAAA;AAAA,QACC,MAAAjB;AAAA,QACA,SAAAU;AAAA,QACA,OAAAR;AAAA,QACA,aAAAC;AAAA,QACA,cAAAQ;AAAA,QACA,YAAYG,GAAe;AAAA,QAC3B,YAAYA,GAAe;AAAA,QAC3B,gBAAAT;AAAA,QACA,iBAAAC;AAAA,QACA,SACEC,MACCO,GAAe,UAAWI,EAAgBJ,EAAc,OAAO,KAAK,SAAa;AAAA,QAEpF,SACEN,MACCM,GAAe,UAAWI,EAAgBJ,EAAc,OAAO,KAAK,SAAa;AAAA,MAAA;AAAA,IAAA;AAAA,EAEtF;AAEJ;"}