@gusto/embedded-react-sdk 0.53.0 → 0.54.1-rc.1

package/dist/components/Employee/Compensation/shared/useCompensationForm/useCompensationForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCompensationForm.js","sources":["../../../../../../src/components/Employee/Compensation/shared/useCompensationForm/useCompensationForm.tsx"],"sourcesContent":["import { useEffect, useMemo, useRef } from 'react'\nimport type { ComponentType } from 'react'\nimport { useForm, useWatch } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Compensation, PaymentUnit } from '@gusto/embedded-api/models/components/compensation'\nimport type { Job } from '@gusto/embedded-api/models/components/job'\nimport type { FlsaStatusType } from '@gusto/embedded-api/models/components/flsastatustype'\nimport type { MinimumWage } from '@gusto/embedded-api/models/components/minimumwage'\nimport { useJobsAndCompensationsGetJobs } from '@gusto/embedded-api/react-query/jobsAndCompensationsGetJobs'\nimport { GetV1EmployeesEmployeeIdJobsQueryParamInclude } from '@gusto/embedded-api/models/operations/getv1employeesemployeeidjobs'\nimport { useJobsAndCompensationsCreateCompensationMutation } from '@gusto/embedded-api/react-query/jobsAndCompensationsCreateCompensation'\nimport { useJobsAndCompensationsUpdateCompensationMutation } from '@gusto/embedded-api/react-query/jobsAndCompensationsUpdateCompensation'\nimport { useLocationsGetMinimumWages } from '@gusto/embedded-api/react-query/locationsGetMinimumWages'\nimport { useEmployeeAddressesGetWorkAddresses } from '@gusto/embedded-api/react-query/employeeAddressesGetWorkAddresses'\nimport { useEmployeesGet } from '@gusto/embedded-api/react-query/employeesGet'\nimport {\n  createCompensationSchema,\n  type CompensationOptionalFieldsToRequire,\n  type CompensationFormData,\n  type CompensationFormOutputs,\n} from './compensationSchema'\nimport {\n  TitleField,\n  FlsaStatusField,\n  RateField,\n  PaymentUnitField,\n  AdjustForMinimumWageField,\n  MinimumWageIdField,\n  EffectiveDateField,\n} from './fields'\nimport type {\n  TitleFieldProps,\n  FlsaStatusFieldProps,\n  RateFieldProps,\n  PaymentUnitFieldProps,\n  AdjustForMinimumWageFieldProps,\n  MinimumWageIdFieldProps,\n  EffectiveDateFieldProps,\n} from './fields'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { withFlags } from '@/partner-hook-utils/form/withFlags'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldMetadata,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { FlsaStatus, PAY_PERIODS, TIP_CREDITS_UNSUPPORTED_STATES } from '@/shared/constants'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { addDays, formatDateToStringDate } from '@/helpers/dateFormatting'\n\n/**\n * Optional values supplied to {@link useCompensationForm}'s `actions.onSubmit` at submit time.\n *\n * @remarks\n * Use these to override hook-construction props when an ID isn't known at\n * mount — most commonly the **onboarding stub-fill** chain, where `useJobForm`\n * creates the parent job and returns the auto-created stub compensation, and\n * the IDs and version are threaded into this hook's `onSubmit` to PUT the\n * stub.\n *\n * @public\n */\nexport interface CompensationSubmitOptions {\n  /** Override jobId — required when creating a compensation if not configured at hook construction (e.g. when the parent job was just created in the same submit chain). */\n  jobId?: string\n  /** Override compensationId — when present, forces update (PUT) routing regardless of hook construction. */\n  compensationId?: string\n  /**\n   * Compensation version for optimistic locking on PUT. Required when forcing\n   * update routing post-create (e.g. updating the auto-created stub returned\n   * from `POST /v1/employees/:id/jobs`). When omitted, the hook reads the\n   * version from its cached `currentCompensation`.\n   */\n  compensationVersion?: string\n  /**\n   * Supply `effectiveDate` at submit time. When `withEffectiveDateField`\n   * is `true`, this overrides the form's value. When `withEffectiveDateField`\n   * is `false`, this is the only way to put `effective_date` on the wire —\n   * the form value is not read in that mode (matching the options-only\n   * convention of `useWorkAddressForm` / `useHomeAddressForm` / `useJobForm`).\n   */\n  effectiveDate?: string\n}\n\n/**\n * Configuration options for {@link useCompensationForm}.\n *\n * @remarks\n * Presence or absence of `compensationId` selects the API verb — see the\n * `compensationId` field description. `employeeId` is optional so the hook\n * can be composed alongside an employee-creation step. `jobId` is optional in\n * update mode (derived from the loaded compensation) and required in create\n * mode (scopes the POST); supply it at submit time via\n * {@link CompensationSubmitOptions.jobId} when the parent job is created in\n * the same submit chain.\n *\n * @public\n */\nexport interface UseCompensationFormProps {\n  /** UUID of the employee whose compensation is being created or edited. Drives data fetching for derived helpers (jobs list, work address, minimum wages). May be omitted when composing alongside an employee-creation step. */\n  employeeId?: string\n  /** The parent job's UUID. Required in create mode (scopes `POST /v1/jobs/:jobId/compensations`). Optional in update mode — the parent job is derived from the loaded compensation. */\n  jobId?: string\n  /** Present → update mode (PUT /v1/compensations/:id). Omitted → create mode (POST /v1/jobs/:jobId/compensations). */\n  compensationId?: string\n  /** Override fields that are optional on a given mode to be required. See {@link CompensationOptionalFieldsToRequire}. */\n  optionalFieldsToRequire?: CompensationOptionalFieldsToRequire\n  /** Pre-fill form values. Server data takes precedence on update mode. */\n  defaultValues?: Partial<CompensationFormData>\n  /** Passed through to react-hook-form. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Auto-focus the first invalid field on submit. Set to `false` when using `composeSubmitHandler` so submit-time focus is coordinated across multiple forms. Defaults to `true`. */\n  shouldFocusError?: boolean\n  /**\n   * When `false`, hides `Fields.EffectiveDate` (becomes `undefined`) and\n   * removes `effectiveDate` from schema validation. In this mode the hook\n   * does not read any form value at submit time — `effective_date` is\n   * omitted from the request body unless explicitly supplied via\n   * {@link CompensationSubmitOptions.effectiveDate}. This matches the\n   * options-only convention of other form hooks, and means the\n   * `willDeleteSecondaryJobs` carve-out's form-state side effects do not\n   * leak onto the wire (there is no field to render them in anyway).\n   * Defaults to `true`.\n   */\n  withEffectiveDateField?: boolean\n}\n\n/**\n * Pre-bound field components exposed on `useCompensationForm().form.Fields`.\n *\n * @remarks\n * Each property is either the field component or `undefined`. A field is\n * `undefined` when conditions for rendering it aren't met — see each member\n * for its visibility rule. Always null-check conditional fields (e.g.\n * `{Fields.FlsaStatus && <Fields.FlsaStatus ... />}`) before rendering.\n *\n * @public\n */\nexport interface CompensationFormFields {\n  /** Bound to `title`. Title text input. Always available. Optional in both modes unless `optionalFieldsToRequire` requires it. */\n  Title: ComponentType<TitleFieldProps>\n  /** Bound to `flsaStatus`. FLSA classification select. `undefined` when the status is not user-editable (e.g. secondary jobs that must match the primary). */\n  FlsaStatus: ComponentType<FlsaStatusFieldProps> | undefined\n  /** Bound to `rate`. Compensation amount input. `undefined` for commission-only FLSA statuses, which don't accept a partner-supplied rate. */\n  Rate: ComponentType<RateFieldProps> | undefined\n  /** Bound to `paymentUnit`. Payment unit select. `undefined` for commission-only FLSA statuses (the hook forces `paymentUnit=Year`). */\n  PaymentUnit: ComponentType<PaymentUnitFieldProps> | undefined\n  /** Bound to `adjustForMinimumWage`. Minimum-wage adjustment checkbox. `undefined` unless `flsaStatus === Nonexempt`, the employee's work location has minimum wages, and the state supports tip credits. */\n  AdjustForMinimumWage: ComponentType<AdjustForMinimumWageFieldProps> | undefined\n  /** Bound to `minimumWageId`. Minimum-wage selection. `undefined` unless `Fields.AdjustForMinimumWage` is rendered and checked. */\n  MinimumWageId: ComponentType<MinimumWageIdFieldProps> | undefined\n  /** Bound to `effectiveDate`. Effective-date picker. `undefined` when `withEffectiveDateField: false`; supply the value via `CompensationSubmitOptions.effectiveDate` in that mode. */\n  EffectiveDate: ComponentType<EffectiveDateFieldProps> | undefined\n}\n\n/**\n * Ready-state shape returned by {@link useCompensationForm} once data has loaded.\n *\n * @remarks\n * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with\n * the compensation-specific `data`, `status`, `actions`, and `form.Fields`\n * shape. Static, entity-derived values live under `data.*`; reactive values\n * that flip with form input live under `status.*`.\n *\n * @public\n */\nexport interface UseCompensationFormReady extends BaseFormHookReady<\n  CompensationFieldsMetadata,\n  CompensationFormData,\n  CompensationFormFields\n> {\n  /** Compensation-specific data payload: the loaded compensation, the parent job, available minimum wages, and effective-date bounds. */\n  data: {\n    /** The compensation row loaded for update; `null` in create mode. */\n    compensation: Compensation | null\n    /** The parent job. In update mode it's derived from the loaded compensation; in create mode it's looked up by `jobId`. `null` if neither resolves. */\n    currentJob: Job | null\n    /** Minimum wages available at the employee's active work location. Empty when no location is set or no minimums are defined. */\n    minimumWages: MinimumWage[]\n    /** Lower bound for `effectiveDate` (typically the parent job's hire date). */\n    minimumEffectiveDate: string | null\n    /** Upper bound for `effectiveDate` — the next scheduled future compensation's effective date, when one exists. */\n    maximumEffectiveDate: string | null\n    /** True when at least one future-dated compensation already exists for this job. */\n    hasPendingFutureCompensation: boolean\n  }\n  /** Submission state and reactive flags derived from current form input. `isPending` is `true` while a create/update mutation is in flight; `mode` reflects whether the next submit will create or update; the `show*Alert` flags drive FLSA-specific inline warnings. */\n  status: {\n    /** `true` while a create or update mutation is in flight. */\n    isPending: boolean\n    /** Reflects whether the next submit will POST a new compensation or PUT an existing one. */\n    mode: 'create' | 'update'\n    /**\n     * True when submitting the form right now would delete the employee's\n     * secondary jobs server-side (the \"carve-out\" branch). Reactive:\n     * derived from the current `flsaStatus` form value, the loaded\n     * compensation, and the other-jobs count, so this flips as you change\n     * inputs.\n     *\n     * Conditions: update mode, the loaded compensation is Nonexempt, the\n     * form's `flsaStatus` has been changed to a non-Nonexempt value, and\n     * the employee has at least one secondary job.\n     *\n     * While this flag is true the hook also takes the `effectiveDate`\n     * field over: it forces the form value to today (so submits route\n     * through a PUT that immediately deletes secondaries) and exposes\n     * `fieldsMetadata.effectiveDate.isDisabled = true` so `Fields.EffectiveDate`\n     * renders as disabled. On revert (FLSA back to Nonexempt) the prior\n     * `effectiveDate` is restored. Render an inline warning keyed off\n     * this flag — no separate confirmation step is needed.\n     */\n    willDeleteSecondaryJobs: boolean\n    /**\n     * True when the current `flsaStatus` is `COMMISSION_ONLY_EXEMPT`\n     * (Commission Only/No Overtime). Render the federal-minimum-pay\n     * warning alert when this flag is true. While this flag is true,\n     * `Fields.Rate` and `Fields.PaymentUnit` are also `undefined` (the\n     * hook forces `rate=0`, `paymentUnit=YEAR` on the form values).\n     */\n    showCommissionFederalMinimumPayAlert: boolean\n    /**\n     * True when the current `flsaStatus` is `COMMISSION_ONLY_NONEXEMPT`\n     * (Commission Only/Eligible for overtime). Render the local-minimum-wage\n     * warning alert when this flag is true. While this flag is true,\n     * `Fields.Rate` and `Fields.PaymentUnit` are also `undefined` (the\n     * hook forces `rate=0`, `paymentUnit=YEAR` on the form values).\n     */\n    showCommissionMinimumWageAlert: boolean\n    /**\n     * True when the current `flsaStatus` is `OWNER` (Owner's draw). Render\n     * an informational alert noting that the IRS requires S-corp owners to\n     * pay themselves a reasonable salary for similar work before taking\n     * distributions.\n     */\n    showOwnerSalaryAlert: boolean\n  }\n  /** Submit actions exposed by the hook. */\n  actions: {\n    /** Validates the form, runs the appropriate create/update mutation, and resolves to a {@link HookSubmitResult} containing the saved compensation. Resolves to `undefined` on validation failure or mutation error. Accepts {@link CompensationSubmitOptions} for threading IDs/version into the onboarding stub-fill chain. */\n    onSubmit: (\n      options?: CompensationSubmitOptions,\n    ) => Promise<HookSubmitResult<Compensation> | undefined>\n  }\n}\n\nfunction resolveCompAndJob(\n  jobs: Job[] | undefined,\n  compensationId: string | undefined,\n  jobId: string | undefined,\n): { compensation: Compensation | null; job: Job | null } {\n  if (!jobs) return { compensation: null, job: null }\n  if (compensationId) {\n    for (const job of jobs) {\n      const compensation = job.compensations?.find(c => c.uuid === compensationId)\n      if (compensation) return { compensation, job }\n    }\n    // If the comp isn't in any job's compensations list, still try to resolve\n    // the job by jobId so callers can check job metadata (e.g. job.primary).\n    const fallbackJob = jobId ? (jobs.find(j => j.uuid === jobId) ?? null) : null\n    return { compensation: null, job: fallbackJob }\n  }\n  if (jobId) return { compensation: null, job: jobs.find(j => j.uuid === jobId) ?? null }\n  return { compensation: null, job: null }\n}\n\nfunction findPrimaryFlsaStatus(jobs: Job[] | undefined): FlsaStatusType | null {\n  if (!jobs) return null\n  for (const job of jobs) {\n    if (!job.primary) continue\n    const compensation = job.compensations?.find(c => c.uuid === job.currentCompensationUuid)\n    if (compensation?.flsaStatus) return compensation.flsaStatus\n  }\n  return null\n}\n\nfunction findFutureCompensations(job: Job | null): Compensation[] {\n  if (!job?.compensations) return []\n  const today = todayISO()\n  return job.compensations.filter(c => c.effectiveDate !== undefined && c.effectiveDate > today)\n}\n\nfunction earliestEffectiveDate(comps: Compensation[]): string | null {\n  if (comps.length === 0) return null\n  return comps.reduce<string | null>((min, c) => {\n    const d = c.effectiveDate\n    if (!d) return min\n    if (!min || d < min) return d\n    return min\n  }, null)\n}\n\nconst flsaStatusEntries: FlsaStatusType[] = [\n  FlsaStatus.EXEMPT,\n  FlsaStatus.SALARIED_NONEXEMPT,\n  FlsaStatus.NONEXEMPT,\n  FlsaStatus.OWNER,\n  FlsaStatus.COMMISSION_ONLY_EXEMPT,\n  FlsaStatus.COMMISSION_ONLY_NONEXEMPT,\n]\n\nconst flsaOptions = flsaStatusEntries.map(status => ({ value: status, label: status }))\n\nconst paymentUnitEntries: PaymentUnit[] = [\n  PAY_PERIODS.HOUR,\n  PAY_PERIODS.WEEK,\n  PAY_PERIODS.MONTH,\n  PAY_PERIODS.YEAR,\n  PAY_PERIODS.PAYCHECK,\n]\n\nconst paymentUnitOptions = paymentUnitEntries.map(unit => ({ value: unit, label: unit }))\n\nfunction todayISO(): string {\n  return new Date().toISOString().split('T')[0]!\n}\n\n/** @internal */\nfunction buildCompensationFieldsMetadata(\n  base: Record<keyof CompensationFormData, FieldMetadata>,\n  {\n    willDeleteSecondaryJobs,\n    isCreateMode,\n    isCommissionOnly,\n    isOwner,\n    isAdjustMinimumWageEnabled,\n    effectiveDateMinDate,\n    maximumEffectiveDate,\n    minimumWageOptions,\n    minimumWages,\n  }: {\n    willDeleteSecondaryJobs: boolean\n    isCreateMode: boolean\n    isCommissionOnly: boolean\n    isOwner: boolean\n    isAdjustMinimumWageEnabled: boolean\n    effectiveDateMinDate: string | null\n    maximumEffectiveDate: string | null\n    minimumWageOptions: { value: string; label: string }[]\n    minimumWages: MinimumWage[]\n  },\n) {\n  return {\n    title: base.title,\n    effectiveDate: withFlags(base.effectiveDate, {\n      isDisabled: willDeleteSecondaryJobs && !isCreateMode,\n      minDate: effectiveDateMinDate,\n      maxDate: maximumEffectiveDate,\n    }),\n    flsaStatus: withOptions<FlsaStatusType>(base.flsaStatus, flsaOptions, flsaStatusEntries),\n    rate: withFlags(base.rate, { isDisabled: isCommissionOnly }),\n    paymentUnit: withOptions<PaymentUnit>(\n      withFlags(base.paymentUnit, { isDisabled: isOwner || isCommissionOnly }),\n      paymentUnitOptions,\n      paymentUnitEntries,\n    ),\n    adjustForMinimumWage: withFlags(base.adjustForMinimumWage, {\n      isDisabled: !isAdjustMinimumWageEnabled,\n    }),\n    minimumWageId: withOptions<MinimumWage>(base.minimumWageId, minimumWageOptions, minimumWages),\n  } satisfies FieldsMetadata\n}\n\n/**\n * Headless hook for creating or updating a compensation row on a job — FLSA classification, pay rate, payment unit, effective date, and optional minimum-wage adjustment.\n *\n * @remarks\n * Companion hook to `useJobForm`. Jobs and their compensations are separate\n * entities in the Gusto API and this hook focuses exclusively on the\n * compensation side. Presence of `compensationId` selects the verb:\n *\n * | Hook config / submit options | Mode | API call |\n * | ---------------------------- | ---- | -------- |\n * | `{ jobId, compensationId }` | update | `PUT /v1/compensations/:compensationId` (with `version`) |\n * | `{ jobId }` (no `compensationId`) | create | `POST /v1/jobs/:jobId/compensations` |\n * | `{ employeeId }` + submit `{ jobId, compensationId, compensationVersion }` | update | `PUT /v1/compensations/:compensationId` (with the supplied `version`) |\n * | `{ employeeId }` + submit `{ jobId }` (no `compensationId`) | create | `POST /v1/jobs/:options.jobId/compensations` |\n *\n * Use the submit-options form for the **onboarding stub-fill** chain: after\n * `useJobForm.actions.onSubmit()` creates a job, capture the auto-created\n * compensation's UUID and version from the response, and pass them as\n * `{ jobId, compensationId, compensationVersion }` to this hook's `onSubmit`\n * to PUT the stub.\n *\n * The hook exposes several derived helpers for driving UX — static\n * entity-derived values under `data.*` (effective-date bounds, pending\n * future compensations) and reactive flags under `status.*` (the\n * `willDeleteSecondaryJobs` carve-out, plus FLSA-specific alerts for\n * commission-only and owner classifications). When\n * `willDeleteSecondaryJobs` is `true` in update mode, the hook also locks\n * the `effectiveDate` field (forces to today, renders disabled) until the\n * FLSA selection is reverted.\n *\n * @param input - {@link UseCompensationFormProps} — `employeeId`, `jobId`, `compensationId` (toggle create/update), required-field overrides, default values, and which fields the hook renders.\n * @returns A {@link HookLoadingResult} while data is loading, or a {@link UseCompensationFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import { useCompensationForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n *\n * function CompensationForm({ employeeId, jobId }: { employeeId: string; jobId: string }) {\n *   const comp = useCompensationForm({ employeeId, jobId })\n *   if (comp.isLoading) return null\n *\n *   const { Fields } = comp.form\n *   return (\n *     <form onSubmit={e => { e.preventDefault(); comp.actions.onSubmit() }}>\n *       <SDKFormProvider formHookResult={comp}>\n *         {Fields.FlsaStatus && <Fields.FlsaStatus label=\"Employee type\" />}\n *         <Fields.Rate label=\"Compensation amount\" />\n *         <Fields.PaymentUnit label=\"Payment unit\" />\n *         {Fields.EffectiveDate && <Fields.EffectiveDate label=\"Effective date\" />}\n *       </SDKFormProvider>\n *       {comp.status.willDeleteSecondaryJobs && (\n *         <p>Saving will remove this employee's secondary jobs.</p>\n *       )}\n *       <button type=\"submit\" disabled={comp.status.isPending}>Save</button>\n *     </form>\n *   )\n * }\n * ```\n */\nexport function useCompensationForm({\n  employeeId,\n  jobId,\n  compensationId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n  withEffectiveDateField = true,\n}: UseCompensationFormProps): HookLoadingResult | UseCompensationFormReady {\n  const jobsQuery = useJobsAndCompensationsGetJobs(\n    {\n      employeeId: employeeId ?? '',\n      // Fetch all effective-dated compensations when editing an existing one so\n      // resolveCompAndJob can find the target comp (future-dated comps are\n      // omitted from the default response, which only returns the current comp).\n      include: compensationId\n        ? GetV1EmployeesEmployeeIdJobsQueryParamInclude.AllCompensations\n        : undefined,\n    },\n    { enabled: !!employeeId },\n  )\n  const addressesQuery = useEmployeeAddressesGetWorkAddresses(\n    { employeeId: employeeId ?? '' },\n    { enabled: !!employeeId },\n  )\n  const employeeQuery = useEmployeesGet({ employeeId: employeeId ?? '' }, { enabled: !!employeeId })\n\n  const employeeJobs = jobsQuery.data?.jobs\n  const workAddresses = addressesQuery.data?.employeeWorkAddressesList\n  const currentWorkAddress = workAddresses?.find(address => address.active)\n  const locationUuid = currentWorkAddress?.locationUuid\n  const employee = employeeQuery.data?.employee\n\n  const minWagesQuery = useLocationsGetMinimumWages(\n    { locationUuid: locationUuid ?? '' },\n    { enabled: !!locationUuid },\n  )\n\n  const minimumWages = minWagesQuery.data?.minimumWageList ?? []\n\n  const { compensation: currentCompensation, job: currentJob } = resolveCompAndJob(\n    employeeJobs,\n    compensationId,\n    jobId,\n  )\n\n  const otherJobsCount =\n    employeeJobs && currentJob ? employeeJobs.filter(j => j.uuid !== currentJob.uuid).length : 0\n\n  // Snapshot — written exactly once, on the first render where `employeeJobs`\n  // is defined (i.e., the initial `getJobs` query has resolved) — capturing\n  // whether the employee already had a primary job at that moment.\n  //\n  // Used to ignore the API-generated stub primary (FLSA Nonexempt, rate \"0.00\")\n  // that briefly appears between the chained job POST and comp PUT during\n  // onboarding: `getJobs` invalidates between the two mutations and\n  // momentarily includes the stub, which would otherwise flip\n  // `isAddingSecondaryJob` to true and hide `Fields.FlsaStatus` mid-submit.\n  //\n  // In steady-state flows (edit primary, edit secondary, add secondary), the\n  // real primary already exists when the query first resolves, so the snapshot\n  // is `true` and live `employeeJobs` continues to drive `primaryFlsaStatus`.\n  // Recovery for the rare case where a partner mounts before any jobs exist\n  // and a primary is created externally mid-form is to remount the hook\n  // (e.g., via a `key` change).\n  const hadPrimaryAtMountRef = useRef<boolean | null>(null)\n  if (hadPrimaryAtMountRef.current === null && employeeJobs !== undefined) {\n    hadPrimaryAtMountRef.current = employeeJobs.some(job => job.primary)\n  }\n  const hadPrimaryAtMount = hadPrimaryAtMountRef.current === true\n\n  // FLSA status of the employee's primary job's current compensation, when one\n  // exists. Used as a fallback default when adding a *secondary* job/comp so the\n  // multi-job classification stays consistent with the primary by default — the\n  // user can still override it (when allowed). Null when there was no primary\n  // job at the moment the hook first observed `employeeJobs`, or when the\n  // primary has no current compensation yet.\n  const primaryFlsaStatus = hadPrimaryAtMount ? findPrimaryFlsaStatus(employeeJobs) : null\n\n  const hireDate =\n    currentJob?.hireDate ??\n    // Secondary jobs being created (CompensationAddAnotherJobForm) have no hireDate until the\n    // job POST completes. Fall back to the primary job's hireDate so the schema\n    // can enforce EFFECTIVE_DATE_BEFORE_HIRE during that window.\n    employeeJobs?.find(j => j.primary)?.hireDate ??\n    null\n\n  // In update mode, exclude the compensation being edited so it doesn't\n  // bound `maximumEffectiveDate` to its own current date — that would prevent\n  // the user from pushing the pending effective date further out.\n  const futureCompensations = findFutureCompensations(currentJob).filter(\n    c => c.uuid !== compensationId,\n  )\n  const hasPendingFutureCompensation = futureCompensations.length > 0\n  const maximumEffectiveDate = earliestEffectiveDate(futureCompensations)\n\n  const isCreateMode = !compensationId\n  const mode = isCreateMode ? 'create' : 'update'\n  // Adding a secondary job (the employee already has a primary). The Gusto API\n  // only allows secondaries when the primary's current FLSA is Nonexempt, and\n  // the secondary itself must match — so the FLSA field is not user-editable\n  // in this branch. We force the form value to the primary's FLSA below and\n  // hide `Fields.FlsaStatus`.\n  // True when adding a brand-new secondary job (not when scheduling a future\n  // comp for the primary). The distinction matters: for the primary's future\n  // comp, FLSA should be editable; for a secondary, it must match the primary.\n  const isAddingSecondaryJob =\n    isCreateMode && primaryFlsaStatus === FlsaStatus.NONEXEMPT && currentJob?.primary !== true\n\n  // Derive the effective-date floor internally so consumers don't need to wire\n  // it up. Rules by mode and job type:\n  //   create (any job): tomorrow — new comp must be future-dated\n  //   update, primary: undefined — the carve-out (willDeleteSecondaryJobs) can\n  //     force effectiveDate to today on a disabled field; enforcing a floor here\n  //     would produce a spurious EFFECTIVE_DATE_BEFORE_MIN on submit.\n  //   update, secondary: tomorrow — must be in the future\n  // The hire-date lower bound is handled separately in the schema via the\n  // `hireDate` option (→ EFFECTIVE_DATE_BEFORE_HIRE), which fires alongside\n  // this check so each violation gets its own error message.\n  const internalMinEffectiveDate = useMemo(() => {\n    if (!withEffectiveDateField) return undefined\n    if (!isCreateMode && currentJob?.primary === true) return undefined\n\n    return formatDateToStringDate(addDays(new Date(), 1)) ?? undefined\n  }, [isCreateMode, currentJob?.primary, withEffectiveDateField])\n\n  const [schema, metadataConfig] = useMemo(\n    () =>\n      createCompensationSchema({\n        mode,\n        optionalFieldsToRequire,\n        hireDate,\n        minEffectiveDate: internalMinEffectiveDate,\n        withEffectiveDateField,\n      }),\n    [mode, optionalFieldsToRequire, hireDate, internalMinEffectiveDate, withEffectiveDateField],\n  )\n\n  const state = currentWorkAddress?.state\n\n  // `flsaStatus` is intentionally allowed to be undefined so the field renders\n  // an empty placeholder when nothing is provided — partners can choose to\n  // seed it via `defaultValues.flsaStatus`. When a `compensation` is loaded we\n  // seed from it; for a brand-new secondary job we inherit from the primary's\n  // current compensation so multi-job classification stays consistent. The\n  // schema enforces requiredness on submit in `create` mode (see\n  // `requiredFieldsConfig` in compensationSchema.ts).\n  //\n  // `title` lives on compensation in the API — `job.title` is a denormalized\n  // snapshot of the primary comp's title that can lag behind comp-level edits\n  // on secondaries. Seed directly from the loaded compensation so editing in\n  // place can't silently re-introduce a stale title from the job record.\n  const resolvedDefaults: CompensationFormData = useMemo(\n    () => ({\n      title: currentCompensation?.title ?? partnerDefaults?.title ?? '',\n      // When adding a secondary, the FLSA must match the primary's — force it\n      // here (overriding any partner default) so the form submits the right\n      // value even though `Fields.FlsaStatus` is hidden.\n      flsaStatus: isAddingSecondaryJob\n        ? primaryFlsaStatus\n        : (currentCompensation?.flsaStatus ??\n          partnerDefaults?.flsaStatus ??\n          primaryFlsaStatus ??\n          undefined),\n      rate: Number(currentCompensation?.rate ?? partnerDefaults?.rate ?? 0),\n      adjustForMinimumWage:\n        currentCompensation?.adjustForMinimumWage ?? partnerDefaults?.adjustForMinimumWage ?? false,\n      minimumWageId:\n        currentCompensation?.minimumWages?.[0]?.uuid ?? partnerDefaults?.minimumWageId ?? '',\n      paymentUnit:\n        currentCompensation?.paymentUnit ?? partnerDefaults?.paymentUnit ?? PAY_PERIODS.HOUR,\n      effectiveDate: currentCompensation?.effectiveDate ?? partnerDefaults?.effectiveDate ?? null,\n    }),\n    [currentCompensation, currentJob, partnerDefaults, primaryFlsaStatus, isAddingSecondaryJob],\n  )\n\n  const formMethods = useForm<CompensationFormData, unknown, CompensationFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const { control, getValues, setValue, clearErrors } = formMethods\n  const watchedFlsaStatus = useWatch({ control, name: 'flsaStatus' })\n  const watchedAdjustForMinimumWage = useWatch({\n    control,\n    name: 'adjustForMinimumWage',\n  })\n\n  // Validation rules for `paymentUnit` and `rate` are FLSA-driven, so any\n  // prior error on those fields is stale once FLSA changes. RHF doesn't clear\n  // them on its own (`setValue` without `shouldValidate` skips the resolver,\n  // and reValidate is per-field) — clear eagerly and let the next blur/submit\n  // re-establish the error if it still applies.\n  useEffect(() => {\n    clearErrors(['paymentUnit', 'rate'])\n    if (watchedFlsaStatus === FlsaStatus.OWNER) {\n      setValue('paymentUnit', PAY_PERIODS.PAYCHECK)\n    } else if (\n      watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_NONEXEMPT ||\n      watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_EXEMPT\n    ) {\n      setValue('paymentUnit', PAY_PERIODS.YEAR)\n      setValue('rate', 0)\n    } else {\n      setValue('paymentUnit', resolvedDefaults.paymentUnit)\n    }\n  }, [watchedFlsaStatus, setValue, clearErrors, resolvedDefaults.paymentUnit])\n\n  // The FLSA status that represents the employee's current classification.\n  // In update mode this is the compensation being edited. In create mode\n  // `currentCompensation` is null, so fall back to the job's active\n  // compensation (identified by currentCompensationUuid) — this lets the\n  // secondary-job warning fire even when scheduling a future-dated change.\n  const currentJobActiveComp = currentJob\n    ? currentJob.compensations?.find(c => c.uuid === currentJob.currentCompensationUuid)\n    : undefined\n  const effectiveBaseFlsaStatus =\n    currentCompensation?.flsaStatus ?? currentJobActiveComp?.flsaStatus ?? null\n\n  // True when the user is changing FLSA away from Nonexempt on a job that has\n  // secondary jobs — those secondaries will be deleted by the API when the\n  // new classification takes effect (immediately in update mode, at the chosen\n  // effective date in create mode). Drives the warning and, in update mode\n  // only, the effectiveDate-lock side effect below.\n  const willDeleteSecondaryJobs =\n    effectiveBaseFlsaStatus === FlsaStatus.NONEXEMPT &&\n    watchedFlsaStatus !== undefined &&\n    watchedFlsaStatus !== FlsaStatus.NONEXEMPT &&\n    otherJobsCount > 0\n\n  // Carve-out UX — update mode only: while willDeleteSecondaryJobs is active\n  // the server deletes secondaries immediately on PUT. Mirror this by forcing\n  // `effectiveDate` to today and disabling the field. In create mode the\n  // deletion happens at the chosen future date, so we show the warning but\n  // leave the date field editable.\n  const carveOutActiveRef = useRef(false)\n  const priorEffectiveDateRef = useRef<string | null>(null)\n  useEffect(() => {\n    if (!isCreateMode && willDeleteSecondaryJobs && !carveOutActiveRef.current) {\n      priorEffectiveDateRef.current = getValues('effectiveDate') ?? null\n      setValue('effectiveDate', todayISO(), { shouldDirty: true, shouldValidate: false })\n      carveOutActiveRef.current = true\n    } else if (!isCreateMode && !willDeleteSecondaryJobs && carveOutActiveRef.current) {\n      setValue('effectiveDate', priorEffectiveDateRef.current ?? null, {\n        shouldDirty: true,\n        shouldValidate: false,\n      })\n      priorEffectiveDateRef.current = null\n      carveOutActiveRef.current = false\n    }\n  }, [isCreateMode, willDeleteSecondaryJobs, getValues, setValue])\n\n  const updateCompensationMutation = useJobsAndCompensationsUpdateCompensationMutation()\n  const createCompensationMutation = useJobsAndCompensationsCreateCompensationMutation()\n\n  const isPending = updateCompensationMutation.isPending || createCompensationMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('CompensationForm')\n\n  const queriesForErrors = employeeId\n    ? [jobsQuery, addressesQuery, employeeQuery, minWagesQuery]\n    : []\n  const errorHandling = composeErrorHandler(queriesForErrors, { submitError, setSubmitError })\n\n  const isCommissionOnly =\n    watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_NONEXEMPT ||\n    watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_EXEMPT\n  const isOwner = watchedFlsaStatus === FlsaStatus.OWNER\n\n  // Hide `Fields.FlsaStatus` when the user has no meaningful choice:\n  // - update mode editing a secondary whose comp is already Nonexempt\n  //   (must keep matching the primary), and\n  // - create mode while adding a secondary (must inherit primary's FLSA).\n  // The first job's create flow and primary-job edits keep the field exposed.\n  const isFlsaSelectionEnabled =\n    !isAddingSecondaryJob &&\n    (watchedFlsaStatus !== FlsaStatus.NONEXEMPT || currentJob?.primary === true || isCreateMode)\n\n  const isAdjustMinimumWageEnabled =\n    watchedFlsaStatus === FlsaStatus.NONEXEMPT &&\n    minimumWages.length > 0 &&\n    state !== undefined &&\n    !TIP_CREDITS_UNSUPPORTED_STATES.includes(state)\n\n  // Min-wage adjustment is only valid for Nonexempt FLSA (and a state that\n  // allows tip credit). When the gate flips off — typically because the user\n  // changed FLSA away from Nonexempt — `Fields.AdjustForMinimumWage` and\n  // `Fields.MinimumWageId` stop rendering, but the underlying form values\n  // persist in react-hook-form state. That would leak an\n  // `adjust_for_minimum_wage: true` + `minimum_wages: [...]` body on submit\n  // (server rejects with \"Minimum wage adjustments only valid for\n  // flsa_status: Nonexempt\"). Reset both values to safe defaults so the\n  // submitted payload always matches what the user can actually see.\n  useEffect(() => {\n    if (isAdjustMinimumWageEnabled) return\n    if (getValues('adjustForMinimumWage')) {\n      setValue('adjustForMinimumWage', false, { shouldDirty: true, shouldValidate: false })\n    }\n    if (getValues('minimumWageId')) {\n      setValue('minimumWageId', '', { shouldDirty: true, shouldValidate: false })\n    }\n    // Both fields stop rendering once the gate closes — clear errors so a\n    // stale one doesn't silently fail the next submit with no visible UI to fix.\n    clearErrors(['adjustForMinimumWage', 'minimumWageId'])\n  }, [isAdjustMinimumWageEnabled, getValues, setValue, clearErrors])\n\n  const minimumWageOptions = minimumWages.map(wage => ({\n    value: wage.uuid,\n    label: `${wage.wage} - ${wage.authority}: ${wage.notes ?? ''}`,\n  }))\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const effectiveDateMinDate = useMemo(\n    () =>\n      [internalMinEffectiveDate, hireDate]\n        .filter((d): d is string => !!d)\n        .reduce<string | null>((max, d) => (!max || d > max ? d : max), null),\n    [internalMinEffectiveDate, hireDate],\n  )\n  const fieldsMetadata = buildCompensationFieldsMetadata(baseMetadata, {\n    willDeleteSecondaryJobs,\n    isCreateMode,\n    isCommissionOnly,\n    isOwner,\n    isAdjustMinimumWageEnabled,\n    effectiveDateMinDate,\n    maximumEffectiveDate,\n    minimumWageOptions,\n    minimumWages,\n  })\n\n  const onSubmit = async (\n    options?: CompensationSubmitOptions,\n  ): Promise<HookSubmitResult<Compensation> | undefined> => {\n    let submitResult: HookSubmitResult<Compensation> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: CompensationFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const resolvedJobId = options?.jobId ?? jobId\n            const resolvedCompensationId = options?.compensationId ?? compensationId\n            const resolvedMode = resolvedCompensationId ? 'update' : 'create'\n\n            // When the field is rendered, the validated payload value wins\n            // unless an explicit submit-time override is supplied. When the\n            // field is hidden (`withEffectiveDateField: false`) we are\n            // strictly options-only — matching `useWorkAddressForm` and the\n            // hidden-field behavior of `useHomeAddressForm` / `useJobForm`.\n            // The carve-out's form-state side effect (force value to today)\n            // is therefore inert in the hidden-field path; partners who\n            // need a specific date there must supply it via\n            // `CompensationSubmitOptions.effectiveDate`.\n            const resolvedEffectiveDate = withEffectiveDateField\n              ? (options?.effectiveDate ?? payload.effectiveDate ?? undefined)\n              : (options?.effectiveDate ?? undefined)\n\n            const requestBodyBase = {\n              rate: String(payload.rate),\n              paymentUnit: payload.paymentUnit,\n              flsaStatus: payload.flsaStatus,\n              effectiveDate: resolvedEffectiveDate,\n              title: payload.title || undefined,\n              adjustForMinimumWage: payload.adjustForMinimumWage,\n              minimumWages: payload.adjustForMinimumWage ? [{ uuid: payload.minimumWageId }] : [],\n            }\n\n            let result: Compensation | undefined\n\n            if (resolvedMode === 'create') {\n              if (!resolvedJobId) {\n                throw new SDKInternalError(\n                  'jobId is required to create a compensation. Pass it as a hook prop or via submit options.',\n                )\n              }\n              // Schema's `requiredFieldsConfig` guarantees `flsaStatus` is set\n              // on create-mode submit; the runtime guard appeases the API\n              // request-body type (which requires a non-undefined value on\n              // POST, vs. the optional PUT body).\n              if (!payload.flsaStatus) {\n                throw new SDKInternalError('flsaStatus is required to create a compensation.')\n              }\n              const createResponse = await createCompensationMutation.mutateAsync({\n                request: {\n                  jobId: resolvedJobId,\n                  compensationsRequestBody: { ...requestBodyBase, flsaStatus: payload.flsaStatus },\n                },\n              })\n              result = createResponse.compensation\n              if (!result) throw new SDKInternalError('Compensation creation failed')\n            } else {\n              if (!resolvedCompensationId) {\n                throw new SDKInternalError(\n                  'compensationId is required to update a compensation. Pass it as a hook prop or via submit options.',\n                )\n              }\n              const resolvedVersion =\n                options?.compensationVersion ?? (currentCompensation?.version as string | undefined)\n              if (!resolvedVersion) {\n                throw new SDKInternalError(\n                  'compensation version is required to update a compensation. Pass it via submit options when threading post-create, or ensure the compensation is loaded.',\n                )\n              }\n              const updateResponse = await updateCompensationMutation.mutateAsync({\n                request: {\n                  compensationId: resolvedCompensationId,\n                  compensationsUpdateRequestBody: {\n                    version: resolvedVersion,\n                    ...requestBodyBase,\n                  },\n                },\n              })\n              result = updateResponse.compensation\n              if (!result) throw new SDKInternalError('Compensation update failed')\n            }\n\n            submitResult = { mode: resolvedMode, data: result }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const isDataLoading = employeeId\n    ? jobsQuery.isLoading ||\n      addressesQuery.isLoading ||\n      employeeQuery.isLoading ||\n      minWagesQuery.isLoading\n    : false\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (isDataLoading || (employeeId && (!employeeJobs || !employee))) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      compensation: currentCompensation,\n      currentJob,\n      minimumWages,\n      minimumEffectiveDate: effectiveDateMinDate,\n      maximumEffectiveDate,\n      hasPendingFutureCompensation,\n    },\n    status: {\n      isPending,\n      mode,\n      willDeleteSecondaryJobs,\n      showCommissionFederalMinimumPayAlert: watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_EXEMPT,\n      showCommissionMinimumWageAlert: watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_NONEXEMPT,\n      showOwnerSalaryAlert: watchedFlsaStatus === FlsaStatus.OWNER,\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Title: TitleField,\n        FlsaStatus: isFlsaSelectionEnabled ? FlsaStatusField : undefined,\n        Rate: isCommissionOnly ? undefined : RateField,\n        PaymentUnit: isCommissionOnly ? undefined : PaymentUnitField,\n        AdjustForMinimumWage: isAdjustMinimumWageEnabled ? AdjustForMinimumWageField : undefined,\n        MinimumWageId:\n          isAdjustMinimumWageEnabled && watchedAdjustForMinimumWage\n            ? MinimumWageIdField\n            : undefined,\n        EffectiveDate: withEffectiveDateField ? EffectiveDateField : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Discriminated union returned by {@link useCompensationForm} — either the loading state or the ready state.\n *\n * @remarks\n * Use this type when threading the hook result through helpers (e.g.\n * presentational components). Discriminate on `isLoading` to narrow to\n * {@link UseCompensationFormReady}.\n *\n * @public\n */\nexport type UseCompensationFormResult = HookLoadingResult | UseCompensationFormReady\n\n/**\n * Metadata for each {@link useCompensationForm} field, exposed on `form.fieldsMetadata`.\n *\n * @remarks\n * Includes per-field `isDisabled`, `isRequired`, and the dynamic option list\n * for select fields (`flsaStatus`, `paymentUnit`, `minimumWageId`).\n * `effectiveDate` additionally carries `minDate` / `maxDate` derived from\n * the parent job's hire date and any pending future compensation.\n *\n * @public\n */\nexport type CompensationFieldsMetadata = ReturnType<typeof buildCompensationFieldsMetadata>\n"],"names":["resolveCompAndJob","jobs","compensationId","jobId","job","compensation","c","j","findPrimaryFlsaStatus","findFutureCompensations","today","todayISO","earliestEffectiveDate","comps","min","d","flsaStatusEntries","FlsaStatus","flsaOptions","status","paymentUnitEntries","PAY_PERIODS","paymentUnitOptions","unit","buildCompensationFieldsMetadata","base","willDeleteSecondaryJobs","isCreateMode","isCommissionOnly","isOwner","isAdjustMinimumWageEnabled","effectiveDateMinDate","maximumEffectiveDate","minimumWageOptions","minimumWages","withFlags","withOptions","useCompensationForm","employeeId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","withEffectiveDateField","jobsQuery","useJobsAndCompensationsGetJobs","GetV1EmployeesEmployeeIdJobsQueryParamInclude","addressesQuery","useEmployeeAddressesGetWorkAddresses","employeeQuery","useEmployeesGet","employeeJobs","currentWorkAddress","address","locationUuid","employee","minWagesQuery","useLocationsGetMinimumWages","currentCompensation","currentJob","otherJobsCount","hadPrimaryAtMountRef","useRef","primaryFlsaStatus","hireDate","futureCompensations","hasPendingFutureCompensation","mode","isAddingSecondaryJob","internalMinEffectiveDate","useMemo","formatDateToStringDate","addDays","schema","metadataConfig","createCompensationSchema","state","resolvedDefaults","formMethods","useForm","zodResolver","control","getValues","setValue","clearErrors","watchedFlsaStatus","useWatch","watchedAdjustForMinimumWage","useEffect","currentJobActiveComp","carveOutActiveRef","priorEffectiveDateRef","updateCompensationMutation","useJobsAndCompensationsUpdateCompensationMutation","createCompensationMutation","useJobsAndCompensationsCreateCompensationMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","isFlsaSelectionEnabled","TIP_CREDITS_UNSUPPORTED_STATES","wage","baseMetadata","useDeriveFieldsMetadata","max","fieldsMetadata","onSubmit","options","submitResult","resolve","data","payload","resolvedJobId","resolvedCompensationId","resolvedMode","resolvedEffectiveDate","requestBodyBase","result","SDKInternalError","resolvedVersion","isDataLoading","hookFormInternals","useHookFormInternals","TitleField","FlsaStatusField","RateField","PaymentUnitField","AdjustForMinimumWageField","MinimumWageIdField","EffectiveDateField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"useCompensationForm.js","sources":["../../../../../../src/components/Employee/Compensation/shared/useCompensationForm/useCompensationForm.tsx"],"sourcesContent":["import { useEffect, useMemo, useRef } from 'react'\nimport type { ComponentType } from 'react'\nimport { useForm, useWatch } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Compensation, PaymentUnit } from '@gusto/embedded-api/models/components/compensation'\nimport type { Job } from '@gusto/embedded-api/models/components/job'\nimport type { FlsaStatusType } from '@gusto/embedded-api/models/components/flsastatustype'\nimport type { MinimumWage } from '@gusto/embedded-api/models/components/minimumwage'\nimport { useJobsAndCompensationsGetJobs } from '@gusto/embedded-api/react-query/jobsAndCompensationsGetJobs'\nimport { GetV1EmployeesEmployeeIdJobsQueryParamInclude } from '@gusto/embedded-api/models/operations/getv1employeesemployeeidjobs'\nimport { useJobsAndCompensationsCreateCompensationMutation } from '@gusto/embedded-api/react-query/jobsAndCompensationsCreateCompensation'\nimport { useJobsAndCompensationsUpdateCompensationMutation } from '@gusto/embedded-api/react-query/jobsAndCompensationsUpdateCompensation'\nimport { useLocationsGetMinimumWages } from '@gusto/embedded-api/react-query/locationsGetMinimumWages'\nimport { useEmployeeAddressesGetWorkAddresses } from '@gusto/embedded-api/react-query/employeeAddressesGetWorkAddresses'\nimport { useEmployeesGet } from '@gusto/embedded-api/react-query/employeesGet'\nimport {\n  createCompensationSchema,\n  type CompensationOptionalFieldsToRequire,\n  type CompensationFormData,\n  type CompensationFormOutputs,\n} from './compensationSchema'\nimport {\n  TitleField,\n  FlsaStatusField,\n  RateField,\n  PaymentUnitField,\n  AdjustForMinimumWageField,\n  MinimumWageIdField,\n  EffectiveDateField,\n} from './fields'\nimport type {\n  TitleFieldProps,\n  FlsaStatusFieldProps,\n  RateFieldProps,\n  PaymentUnitFieldProps,\n  AdjustForMinimumWageFieldProps,\n  MinimumWageIdFieldProps,\n  EffectiveDateFieldProps,\n} from './fields'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { withFlags } from '@/partner-hook-utils/form/withFlags'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldMetadata,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { FlsaStatus, PAY_PERIODS, TIP_CREDITS_UNSUPPORTED_STATES } from '@/shared/constants'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { addDays, formatDateToStringDate } from '@/helpers/dateFormatting'\n\n/**\n * Optional values supplied to {@link useCompensationForm}'s `actions.onSubmit` at submit time.\n *\n * @remarks\n * Use these to override hook-construction props when an ID isn't known at\n * mount — most commonly the **onboarding stub-fill** chain, where `useJobForm`\n * creates the parent job and returns the auto-created stub compensation, and\n * the IDs and version are threaded into this hook's `onSubmit` to PUT the\n * stub.\n *\n * @public\n */\nexport interface CompensationSubmitOptions {\n  /** Override jobId — required when creating a compensation if not configured at hook construction (e.g. when the parent job was just created in the same submit chain). */\n  jobId?: string\n  /** Override compensationId — when present, forces update (PUT) routing regardless of hook construction. */\n  compensationId?: string\n  /**\n   * Compensation version for optimistic locking on PUT. Required when forcing\n   * update routing post-create (e.g. updating the auto-created stub returned\n   * from `POST /v1/employees/:id/jobs`). When omitted, the hook reads the\n   * version from its cached `currentCompensation`.\n   */\n  compensationVersion?: string\n  /**\n   * Supply `effectiveDate` at submit time. When `withEffectiveDateField`\n   * is `true`, this overrides the form's value. When `withEffectiveDateField`\n   * is `false`, this is the only way to put `effective_date` on the wire —\n   * the form value is not read in that mode (matching the options-only\n   * convention of `useWorkAddressForm` / `useHomeAddressForm` / `useJobForm`).\n   */\n  effectiveDate?: string\n}\n\n/**\n * Configuration options for {@link useCompensationForm}.\n *\n * @remarks\n * Presence or absence of `compensationId` selects the API verb — see the\n * `compensationId` field description. `employeeId` is optional so the hook\n * can be composed alongside an employee-creation step. `jobId` is optional in\n * update mode (derived from the loaded compensation) and required in create\n * mode (scopes the POST); supply it at submit time via\n * {@link CompensationSubmitOptions.jobId} when the parent job is created in\n * the same submit chain.\n *\n * @public\n */\nexport interface UseCompensationFormProps {\n  /** UUID of the employee whose compensation is being created or edited. Drives data fetching for derived helpers (jobs list, work address, minimum wages). May be omitted when composing alongside an employee-creation step. */\n  employeeId?: string\n  /** The parent job's UUID. Required in create mode (scopes `POST /v1/jobs/:jobId/compensations`). Optional in update mode — the parent job is derived from the loaded compensation. */\n  jobId?: string\n  /** Present → update mode (PUT /v1/compensations/:id). Omitted → create mode (POST /v1/jobs/:jobId/compensations). */\n  compensationId?: string\n  /** Override fields that are optional on a given mode to be required. See {@link CompensationOptionalFieldsToRequire}. */\n  optionalFieldsToRequire?: CompensationOptionalFieldsToRequire\n  /** Pre-fill form values. Server data takes precedence on update mode. */\n  defaultValues?: Partial<CompensationFormData>\n  /** Passed through to react-hook-form. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Auto-focus the first invalid field on submit. Set to `false` when using `composeSubmitHandler` so submit-time focus is coordinated across multiple forms. Defaults to `true`. */\n  shouldFocusError?: boolean\n  /**\n   * When `false`, hides `Fields.EffectiveDate` (becomes `undefined`) and\n   * removes `effectiveDate` from schema validation. In this mode the hook\n   * does not read any form value at submit time — `effective_date` is\n   * omitted from the request body unless explicitly supplied via\n   * {@link CompensationSubmitOptions.effectiveDate}. This matches the\n   * options-only convention of other form hooks, and means the\n   * `willDeleteSecondaryJobs` carve-out's form-state side effects do not\n   * leak onto the wire (there is no field to render them in anyway).\n   * Defaults to `true`.\n   */\n  withEffectiveDateField?: boolean\n}\n\n/**\n * Pre-bound field components exposed on `useCompensationForm().form.Fields`.\n *\n * @remarks\n * Each property is either the field component or `undefined`. A field is\n * `undefined` when conditions for rendering it aren't met — see each member\n * for its visibility rule. Always null-check conditional fields (e.g.\n * `{Fields.FlsaStatus && <Fields.FlsaStatus ... />}`) before rendering.\n *\n * @public\n */\nexport interface CompensationFormFields {\n  /** Bound to `title`. Title text input. Always available. Optional in both modes unless `optionalFieldsToRequire` requires it. */\n  Title: ComponentType<TitleFieldProps>\n  /** Bound to `flsaStatus`. FLSA classification select. `undefined` when the status is not user-editable (e.g. secondary jobs that must match the primary). */\n  FlsaStatus: ComponentType<FlsaStatusFieldProps> | undefined\n  /** Bound to `rate`. Compensation amount input. `undefined` for commission-only FLSA statuses, which don't accept a partner-supplied rate. */\n  Rate: ComponentType<RateFieldProps> | undefined\n  /** Bound to `paymentUnit`. Payment unit select. `undefined` for commission-only FLSA statuses (the hook forces `paymentUnit=Year`). */\n  PaymentUnit: ComponentType<PaymentUnitFieldProps> | undefined\n  /** Bound to `adjustForMinimumWage`. Minimum-wage adjustment checkbox. `undefined` unless `flsaStatus === Nonexempt`, the employee's work location has minimum wages, and the state supports tip credits. */\n  AdjustForMinimumWage: ComponentType<AdjustForMinimumWageFieldProps> | undefined\n  /** Bound to `minimumWageId`. Minimum-wage selection. `undefined` unless `Fields.AdjustForMinimumWage` is rendered and checked. */\n  MinimumWageId: ComponentType<MinimumWageIdFieldProps> | undefined\n  /** Bound to `effectiveDate`. Effective-date picker. `undefined` when `withEffectiveDateField: false`; supply the value via `CompensationSubmitOptions.effectiveDate` in that mode. */\n  EffectiveDate: ComponentType<EffectiveDateFieldProps> | undefined\n}\n\n/**\n * Ready-state shape returned by {@link useCompensationForm} once data has loaded.\n *\n * @remarks\n * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with\n * the compensation-specific `data`, `status`, `actions`, and `form.Fields`\n * shape. Static, entity-derived values live under `data.*`; reactive values\n * that flip with form input live under `status.*`.\n *\n * @public\n */\nexport interface UseCompensationFormReady extends BaseFormHookReady<\n  CompensationFieldsMetadata,\n  CompensationFormData,\n  CompensationFormFields\n> {\n  /** Compensation-specific data payload: the loaded compensation, the parent job, available minimum wages, and effective-date bounds. */\n  data: {\n    /** The compensation row loaded for update; `null` in create mode. */\n    compensation: Compensation | null\n    /** The parent job. In update mode it's derived from the loaded compensation; in create mode it's looked up by `jobId`. `null` if neither resolves. */\n    currentJob: Job | null\n    /** Minimum wages available at the employee's active work location. Empty when no location is set or no minimums are defined. */\n    minimumWages: MinimumWage[]\n    /** Lower bound for `effectiveDate` (typically the parent job's hire date). */\n    minimumEffectiveDate: string | null\n    /** Upper bound for `effectiveDate` — the next scheduled future compensation's effective date, when one exists. */\n    maximumEffectiveDate: string | null\n    /** True when at least one future-dated compensation already exists for this job. */\n    hasPendingFutureCompensation: boolean\n  }\n  /** Submission state and reactive flags derived from current form input. `isPending` is `true` while a create/update mutation is in flight; `mode` reflects whether the next submit will create or update; the `show*Alert` flags drive FLSA-specific inline warnings. */\n  status: {\n    /** `true` while a create or update mutation is in flight. */\n    isPending: boolean\n    /** Reflects whether the next submit will POST a new compensation or PUT an existing one. */\n    mode: 'create' | 'update'\n    /**\n     * True when submitting the form right now would delete the employee's\n     * secondary jobs server-side (the \"carve-out\" branch). Reactive:\n     * derived from the current `flsaStatus` form value, the loaded\n     * compensation, and the other-jobs count, so this flips as you change\n     * inputs.\n     *\n     * Conditions: update mode, the loaded compensation is Nonexempt, the\n     * form's `flsaStatus` has been changed to a non-Nonexempt value, and\n     * the employee has at least one secondary job.\n     *\n     * While this flag is true the hook also takes the `effectiveDate`\n     * field over: it forces the form value to today (so submits route\n     * through a PUT that immediately deletes secondaries) and exposes\n     * `fieldsMetadata.effectiveDate.isDisabled = true` so `Fields.EffectiveDate`\n     * renders as disabled. On revert (FLSA back to Nonexempt) the prior\n     * `effectiveDate` is restored. Render an inline warning keyed off\n     * this flag — no separate confirmation step is needed.\n     */\n    willDeleteSecondaryJobs: boolean\n    /**\n     * True when the current `flsaStatus` is `COMMISSION_ONLY_EXEMPT`\n     * (Commission Only/No Overtime). Render the federal-minimum-pay\n     * warning alert when this flag is true. While this flag is true,\n     * `Fields.Rate` and `Fields.PaymentUnit` are also `undefined` (the\n     * hook forces `rate=0`, `paymentUnit=YEAR` on the form values).\n     */\n    showCommissionFederalMinimumPayAlert: boolean\n    /**\n     * True when the current `flsaStatus` is `COMMISSION_ONLY_NONEXEMPT`\n     * (Commission Only/Eligible for overtime). Render the local-minimum-wage\n     * warning alert when this flag is true. While this flag is true,\n     * `Fields.Rate` and `Fields.PaymentUnit` are also `undefined` (the\n     * hook forces `rate=0`, `paymentUnit=YEAR` on the form values).\n     */\n    showCommissionMinimumWageAlert: boolean\n    /**\n     * True when the current `flsaStatus` is `OWNER` (Owner's draw). Render\n     * an informational alert noting that the IRS requires S-corp owners to\n     * pay themselves a reasonable salary for similar work before taking\n     * distributions.\n     */\n    showOwnerSalaryAlert: boolean\n  }\n  /** Submit actions exposed by the hook. */\n  actions: {\n    /** Validates the form, runs the appropriate create/update mutation, and resolves to a {@link HookSubmitResult} containing the saved compensation. Resolves to `undefined` on validation failure or mutation error. Accepts {@link CompensationSubmitOptions} for threading IDs/version into the onboarding stub-fill chain. */\n    onSubmit: (\n      options?: CompensationSubmitOptions,\n    ) => Promise<HookSubmitResult<Compensation> | undefined>\n  }\n}\n\nfunction resolveCompAndJob(\n  jobs: Job[] | undefined,\n  compensationId: string | undefined,\n  jobId: string | undefined,\n): { compensation: Compensation | null; job: Job | null } {\n  if (!jobs) return { compensation: null, job: null }\n  if (compensationId) {\n    for (const job of jobs) {\n      const compensation = job.compensations?.find(c => c.uuid === compensationId)\n      if (compensation) return { compensation, job }\n    }\n    // If the comp isn't in any job's compensations list, still try to resolve\n    // the job by jobId so callers can check job metadata (e.g. job.primary).\n    const fallbackJob = jobId ? (jobs.find(j => j.uuid === jobId) ?? null) : null\n    return { compensation: null, job: fallbackJob }\n  }\n  if (jobId) return { compensation: null, job: jobs.find(j => j.uuid === jobId) ?? null }\n  return { compensation: null, job: null }\n}\n\nfunction findPrimaryFlsaStatus(jobs: Job[] | undefined): FlsaStatusType | null {\n  if (!jobs) return null\n  for (const job of jobs) {\n    if (!job.primary) continue\n    const compensation = job.compensations?.find(c => c.uuid === job.currentCompensationUuid)\n    if (compensation?.flsaStatus) return compensation.flsaStatus\n  }\n  return null\n}\n\nfunction findFutureCompensations(job: Job | null): Compensation[] {\n  if (!job?.compensations) return []\n  const today = todayISO()\n  return job.compensations.filter(c => c.effectiveDate !== undefined && c.effectiveDate > today)\n}\n\nfunction earliestEffectiveDate(comps: Compensation[]): string | null {\n  if (comps.length === 0) return null\n  return comps.reduce<string | null>((min, c) => {\n    const d = c.effectiveDate\n    if (!d) return min\n    if (!min || d < min) return d\n    return min\n  }, null)\n}\n\nconst flsaStatusEntries: FlsaStatusType[] = [\n  FlsaStatus.EXEMPT,\n  FlsaStatus.SALARIED_NONEXEMPT,\n  FlsaStatus.NONEXEMPT,\n  FlsaStatus.OWNER,\n  FlsaStatus.COMMISSION_ONLY_EXEMPT,\n  FlsaStatus.COMMISSION_ONLY_NONEXEMPT,\n]\n\nconst flsaOptions = flsaStatusEntries.map(status => ({ value: status, label: status }))\n\nconst paymentUnitEntries: PaymentUnit[] = [\n  PAY_PERIODS.HOUR,\n  PAY_PERIODS.WEEK,\n  PAY_PERIODS.MONTH,\n  PAY_PERIODS.YEAR,\n  PAY_PERIODS.PAYCHECK,\n]\n\nconst paymentUnitOptions = paymentUnitEntries.map(unit => ({ value: unit, label: unit }))\n\nfunction todayISO(): string {\n  return new Date().toISOString().split('T')[0]!\n}\n\n/** @internal */\nfunction buildCompensationFieldsMetadata(\n  base: Record<keyof CompensationFormData, FieldMetadata>,\n  {\n    willDeleteSecondaryJobs,\n    isCreateMode,\n    isCommissionOnly,\n    isOwner,\n    isAdjustMinimumWageEnabled,\n    effectiveDateMinDate,\n    maximumEffectiveDate,\n    minimumWageOptions,\n    minimumWages,\n  }: {\n    willDeleteSecondaryJobs: boolean\n    isCreateMode: boolean\n    isCommissionOnly: boolean\n    isOwner: boolean\n    isAdjustMinimumWageEnabled: boolean\n    effectiveDateMinDate: string | null\n    maximumEffectiveDate: string | null\n    minimumWageOptions: { value: string; label: string }[]\n    minimumWages: MinimumWage[]\n  },\n) {\n  return {\n    title: base.title,\n    effectiveDate: withFlags(base.effectiveDate, {\n      isDisabled: willDeleteSecondaryJobs && !isCreateMode,\n      minDate: effectiveDateMinDate,\n      maxDate: maximumEffectiveDate,\n    }),\n    flsaStatus: withOptions<FlsaStatusType>(base.flsaStatus, flsaOptions, flsaStatusEntries),\n    rate: withFlags(base.rate, { isDisabled: isCommissionOnly }),\n    paymentUnit: withOptions<PaymentUnit>(\n      withFlags(base.paymentUnit, { isDisabled: isOwner || isCommissionOnly }),\n      paymentUnitOptions,\n      paymentUnitEntries,\n    ),\n    adjustForMinimumWage: withFlags(base.adjustForMinimumWage, {\n      isDisabled: !isAdjustMinimumWageEnabled,\n    }),\n    minimumWageId: withOptions<MinimumWage>(base.minimumWageId, minimumWageOptions, minimumWages),\n  } satisfies FieldsMetadata\n}\n\n/**\n * Headless hook for creating or updating a compensation row on a job — FLSA classification, pay rate, payment unit, effective date, and optional minimum-wage adjustment.\n *\n * @remarks\n * Companion hook to `useJobForm`. Jobs and their compensations are separate\n * entities in the Gusto API and this hook focuses exclusively on the\n * compensation side. Presence of `compensationId` selects the verb:\n *\n * | Hook config / submit options | Mode | API call |\n * | ---------------------------- | ---- | -------- |\n * | `{ jobId, compensationId }` | update | `PUT /v1/compensations/:compensationId` (with `version`) |\n * | `{ jobId }` (no `compensationId`) | create | `POST /v1/jobs/:jobId/compensations` |\n * | `{ employeeId }` + submit `{ jobId, compensationId, compensationVersion }` | update | `PUT /v1/compensations/:compensationId` (with the supplied `version`) |\n * | `{ employeeId }` + submit `{ jobId }` (no `compensationId`) | create | `POST /v1/jobs/:options.jobId/compensations` |\n *\n * Use the submit-options form for the **onboarding stub-fill** chain: after\n * `useJobForm.actions.onSubmit()` creates a job, capture the auto-created\n * compensation's UUID and version from the response, and pass them as\n * `{ jobId, compensationId, compensationVersion }` to this hook's `onSubmit`\n * to PUT the stub.\n *\n * The hook exposes several derived helpers for driving UX — static\n * entity-derived values under `data.*` (effective-date bounds, pending\n * future compensations) and reactive flags under `status.*` (the\n * `willDeleteSecondaryJobs` carve-out, plus FLSA-specific alerts for\n * commission-only and owner classifications). When\n * `willDeleteSecondaryJobs` is `true` in update mode, the hook also locks\n * the `effectiveDate` field (forces to today, renders disabled) until the\n * FLSA selection is reverted.\n *\n * @param input - {@link UseCompensationFormProps} — `employeeId`, `jobId`, `compensationId` (toggle create/update), required-field overrides, default values, and which fields the hook renders.\n * @returns A {@link HookLoadingResult} while data is loading, or a {@link UseCompensationFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import { useCompensationForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n *\n * function CompensationForm({ employeeId, jobId }: { employeeId: string; jobId: string }) {\n *   const comp = useCompensationForm({ employeeId, jobId })\n *   if (comp.isLoading) return null\n *\n *   const { Fields } = comp.form\n *   return (\n *     <form onSubmit={e => { e.preventDefault(); comp.actions.onSubmit() }}>\n *       <SDKFormProvider formHookResult={comp}>\n *         {Fields.FlsaStatus && <Fields.FlsaStatus label=\"Employee type\" />}\n *         <Fields.Rate label=\"Compensation amount\" />\n *         <Fields.PaymentUnit label=\"Payment unit\" />\n *         {Fields.EffectiveDate && <Fields.EffectiveDate label=\"Effective date\" />}\n *       </SDKFormProvider>\n *       {comp.status.willDeleteSecondaryJobs && (\n *         <p>Saving will remove this employee's secondary jobs.</p>\n *       )}\n *       <button type=\"submit\" disabled={comp.status.isPending}>Save</button>\n *     </form>\n *   )\n * }\n * ```\n */\nexport function useCompensationForm({\n  employeeId,\n  jobId,\n  compensationId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n  withEffectiveDateField = true,\n}: UseCompensationFormProps): HookLoadingResult | UseCompensationFormReady {\n  const jobsQuery = useJobsAndCompensationsGetJobs(\n    {\n      employeeId: employeeId ?? '',\n      // Fetch all effective-dated compensations when editing an existing one so\n      // resolveCompAndJob can find the target comp (future-dated comps are\n      // omitted from the default response, which only returns the current comp).\n      include: compensationId\n        ? GetV1EmployeesEmployeeIdJobsQueryParamInclude.AllCompensations\n        : undefined,\n    },\n    { enabled: !!employeeId },\n  )\n  const addressesQuery = useEmployeeAddressesGetWorkAddresses(\n    { employeeId: employeeId ?? '' },\n    { enabled: !!employeeId },\n  )\n  const employeeQuery = useEmployeesGet({ employeeId: employeeId ?? '' }, { enabled: !!employeeId })\n\n  const employeeJobs = jobsQuery.data?.jobs\n  const workAddresses = addressesQuery.data?.employeeWorkAddressesList\n  const currentWorkAddress = workAddresses?.find(address => address.active)\n  const locationUuid = currentWorkAddress?.locationUuid\n  const employee = employeeQuery.data?.employee\n\n  const minWagesQuery = useLocationsGetMinimumWages(\n    { locationUuid: locationUuid ?? '' },\n    { enabled: !!locationUuid, staleTime: Infinity },\n  )\n\n  const minimumWages = minWagesQuery.data?.minimumWageList ?? []\n\n  const { compensation: currentCompensation, job: currentJob } = resolveCompAndJob(\n    employeeJobs,\n    compensationId,\n    jobId,\n  )\n\n  const otherJobsCount =\n    employeeJobs && currentJob ? employeeJobs.filter(j => j.uuid !== currentJob.uuid).length : 0\n\n  // Snapshot — written exactly once, on the first render where `employeeJobs`\n  // is defined (i.e., the initial `getJobs` query has resolved) — capturing\n  // whether the employee already had a primary job at that moment.\n  //\n  // Used to ignore the API-generated stub primary (FLSA Nonexempt, rate \"0.00\")\n  // that briefly appears between the chained job POST and comp PUT during\n  // onboarding: `getJobs` invalidates between the two mutations and\n  // momentarily includes the stub, which would otherwise flip\n  // `isAddingSecondaryJob` to true and hide `Fields.FlsaStatus` mid-submit.\n  //\n  // In steady-state flows (edit primary, edit secondary, add secondary), the\n  // real primary already exists when the query first resolves, so the snapshot\n  // is `true` and live `employeeJobs` continues to drive `primaryFlsaStatus`.\n  // Recovery for the rare case where a partner mounts before any jobs exist\n  // and a primary is created externally mid-form is to remount the hook\n  // (e.g., via a `key` change).\n  const hadPrimaryAtMountRef = useRef<boolean | null>(null)\n  if (hadPrimaryAtMountRef.current === null && employeeJobs !== undefined) {\n    hadPrimaryAtMountRef.current = employeeJobs.some(job => job.primary)\n  }\n  const hadPrimaryAtMount = hadPrimaryAtMountRef.current === true\n\n  // FLSA status of the employee's primary job's current compensation, when one\n  // exists. Used as a fallback default when adding a *secondary* job/comp so the\n  // multi-job classification stays consistent with the primary by default — the\n  // user can still override it (when allowed). Null when there was no primary\n  // job at the moment the hook first observed `employeeJobs`, or when the\n  // primary has no current compensation yet.\n  const primaryFlsaStatus = hadPrimaryAtMount ? findPrimaryFlsaStatus(employeeJobs) : null\n\n  const hireDate =\n    currentJob?.hireDate ??\n    // Secondary jobs being created (CompensationAddAnotherJobForm) have no hireDate until the\n    // job POST completes. Fall back to the primary job's hireDate so the schema\n    // can enforce EFFECTIVE_DATE_BEFORE_HIRE during that window.\n    employeeJobs?.find(j => j.primary)?.hireDate ??\n    null\n\n  // In update mode, exclude the compensation being edited so it doesn't\n  // bound `maximumEffectiveDate` to its own current date — that would prevent\n  // the user from pushing the pending effective date further out.\n  const futureCompensations = findFutureCompensations(currentJob).filter(\n    c => c.uuid !== compensationId,\n  )\n  const hasPendingFutureCompensation = futureCompensations.length > 0\n  const maximumEffectiveDate = earliestEffectiveDate(futureCompensations)\n\n  const isCreateMode = !compensationId\n  const mode = isCreateMode ? 'create' : 'update'\n  // Adding a secondary job (the employee already has a primary). The Gusto API\n  // only allows secondaries when the primary's current FLSA is Nonexempt, and\n  // the secondary itself must match — so the FLSA field is not user-editable\n  // in this branch. We force the form value to the primary's FLSA below and\n  // hide `Fields.FlsaStatus`.\n  // True when adding a brand-new secondary job (not when scheduling a future\n  // comp for the primary). The distinction matters: for the primary's future\n  // comp, FLSA should be editable; for a secondary, it must match the primary.\n  const isAddingSecondaryJob =\n    isCreateMode && primaryFlsaStatus === FlsaStatus.NONEXEMPT && currentJob?.primary !== true\n\n  // Derive the effective-date floor internally so consumers don't need to wire\n  // it up. Rules by mode and job type:\n  //   create (any job): tomorrow — new comp must be future-dated\n  //   update, primary: undefined — the carve-out (willDeleteSecondaryJobs) can\n  //     force effectiveDate to today on a disabled field; enforcing a floor here\n  //     would produce a spurious EFFECTIVE_DATE_BEFORE_MIN on submit.\n  //   update, secondary: tomorrow — must be in the future\n  // The hire-date lower bound is handled separately in the schema via the\n  // `hireDate` option (→ EFFECTIVE_DATE_BEFORE_HIRE), which fires alongside\n  // this check so each violation gets its own error message.\n  const internalMinEffectiveDate = useMemo(() => {\n    if (!withEffectiveDateField) return undefined\n    if (!isCreateMode && currentJob?.primary === true) return undefined\n\n    return formatDateToStringDate(addDays(new Date(), 1)) ?? undefined\n  }, [isCreateMode, currentJob?.primary, withEffectiveDateField])\n\n  const [schema, metadataConfig] = useMemo(\n    () =>\n      createCompensationSchema({\n        mode,\n        optionalFieldsToRequire,\n        hireDate,\n        minEffectiveDate: internalMinEffectiveDate,\n        withEffectiveDateField,\n      }),\n    [mode, optionalFieldsToRequire, hireDate, internalMinEffectiveDate, withEffectiveDateField],\n  )\n\n  const state = currentWorkAddress?.state\n\n  // `flsaStatus` is intentionally allowed to be undefined so the field renders\n  // an empty placeholder when nothing is provided — partners can choose to\n  // seed it via `defaultValues.flsaStatus`. When a `compensation` is loaded we\n  // seed from it; for a brand-new secondary job we inherit from the primary's\n  // current compensation so multi-job classification stays consistent. The\n  // schema enforces requiredness on submit in `create` mode (see\n  // `requiredFieldsConfig` in compensationSchema.ts).\n  //\n  // `title` lives on compensation in the API — `job.title` is a denormalized\n  // snapshot of the primary comp's title that can lag behind comp-level edits\n  // on secondaries. Seed directly from the loaded compensation so editing in\n  // place can't silently re-introduce a stale title from the job record.\n  const resolvedDefaults: CompensationFormData = useMemo(\n    () => ({\n      title: currentCompensation?.title ?? partnerDefaults?.title ?? '',\n      // When adding a secondary, the FLSA must match the primary's — force it\n      // here (overriding any partner default) so the form submits the right\n      // value even though `Fields.FlsaStatus` is hidden.\n      flsaStatus: isAddingSecondaryJob\n        ? primaryFlsaStatus\n        : (currentCompensation?.flsaStatus ??\n          partnerDefaults?.flsaStatus ??\n          primaryFlsaStatus ??\n          undefined),\n      rate: Number(currentCompensation?.rate ?? partnerDefaults?.rate ?? 0),\n      adjustForMinimumWage:\n        currentCompensation?.adjustForMinimumWage ?? partnerDefaults?.adjustForMinimumWage ?? false,\n      minimumWageId:\n        currentCompensation?.minimumWages?.[0]?.uuid ?? partnerDefaults?.minimumWageId ?? '',\n      paymentUnit:\n        currentCompensation?.paymentUnit ?? partnerDefaults?.paymentUnit ?? PAY_PERIODS.HOUR,\n      effectiveDate: currentCompensation?.effectiveDate ?? partnerDefaults?.effectiveDate ?? null,\n    }),\n    [currentCompensation, currentJob, partnerDefaults, primaryFlsaStatus, isAddingSecondaryJob],\n  )\n\n  const formMethods = useForm<CompensationFormData, unknown, CompensationFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const { control, getValues, setValue, clearErrors } = formMethods\n  const watchedFlsaStatus = useWatch({ control, name: 'flsaStatus' })\n  const watchedAdjustForMinimumWage = useWatch({\n    control,\n    name: 'adjustForMinimumWage',\n  })\n\n  // Validation rules for `paymentUnit` and `rate` are FLSA-driven, so any\n  // prior error on those fields is stale once FLSA changes. RHF doesn't clear\n  // them on its own (`setValue` without `shouldValidate` skips the resolver,\n  // and reValidate is per-field) — clear eagerly and let the next blur/submit\n  // re-establish the error if it still applies.\n  useEffect(() => {\n    clearErrors(['paymentUnit', 'rate'])\n    if (watchedFlsaStatus === FlsaStatus.OWNER) {\n      setValue('paymentUnit', PAY_PERIODS.PAYCHECK)\n    } else if (\n      watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_NONEXEMPT ||\n      watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_EXEMPT\n    ) {\n      setValue('paymentUnit', PAY_PERIODS.YEAR)\n      setValue('rate', 0)\n    } else {\n      setValue('paymentUnit', resolvedDefaults.paymentUnit)\n    }\n  }, [watchedFlsaStatus, setValue, clearErrors, resolvedDefaults.paymentUnit])\n\n  // The FLSA status that represents the employee's current classification.\n  // In update mode this is the compensation being edited. In create mode\n  // `currentCompensation` is null, so fall back to the job's active\n  // compensation (identified by currentCompensationUuid) — this lets the\n  // secondary-job warning fire even when scheduling a future-dated change.\n  const currentJobActiveComp = currentJob\n    ? currentJob.compensations?.find(c => c.uuid === currentJob.currentCompensationUuid)\n    : undefined\n  const effectiveBaseFlsaStatus =\n    currentCompensation?.flsaStatus ?? currentJobActiveComp?.flsaStatus ?? null\n\n  // True when the user is changing FLSA away from Nonexempt on a job that has\n  // secondary jobs — those secondaries will be deleted by the API when the\n  // new classification takes effect (immediately in update mode, at the chosen\n  // effective date in create mode). Drives the warning and, in update mode\n  // only, the effectiveDate-lock side effect below.\n  const willDeleteSecondaryJobs =\n    effectiveBaseFlsaStatus === FlsaStatus.NONEXEMPT &&\n    watchedFlsaStatus !== undefined &&\n    watchedFlsaStatus !== FlsaStatus.NONEXEMPT &&\n    otherJobsCount > 0\n\n  // Carve-out UX — update mode only: while willDeleteSecondaryJobs is active\n  // the server deletes secondaries immediately on PUT. Mirror this by forcing\n  // `effectiveDate` to today and disabling the field. In create mode the\n  // deletion happens at the chosen future date, so we show the warning but\n  // leave the date field editable.\n  const carveOutActiveRef = useRef(false)\n  const priorEffectiveDateRef = useRef<string | null>(null)\n  useEffect(() => {\n    if (!isCreateMode && willDeleteSecondaryJobs && !carveOutActiveRef.current) {\n      priorEffectiveDateRef.current = getValues('effectiveDate') ?? null\n      setValue('effectiveDate', todayISO(), { shouldDirty: true, shouldValidate: false })\n      carveOutActiveRef.current = true\n    } else if (!isCreateMode && !willDeleteSecondaryJobs && carveOutActiveRef.current) {\n      setValue('effectiveDate', priorEffectiveDateRef.current ?? null, {\n        shouldDirty: true,\n        shouldValidate: false,\n      })\n      priorEffectiveDateRef.current = null\n      carveOutActiveRef.current = false\n    }\n  }, [isCreateMode, willDeleteSecondaryJobs, getValues, setValue])\n\n  const updateCompensationMutation = useJobsAndCompensationsUpdateCompensationMutation()\n  const createCompensationMutation = useJobsAndCompensationsCreateCompensationMutation()\n\n  const isPending = updateCompensationMutation.isPending || createCompensationMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('CompensationForm')\n\n  const queriesForErrors = employeeId\n    ? [jobsQuery, addressesQuery, employeeQuery, minWagesQuery]\n    : []\n  const errorHandling = composeErrorHandler(queriesForErrors, { submitError, setSubmitError })\n\n  const isCommissionOnly =\n    watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_NONEXEMPT ||\n    watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_EXEMPT\n  const isOwner = watchedFlsaStatus === FlsaStatus.OWNER\n\n  // Hide `Fields.FlsaStatus` when the user has no meaningful choice:\n  // - update mode editing a secondary whose comp is already Nonexempt\n  //   (must keep matching the primary), and\n  // - create mode while adding a secondary (must inherit primary's FLSA).\n  // The first job's create flow and primary-job edits keep the field exposed.\n  const isFlsaSelectionEnabled =\n    !isAddingSecondaryJob &&\n    (watchedFlsaStatus !== FlsaStatus.NONEXEMPT || currentJob?.primary === true || isCreateMode)\n\n  const isAdjustMinimumWageEnabled =\n    watchedFlsaStatus === FlsaStatus.NONEXEMPT &&\n    minimumWages.length > 0 &&\n    state !== undefined &&\n    !TIP_CREDITS_UNSUPPORTED_STATES.includes(state)\n\n  // Min-wage adjustment is only valid for Nonexempt FLSA (and a state that\n  // allows tip credit). When the gate flips off — typically because the user\n  // changed FLSA away from Nonexempt — `Fields.AdjustForMinimumWage` and\n  // `Fields.MinimumWageId` stop rendering, but the underlying form values\n  // persist in react-hook-form state. That would leak an\n  // `adjust_for_minimum_wage: true` + `minimum_wages: [...]` body on submit\n  // (server rejects with \"Minimum wage adjustments only valid for\n  // flsa_status: Nonexempt\"). Reset both values to safe defaults so the\n  // submitted payload always matches what the user can actually see.\n  useEffect(() => {\n    if (isAdjustMinimumWageEnabled) return\n    if (getValues('adjustForMinimumWage')) {\n      setValue('adjustForMinimumWage', false, { shouldDirty: true, shouldValidate: false })\n    }\n    if (getValues('minimumWageId')) {\n      setValue('minimumWageId', '', { shouldDirty: true, shouldValidate: false })\n    }\n    // Both fields stop rendering once the gate closes — clear errors so a\n    // stale one doesn't silently fail the next submit with no visible UI to fix.\n    clearErrors(['adjustForMinimumWage', 'minimumWageId'])\n  }, [isAdjustMinimumWageEnabled, getValues, setValue, clearErrors])\n\n  const minimumWageOptions = minimumWages.map(wage => ({\n    value: wage.uuid,\n    label: `${wage.wage} - ${wage.authority}: ${wage.notes ?? ''}`,\n  }))\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const effectiveDateMinDate = useMemo(\n    () =>\n      [internalMinEffectiveDate, hireDate]\n        .filter((d): d is string => !!d)\n        .reduce<string | null>((max, d) => (!max || d > max ? d : max), null),\n    [internalMinEffectiveDate, hireDate],\n  )\n  const fieldsMetadata = buildCompensationFieldsMetadata(baseMetadata, {\n    willDeleteSecondaryJobs,\n    isCreateMode,\n    isCommissionOnly,\n    isOwner,\n    isAdjustMinimumWageEnabled,\n    effectiveDateMinDate,\n    maximumEffectiveDate,\n    minimumWageOptions,\n    minimumWages,\n  })\n\n  const onSubmit = async (\n    options?: CompensationSubmitOptions,\n  ): Promise<HookSubmitResult<Compensation> | undefined> => {\n    let submitResult: HookSubmitResult<Compensation> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: CompensationFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const resolvedJobId = options?.jobId ?? jobId\n            const resolvedCompensationId = options?.compensationId ?? compensationId\n            const resolvedMode = resolvedCompensationId ? 'update' : 'create'\n\n            // When the field is rendered, the validated payload value wins\n            // unless an explicit submit-time override is supplied. When the\n            // field is hidden (`withEffectiveDateField: false`) we are\n            // strictly options-only — matching `useWorkAddressForm` and the\n            // hidden-field behavior of `useHomeAddressForm` / `useJobForm`.\n            // The carve-out's form-state side effect (force value to today)\n            // is therefore inert in the hidden-field path; partners who\n            // need a specific date there must supply it via\n            // `CompensationSubmitOptions.effectiveDate`.\n            const resolvedEffectiveDate = withEffectiveDateField\n              ? (options?.effectiveDate ?? payload.effectiveDate ?? undefined)\n              : (options?.effectiveDate ?? undefined)\n\n            const requestBodyBase = {\n              rate: String(payload.rate),\n              paymentUnit: payload.paymentUnit,\n              flsaStatus: payload.flsaStatus,\n              effectiveDate: resolvedEffectiveDate,\n              title: payload.title || undefined,\n              adjustForMinimumWage: payload.adjustForMinimumWage,\n              minimumWages: payload.adjustForMinimumWage ? [{ uuid: payload.minimumWageId }] : [],\n            }\n\n            let result: Compensation | undefined\n\n            if (resolvedMode === 'create') {\n              if (!resolvedJobId) {\n                throw new SDKInternalError(\n                  'jobId is required to create a compensation. Pass it as a hook prop or via submit options.',\n                )\n              }\n              // Schema's `requiredFieldsConfig` guarantees `flsaStatus` is set\n              // on create-mode submit; the runtime guard appeases the API\n              // request-body type (which requires a non-undefined value on\n              // POST, vs. the optional PUT body).\n              if (!payload.flsaStatus) {\n                throw new SDKInternalError('flsaStatus is required to create a compensation.')\n              }\n              const createResponse = await createCompensationMutation.mutateAsync({\n                request: {\n                  jobId: resolvedJobId,\n                  compensationsRequestBody: { ...requestBodyBase, flsaStatus: payload.flsaStatus },\n                },\n              })\n              result = createResponse.compensation\n              if (!result) throw new SDKInternalError('Compensation creation failed')\n            } else {\n              if (!resolvedCompensationId) {\n                throw new SDKInternalError(\n                  'compensationId is required to update a compensation. Pass it as a hook prop or via submit options.',\n                )\n              }\n              const resolvedVersion =\n                options?.compensationVersion ?? (currentCompensation?.version as string | undefined)\n              if (!resolvedVersion) {\n                throw new SDKInternalError(\n                  'compensation version is required to update a compensation. Pass it via submit options when threading post-create, or ensure the compensation is loaded.',\n                )\n              }\n              const updateResponse = await updateCompensationMutation.mutateAsync({\n                request: {\n                  compensationId: resolvedCompensationId,\n                  compensationsUpdateRequestBody: {\n                    version: resolvedVersion,\n                    ...requestBodyBase,\n                  },\n                },\n              })\n              result = updateResponse.compensation\n              if (!result) throw new SDKInternalError('Compensation update failed')\n            }\n\n            submitResult = { mode: resolvedMode, data: result }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const isDataLoading = employeeId\n    ? jobsQuery.isLoading ||\n      addressesQuery.isLoading ||\n      employeeQuery.isLoading ||\n      minWagesQuery.isLoading\n    : false\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (isDataLoading || (employeeId && (!employeeJobs || !employee))) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      compensation: currentCompensation,\n      currentJob,\n      minimumWages,\n      minimumEffectiveDate: effectiveDateMinDate,\n      maximumEffectiveDate,\n      hasPendingFutureCompensation,\n    },\n    status: {\n      isPending,\n      mode,\n      willDeleteSecondaryJobs,\n      showCommissionFederalMinimumPayAlert: watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_EXEMPT,\n      showCommissionMinimumWageAlert: watchedFlsaStatus === FlsaStatus.COMMISSION_ONLY_NONEXEMPT,\n      showOwnerSalaryAlert: watchedFlsaStatus === FlsaStatus.OWNER,\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Title: TitleField,\n        FlsaStatus: isFlsaSelectionEnabled ? FlsaStatusField : undefined,\n        Rate: isCommissionOnly ? undefined : RateField,\n        PaymentUnit: isCommissionOnly ? undefined : PaymentUnitField,\n        AdjustForMinimumWage: isAdjustMinimumWageEnabled ? AdjustForMinimumWageField : undefined,\n        MinimumWageId:\n          isAdjustMinimumWageEnabled && watchedAdjustForMinimumWage\n            ? MinimumWageIdField\n            : undefined,\n        EffectiveDate: withEffectiveDateField ? EffectiveDateField : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Discriminated union returned by {@link useCompensationForm} — either the loading state or the ready state.\n *\n * @remarks\n * Use this type when threading the hook result through helpers (e.g.\n * presentational components). Discriminate on `isLoading` to narrow to\n * {@link UseCompensationFormReady}.\n *\n * @public\n */\nexport type UseCompensationFormResult = HookLoadingResult | UseCompensationFormReady\n\n/**\n * Metadata for each {@link useCompensationForm} field, exposed on `form.fieldsMetadata`.\n *\n * @remarks\n * Includes per-field `isDisabled`, `isRequired`, and the dynamic option list\n * for select fields (`flsaStatus`, `paymentUnit`, `minimumWageId`).\n * `effectiveDate` additionally carries `minDate` / `maxDate` derived from\n * the parent job's hire date and any pending future compensation.\n *\n * @public\n */\nexport type CompensationFieldsMetadata = ReturnType<typeof buildCompensationFieldsMetadata>\n"],"names":["resolveCompAndJob","jobs","compensationId","jobId","job","compensation","c","j","findPrimaryFlsaStatus","findFutureCompensations","today","todayISO","earliestEffectiveDate","comps","min","d","flsaStatusEntries","FlsaStatus","flsaOptions","status","paymentUnitEntries","PAY_PERIODS","paymentUnitOptions","unit","buildCompensationFieldsMetadata","base","willDeleteSecondaryJobs","isCreateMode","isCommissionOnly","isOwner","isAdjustMinimumWageEnabled","effectiveDateMinDate","maximumEffectiveDate","minimumWageOptions","minimumWages","withFlags","withOptions","useCompensationForm","employeeId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","withEffectiveDateField","jobsQuery","useJobsAndCompensationsGetJobs","GetV1EmployeesEmployeeIdJobsQueryParamInclude","addressesQuery","useEmployeeAddressesGetWorkAddresses","employeeQuery","useEmployeesGet","employeeJobs","currentWorkAddress","address","locationUuid","employee","minWagesQuery","useLocationsGetMinimumWages","currentCompensation","currentJob","otherJobsCount","hadPrimaryAtMountRef","useRef","primaryFlsaStatus","hireDate","futureCompensations","hasPendingFutureCompensation","mode","isAddingSecondaryJob","internalMinEffectiveDate","useMemo","formatDateToStringDate","addDays","schema","metadataConfig","createCompensationSchema","state","resolvedDefaults","formMethods","useForm","zodResolver","control","getValues","setValue","clearErrors","watchedFlsaStatus","useWatch","watchedAdjustForMinimumWage","useEffect","currentJobActiveComp","carveOutActiveRef","priorEffectiveDateRef","updateCompensationMutation","useJobsAndCompensationsUpdateCompensationMutation","createCompensationMutation","useJobsAndCompensationsCreateCompensationMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","isFlsaSelectionEnabled","TIP_CREDITS_UNSUPPORTED_STATES","wage","baseMetadata","useDeriveFieldsMetadata","max","fieldsMetadata","onSubmit","options","submitResult","resolve","data","payload","resolvedJobId","resolvedCompensationId","resolvedMode","resolvedEffectiveDate","requestBodyBase","result","SDKInternalError","resolvedVersion","isDataLoading","hookFormInternals","useHookFormInternals","TitleField","FlsaStatusField","RateField","PaymentUnitField","AdjustForMinimumWageField","MinimumWageIdField","EffectiveDateField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Employee/Dashboard/Dashboard.d.ts

@@ -32,4 +32,4 @@ export interface DashboardProps extends BaseComponentInterface<'Employee.Dashboa
  * @returns A React element rendering the employee dashboard.
  * @public
  */
-export declare function Dashboard({ FallbackComponent, ...props }: DashboardProps): import("react").JSX.Element;
+export declare function Dashboard({ FallbackComponent, LoaderComponent, ...props }: DashboardProps): import("react").JSX.Element;

package/dist/components/Employee/Dashboard/Dashboard.js

@@ -1,25 +1,26 @@
 import { jsx as e, jsxs as i } from "react/jsx-runtime";
-import { useState as h, Suspense as x } from "react";
+import { useState as x, Suspense as y } from "react";
 import { useTranslation as c } from "react-i18next";
-import { useEmployeesGetSuspense as y } from "@gusto/embedded-api/react-query/employeesGet";
-import { BasicDetailsView as T } from "./BasicDetailsView.js";
-import { JobAndPayView as A } from "./JobAndPayView.js";
+import { useEmployeesGetSuspense as T } from "@gusto/embedded-api/react-query/employeesGet";
+import { BasicDetailsView as A } from "./BasicDetailsView.js";
+import { JobAndPayView as g } from "./JobAndPayView.js";
 import { TaxesViewWithData as C } from "./TaxesView.js";
 import { Flex as l } from "../../Common/Flex/Flex.js";
 import { useComponentContext as b } from "../../../contexts/ComponentAdapter/useComponentContext.js";
-import { BaseBoundaries as g } from "../../Base/Base.js";
-import { useI18n as E, useComponentDictionary as j } from "../../../i18n/I18n.js";
-import { componentEvents as B } from "../../../shared/constants.js";
-import { firstLastName as N } from "../../../helpers/formattedStrings.js";
-import { DocumentsCard as P } from "../Documents/management/DocumentsCard/DocumentsCard.js";
-function S({
-  employeeId: t,
-  dictionary: a,
-  onEvent: o,
-  selectedTab: r
+import { BaseBoundaries as E } from "../../Base/Base.js";
+import { useI18n as j, useComponentDictionary as B } from "../../../i18n/I18n.js";
+import { componentEvents as N } from "../../../shared/constants.js";
+import { firstLastName as P } from "../../../helpers/formattedStrings.js";
+import { DocumentsCard as S } from "../Documents/management/DocumentsCard/DocumentsCard.js";
+function _({
+  employeeId: a,
+  dictionary: o,
+  onEvent: t,
+  selectedTab: r,
+  LoaderComponent: p
 }) {
-  E("Employee.Dashboard"), j("Employee.Dashboard", a);
-  const { t: n } = c("Employee.Dashboard"), p = b(), [d, u] = h("basicDetails"), s = r ?? d, f = [
+  j("Employee.Dashboard"), B("Employee.Dashboard", o);
+  const { t: n } = c("Employee.Dashboard"), d = b(), [u, f] = x("basicDetails"), s = r ?? u, D = [
     {
       id: "basicDetails",
       label: n("tabs.basicDetails"),
@@ -42,42 +43,57 @@ function S({
     }
   ];
   return /* @__PURE__ */ i(l, { flexDirection: "column", gap: 32, children: [
-    /* @__PURE__ */ e(x, { fallback: null, children: /* @__PURE__ */ e(_, { employeeId: t }) }),
+    /* @__PURE__ */ e(y, { fallback: null, children: /* @__PURE__ */ e(H, { employeeId: a }) }),
     /* @__PURE__ */ i(l, { flexDirection: "column", gap: 8, children: [
       /* @__PURE__ */ e(
-        p.Tabs,
+        d.Tabs,
         {
-          tabs: f,
+          tabs: D,
           selectedId: s,
-          onSelectionChange: (D) => {
-            const m = D;
-            u(m), o(B.EMPLOYEE_DASHBOARD_TAB_CHANGE, { tab: m });
+          onSelectionChange: (h) => {
+            const m = h;
+            f(m), t(N.EMPLOYEE_DASHBOARD_TAB_CHANGE, { tab: m });
           },
           "aria-label": n("tabsLabel")
         }
       ),
       /* @__PURE__ */ i(l, { flexDirection: "column", gap: 24, children: [
-        s === "basicDetails" && /* @__PURE__ */ e(T, { employeeId: t, onEvent: o }),
-        s === "jobAndPay" && /* @__PURE__ */ e(A, { employeeId: t, onEvent: o }),
-        s === "taxes" && /* @__PURE__ */ e(C, { employeeId: t, onEvent: o }),
-        s === "documents" && /* @__PURE__ */ e(P, { employeeId: t, onEvent: o })
+        s === "basicDetails" && /* @__PURE__ */ e(A, { employeeId: a, onEvent: t }),
+        s === "jobAndPay" && /* @__PURE__ */ e(g, { employeeId: a, onEvent: t }),
+        s === "taxes" && /* @__PURE__ */ e(C, { employeeId: a, onEvent: t }),
+        s === "documents" && /* @__PURE__ */ e(
+          S,
+          {
+            employeeId: a,
+            onEvent: t,
+            LoaderComponent: p
+          }
+        )
       ] })
     ] })
   ] });
 }
-function _({ employeeId: t }) {
-  const { t: a } = c("Employee.Dashboard"), o = b(), {
+function H({ employeeId: a }) {
+  const { t: o } = c("Employee.Dashboard"), t = b(), {
     data: { employee: r }
-  } = y({ employeeId: t });
+  } = T({ employeeId: a });
   return /* @__PURE__ */ i(l, { flexDirection: "column", gap: 4, children: [
-    /* @__PURE__ */ e(o.Heading, { as: "h2", children: N({ first_name: r?.firstName, last_name: r?.lastName }) }),
-    /* @__PURE__ */ e(o.Text, { variant: "supporting", children: a("employeeRoleLabel") })
+    /* @__PURE__ */ e(t.Heading, { as: "h2", children: P({ first_name: r?.firstName, last_name: r?.lastName }) }),
+    /* @__PURE__ */ e(t.Text, { variant: "supporting", children: o("employeeRoleLabel") })
   ] });
 }
-function z({ FallbackComponent: t, ...a }) {
-  return /* @__PURE__ */ e(g, { componentName: "Employee.Dashboard", FallbackComponent: t, children: /* @__PURE__ */ e(S, { ...a }) });
+function K({ FallbackComponent: a, LoaderComponent: o, ...t }) {
+  return /* @__PURE__ */ e(
+    E,
+    {
+      componentName: "Employee.Dashboard",
+      FallbackComponent: a,
+      LoaderComponent: o,
+      children: /* @__PURE__ */ e(_, { ...t, LoaderComponent: o })
+    }
+  );
 }
 export {
-  z as Dashboard
+  K as Dashboard
 };
 //# sourceMappingURL=Dashboard.js.map

package/dist/components/Employee/Dashboard/Dashboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"Dashboard.js","sources":["../../../../src/components/Employee/Dashboard/Dashboard.tsx"],"sourcesContent":["import { Suspense, useState } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport { useEmployeesGetSuspense } from '@gusto/embedded-api/react-query/employeesGet'\nimport { BasicDetailsView } from './BasicDetailsView'\nimport { JobAndPayView } from './JobAndPayView'\nimport { TaxesViewWithData } from './TaxesView'\nimport { DocumentsCard } from '@/components/Employee/Documents/management/DocumentsCard'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { BaseBoundaries, type BaseComponentInterface } from '@/components/Base/Base'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\nimport { firstLastName } from '@/helpers/formattedStrings'\n\n/** @public */\nexport type DashboardTab = 'basicDetails' | 'jobAndPay' | 'taxes' | 'documents'\n\n/** @public */\nexport interface DashboardProps extends BaseComponentInterface<'Employee.Dashboard'> {\n  /** The associated employee identifier. */\n  employeeId: string\n  /** The currently active tab. Defaults to `'basicDetails'` when uncontrolled. */\n  selectedTab?: DashboardTab\n}\n\nfunction DashboardRoot({\n  employeeId,\n  dictionary,\n  onEvent,\n  selectedTab: controlledTab,\n}: DashboardProps) {\n  useI18n('Employee.Dashboard')\n  useComponentDictionary('Employee.Dashboard', dictionary)\n  const { t } = useTranslation('Employee.Dashboard')\n  const Components = useComponentContext()\n  const [internalTab, setInternalTab] = useState<DashboardTab>('basicDetails')\n  const selectedTab = controlledTab ?? internalTab\n\n  const tabs = [\n    {\n      id: 'basicDetails' as const,\n      label: t('tabs.basicDetails'),\n      content: null,\n    },\n    {\n      id: 'jobAndPay' as const,\n      label: t('tabs.jobAndPay'),\n      content: null,\n    },\n    {\n      id: 'taxes' as const,\n      label: t('tabs.taxes'),\n      content: null,\n    },\n    {\n      id: 'documents' as const,\n      label: t('tabs.documents'),\n      content: null,\n    },\n  ]\n\n  return (\n    <Flex flexDirection=\"column\" gap={32}>\n      <Suspense fallback={null}>\n        <DashboardHeader employeeId={employeeId} />\n      </Suspense>\n\n      <Flex flexDirection=\"column\" gap={8}>\n        <Components.Tabs\n          tabs={tabs}\n          selectedId={selectedTab}\n          onSelectionChange={id => {\n            const next = id as DashboardTab\n            setInternalTab(next)\n            onEvent(componentEvents.EMPLOYEE_DASHBOARD_TAB_CHANGE, { tab: next })\n          }}\n          aria-label={t('tabsLabel')}\n        />\n\n        <Flex flexDirection=\"column\" gap={24}>\n          {selectedTab === 'basicDetails' && (\n            <BasicDetailsView employeeId={employeeId} onEvent={onEvent} />\n          )}\n\n          {selectedTab === 'jobAndPay' && (\n            <JobAndPayView employeeId={employeeId} onEvent={onEvent} />\n          )}\n\n          {selectedTab === 'taxes' && (\n            <TaxesViewWithData employeeId={employeeId} onEvent={onEvent} />\n          )}\n\n          {selectedTab === 'documents' && (\n            <DocumentsCard employeeId={employeeId} onEvent={onEvent} />\n          )}\n        </Flex>\n      </Flex>\n    </Flex>\n  )\n}\n\nfunction DashboardHeader({ employeeId }: { employeeId: string }) {\n  const { t } = useTranslation('Employee.Dashboard')\n  const Components = useComponentContext()\n  const {\n    data: { employee },\n  } = useEmployeesGetSuspense({ employeeId })\n\n  return (\n    <Flex flexDirection=\"column\" gap={4}>\n      <Components.Heading as=\"h2\">\n        {firstLastName({ first_name: employee?.firstName, last_name: employee?.lastName })}\n      </Components.Heading>\n      <Components.Text variant=\"supporting\">{t('employeeRoleLabel')}</Components.Text>\n    </Flex>\n  )\n}\n\n/**\n * Employee self-service dashboard summarizing a single employee's basic details, job and pay, taxes, and documents.\n *\n * @remarks\n * Renders a tabbed overview of the employee, wrapped in the SDK's standard error and suspense\n * boundaries. The active tab may be controlled via `selectedTab` or left uncontrolled, in which\n * case it defaults to basic details. Each tab composes the read-only section cards listed below.\n *\n * @components\n * - {@link ProfileCard}\n * - {@link HomeAddressCard}\n * - {@link WorkAddressCard}\n * - {@link CompensationCard}\n * - {@link PaymentMethodCard}\n * - {@link DeductionsCard}\n * - {@link PaystubsCard}\n * - {@link FederalTaxesCard}\n * - {@link StateTaxesCard}\n * - {@link DocumentsCard}\n *\n * @param props - Component props. See {@link DashboardProps}.\n * @returns A React element rendering the employee dashboard.\n * @public\n */\nexport function Dashboard({ FallbackComponent, ...props }: DashboardProps) {\n  return (\n    <BaseBoundaries componentName=\"Employee.Dashboard\" FallbackComponent={FallbackComponent}>\n      <DashboardRoot {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["DashboardRoot","employeeId","dictionary","onEvent","controlledTab","useI18n","useComponentDictionary","t","useTranslation","Components","useComponentContext","internalTab","setInternalTab","useState","selectedTab","tabs","jsxs","Flex","jsx","Suspense","DashboardHeader","id","next","componentEvents","BasicDetailsView","JobAndPayView","TaxesViewWithData","DocumentsCard","employee","useEmployeesGetSuspense","firstLastName","Dashboard","FallbackComponent","props","BaseBoundaries"],"mappings":"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"}
+{"version":3,"file":"Dashboard.js","sources":["../../../../src/components/Employee/Dashboard/Dashboard.tsx"],"sourcesContent":["import { Suspense, useState } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport { useEmployeesGetSuspense } from '@gusto/embedded-api/react-query/employeesGet'\nimport { BasicDetailsView } from './BasicDetailsView'\nimport { JobAndPayView } from './JobAndPayView'\nimport { TaxesViewWithData } from './TaxesView'\nimport { DocumentsCard } from '@/components/Employee/Documents/management/DocumentsCard'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { BaseBoundaries, type BaseComponentInterface } from '@/components/Base/Base'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\nimport { firstLastName } from '@/helpers/formattedStrings'\n\n/** @public */\nexport type DashboardTab = 'basicDetails' | 'jobAndPay' | 'taxes' | 'documents'\n\n/** @public */\nexport interface DashboardProps extends BaseComponentInterface<'Employee.Dashboard'> {\n  /** The associated employee identifier. */\n  employeeId: string\n  /** The currently active tab. Defaults to `'basicDetails'` when uncontrolled. */\n  selectedTab?: DashboardTab\n}\n\nfunction DashboardRoot({\n  employeeId,\n  dictionary,\n  onEvent,\n  selectedTab: controlledTab,\n  LoaderComponent,\n}: DashboardProps) {\n  useI18n('Employee.Dashboard')\n  useComponentDictionary('Employee.Dashboard', dictionary)\n  const { t } = useTranslation('Employee.Dashboard')\n  const Components = useComponentContext()\n  const [internalTab, setInternalTab] = useState<DashboardTab>('basicDetails')\n  const selectedTab = controlledTab ?? internalTab\n\n  const tabs = [\n    {\n      id: 'basicDetails' as const,\n      label: t('tabs.basicDetails'),\n      content: null,\n    },\n    {\n      id: 'jobAndPay' as const,\n      label: t('tabs.jobAndPay'),\n      content: null,\n    },\n    {\n      id: 'taxes' as const,\n      label: t('tabs.taxes'),\n      content: null,\n    },\n    {\n      id: 'documents' as const,\n      label: t('tabs.documents'),\n      content: null,\n    },\n  ]\n\n  return (\n    <Flex flexDirection=\"column\" gap={32}>\n      <Suspense fallback={null}>\n        <DashboardHeader employeeId={employeeId} />\n      </Suspense>\n\n      <Flex flexDirection=\"column\" gap={8}>\n        <Components.Tabs\n          tabs={tabs}\n          selectedId={selectedTab}\n          onSelectionChange={id => {\n            const next = id as DashboardTab\n            setInternalTab(next)\n            onEvent(componentEvents.EMPLOYEE_DASHBOARD_TAB_CHANGE, { tab: next })\n          }}\n          aria-label={t('tabsLabel')}\n        />\n\n        <Flex flexDirection=\"column\" gap={24}>\n          {selectedTab === 'basicDetails' && (\n            <BasicDetailsView employeeId={employeeId} onEvent={onEvent} />\n          )}\n\n          {selectedTab === 'jobAndPay' && (\n            <JobAndPayView employeeId={employeeId} onEvent={onEvent} />\n          )}\n\n          {selectedTab === 'taxes' && (\n            <TaxesViewWithData employeeId={employeeId} onEvent={onEvent} />\n          )}\n\n          {selectedTab === 'documents' && (\n            <DocumentsCard\n              employeeId={employeeId}\n              onEvent={onEvent}\n              LoaderComponent={LoaderComponent}\n            />\n          )}\n        </Flex>\n      </Flex>\n    </Flex>\n  )\n}\n\nfunction DashboardHeader({ employeeId }: { employeeId: string }) {\n  const { t } = useTranslation('Employee.Dashboard')\n  const Components = useComponentContext()\n  const {\n    data: { employee },\n  } = useEmployeesGetSuspense({ employeeId })\n\n  return (\n    <Flex flexDirection=\"column\" gap={4}>\n      <Components.Heading as=\"h2\">\n        {firstLastName({ first_name: employee?.firstName, last_name: employee?.lastName })}\n      </Components.Heading>\n      <Components.Text variant=\"supporting\">{t('employeeRoleLabel')}</Components.Text>\n    </Flex>\n  )\n}\n\n/**\n * Employee self-service dashboard summarizing a single employee's basic details, job and pay, taxes, and documents.\n *\n * @remarks\n * Renders a tabbed overview of the employee, wrapped in the SDK's standard error and suspense\n * boundaries. The active tab may be controlled via `selectedTab` or left uncontrolled, in which\n * case it defaults to basic details. Each tab composes the read-only section cards listed below.\n *\n * @components\n * - {@link ProfileCard}\n * - {@link HomeAddressCard}\n * - {@link WorkAddressCard}\n * - {@link CompensationCard}\n * - {@link PaymentMethodCard}\n * - {@link DeductionsCard}\n * - {@link PaystubsCard}\n * - {@link FederalTaxesCard}\n * - {@link StateTaxesCard}\n * - {@link DocumentsCard}\n *\n * @param props - Component props. See {@link DashboardProps}.\n * @returns A React element rendering the employee dashboard.\n * @public\n */\nexport function Dashboard({ FallbackComponent, LoaderComponent, ...props }: DashboardProps) {\n  return (\n    <BaseBoundaries\n      componentName=\"Employee.Dashboard\"\n      FallbackComponent={FallbackComponent}\n      LoaderComponent={LoaderComponent}\n    >\n      <DashboardRoot {...props} LoaderComponent={LoaderComponent} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["DashboardRoot","employeeId","dictionary","onEvent","controlledTab","LoaderComponent","useI18n","useComponentDictionary","t","useTranslation","Components","useComponentContext","internalTab","setInternalTab","useState","selectedTab","tabs","jsxs","Flex","jsx","Suspense","DashboardHeader","id","next","componentEvents","BasicDetailsView","JobAndPayView","TaxesViewWithData","DocumentsCard","employee","useEmployeesGetSuspense","firstLastName","Dashboard","FallbackComponent","props","BaseBoundaries"],"mappings":"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"}

package/dist/components/Employee/Dashboard/DashboardFlow.js

@@ -1,17 +1,17 @@
 import { jsx as m } from "react/jsx-runtime";
-import { createMachine as e } from "robot3";
-import { useMemo as i } from "react";
-import { dashboardStateMachine as n } from "./dashboardStateMachine.js";
-import { DashboardViewContextual as c } from "./DashboardComponents.js";
+import { useMemo as e } from "react";
+import { dashboardStateMachine as i } from "./dashboardStateMachine.js";
+import { DashboardViewContextual as n } from "./DashboardComponents.js";
+import { createMachine as c } from "../../../lib/state-machine/core.js";
 import { Flow as h } from "../../Flow/Flow.js";
 const M = ({ employeeId: o, onEvent: r }) => {
-  const t = i(
-    () => e(
+  const t = e(
+    () => c(
       "index",
-      n,
+      i,
       (a) => ({
         ...a,
-        component: c,
+        component: n,
         employeeId: o
       })
     ),

package/dist/components/Employee/Dashboard/DashboardFlow.js.map

@@ -1 +1 @@
-{"version":3,"file":"DashboardFlow.js","sources":["../../../../src/components/Employee/Dashboard/DashboardFlow.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport { dashboardStateMachine } from './dashboardStateMachine'\nimport { type DashboardContextInterface, DashboardViewContextual } from './DashboardComponents'\nimport { Flow } from '@/components/Flow/Flow'\nimport type { BaseComponentInterface } from '@/components/Base'\n\n/**\n * Props for {@link DashboardFlow}.\n *\n * @public\n */\nexport interface DashboardFlowProps extends BaseComponentInterface<never> {\n  /** The associated employee identifier. */\n  employeeId: string\n}\n\n/**\n * Hub for viewing and managing a single employee's profile, pay, and documents.\n *\n * @remarks\n * Renders a tabbed view of an employee's profile (Basic details, Job and pay,\n * Taxes, Documents), wires the card surfaces to their corresponding edit\n * screens via an internal state machine, and surfaces success alerts at the\n * top of the dashboard after each successful edit. Wraps the dashboard in\n * error and suspense boundaries.\n *\n * Every tab section of the dashboard is also exported as a self-contained\n * block that can be dropped into a custom layout without the surrounding\n * dashboard chrome (see the blocks below).\n *\n * Each block wraps its read-only card, its edit form, and the card↔form\n * transitions as a single drop-in. For cases where that built-in orchestration\n * doesn't fit — rendering a form in a modal, driving navigation via a router,\n * or showing a card read-only — each block's card and form are also exported\n * individually (e.g. {@link CompensationCard}, {@link CompensationEditForm}).\n * Using the individual pieces means owning the swap, any success alerts, and\n * cross-component state yourself.\n *\n * The dashboard composes self-fetching cards and their edit forms and forwards\n * every event they emit to the partner via `onEvent`; its internal state\n * machine also reacts to a subset of these events to swap between the cards\n * and edit screens and to surface success alerts. The table below is the\n * complete, current set of events observable from `DashboardFlow`, grouped by\n * the tab that emits them.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/management/profile/editRequested` | Fired when \"Edit\" is clicked on the Basic details (Profile) card | `{ employeeId: string }` |\n * | `employee/management/profile/updated` | Fired after the basic-details edit form is saved; the dashboard returns to the cards and surfaces the \"Profile updated\" alert | Updated `Employee` entity |\n * | `employee/management/profile/editCancelled` | Fired when the user clicks Cancel on the basic-details edit form; the dashboard returns to the cards | — |\n * | `employee/management/homeAddress/editRequested` | Fired when \"Manage\" is clicked on the Home address card | `{ employeeId: string }` |\n * | `employee/management/homeAddress/created` | Fired after a new home address is created on the manage screen; the manage screen stays open | Created `EmployeeAddress` entity |\n * | `employee/management/homeAddress/updated` | Fired after a home address is updated on the manage screen; the manage screen stays open | Updated `EmployeeAddress` entity |\n * | `employee/management/homeAddress/deleted` | Fired after a non-active home address is deleted on the manage screen; the manage screen stays open | Deleted `EmployeeAddress` entity |\n * | `employee/management/homeAddress/editCancelled` | Fired when the user clicks Back on the manage screen; the dashboard returns to the cards | — |\n * | `employee/management/workAddress/editRequested` | Fired when \"Manage\" is clicked on the Work address card | `{ employeeId: string }` |\n * | `employee/management/workAddress/created` | Fired after a new work address is created on the manage screen; the manage screen stays open | Created `EmployeeWorkAddress` entity |\n * | `employee/management/workAddress/updated` | Fired after a work address is updated on the manage screen; the manage screen stays open | Updated `EmployeeWorkAddress` entity |\n * | `employee/management/workAddress/deleted` | Fired after a work address is deleted on the manage screen; the manage screen stays open | Deleted `EmployeeWorkAddress` entity |\n * | `employee/management/workAddress/editCancelled` | Fired when the user clicks Back on the manage screen; the dashboard returns to the cards | — |\n * | `employee/management/compensation/card/editRequested` | Fired when an \"Edit\" CTA is clicked for a job on the Compensation card | `{ employeeId: string, jobId: string }` |\n * | `employee/management/compensation/card/addRequested` | Fired when \"Add job\" is clicked from the Compensation card's empty state | `{ employeeId: string }` |\n * | `employee/management/compensation/card/addAnotherRequested` | Fired when \"Add another job\" is clicked on the Compensation card | `{ employeeId: string }` |\n * | `employee/management/compensation/card/jobDeleted` | Fired after a non-primary job is deleted via the card's confirm dialog | `{ employeeId: string, jobId: string }` |\n * | `employee/management/compensation/card/changeCancelled` | Fired after a scheduled future-dated change is cancelled from the card | `{ employeeId: string, compensationId: string }` |\n * | `employee/management/compensation/editForm/submitted` | Fired after an edit-compensation save completes; the dashboard returns to the cards | Updated `Compensation` entity |\n * | `employee/management/compensation/editForm/cancelled` | Fired when the user cancels the edit-compensation form; the dashboard returns to the cards | — |\n * | `employee/management/compensation/addJobForm/submitted` | Fired after the first job and compensation are saved; the dashboard returns to the cards and surfaces the \"Job added\" alert | Updated `Compensation` entity |\n * | `employee/management/compensation/addJobForm/cancelled` | Fired when the user cancels the add-job form; the dashboard returns to the cards | — |\n * | `employee/management/compensation/addAnotherJobForm/submitted` | Fired after a secondary job and compensation are saved; the dashboard returns to the cards and surfaces the \"Job added\" alert | Updated `Compensation` entity |\n * | `employee/management/compensation/addAnotherJobForm/cancelled` | Fired when the user cancels the add-another-job form; the dashboard returns to the cards | — |\n * | `employee/management/paymentMethod/card/addRequested` | Fired when \"Add bank account\" / \"Add another bank account\" is clicked on the Payment card | — |\n * | `employee/management/paymentMethod/card/splitRequested` | Fired when \"Split paycheck\" is clicked on the Payment card | — |\n * | `employee/management/paymentMethod/card/bankAccountDeleted` | Fired after a bank account is deleted from the card; the dashboard surfaces the \"Bank account deleted\" alert | Response from the Delete a bank account endpoint |\n * | `employee/management/paymentMethod/bankForm/submitted` | Fired after a new bank account is saved; the dashboard returns to the cards and surfaces the \"Bank account added\" alert | Created `EmployeeBankAccount` entity |\n * | `employee/management/paymentMethod/bankForm/cancelled` | Fired when the user cancels the add-bank-account screen; the dashboard returns to the cards | — |\n * | `employee/management/paymentMethod/splitForm/submitted` | Fired after the split configuration is saved; the dashboard returns to the cards and surfaces the \"Split updated\" alert | Updated `EmployeePaymentMethod` entity |\n * | `employee/management/paymentMethod/splitForm/cancelled` | Fired when the user cancels the split-paycheck screen; the dashboard returns to the cards | — |\n * | `employee/management/deductions/card/addRequested` | Fired when \"Add deduction\" is clicked on the Deductions card | `{ employeeId: string }` |\n * | `employee/management/deductions/card/editRequested` | Fired when a row's \"Edit\" menu item is chosen on the Deductions card | The `Garnishment` row being edited |\n * | `employee/management/deductions/card/deleted` | Fired after the soft-delete dialog is confirmed; the dashboard surfaces the \"Deduction deleted\" alert | The now-inactive `Garnishment` |\n * | `employee/management/deductions/editForm/created` | Fired after a new deduction is created; the dashboard returns to the cards and surfaces the \"Deduction added\" alert | The created `Garnishment` |\n * | `employee/management/deductions/editForm/updated` | Fired after a deduction is updated; the dashboard returns to the cards and surfaces the \"Deduction updated\" alert | The updated `Garnishment` |\n * | `employee/management/deductions/editForm/cancelled` | Fired when the user cancels the add/edit deduction form; the dashboard returns to the cards | — |\n * | `employee/management/paystubs/card/downloadRequested` | Fired when a paystub row's download button is clicked, before the PDF is fetched | `{ employeeId: string, payrollUuid: string }` |\n * | `employee/management/paystubs/card/downloaded` | Fired after the paystub PDF is fetched and opened in a new tab | `{ employeeId: string, payrollUuid: string }` |\n * | `employee/management/federalTaxes/card/editRequested` | Fired when \"Edit\" is clicked on the Federal taxes card | `{ employeeId: string }` |\n * | `employee/management/federalTaxes/editForm/submitted` | Fired after a federal-taxes save succeeds; the dashboard returns to the cards and surfaces the \"Federal taxes updated\" alert | Updated `EmployeeFederalTax` entity |\n * | `employee/management/federalTaxes/editForm/cancelled` | Fired when the user cancels the federal-taxes edit form; the dashboard returns to the cards | — |\n * | `employee/management/stateTaxes/editRequested` | Fired when \"Edit\" is clicked on the State taxes card | `{ employeeId: string }` |\n * | `employee/management/stateTaxes/updated` | Fired after a state-taxes save succeeds; the dashboard returns to the cards and surfaces the \"State taxes updated\" alert | `{ employeeStateTaxesList: EmployeeStateTaxesList[] }` |\n * | `employee/management/stateTaxes/editCancelled` | Fired when the user cancels the state-taxes edit form; the dashboard returns to the cards | — |\n * | `employee/management/documents/card/viewRequested` | Fired when a document row's \"View\" CTA is clicked; the dashboard swaps to the read-only document viewer | `{ employeeId: string, formId: string }` |\n * | `CANCEL` | Fired when the user clicks Back in the document viewer; the dashboard returns to the cards | — |\n * | `employee/dashboard/tabChange` | Fired when the user switches dashboard tabs | `{ tab: 'basicDetails' \\| 'jobAndPay' \\| 'taxes' \\| 'documents' }` |\n * | `employee/dismiss` | Fired when the user dismisses a top-of-dashboard success alert | — |\n *\n * @components\n * - {@link Dashboard}\n * - {@link ProfileEditForm}\n * - {@link HomeAddressEditForm}\n * - {@link WorkAddressEditForm}\n * - {@link FederalTaxesEditForm}\n * - {@link StateTaxesEditForm}\n * - {@link PaymentMethodBankForm}\n * - {@link PaymentMethodSplitForm}\n * - {@link CompensationAddJobForm}\n * - {@link CompensationEditForm}\n * - {@link CompensationAddAnotherJobForm}\n * - {@link DeductionsEditForm}\n * - {@link DocumentManager}\n *\n * @param props - See {@link DashboardFlowProps}.\n * @returns The tabbed dashboard with internal navigation between cards and edit screens.\n * @public\n * @group Flow components\n *\n * @example\n * ```tsx title=\"App.tsx\"\n * import { EmployeeManagement } from '@gusto/embedded-react-sdk'\n *\n * function MyApp() {\n *   return (\n *     <EmployeeManagement.DashboardFlow\n *       employeeId=\"4b3f930f-82cd-48a8-b797-798686e12e5e\"\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport const DashboardFlow = ({ employeeId, onEvent }: DashboardFlowProps) => {\n  const dashboardMachine = useMemo(\n    () =>\n      createMachine(\n        'index',\n        dashboardStateMachine,\n        (initialContext: DashboardContextInterface) => ({\n          ...initialContext,\n          component: DashboardViewContextual,\n          employeeId,\n        }),\n      ),\n    [employeeId],\n  )\n\n  return <Flow machine={dashboardMachine} onEvent={onEvent} />\n}\n"],"names":["DashboardFlow","employeeId","onEvent","dashboardMachine","useMemo","createMachine","dashboardStateMachine","initialContext","DashboardViewContextual","jsx","Flow"],"mappings":";;;;;;AAqIO,MAAMA,IAAgB,CAAC,EAAE,YAAAC,GAAY,SAAAC,QAAkC;AAC5E,QAAMC,IAAmBC;AAAA,IACvB,MACEC;AAAA,MACE;AAAA,MACAC;AAAA,MACA,CAACC,OAA+C;AAAA,QAC9C,GAAGA;AAAA,QACH,WAAWC;AAAA,QACX,YAAAP;AAAA,MAAA;AAAA,IACF;AAAA,IAEJ,CAACA,CAAU;AAAA,EAAA;AAGb,SAAO,gBAAAQ,EAACC,GAAA,EAAK,SAASP,GAAkB,SAAAD,EAAA,CAAkB;AAC5D;"}
+{"version":3,"file":"DashboardFlow.js","sources":["../../../../src/components/Employee/Dashboard/DashboardFlow.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { dashboardStateMachine } from './dashboardStateMachine'\nimport { type DashboardContextInterface, DashboardViewContextual } from './DashboardComponents'\nimport { createMachine } from '@/lib/state-machine'\nimport { Flow } from '@/components/Flow/Flow'\nimport type { BaseComponentInterface } from '@/components/Base'\n\n/**\n * Props for {@link DashboardFlow}.\n *\n * @public\n */\nexport interface DashboardFlowProps extends BaseComponentInterface<never> {\n  /** The associated employee identifier. */\n  employeeId: string\n}\n\n/**\n * Hub for viewing and managing a single employee's profile, pay, and documents.\n *\n * @remarks\n * Renders a tabbed view of an employee's profile (Basic details, Job and pay,\n * Taxes, Documents), wires the card surfaces to their corresponding edit\n * screens via an internal state machine, and surfaces success alerts at the\n * top of the dashboard after each successful edit. Wraps the dashboard in\n * error and suspense boundaries.\n *\n * Every tab section of the dashboard is also exported as a self-contained\n * block that can be dropped into a custom layout without the surrounding\n * dashboard chrome (see the blocks below).\n *\n * Each block wraps its read-only card, its edit form, and the card↔form\n * transitions as a single drop-in. For cases where that built-in orchestration\n * doesn't fit — rendering a form in a modal, driving navigation via a router,\n * or showing a card read-only — each block's card and form are also exported\n * individually (e.g. {@link CompensationCard}, {@link CompensationEditForm}).\n * Using the individual pieces means owning the swap, any success alerts, and\n * cross-component state yourself.\n *\n * The dashboard composes self-fetching cards and their edit forms and forwards\n * every event they emit to the partner via `onEvent`; its internal state\n * machine also reacts to a subset of these events to swap between the cards\n * and edit screens and to surface success alerts. The table below is the\n * complete, current set of events observable from `DashboardFlow`, grouped by\n * the tab that emits them.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/management/profile/editRequested` | Fired when \"Edit\" is clicked on the Basic details (Profile) card | `{ employeeId: string }` |\n * | `employee/management/profile/updated` | Fired after the basic-details edit form is saved; the dashboard returns to the cards and surfaces the \"Profile updated\" alert | Updated `Employee` entity |\n * | `employee/management/profile/editCancelled` | Fired when the user clicks Cancel on the basic-details edit form; the dashboard returns to the cards | — |\n * | `employee/management/homeAddress/editRequested` | Fired when \"Manage\" is clicked on the Home address card | `{ employeeId: string }` |\n * | `employee/management/homeAddress/created` | Fired after a new home address is created on the manage screen; the manage screen stays open | Created `EmployeeAddress` entity |\n * | `employee/management/homeAddress/updated` | Fired after a home address is updated on the manage screen; the manage screen stays open | Updated `EmployeeAddress` entity |\n * | `employee/management/homeAddress/deleted` | Fired after a non-active home address is deleted on the manage screen; the manage screen stays open | Deleted `EmployeeAddress` entity |\n * | `employee/management/homeAddress/editCancelled` | Fired when the user clicks Back on the manage screen; the dashboard returns to the cards | — |\n * | `employee/management/workAddress/editRequested` | Fired when \"Manage\" is clicked on the Work address card | `{ employeeId: string }` |\n * | `employee/management/workAddress/created` | Fired after a new work address is created on the manage screen; the manage screen stays open | Created `EmployeeWorkAddress` entity |\n * | `employee/management/workAddress/updated` | Fired after a work address is updated on the manage screen; the manage screen stays open | Updated `EmployeeWorkAddress` entity |\n * | `employee/management/workAddress/deleted` | Fired after a work address is deleted on the manage screen; the manage screen stays open | Deleted `EmployeeWorkAddress` entity |\n * | `employee/management/workAddress/editCancelled` | Fired when the user clicks Back on the manage screen; the dashboard returns to the cards | — |\n * | `employee/management/compensation/card/editRequested` | Fired when an \"Edit\" CTA is clicked for a job on the Compensation card | `{ employeeId: string, jobId: string }` |\n * | `employee/management/compensation/card/addRequested` | Fired when \"Add job\" is clicked from the Compensation card's empty state | `{ employeeId: string }` |\n * | `employee/management/compensation/card/addAnotherRequested` | Fired when \"Add another job\" is clicked on the Compensation card | `{ employeeId: string }` |\n * | `employee/management/compensation/card/jobDeleted` | Fired after a non-primary job is deleted via the card's confirm dialog | `{ employeeId: string, jobId: string }` |\n * | `employee/management/compensation/card/changeCancelled` | Fired after a scheduled future-dated change is cancelled from the card | `{ employeeId: string, compensationId: string }` |\n * | `employee/management/compensation/editForm/submitted` | Fired after an edit-compensation save completes; the dashboard returns to the cards | Updated `Compensation` entity |\n * | `employee/management/compensation/editForm/cancelled` | Fired when the user cancels the edit-compensation form; the dashboard returns to the cards | — |\n * | `employee/management/compensation/addJobForm/submitted` | Fired after the first job and compensation are saved; the dashboard returns to the cards and surfaces the \"Job added\" alert | Updated `Compensation` entity |\n * | `employee/management/compensation/addJobForm/cancelled` | Fired when the user cancels the add-job form; the dashboard returns to the cards | — |\n * | `employee/management/compensation/addAnotherJobForm/submitted` | Fired after a secondary job and compensation are saved; the dashboard returns to the cards and surfaces the \"Job added\" alert | Updated `Compensation` entity |\n * | `employee/management/compensation/addAnotherJobForm/cancelled` | Fired when the user cancels the add-another-job form; the dashboard returns to the cards | — |\n * | `employee/management/paymentMethod/card/addRequested` | Fired when \"Add bank account\" / \"Add another bank account\" is clicked on the Payment card | — |\n * | `employee/management/paymentMethod/card/splitRequested` | Fired when \"Split paycheck\" is clicked on the Payment card | — |\n * | `employee/management/paymentMethod/card/bankAccountDeleted` | Fired after a bank account is deleted from the card; the dashboard surfaces the \"Bank account deleted\" alert | Response from the Delete a bank account endpoint |\n * | `employee/management/paymentMethod/bankForm/submitted` | Fired after a new bank account is saved; the dashboard returns to the cards and surfaces the \"Bank account added\" alert | Created `EmployeeBankAccount` entity |\n * | `employee/management/paymentMethod/bankForm/cancelled` | Fired when the user cancels the add-bank-account screen; the dashboard returns to the cards | — |\n * | `employee/management/paymentMethod/splitForm/submitted` | Fired after the split configuration is saved; the dashboard returns to the cards and surfaces the \"Split updated\" alert | Updated `EmployeePaymentMethod` entity |\n * | `employee/management/paymentMethod/splitForm/cancelled` | Fired when the user cancels the split-paycheck screen; the dashboard returns to the cards | — |\n * | `employee/management/deductions/card/addRequested` | Fired when \"Add deduction\" is clicked on the Deductions card | `{ employeeId: string }` |\n * | `employee/management/deductions/card/editRequested` | Fired when a row's \"Edit\" menu item is chosen on the Deductions card | The `Garnishment` row being edited |\n * | `employee/management/deductions/card/deleted` | Fired after the soft-delete dialog is confirmed; the dashboard surfaces the \"Deduction deleted\" alert | The now-inactive `Garnishment` |\n * | `employee/management/deductions/editForm/created` | Fired after a new deduction is created; the dashboard returns to the cards and surfaces the \"Deduction added\" alert | The created `Garnishment` |\n * | `employee/management/deductions/editForm/updated` | Fired after a deduction is updated; the dashboard returns to the cards and surfaces the \"Deduction updated\" alert | The updated `Garnishment` |\n * | `employee/management/deductions/editForm/cancelled` | Fired when the user cancels the add/edit deduction form; the dashboard returns to the cards | — |\n * | `employee/management/paystubs/card/downloadRequested` | Fired when a paystub row's download button is clicked, before the PDF is fetched | `{ employeeId: string, payrollUuid: string }` |\n * | `employee/management/paystubs/card/downloaded` | Fired after the paystub PDF is fetched and opened in a new tab | `{ employeeId: string, payrollUuid: string }` |\n * | `employee/management/federalTaxes/card/editRequested` | Fired when \"Edit\" is clicked on the Federal taxes card | `{ employeeId: string }` |\n * | `employee/management/federalTaxes/editForm/submitted` | Fired after a federal-taxes save succeeds; the dashboard returns to the cards and surfaces the \"Federal taxes updated\" alert | Updated `EmployeeFederalTax` entity |\n * | `employee/management/federalTaxes/editForm/cancelled` | Fired when the user cancels the federal-taxes edit form; the dashboard returns to the cards | — |\n * | `employee/management/stateTaxes/editRequested` | Fired when \"Edit\" is clicked on the State taxes card | `{ employeeId: string }` |\n * | `employee/management/stateTaxes/updated` | Fired after a state-taxes save succeeds; the dashboard returns to the cards and surfaces the \"State taxes updated\" alert | `{ employeeStateTaxesList: EmployeeStateTaxesList[] }` |\n * | `employee/management/stateTaxes/editCancelled` | Fired when the user cancels the state-taxes edit form; the dashboard returns to the cards | — |\n * | `employee/management/documents/card/viewRequested` | Fired when a document row's \"View\" CTA is clicked; the dashboard swaps to the read-only document viewer | `{ employeeId: string, formId: string }` |\n * | `CANCEL` | Fired when the user clicks Back in the document viewer; the dashboard returns to the cards | — |\n * | `employee/dashboard/tabChange` | Fired when the user switches dashboard tabs | `{ tab: 'basicDetails' \\| 'jobAndPay' \\| 'taxes' \\| 'documents' }` |\n * | `employee/dismiss` | Fired when the user dismisses a top-of-dashboard success alert | — |\n *\n * @components\n * - {@link Dashboard}\n * - {@link ProfileEditForm}\n * - {@link HomeAddressEditForm}\n * - {@link WorkAddressEditForm}\n * - {@link FederalTaxesEditForm}\n * - {@link StateTaxesEditForm}\n * - {@link PaymentMethodBankForm}\n * - {@link PaymentMethodSplitForm}\n * - {@link CompensationAddJobForm}\n * - {@link CompensationEditForm}\n * - {@link CompensationAddAnotherJobForm}\n * - {@link DeductionsEditForm}\n * - {@link DocumentManager}\n *\n * @param props - See {@link DashboardFlowProps}.\n * @returns The tabbed dashboard with internal navigation between cards and edit screens.\n * @public\n * @group Flow components\n *\n * @example\n * ```tsx title=\"App.tsx\"\n * import { EmployeeManagement } from '@gusto/embedded-react-sdk'\n *\n * function MyApp() {\n *   return (\n *     <EmployeeManagement.DashboardFlow\n *       employeeId=\"4b3f930f-82cd-48a8-b797-798686e12e5e\"\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport const DashboardFlow = ({ employeeId, onEvent }: DashboardFlowProps) => {\n  const dashboardMachine = useMemo(\n    () =>\n      createMachine(\n        'index',\n        dashboardStateMachine,\n        (initialContext: DashboardContextInterface) => ({\n          ...initialContext,\n          component: DashboardViewContextual,\n          employeeId,\n        }),\n      ),\n    [employeeId],\n  )\n\n  return <Flow machine={dashboardMachine} onEvent={onEvent} />\n}\n"],"names":["DashboardFlow","employeeId","onEvent","dashboardMachine","useMemo","createMachine","dashboardStateMachine","initialContext","DashboardViewContextual","jsx","Flow"],"mappings":";;;;;;AAqIO,MAAMA,IAAgB,CAAC,EAAE,YAAAC,GAAY,SAAAC,QAAkC;AAC5E,QAAMC,IAAmBC;AAAA,IACvB,MACEC;AAAA,MACE;AAAA,MACAC;AAAA,MACA,CAACC,OAA+C;AAAA,QAC9C,GAAGA;AAAA,QACH,WAAWC;AAAA,QACX,YAAAP;AAAA,MAAA;AAAA,IACF;AAAA,IAEJ,CAACA,CAAU;AAAA,EAAA;AAGb,SAAO,gBAAAQ,EAACC,GAAA,EAAK,SAASP,GAAkB,SAAAD,EAAA,CAAkB;AAC5D;"}

package/dist/components/Employee/Dashboard/dashboardStateMachine.d.ts

@@ -1,16 +1,16 @@
 /** @internal */
 export declare const dashboardStateMachine: {
-    index: import('robot3').MachineState<any>;
-    homeAddress: import('robot3').MachineState<any>;
-    workAddress: import('robot3').MachineState<any>;
-    federalTaxes: import('robot3').MachineState<any>;
-    stateTaxes: import('robot3').MachineState<any>;
-    profile: import('robot3').MachineState<any>;
-    paymentBankForm: import('robot3').MachineState<any>;
-    paymentSplitView: import('robot3').MachineState<any>;
-    documentManager: import('robot3').MachineState<any>;
-    editDeduction: import('robot3').MachineState<any>;
-    addJob: import('robot3').MachineState<any>;
-    editCompensation: import('robot3').MachineState<any>;
-    addAnotherJob: import('robot3').MachineState<any>;
+    index: import('../../../lib/state-machine').StateDefinition;
+    homeAddress: import('../../../lib/state-machine').StateDefinition;
+    workAddress: import('../../../lib/state-machine').StateDefinition;
+    federalTaxes: import('../../../lib/state-machine').StateDefinition;
+    stateTaxes: import('../../../lib/state-machine').StateDefinition;
+    profile: import('../../../lib/state-machine').StateDefinition;
+    paymentBankForm: import('../../../lib/state-machine').StateDefinition;
+    paymentSplitView: import('../../../lib/state-machine').StateDefinition;
+    documentManager: import('../../../lib/state-machine').StateDefinition;
+    editDeduction: import('../../../lib/state-machine').StateDefinition;
+    addJob: import('../../../lib/state-machine').StateDefinition;
+    editCompensation: import('../../../lib/state-machine').StateDefinition;
+    addAnotherJob: import('../../../lib/state-machine').StateDefinition;
 };