@gusto/embedded-react-sdk 0.47.1 → 0.48.0

package/dist/components/Employee/Profile/onboarding/EmployeeProfile.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmployeeProfile.js","sources":["../../../../../src/components/Employee/Profile/onboarding/EmployeeProfile.tsx"],"sourcesContent":["import { useState } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport classNames from 'classnames'\nimport { useEmployeeAddressesGetWorkAddresses } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesGetWorkAddresses'\nimport { useEmployeeDetailsForm } from '../shared/useEmployeeDetailsForm'\nimport type { EmployeeDetailsOptionalFieldsToRequire } from '../shared/useEmployeeDetailsForm'\nimport { useCurrentHomeAddressForm } from '../shared/useHomeAddressForm'\nimport styles from './EmployeeProfile.module.scss'\nimport type { ProfileProps } from './Profile'\nimport { SDKFormProvider } from '@/partner-hook-utils/form/SDKFormProvider'\nimport { composeSubmitHandler } from '@/partner-hook-utils/form/composeSubmitHandler'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport { Grid } from '@/components/Common/Grid/Grid'\nimport { ActionsLayout } from '@/components/Common'\nimport { Form } from '@/components/Common/Form'\nimport { BaseLayout } from '@/components/Base'\nimport { useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport { getStreet, getCityStateZip } from '@/helpers/formattedStrings'\n\nconst SELF_OPTIONAL_FIELDS: EmployeeDetailsOptionalFieldsToRequire = {\n  create: ['dateOfBirth', 'ssn'],\n  update: ['firstName', 'lastName', 'dateOfBirth', 'ssn'],\n}\n\nexport function EmployeeProfile({\n  companyId,\n  employeeId,\n  defaultValues,\n  className = '',\n  dictionary,\n  onEvent,\n}: ProfileProps) {\n  useI18n('Employee.Profile')\n  useI18n('Employee.HomeAddress')\n  useComponentDictionary('Employee.Profile', dictionary)\n  const { t } = useTranslation('Employee.Profile')\n  const { t: tHome } = useTranslation('Employee.HomeAddress')\n  const { t: tCommon } = useTranslation('common')\n  const Components = useComponentContext()\n\n  const [resolvedEmployeeId, setResolvedEmployeeId] = useState(employeeId)\n\n  const employeeDetails = useEmployeeDetailsForm({\n    companyId,\n    employeeId: resolvedEmployeeId,\n    withSelfOnboardingField: false,\n    optionalFieldsToRequire: SELF_OPTIONAL_FIELDS,\n    defaultValues: defaultValues?.employee,\n    shouldFocusError: false,\n  })\n\n  const homeAddress = useCurrentHomeAddressForm({\n    employeeId: resolvedEmployeeId ?? '',\n    withEffectiveDateField: false,\n    defaultValues: {\n      street1: defaultValues?.homeAddress?.street1,\n      street2: defaultValues?.homeAddress?.street2,\n      city: defaultValues?.homeAddress?.city,\n      state: defaultValues?.homeAddress?.state,\n      zip: defaultValues?.homeAddress?.zip,\n    },\n    shouldFocusError: false,\n  })\n\n  const workAddressesQuery = useEmployeeAddressesGetWorkAddresses(\n    { employeeId: resolvedEmployeeId ?? '' },\n    { enabled: !!resolvedEmployeeId },\n  )\n  const workAddresses = workAddressesQuery.data?.employeeWorkAddressesList\n  const activeWorkAddress = workAddresses?.find(address => address.active)\n\n  if (employeeDetails.isLoading || homeAddress.isLoading || workAddressesQuery.isLoading) {\n    const loadingErrorHandling = composeErrorHandler([\n      employeeDetails,\n      homeAddress,\n      workAddressesQuery,\n    ])\n    return <BaseLayout isLoading error={loadingErrorHandling.errors} />\n  }\n\n  const EmpFields = employeeDetails.form.Fields\n  const HomeFields = homeAddress.form.Fields\n\n  const submitResult = composeSubmitHandler([employeeDetails, homeAddress], async () => {\n    const employeeResult = await employeeDetails.actions.onSubmit({\n      onEmployeeCreated: emp => {\n        onEvent(componentEvents.EMPLOYEE_CREATED, emp)\n      },\n      onEmployeeUpdated: emp => {\n        onEvent(componentEvents.EMPLOYEE_UPDATED, emp)\n      },\n    })\n    if (!employeeResult) return\n\n    const newEmployeeId = employeeResult.data.uuid\n\n    const homeResult = await homeAddress.actions.onSubmit({\n      employeeId: newEmployeeId,\n    })\n    if (!homeResult) {\n      if (!employeeId) setResolvedEmployeeId(newEmployeeId)\n      return\n    }\n    if (homeResult.mode === 'create') {\n      onEvent(componentEvents.EMPLOYEE_HOME_ADDRESS_CREATED, homeResult.data)\n    } else {\n      onEvent(componentEvents.EMPLOYEE_HOME_ADDRESS_UPDATED, homeResult.data)\n    }\n\n    onEvent(componentEvents.EMPLOYEE_PROFILE_DONE, employeeResult.data)\n  })\n\n  const errorHandling = composeErrorHandler([\n    submitResult,\n    { errorHandling: homeAddress.errorHandling },\n    workAddressesQuery,\n  ])\n\n  const isPending = employeeDetails.status.isPending || homeAddress.status.isPending\n\n  return (\n    <section className={classNames(styles.container, className)}>\n      <BaseLayout error={errorHandling.errors}>\n        <Form onSubmit={submitResult.handleSubmit}>\n          <Grid gridTemplateColumns=\"1fr\" gap={24}>\n            <div>\n              <Components.Heading as=\"h2\">{t('title')}</Components.Heading>\n              <Components.Text>{t('description')}</Components.Text>\n            </div>\n\n            <SDKFormProvider formHookResult={employeeDetails}>\n              <Grid\n                gap={{ base: 20, small: 8 }}\n                gridTemplateColumns={{ base: '1fr', small: ['1fr', 200] }}\n              >\n                <EmpFields.FirstName\n                  label={t('firstName')}\n                  validationMessages={{\n                    REQUIRED: t('validations.firstName'),\n                    INVALID_NAME: t('validations.firstName'),\n                  }}\n                />\n                <EmpFields.MiddleInitial label={t('middleInitial')} />\n              </Grid>\n              <EmpFields.LastName\n                label={t('lastName')}\n                validationMessages={{\n                  REQUIRED: t('validations.lastName'),\n                  INVALID_NAME: t('validations.lastName'),\n                }}\n              />\n              <EmpFields.Ssn\n                label={t('ssnLabel')}\n                validationMessages={{\n                  INVALID_SSN: t('validations.ssn', { ns: 'common' }),\n                  REQUIRED: t('validations.ssnRequired', { ns: 'common' }),\n                }}\n              />\n              <EmpFields.DateOfBirth\n                label={t('dobLabel')}\n                validationMessages={{ REQUIRED: t('validations.dob', { ns: 'common' }) }}\n              />\n            </SDKFormProvider>\n\n            <SDKFormProvider formHookResult={homeAddress}>\n              <div>\n                <Components.Heading as=\"h2\">{tHome('formTitle')}</Components.Heading>\n                <Components.Text>{tHome('desc')}</Components.Text>\n              </div>\n              <Grid\n                gridTemplateColumns={{\n                  base: '1fr',\n                  small: ['1fr', '1fr'],\n                }}\n                gap={20}\n              >\n                <HomeFields.Street1\n                  label={tHome('street1')}\n                  validationMessages={{ REQUIRED: tHome('validations.street1') }}\n                />\n                <HomeFields.Street2 label={tHome('street2')} />\n                <HomeFields.City\n                  label={tHome('city')}\n                  validationMessages={{ REQUIRED: tHome('validations.city') }}\n                />\n                <HomeFields.State\n                  label={tHome('state')}\n                  placeholder={tHome('statePlaceholder')}\n                  validationMessages={{ REQUIRED: tHome('validations.state') }}\n                  getOptionLabel={(abbr: string) =>\n                    tCommon(`statesHash.${abbr}`, { defaultValue: abbr })\n                  }\n                />\n                <HomeFields.Zip\n                  label={tHome('zip')}\n                  validationMessages={{\n                    REQUIRED: tHome('validations.zip'),\n                    INVALID_ZIP: tHome('validations.zip'),\n                  }}\n                />\n              </Grid>\n            </SDKFormProvider>\n\n            {activeWorkAddress && (\n              <section>\n                <Components.Heading as=\"h2\">{t('workAddressSectionTitle')}</Components.Heading>\n                <Components.Text>{t('workAddressSectionDescription')}</Components.Text>\n                <address className={styles.address}>\n                  <Components.Text>{getStreet(activeWorkAddress)}</Components.Text>\n                  <Components.Text>{getCityStateZip(activeWorkAddress)}</Components.Text>\n                </address>\n              </section>\n            )}\n          </Grid>\n          <ActionsLayout>\n            <Components.Button type=\"submit\" isLoading={isPending}>\n              {t('submitCta')}\n            </Components.Button>\n          </ActionsLayout>\n        </Form>\n      </BaseLayout>\n    </section>\n  )\n}\n"],"names":["SELF_OPTIONAL_FIELDS","EmployeeProfile","companyId","employeeId","defaultValues","className","dictionary","onEvent","useI18n","useComponentDictionary","t","useTranslation","tHome","tCommon","Components","useComponentContext","resolvedEmployeeId","setResolvedEmployeeId","useState","employeeDetails","useEmployeeDetailsForm","homeAddress","useCurrentHomeAddressForm","workAddressesQuery","useEmployeeAddressesGetWorkAddresses","activeWorkAddress","address","loadingErrorHandling","composeErrorHandler","BaseLayout","EmpFields","HomeFields","submitResult","composeSubmitHandler","employeeResult","emp","componentEvents","newEmployeeId","homeResult","errorHandling","isPending","classNames","styles","jsx","Form","jsxs","Grid","SDKFormProvider","abbr","getStreet","getCityStateZip","ActionsLayout"],"mappings":"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"}
+{"version":3,"file":"EmployeeProfile.js","sources":["../../../../../src/components/Employee/Profile/onboarding/EmployeeProfile.tsx"],"sourcesContent":["import { useState } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport classNames from 'classnames'\nimport { useEmployeeAddressesGetWorkAddresses } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesGetWorkAddresses'\nimport { useEmployeeDetailsForm } from '../shared/useEmployeeDetailsForm'\nimport type { EmployeeDetailsOptionalFieldsToRequire } from '../shared/useEmployeeDetailsForm'\nimport { useCurrentHomeAddressForm } from '../shared/useHomeAddressForm'\nimport styles from './EmployeeProfile.module.scss'\nimport type { ProfileProps } from './Profile'\nimport { SDKFormProvider } from '@/partner-hook-utils/form/SDKFormProvider'\nimport { composeSubmitHandler } from '@/partner-hook-utils/form/composeSubmitHandler'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport { Grid } from '@/components/Common/Grid/Grid'\nimport { ActionsLayout } from '@/components/Common'\nimport { Form } from '@/components/Common/Form'\nimport { BaseLayout } from '@/components/Base'\nimport { useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport { getStreet, getCityStateZip } from '@/helpers/formattedStrings'\n\nconst SELF_OPTIONAL_FIELDS: EmployeeDetailsOptionalFieldsToRequire = {\n  create: ['dateOfBirth', 'ssn'],\n  update: ['firstName', 'lastName', 'dateOfBirth', 'ssn'],\n}\n\n/** @internal */\nexport function EmployeeProfile({\n  companyId,\n  employeeId,\n  defaultValues,\n  className = '',\n  dictionary,\n  onEvent,\n}: ProfileProps) {\n  useI18n('Employee.Profile')\n  useI18n('Employee.HomeAddress')\n  useComponentDictionary('Employee.Profile', dictionary)\n  const { t } = useTranslation('Employee.Profile')\n  const { t: tHome } = useTranslation('Employee.HomeAddress')\n  const { t: tCommon } = useTranslation('common')\n  const Components = useComponentContext()\n\n  const [resolvedEmployeeId, setResolvedEmployeeId] = useState(employeeId)\n\n  const employeeDetails = useEmployeeDetailsForm({\n    companyId,\n    employeeId: resolvedEmployeeId,\n    withSelfOnboardingField: false,\n    optionalFieldsToRequire: SELF_OPTIONAL_FIELDS,\n    defaultValues: defaultValues?.employee,\n    shouldFocusError: false,\n  })\n\n  const homeAddress = useCurrentHomeAddressForm({\n    employeeId: resolvedEmployeeId ?? '',\n    withEffectiveDateField: false,\n    defaultValues: {\n      street1: defaultValues?.homeAddress?.street1,\n      street2: defaultValues?.homeAddress?.street2,\n      city: defaultValues?.homeAddress?.city,\n      state: defaultValues?.homeAddress?.state,\n      zip: defaultValues?.homeAddress?.zip,\n    },\n    shouldFocusError: false,\n  })\n\n  const workAddressesQuery = useEmployeeAddressesGetWorkAddresses(\n    { employeeId: resolvedEmployeeId ?? '' },\n    { enabled: !!resolvedEmployeeId },\n  )\n  const workAddresses = workAddressesQuery.data?.employeeWorkAddressesList\n  const activeWorkAddress = workAddresses?.find(address => address.active)\n\n  if (employeeDetails.isLoading || homeAddress.isLoading || workAddressesQuery.isLoading) {\n    const loadingErrorHandling = composeErrorHandler([\n      employeeDetails,\n      homeAddress,\n      workAddressesQuery,\n    ])\n    return <BaseLayout isLoading error={loadingErrorHandling.errors} />\n  }\n\n  const EmpFields = employeeDetails.form.Fields\n  const HomeFields = homeAddress.form.Fields\n\n  const submitResult = composeSubmitHandler([employeeDetails, homeAddress], async () => {\n    const employeeResult = await employeeDetails.actions.onSubmit({\n      onEmployeeCreated: emp => {\n        onEvent(componentEvents.EMPLOYEE_CREATED, emp)\n      },\n      onEmployeeUpdated: emp => {\n        onEvent(componentEvents.EMPLOYEE_UPDATED, emp)\n      },\n    })\n    if (!employeeResult) return\n\n    const newEmployeeId = employeeResult.data.uuid\n\n    const homeResult = await homeAddress.actions.onSubmit({\n      employeeId: newEmployeeId,\n    })\n    if (!homeResult) {\n      if (!employeeId) setResolvedEmployeeId(newEmployeeId)\n      return\n    }\n    if (homeResult.mode === 'create') {\n      onEvent(componentEvents.EMPLOYEE_HOME_ADDRESS_CREATED, homeResult.data)\n    } else {\n      onEvent(componentEvents.EMPLOYEE_HOME_ADDRESS_UPDATED, homeResult.data)\n    }\n\n    onEvent(componentEvents.EMPLOYEE_PROFILE_DONE, employeeResult.data)\n  })\n\n  const errorHandling = composeErrorHandler([\n    submitResult,\n    { errorHandling: homeAddress.errorHandling },\n    workAddressesQuery,\n  ])\n\n  const isPending = employeeDetails.status.isPending || homeAddress.status.isPending\n\n  return (\n    <section className={classNames(styles.container, className)}>\n      <BaseLayout error={errorHandling.errors}>\n        <Form onSubmit={submitResult.handleSubmit}>\n          <Grid gridTemplateColumns=\"1fr\" gap={24}>\n            <div>\n              <Components.Heading as=\"h2\">{t('title')}</Components.Heading>\n              <Components.Text>{t('description')}</Components.Text>\n            </div>\n\n            <SDKFormProvider formHookResult={employeeDetails}>\n              <Grid\n                gap={{ base: 20, small: 8 }}\n                gridTemplateColumns={{ base: '1fr', small: ['1fr', 200] }}\n              >\n                <EmpFields.FirstName\n                  label={t('firstName')}\n                  validationMessages={{\n                    REQUIRED: t('validations.firstName'),\n                    INVALID_NAME: t('validations.firstName'),\n                  }}\n                />\n                <EmpFields.MiddleInitial label={t('middleInitial')} />\n              </Grid>\n              <EmpFields.LastName\n                label={t('lastName')}\n                validationMessages={{\n                  REQUIRED: t('validations.lastName'),\n                  INVALID_NAME: t('validations.lastName'),\n                }}\n              />\n              <EmpFields.Ssn\n                label={t('ssnLabel')}\n                validationMessages={{\n                  INVALID_SSN: t('validations.ssn', { ns: 'common' }),\n                  REQUIRED: t('validations.ssnRequired', { ns: 'common' }),\n                }}\n              />\n              <EmpFields.DateOfBirth\n                label={t('dobLabel')}\n                validationMessages={{ REQUIRED: t('validations.dob', { ns: 'common' }) }}\n              />\n            </SDKFormProvider>\n\n            <SDKFormProvider formHookResult={homeAddress}>\n              <div>\n                <Components.Heading as=\"h2\">{tHome('formTitle')}</Components.Heading>\n                <Components.Text>{tHome('desc')}</Components.Text>\n              </div>\n              <Grid\n                gridTemplateColumns={{\n                  base: '1fr',\n                  small: ['1fr', '1fr'],\n                }}\n                gap={20}\n              >\n                <HomeFields.Street1\n                  label={tHome('street1')}\n                  validationMessages={{ REQUIRED: tHome('validations.street1') }}\n                />\n                <HomeFields.Street2 label={tHome('street2')} />\n                <HomeFields.City\n                  label={tHome('city')}\n                  validationMessages={{ REQUIRED: tHome('validations.city') }}\n                />\n                <HomeFields.State\n                  label={tHome('state')}\n                  placeholder={tHome('statePlaceholder')}\n                  validationMessages={{ REQUIRED: tHome('validations.state') }}\n                  getOptionLabel={(abbr: string) =>\n                    tCommon(`statesHash.${abbr}`, { defaultValue: abbr })\n                  }\n                />\n                <HomeFields.Zip\n                  label={tHome('zip')}\n                  validationMessages={{\n                    REQUIRED: tHome('validations.zip'),\n                    INVALID_ZIP: tHome('validations.zip'),\n                  }}\n                />\n              </Grid>\n            </SDKFormProvider>\n\n            {activeWorkAddress && (\n              <section>\n                <Components.Heading as=\"h2\">{t('workAddressSectionTitle')}</Components.Heading>\n                <Components.Text>{t('workAddressSectionDescription')}</Components.Text>\n                <address className={styles.address}>\n                  <Components.Text>{getStreet(activeWorkAddress)}</Components.Text>\n                  <Components.Text>{getCityStateZip(activeWorkAddress)}</Components.Text>\n                </address>\n              </section>\n            )}\n          </Grid>\n          <ActionsLayout>\n            <Components.Button type=\"submit\" isLoading={isPending}>\n              {t('submitCta')}\n            </Components.Button>\n          </ActionsLayout>\n        </Form>\n      </BaseLayout>\n    </section>\n  )\n}\n"],"names":["SELF_OPTIONAL_FIELDS","EmployeeProfile","companyId","employeeId","defaultValues","className","dictionary","onEvent","useI18n","useComponentDictionary","t","useTranslation","tHome","tCommon","Components","useComponentContext","resolvedEmployeeId","setResolvedEmployeeId","useState","employeeDetails","useEmployeeDetailsForm","homeAddress","useCurrentHomeAddressForm","workAddressesQuery","useEmployeeAddressesGetWorkAddresses","activeWorkAddress","address","loadingErrorHandling","composeErrorHandler","BaseLayout","EmpFields","HomeFields","submitResult","composeSubmitHandler","employeeResult","emp","componentEvents","newEmployeeId","homeResult","errorHandling","isPending","classNames","styles","jsx","Form","jsxs","Grid","SDKFormProvider","abbr","getStreet","getCityStateZip","ActionsLayout"],"mappings":"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"}

package/dist/components/Employee/Profile/onboarding/Profile.d.ts

@@ -1,29 +1,90 @@
 import { BaseComponentInterface, CommonComponentInterface } from '../../../Base';
 import { RequireAtLeastOne } from '../../../../types/Helpers';
+/**
+ * Pre-fill values for the {@link Profile} onboarding step.
+ *
+ * @remarks
+ * At least one of the listed fields must be provided. When employee data is
+ * already available via the API, those values take precedence over the
+ * defaults.
+ *
+ * @public
+ */
 export type ProfileDefaultValues = RequireAtLeastOne<{
+    /** Pre-fill values for the employee details section. At least one nested field must be set. */
     employee?: RequireAtLeastOne<{
+        /** The employee's first name. */
         firstName?: string;
+        /** The employee's middle initial. */
         middleInitial?: string;
+        /** The employee's last name. */
         lastName?: string;
+        /** The employee's personal email address. */
         email?: string;
+        /** The employee's date of birth as an ISO date string (`YYYY-MM-DD`). */
         dateOfBirth?: string;
     }>;
+    /** Pre-fill values for the home address section. At least one nested field must be set. */
     homeAddress?: RequireAtLeastOne<{
+        /** First line of the street address. */
         street1?: string;
+        /** Second line of the street address (optional). */
         street2?: string;
+        /** City. */
         city?: string;
+        /** Two-letter state abbreviation. */
         state?: string;
+        /** ZIP code. */
         zip?: string;
     }>;
+    /** When `true`, the admin form opens with the self-onboarding toggle enabled by default in create mode. */
     inviteEmployeeDefault?: boolean;
 }>;
+/**
+ * Props for {@link Profile}.
+ *
+ * @public
+ */
 export interface ProfileProps extends CommonComponentInterface<'Employee.Profile'> {
+    /** The associated employee identifier. Omit to create a new employee. */
     employeeId?: string;
+    /** The associated company identifier. */
     companyId: string;
+    /** Pre-fill values for the form fields. */
     defaultValues?: ProfileDefaultValues;
+    /** When `true`, renders the admin variant (collects work address, start date, and self-onboarding toggle). Defaults to `false`. */
     isAdmin?: boolean;
+    /** When `true`, the admin variant exposes the self-onboarding toggle. Defaults to `true`. */
     isSelfOnboardingEnabled?: boolean;
+    /** Event handler fired on profile creation, update, and address changes. */
     onEvent: BaseComponentInterface['onEvent'];
 }
+/**
+ * Onboarding step for collecting an employee's basic profile and addresses.
+ *
+ * @remarks
+ * Switches between an admin-facing variant (collects employee details,
+ * work address, start date, and an optional self-onboarding invitation
+ * toggle) and an employee-facing variant (collects employee details and
+ * home address only — the active work address is read-only) based on
+ * `isAdmin`. Both variants create the employee on submit when `employeeId`
+ * is omitted.
+ *
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `employee/created` | Fired after an employee is successfully created | {@link Employee} |
+ * | `employee/updated` | Fired after an employee is successfully updated | {@link Employee} |
+ * | `employee/onboardingStatus/updated` | Fired when toggling self-onboarding changes the employee's onboarding status (admin variant) | The updated onboarding status |
+ * | `employee/homeAddress/created` | Fired after the home address is created | {@link EmployeeAddress} |
+ * | `employee/homeAddress/updated` | Fired after the home address is updated | {@link EmployeeAddress} |
+ * | `employee/workAddress/created` | Fired after the work address is created (admin variant) | {@link EmployeeWorkAddress} |
+ * | `employee/workAddress/updated` | Fired after the work address is updated (admin variant) | {@link EmployeeWorkAddress} |
+ * | `employee/profile/done` | Fired when all profile saves complete and the parent flow can advance | {@link Employee} extended with `startDate` (admin variant) |
+ *
+ * @param input - See {@link ProfileProps}.
+ * @returns The employee profile onboarding step.
+ * @public
+ */
 export declare function Profile({ FallbackComponent, isAdmin, ...props }: ProfileProps & BaseComponentInterface): import("react").JSX.Element;
+/** @internal */
 export declare const ProfileContextual: () => import("react").JSX.Element;

package/dist/components/Employee/Profile/onboarding/Profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"Profile.js","sources":["../../../../../src/components/Employee/Profile/onboarding/Profile.tsx"],"sourcesContent":["import type { OnboardingContextInterface } from '../../OnboardingFlow/OnboardingFlowComponents'\nimport { AdminProfile } from './AdminProfile'\nimport { EmployeeProfile } from './EmployeeProfile'\nimport {\n  BaseBoundaries,\n  type BaseComponentInterface,\n  type CommonComponentInterface,\n} from '@/components/Base'\nimport type { RequireAtLeastOne } from '@/types/Helpers'\nimport { useFlow } from '@/components/Flow/useFlow'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\nexport type ProfileDefaultValues = RequireAtLeastOne<{\n  employee?: RequireAtLeastOne<{\n    firstName?: string\n    middleInitial?: string\n    lastName?: string\n    email?: string\n    dateOfBirth?: string\n  }>\n  homeAddress?: RequireAtLeastOne<{\n    street1?: string\n    street2?: string\n    city?: string\n    state?: string\n    zip?: string\n  }>\n  inviteEmployeeDefault?: boolean\n}>\n\nexport interface ProfileProps extends CommonComponentInterface<'Employee.Profile'> {\n  employeeId?: string\n  companyId: string\n  defaultValues?: ProfileDefaultValues\n  isAdmin?: boolean\n  isSelfOnboardingEnabled?: boolean\n  onEvent: BaseComponentInterface['onEvent']\n}\n\nexport function Profile({\n  FallbackComponent,\n  isAdmin = false,\n  ...props\n}: ProfileProps & BaseComponentInterface) {\n  return (\n    <BaseBoundaries componentName=\"Employee.Profile\" FallbackComponent={FallbackComponent}>\n      {isAdmin ? <AdminProfile {...props} isAdmin /> : <EmployeeProfile {...props} />}\n    </BaseBoundaries>\n  )\n}\n\nexport const ProfileContextual = () => {\n  const { companyId, employeeId, onEvent, isAdmin, defaultValues, isSelfOnboardingEnabled } =\n    useFlow<OnboardingContextInterface>()\n\n  return (\n    <Profile\n      companyId={ensureRequired(companyId)}\n      employeeId={employeeId}\n      onEvent={onEvent}\n      isAdmin={isAdmin}\n      defaultValues={defaultValues?.profile}\n      isSelfOnboardingEnabled={isSelfOnboardingEnabled}\n    />\n  )\n}\n"],"names":["Profile","FallbackComponent","isAdmin","props","BaseBoundaries","jsx","AdminProfile","EmployeeProfile","ProfileContextual","companyId","employeeId","onEvent","defaultValues","isSelfOnboardingEnabled","useFlow","ensureRequired"],"mappings":";;;;;;;AAuCO,SAASA,EAAQ;AAAA,EACtB,mBAAAC;AAAA,EACA,SAAAC,IAAU;AAAA,EACV,GAAGC;AACL,GAA0C;AACxC,2BACGC,GAAA,EAAe,eAAc,oBAAmB,mBAAAH,GAC9C,cAAU,gBAAAI,EAACC,GAAA,EAAc,GAAGH,GAAO,SAAO,GAAA,CAAC,sBAAMI,GAAA,EAAiB,GAAGJ,GAAO,GAC/E;AAEJ;AAEO,MAAMK,IAAoB,MAAM;AACrC,QAAM,EAAE,WAAAC,GAAW,YAAAC,GAAY,SAAAC,GAAS,SAAAT,GAAS,eAAAU,GAAe,yBAAAC,EAAA,IAC9DC,EAAA;AAEF,SACE,gBAAAT;AAAA,IAACL;AAAA,IAAA;AAAA,MACC,WAAWe,EAAeN,CAAS;AAAA,MACnC,YAAAC;AAAA,MACA,SAAAC;AAAA,MACA,SAAAT;AAAA,MACA,eAAeU,GAAe;AAAA,MAC9B,yBAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;"}
+{"version":3,"file":"Profile.js","sources":["../../../../../src/components/Employee/Profile/onboarding/Profile.tsx"],"sourcesContent":["import type { OnboardingContextInterface } from '../../OnboardingFlow/OnboardingFlowComponents'\nimport { AdminProfile } from './AdminProfile'\nimport { EmployeeProfile } from './EmployeeProfile'\nimport {\n  BaseBoundaries,\n  type BaseComponentInterface,\n  type CommonComponentInterface,\n} from '@/components/Base'\nimport type { RequireAtLeastOne } from '@/types/Helpers'\nimport { useFlow } from '@/components/Flow/useFlow'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/**\n * Pre-fill values for the {@link Profile} onboarding step.\n *\n * @remarks\n * At least one of the listed fields must be provided. When employee data is\n * already available via the API, those values take precedence over the\n * defaults.\n *\n * @public\n */\nexport type ProfileDefaultValues = RequireAtLeastOne<{\n  /** Pre-fill values for the employee details section. At least one nested field must be set. */\n  employee?: RequireAtLeastOne<{\n    /** The employee's first name. */\n    firstName?: string\n    /** The employee's middle initial. */\n    middleInitial?: string\n    /** The employee's last name. */\n    lastName?: string\n    /** The employee's personal email address. */\n    email?: string\n    /** The employee's date of birth as an ISO date string (`YYYY-MM-DD`). */\n    dateOfBirth?: string\n  }>\n  /** Pre-fill values for the home address section. At least one nested field must be set. */\n  homeAddress?: RequireAtLeastOne<{\n    /** First line of the street address. */\n    street1?: string\n    /** Second line of the street address (optional). */\n    street2?: string\n    /** City. */\n    city?: string\n    /** Two-letter state abbreviation. */\n    state?: string\n    /** ZIP code. */\n    zip?: string\n  }>\n  /** When `true`, the admin form opens with the self-onboarding toggle enabled by default in create mode. */\n  inviteEmployeeDefault?: boolean\n}>\n\n/**\n * Props for {@link Profile}.\n *\n * @public\n */\nexport interface ProfileProps extends CommonComponentInterface<'Employee.Profile'> {\n  /** The associated employee identifier. Omit to create a new employee. */\n  employeeId?: string\n  /** The associated company identifier. */\n  companyId: string\n  /** Pre-fill values for the form fields. */\n  defaultValues?: ProfileDefaultValues\n  /** When `true`, renders the admin variant (collects work address, start date, and self-onboarding toggle). Defaults to `false`. */\n  isAdmin?: boolean\n  /** When `true`, the admin variant exposes the self-onboarding toggle. Defaults to `true`. */\n  isSelfOnboardingEnabled?: boolean\n  /** Event handler fired on profile creation, update, and address changes. */\n  onEvent: BaseComponentInterface['onEvent']\n}\n\n/**\n * Onboarding step for collecting an employee's basic profile and addresses.\n *\n * @remarks\n * Switches between an admin-facing variant (collects employee details,\n * work address, start date, and an optional self-onboarding invitation\n * toggle) and an employee-facing variant (collects employee details and\n * home address only — the active work address is read-only) based on\n * `isAdmin`. Both variants create the employee on submit when `employeeId`\n * is omitted.\n *\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/created` | Fired after an employee is successfully created | {@link Employee} |\n * | `employee/updated` | Fired after an employee is successfully updated | {@link Employee} |\n * | `employee/onboardingStatus/updated` | Fired when toggling self-onboarding changes the employee's onboarding status (admin variant) | The updated onboarding status |\n * | `employee/homeAddress/created` | Fired after the home address is created | {@link EmployeeAddress} |\n * | `employee/homeAddress/updated` | Fired after the home address is updated | {@link EmployeeAddress} |\n * | `employee/workAddress/created` | Fired after the work address is created (admin variant) | {@link EmployeeWorkAddress} |\n * | `employee/workAddress/updated` | Fired after the work address is updated (admin variant) | {@link EmployeeWorkAddress} |\n * | `employee/profile/done` | Fired when all profile saves complete and the parent flow can advance | {@link Employee} extended with `startDate` (admin variant) |\n *\n * @param input - See {@link ProfileProps}.\n * @returns The employee profile onboarding step.\n * @public\n */\nexport function Profile({\n  FallbackComponent,\n  isAdmin = false,\n  ...props\n}: ProfileProps & BaseComponentInterface) {\n  return (\n    <BaseBoundaries componentName=\"Employee.Profile\" FallbackComponent={FallbackComponent}>\n      {isAdmin ? <AdminProfile {...props} isAdmin /> : <EmployeeProfile {...props} />}\n    </BaseBoundaries>\n  )\n}\n\n/** @internal */\nexport const ProfileContextual = () => {\n  const { companyId, employeeId, onEvent, isAdmin, defaultValues, isSelfOnboardingEnabled } =\n    useFlow<OnboardingContextInterface>()\n\n  return (\n    <Profile\n      companyId={ensureRequired(companyId)}\n      employeeId={employeeId}\n      onEvent={onEvent}\n      isAdmin={isAdmin}\n      defaultValues={defaultValues?.profile}\n      isSelfOnboardingEnabled={isSelfOnboardingEnabled}\n    />\n  )\n}\n"],"names":["Profile","FallbackComponent","isAdmin","props","BaseBoundaries","jsx","AdminProfile","EmployeeProfile","ProfileContextual","companyId","employeeId","onEvent","defaultValues","isSelfOnboardingEnabled","useFlow","ensureRequired"],"mappings":";;;;;;;AAmGO,SAASA,EAAQ;AAAA,EACtB,mBAAAC;AAAA,EACA,SAAAC,IAAU;AAAA,EACV,GAAGC;AACL,GAA0C;AACxC,2BACGC,GAAA,EAAe,eAAc,oBAAmB,mBAAAH,GAC9C,cAAU,gBAAAI,EAACC,GAAA,EAAc,GAAGH,GAAO,SAAO,GAAA,CAAC,sBAAMI,GAAA,EAAiB,GAAGJ,GAAO,GAC/E;AAEJ;AAGO,MAAMK,IAAoB,MAAM;AACrC,QAAM,EAAE,WAAAC,GAAW,YAAAC,GAAY,SAAAC,GAAS,SAAAT,GAAS,eAAAU,GAAe,yBAAAC,EAAA,IAC9DC,EAAA;AAEF,SACE,gBAAAT;AAAA,IAACL;AAAA,IAAA;AAAA,MACC,WAAWe,EAAeN,CAAS;AAAA,MACnC,YAAAC;AAAA,MACA,SAAAC;AAAA,MACA,SAAAT;AAAA,MACA,eAAeU,GAAe;AAAA,MAC9B,yBAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Employee/Profile/shared/useEmployeeDetailsForm/employeeDetailsSchema.d.ts

@@ -1,5 +1,12 @@
 import { z } from 'zod';
 import { OptionalFieldsToRequire } from '../../../../../partner-hook-utils/form/buildFormSchema';
+/**
+ * Validation error codes emitted by the employee details form schema. Map
+ * these codes to localized copy in `validationMessages` when composing the
+ * hook.
+ *
+ * @public
+ */
 export declare const EmployeeDetailsErrorCodes: {
     readonly REQUIRED: "REQUIRED";
     readonly INVALID_NAME: "INVALID_NAME";
@@ -7,6 +14,12 @@ export declare const EmployeeDetailsErrorCodes: {
     readonly INVALID_SSN: "INVALID_SSN";
     readonly EMAIL_REQUIRED_FOR_SELF_ONBOARDING: "EMAIL_REQUIRED_FOR_SELF_ONBOARDING";
 };
+/**
+ * Union of validation error code strings emitted by the employee details form
+ * schema.
+ *
+ * @public
+ */
 export type EmployeeDetailsErrorCode = (typeof EmployeeDetailsErrorCodes)[keyof typeof EmployeeDetailsErrorCodes];
 declare const fieldValidators: {
     firstName: z.ZodString;
@@ -17,10 +30,26 @@ declare const fieldValidators: {
     ssn: z.ZodString;
     selfOnboarding: z.ZodBoolean;
 };
+/**
+ * Field names accepted by the employee details form.
+ *
+ * @public
+ */
 export type EmployeeDetailsField = Exclude<keyof typeof fieldValidators, 'selfOnboarding'>;
+/**
+ * Shape of the values managed by the employee details form.
+ *
+ * @public
+ */
 export type EmployeeDetailsFormData = {
     [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>;
 };
+/**
+ * Shape of the validated values produced by the employee details form on
+ * submit.
+ *
+ * @public
+ */
 export type EmployeeDetailsFormOutputs = EmployeeDetailsFormData;
 declare const requiredFieldsConfig: {
     firstName: "create";
@@ -30,12 +59,20 @@ declare const requiredFieldsConfig: {
     dateOfBirth: "never";
     ssn: "never";
 };
+/**
+ * Keys of optional employee details fields that can be promoted to required
+ * via the hook's `optionalFieldsToRequire` option.
+ *
+ * @public
+ */
 export type EmployeeDetailsOptionalFieldsToRequire = OptionalFieldsToRequire<typeof requiredFieldsConfig>;
+/** @internal */
 interface EmployeeDetailsSchemaOptions {
     mode?: 'create' | 'update';
     optionalFieldsToRequire?: EmployeeDetailsOptionalFieldsToRequire;
     hasSsn?: boolean;
 }
+/** @internal */
 export declare function createEmployeeDetailsSchema(options?: EmployeeDetailsSchemaOptions): import('../../../../../partner-hook-utils/form/buildFormSchema').BuildFormSchemaResult<{
     firstName: z.ZodString;
     middleInitial: z.ZodString;

package/dist/components/Employee/Profile/shared/useEmployeeDetailsForm/employeeDetailsSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"employeeDetailsSchema.js","sources":["../../../../../../src/components/Employee/Profile/shared/useEmployeeDetailsForm/employeeDetailsSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type RequiredFieldConfig,\n  type OptionalFieldsToRequire,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { SSN_REGEX, NAME_REGEX } from '@/helpers/validations'\n\n// ── Error codes ────────────────────────────────────────────────────────\n\nexport const EmployeeDetailsErrorCodes = {\n  REQUIRED: 'REQUIRED',\n  INVALID_NAME: 'INVALID_NAME',\n  INVALID_EMAIL: 'INVALID_EMAIL',\n  INVALID_SSN: 'INVALID_SSN',\n  EMAIL_REQUIRED_FOR_SELF_ONBOARDING: 'EMAIL_REQUIRED_FOR_SELF_ONBOARDING',\n} as const\n\nexport type EmployeeDetailsErrorCode =\n  (typeof EmployeeDetailsErrorCodes)[keyof typeof EmployeeDetailsErrorCodes]\n\n// ── Field validators ───────────────────────────────────────────────────\n\nconst fieldValidators = {\n  firstName: z\n    .string()\n    .min(1, { message: EmployeeDetailsErrorCodes.REQUIRED })\n    .regex(NAME_REGEX, { message: EmployeeDetailsErrorCodes.INVALID_NAME }),\n  middleInitial: z.string(),\n  lastName: z\n    .string()\n    .min(1, { message: EmployeeDetailsErrorCodes.REQUIRED })\n    .regex(NAME_REGEX, { message: EmployeeDetailsErrorCodes.INVALID_NAME }),\n  email: z.email({\n    error: issue =>\n      typeof issue.input === 'string' && issue.input.length === 0\n        ? EmployeeDetailsErrorCodes.REQUIRED\n        : EmployeeDetailsErrorCodes.INVALID_EMAIL,\n  }),\n  dateOfBirth: z.iso.date({ error: () => EmployeeDetailsErrorCodes.REQUIRED }),\n  ssn: z\n    .string({ error: () => EmployeeDetailsErrorCodes.REQUIRED })\n    .refine((v: string) => SSN_REGEX.test(v.replace(/\\D/g, '')), {\n      message: EmployeeDetailsErrorCodes.INVALID_SSN,\n    }),\n  selfOnboarding: z.boolean(),\n}\n\nexport type EmployeeDetailsField = Exclude<keyof typeof fieldValidators, 'selfOnboarding'>\n\nexport type EmployeeDetailsFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\nexport type EmployeeDetailsFormOutputs = EmployeeDetailsFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n\nconst requiredFieldsConfig = {\n  firstName: 'create',\n  lastName: 'create',\n  middleInitial: 'never',\n  email: 'never',\n  dateOfBirth: 'never',\n  ssn: 'never',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\nexport type EmployeeDetailsOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\ninterface EmployeeDetailsSchemaOptions {\n  mode?: 'create' | 'update'\n  optionalFieldsToRequire?: EmployeeDetailsOptionalFieldsToRequire\n  hasSsn?: boolean\n}\n\nexport function createEmployeeDetailsSchema(options: EmployeeDetailsSchemaOptions = {}) {\n  const { mode = 'create', optionalFieldsToRequire, hasSsn = false } = options\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: EmployeeDetailsErrorCodes.REQUIRED,\n    mode,\n    optionalFieldsToRequire,\n    fieldsWithRedactedValues: hasSsn ? ['ssn'] : [],\n    superRefine:\n      mode === 'create'\n        ? (data, ctx) => {\n            if (data.selfOnboarding && (!data.email || data.email.trim() === '')) {\n              ctx.addIssue({\n                code: z.ZodIssueCode.custom,\n                path: ['email'],\n                message: EmployeeDetailsErrorCodes.EMAIL_REQUIRED_FOR_SELF_ONBOARDING,\n              })\n            }\n          }\n        : undefined,\n  })\n}\n"],"names":["EmployeeDetailsErrorCodes","fieldValidators","z","NAME_REGEX","issue","v","SSN_REGEX","requiredFieldsConfig","createEmployeeDetailsSchema","options","mode","optionalFieldsToRequire","hasSsn","buildFormSchema","data","ctx"],"mappings":";;;AAUO,MAAMA,IAA4B;AAAA,EACvC,UAAU;AAAA,EACV,cAAc;AAAA,EACd,eAAe;AAAA,EACf,aAAa;AAAA,EACb,oCAAoC;AACtC,GAOMC,IAAkB;AAAA,EACtB,WAAWC,EACR,OAAA,EACA,IAAI,GAAG,EAAE,SAASF,EAA0B,SAAA,CAAU,EACtD,MAAMG,GAAY,EAAE,SAASH,EAA0B,cAAc;AAAA,EACxE,eAAeE,EAAE,OAAA;AAAA,EACjB,UAAUA,EACP,OAAA,EACA,IAAI,GAAG,EAAE,SAASF,EAA0B,SAAA,CAAU,EACtD,MAAMG,GAAY,EAAE,SAASH,EAA0B,cAAc;AAAA,EACxE,OAAOE,EAAE,MAAM;AAAA,IACb,OAAO,CAAAE,MACL,OAAOA,EAAM,SAAU,YAAYA,EAAM,MAAM,WAAW,IACtDJ,EAA0B,WAC1BA,EAA0B;AAAA,EAAA,CACjC;AAAA,EACD,aAAaE,EAAE,IAAI,KAAK,EAAE,OAAO,MAAMF,EAA0B,UAAU;AAAA,EAC3E,KAAKE,EACF,OAAO,EAAE,OAAO,MAAMF,EAA0B,UAAU,EAC1D,OAAO,CAACK,MAAcC,EAAU,KAAKD,EAAE,QAAQ,OAAO,EAAE,CAAC,GAAG;AAAA,IAC3D,SAASL,EAA0B;AAAA,EAAA,CACpC;AAAA,EACH,gBAAgBE,EAAE,QAAA;AACpB,GAWMK,IAAuB;AAAA,EAC3B,WAAW;AAAA,EACX,UAAU;AAAA,EACV,eAAe;AAAA,EACf,OAAO;AAAA,EACP,aAAa;AAAA,EACb,KAAK;AACP;AAcO,SAASC,EAA4BC,IAAwC,IAAI;AACtF,QAAM,EAAE,MAAAC,IAAO,UAAU,yBAAAC,GAAyB,QAAAC,IAAS,OAAUH;AAErE,SAAOI,EAAgBZ,GAAiB;AAAA,IACtC,sBAAAM;AAAA,IACA,mBAAmBP,EAA0B;AAAA,IAC7C,MAAAU;AAAA,IACA,yBAAAC;AAAA,IACA,0BAA0BC,IAAS,CAAC,KAAK,IAAI,CAAA;AAAA,IAC7C,aACEF,MAAS,WACL,CAACI,GAAMC,MAAQ;AACb,MAAID,EAAK,mBAAmB,CAACA,EAAK,SAASA,EAAK,MAAM,WAAW,OAC/DC,EAAI,SAAS;AAAA,QACX,MAAMb,EAAE,aAAa;AAAA,QACrB,MAAM,CAAC,OAAO;AAAA,QACd,SAASF,EAA0B;AAAA,MAAA,CACpC;AAAA,IAEL,IACA;AAAA,EAAA,CACP;AACH;"}
+{"version":3,"file":"employeeDetailsSchema.js","sources":["../../../../../../src/components/Employee/Profile/shared/useEmployeeDetailsForm/employeeDetailsSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type RequiredFieldConfig,\n  type OptionalFieldsToRequire,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { SSN_REGEX, NAME_REGEX } from '@/helpers/validations'\n\n// ── Error codes ────────────────────────────────────────────────────────\n\n/**\n * Validation error codes emitted by the employee details form schema. Map\n * these codes to localized copy in `validationMessages` when composing the\n * hook.\n *\n * @public\n */\nexport const EmployeeDetailsErrorCodes = {\n  REQUIRED: 'REQUIRED',\n  INVALID_NAME: 'INVALID_NAME',\n  INVALID_EMAIL: 'INVALID_EMAIL',\n  INVALID_SSN: 'INVALID_SSN',\n  EMAIL_REQUIRED_FOR_SELF_ONBOARDING: 'EMAIL_REQUIRED_FOR_SELF_ONBOARDING',\n} as const\n\n/**\n * Union of validation error code strings emitted by the employee details form\n * schema.\n *\n * @public\n */\nexport type EmployeeDetailsErrorCode =\n  (typeof EmployeeDetailsErrorCodes)[keyof typeof EmployeeDetailsErrorCodes]\n\n// ── Field validators ───────────────────────────────────────────────────\n\nconst fieldValidators = {\n  firstName: z\n    .string()\n    .min(1, { message: EmployeeDetailsErrorCodes.REQUIRED })\n    .regex(NAME_REGEX, { message: EmployeeDetailsErrorCodes.INVALID_NAME }),\n  middleInitial: z.string(),\n  lastName: z\n    .string()\n    .min(1, { message: EmployeeDetailsErrorCodes.REQUIRED })\n    .regex(NAME_REGEX, { message: EmployeeDetailsErrorCodes.INVALID_NAME }),\n  email: z.email({\n    error: issue =>\n      typeof issue.input === 'string' && issue.input.length === 0\n        ? EmployeeDetailsErrorCodes.REQUIRED\n        : EmployeeDetailsErrorCodes.INVALID_EMAIL,\n  }),\n  dateOfBirth: z.iso.date({ error: () => EmployeeDetailsErrorCodes.REQUIRED }),\n  ssn: z\n    .string({ error: () => EmployeeDetailsErrorCodes.REQUIRED })\n    .refine((v: string) => SSN_REGEX.test(v.replace(/\\D/g, '')), {\n      message: EmployeeDetailsErrorCodes.INVALID_SSN,\n    }),\n  selfOnboarding: z.boolean(),\n}\n\n/**\n * Field names accepted by the employee details form.\n *\n * @public\n */\nexport type EmployeeDetailsField = Exclude<keyof typeof fieldValidators, 'selfOnboarding'>\n\n/**\n * Shape of the values managed by the employee details form.\n *\n * @public\n */\nexport type EmployeeDetailsFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n/**\n * Shape of the validated values produced by the employee details form on\n * submit.\n *\n * @public\n */\nexport type EmployeeDetailsFormOutputs = EmployeeDetailsFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n\nconst requiredFieldsConfig = {\n  firstName: 'create',\n  lastName: 'create',\n  middleInitial: 'never',\n  email: 'never',\n  dateOfBirth: 'never',\n  ssn: 'never',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\n/**\n * Keys of optional employee details fields that can be promoted to required\n * via the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type EmployeeDetailsOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface EmployeeDetailsSchemaOptions {\n  mode?: 'create' | 'update'\n  optionalFieldsToRequire?: EmployeeDetailsOptionalFieldsToRequire\n  hasSsn?: boolean\n}\n\n/** @internal */\nexport function createEmployeeDetailsSchema(options: EmployeeDetailsSchemaOptions = {}) {\n  const { mode = 'create', optionalFieldsToRequire, hasSsn = false } = options\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: EmployeeDetailsErrorCodes.REQUIRED,\n    mode,\n    optionalFieldsToRequire,\n    fieldsWithRedactedValues: hasSsn ? ['ssn'] : [],\n    superRefine:\n      mode === 'create'\n        ? (data, ctx) => {\n            if (data.selfOnboarding && (!data.email || data.email.trim() === '')) {\n              ctx.addIssue({\n                code: z.ZodIssueCode.custom,\n                path: ['email'],\n                message: EmployeeDetailsErrorCodes.EMAIL_REQUIRED_FOR_SELF_ONBOARDING,\n              })\n            }\n          }\n        : undefined,\n  })\n}\n"],"names":["EmployeeDetailsErrorCodes","fieldValidators","z","NAME_REGEX","issue","v","SSN_REGEX","requiredFieldsConfig","createEmployeeDetailsSchema","options","mode","optionalFieldsToRequire","hasSsn","buildFormSchema","data","ctx"],"mappings":";;;AAiBO,MAAMA,IAA4B;AAAA,EACvC,UAAU;AAAA,EACV,cAAc;AAAA,EACd,eAAe;AAAA,EACf,aAAa;AAAA,EACb,oCAAoC;AACtC,GAaMC,IAAkB;AAAA,EACtB,WAAWC,EACR,OAAA,EACA,IAAI,GAAG,EAAE,SAASF,EAA0B,SAAA,CAAU,EACtD,MAAMG,GAAY,EAAE,SAASH,EAA0B,cAAc;AAAA,EACxE,eAAeE,EAAE,OAAA;AAAA,EACjB,UAAUA,EACP,OAAA,EACA,IAAI,GAAG,EAAE,SAASF,EAA0B,SAAA,CAAU,EACtD,MAAMG,GAAY,EAAE,SAASH,EAA0B,cAAc;AAAA,EACxE,OAAOE,EAAE,MAAM;AAAA,IACb,OAAO,CAAAE,MACL,OAAOA,EAAM,SAAU,YAAYA,EAAM,MAAM,WAAW,IACtDJ,EAA0B,WAC1BA,EAA0B;AAAA,EAAA,CACjC;AAAA,EACD,aAAaE,EAAE,IAAI,KAAK,EAAE,OAAO,MAAMF,EAA0B,UAAU;AAAA,EAC3E,KAAKE,EACF,OAAO,EAAE,OAAO,MAAMF,EAA0B,UAAU,EAC1D,OAAO,CAACK,MAAcC,EAAU,KAAKD,EAAE,QAAQ,OAAO,EAAE,CAAC,GAAG;AAAA,IAC3D,SAASL,EAA0B;AAAA,EAAA,CACpC;AAAA,EACH,gBAAgBE,EAAE,QAAA;AACpB,GA2BMK,IAAuB;AAAA,EAC3B,WAAW;AAAA,EACX,UAAU;AAAA,EACV,eAAe;AAAA,EACf,OAAO;AAAA,EACP,aAAa;AAAA,EACb,KAAK;AACP;AAsBO,SAASC,EAA4BC,IAAwC,IAAI;AACtF,QAAM,EAAE,MAAAC,IAAO,UAAU,yBAAAC,GAAyB,QAAAC,IAAS,OAAUH;AAErE,SAAOI,EAAgBZ,GAAiB;AAAA,IACtC,sBAAAM;AAAA,IACA,mBAAmBP,EAA0B;AAAA,IAC7C,MAAAU;AAAA,IACA,yBAAAC;AAAA,IACA,0BAA0BC,IAAS,CAAC,KAAK,IAAI,CAAA;AAAA,IAC7C,aACEF,MAAS,WACL,CAACI,GAAMC,MAAQ;AACb,MAAID,EAAK,mBAAmB,CAACA,EAAK,SAASA,EAAK,MAAM,WAAW,OAC/DC,EAAI,SAAS;AAAA,QACX,MAAMb,EAAE,aAAa;AAAA,QACrB,MAAM,CAAC,OAAO;AAAA,QACd,SAASF,EAA0B;AAAA,MAAA,CACpC;AAAA,IAEL,IACA;AAAA,EAAA,CACP;AACH;"}

package/dist/components/Employee/Profile/shared/useEmployeeDetailsForm/fields.d.ts

@@ -3,22 +3,192 @@ import { TextInputHookFieldProps } from '../../../../../partner-hook-utils/form/
 import { DatePickerHookFieldProps } from '../../../../../partner-hook-utils/form/fields/DatePickerHookField';
 import { SwitchHookFieldProps } from '../../../../../partner-hook-utils/form/fields/SwitchHookField';
 import { HookFieldProps } from '../../../../../partner-hook-utils/types';
+/**
+ * The required-field error code produced by {@link useEmployeeDetailsForm} fields that only emit `REQUIRED`.
+ *
+ * @remarks
+ * Used as the `validationMessages` key for the middle initial and date of
+ * birth fields. See {@link EmployeeDetailsErrorCodes}.
+ *
+ * @public
+ */
 export type RequiredValidation = typeof EmployeeDetailsErrorCodes.REQUIRED;
+/**
+ * Validation error codes emitted by the name fields of {@link useEmployeeDetailsForm}.
+ *
+ * @remarks
+ * Use these as keys in `validationMessages` on `Fields.FirstName` and
+ * `Fields.LastName`. See {@link EmployeeDetailsErrorCodes} for the full
+ * description of each code.
+ *
+ * @public
+ */
 export type NameValidation = (typeof EmployeeDetailsErrorCodes)['REQUIRED' | 'INVALID_NAME'];
+/**
+ * Validation error codes emitted by the `email` field of {@link useEmployeeDetailsForm}.
+ *
+ * @remarks
+ * Use these as keys in `validationMessages` on `Fields.Email`. The
+ * `EMAIL_REQUIRED_FOR_SELF_ONBOARDING` code fires when self-onboarding is
+ * enabled but the email is empty (create mode only). See
+ * {@link EmployeeDetailsErrorCodes}.
+ *
+ * @public
+ */
 export type EmailValidation = (typeof EmployeeDetailsErrorCodes)['REQUIRED' | 'INVALID_EMAIL' | 'EMAIL_REQUIRED_FOR_SELF_ONBOARDING'];
+/**
+ * The format-validation error code emitted by the `ssn` field of {@link useEmployeeDetailsForm}.
+ *
+ * @remarks
+ * Use as a key in `validationMessages` on `Fields.Ssn`. See
+ * {@link EmployeeDetailsErrorCodes}.
+ *
+ * @public
+ */
 export type SsnValidation = typeof EmployeeDetailsErrorCodes.INVALID_SSN;
+/**
+ * The required-field error code for the `ssn` field of {@link useEmployeeDetailsForm}.
+ *
+ * @remarks
+ * The required rule is automatically waived when the employee already has
+ * an SSN on file, even if `ssn` is included in `optionalFieldsToRequire`.
+ *
+ * @public
+ */
 export type SsnRequiredValidation = typeof EmployeeDetailsErrorCodes.REQUIRED;
+/**
+ * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.FirstName` component.
+ *
+ * @public
+ */
 export type FirstNameFieldProps = HookFieldProps<TextInputHookFieldProps<NameValidation>>;
+/**
+ * Text input bound to the `firstName` field of {@link useEmployeeDetailsForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.FirstName`. Required on
+ * create; can be made required on update via `optionalFieldsToRequire`.
+ *
+ * @param props - {@link FirstNameFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered text input bound to `firstName`.
+ * @public
+ */
 export declare function FirstNameField(props: FirstNameFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.MiddleInitial` component.
+ *
+ * @public
+ */
 export type MiddleInitialFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>;
+/**
+ * Text input bound to the `middleInitial` field of {@link useEmployeeDetailsForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.MiddleInitial`. Always
+ * optional.
+ *
+ * @param props - {@link MiddleInitialFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered text input bound to `middleInitial`.
+ * @public
+ */
 export declare function MiddleInitialField(props: MiddleInitialFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.LastName` component.
+ *
+ * @public
+ */
 export type LastNameFieldProps = HookFieldProps<TextInputHookFieldProps<NameValidation>>;
+/**
+ * Text input bound to the `lastName` field of {@link useEmployeeDetailsForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.LastName`. Required on
+ * create; can be made required on update via `optionalFieldsToRequire`.
+ *
+ * @param props - {@link LastNameFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered text input bound to `lastName`.
+ * @public
+ */
 export declare function LastNameField(props: LastNameFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.Email` component.
+ *
+ * @public
+ */
 export type EmailFieldProps = HookFieldProps<TextInputHookFieldProps<EmailValidation>>;
+/**
+ * Text input bound to the `email` field of {@link useEmployeeDetailsForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.Email`. Optional by default
+ * — opt in via `optionalFieldsToRequire`. Also enforces a required rule
+ * whenever the self-onboarding toggle is enabled in create mode, reported
+ * via the `EMAIL_REQUIRED_FOR_SELF_ONBOARDING` code.
+ *
+ * @param props - {@link EmailFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered text input bound to `email`.
+ * @public
+ */
 export declare function EmailField(props: EmailFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.DateOfBirth` component.
+ *
+ * @public
+ */
 export type DateOfBirthFieldProps = HookFieldProps<DatePickerHookFieldProps<RequiredValidation>>;
+/**
+ * Date picker bound to the `dateOfBirth` field of {@link useEmployeeDetailsForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.DateOfBirth`. Optional by
+ * default — opt in via `optionalFieldsToRequire`.
+ *
+ * @param props - {@link DateOfBirthFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered date picker bound to `dateOfBirth`.
+ * @public
+ */
 export declare function DateOfBirthField(props: DateOfBirthFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.Ssn` component.
+ *
+ * @public
+ */
 export type SsnFieldProps = HookFieldProps<TextInputHookFieldProps<SsnValidation, SsnRequiredValidation>>;
+/**
+ * Text input bound to the `ssn` field of {@link useEmployeeDetailsForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.Ssn`. Auto-formats input
+ * with dashes (`XXX-XX-XXXX`). When the employee already has an SSN on
+ * file, the field shows a masked placeholder and the required rule is
+ * automatically waived even if `ssn` is listed in
+ * `optionalFieldsToRequire`.
+ *
+ * @param props - {@link SsnFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
+ * @returns The rendered text input bound to `ssn`.
+ * @public
+ */
 export declare function SsnField(props: SsnFieldProps): import("react").JSX.Element;
+/**
+ * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.SelfOnboarding` component.
+ *
+ * @public
+ */
 export type SelfOnboardingFieldProps = HookFieldProps<SwitchHookFieldProps>;
+/**
+ * Switch bound to the `selfOnboarding` field of {@link useEmployeeDetailsForm}.
+ *
+ * @remarks
+ * Available on the hook result as `form.Fields.SelfOnboarding` when the
+ * field is toggleable. The field is `undefined` when
+ * `withSelfOnboardingField` is `false`, or when the employee's
+ * onboarding status no longer allows toggling (e.g. self-onboarding is
+ * already in progress or completed). Always null-check before rendering.
+ * When enabled, the employee receives an invitation to enter their own
+ * personal, tax, and banking details.
+ *
+ * @param props - {@link SelfOnboardingFieldProps} — accepts the standard hook field props (label, description, FieldComponent override).
+ * @returns The rendered switch bound to `selfOnboarding`.
+ * @public
+ */
 export declare function SelfOnboardingField(props: SelfOnboardingFieldProps): import("react").JSX.Element;

package/dist/components/Employee/Profile/shared/useEmployeeDetailsForm/fields.js

@@ -1,9 +1,9 @@
 import { jsx as t } from "react/jsx-runtime";
 import { useFormFieldsMetadataContext as r } from "../../../../../partner-hook-utils/form/FormFieldsMetadataContext.js";
 import { usePlaceholderSSN as m, normalizeSSN as l } from "../../../../../helpers/ssn.js";
-import { SwitchHookField as d } from "../../../../../partner-hook-utils/form/fields/SwitchHookField.js";
+import { DatePickerHookField as d } from "../../../../../partner-hook-utils/form/fields/DatePickerHookField.js";
 import { TextInputHookField as a } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
-import { DatePickerHookField as f } from "../../../../../partner-hook-utils/form/fields/DatePickerHookField.js";
+import { SwitchHookField as f } from "../../../../../partner-hook-utils/form/fields/SwitchHookField.js";
 function h(e) {
   return /* @__PURE__ */ t(a, { ...e, name: "firstName" });
 }
@@ -17,7 +17,7 @@ function x(e) {
   return /* @__PURE__ */ t(a, { ...e, name: "email" });
 }
 function H(e) {
-  return /* @__PURE__ */ t(f, { ...e, name: "dateOfBirth" });
+  return /* @__PURE__ */ t(d, { ...e, name: "dateOfBirth" });
 }
 function O(e) {
   const n = r(), i = e.formHookResult?.form.fieldsMetadata ?? n?.metadata ?? {}, o = m(i.ssn?.hasRedactedValue);
@@ -32,7 +32,7 @@ function O(e) {
   );
 }
 function I(e) {
-  return /* @__PURE__ */ t(d, { ...e, name: "selfOnboarding" });
+  return /* @__PURE__ */ t(f, { ...e, name: "selfOnboarding" });
 }
 export {
   H as DateOfBirthField,

package/dist/components/Employee/Profile/shared/useEmployeeDetailsForm/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/Profile/shared/useEmployeeDetailsForm/fields.tsx"],"sourcesContent":["import type { EmployeeDetailsErrorCodes } from './employeeDetailsSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { DatePickerHookFieldProps } from '@/partner-hook-utils/form/fields/DatePickerHookField'\nimport type { SwitchHookFieldProps } from '@/partner-hook-utils/form/fields/SwitchHookField'\nimport {\n  TextInputHookField,\n  DatePickerHookField,\n  SwitchHookField,\n} from '@/partner-hook-utils/form/fields'\nimport { useFormFieldsMetadataContext } from '@/partner-hook-utils/form/FormFieldsMetadataContext'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\nimport { normalizeSSN, usePlaceholderSSN } from '@/helpers/ssn'\n\nexport type RequiredValidation = typeof EmployeeDetailsErrorCodes.REQUIRED\nexport type NameValidation = (typeof EmployeeDetailsErrorCodes)['REQUIRED' | 'INVALID_NAME']\nexport type EmailValidation = (typeof EmployeeDetailsErrorCodes)[\n  | 'REQUIRED'\n  | 'INVALID_EMAIL'\n  | 'EMAIL_REQUIRED_FOR_SELF_ONBOARDING']\nexport type SsnValidation = typeof EmployeeDetailsErrorCodes.INVALID_SSN\nexport type SsnRequiredValidation = typeof EmployeeDetailsErrorCodes.REQUIRED\n\nexport type FirstNameFieldProps = HookFieldProps<TextInputHookFieldProps<NameValidation>>\n\nexport function FirstNameField(props: FirstNameFieldProps) {\n  return <TextInputHookField {...props} name=\"firstName\" />\n}\n\nexport type MiddleInitialFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\nexport function MiddleInitialField(props: MiddleInitialFieldProps) {\n  return <TextInputHookField {...props} name=\"middleInitial\" />\n}\n\nexport type LastNameFieldProps = HookFieldProps<TextInputHookFieldProps<NameValidation>>\n\nexport function LastNameField(props: LastNameFieldProps) {\n  return <TextInputHookField {...props} name=\"lastName\" />\n}\n\nexport type EmailFieldProps = HookFieldProps<TextInputHookFieldProps<EmailValidation>>\n\nexport function EmailField(props: EmailFieldProps) {\n  return <TextInputHookField {...props} name=\"email\" />\n}\n\nexport type DateOfBirthFieldProps = HookFieldProps<DatePickerHookFieldProps<RequiredValidation>>\n\nexport function DateOfBirthField(props: DateOfBirthFieldProps) {\n  return <DatePickerHookField {...props} name=\"dateOfBirth\" />\n}\n\nexport type SsnFieldProps = HookFieldProps<\n  TextInputHookFieldProps<SsnValidation, SsnRequiredValidation>\n>\n\nexport function SsnField(props: SsnFieldProps) {\n  const metadataContext = useFormFieldsMetadataContext()\n  const metadata = props.formHookResult?.form.fieldsMetadata ?? metadataContext?.metadata ?? {}\n  const placeholderSSN = usePlaceholderSSN(metadata.ssn?.hasRedactedValue)\n  return (\n    <TextInputHookField\n      {...props}\n      name=\"ssn\"\n      transform={normalizeSSN}\n      placeholder={placeholderSSN}\n    />\n  )\n}\n\nexport type SelfOnboardingFieldProps = HookFieldProps<SwitchHookFieldProps>\n\nexport function SelfOnboardingField(props: SelfOnboardingFieldProps) {\n  return <SwitchHookField {...props} name=\"selfOnboarding\" />\n}\n"],"names":["FirstNameField","props","jsx","TextInputHookField","MiddleInitialField","LastNameField","EmailField","DateOfBirthField","DatePickerHookField","SsnField","metadataContext","useFormFieldsMetadataContext","metadata","placeholderSSN","usePlaceholderSSN","normalizeSSN","SelfOnboardingField","SwitchHookField"],"mappings":";;;;;;AAwBO,SAASA,EAAeC,GAA4B;AACzD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,aAAY;AACzD;AAIO,SAASG,EAAmBH,GAAgC;AACjE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,iBAAgB;AAC7D;AAIO,SAASI,EAAcJ,GAA2B;AACvD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,YAAW;AACxD;AAIO,SAASK,EAAWL,GAAwB;AACjD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,SAAQ;AACrD;AAIO,SAASM,EAAiBN,GAA8B;AAC7D,SAAO,gBAAAC,EAACM,GAAA,EAAqB,GAAGP,GAAO,MAAK,eAAc;AAC5D;AAMO,SAASQ,EAASR,GAAsB;AAC7C,QAAMS,IAAkBC,EAAA,GAClBC,IAAWX,EAAM,gBAAgB,KAAK,kBAAkBS,GAAiB,YAAY,CAAA,GACrFG,IAAiBC,EAAkBF,EAAS,KAAK,gBAAgB;AACvE,SACE,gBAAAV;AAAA,IAACC;AAAA,IAAA;AAAA,MACE,GAAGF;AAAA,MACJ,MAAK;AAAA,MACL,WAAWc;AAAA,MACX,aAAaF;AAAA,IAAA;AAAA,EAAA;AAGnB;AAIO,SAASG,EAAoBf,GAAiC;AACnE,SAAO,gBAAAC,EAACe,GAAA,EAAiB,GAAGhB,GAAO,MAAK,kBAAiB;AAC3D;"}
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/Profile/shared/useEmployeeDetailsForm/fields.tsx"],"sourcesContent":["import type { EmployeeDetailsErrorCodes } from './employeeDetailsSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { DatePickerHookFieldProps } from '@/partner-hook-utils/form/fields/DatePickerHookField'\nimport type { SwitchHookFieldProps } from '@/partner-hook-utils/form/fields/SwitchHookField'\nimport {\n  TextInputHookField,\n  DatePickerHookField,\n  SwitchHookField,\n} from '@/partner-hook-utils/form/fields'\nimport { useFormFieldsMetadataContext } from '@/partner-hook-utils/form/FormFieldsMetadataContext'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\nimport { normalizeSSN, usePlaceholderSSN } from '@/helpers/ssn'\n\n/**\n * The required-field error code produced by {@link useEmployeeDetailsForm} fields that only emit `REQUIRED`.\n *\n * @remarks\n * Used as the `validationMessages` key for the middle initial and date of\n * birth fields. See {@link EmployeeDetailsErrorCodes}.\n *\n * @public\n */\nexport type RequiredValidation = typeof EmployeeDetailsErrorCodes.REQUIRED\n\n/**\n * Validation error codes emitted by the name fields of {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Use these as keys in `validationMessages` on `Fields.FirstName` and\n * `Fields.LastName`. See {@link EmployeeDetailsErrorCodes} for the full\n * description of each code.\n *\n * @public\n */\nexport type NameValidation = (typeof EmployeeDetailsErrorCodes)['REQUIRED' | 'INVALID_NAME']\n\n/**\n * Validation error codes emitted by the `email` field of {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Use these as keys in `validationMessages` on `Fields.Email`. The\n * `EMAIL_REQUIRED_FOR_SELF_ONBOARDING` code fires when self-onboarding is\n * enabled but the email is empty (create mode only). See\n * {@link EmployeeDetailsErrorCodes}.\n *\n * @public\n */\nexport type EmailValidation = (typeof EmployeeDetailsErrorCodes)[\n  | 'REQUIRED'\n  | 'INVALID_EMAIL'\n  | 'EMAIL_REQUIRED_FOR_SELF_ONBOARDING']\n\n/**\n * The format-validation error code emitted by the `ssn` field of {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Use as a key in `validationMessages` on `Fields.Ssn`. See\n * {@link EmployeeDetailsErrorCodes}.\n *\n * @public\n */\nexport type SsnValidation = typeof EmployeeDetailsErrorCodes.INVALID_SSN\n\n/**\n * The required-field error code for the `ssn` field of {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * The required rule is automatically waived when the employee already has\n * an SSN on file, even if `ssn` is included in `optionalFieldsToRequire`.\n *\n * @public\n */\nexport type SsnRequiredValidation = typeof EmployeeDetailsErrorCodes.REQUIRED\n\n/**\n * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.FirstName` component.\n *\n * @public\n */\nexport type FirstNameFieldProps = HookFieldProps<TextInputHookFieldProps<NameValidation>>\n\n/**\n * Text input bound to the `firstName` field of {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.FirstName`. Required on\n * create; can be made required on update via `optionalFieldsToRequire`.\n *\n * @param props - {@link FirstNameFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `firstName`.\n * @public\n */\nexport function FirstNameField(props: FirstNameFieldProps) {\n  return <TextInputHookField {...props} name=\"firstName\" />\n}\n\n/**\n * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.MiddleInitial` component.\n *\n * @public\n */\nexport type MiddleInitialFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Text input bound to the `middleInitial` field of {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.MiddleInitial`. Always\n * optional.\n *\n * @param props - {@link MiddleInitialFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `middleInitial`.\n * @public\n */\nexport function MiddleInitialField(props: MiddleInitialFieldProps) {\n  return <TextInputHookField {...props} name=\"middleInitial\" />\n}\n\n/**\n * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.LastName` component.\n *\n * @public\n */\nexport type LastNameFieldProps = HookFieldProps<TextInputHookFieldProps<NameValidation>>\n\n/**\n * Text input bound to the `lastName` field of {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.LastName`. Required on\n * create; can be made required on update via `optionalFieldsToRequire`.\n *\n * @param props - {@link LastNameFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `lastName`.\n * @public\n */\nexport function LastNameField(props: LastNameFieldProps) {\n  return <TextInputHookField {...props} name=\"lastName\" />\n}\n\n/**\n * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.Email` component.\n *\n * @public\n */\nexport type EmailFieldProps = HookFieldProps<TextInputHookFieldProps<EmailValidation>>\n\n/**\n * Text input bound to the `email` field of {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Email`. Optional by default\n * — opt in via `optionalFieldsToRequire`. Also enforces a required rule\n * whenever the self-onboarding toggle is enabled in create mode, reported\n * via the `EMAIL_REQUIRED_FOR_SELF_ONBOARDING` code.\n *\n * @param props - {@link EmailFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `email`.\n * @public\n */\nexport function EmailField(props: EmailFieldProps) {\n  return <TextInputHookField {...props} name=\"email\" />\n}\n\n/**\n * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.DateOfBirth` component.\n *\n * @public\n */\nexport type DateOfBirthFieldProps = HookFieldProps<DatePickerHookFieldProps<RequiredValidation>>\n\n/**\n * Date picker bound to the `dateOfBirth` field of {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.DateOfBirth`. Optional by\n * default — opt in via `optionalFieldsToRequire`.\n *\n * @param props - {@link DateOfBirthFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered date picker bound to `dateOfBirth`.\n * @public\n */\nexport function DateOfBirthField(props: DateOfBirthFieldProps) {\n  return <DatePickerHookField {...props} name=\"dateOfBirth\" />\n}\n\n/**\n * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.Ssn` component.\n *\n * @public\n */\nexport type SsnFieldProps = HookFieldProps<\n  TextInputHookFieldProps<SsnValidation, SsnRequiredValidation>\n>\n\n/**\n * Text input bound to the `ssn` field of {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Ssn`. Auto-formats input\n * with dashes (`XXX-XX-XXXX`). When the employee already has an SSN on\n * file, the field shows a masked placeholder and the required rule is\n * automatically waived even if `ssn` is listed in\n * `optionalFieldsToRequire`.\n *\n * @param props - {@link SsnFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `ssn`.\n * @public\n */\nexport function SsnField(props: SsnFieldProps) {\n  const metadataContext = useFormFieldsMetadataContext()\n  const metadata = props.formHookResult?.form.fieldsMetadata ?? metadataContext?.metadata ?? {}\n  const placeholderSSN = usePlaceholderSSN(metadata.ssn?.hasRedactedValue)\n  return (\n    <TextInputHookField\n      {...props}\n      name=\"ssn\"\n      transform={normalizeSSN}\n      placeholder={placeholderSSN}\n    />\n  )\n}\n\n/**\n * Props accepted by {@link useEmployeeDetailsForm}'s `Fields.SelfOnboarding` component.\n *\n * @public\n */\nexport type SelfOnboardingFieldProps = HookFieldProps<SwitchHookFieldProps>\n\n/**\n * Switch bound to the `selfOnboarding` field of {@link useEmployeeDetailsForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.SelfOnboarding` when the\n * field is toggleable. The field is `undefined` when\n * `withSelfOnboardingField` is `false`, or when the employee's\n * onboarding status no longer allows toggling (e.g. self-onboarding is\n * already in progress or completed). Always null-check before rendering.\n * When enabled, the employee receives an invitation to enter their own\n * personal, tax, and banking details.\n *\n * @param props - {@link SelfOnboardingFieldProps} — accepts the standard hook field props (label, description, FieldComponent override).\n * @returns The rendered switch bound to `selfOnboarding`.\n * @public\n */\nexport function SelfOnboardingField(props: SelfOnboardingFieldProps) {\n  return <SwitchHookField {...props} name=\"selfOnboarding\" />\n}\n"],"names":["FirstNameField","props","jsx","TextInputHookField","MiddleInitialField","LastNameField","EmailField","DateOfBirthField","DatePickerHookField","SsnField","metadataContext","useFormFieldsMetadataContext","metadata","placeholderSSN","usePlaceholderSSN","normalizeSSN","SelfOnboardingField","SwitchHookField"],"mappings":";;;;;;AA4FO,SAASA,EAAeC,GAA4B;AACzD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,aAAY;AACzD;AAoBO,SAASG,EAAmBH,GAAgC;AACjE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,iBAAgB;AAC7D;AAoBO,SAASI,EAAcJ,GAA2B;AACvD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,YAAW;AACxD;AAsBO,SAASK,EAAWL,GAAwB;AACjD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,SAAQ;AACrD;AAoBO,SAASM,EAAiBN,GAA8B;AAC7D,SAAO,gBAAAC,EAACM,GAAA,EAAqB,GAAGP,GAAO,MAAK,eAAc;AAC5D;AAyBO,SAASQ,EAASR,GAAsB;AAC7C,QAAMS,IAAkBC,EAAA,GAClBC,IAAWX,EAAM,gBAAgB,KAAK,kBAAkBS,GAAiB,YAAY,CAAA,GACrFG,IAAiBC,EAAkBF,EAAS,KAAK,gBAAgB;AACvE,SACE,gBAAAV;AAAA,IAACC;AAAA,IAAA;AAAA,MACE,GAAGF;AAAA,MACJ,MAAK;AAAA,MACL,WAAWc;AAAA,MACX,aAAaF;AAAA,IAAA;AAAA,EAAA;AAGnB;AAyBO,SAASG,EAAoBf,GAAiC;AACnE,SAAO,gBAAAC,EAACe,GAAA,EAAiB,GAAGhB,GAAO,MAAK,kBAAiB;AAC3D;"}

package/dist/components/Employee/Profile/shared/useEmployeeDetailsForm/index.d.ts

@@ -1,5 +1,7 @@
 import "./types/i18next.d.ts"
 export { useEmployeeDetailsForm } from './useEmployeeDetailsForm';
-export type { EmployeeDetailsSubmitCallbacks, EmployeeDetailsOptionalFieldsToRequire, UseEmployeeDetailsFormProps, UseEmployeeDetailsFormResult, UseEmployeeDetailsFormReady, EmployeeDetailsFieldsMetadata, EmployeeDetailsFormFields, } from './useEmployeeDetailsForm';
+export type { EmployeeDetailsSubmitCallbacks, EmployeeDetailsOptionalFieldsToRequire, UseEmployeeDetailsFormSharedProps, UseEmployeeDetailsFormProps, UseEmployeeDetailsFormResult, UseEmployeeDetailsFormReady, EmployeeDetailsFieldsMetadata, EmployeeDetailsFormFields, } from './useEmployeeDetailsForm';
 export { createEmployeeDetailsSchema, EmployeeDetailsErrorCodes, type EmployeeDetailsErrorCode, type EmployeeDetailsFormData, type EmployeeDetailsFormOutputs, type EmployeeDetailsField, } from './employeeDetailsSchema';
-export type { RequiredValidation as EmployeeDetailsRequiredValidation, NameValidation, EmailValidation, SsnValidation, FirstNameFieldProps, MiddleInitialFieldProps, LastNameFieldProps, EmailFieldProps, DateOfBirthFieldProps, SsnFieldProps, SelfOnboardingFieldProps, } from './fields';
+export { FirstNameField, MiddleInitialField, LastNameField, EmailField, DateOfBirthField, SsnField, SelfOnboardingField, } from './fields';
+export type { RequiredValidation as EmployeeDetailsRequiredValidation, NameValidation, EmailValidation, SsnValidation, SsnRequiredValidation, FirstNameFieldProps, MiddleInitialFieldProps, LastNameFieldProps, EmailFieldProps, DateOfBirthFieldProps, SsnFieldProps, SelfOnboardingFieldProps, } from './fields';
+export type { EmployeeDetailsFields } from './useEmployeeDetailsForm';