@gusto/embedded-react-sdk 0.42.0 → 0.44.0

package/dist/index.js

@@ -1,111 +1,136 @@
-import * as o from "./components/Company/index.js";
-import * as r from "./components/Contractor/index.js";
+import * as r from "./components/Company/index.js";
+import * as o from "./components/Contractor/index.js";
 import * as e from "./components/Employee/index.js";
 import * as m from "./components/InformationRequests/index.js";
 import * as t from "./components/Payroll/index.js";
-import * as p from "./components/UNSTABLE_TimeOff/index.js";
-import * as a from "./components/Employee/exports/employeeOnboarding.js";
+import * as a from "./components/TimeOff/index.js";
+import * as p from "./components/Employee/exports/employeeOnboarding.js";
 import * as s from "./components/Employee/exports/employeeManagement.js";
 import * as i from "./components/Company/exports/companyOnboarding.js";
-import * as d from "./components/Contractor/exports/contractorOnboarding.js";
+import * as x from "./components/Contractor/exports/contractorOnboarding.js";
 import { ApiProvider as f } from "./contexts/ApiProvider/ApiProvider.js";
 import { componentEvents as c } from "./shared/constants.js";
-import { SDKInternalError as u, normalizeToSDKError as F } from "./types/sdkError.js";
-import { composeErrorHandler as y } from "./partner-hook-utils/composeErrorHandler.js";
-import { collectErrors as P } from "./partner-hook-utils/collectErrors.js";
-import { useCompensationForm as A } from "./components/Employee/Compensation/shared/useCompensationForm/useCompensationForm.js";
-import { CompensationErrorCodes as h, createCompensationSchema as k } from "./components/Employee/Compensation/shared/useCompensationForm/compensationSchema.js";
-import { useEmployeeDetailsForm as v } from "./components/Employee/Profile/shared/useEmployeeDetailsForm/useEmployeeDetailsForm.js";
-import { EmployeeDetailsErrorCodes as O, createEmployeeDetailsSchema as R } from "./components/Employee/Profile/shared/useEmployeeDetailsForm/employeeDetailsSchema.js";
-import { useWorkAddressForm as M } from "./components/Employee/Profile/shared/useWorkAddressForm/useWorkAddressForm.js";
-import { useCurrentWorkAddressForm as $ } from "./components/Employee/Profile/shared/useWorkAddressForm/useCurrentWorkAddressForm.js";
-import { WorkAddressErrorCodes as N, createWorkAddressSchema as T } from "./components/Employee/Profile/shared/useWorkAddressForm/workAddressSchema.js";
-import { useHomeAddressForm as K } from "./components/Employee/Profile/shared/useHomeAddressForm/useHomeAddressForm.js";
-import { useCurrentHomeAddressForm as B } from "./components/Employee/Profile/shared/useHomeAddressForm/useCurrentHomeAddressForm.js";
-import { HomeAddressErrorCodes as U, createHomeAddressSchema as X } from "./components/Employee/Profile/shared/useHomeAddressForm/homeAddressSchema.js";
-import { useSignEmployeeForm as z } from "./components/Employee/DocumentSigner/shared/useSignEmployeeForm/useSignEmployeeForm.js";
-import { MAX_PREPARERS as j, PREPARER_FIELDS_BY_INDEX as J, SignEmployeeFormErrorCodes as Q, createSignEmployeeFormSchema as V, preparerFieldName as Z } from "./components/Employee/DocumentSigner/shared/useSignEmployeeForm/signEmployeeFormSchema.js";
-import { usePayScheduleForm as ro } from "./components/Company/PaySchedule/shared/usePayScheduleForm/usePayScheduleForm.js";
-import { PayScheduleErrorCodes as mo, createPayScheduleSchema as to } from "./components/Company/PaySchedule/shared/usePayScheduleForm/payScheduleSchema.js";
-import { useSignCompanyForm as ao } from "./components/Company/DocumentSigner/shared/useSignCompanyForm/useSignCompanyForm.js";
-import { SignCompanyFormErrorCodes as io, createSignCompanyFormSchema as no } from "./components/Company/DocumentSigner/shared/useSignCompanyForm/signCompanyFormSchema.js";
-import { CheckboxHookField as fo } from "./partner-hook-utils/form/fields/CheckboxHookField.js";
-import { DatePickerHookField as co } from "./partner-hook-utils/form/fields/DatePickerHookField.js";
-import { FormFieldsMetadataProvider as uo } from "./partner-hook-utils/form/FormFieldsMetadataProvider.js";
-import { GustoApiProvider as So, GustoProvider as yo } from "./contexts/GustoProvider/GustoProvider.js";
-import { GustoProviderCustomUIAdapter as Po } from "./contexts/GustoProvider/GustoProviderCustomUIAdapter.js";
-import { NumberInputHookField as Ao } from "./partner-hook-utils/form/fields/NumberInputHookField.js";
-import { ObservabilityProvider as ho } from "./contexts/ObservabilityProvider/ObservabilityProvider.js";
-import { RadioGroupHookField as Ho } from "./partner-hook-utils/form/fields/RadioGroupHookField.js";
-import { SDKFormProvider as Do } from "./partner-hook-utils/form/SDKFormProvider.js";
-import { SelectHookField as Ro } from "./partner-hook-utils/form/fields/SelectHookField.js";
-import { SwitchHookField as Mo } from "./partner-hook-utils/form/fields/SwitchHookField.js";
-import { TextInputHookField as $o } from "./partner-hook-utils/form/fields/TextInputHookField.js";
-import { composeSubmitHandler as No } from "./partner-hook-utils/form/composeSubmitHandler.js";
-import { useDeriveFieldsMetadata as Wo } from "./partner-hook-utils/form/useDeriveFieldsMetadata.js";
-import { useFieldErrorMessage as wo } from "./partner-hook-utils/form/useFieldErrorMessage.js";
-import { useObservability as Lo } from "./contexts/ObservabilityProvider/useObservability.js";
-import { withOptions as Xo } from "./partner-hook-utils/form/withOptions.js";
+import { SDKInternalError as u, normalizeToSDKError as E } from "./types/sdkError.js";
+import { composeErrorHandler as C } from "./partner-hook-utils/composeErrorHandler.js";
+import { collectErrors as b } from "./partner-hook-utils/collectErrors.js";
+import { useCompensationForm as h } from "./components/Employee/Compensation/shared/useCompensationForm/useCompensationForm.js";
+import { useCurrentCompensationForm as P } from "./components/Employee/Compensation/shared/useCompensationForm/useCurrentCompensationForm.js";
+import { CompensationErrorCodes as H, createCompensationSchema as v } from "./components/Employee/Compensation/shared/useCompensationForm/compensationSchema.js";
+import { useJobForm as D } from "./components/Employee/Compensation/shared/useJobForm/useJobForm.js";
+import { useCurrentJobForm as I } from "./components/Employee/Compensation/shared/useJobForm/useCurrentJobForm.js";
+import { JobErrorCodes as M, createJobSchema as _ } from "./components/Employee/Compensation/shared/useJobForm/jobSchema.js";
+import { useEmployeeDetailsForm as $ } from "./components/Employee/Profile/shared/useEmployeeDetailsForm/useEmployeeDetailsForm.js";
+import { EmployeeDetailsErrorCodes as N, createEmployeeDetailsSchema as W } from "./components/Employee/Profile/shared/useEmployeeDetailsForm/employeeDetailsSchema.js";
+import { useWorkAddressForm as L } from "./components/Employee/Profile/shared/useWorkAddressForm/useWorkAddressForm.js";
+import { useCurrentWorkAddressForm as w } from "./components/Employee/Profile/shared/useWorkAddressForm/useCurrentWorkAddressForm.js";
+import { WorkAddressErrorCodes as X, createWorkAddressSchema as q } from "./components/Employee/Profile/shared/useWorkAddressForm/workAddressSchema.js";
+import { useHomeAddressForm as B } from "./components/Employee/Profile/shared/useHomeAddressForm/useHomeAddressForm.js";
+import { useCurrentHomeAddressForm as Y } from "./components/Employee/Profile/shared/useHomeAddressForm/useCurrentHomeAddressForm.js";
+import { HomeAddressErrorCodes as Z, createHomeAddressSchema as rr } from "./components/Employee/Profile/shared/useHomeAddressForm/homeAddressSchema.js";
+import { useFederalTaxesForm as er } from "./components/Employee/FederalTaxes/shared/useFederalTaxesForm/useFederalTaxesForm.js";
+import { FILING_STATUS_VALUES as tr, FederalTaxesErrorCodes as ar, createFederalTaxesSchema as pr } from "./components/Employee/FederalTaxes/shared/useFederalTaxesForm/federalTaxesSchema.js";
+import { useSignEmployeeForm as ir } from "./components/Employee/DocumentSigner/shared/useSignEmployeeForm/useSignEmployeeForm.js";
+import { MAX_PREPARERS as dr, PREPARER_FIELDS_BY_INDEX as nr, SignEmployeeFormErrorCodes as fr, createSignEmployeeFormSchema as lr, preparerFieldName as cr } from "./components/Employee/DocumentSigner/shared/useSignEmployeeForm/signEmployeeFormSchema.js";
+import { usePayScheduleForm as ur } from "./components/Company/PaySchedule/shared/usePayScheduleForm/usePayScheduleForm.js";
+import { PayScheduleErrorCodes as Sr, createPayScheduleSchema as Cr } from "./components/Company/PaySchedule/shared/usePayScheduleForm/payScheduleSchema.js";
+import { useSignCompanyForm as br } from "./components/Company/DocumentSigner/shared/useSignCompanyForm/useSignCompanyForm.js";
+import { SignCompanyFormErrorCodes as hr, createSignCompanyFormSchema as Ar } from "./components/Company/DocumentSigner/shared/useSignCompanyForm/signCompanyFormSchema.js";
+import { CheckboxHookField as kr } from "./partner-hook-utils/form/fields/CheckboxHookField.js";
+import { DatePickerHookField as vr } from "./partner-hook-utils/form/fields/DatePickerHookField.js";
+import { EmployeeStateTaxesErrorCodes as Dr, createEmployeeStateTaxesSchema as Or } from "./components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/employeeStateTaxesSchema.js";
+import { FormFieldsMetadataProvider as Rr } from "./partner-hook-utils/form/FormFieldsMetadataProvider.js";
+import { GustoApiProvider as _r, GustoProvider as Gr } from "./contexts/GustoProvider/GustoProvider.js";
+import { GustoProviderCustomUIAdapter as Jr } from "./contexts/GustoProvider/GustoProviderCustomUIAdapter.js";
+import { NumberInputHookField as Wr } from "./partner-hook-utils/form/fields/NumberInputHookField.js";
+import { ObservabilityProvider as Lr } from "./contexts/ObservabilityProvider/ObservabilityProvider.js";
+import { RadioGroupHookField as wr } from "./partner-hook-utils/form/fields/RadioGroupHookField.js";
+import { SDKFormProvider as Xr } from "./partner-hook-utils/form/SDKFormProvider.js";
+import { SelectHookField as zr } from "./partner-hook-utils/form/fields/SelectHookField.js";
+import { SwitchHookField as Qr } from "./partner-hook-utils/form/fields/SwitchHookField.js";
+import { TextInputHookField as jr } from "./partner-hook-utils/form/fields/TextInputHookField.js";
+import { composeSubmitHandler as ro } from "./partner-hook-utils/form/composeSubmitHandler.js";
+import { createStateFields as eo, useStateFields as mo } from "./components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/fields.js";
+import { getQuestionVariant as ao } from "./components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/fieldMapping.js";
+import { useDeriveFieldsMetadata as so } from "./partner-hook-utils/form/useDeriveFieldsMetadata.js";
+import { useEmployeeStateTaxesForm as xo } from "./components/Employee/StateTaxes/shared/useEmployeeStateTaxesForm/useEmployeeStateTaxesForm.js";
+import { useFieldErrorMessage as fo } from "./partner-hook-utils/form/useFieldErrorMessage.js";
+import { useObservability as co } from "./contexts/ObservabilityProvider/useObservability.js";
+import { withOptions as uo } from "./partner-hook-utils/form/withOptions.js";
 export {
   f as ApiProvider,
-  fo as CheckboxHookField,
-  o as Company,
+  kr as CheckboxHookField,
+  r as Company,
   i as CompanyOnboarding,
-  h as CompensationErrorCodes,
-  r as Contractor,
-  d as ContractorOnboarding,
-  co as DatePickerHookField,
+  H as CompensationErrorCodes,
+  o as Contractor,
+  x as ContractorOnboarding,
+  vr as DatePickerHookField,
   e as Employee,
-  O as EmployeeDetailsErrorCodes,
+  N as EmployeeDetailsErrorCodes,
   s as EmployeeManagement,
-  a as EmployeeOnboarding,
-  uo as FormFieldsMetadataProvider,
-  So as GustoApiProvider,
-  yo as GustoProvider,
-  Po as GustoProviderCustomUIAdapter,
-  U as HomeAddressErrorCodes,
+  p as EmployeeOnboarding,
+  Dr as EmployeeStateTaxesErrorCodes,
+  tr as FILING_STATUS_VALUES,
+  ar as FederalTaxesErrorCodes,
+  Rr as FormFieldsMetadataProvider,
+  _r as GustoApiProvider,
+  Gr as GustoProvider,
+  Jr as GustoProviderCustomUIAdapter,
+  Z as HomeAddressErrorCodes,
   m as InformationRequests,
-  j as MAX_PREPARERS,
-  Ao as NumberInputHookField,
-  ho as ObservabilityProvider,
-  J as PREPARER_FIELDS_BY_INDEX,
-  mo as PayScheduleErrorCodes,
+  M as JobErrorCodes,
+  dr as MAX_PREPARERS,
+  Wr as NumberInputHookField,
+  Lr as ObservabilityProvider,
+  nr as PREPARER_FIELDS_BY_INDEX,
+  Sr as PayScheduleErrorCodes,
   t as Payroll,
-  Ho as RadioGroupHookField,
-  Do as SDKFormProvider,
+  wr as RadioGroupHookField,
+  Xr as SDKFormProvider,
   u as SDKInternalError,
-  Ro as SelectHookField,
-  io as SignCompanyFormErrorCodes,
-  Q as SignEmployeeFormErrorCodes,
-  Mo as SwitchHookField,
-  $o as TextInputHookField,
-  p as UNSTABLE_TimeOff,
-  N as WorkAddressErrorCodes,
-  P as collectErrors,
+  zr as SelectHookField,
+  hr as SignCompanyFormErrorCodes,
+  fr as SignEmployeeFormErrorCodes,
+  Qr as SwitchHookField,
+  jr as TextInputHookField,
+  a as TimeOff,
+  X as WorkAddressErrorCodes,
+  b as collectErrors,
   c as componentEvents,
-  y as composeErrorHandler,
-  No as composeSubmitHandler,
-  k as createCompensationSchema,
-  R as createEmployeeDetailsSchema,
-  X as createHomeAddressSchema,
-  to as createPayScheduleSchema,
-  no as createSignCompanyFormSchema,
-  V as createSignEmployeeFormSchema,
-  T as createWorkAddressSchema,
-  F as normalizeToSDKError,
-  Z as preparerFieldName,
-  A as useCompensationForm,
-  B as useCurrentHomeAddressForm,
-  $ as useCurrentWorkAddressForm,
-  Wo as useDeriveFieldsMetadata,
-  v as useEmployeeDetailsForm,
-  wo as useFieldErrorMessage,
-  K as useHomeAddressForm,
-  Lo as useObservability,
-  ro as usePayScheduleForm,
-  ao as useSignCompanyForm,
-  z as useSignEmployeeForm,
-  M as useWorkAddressForm,
-  Xo as withOptions
+  C as composeErrorHandler,
+  ro as composeSubmitHandler,
+  v as createCompensationSchema,
+  W as createEmployeeDetailsSchema,
+  Or as createEmployeeStateTaxesSchema,
+  pr as createFederalTaxesSchema,
+  rr as createHomeAddressSchema,
+  _ as createJobSchema,
+  Cr as createPayScheduleSchema,
+  Ar as createSignCompanyFormSchema,
+  lr as createSignEmployeeFormSchema,
+  eo as createStateFields,
+  q as createWorkAddressSchema,
+  ao as getQuestionVariant,
+  E as normalizeToSDKError,
+  cr as preparerFieldName,
+  h as useCompensationForm,
+  P as useCurrentCompensationForm,
+  Y as useCurrentHomeAddressForm,
+  I as useCurrentJobForm,
+  w as useCurrentWorkAddressForm,
+  so as useDeriveFieldsMetadata,
+  $ as useEmployeeDetailsForm,
+  xo as useEmployeeStateTaxesForm,
+  er as useFederalTaxesForm,
+  fo as useFieldErrorMessage,
+  B as useHomeAddressForm,
+  D as useJobForm,
+  co as useObservability,
+  ur as usePayScheduleForm,
+  br as useSignCompanyForm,
+  ir as useSignEmployeeForm,
+  mo as useStateFields,
+  L as useWorkAddressForm,
+  uo as withOptions
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

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

@@ -1,24 +1,28 @@
-import { jsx as a } from "react/jsx-runtime";
-import { useEffect as i } from "react";
+import { jsx as n } from "react/jsx-runtime";
+import { useEffect as a } from "react";
 import { FormProvider as d } from "react-hook-form";
-import { FormFieldsMetadataProvider as f } from "./FormFieldsMetadataProvider.js";
-function m(o, s) {
-  const { fieldsMetadata: e } = s, { setError: r } = s.hookFormInternals.formMethods;
-  i(() => {
+import { FormFieldsMetadataProvider as l } from "./FormFieldsMetadataProvider.js";
+import { FieldElementRegistryProvider as f } from "../../components/Common/Fields/hooks/FieldElementRegistryProvider.js";
+import { normalizeErrorKeyForForm as c } from "../../helpers/formattedStrings.js";
+function F(o, t) {
+  const { fieldsMetadata: e } = t, { setError: r } = t.hookFormInternals.formMethods;
+  a(() => {
     if (!o.length) return;
-    const n = new Set(Object.keys(e));
-    for (const t of o)
-      n.has(t.field) && r(t.field, {
+    const i = new Set(Object.keys(e));
+    for (const s of o) {
+      const m = c(s.field);
+      i.has(m) && r(m, {
         type: "custom",
-        message: t.message
+        message: s.message
       });
+    }
   }, [o, r, e]);
 }
-function p({ formHookResult: o, children: s }) {
-  const { errorHandling: e, form: r } = o, n = e.errors.flatMap((t) => t.fieldErrors);
-  return m(n, r), /* @__PURE__ */ a(f, { metadata: r.fieldsMetadata, errors: e.errors, children: /* @__PURE__ */ a(d, { ...r.hookFormInternals.formMethods, children: s }) });
+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 }) }) });
 }
 export {
-  p as SDKFormProvider
+  M as SDKFormProvider
 };
 //# sourceMappingURL=SDKFormProvider.js.map

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 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      if (knownFields.has(fieldError.field)) {\n        setError(fieldError.field 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\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      <FormProvider {...form.hookFormInternals.formMethods}>{children}</FormProvider>\n    </FormFieldsMetadataProvider>\n  )\n}\n"],"names":["useSyncFieldErrors","fieldErrors","form","fieldsMetadata","setError","useEffect","knownFields","fieldError","SDKFormProvider","formHookResult","children","errorHandling","allFieldErrors","e","jsx","FormFieldsMetadataProvider","FormProvider"],"mappings":";;;;AAOA,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;AACvB,MAAIK,EAAY,IAAIC,EAAW,KAAK,KAClCH,EAASG,EAAW,OAA+B;AAAA,QACjD,MAAM;AAAA,QACN,SAASA,EAAW;AAAA,MAAA,CACrB;AAAA,EAGP,GAAG,CAACN,GAAaG,GAAUD,CAAc,CAAC;AAC5C;AAkBO,SAASK,EAKd,EAAE,gBAAAC,GAAgB,UAAAC,KAA8D;AAChF,QAAM,EAAE,eAAAC,GAAe,MAAAT,EAAA,IAASO,GAC1BG,IAAiBD,EAAc,OAAO,QAAQ,CAAAE,MAAKA,EAAE,WAAW;AACtE,SAAAb,EAAmBY,GAAgBV,CAAI,GAGrC,gBAAAY,EAACC,GAAA,EAA2B,UAAUb,EAAK,gBAAgB,QAAQS,EAAc,QAC/E,UAAA,gBAAAG,EAACE,KAAc,GAAGd,EAAK,kBAAkB,aAAc,UAAAQ,GAAS,GAClE;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 { 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\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;AAkBO,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;"}

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

@@ -1,94 +1,94 @@
 import { z as h } from "zod";
-function I(t, r) {
+function D(e, r) {
   const {
     mode: i,
     requiredFieldsConfig: u = {},
     requiredErrorCode: c = "REQUIRED",
-    excludeFields: l = []
-  } = r, f = new Set(l.map(String)), a = new Set((r.fieldsWithRedactedValues ?? []).map(String)), R = new Set(
-    F(r.optionalFieldsToRequire, i)
-  ), m = {}, d = [], y = [], g = u;
-  for (const [n, s] of Object.entries(t)) {
+    excludeFields: p = []
+  } = r, f = new Set(p.map(String)), a = new Set((r.fieldsWithRedactedValues ?? []).map(String)), m = new Set(
+    x(r.optionalFieldsToRequire, i)
+  ), R = {}, d = [], y = [], g = u;
+  for (const [n, s] of Object.entries(e)) {
     if (f.has(n)) continue;
     y.push(n);
-    const e = g[n] ?? "always";
-    if (m[n] = x(s), !a.has(n)) {
-      const o = R.has(n);
-      typeof e == "function" ? d.push({
+    const t = g[n] ?? "always";
+    if (R[n] = b(s), !a.has(n)) {
+      const o = m.has(n);
+      typeof t == "function" ? d.push({
         name: n,
-        predicate: o ? () => !0 : e
-      }) : (e === "always" || e === i || o) && d.push({ name: n, predicate: () => !0 });
+        predicate: o ? () => !0 : t
+      }) : (t === "always" || t === i || o) && d.push({ name: n, predicate: () => !0 });
     }
   }
-  const q = d.length > 0 || r.superRefine;
-  let p = h.object(m);
-  q && (p = p.superRefine(
+  const w = d.length > 0 || r.superRefine;
+  let l = h.object(R);
+  w && (l = l.superRefine(
     (n, s) => {
-      for (const { name: e, predicate: o } of d)
-        o(n, i) && P(n[e]) && s.addIssue({
+      for (const { name: t, predicate: o } of d)
+        o(n, i) && q(n[t]) && s.addIssue({
           code: h.ZodIssueCode.custom,
-          path: [e],
+          path: [t],
           message: c
         });
       r.superRefine?.(n, s);
     }
   ));
-  const w = C(d, i);
-  function S(n) {
+  const S = P(d, i);
+  function F(n) {
     const s = {};
-    for (const e of y) {
-      const o = g[e] ?? "always";
-      R.has(e) ? s[e] = { name: e, isRequired: !0 } : typeof o == "function" ? s[e] = { name: e, isRequired: n ? o(n, i) : !1 } : s[e] = {
-        name: e,
+    for (const t of y) {
+      const o = g[t] ?? "always";
+      m.has(t) ? s[t] = { name: t, isRequired: !0 } : typeof o == "function" ? s[t] = { name: t, isRequired: n ? o(n, i) : !1 } : s[t] = {
+        name: t,
         isRequired: o === "always" || o === i
-      }, a.has(e) && (s[e].hasRedactedValue = !0);
+      }, a.has(t) && (s[t].hasRedactedValue = !0);
     }
     return s;
   }
   return [
-    p,
-    { getFieldsMetadata: S, predicateDeps: w }
+    l,
+    { getFieldsMetadata: F, predicateDeps: S }
   ];
 }
-function F(t, r) {
-  return t ? (r === "create" ? t.create : t.update) ?? [] : [];
+function x(e, r) {
+  return e ? (r === "create" ? e.create : e.update) ?? [] : [];
 }
-function x(t) {
-  return h.preprocess((r) => r === "" || r === null ? void 0 : r, t.optional());
+function b(e) {
+  return h.preprocess((r) => q(r) ? void 0 : r, e.optional());
 }
-function P(t) {
-  return t == null || typeof t == "string" && t.trim() === "";
+function q(e) {
+  return !!(e == null || typeof e == "string" && e.trim() === "" || typeof e == "number" && Number.isNaN(e));
 }
-function C(t, r) {
+function P(e, r) {
   const i = /* @__PURE__ */ new Set();
-  for (const { predicate: u } of t) {
-    if (E(u)) continue;
-    const c = [], l = new Proxy({}, {
+  for (const { predicate: u } of e) {
+    if (C(u)) continue;
+    const c = [], p = new Proxy({}, {
       get(f, a) {
         typeof a == "string" && c.push(a);
       }
     });
     try {
-      u(l, r);
+      u(p, r);
     } catch {
     }
     for (const f of c) i.add(f);
   }
   return [...i];
 }
-function E(t) {
+function C(e) {
   const r = [], i = new Proxy({}, {
     get(u, c) {
       typeof c == "string" && r.push(c);
     }
   });
   try {
-    t(i, "create");
+    e(i, "create");
   } catch {
   }
   return r.length === 0;
 }
 export {
-  I as buildFormSchema
+  D as buildFormSchema
 };
 //# sourceMappingURL=buildFormSchema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"buildFormSchema.js","sources":["../../../src/partner-hook-utils/form/buildFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport type { FieldMetadata } from '../types'\n\n// ── Types ────────────────────────────────────────────────────────────\n\nexport type FormMode = 'create' | 'update'\n\nexport type RequiredFieldRule<TData = Record<string, unknown>> =\n  | 'create'\n  | 'update'\n  | 'always'\n  | 'never'\n  | ((data: TData, mode: FormMode) => boolean)\n\nexport type RequiredFieldConfig<TSchema extends Record<string, z.ZodType>> = Partial<{\n  [K in keyof TSchema & string]: RequiredFieldRule<{\n    [F in keyof TSchema]: z.infer<TSchema[F]>\n  }>\n}>\n\ntype OptionalOnCreate<TConfig> = {\n  [K in keyof TConfig & string]: TConfig[K] extends 'update' | 'never' ? K : never\n}[keyof TConfig & string]\n\ntype OptionalOnUpdate<TConfig> = {\n  [K in keyof TConfig & string]: TConfig[K] extends 'create' | 'never' ? K : never\n}[keyof TConfig & string]\n\nexport type OptionalFieldsToRequire<TConfig> = {\n  create?: Array<OptionalOnCreate<TConfig>>\n  update?: Array<OptionalOnUpdate<TConfig>>\n}\n\n// ── buildFormSchema ──────────────────────────────────────────────────\n\ninterface BuildFormSchemaOptions<\n  T extends Record<string, z.ZodType>,\n  TConfig extends RequiredFieldConfig<T>,\n> {\n  requiredFieldsConfig?: TConfig\n  requiredErrorCode?: string\n  mode: FormMode\n  optionalFieldsToRequire?: OptionalFieldsToRequire<TConfig>\n  excludeFields?: Array<keyof T & string>\n  /** Fields with existing server-side values that are redacted in the API response\n   *  (e.g. SSN, EIN). These fields remain in the schema for format validation and\n   *  appear in metadata (with `hasRedactedValue: true`) but are exempt from required\n   *  validation — an empty submission is valid because a value already exists. */\n  fieldsWithRedactedValues?: Array<keyof T & string>\n  superRefine?: (data: { [K in keyof T]: z.infer<T[K]> }, ctx: z.RefinementCtx) => void\n}\n\nexport interface FieldsMetadataConfig<T extends Record<string, z.ZodType>> {\n  getFieldsMetadata: (data?: Record<string, unknown>) => Record<keyof T, FieldMetadata>\n  /** Form field names that predicate-based requiredness rules read at runtime. */\n  predicateDeps: string[]\n}\n\ntype FormDataFromValidators<T extends Record<string, z.ZodType>> = {\n  [K in keyof T]: z.infer<T[K]>\n}\n\nexport type BuildFormSchemaResult<T extends Record<string, z.ZodType>> = [\n  schema: z.ZodType<FormDataFromValidators<T>, FormDataFromValidators<T>>,\n  metadataConfig: FieldsMetadataConfig<T>,\n]\n\nexport function buildFormSchema<\n  T extends Record<string, z.ZodType>,\n  TConfig extends RequiredFieldConfig<T>,\n>(fieldValidators: T, options: BuildFormSchemaOptions<T, TConfig>): BuildFormSchemaResult<T> {\n  const {\n    mode,\n    requiredFieldsConfig = {} as Record<string, RequiredFieldRule>,\n    requiredErrorCode = 'REQUIRED',\n    excludeFields = [],\n  } = options\n  const excluded = new Set(excludeFields.map(String))\n  const redacted = new Set((options.fieldsWithRedactedValues ?? []).map(String))\n  const partnerRequired = new Set(\n    resolveOptionalFieldsToRequire(options.optionalFieldsToRequire, mode),\n  )\n\n  const shape: Record<string, z.ZodType> = {}\n  const dynamicRequired: Array<{\n    name: string\n    predicate: (data: Record<string, unknown>, mode: FormMode) => boolean\n  }> = []\n  const includedFieldNames: string[] = []\n  const config = requiredFieldsConfig as Record<string, RequiredFieldRule>\n\n  for (const [name, validator] of Object.entries(fieldValidators)) {\n    if (excluded.has(name)) continue\n    includedFieldNames.push(name)\n\n    const effectiveRule = config[name] ?? 'always'\n\n    shape[name] = makeOptional(validator)\n\n    if (!redacted.has(name)) {\n      const isPartnerRequired = partnerRequired.has(name)\n\n      if (typeof effectiveRule === 'function') {\n        dynamicRequired.push({\n          name,\n          predicate: isPartnerRequired ? () => true : effectiveRule,\n        })\n      } else {\n        const isRequired = effectiveRule === 'always' || effectiveRule === mode || isPartnerRequired\n        if (isRequired) {\n          dynamicRequired.push({ name, predicate: () => true })\n        }\n      }\n    }\n  }\n\n  const hasSuperRefine = dynamicRequired.length > 0 || options.superRefine\n  let schema: z.ZodType = z.object(shape)\n\n  if (hasSuperRefine) {\n    schema = (schema as z.ZodObject).superRefine(\n      (data: Record<string, unknown>, ctx: z.RefinementCtx) => {\n        for (const { name, predicate } of dynamicRequired) {\n          if (predicate(data, mode) && isEmpty(data[name])) {\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: [name],\n              message: requiredErrorCode,\n            })\n          }\n        }\n\n        options.superRefine?.(data as { [K in keyof T]: z.infer<T[K]> }, ctx)\n      },\n    )\n  }\n\n  const predicateDeps = detectPredicateDeps(dynamicRequired, mode)\n\n  function getFieldsMetadata(data?: Record<string, unknown>) {\n    const metadata: Record<string, FieldMetadata> = {}\n\n    for (const name of includedFieldNames) {\n      const effectiveRule = config[name] ?? 'always'\n\n      if (partnerRequired.has(name)) {\n        metadata[name] = { name, isRequired: true }\n      } else if (typeof effectiveRule === 'function') {\n        metadata[name] = { name, isRequired: data ? effectiveRule(data, mode) : false }\n      } else {\n        metadata[name] = {\n          name,\n          isRequired: effectiveRule === 'always' || effectiveRule === mode,\n        }\n      }\n\n      if (redacted.has(name)) {\n        metadata[name].hasRedactedValue = true\n      }\n    }\n\n    return metadata as Record<keyof T, FieldMetadata>\n  }\n\n  // makeOptional wraps fields with z.preprocess, which causes z.input to infer\n  // `unknown`. Cast the schema to carry the original field types so zodResolver\n  // infers correct form data types — consumers don't need per-hook casts.\n  return [\n    schema as z.ZodType<FormDataFromValidators<T>, FormDataFromValidators<T>>,\n    { getFieldsMetadata, predicateDeps },\n  ]\n}\n\n// ── Internal helpers ─────────────────────────────────────────────────\n\nfunction resolveOptionalFieldsToRequire<TConfig>(\n  value: OptionalFieldsToRequire<TConfig> | undefined,\n  mode: FormMode,\n): string[] {\n  if (!value) return []\n  return ((mode === 'create' ? value.create : value.update) ?? []) as string[]\n}\n\nfunction makeOptional(validator: z.ZodType): z.ZodType {\n  return z.preprocess(v => (v === '' || v === null ? undefined : v), validator.optional())\n}\n\nfunction isEmpty(value: unknown): boolean {\n  if (value === undefined || value === null) return true\n  if (typeof value === 'string' && value.trim() === '') return true\n  return false\n}\n\n/**\n * Determines which form field names are read by predicate-based requiredness\n * rules. This enables `useDeriveFieldsMetadata` to watch only the specific\n * fields that predicates depend on, rather than subscribing to every form\n * value change (which defeats react-hook-form's per-field render optimization).\n *\n * Works by running each predicate against a recording Proxy. The Proxy\n * intercepts property access and logs the keys, giving us the dependency list\n * without requiring manual declaration.\n *\n * Limitation: JavaScript short-circuit evaluation (`a && b`) can prevent the\n * Proxy from seeing later operands when earlier ones are falsy. In practice\n * this is acceptable — our predicate rules read a single form value each\n * (e.g. `data => data.adjustForMinimumWage`). Multi-field predicates with\n * equality guards should be expressed as `superRefine` rules instead.\n */\nfunction detectPredicateDeps(\n  dynamicRequired: Array<{\n    name: string\n    predicate: (data: Record<string, unknown>, mode: FormMode) => boolean\n  }>,\n  mode: FormMode,\n): string[] {\n  const deps = new Set<string>()\n\n  for (const { predicate } of dynamicRequired) {\n    if (isConstantPredicate(predicate)) continue\n\n    const accessed: string[] = []\n    const proxy = new Proxy({} as Record<string, unknown>, {\n      get(_target, prop) {\n        if (typeof prop === 'string') accessed.push(prop)\n        return undefined\n      },\n    })\n\n    try {\n      predicate(proxy, mode)\n    } catch {\n      /* Predicate may throw on undefined values — that's fine, we already captured the property accesses */\n    }\n\n    for (const key of accessed) deps.add(key)\n  }\n\n  return [...deps]\n}\n\n/**\n * Static predicates (e.g. `() => true` from 'always' / mode rules / partner\n * overrides) don't access form data, so we skip them during dependency\n * detection. We identify them by running against an empty proxy and checking\n * whether any properties were accessed.\n */\nfunction isConstantPredicate(\n  predicate: (data: Record<string, unknown>, mode: FormMode) => boolean,\n): boolean {\n  const accessed: string[] = []\n  const proxy = new Proxy({} as Record<string, unknown>, {\n    get(_target, prop) {\n      if (typeof prop === 'string') accessed.push(prop)\n      return undefined\n    },\n  })\n  try {\n    predicate(proxy, 'create')\n  } catch {\n    /* ignore */\n  }\n  return accessed.length === 0\n}\n"],"names":["buildFormSchema","fieldValidators","options","mode","requiredFieldsConfig","requiredErrorCode","excludeFields","excluded","redacted","partnerRequired","resolveOptionalFieldsToRequire","shape","dynamicRequired","includedFieldNames","config","name","validator","effectiveRule","makeOptional","isPartnerRequired","hasSuperRefine","schema","z","data","ctx","predicate","isEmpty","predicateDeps","detectPredicateDeps","getFieldsMetadata","metadata","value","v","deps","isConstantPredicate","accessed","proxy","_target","prop","key"],"mappings":"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"}
+{"version":3,"file":"buildFormSchema.js","sources":["../../../src/partner-hook-utils/form/buildFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport type { FieldMetadata } from '../types'\n\n// ── Types ────────────────────────────────────────────────────────────\n\nexport type FormMode = 'create' | 'update'\n\nexport type RequiredFieldRule<TData = Record<string, unknown>> =\n  | 'create'\n  | 'update'\n  | 'always'\n  | 'never'\n  | ((data: TData, mode: FormMode) => boolean)\n\nexport type RequiredFieldConfig<TSchema extends Record<string, z.ZodType>> = Partial<{\n  [K in keyof TSchema & string]: RequiredFieldRule<{\n    [F in keyof TSchema]: z.infer<TSchema[F]>\n  }>\n}>\n\ntype OptionalOnCreate<TConfig> = {\n  [K in keyof TConfig & string]: TConfig[K] extends 'update' | 'never' ? K : never\n}[keyof TConfig & string]\n\ntype OptionalOnUpdate<TConfig> = {\n  [K in keyof TConfig & string]: TConfig[K] extends 'create' | 'never' ? K : never\n}[keyof TConfig & string]\n\nexport type OptionalFieldsToRequire<TConfig> = {\n  create?: Array<OptionalOnCreate<TConfig>>\n  update?: Array<OptionalOnUpdate<TConfig>>\n}\n\n// ── buildFormSchema ──────────────────────────────────────────────────\n\ninterface BuildFormSchemaOptions<\n  T extends Record<string, z.ZodType>,\n  TConfig extends RequiredFieldConfig<T>,\n> {\n  requiredFieldsConfig?: TConfig\n  requiredErrorCode?: string\n  mode: FormMode\n  optionalFieldsToRequire?: OptionalFieldsToRequire<TConfig>\n  excludeFields?: Array<keyof T & string>\n  /** Fields with existing server-side values that are redacted in the API response\n   *  (e.g. SSN, EIN). These fields remain in the schema for format validation and\n   *  appear in metadata (with `hasRedactedValue: true`) but are exempt from required\n   *  validation — an empty submission is valid because a value already exists. */\n  fieldsWithRedactedValues?: Array<keyof T & string>\n  superRefine?: (data: { [K in keyof T]: z.infer<T[K]> }, ctx: z.RefinementCtx) => void\n}\n\nexport interface FieldsMetadataConfig<T extends Record<string, z.ZodType>> {\n  getFieldsMetadata: (data?: Record<string, unknown>) => Record<keyof T, FieldMetadata>\n  /** Form field names that predicate-based requiredness rules read at runtime. */\n  predicateDeps: string[]\n}\n\ntype FormDataFromValidators<T extends Record<string, z.ZodType>> = {\n  [K in keyof T]: z.infer<T[K]>\n}\n\nexport type BuildFormSchemaResult<T extends Record<string, z.ZodType>> = [\n  schema: z.ZodType<FormDataFromValidators<T>, FormDataFromValidators<T>>,\n  metadataConfig: FieldsMetadataConfig<T>,\n]\n\nexport function buildFormSchema<\n  T extends Record<string, z.ZodType>,\n  TConfig extends RequiredFieldConfig<T>,\n>(fieldValidators: T, options: BuildFormSchemaOptions<T, TConfig>): BuildFormSchemaResult<T> {\n  const {\n    mode,\n    requiredFieldsConfig = {} as Record<string, RequiredFieldRule>,\n    requiredErrorCode = 'REQUIRED',\n    excludeFields = [],\n  } = options\n  const excluded = new Set(excludeFields.map(String))\n  const redacted = new Set((options.fieldsWithRedactedValues ?? []).map(String))\n  const partnerRequired = new Set(\n    resolveOptionalFieldsToRequire(options.optionalFieldsToRequire, mode),\n  )\n\n  const shape: Record<string, z.ZodType> = {}\n  const dynamicRequired: Array<{\n    name: string\n    predicate: (data: Record<string, unknown>, mode: FormMode) => boolean\n  }> = []\n  const includedFieldNames: string[] = []\n  const config = requiredFieldsConfig as Record<string, RequiredFieldRule>\n\n  for (const [name, validator] of Object.entries(fieldValidators)) {\n    if (excluded.has(name)) continue\n    includedFieldNames.push(name)\n\n    const effectiveRule = config[name] ?? 'always'\n\n    shape[name] = makeOptional(validator)\n\n    if (!redacted.has(name)) {\n      const isPartnerRequired = partnerRequired.has(name)\n\n      if (typeof effectiveRule === 'function') {\n        dynamicRequired.push({\n          name,\n          predicate: isPartnerRequired ? () => true : effectiveRule,\n        })\n      } else {\n        const isRequired = effectiveRule === 'always' || effectiveRule === mode || isPartnerRequired\n        if (isRequired) {\n          dynamicRequired.push({ name, predicate: () => true })\n        }\n      }\n    }\n  }\n\n  const hasSuperRefine = dynamicRequired.length > 0 || options.superRefine\n  let schema: z.ZodType = z.object(shape)\n\n  if (hasSuperRefine) {\n    schema = (schema as z.ZodObject).superRefine(\n      (data: Record<string, unknown>, ctx: z.RefinementCtx) => {\n        for (const { name, predicate } of dynamicRequired) {\n          if (predicate(data, mode) && isEmpty(data[name])) {\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: [name],\n              message: requiredErrorCode,\n            })\n          }\n        }\n\n        options.superRefine?.(data as { [K in keyof T]: z.infer<T[K]> }, ctx)\n      },\n    )\n  }\n\n  const predicateDeps = detectPredicateDeps(dynamicRequired, mode)\n\n  function getFieldsMetadata(data?: Record<string, unknown>) {\n    const metadata: Record<string, FieldMetadata> = {}\n\n    for (const name of includedFieldNames) {\n      const effectiveRule = config[name] ?? 'always'\n\n      if (partnerRequired.has(name)) {\n        metadata[name] = { name, isRequired: true }\n      } else if (typeof effectiveRule === 'function') {\n        metadata[name] = { name, isRequired: data ? effectiveRule(data, mode) : false }\n      } else {\n        metadata[name] = {\n          name,\n          isRequired: effectiveRule === 'always' || effectiveRule === mode,\n        }\n      }\n\n      if (redacted.has(name)) {\n        metadata[name].hasRedactedValue = true\n      }\n    }\n\n    return metadata as Record<keyof T, FieldMetadata>\n  }\n\n  // makeOptional wraps fields with z.preprocess, which causes z.input to infer\n  // `unknown`. Cast the schema to carry the original field types so zodResolver\n  // infers correct form data types — consumers don't need per-hook casts.\n  return [\n    schema as z.ZodType<FormDataFromValidators<T>, FormDataFromValidators<T>>,\n    { getFieldsMetadata, predicateDeps },\n  ]\n}\n\n// ── Internal helpers ─────────────────────────────────────────────────\n\nfunction resolveOptionalFieldsToRequire<TConfig>(\n  value: OptionalFieldsToRequire<TConfig> | undefined,\n  mode: FormMode,\n): string[] {\n  if (!value) return []\n  return ((mode === 'create' ? value.create : value.update) ?? []) as string[]\n}\n\nfunction makeOptional(validator: z.ZodType): z.ZodType {\n  return z.preprocess(v => (isEmpty(v) ? undefined : v), validator.optional())\n}\n\nfunction isEmpty(value: unknown): boolean {\n  if (value === undefined || value === null) return true\n  if (typeof value === 'string' && value.trim() === '') return true\n  if (typeof value === 'number' && Number.isNaN(value)) return true\n  return false\n}\n\n/**\n * Determines which form field names are read by predicate-based requiredness\n * rules. This enables `useDeriveFieldsMetadata` to watch only the specific\n * fields that predicates depend on, rather than subscribing to every form\n * value change (which defeats react-hook-form's per-field render optimization).\n *\n * Works by running each predicate against a recording Proxy. The Proxy\n * intercepts property access and logs the keys, giving us the dependency list\n * without requiring manual declaration.\n *\n * Limitation: JavaScript short-circuit evaluation (`a && b`) can prevent the\n * Proxy from seeing later operands when earlier ones are falsy. In practice\n * this is acceptable — our predicate rules read a single form value each\n * (e.g. `data => data.adjustForMinimumWage`). Multi-field predicates with\n * equality guards should be expressed as `superRefine` rules instead.\n */\nfunction detectPredicateDeps(\n  dynamicRequired: Array<{\n    name: string\n    predicate: (data: Record<string, unknown>, mode: FormMode) => boolean\n  }>,\n  mode: FormMode,\n): string[] {\n  const deps = new Set<string>()\n\n  for (const { predicate } of dynamicRequired) {\n    if (isConstantPredicate(predicate)) continue\n\n    const accessed: string[] = []\n    const proxy = new Proxy({} as Record<string, unknown>, {\n      get(_target, prop) {\n        if (typeof prop === 'string') accessed.push(prop)\n        return undefined\n      },\n    })\n\n    try {\n      predicate(proxy, mode)\n    } catch {\n      /* Predicate may throw on undefined values — that's fine, we already captured the property accesses */\n    }\n\n    for (const key of accessed) deps.add(key)\n  }\n\n  return [...deps]\n}\n\n/**\n * Static predicates (e.g. `() => true` from 'always' / mode rules / partner\n * overrides) don't access form data, so we skip them during dependency\n * detection. We identify them by running against an empty proxy and checking\n * whether any properties were accessed.\n */\nfunction isConstantPredicate(\n  predicate: (data: Record<string, unknown>, mode: FormMode) => boolean,\n): boolean {\n  const accessed: string[] = []\n  const proxy = new Proxy({} as Record<string, unknown>, {\n    get(_target, prop) {\n      if (typeof prop === 'string') accessed.push(prop)\n      return undefined\n    },\n  })\n  try {\n    predicate(proxy, 'create')\n  } catch {\n    /* ignore */\n  }\n  return accessed.length === 0\n}\n"],"names":["buildFormSchema","fieldValidators","options","mode","requiredFieldsConfig","requiredErrorCode","excludeFields","excluded","redacted","partnerRequired","resolveOptionalFieldsToRequire","shape","dynamicRequired","includedFieldNames","config","name","validator","effectiveRule","makeOptional","isPartnerRequired","hasSuperRefine","schema","z","data","ctx","predicate","isEmpty","predicateDeps","detectPredicateDeps","getFieldsMetadata","metadata","value","v","deps","isConstantPredicate","accessed","proxy","_target","prop","key"],"mappings":";AAmEO,SAASA,EAGdC,GAAoBC,GAAuE;AAC3F,QAAM;AAAA,IACJ,MAAAC;AAAA,IACA,sBAAAC,IAAuB,CAAA;AAAA,IACvB,mBAAAC,IAAoB;AAAA,IACpB,eAAAC,IAAgB,CAAA;AAAA,EAAC,IACfJ,GACEK,IAAW,IAAI,IAAID,EAAc,IAAI,MAAM,CAAC,GAC5CE,IAAW,IAAI,KAAKN,EAAQ,4BAA4B,CAAA,GAAI,IAAI,MAAM,CAAC,GACvEO,IAAkB,IAAI;AAAA,IAC1BC,EAA+BR,EAAQ,yBAAyBC,CAAI;AAAA,EAAA,GAGhEQ,IAAmC,CAAA,GACnCC,IAGD,CAAA,GACCC,IAA+B,CAAA,GAC/BC,IAASV;AAEf,aAAW,CAACW,GAAMC,CAAS,KAAK,OAAO,QAAQf,CAAe,GAAG;AAC/D,QAAIM,EAAS,IAAIQ,CAAI,EAAG;AACxB,IAAAF,EAAmB,KAAKE,CAAI;AAE5B,UAAME,IAAgBH,EAAOC,CAAI,KAAK;AAItC,QAFAJ,EAAMI,CAAI,IAAIG,EAAaF,CAAS,GAEhC,CAACR,EAAS,IAAIO,CAAI,GAAG;AACvB,YAAMI,IAAoBV,EAAgB,IAAIM,CAAI;AAElD,MAAI,OAAOE,KAAkB,aAC3BL,EAAgB,KAAK;AAAA,QACnB,MAAAG;AAAA,QACA,WAAWI,IAAoB,MAAM,KAAOF;AAAA,MAAA,CAC7C,KAEkBA,MAAkB,YAAYA,MAAkBd,KAAQgB,MAEzEP,EAAgB,KAAK,EAAE,MAAAG,GAAM,WAAW,MAAM,IAAM;AAAA,IAG1D;AAAA,EACF;AAEA,QAAMK,IAAiBR,EAAgB,SAAS,KAAKV,EAAQ;AAC7D,MAAImB,IAAoBC,EAAE,OAAOX,CAAK;AAEtC,EAAIS,MACFC,IAAUA,EAAuB;AAAA,IAC/B,CAACE,GAA+BC,MAAyB;AACvD,iBAAW,EAAE,MAAAT,GAAM,WAAAU,EAAA,KAAeb;AAChC,QAAIa,EAAUF,GAAMpB,CAAI,KAAKuB,EAAQH,EAAKR,CAAI,CAAC,KAC7CS,EAAI,SAAS;AAAA,UACX,MAAMF,EAAE,aAAa;AAAA,UACrB,MAAM,CAACP,CAAI;AAAA,UACX,SAASV;AAAA,QAAA,CACV;AAIL,MAAAH,EAAQ,cAAcqB,GAA2CC,CAAG;AAAA,IACtE;AAAA,EAAA;AAIJ,QAAMG,IAAgBC,EAAoBhB,GAAiBT,CAAI;AAE/D,WAAS0B,EAAkBN,GAAgC;AACzD,UAAMO,IAA0C,CAAA;AAEhD,eAAWf,KAAQF,GAAoB;AACrC,YAAMI,IAAgBH,EAAOC,CAAI,KAAK;AAEtC,MAAIN,EAAgB,IAAIM,CAAI,IAC1Be,EAASf,CAAI,IAAI,EAAE,MAAAA,GAAM,YAAY,GAAA,IAC5B,OAAOE,KAAkB,aAClCa,EAASf,CAAI,IAAI,EAAE,MAAAA,GAAM,YAAYQ,IAAON,EAAcM,GAAMpB,CAAI,IAAI,GAAA,IAExE2B,EAASf,CAAI,IAAI;AAAA,QACf,MAAAA;AAAA,QACA,YAAYE,MAAkB,YAAYA,MAAkBd;AAAA,MAAA,GAI5DK,EAAS,IAAIO,CAAI,MACnBe,EAASf,CAAI,EAAE,mBAAmB;AAAA,IAEtC;AAEA,WAAOe;AAAA,EACT;AAKA,SAAO;AAAA,IACLT;AAAA,IACA,EAAE,mBAAAQ,GAAmB,eAAAF,EAAA;AAAA,EAAc;AAEvC;AAIA,SAASjB,EACPqB,GACA5B,GACU;AACV,SAAK4B,KACI5B,MAAS,WAAW4B,EAAM,SAASA,EAAM,WAAW,CAAA,IAD1C,CAAA;AAErB;AAEA,SAASb,EAAaF,GAAiC;AACrD,SAAOM,EAAE,WAAW,CAAAU,MAAMN,EAAQM,CAAC,IAAI,SAAYA,GAAIhB,EAAU,SAAA,CAAU;AAC7E;AAEA,SAASU,EAAQK,GAAyB;AAGxC,SAFI,GAAuBA,KAAU,QACjC,OAAOA,KAAU,YAAYA,EAAM,KAAA,MAAW,MAC9C,OAAOA,KAAU,YAAY,OAAO,MAAMA,CAAK;AAErD;AAkBA,SAASH,EACPhB,GAIAT,GACU;AACV,QAAM8B,wBAAW,IAAA;AAEjB,aAAW,EAAE,WAAAR,EAAA,KAAeb,GAAiB;AAC3C,QAAIsB,EAAoBT,CAAS,EAAG;AAEpC,UAAMU,IAAqB,CAAA,GACrBC,IAAQ,IAAI,MAAM,IAA+B;AAAA,MACrD,IAAIC,GAASC,GAAM;AACjB,QAAI,OAAOA,KAAS,YAAUH,EAAS,KAAKG,CAAI;AAAA,MAElD;AAAA,IAAA,CACD;AAED,QAAI;AACF,MAAAb,EAAUW,GAAOjC,CAAI;AAAA,IACvB,QAAQ;AAAA,IAER;AAEA,eAAWoC,KAAOJ,EAAU,CAAAF,EAAK,IAAIM,CAAG;AAAA,EAC1C;AAEA,SAAO,CAAC,GAAGN,CAAI;AACjB;AAQA,SAASC,EACPT,GACS;AACT,QAAMU,IAAqB,CAAA,GACrBC,IAAQ,IAAI,MAAM,IAA+B;AAAA,IACrD,IAAIC,GAASC,GAAM;AACjB,MAAI,OAAOA,KAAS,YAAUH,EAAS,KAAKG,CAAI;AAAA,IAElD;AAAA,EAAA,CACD;AACD,MAAI;AACF,IAAAb,EAAUW,GAAO,QAAQ;AAAA,EAC3B,QAAQ;AAAA,EAER;AACA,SAAOD,EAAS,WAAW;AAC7B;"}

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

@@ -1,18 +1,21 @@
 import { SyntheticEvent } from 'react';
 import { FieldValues, UseFormReturn } from 'react-hook-form';
-import { HookErrorHandling } from '../types';
+import { HookErrorHandling, HookFormInternals } from '../types';
 /**
  * Minimal shape required for a form hook result to participate in `composeSubmitHandler`.
  * Any hook returning `BaseFormHookReady` satisfies this interface.
  *
- * Uses method syntax so TypeScript applies bivariant checking on parameter types,
+ * `formMethods` is declared with method-call syntax (rather than reused from
+ * `HookFormInternals`) so TypeScript applies bivariant parameter checking,
  * 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.
  */
 interface ComposableFormHookResult {
     form: {
-        hookFormInternals: {
+        hookFormInternals: Pick<HookFormInternals, '_fieldElementRegistry'> & {
             formMethods: {
-                handleSubmit(onValid: () => void, onInvalid?: () => void): () => Promise<void>;
+                handleSubmit(onValid: () => void, onInvalid?: (errors: Record<string, unknown>) => void): () => Promise<void>;
                 setFocus(name: string): void;
                 formState: {
                     errors: Record<string, unknown>;
@@ -39,8 +42,9 @@ export interface ComposeSubmitHandlerResult {
  * Coordinates validation and submission across multiple form hooks on the same page, and
  * returns aggregated `errorHandling` for those forms so you can drive a single error surface.
  *
- * Validates all forms simultaneously via `handleSubmit()`, then focuses the first invalid
- * field across all forms (in array order). Only calls `onAllValid` when every form passes.
+ * Validates all forms simultaneously via `handleSubmit()`, then focuses the visually first
+ * invalid field across all forms (sorted by `getBoundingClientRect()`). Only calls
+ * `onAllValid` when every form passes.
  *
  * Uses `handleSubmit` rather than `trigger` so that react-hook-form sets
  * `formState.isSubmitted = true`, which enables `reValidateMode` (default: `onChange`).