@gusto/embedded-react-sdk 0.46.0 → 0.46.3

package/dist/components/Employee/WorkAddress/management/useWorkAddressManagement.js

@@ -1,67 +1,68 @@
-import { useState as N, useMemo as g } from "react";
-import { useEmployeeAddressesDeleteWorkAddressMutation as T } from "@gusto/embedded-api/react-query/employeeAddressesDeleteWorkAddress";
-import { useEmployeeAddressesGetWorkAddresses as C } from "@gusto/embedded-api/react-query/employeeAddressesGetWorkAddresses";
-import { useEmployeesGet as K } from "@gusto/embedded-api/react-query/employeesGet";
-import { useBaseSubmit as O } from "../../../Base/useBaseSubmit.js";
-import { useWorkAddressForm as W } from "../../Profile/shared/useWorkAddressForm/useWorkAddressForm.js";
-import { composeErrorHandler as Q } from "../../../../partner-hook-utils/composeErrorHandler.js";
-import { firstLastName as q } from "../../../../helpers/formattedStrings.js";
-import { normalizeToSDKError as G, SDKInternalError as n } from "../../../../types/sdkError.js";
-import { componentEvents as x } from "../../../../shared/constants.js";
-function te(e) {
+import { useState as T, useMemo as E } from "react";
+import { useEmployeeAddressesDeleteWorkAddressMutation as C } from "@gusto/embedded-api/react-query/employeeAddressesDeleteWorkAddress";
+import { useEmployeeAddressesGetWorkAddresses as K } from "@gusto/embedded-api/react-query/employeeAddressesGetWorkAddresses";
+import { useEmployeesGet as O } from "@gusto/embedded-api/react-query/employeesGet";
+import { useBaseSubmit as Q } from "../../../Base/useBaseSubmit.js";
+import { useWorkAddressForm as h } from "../../Profile/shared/useWorkAddressForm/useWorkAddressForm.js";
+import { composeErrorHandler as q } from "../../../../partner-hook-utils/composeErrorHandler.js";
+import { firstLastName as G } from "../../../../helpers/formattedStrings.js";
+import { normalizeToSDKError as x, SDKInternalError as d } from "../../../../types/sdkError.js";
+import { componentEvents as z } from "../../../../shared/constants.js";
+function ie(e) {
   return e.isLoading ? !1 : !e.status.isEmployeeError;
 }
-function z(e, d) {
+function B(e, n) {
   if (e.isLoading)
-    throw new n("Edit work address form is still loading");
-  if (d.isLoading)
-    throw new n("Change work address form is still loading");
+    throw new d("Edit work address form is still loading");
+  if (n.isLoading)
+    throw new d("Change work address form is still loading");
   return {
     editWorkAddressForm: e,
-    changeWorkAddressForm: d
+    changeWorkAddressForm: n
   };
 }
-function ie({
+function de({
   employeeId: e,
-  onEvent: d
+  onEvent: n
 }) {
   const {
-    baseSubmitHandler: h,
-    error: D,
-    setError: F
-  } = O("Employee.WorkAddress.Management"), l = T(), [t, S] = N(void 0), o = K({ employeeId: e }, { enabled: !!e }), a = o.data?.employee?.companyUuid, f = C(
+    baseSubmitHandler: D,
+    error: F,
+    setError: S
+  } = Q("Employee.WorkAddress.Management"), l = C(), [t, v] = T(void 0), o = O({ employeeId: e }, { enabled: !!e }), a = o.data?.employee?.companyUuid, f = K(
     { employeeId: e },
     { enabled: !!e && !!a }
-  ), r = f.data?.employeeWorkAddressesList, b = g(() => r?.length ? r.find((s) => s.active) ?? r[0] ?? null : null, [r]), v = t ?? b?.uuid, E = g(() => {
+  ), r = f.data?.employeeWorkAddressesList, b = E(() => r?.length ? r.find((s) => s.active) ?? r[0] ?? null : null, [r]), g = t ?? b?.uuid, p = E(() => {
     if (!(!t || !r))
       return r.find((s) => s.uuid === t);
-  }, [t, r]), R = E ? E.active !== !0 : !1, m = W({
+  }, [t, r]), R = g ? r?.find((s) => s.uuid === g) : void 0, M = p ? p.active !== !0 : !1, u = h({
     companyId: a,
     employeeId: e,
-    workAddressUuid: v,
-    withEffectiveDateField: R
-  }), u = W({
+    workAddressUuid: g,
+    initialAddress: R,
+    withEffectiveDateField: M
+  }), m = h({
     companyId: a,
     employeeId: e,
     withEffectiveDateField: !0
-  }), p = g(() => {
+  }), y = E(() => {
     const s = o.data?.employee;
-    return s ? q({
+    return s ? G({
       first_name: s.firstName,
       last_name: s.lastName
     }).trim() : "";
-  }, [o.data?.employee]), y = !!o.data?.employee && !a, i = Q(
+  }, [o.data?.employee]), k = !!o.data?.employee && !a, i = q(
     [
       o,
       f,
-      m,
       u,
-      ...y ? [
+      m,
+      ...k ? [
         {
           errorHandling: {
             errors: [
-              G(
-                new n(
+              x(
+                new d(
                   "Employee record is missing companyUuid, which is required to load work address locations."
                 )
               )
@@ -74,70 +75,70 @@ function ie({
         }
       ] : []
     ],
-    { submitError: D, setSubmitError: F }
-  ), k = {
-    setEditTargetUuid: S,
+    { submitError: F, setSubmitError: S }
+  ), A = {
+    setEditTargetUuid: v,
     confirmDeleteWorkAddress: async (s) => {
-      const _ = r?.find((c) => c.uuid === s) ?? null;
+      const H = r?.find((c) => c.uuid === s) ?? null;
       let w = !1;
-      return await h(
-        { workAddressUuid: s, snapshot: _ },
-        async ({ workAddressUuid: c, snapshot: A }) => {
-          const L = r?.find((H) => H.uuid === c);
+      return await D(
+        { workAddressUuid: s, snapshot: H },
+        async ({ workAddressUuid: c, snapshot: W }) => {
+          const L = r?.find((N) => N.uuid === c);
           if (!L)
-            throw new n("Work address not found");
+            throw new d("Work address not found");
           if (L.active === !0)
-            throw new n("Cannot delete the active work address");
+            throw new d("Cannot delete the active work address");
           await l.mutateAsync({
             request: { workAddressUuid: c }
-          }), w = !0, A && d(x.EMPLOYEE_WORK_ADDRESS_DELETED, A);
+          }), w = !0, W && n(z.EMPLOYEE_WORK_ADDRESS_DELETED, W);
         }
       ), w;
     }
-  }, M = {
-    employeeDisplayName: p,
+  }, U = {
+    employeeDisplayName: y,
     employeeWorkAddresses: r,
     editTargetUuid: t,
-    editWorkAddressForm: m,
-    changeWorkAddressForm: u
+    editWorkAddressForm: u,
+    changeWorkAddressForm: m
   };
   if (o.isLoading)
     return { isLoading: !0, errorHandling: i };
-  if (o.isError || y)
+  if (o.isError || k)
     return {
       isLoading: !1,
-      data: M,
+      data: U,
       status: {
         isDeletePending: l.isPending,
         isEmployeeError: !0
       },
       errorHandling: i,
-      actions: k
+      actions: A
     };
   if (f.isLoading)
     return { isLoading: !0, errorHandling: i };
-  if (m.isLoading || u.isLoading)
+  if (u.isLoading || m.isLoading)
     return { isLoading: !0, errorHandling: i };
-  const { editWorkAddressForm: U, changeWorkAddressForm: P } = z(m, u);
+  const { editWorkAddressForm: P, changeWorkAddressForm: _ } = B(u, m);
   return {
     isLoading: !1,
     data: {
-      employeeDisplayName: p,
+      employeeDisplayName: y,
       employeeWorkAddresses: r,
       editTargetUuid: t,
-      editWorkAddressForm: U,
-      changeWorkAddressForm: P
+      editWorkAddressForm: P,
+      changeWorkAddressForm: _
     },
     status: {
       isDeletePending: l.isPending,
       isEmployeeError: !1
     },
     errorHandling: i,
-    actions: k
+    actions: A
   };
 }
 export {
-  te as isUseWorkAddressManagementSuccess,
-  ie as useWorkAddressManagement
+  ie as isUseWorkAddressManagementSuccess,
+  de as useWorkAddressManagement
 };
 //# sourceMappingURL=useWorkAddressManagement.js.map

package/dist/components/Employee/WorkAddress/management/useWorkAddressManagement.js.map

@@ -1 +1 @@
-{"version":3,"file":"useWorkAddressManagement.js","sources":["../../../../../src/components/Employee/WorkAddress/management/useWorkAddressManagement.tsx"],"sourcesContent":["import { useMemo, useState } from 'react'\nimport type { EmployeeWorkAddress } from '@gusto/embedded-api/models/components/employeeworkaddress'\nimport { useEmployeeAddressesDeleteWorkAddressMutation } from '@gusto/embedded-api/react-query/employeeAddressesDeleteWorkAddress'\nimport { useEmployeeAddressesGetWorkAddresses } from '@gusto/embedded-api/react-query/employeeAddressesGetWorkAddresses'\nimport { useEmployeesGet } from '@gusto/embedded-api/react-query/employeesGet'\nimport type { OnEventType } from '@/components/Base/useBase'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { useWorkAddressForm } from '@/components/Employee/Profile/shared/useWorkAddressForm'\nimport type {\n  UseWorkAddressFormReady,\n  UseWorkAddressFormResult,\n} from '@/components/Employee/Profile/shared/useWorkAddressForm'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseHookReady,\n  HookErrorHandling,\n  HookLoadingResult,\n} from '@/partner-hook-utils/types'\nimport { firstLastName } from '@/helpers/formattedStrings'\nimport { normalizeToSDKError, SDKInternalError } from '@/types/sdkError'\nimport { componentEvents, type EventType } from '@/shared/constants'\n\nexport interface UseWorkAddressManagementParams {\n  employeeId: string\n  onEvent: OnEventType<EventType, unknown>\n}\n\nexport interface UseWorkAddressManagementDataPendingForms extends Record<string, unknown> {\n  employeeDisplayName: string\n  employeeWorkAddresses: EmployeeWorkAddress[] | undefined\n  editTargetUuid: string | undefined\n  editWorkAddressForm: UseWorkAddressFormResult\n  changeWorkAddressForm: UseWorkAddressFormResult\n}\n\nexport interface UseWorkAddressManagementDataReady extends Record<string, unknown> {\n  employeeDisplayName: string\n  employeeWorkAddresses: EmployeeWorkAddress[] | undefined\n  editTargetUuid: string | undefined\n  editWorkAddressForm: UseWorkAddressFormReady\n  changeWorkAddressForm: UseWorkAddressFormReady\n}\n\nexport interface UseWorkAddressManagementStatusEmployeeError extends Record<string, unknown> {\n  isDeletePending: boolean\n  isEmployeeError: true\n}\n\nexport interface UseWorkAddressManagementStatusSuccess extends Record<string, unknown> {\n  isDeletePending: boolean\n  isEmployeeError: false\n}\n\nexport interface UseWorkAddressManagementActions {\n  setEditTargetUuid: (workAddressUuid: string | undefined) => void\n  confirmDeleteWorkAddress: (workAddressUuid: string) => Promise<boolean>\n}\n\nexport interface UseWorkAddressManagementReadyEmployeeError extends BaseHookReady<\n  UseWorkAddressManagementDataPendingForms,\n  UseWorkAddressManagementStatusEmployeeError\n> {\n  actions: UseWorkAddressManagementActions\n}\n\nexport interface UseWorkAddressManagementReadySuccess extends BaseHookReady<\n  UseWorkAddressManagementDataReady,\n  UseWorkAddressManagementStatusSuccess\n> {\n  actions: UseWorkAddressManagementActions\n}\n\nexport type UseWorkAddressManagementReady =\n  | UseWorkAddressManagementReadyEmployeeError\n  | UseWorkAddressManagementReadySuccess\n\nexport type UseWorkAddressManagementResult = HookLoadingResult | UseWorkAddressManagementReady\n\nexport function isUseWorkAddressManagementSuccess(\n  value: UseWorkAddressManagementResult,\n): value is UseWorkAddressManagementReadySuccess {\n  if (value.isLoading) {\n    return false\n  }\n  return !value.status.isEmployeeError\n}\n\nfunction workAddressFormsReady(\n  editWorkAddressForm: UseWorkAddressFormResult,\n  changeWorkAddressForm: UseWorkAddressFormResult,\n): Pick<UseWorkAddressManagementDataReady, 'editWorkAddressForm' | 'changeWorkAddressForm'> {\n  if (editWorkAddressForm.isLoading) {\n    throw new SDKInternalError('Edit work address form is still loading')\n  }\n  if (changeWorkAddressForm.isLoading) {\n    throw new SDKInternalError('Change work address form is still loading')\n  }\n  return {\n    editWorkAddressForm,\n    changeWorkAddressForm,\n  }\n}\n\nexport function useWorkAddressManagement({\n  employeeId,\n  onEvent,\n}: UseWorkAddressManagementParams): UseWorkAddressManagementResult {\n  const {\n    baseSubmitHandler,\n    error: rootSubmitError,\n    setError: setRootSubmitError,\n  } = useBaseSubmit('Employee.WorkAddress.Management')\n  const deleteWorkAddressMutation = useEmployeeAddressesDeleteWorkAddressMutation()\n  const [editTargetUuid, setEditTargetUuid] = useState<string | undefined>(undefined)\n\n  const employeeQuery = useEmployeesGet({ employeeId }, { enabled: !!employeeId })\n  const companyId = employeeQuery.data?.employee?.companyUuid\n\n  const workAddressesQuery = useEmployeeAddressesGetWorkAddresses(\n    { employeeId },\n    { enabled: !!employeeId && !!companyId },\n  )\n\n  const employeeWorkAddresses = workAddressesQuery.data?.employeeWorkAddressesList\n\n  const currentWorkAddress = useMemo<EmployeeWorkAddress | null>(() => {\n    if (!employeeWorkAddresses?.length) {\n      return null\n    }\n    return employeeWorkAddresses.find(w => w.active) ?? employeeWorkAddresses[0] ?? null\n  }, [employeeWorkAddresses])\n\n  const workAddressUuidForEdit = editTargetUuid ?? currentWorkAddress?.uuid\n\n  const editInactiveRow = useMemo(() => {\n    if (!editTargetUuid || !employeeWorkAddresses) {\n      return undefined\n    }\n    return employeeWorkAddresses.find(w => w.uuid === editTargetUuid)\n  }, [editTargetUuid, employeeWorkAddresses])\n\n  const withEffectiveDateOnEdit = editInactiveRow ? editInactiveRow.active !== true : false\n\n  const editWorkAddressForm = useWorkAddressForm({\n    companyId,\n    employeeId,\n    workAddressUuid: workAddressUuidForEdit,\n    withEffectiveDateField: withEffectiveDateOnEdit,\n  })\n\n  const changeWorkAddressForm = useWorkAddressForm({\n    companyId,\n    employeeId,\n    withEffectiveDateField: true,\n  })\n\n  const employeeDisplayName = useMemo(() => {\n    const employee = employeeQuery.data?.employee\n    if (!employee) {\n      return ''\n    }\n    return firstLastName({\n      first_name: employee.firstName,\n      last_name: employee.lastName,\n    }).trim()\n  }, [employeeQuery.data?.employee])\n\n  const isMissingCompany = !!employeeQuery.data?.employee && !companyId\n\n  const errorHandling: HookErrorHandling = composeErrorHandler(\n    [\n      employeeQuery,\n      workAddressesQuery,\n      editWorkAddressForm,\n      changeWorkAddressForm,\n      ...(isMissingCompany\n        ? [\n            {\n              errorHandling: {\n                errors: [\n                  normalizeToSDKError(\n                    new SDKInternalError(\n                      'Employee record is missing companyUuid, which is required to load work address locations.',\n                    ),\n                  ),\n                ],\n                retryQueries: () => {},\n                clearSubmitError: () => {},\n              },\n            },\n          ]\n        : []),\n    ],\n    { submitError: rootSubmitError, setSubmitError: setRootSubmitError },\n  )\n\n  const confirmDeleteWorkAddress = async (workAddressUuid: string): Promise<boolean> => {\n    const snapshot = employeeWorkAddresses?.find(w => w.uuid === workAddressUuid) ?? null\n\n    let succeeded = false\n    await baseSubmitHandler(\n      { workAddressUuid, snapshot },\n      async ({ workAddressUuid: uuid, snapshot: snap }) => {\n        const target = employeeWorkAddresses?.find(w => w.uuid === uuid)\n        if (!target) {\n          throw new SDKInternalError('Work address not found')\n        }\n        if (target.active === true) {\n          throw new SDKInternalError('Cannot delete the active work address')\n        }\n\n        await deleteWorkAddressMutation.mutateAsync({\n          request: { workAddressUuid: uuid },\n        })\n        succeeded = true\n        if (snap) {\n          onEvent(componentEvents.EMPLOYEE_WORK_ADDRESS_DELETED, snap)\n        }\n      },\n    )\n    return succeeded\n  }\n\n  const actions: UseWorkAddressManagementActions = {\n    setEditTargetUuid,\n    confirmDeleteWorkAddress,\n  }\n\n  const dataPayloadPendingForms: UseWorkAddressManagementDataPendingForms = {\n    employeeDisplayName,\n    employeeWorkAddresses,\n    editTargetUuid,\n    editWorkAddressForm,\n    changeWorkAddressForm,\n  }\n\n  if (employeeQuery.isLoading) {\n    return { isLoading: true, errorHandling }\n  }\n\n  if (employeeQuery.isError || isMissingCompany) {\n    return {\n      isLoading: false,\n      data: dataPayloadPendingForms,\n      status: {\n        isDeletePending: deleteWorkAddressMutation.isPending,\n        isEmployeeError: true,\n      },\n      errorHandling,\n      actions,\n    }\n  }\n\n  if (workAddressesQuery.isLoading) {\n    return { isLoading: true, errorHandling }\n  }\n\n  const isFormsLoading = editWorkAddressForm.isLoading || changeWorkAddressForm.isLoading\n  if (isFormsLoading) {\n    return { isLoading: true, errorHandling }\n  }\n\n  const { editWorkAddressForm: editReady, changeWorkAddressForm: changeReady } =\n    workAddressFormsReady(editWorkAddressForm, changeWorkAddressForm)\n\n  const dataReady: UseWorkAddressManagementDataReady = {\n    employeeDisplayName,\n    employeeWorkAddresses,\n    editTargetUuid,\n    editWorkAddressForm: editReady,\n    changeWorkAddressForm: changeReady,\n  }\n\n  return {\n    isLoading: false,\n    data: dataReady,\n    status: {\n      isDeletePending: deleteWorkAddressMutation.isPending,\n      isEmployeeError: false,\n    },\n    errorHandling,\n    actions,\n  }\n}\n"],"names":["isUseWorkAddressManagementSuccess","value","workAddressFormsReady","editWorkAddressForm","changeWorkAddressForm","SDKInternalError","useWorkAddressManagement","employeeId","onEvent","baseSubmitHandler","rootSubmitError","setRootSubmitError","useBaseSubmit","deleteWorkAddressMutation","useEmployeeAddressesDeleteWorkAddressMutation","editTargetUuid","setEditTargetUuid","useState","employeeQuery","useEmployeesGet","companyId","workAddressesQuery","useEmployeeAddressesGetWorkAddresses","employeeWorkAddresses","currentWorkAddress","useMemo","w","workAddressUuidForEdit","editInactiveRow","withEffectiveDateOnEdit","useWorkAddressForm","employeeDisplayName","employee","firstLastName","isMissingCompany","errorHandling","composeErrorHandler","normalizeToSDKError","actions","workAddressUuid","snapshot","succeeded","uuid","snap","target","componentEvents","dataPayloadPendingForms","editReady","changeReady"],"mappings":"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"}
+{"version":3,"file":"useWorkAddressManagement.js","sources":["../../../../../src/components/Employee/WorkAddress/management/useWorkAddressManagement.tsx"],"sourcesContent":["import { useMemo, useState } from 'react'\nimport type { EmployeeWorkAddress } from '@gusto/embedded-api/models/components/employeeworkaddress'\nimport { useEmployeeAddressesDeleteWorkAddressMutation } from '@gusto/embedded-api/react-query/employeeAddressesDeleteWorkAddress'\nimport { useEmployeeAddressesGetWorkAddresses } from '@gusto/embedded-api/react-query/employeeAddressesGetWorkAddresses'\nimport { useEmployeesGet } from '@gusto/embedded-api/react-query/employeesGet'\nimport type { OnEventType } from '@/components/Base/useBase'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { useWorkAddressForm } from '@/components/Employee/Profile/shared/useWorkAddressForm'\nimport type {\n  UseWorkAddressFormReady,\n  UseWorkAddressFormResult,\n} from '@/components/Employee/Profile/shared/useWorkAddressForm'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseHookReady,\n  HookErrorHandling,\n  HookLoadingResult,\n} from '@/partner-hook-utils/types'\nimport { firstLastName } from '@/helpers/formattedStrings'\nimport { normalizeToSDKError, SDKInternalError } from '@/types/sdkError'\nimport { componentEvents, type EventType } from '@/shared/constants'\n\nexport interface UseWorkAddressManagementParams {\n  employeeId: string\n  onEvent: OnEventType<EventType, unknown>\n}\n\nexport interface UseWorkAddressManagementDataPendingForms extends Record<string, unknown> {\n  employeeDisplayName: string\n  employeeWorkAddresses: EmployeeWorkAddress[] | undefined\n  editTargetUuid: string | undefined\n  editWorkAddressForm: UseWorkAddressFormResult\n  changeWorkAddressForm: UseWorkAddressFormResult\n}\n\nexport interface UseWorkAddressManagementDataReady extends Record<string, unknown> {\n  employeeDisplayName: string\n  employeeWorkAddresses: EmployeeWorkAddress[] | undefined\n  editTargetUuid: string | undefined\n  editWorkAddressForm: UseWorkAddressFormReady\n  changeWorkAddressForm: UseWorkAddressFormReady\n}\n\nexport interface UseWorkAddressManagementStatusEmployeeError extends Record<string, unknown> {\n  isDeletePending: boolean\n  isEmployeeError: true\n}\n\nexport interface UseWorkAddressManagementStatusSuccess extends Record<string, unknown> {\n  isDeletePending: boolean\n  isEmployeeError: false\n}\n\nexport interface UseWorkAddressManagementActions {\n  setEditTargetUuid: (workAddressUuid: string | undefined) => void\n  confirmDeleteWorkAddress: (workAddressUuid: string) => Promise<boolean>\n}\n\nexport interface UseWorkAddressManagementReadyEmployeeError extends BaseHookReady<\n  UseWorkAddressManagementDataPendingForms,\n  UseWorkAddressManagementStatusEmployeeError\n> {\n  actions: UseWorkAddressManagementActions\n}\n\nexport interface UseWorkAddressManagementReadySuccess extends BaseHookReady<\n  UseWorkAddressManagementDataReady,\n  UseWorkAddressManagementStatusSuccess\n> {\n  actions: UseWorkAddressManagementActions\n}\n\nexport type UseWorkAddressManagementReady =\n  | UseWorkAddressManagementReadyEmployeeError\n  | UseWorkAddressManagementReadySuccess\n\nexport type UseWorkAddressManagementResult = HookLoadingResult | UseWorkAddressManagementReady\n\nexport function isUseWorkAddressManagementSuccess(\n  value: UseWorkAddressManagementResult,\n): value is UseWorkAddressManagementReadySuccess {\n  if (value.isLoading) {\n    return false\n  }\n  return !value.status.isEmployeeError\n}\n\nfunction workAddressFormsReady(\n  editWorkAddressForm: UseWorkAddressFormResult,\n  changeWorkAddressForm: UseWorkAddressFormResult,\n): Pick<UseWorkAddressManagementDataReady, 'editWorkAddressForm' | 'changeWorkAddressForm'> {\n  if (editWorkAddressForm.isLoading) {\n    throw new SDKInternalError('Edit work address form is still loading')\n  }\n  if (changeWorkAddressForm.isLoading) {\n    throw new SDKInternalError('Change work address form is still loading')\n  }\n  return {\n    editWorkAddressForm,\n    changeWorkAddressForm,\n  }\n}\n\nexport function useWorkAddressManagement({\n  employeeId,\n  onEvent,\n}: UseWorkAddressManagementParams): UseWorkAddressManagementResult {\n  const {\n    baseSubmitHandler,\n    error: rootSubmitError,\n    setError: setRootSubmitError,\n  } = useBaseSubmit('Employee.WorkAddress.Management')\n  const deleteWorkAddressMutation = useEmployeeAddressesDeleteWorkAddressMutation()\n  const [editTargetUuid, setEditTargetUuid] = useState<string | undefined>(undefined)\n\n  const employeeQuery = useEmployeesGet({ employeeId }, { enabled: !!employeeId })\n  const companyId = employeeQuery.data?.employee?.companyUuid\n\n  const workAddressesQuery = useEmployeeAddressesGetWorkAddresses(\n    { employeeId },\n    { enabled: !!employeeId && !!companyId },\n  )\n\n  const employeeWorkAddresses = workAddressesQuery.data?.employeeWorkAddressesList\n\n  const currentWorkAddress = useMemo<EmployeeWorkAddress | null>(() => {\n    if (!employeeWorkAddresses?.length) {\n      return null\n    }\n    return employeeWorkAddresses.find(w => w.active) ?? employeeWorkAddresses[0] ?? null\n  }, [employeeWorkAddresses])\n\n  const workAddressUuidForEdit = editTargetUuid ?? currentWorkAddress?.uuid\n\n  const editInactiveRow = useMemo(() => {\n    if (!editTargetUuid || !employeeWorkAddresses) {\n      return undefined\n    }\n    return employeeWorkAddresses.find(w => w.uuid === editTargetUuid)\n  }, [editTargetUuid, employeeWorkAddresses])\n\n  const editingWorkAddressRow = workAddressUuidForEdit\n    ? employeeWorkAddresses?.find(w => w.uuid === workAddressUuidForEdit)\n    : undefined\n\n  const withEffectiveDateOnEdit = editInactiveRow ? editInactiveRow.active !== true : false\n\n  const editWorkAddressForm = useWorkAddressForm({\n    companyId,\n    employeeId,\n    workAddressUuid: workAddressUuidForEdit,\n    initialAddress: editingWorkAddressRow,\n    withEffectiveDateField: withEffectiveDateOnEdit,\n  })\n\n  const changeWorkAddressForm = useWorkAddressForm({\n    companyId,\n    employeeId,\n    withEffectiveDateField: true,\n  })\n\n  const employeeDisplayName = useMemo(() => {\n    const employee = employeeQuery.data?.employee\n    if (!employee) {\n      return ''\n    }\n    return firstLastName({\n      first_name: employee.firstName,\n      last_name: employee.lastName,\n    }).trim()\n  }, [employeeQuery.data?.employee])\n\n  const isMissingCompany = !!employeeQuery.data?.employee && !companyId\n\n  const errorHandling: HookErrorHandling = composeErrorHandler(\n    [\n      employeeQuery,\n      workAddressesQuery,\n      editWorkAddressForm,\n      changeWorkAddressForm,\n      ...(isMissingCompany\n        ? [\n            {\n              errorHandling: {\n                errors: [\n                  normalizeToSDKError(\n                    new SDKInternalError(\n                      'Employee record is missing companyUuid, which is required to load work address locations.',\n                    ),\n                  ),\n                ],\n                retryQueries: () => {},\n                clearSubmitError: () => {},\n              },\n            },\n          ]\n        : []),\n    ],\n    { submitError: rootSubmitError, setSubmitError: setRootSubmitError },\n  )\n\n  const confirmDeleteWorkAddress = async (workAddressUuid: string): Promise<boolean> => {\n    const snapshot = employeeWorkAddresses?.find(w => w.uuid === workAddressUuid) ?? null\n\n    let succeeded = false\n    await baseSubmitHandler(\n      { workAddressUuid, snapshot },\n      async ({ workAddressUuid: uuid, snapshot: snap }) => {\n        const target = employeeWorkAddresses?.find(w => w.uuid === uuid)\n        if (!target) {\n          throw new SDKInternalError('Work address not found')\n        }\n        if (target.active === true) {\n          throw new SDKInternalError('Cannot delete the active work address')\n        }\n\n        await deleteWorkAddressMutation.mutateAsync({\n          request: { workAddressUuid: uuid },\n        })\n        succeeded = true\n        if (snap) {\n          onEvent(componentEvents.EMPLOYEE_WORK_ADDRESS_DELETED, snap)\n        }\n      },\n    )\n    return succeeded\n  }\n\n  const actions: UseWorkAddressManagementActions = {\n    setEditTargetUuid,\n    confirmDeleteWorkAddress,\n  }\n\n  const dataPayloadPendingForms: UseWorkAddressManagementDataPendingForms = {\n    employeeDisplayName,\n    employeeWorkAddresses,\n    editTargetUuid,\n    editWorkAddressForm,\n    changeWorkAddressForm,\n  }\n\n  if (employeeQuery.isLoading) {\n    return { isLoading: true, errorHandling }\n  }\n\n  if (employeeQuery.isError || isMissingCompany) {\n    return {\n      isLoading: false,\n      data: dataPayloadPendingForms,\n      status: {\n        isDeletePending: deleteWorkAddressMutation.isPending,\n        isEmployeeError: true,\n      },\n      errorHandling,\n      actions,\n    }\n  }\n\n  if (workAddressesQuery.isLoading) {\n    return { isLoading: true, errorHandling }\n  }\n\n  const isFormsLoading = editWorkAddressForm.isLoading || changeWorkAddressForm.isLoading\n  if (isFormsLoading) {\n    return { isLoading: true, errorHandling }\n  }\n\n  const { editWorkAddressForm: editReady, changeWorkAddressForm: changeReady } =\n    workAddressFormsReady(editWorkAddressForm, changeWorkAddressForm)\n\n  const dataReady: UseWorkAddressManagementDataReady = {\n    employeeDisplayName,\n    employeeWorkAddresses,\n    editTargetUuid,\n    editWorkAddressForm: editReady,\n    changeWorkAddressForm: changeReady,\n  }\n\n  return {\n    isLoading: false,\n    data: dataReady,\n    status: {\n      isDeletePending: deleteWorkAddressMutation.isPending,\n      isEmployeeError: false,\n    },\n    errorHandling,\n    actions,\n  }\n}\n"],"names":["isUseWorkAddressManagementSuccess","value","workAddressFormsReady","editWorkAddressForm","changeWorkAddressForm","SDKInternalError","useWorkAddressManagement","employeeId","onEvent","baseSubmitHandler","rootSubmitError","setRootSubmitError","useBaseSubmit","deleteWorkAddressMutation","useEmployeeAddressesDeleteWorkAddressMutation","editTargetUuid","setEditTargetUuid","useState","employeeQuery","useEmployeesGet","companyId","workAddressesQuery","useEmployeeAddressesGetWorkAddresses","employeeWorkAddresses","currentWorkAddress","useMemo","w","workAddressUuidForEdit","editInactiveRow","editingWorkAddressRow","withEffectiveDateOnEdit","useWorkAddressForm","employeeDisplayName","employee","firstLastName","isMissingCompany","errorHandling","composeErrorHandler","normalizeToSDKError","actions","workAddressUuid","snapshot","succeeded","uuid","snap","target","componentEvents","dataPayloadPendingForms","editReady","changeReady"],"mappings":"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"}

package/dist/components/Employee/exports/employeeManagement.d.ts

@@ -1,4 +1,6 @@
 export { ManagementEmployeeList as EmployeeList } from '../EmployeeList/management/ManagementEmployeeList';
+export { EmployeeListFlow } from '../EmployeeListFlow';
+export type { EmployeeListFlowProps } from '../EmployeeListFlow';
 /** @deprecated Use EmployeeOnboarding.EmployeeDocuments; not applicable for post-onboarding flows. Will be removed in a future version. */
 export { EmployeeDocuments } from '../Documents/onboarding/EmployeeDocuments';
 export { DocumentManager } from '../Documents/management/DocumentManager';

package/dist/components/Employee/exports/employeeManagement.js

@@ -1,27 +1,29 @@
 import { ManagementEmployeeList as r } from "../EmployeeList/management/ManagementEmployeeList.js";
 import { DocumentManager as t } from "../Documents/management/DocumentManager.js";
-import { WorkAddress as p } from "../WorkAddress/management/WorkAddress.js";
+import { WorkAddress as a } from "../WorkAddress/management/WorkAddress.js";
 import { FederalTaxes as f } from "../FederalTaxes/management/FederalTaxes.js";
-import { StateTaxes as s } from "../StateTaxes/management/StateTaxes.js";
-import { Profile as l } from "../Profile/management/Profile.js";
+import { StateTaxes as l } from "../StateTaxes/management/StateTaxes.js";
+import { Profile as i } from "../Profile/management/Profile.js";
 import { TerminateEmployee as d } from "../Terminations/TerminateEmployee/TerminateEmployee.js";
-import { TerminationSummary as E } from "../Terminations/TerminationSummary/TerminationSummary.js";
-import { TerminationFlow as D } from "../Terminations/TerminationFlow/TerminationFlow.js";
-import { DashboardFlow as M } from "../Dashboard/DashboardFlow.js";
-import { EmployeeDocuments as g } from "../Documents/onboarding/EmployeeDocuments/EmployeeDocuments.js";
-import { PaymentMethod as w } from "../PaymentMethod/management/PaymentMethod.js";
+import { TerminationSummary as T } from "../Terminations/TerminationSummary/TerminationSummary.js";
+import { TerminationFlow as u } from "../Terminations/TerminationFlow/TerminationFlow.js";
+import { DashboardFlow as D } from "../Dashboard/DashboardFlow.js";
+import { EmployeeDocuments as M } from "../Documents/onboarding/EmployeeDocuments/EmployeeDocuments.js";
+import { EmployeeListFlow as g } from "../EmployeeListFlow/EmployeeListFlow.js";
+import { PaymentMethod as P } from "../PaymentMethod/management/PaymentMethod.js";
 export {
-  M as DashboardFlow,
+  D as DashboardFlow,
   t as DocumentManager,
-  g as EmployeeDocuments,
+  M as EmployeeDocuments,
   r as EmployeeList,
+  g as EmployeeListFlow,
   f as FederalTaxes,
-  w as PaymentMethod,
-  l as Profile,
-  s as StateTaxes,
+  P as PaymentMethod,
+  i as Profile,
+  l as StateTaxes,
   d as TerminateEmployee,
-  D as TerminationFlow,
-  E as TerminationSummary,
-  p as WorkAddress
+  u as TerminationFlow,
+  T as TerminationSummary,
+  a as WorkAddress
 };
 //# sourceMappingURL=employeeManagement.js.map

package/dist/components/Employee/exports/employeeManagement.js.map

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

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

@@ -15,6 +15,8 @@ export { SelfOnboardingFlow } from './SelfOnboardingFlow/SelfOnboardingFlow';
 export { EmployeeDocuments } from './Documents/onboarding/EmployeeDocuments';
 export { DashboardFlow } from './Dashboard';
 export type { DashboardFlowProps } from './Dashboard';
+export { EmployeeListFlow } from './EmployeeListFlow';
+export type { EmployeeListFlowProps } from './EmployeeListFlow';
 export { HomeAddress } from './HomeAddress/management/HomeAddress';
 export type { HomeAddressProps } from './HomeAddress/management/HomeAddress';
 export { EmploymentEligibility } from './Documents/onboarding/DocumentSigner/EmploymentEligibility';

package/dist/components/Employee/index.js

@@ -2,44 +2,46 @@ import { EmployeeList as e } from "./EmployeeList/onboarding/EmployeeList.js";
 import { Profile as t } from "./Profile/onboarding/Profile.js";
 import { OnboardingFlow as x } from "./OnboardingFlow/OnboardingFlow.js";
 import { SelfOnboardingFlow as n } from "./SelfOnboardingFlow/SelfOnboardingFlow.js";
-import { HomeAddress as i } from "./HomeAddress/management/HomeAddress.js";
-import { TerminateEmployee as d } from "./Terminations/TerminateEmployee/TerminateEmployee.js";
+import { HomeAddress as a } from "./HomeAddress/management/HomeAddress.js";
+import { TerminateEmployee as s } from "./Terminations/TerminateEmployee/TerminateEmployee.js";
 import { TerminationSummary as y } from "./Terminations/TerminationSummary/TerminationSummary.js";
-import { TerminationFlow as T } from "./Terminations/TerminationFlow/TerminationFlow.js";
-import { WorkAddress as u } from "./WorkAddress/management/WorkAddress.js";
-import { Compensation as F } from "./Compensation/onboarding/Compensation.js";
-import { DashboardFlow as w } from "./Dashboard/DashboardFlow.js";
+import { TerminationFlow as E } from "./Terminations/TerminationFlow/TerminationFlow.js";
+import { WorkAddress as T } from "./WorkAddress/management/WorkAddress.js";
+import { Compensation as u } from "./Compensation/onboarding/Compensation.js";
+import { DashboardFlow as S } from "./Dashboard/DashboardFlow.js";
 import { Deductions as c } from "./Deductions/Deductions.js";
-import { DocumentSigner as h } from "./Documents/onboarding/DocumentSigner/DocumentSigner.js";
-import { EmployeeDocuments as L } from "./Documents/onboarding/EmployeeDocuments/EmployeeDocuments.js";
-import { EmploymentEligibility as k } from "./Documents/onboarding/DocumentSigner/EmploymentEligibility/EmploymentEligibility.js";
-import { FederalTaxes as H } from "./FederalTaxes/management/FederalTaxes.js";
-import { Landing as W } from "./Landing/Landing.js";
-import { OnboardingSummary as q } from "./OnboardingSummary/OnboardingSummary.js";
-import { PaymentMethod as z } from "./PaymentMethod/onboarding/PaymentMethod.js";
-import { StateTaxes as G } from "./StateTaxes/management/StateTaxes.js";
-import { Taxes as J } from "./Taxes/Taxes.js";
+import { DocumentSigner as O } from "./Documents/onboarding/DocumentSigner/DocumentSigner.js";
+import { EmployeeDocuments as A } from "./Documents/onboarding/EmployeeDocuments/EmployeeDocuments.js";
+import { EmployeeListFlow as k } from "./EmployeeListFlow/EmployeeListFlow.js";
+import { EmploymentEligibility as H } from "./Documents/onboarding/DocumentSigner/EmploymentEligibility/EmploymentEligibility.js";
+import { FederalTaxes as W } from "./FederalTaxes/management/FederalTaxes.js";
+import { Landing as q } from "./Landing/Landing.js";
+import { OnboardingSummary as z } from "./OnboardingSummary/OnboardingSummary.js";
+import { PaymentMethod as G } from "./PaymentMethod/onboarding/PaymentMethod.js";
+import { StateTaxes as J } from "./StateTaxes/management/StateTaxes.js";
+import { Taxes as N } from "./Taxes/Taxes.js";
 export {
-  F as Compensation,
-  w as DashboardFlow,
+  u as Compensation,
+  S as DashboardFlow,
   c as Deductions,
-  h as DocumentSigner,
-  L as EmployeeDocuments,
+  O as DocumentSigner,
+  A as EmployeeDocuments,
   e as EmployeeList,
-  k as EmploymentEligibility,
-  H as FederalTaxes,
-  i as HomeAddress,
-  W as Landing,
+  k as EmployeeListFlow,
+  H as EmploymentEligibility,
+  W as FederalTaxes,
+  a as HomeAddress,
+  q as Landing,
   x as OnboardingFlow,
-  q as OnboardingSummary,
-  z as PaymentMethod,
+  z as OnboardingSummary,
+  G as PaymentMethod,
   t as Profile,
   n as SelfOnboardingFlow,
-  G as StateTaxes,
-  J as Taxes,
-  d as TerminateEmployee,
-  T as TerminationFlow,
+  J as StateTaxes,
+  N as Taxes,
+  s as TerminateEmployee,
+  E as TerminationFlow,
   y as TerminationSummary,
-  u as WorkAddress
+  T as WorkAddress
 };
 //# sourceMappingURL=index.js.map

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

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

package/dist/components/Flow/FlowHeader.js

@@ -1,21 +1,21 @@
-import { jsx as r, jsxs as s } from "react/jsx-runtime";
-import { useTranslation as i } from "react-i18next";
-import { FlowBreadcrumbs as d } from "../Common/FlowBreadcrumbs/FlowBreadcrumbs.js";
-import { Flex as m, FlexItem as c } from "../Common/Flex/Flex.js";
+import { jsx as r, jsxs as i } from "react/jsx-runtime";
+import { useTranslation as m } from "react-i18next";
+import { FlowBreadcrumbs as f } from "../Common/FlowBreadcrumbs/FlowBreadcrumbs.js";
+import { Flex as l, FlexItem as a } from "../Common/Flex/Flex.js";
 import "classnames";
-import { componentEvents as p } from "../../shared/constants.js";
-import { useFlow as a } from "./useFlow.js";
+import { componentEvents as b } from "../../shared/constants.js";
+import { useFlow as s } from "./useFlow.js";
 import { useComponentContext as u } from "../../contexts/ComponentAdapter/useComponentContext.js";
-import f from "../../assets/icons/caret-left.svg.js";
-function H() {
-  const { header: e, component: t } = a();
+import h from "../../assets/icons/caret-left.svg.js";
+function L() {
+  const { header: e, component: t } = s();
   if (!e || !t) return null;
   switch (e.type) {
     case "minimal":
-      return /* @__PURE__ */ r(b, { cta: e.cta });
+      return /* @__PURE__ */ r(w, { back: e.back, cta: e.cta });
     case "progress":
       return /* @__PURE__ */ r(
-        h,
+        x,
         {
           currentStep: e.currentStep,
           totalSteps: e.totalSteps,
@@ -24,7 +24,7 @@ function H() {
       );
     case "breadcrumbs":
       return e.currentBreadcrumbId ? /* @__PURE__ */ r(
-        w,
+        v,
         {
           currentBreadcrumbId: e.currentBreadcrumbId,
           breadcrumbs: e.breadcrumbs,
@@ -33,58 +33,61 @@ function H() {
       ) : null;
   }
 }
-function b({ cta: e }) {
-  const { onEvent: t } = a(), n = u(), { t: o } = i();
-  return /* @__PURE__ */ s(m, { flexDirection: "row", justifyContent: "space-between", alignItems: "center", children: [
-    /* @__PURE__ */ r(c, { children: /* @__PURE__ */ r(
-      n.Button,
+function w({
+  back: e,
+  cta: t
+}) {
+  const { onEvent: n } = s(), o = u(), { t: c } = m(e?.namespace), d = c(e ? e.labelKey : "back"), p = e?.event ?? b.CANCEL;
+  return /* @__PURE__ */ i(l, { flexDirection: "row", justifyContent: "space-between", alignItems: "center", children: [
+    /* @__PURE__ */ r(a, { children: /* @__PURE__ */ r(
+      o.Button,
       {
         variant: "secondary",
-        icon: /* @__PURE__ */ r(f, { "aria-hidden": "true" }),
+        icon: /* @__PURE__ */ r(h, { "aria-hidden": "true" }),
         onClick: () => {
-          t(p.CANCEL, void 0);
+          n(p, void 0);
         },
-        children: o("back")
+        children: d
       }
     ) }),
-    e && /* @__PURE__ */ r(c, { children: /* @__PURE__ */ r(e, {}) })
+    t && /* @__PURE__ */ r(a, { children: /* @__PURE__ */ r(t, {}) })
   ] });
 }
-function h({
+function x({
   currentStep: e,
   totalSteps: t,
   cta: n
 }) {
-  const o = u(), { t: l } = i();
+  const o = u(), { t: c } = m();
   return /* @__PURE__ */ r(
     o.ProgressBar,
     {
       totalSteps: t,
       currentStep: e,
-      label: l("progressBarLabel", { totalSteps: t, currentStep: e }),
+      label: c("progressBarLabel", { totalSteps: t, currentStep: e }),
       cta: n
     }
   );
 }
-function w({
+function v({
   currentBreadcrumbId: e,
   breadcrumbs: t = {},
   cta: n
 }) {
-  const { onEvent: o } = a();
-  return /* @__PURE__ */ s(m, { flexDirection: "row", justifyContent: "space-between", alignItems: "center", children: [
-    /* @__PURE__ */ r(c, { flexGrow: 1, children: /* @__PURE__ */ r(
-      d,
+  const { onEvent: o } = s();
+  return /* @__PURE__ */ i(l, { flexDirection: "row", justifyContent: "space-between", alignItems: "center", children: [
+    /* @__PURE__ */ r(a, { flexGrow: 1, children: /* @__PURE__ */ r(
+      f,
       {
         breadcrumbs: e ? t[e] ?? [] : [],
         currentBreadcrumbId: e,
         onEvent: o
       }
     ) }),
-    /* @__PURE__ */ r(c, { children: n && /* @__PURE__ */ r(n, {}) })
+    /* @__PURE__ */ r(a, { children: n && /* @__PURE__ */ r(n, {}) })
   ] });
 }
 export {
-  H as FlowHeader
+  L as FlowHeader
 };
 //# sourceMappingURL=FlowHeader.js.map

package/dist/components/Flow/FlowHeader.js.map

@@ -1 +1 @@
-{"version":3,"file":"FlowHeader.js","sources":["../../../src/components/Flow/FlowHeader.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { FlowBreadcrumbs } from '../Common/FlowBreadcrumbs/FlowBreadcrumbs'\nimport type { BreadcrumbTrail } from '../Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\nimport { Flex } from '../Common/Flex'\nimport { FlexItem } from '../Common'\nimport { useFlow } from './useFlow'\nimport { componentEvents } from '@/shared/constants'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport CaretLeftIcon from '@/assets/icons/caret-left.svg?react'\n\n/**\n * Renders the chrome above the active flow component (back affordance,\n * progress bar, breadcrumbs, ...). Layout is driven by a single\n * discriminated `header` field on the flow context. Each variant maps to a\n * focused renderer below:\n *\n *   header.type === 'minimal'     → MinimalHeader\n *   header.type === 'progress'    → ProgressHeader\n *   header.type === 'breadcrumbs' → BreadcrumbsHeader\n *\n * To add a new piece of chrome:\n *   1. Add a new variant to `FlowHeaderConfig` in `useFlow.ts`.\n *   2. Add a new renderer function below.\n *   3. Branch on it in `FlowHeader`.\n */\nexport function FlowHeader() {\n  const { header, component } = useFlow()\n\n  if (!header || !component) return null\n\n  switch (header.type) {\n    case 'minimal':\n      return <MinimalHeader cta={header.cta} />\n    case 'progress':\n      return (\n        <ProgressHeader\n          currentStep={header.currentStep}\n          totalSteps={header.totalSteps}\n          cta={header.cta}\n        />\n      )\n    case 'breadcrumbs':\n      // The breadcrumb trail is intentionally persisted across \"passive\"\n      // states (e.g. landing screens) so that subsequent transitions can\n      // pick up where they left off without rebuilding it. We render the\n      // bar only when there's an active breadcrumb to show; otherwise\n      // we treat the flow as \"no chrome\" for this state.\n      if (!header.currentBreadcrumbId) return null\n      return (\n        <BreadcrumbsHeader\n          currentBreadcrumbId={header.currentBreadcrumbId}\n          breadcrumbs={header.breadcrumbs}\n          cta={header.cta}\n        />\n      )\n  }\n}\n\nfunction MinimalHeader({ cta: Cta }: { cta?: React.ComponentType }) {\n  const { onEvent } = useFlow()\n  const Components = useComponentContext()\n  const { t } = useTranslation()\n\n  return (\n    <Flex flexDirection=\"row\" justifyContent=\"space-between\" alignItems=\"center\">\n      <FlexItem>\n        <Components.Button\n          variant=\"secondary\"\n          icon={<CaretLeftIcon aria-hidden=\"true\" />}\n          onClick={() => {\n            onEvent(componentEvents.CANCEL, undefined)\n          }}\n        >\n          {t('back')}\n        </Components.Button>\n      </FlexItem>\n      {Cta && (\n        <FlexItem>\n          <Cta />\n        </FlexItem>\n      )}\n    </Flex>\n  )\n}\n\nfunction ProgressHeader({\n  currentStep,\n  totalSteps,\n  cta: Cta,\n}: {\n  currentStep: number\n  totalSteps: number\n  cta?: React.ComponentType\n}) {\n  const Components = useComponentContext()\n  const { t } = useTranslation()\n\n  return (\n    <Components.ProgressBar\n      totalSteps={totalSteps}\n      currentStep={currentStep}\n      label={t('progressBarLabel', { totalSteps, currentStep })}\n      cta={Cta}\n    />\n  )\n}\n\nfunction BreadcrumbsHeader({\n  currentBreadcrumbId,\n  breadcrumbs = {},\n  cta: Cta,\n}: {\n  currentBreadcrumbId?: string\n  breadcrumbs?: BreadcrumbTrail\n  cta?: React.ComponentType\n}) {\n  const { onEvent } = useFlow()\n\n  return (\n    <Flex flexDirection=\"row\" justifyContent=\"space-between\" alignItems=\"center\">\n      <FlexItem flexGrow={1}>\n        <FlowBreadcrumbs\n          breadcrumbs={currentBreadcrumbId ? (breadcrumbs[currentBreadcrumbId] ?? []) : []}\n          currentBreadcrumbId={currentBreadcrumbId}\n          onEvent={onEvent}\n        />\n      </FlexItem>\n      <FlexItem>{Cta && <Cta />}</FlexItem>\n    </Flex>\n  )\n}\n"],"names":["FlowHeader","header","component","useFlow","jsx","MinimalHeader","ProgressHeader","BreadcrumbsHeader","Cta","onEvent","Components","useComponentContext","t","useTranslation","Flex","FlexItem","CaretLeftIcon","componentEvents","currentStep","totalSteps","currentBreadcrumbId","breadcrumbs","FlowBreadcrumbs"],"mappings":";;;;;;;;;AAyBO,SAASA,IAAa;AAC3B,QAAM,EAAE,QAAAC,GAAQ,WAAAC,EAAA,IAAcC,EAAA;AAE9B,MAAI,CAACF,KAAU,CAACC,EAAW,QAAO;AAElC,UAAQD,EAAO,MAAA;AAAA,IACb,KAAK;AACH,aAAO,gBAAAG,EAACC,GAAA,EAAc,KAAKJ,EAAO,IAAA,CAAK;AAAA,IACzC,KAAK;AACH,aACE,gBAAAG;AAAA,QAACE;AAAA,QAAA;AAAA,UACC,aAAaL,EAAO;AAAA,UACpB,YAAYA,EAAO;AAAA,UACnB,KAAKA,EAAO;AAAA,QAAA;AAAA,MAAA;AAAA,IAGlB,KAAK;AAMH,aAAKA,EAAO,sBAEV,gBAAAG;AAAA,QAACG;AAAA,QAAA;AAAA,UACC,qBAAqBN,EAAO;AAAA,UAC5B,aAAaA,EAAO;AAAA,UACpB,KAAKA,EAAO;AAAA,QAAA;AAAA,MAAA,IALwB;AAAA,EAMtC;AAGR;AAEA,SAASI,EAAc,EAAE,KAAKG,KAAsC;AAClE,QAAM,EAAE,SAAAC,EAAA,IAAYN,EAAA,GACdO,IAAaC,EAAA,GACb,EAAE,GAAAC,EAAA,IAAMC,EAAA;AAEd,2BACGC,GAAA,EAAK,eAAc,OAAM,gBAAe,iBAAgB,YAAW,UAClE,UAAA;AAAA,IAAA,gBAAAV,EAACW,GAAA,EACC,UAAA,gBAAAX;AAAA,MAACM,EAAW;AAAA,MAAX;AAAA,QACC,SAAQ;AAAA,QACR,MAAM,gBAAAN,EAACY,GAAA,EAAc,eAAY,OAAA,CAAO;AAAA,QACxC,SAAS,MAAM;AACb,UAAAP,EAAQQ,EAAgB,QAAQ,MAAS;AAAA,QAC3C;AAAA,QAEC,YAAE,MAAM;AAAA,MAAA;AAAA,IAAA,GAEb;AAAA,IACCT,KACC,gBAAAJ,EAACW,GAAA,EACC,UAAA,gBAAAX,EAACI,KAAI,EAAA,CACP;AAAA,EAAA,GAEJ;AAEJ;AAEA,SAASF,EAAe;AAAA,EACtB,aAAAY;AAAA,EACA,YAAAC;AAAA,EACA,KAAKX;AACP,GAIG;AACD,QAAME,IAAaC,EAAA,GACb,EAAE,GAAAC,EAAA,IAAMC,EAAA;AAEd,SACE,gBAAAT;AAAA,IAACM,EAAW;AAAA,IAAX;AAAA,MACC,YAAAS;AAAA,MACA,aAAAD;AAAA,MACA,OAAON,EAAE,oBAAoB,EAAE,YAAAO,GAAY,aAAAD,GAAa;AAAA,MACxD,KAAKV;AAAA,IAAA;AAAA,EAAA;AAGX;AAEA,SAASD,EAAkB;AAAA,EACzB,qBAAAa;AAAA,EACA,aAAAC,IAAc,CAAA;AAAA,EACd,KAAKb;AACP,GAIG;AACD,QAAM,EAAE,SAAAC,EAAA,IAAYN,EAAA;AAEpB,2BACGW,GAAA,EAAK,eAAc,OAAM,gBAAe,iBAAgB,YAAW,UAClE,UAAA;AAAA,IAAA,gBAAAV,EAACW,GAAA,EAAS,UAAU,GAClB,UAAA,gBAAAX;AAAA,MAACkB;AAAA,MAAA;AAAA,QACC,aAAaF,IAAuBC,EAAYD,CAAmB,KAAK,CAAA,IAAM,CAAA;AAAA,QAC9E,qBAAAA;AAAA,QACA,SAAAX;AAAA,MAAA;AAAA,IAAA,GAEJ;AAAA,IACA,gBAAAL,EAACW,GAAA,EAAU,UAAAP,KAAO,gBAAAJ,EAACI,KAAI,EAAA,CAAG;AAAA,EAAA,GAC5B;AAEJ;"}
+{"version":3,"file":"FlowHeader.js","sources":["../../../src/components/Flow/FlowHeader.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport type { CustomTypeOptions } from 'i18next'\nimport { FlowBreadcrumbs } from '../Common/FlowBreadcrumbs/FlowBreadcrumbs'\nimport type { BreadcrumbTrail } from '../Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\nimport { Flex } from '../Common/Flex'\nimport { FlexItem } from '../Common'\nimport { useFlow } from './useFlow'\nimport { componentEvents, type EventType } from '@/shared/constants'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport CaretLeftIcon from '@/assets/icons/caret-left.svg?react'\n\n/**\n * Renders the chrome above the active flow component (back affordance,\n * progress bar, breadcrumbs, ...). Layout is driven by a single\n * discriminated `header` field on the flow context. Each variant maps to a\n * focused renderer below:\n *\n *   header.type === 'minimal'     → MinimalHeader\n *   header.type === 'progress'    → ProgressHeader\n *   header.type === 'breadcrumbs' → BreadcrumbsHeader\n *\n * To add a new piece of chrome:\n *   1. Add a new variant to `FlowHeaderConfig` in `useFlow.ts`.\n *   2. Add a new renderer function below.\n *   3. Branch on it in `FlowHeader`.\n */\nexport function FlowHeader() {\n  const { header, component } = useFlow()\n\n  if (!header || !component) return null\n\n  switch (header.type) {\n    case 'minimal':\n      return <MinimalHeader back={header.back} cta={header.cta} />\n    case 'progress':\n      return (\n        <ProgressHeader\n          currentStep={header.currentStep}\n          totalSteps={header.totalSteps}\n          cta={header.cta}\n        />\n      )\n    case 'breadcrumbs':\n      // The breadcrumb trail is intentionally persisted across \"passive\"\n      // states (e.g. landing screens) so that subsequent transitions can\n      // pick up where they left off without rebuilding it. We render the\n      // bar only when there's an active breadcrumb to show; otherwise\n      // we treat the flow as \"no chrome\" for this state.\n      if (!header.currentBreadcrumbId) return null\n      return (\n        <BreadcrumbsHeader\n          currentBreadcrumbId={header.currentBreadcrumbId}\n          breadcrumbs={header.breadcrumbs}\n          cta={header.cta}\n        />\n      )\n  }\n}\n\nfunction MinimalHeader({\n  back,\n  cta: Cta,\n}: {\n  back?: {\n    labelKey: string\n    namespace: keyof CustomTypeOptions['resources']\n    event: EventType\n  }\n  cta?: React.ComponentType\n}) {\n  const { onEvent } = useFlow()\n  const Components = useComponentContext()\n  const { t } = useTranslation(back?.namespace)\n\n  const label = back ? t(back.labelKey as never) : t('back')\n  const event = back?.event ?? componentEvents.CANCEL\n\n  return (\n    <Flex flexDirection=\"row\" justifyContent=\"space-between\" alignItems=\"center\">\n      <FlexItem>\n        <Components.Button\n          variant=\"secondary\"\n          icon={<CaretLeftIcon aria-hidden=\"true\" />}\n          onClick={() => {\n            onEvent(event, undefined)\n          }}\n        >\n          {label}\n        </Components.Button>\n      </FlexItem>\n      {Cta && (\n        <FlexItem>\n          <Cta />\n        </FlexItem>\n      )}\n    </Flex>\n  )\n}\n\nfunction ProgressHeader({\n  currentStep,\n  totalSteps,\n  cta: Cta,\n}: {\n  currentStep: number\n  totalSteps: number\n  cta?: React.ComponentType\n}) {\n  const Components = useComponentContext()\n  const { t } = useTranslation()\n\n  return (\n    <Components.ProgressBar\n      totalSteps={totalSteps}\n      currentStep={currentStep}\n      label={t('progressBarLabel', { totalSteps, currentStep })}\n      cta={Cta}\n    />\n  )\n}\n\nfunction BreadcrumbsHeader({\n  currentBreadcrumbId,\n  breadcrumbs = {},\n  cta: Cta,\n}: {\n  currentBreadcrumbId?: string\n  breadcrumbs?: BreadcrumbTrail\n  cta?: React.ComponentType\n}) {\n  const { onEvent } = useFlow()\n\n  return (\n    <Flex flexDirection=\"row\" justifyContent=\"space-between\" alignItems=\"center\">\n      <FlexItem flexGrow={1}>\n        <FlowBreadcrumbs\n          breadcrumbs={currentBreadcrumbId ? (breadcrumbs[currentBreadcrumbId] ?? []) : []}\n          currentBreadcrumbId={currentBreadcrumbId}\n          onEvent={onEvent}\n        />\n      </FlexItem>\n      <FlexItem>{Cta && <Cta />}</FlexItem>\n    </Flex>\n  )\n}\n"],"names":["FlowHeader","header","component","useFlow","MinimalHeader","jsx","ProgressHeader","BreadcrumbsHeader","back","Cta","onEvent","Components","useComponentContext","t","useTranslation","label","event","componentEvents","Flex","FlexItem","CaretLeftIcon","currentStep","totalSteps","currentBreadcrumbId","breadcrumbs","FlowBreadcrumbs"],"mappings":";;;;;;;;;AA0BO,SAASA,IAAa;AAC3B,QAAM,EAAE,QAAAC,GAAQ,WAAAC,EAAA,IAAcC,EAAA;AAE9B,MAAI,CAACF,KAAU,CAACC,EAAW,QAAO;AAElC,UAAQD,EAAO,MAAA;AAAA,IACb,KAAK;AACH,+BAAQG,GAAA,EAAc,MAAMH,EAAO,MAAM,KAAKA,EAAO,KAAK;AAAA,IAC5D,KAAK;AACH,aACE,gBAAAI;AAAA,QAACC;AAAA,QAAA;AAAA,UACC,aAAaL,EAAO;AAAA,UACpB,YAAYA,EAAO;AAAA,UACnB,KAAKA,EAAO;AAAA,QAAA;AAAA,MAAA;AAAA,IAGlB,KAAK;AAMH,aAAKA,EAAO,sBAEV,gBAAAI;AAAA,QAACE;AAAA,QAAA;AAAA,UACC,qBAAqBN,EAAO;AAAA,UAC5B,aAAaA,EAAO;AAAA,UACpB,KAAKA,EAAO;AAAA,QAAA;AAAA,MAAA,IALwB;AAAA,EAMtC;AAGR;AAEA,SAASG,EAAc;AAAA,EACrB,MAAAI;AAAA,EACA,KAAKC;AACP,GAOG;AACD,QAAM,EAAE,SAAAC,EAAA,IAAYP,EAAA,GACdQ,IAAaC,EAAA,GACb,EAAE,GAAAC,EAAA,IAAMC,EAAeN,GAAM,SAAS,GAEtCO,IAAeF,EAAPL,IAASA,EAAK,WAAuB,MAAN,GACvCQ,IAAQR,GAAM,SAASS,EAAgB;AAE7C,2BACGC,GAAA,EAAK,eAAc,OAAM,gBAAe,iBAAgB,YAAW,UAClE,UAAA;AAAA,IAAA,gBAAAb,EAACc,GAAA,EACC,UAAA,gBAAAd;AAAA,MAACM,EAAW;AAAA,MAAX;AAAA,QACC,SAAQ;AAAA,QACR,MAAM,gBAAAN,EAACe,GAAA,EAAc,eAAY,OAAA,CAAO;AAAA,QACxC,SAAS,MAAM;AACb,UAAAV,EAAQM,GAAO,MAAS;AAAA,QAC1B;AAAA,QAEC,UAAAD;AAAA,MAAA;AAAA,IAAA,GAEL;AAAA,IACCN,KACC,gBAAAJ,EAACc,GAAA,EACC,UAAA,gBAAAd,EAACI,KAAI,EAAA,CACP;AAAA,EAAA,GAEJ;AAEJ;AAEA,SAASH,EAAe;AAAA,EACtB,aAAAe;AAAA,EACA,YAAAC;AAAA,EACA,KAAKb;AACP,GAIG;AACD,QAAME,IAAaC,EAAA,GACb,EAAE,GAAAC,EAAA,IAAMC,EAAA;AAEd,SACE,gBAAAT;AAAA,IAACM,EAAW;AAAA,IAAX;AAAA,MACC,YAAAW;AAAA,MACA,aAAAD;AAAA,MACA,OAAOR,EAAE,oBAAoB,EAAE,YAAAS,GAAY,aAAAD,GAAa;AAAA,MACxD,KAAKZ;AAAA,IAAA;AAAA,EAAA;AAGX;AAEA,SAASF,EAAkB;AAAA,EACzB,qBAAAgB;AAAA,EACA,aAAAC,IAAc,CAAA;AAAA,EACd,KAAKf;AACP,GAIG;AACD,QAAM,EAAE,SAAAC,EAAA,IAAYP,EAAA;AAEpB,2BACGe,GAAA,EAAK,eAAc,OAAM,gBAAe,iBAAgB,YAAW,UAClE,UAAA;AAAA,IAAA,gBAAAb,EAACc,GAAA,EAAS,UAAU,GAClB,UAAA,gBAAAd;AAAA,MAACoB;AAAA,MAAA;AAAA,QACC,aAAaF,IAAuBC,EAAYD,CAAmB,KAAK,CAAA,IAAM,CAAA;AAAA,QAC9E,qBAAAA;AAAA,QACA,SAAAb;AAAA,MAAA;AAAA,IAAA,GAEJ;AAAA,IACA,gBAAAL,EAACc,GAAA,EAAU,UAAAV,KAAO,gBAAAJ,EAACI,KAAI,EAAA,CAAG;AAAA,EAAA,GAC5B;AAEJ;"}

package/dist/components/Flow/useFlow.d.ts

@@ -23,6 +23,18 @@ export interface CtaConfig {
  */
 export type FlowHeaderConfig = {
     type: 'minimal';
+    /**
+     * Optional override for the default back button (defaults to
+     * `t('back')` + `componentEvents.CANCEL`). Provide both `label` and
+     * `event` to render a flow-specific affordance — e.g. "Back to
+     * employees" routed to a dedicated state-machine transition so nested
+     * flows don't intercept it as a generic cancel.
+     */
+    back?: {
+        labelKey: string;
+        namespace: keyof CustomTypeOptions['resources'];
+        event: EventType;
+    };
     cta?: React.ComponentType;
 } | {
     type: 'progress';

package/dist/components/Flow/useFlow.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFlow.js","sources":["../../../src/components/Flow/useFlow.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\nimport type { CustomTypeOptions } from 'i18next'\nimport type { OnEventType } from '../Base/useBase'\nimport type { CommonComponentInterface } from '../Base'\nimport type { BreadcrumbTrail } from '../Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\nimport type { EventType } from '@/shared/constants'\n\nexport interface CtaConfig {\n  labelKey: string\n  namespace?: keyof CustomTypeOptions['resources']\n}\n\n/**\n * Discriminated union describing the chrome rendered above the active flow\n * component. Each variant declares only the data it needs:\n *   - `minimal`     → Back button. Optional `cta` for an extra control next to it.\n *   - `progress`    → Step indicator. Requires `currentStep` / `totalSteps`,\n *                     plus optional `cta`.\n *   - `breadcrumbs` → Breadcrumb trail. Optional `currentBreadcrumbId` /\n *                     `breadcrumbs` (typically populated via\n *                     `buildBreadcrumbs` + `updateBreadcrumbs`), plus optional\n *                     `cta`.\n *\n * `cta` carries the same meaning across every variant: an optional component\n * rendered as part of the header chrome.\n */\nexport type FlowHeaderConfig =\n  | {\n      type: 'minimal'\n      cta?: React.ComponentType\n    }\n  | {\n      type: 'progress'\n      currentStep: number\n      totalSteps: number\n      cta?: React.ComponentType\n    }\n  | {\n      type: 'breadcrumbs'\n      currentBreadcrumbId?: string\n      breadcrumbs?: BreadcrumbTrail\n      cta?: React.ComponentType\n    }\n\nexport interface FlowContextInterface {\n  component: React.ComponentType<CommonComponentInterface> | null\n  onEvent: OnEventType<EventType, unknown>\n  defaultValues?: Record<string, unknown>\n  ctaConfig?: CtaConfig | null\n  /**\n   * Optional chrome rendered above the active flow component. When omitted\n   * (or set to `null`), no header is shown.\n   */\n  header?: FlowHeaderConfig | null\n}\n\nexport const FlowContext = createContext<FlowContextInterface | null>(null)\n\n//TODO: This is hiding the fact that the callsite for useFlow\n//  destructures a `companyId` that doesn't seem to exist\n// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters\nexport function useFlow<C extends FlowContextInterface>() {\n  // When used outside provider, this is expected to return undefined - consumers must fallback to params\n  const values = useContext<C>(FlowContext as unknown as React.Context<C>)\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!values) {\n    throw new Error('useFlow used outside provider')\n  }\n  return values\n}\n"],"names":["FlowContext","createContext","useFlow","values","useContext"],"mappings":";AAwDO,MAAMA,IAAcC,EAA2C,IAAI;AAKnE,SAASC,IAA0C;AAExD,QAAMC,IAASC,EAAcJ,CAA0C;AAEvE,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,+BAA+B;AAEjD,SAAOA;AACT;"}
+{"version":3,"file":"useFlow.js","sources":["../../../src/components/Flow/useFlow.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\nimport type { CustomTypeOptions } from 'i18next'\nimport type { OnEventType } from '../Base/useBase'\nimport type { CommonComponentInterface } from '../Base'\nimport type { BreadcrumbTrail } from '../Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\nimport type { EventType } from '@/shared/constants'\n\nexport interface CtaConfig {\n  labelKey: string\n  namespace?: keyof CustomTypeOptions['resources']\n}\n\n/**\n * Discriminated union describing the chrome rendered above the active flow\n * component. Each variant declares only the data it needs:\n *   - `minimal`     → Back button. Optional `cta` for an extra control next to it.\n *   - `progress`    → Step indicator. Requires `currentStep` / `totalSteps`,\n *                     plus optional `cta`.\n *   - `breadcrumbs` → Breadcrumb trail. Optional `currentBreadcrumbId` /\n *                     `breadcrumbs` (typically populated via\n *                     `buildBreadcrumbs` + `updateBreadcrumbs`), plus optional\n *                     `cta`.\n *\n * `cta` carries the same meaning across every variant: an optional component\n * rendered as part of the header chrome.\n */\nexport type FlowHeaderConfig =\n  | {\n      type: 'minimal'\n      /**\n       * Optional override for the default back button (defaults to\n       * `t('back')` + `componentEvents.CANCEL`). Provide both `label` and\n       * `event` to render a flow-specific affordance — e.g. \"Back to\n       * employees\" routed to a dedicated state-machine transition so nested\n       * flows don't intercept it as a generic cancel.\n       */\n      back?: {\n        labelKey: string\n        namespace: keyof CustomTypeOptions['resources']\n        event: EventType\n      }\n      cta?: React.ComponentType\n    }\n  | {\n      type: 'progress'\n      currentStep: number\n      totalSteps: number\n      cta?: React.ComponentType\n    }\n  | {\n      type: 'breadcrumbs'\n      currentBreadcrumbId?: string\n      breadcrumbs?: BreadcrumbTrail\n      cta?: React.ComponentType\n    }\n\nexport interface FlowContextInterface {\n  component: React.ComponentType<CommonComponentInterface> | null\n  onEvent: OnEventType<EventType, unknown>\n  defaultValues?: Record<string, unknown>\n  ctaConfig?: CtaConfig | null\n  /**\n   * Optional chrome rendered above the active flow component. When omitted\n   * (or set to `null`), no header is shown.\n   */\n  header?: FlowHeaderConfig | null\n}\n\nexport const FlowContext = createContext<FlowContextInterface | null>(null)\n\n//TODO: This is hiding the fact that the callsite for useFlow\n//  destructures a `companyId` that doesn't seem to exist\n// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters\nexport function useFlow<C extends FlowContextInterface>() {\n  // When used outside provider, this is expected to return undefined - consumers must fallback to params\n  const values = useContext<C>(FlowContext as unknown as React.Context<C>)\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if (!values) {\n    throw new Error('useFlow used outside provider')\n  }\n  return values\n}\n"],"names":["FlowContext","createContext","useFlow","values","useContext"],"mappings":";AAoEO,MAAMA,IAAcC,EAA2C,IAAI;AAKnE,SAASC,IAA0C;AAExD,QAAMC,IAASC,EAAcJ,CAA0C;AAEvE,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,+BAA+B;AAEjD,SAAOA;AACT;"}