@gusto/embedded-react-sdk 0.47.1 → 0.48.1

package/dist/components/Employee/EmployeeList/shared/useEmployeeList.d.ts

@@ -1,35 +1,110 @@
 import { Employee } from '@gusto/embedded-api-v-2025-11-15/models/components/employee';
 import { Job } from '@gusto/embedded-api-v-2025-11-15/models/components/job';
+import { EmployeeOnboardingStatus as EmployeeOnboardingStatusEntity } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeonboardingstatus';
 import { PaginationControlProps } from '../../../Common/PaginationControl/PaginationControlTypes';
-import { HookLoadingResult, HookSubmitResult, BaseHookReady } from '../../../../partner-hook-utils/types';
+import { HookLoadingResult, BaseHookReady } from '../../../../partner-hook-utils/types';
+/**
+ * Action that may be performed on an employee row, determined by the employee's onboarding state
+ * and the `employeeType` filter passed to {@link useEmployeeList}.
+ *
+ * @public
+ */
 export type EmployeeAction = 'edit' | 'delete' | 'cancel_self_onboarding' | 'review' | 'dismiss' | 'rehire';
+/**
+ * An employee entity extended with the actions permitted on it and a reference to its primary job.
+ *
+ * @public
+ */
 export interface EmployeeWithActions extends Employee {
+    /** Actions permitted for this employee given its onboarding status and the active filter. */
     allowedActions: EmployeeAction[];
+    /** The employee's primary job, if one is marked primary. */
     primaryJob?: Job;
 }
-export interface EmployeeActionCallbacks {
-    onDelete?: (employeeId: string) => void;
-    onReview?: (employeeId: string) => void;
-    onCancelSelfOnboarding?: (employeeId: string) => void;
-}
+/**
+ * Filter applied to {@link useEmployeeList} that scopes the result set and tailors the per-row action list.
+ *
+ * @public
+ */
 export type EmployeeType = 'active' | 'onboarding' | 'terminated';
+/**
+ * Props for {@link useEmployeeList}.
+ *
+ * @public
+ */
 export interface UseEmployeeListProps {
+    /** The associated company identifier. */
     companyId: string;
+    /** Filters the list and tailors the allowed actions. Omit to list all employees. */
     employeeType?: EmployeeType;
 }
-interface UseEmployeeListReady extends BaseHookReady<{
+/**
+ * Ready state of {@link useEmployeeList}.
+ *
+ * @public
+ */
+export interface UseEmployeeListReady extends BaseHookReady<{
     employees: EmployeeWithActions[];
 }, {
     isFetching: boolean;
     isPending: boolean;
 }> {
+    /** Pagination controls for the current employee list page. */
     pagination: PaginationControlProps;
+    /** Actions that mutate an employee's state, gated by the entry's `allowedActions`. */
     actions: {
-        onDelete: (employeeId: string, callbacks?: EmployeeActionCallbacks) => Promise<HookSubmitResult<void> | undefined>;
-        onReview: (employeeId: string, callbacks?: EmployeeActionCallbacks) => Promise<HookSubmitResult<string> | undefined>;
-        onCancelSelfOnboarding: (employeeId: string, callbacks?: EmployeeActionCallbacks) => Promise<HookSubmitResult<string> | undefined>;
+        /** Deletes the employee. */
+        onDelete: (employeeId: string) => Promise<void>;
+        /** Moves the employee into the admin-review onboarding status. Resolves to the updated record, or `undefined` if the call failed. */
+        onReview: (employeeId: string) => Promise<EmployeeOnboardingStatusEntity | undefined>;
+        /** Reverts a self-onboarding employee to admin-driven onboarding. Resolves to the updated record, or `undefined` if the call failed. */
+        onCancelSelfOnboarding: (employeeId: string) => Promise<EmployeeOnboardingStatusEntity | undefined>;
     };
 }
+/**
+ * Return type of {@link useEmployeeList}.
+ *
+ * @public
+ */
 export type UseEmployeeListResult = HookLoadingResult | UseEmployeeListReady;
+/**
+ * Fetches a paginated list of a company's employees and decorates each entry with the actions
+ * allowed for its current onboarding state.
+ *
+ * @remarks
+ * `employeeType` maps to a server-side filter and changes which actions appear on each row:
+ * `'active'` adds `dismiss`, `'terminated'` adds `rehire`, `'onboarding'` adds none. Omit it
+ * to list every employee.
+ *
+ * Page changes use placeholder data: the previous page stays rendered while the next one loads,
+ * and `status.isFetching` flips to `true` during the request.
+ *
+ * @param input - Company and optional filter for the list.
+ * @returns A {@link HookLoadingResult} while the first page is in flight, or a {@link UseEmployeeListReady} once data has arrived.
+ * @public
+ *
+ * @example
+ * ```tsx
+ * import { useEmployeeList } from '@gusto/embedded-react-sdk'
+ *
+ * function EmployeeListPage({ companyId }: { companyId: string }) {
+ *   const employeeList = useEmployeeList({ companyId, employeeType: 'onboarding' })
+ *
+ *   if (employeeList.isLoading) return <div>Loading...</div>
+ *
+ *   return (
+ *     <ul>
+ *       {employeeList.data.employees.map(employee => (
+ *         <li key={employee.uuid}>
+ *           {employee.firstName} {employee.lastName}
+ *           {employee.allowedActions.includes('delete') && (
+ *             <button onClick={() => employeeList.actions.onDelete(employee.uuid)}>Delete</button>
+ *           )}
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   )
+ * }
+ * ```
+ */
 export declare function useEmployeeList({ companyId, employeeType, }: UseEmployeeListProps): UseEmployeeListResult;
-export {};

package/dist/components/Employee/EmployeeList/shared/useEmployeeList.js

@@ -1,28 +1,28 @@
-import { useMemo as P } from "react";
-import { useEmployeesList as M } from "@gusto/embedded-api-v-2025-11-15/react-query/employeesList";
-import { useEmployeesDeleteMutation as w } from "@gusto/embedded-api-v-2025-11-15/react-query/employeesDelete";
-import { useEmployeesUpdateOnboardingStatusMutation as R } from "@gusto/embedded-api-v-2025-11-15/react-query/employeesUpdateOnboardingStatus";
+import { useMemo as b } from "react";
+import { useEmployeesList as L } from "@gusto/embedded-api-v-2025-11-15/react-query/employeesList";
+import { useEmployeesDeleteMutation as M } from "@gusto/embedded-api-v-2025-11-15/react-query/employeesDelete";
+import { useEmployeesUpdateOnboardingStatusMutation as w } from "@gusto/embedded-api-v-2025-11-15/react-query/employeesUpdateOnboardingStatus";
 import { keepPreviousData as y } from "@tanstack/react-query";
 import { usePagination as B } from "../../../../hooks/usePagination/usePagination.js";
-import { useBaseSubmit as v } from "../../../Base/useBaseSubmit.js";
-import { composeErrorHandler as G } from "../../../../partner-hook-utils/composeErrorHandler.js";
-import { EmployeeOnboardingStatus as i, EmployeeSelfOnboardingStatuses as C } from "../../../../shared/constants.js";
-function q(e, o) {
+import { useBaseSubmit as G } from "../../../Base/useBaseSubmit.js";
+import { composeErrorHandler as R } from "../../../../partner-hook-utils/composeErrorHandler.js";
+import { EmployeeOnboardingStatus as r, EmployeeSelfOnboardingStatuses as v } from "../../../../shared/constants.js";
+function C(e, s) {
   const a = [];
-  return o !== "terminated" && (e.onboardingStatus === i.ADMIN_ONBOARDING_INCOMPLETE || e.onboardingStatus === i.SELF_ONBOARDING_PENDING_INVITE || e.onboardingStatus === i.SELF_ONBOARDING_AWAITING_ADMIN_REVIEW || e.onboardingStatus === i.ONBOARDING_COMPLETED) && a.push("edit"), e.onboardingStatus && // @ts-expect-error: onboardingStatus during runtime can be one of self onboarding statuses
-  C.has(e.onboardingStatus) && a.push("cancel_self_onboarding"), e.onboardingStatus === i.SELF_ONBOARDING_COMPLETED_BY_EMPLOYEE && a.push("review"), e.onboarded || a.push("delete"), o === "active" && a.push("dismiss"), o === "terminated" && a.push("rehire"), a;
+  return s !== "terminated" && (e.onboardingStatus === r.ADMIN_ONBOARDING_INCOMPLETE || e.onboardingStatus === r.SELF_ONBOARDING_PENDING_INVITE || e.onboardingStatus === r.SELF_ONBOARDING_AWAITING_ADMIN_REVIEW || e.onboardingStatus === r.ONBOARDING_COMPLETED) && a.push("edit"), e.onboardingStatus && // @ts-expect-error: onboardingStatus during runtime can be one of self onboarding statuses
+  v.has(e.onboardingStatus) && a.push("cancel_self_onboarding"), e.onboardingStatus === r.SELF_ONBOARDING_COMPLETED_BY_EMPLOYEE && a.push("review"), e.onboarded || a.push("delete"), s === "active" && a.push("dismiss"), s === "terminated" && a.push("rehire"), a;
 }
-function Q({
+function J({
   companyId: e,
-  employeeType: o
+  employeeType: s
 }) {
-  const { currentPage: a, itemsPerPage: l, getPaginationProps: O } = B(), S = P(() => {
+  const { currentPage: a, itemsPerPage: g, getPaginationProps: p } = B(), P = b(() => {
     const t = {
       companyId: e,
       page: a,
-      per: l
+      per: g
     };
-    switch (o) {
+    switch (s) {
       case "active":
         return { ...t, onboardedActive: !0 };
       case "onboarding":
@@ -32,18 +32,18 @@ function Q({
       default:
         return t;
     }
-  }, [e, a, l, o]), b = M(S, { placeholderData: y }), E = w(), d = R(), {
-    baseSubmitHandler: c,
-    error: f,
-    setError: N
-  } = v("EmployeeList"), p = G([b], { submitError: f, setSubmitError: N }), I = E.isPending || d.isPending, { data: u, isFetching: m } = b, h = P(() => (u?.showEmployees ?? []).map((t) => {
-    const r = t.jobs?.find((n) => n.primary === !0);
+  }, [e, a, g, s]), m = L(P, { placeholderData: y }), l = M(), u = w(), {
+    baseSubmitHandler: d,
+    error: N,
+    setError: O
+  } = G("EmployeeList"), E = R([m], { submitError: N, setSubmitError: O }), S = l.isPending || u.isPending, { data: o, isFetching: c } = m, f = b(() => (o?.showEmployees ?? []).map((t) => {
+    const n = t.jobs?.find((i) => i.primary === !0);
     return {
       ...t,
-      allowedActions: q(t, o),
-      primaryJob: r
+      allowedActions: C(t, s),
+      primaryJob: n
     };
-  }), [u?.showEmployees, o]), A = u?.httpMeta.response.headers ? O(u.httpMeta.response.headers, m) : {
+  }), [o?.showEmployees, s]), I = o?.httpMeta.response.headers ? p(o.httpMeta.response.headers, c) : {
     handleNextPage: () => {
     },
     handleFirstPage: () => {
@@ -58,64 +58,52 @@ function Q({
     totalPages: 1,
     totalCount: 0,
     itemsPerPage: 5
-  }, _ = async (t, r) => {
-    let n;
-    return await c(t, async (s) => {
-      await E.mutateAsync({
-        request: { employeeId: s }
-      }), r?.onDelete?.(s), n = {
-        mode: "update",
-        data: void 0
-      };
-    }), n;
-  }, D = async (t, r) => {
+  }, h = async (t) => {
+    await d(t, async (n) => {
+      await l.mutateAsync({
+        request: { employeeId: n }
+      });
+    });
+  }, A = async (t) => {
     let n;
-    return await c(t, async (s) => {
-      const g = await d.mutateAsync({
+    return await d(t, async (i) => {
+      n = (await u.mutateAsync({
         request: {
-          employeeId: s,
+          employeeId: i,
           requestBody: {
-            onboardingStatus: i.SELF_ONBOARDING_AWAITING_ADMIN_REVIEW
+            onboardingStatus: r.SELF_ONBOARDING_AWAITING_ADMIN_REVIEW
           }
         }
-      });
-      r?.onReview?.(s), n = {
-        mode: "update",
-        data: g.employeeOnboardingStatus?.onboardingStatus ?? ""
-      };
+      })).employeeOnboardingStatus;
     }), n;
-  }, L = async (t, r) => {
+  }, _ = async (t) => {
     let n;
-    return await c(t, async (s) => {
-      const g = await d.mutateAsync({
+    return await d(t, async (i) => {
+      n = (await u.mutateAsync({
         request: {
-          employeeId: s,
+          employeeId: i,
           requestBody: {
-            onboardingStatus: i.ADMIN_ONBOARDING_INCOMPLETE
+            onboardingStatus: r.ADMIN_ONBOARDING_INCOMPLETE
           }
         }
-      });
-      r?.onCancelSelfOnboarding?.(s), n = {
-        mode: "update",
-        data: g.employeeOnboardingStatus?.onboardingStatus ?? ""
-      };
+      })).employeeOnboardingStatus;
     }), n;
   };
-  return !u && m ? {
+  return !o && c ? {
     isLoading: !0,
-    errorHandling: p
+    errorHandling: E
   } : {
     isLoading: !1,
     data: {
-      employees: h
+      employees: f
     },
-    pagination: A,
-    status: { isFetching: m, isPending: I },
-    actions: { onDelete: _, onReview: D, onCancelSelfOnboarding: L },
-    errorHandling: p
+    pagination: I,
+    status: { isFetching: c, isPending: S },
+    actions: { onDelete: h, onReview: A, onCancelSelfOnboarding: _ },
+    errorHandling: E
   };
 }
 export {
-  Q as useEmployeeList
+  J as useEmployeeList
 };
 //# sourceMappingURL=useEmployeeList.js.map

package/dist/components/Employee/EmployeeList/shared/useEmployeeList.js.map

@@ -1 +1 @@
-{"version":3,"file":"useEmployeeList.js","sources":["../../../../../src/components/Employee/EmployeeList/shared/useEmployeeList.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { useEmployeesList } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesList'\nimport type { Employee } from '@gusto/embedded-api-v-2025-11-15/models/components/employee'\nimport type { Job } from '@gusto/embedded-api-v-2025-11-15/models/components/job'\nimport { useEmployeesDeleteMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesDelete'\nimport { useEmployeesUpdateOnboardingStatusMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesUpdateOnboardingStatus'\nimport { keepPreviousData } from '@tanstack/react-query'\nimport { usePagination } from '@/hooks/usePagination/usePagination'\nimport type { PaginationControlProps } from '@/components/Common/PaginationControl/PaginationControlTypes'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport { EmployeeOnboardingStatus, EmployeeSelfOnboardingStatuses } from '@/shared/constants'\nimport type { HookLoadingResult, HookSubmitResult, BaseHookReady } from '@/partner-hook-utils/types'\n\nexport type EmployeeAction =\n  | 'edit'\n  | 'delete'\n  | 'cancel_self_onboarding'\n  | 'review'\n  | 'dismiss'\n  | 'rehire'\n\nexport interface EmployeeWithActions extends Employee {\n  allowedActions: EmployeeAction[]\n  primaryJob?: Job\n}\n\nexport interface EmployeeActionCallbacks {\n  onDelete?: (employeeId: string) => void\n  onReview?: (employeeId: string) => void\n  onCancelSelfOnboarding?: (employeeId: string) => void\n}\n\nexport type EmployeeType = 'active' | 'onboarding' | 'terminated'\n\nexport interface UseEmployeeListProps {\n  companyId: string\n  employeeType?: EmployeeType\n}\n\ninterface UseEmployeeListReady extends BaseHookReady<\n  { employees: EmployeeWithActions[] },\n  { isFetching: boolean; isPending: boolean }\n> {\n  pagination: PaginationControlProps\n  actions: {\n    onDelete: (\n      employeeId: string,\n      callbacks?: EmployeeActionCallbacks,\n    ) => Promise<HookSubmitResult<void> | undefined>\n    onReview: (\n      employeeId: string,\n      callbacks?: EmployeeActionCallbacks,\n    ) => Promise<HookSubmitResult<string> | undefined>\n    onCancelSelfOnboarding: (\n      employeeId: string,\n      callbacks?: EmployeeActionCallbacks,\n    ) => Promise<HookSubmitResult<string> | undefined>\n  }\n}\n\nexport type UseEmployeeListResult = HookLoadingResult | UseEmployeeListReady\n\nfunction deriveAllowedActions(employee: Employee, employeeType?: EmployeeType): EmployeeAction[] {\n  const actions: EmployeeAction[] = []\n\n  // Edit action - available for certain onboarding statuses, but not for terminated employees\n  if (\n    employeeType !== 'terminated' &&\n    (employee.onboardingStatus === EmployeeOnboardingStatus.ADMIN_ONBOARDING_INCOMPLETE ||\n      employee.onboardingStatus === EmployeeOnboardingStatus.SELF_ONBOARDING_PENDING_INVITE ||\n      employee.onboardingStatus ===\n        EmployeeOnboardingStatus.SELF_ONBOARDING_AWAITING_ADMIN_REVIEW ||\n      employee.onboardingStatus === EmployeeOnboardingStatus.ONBOARDING_COMPLETED)\n  ) {\n    actions.push('edit')\n  }\n\n  // Cancel self onboarding - available for employees in self-onboarding flow\n  if (\n    employee.onboardingStatus &&\n    // @ts-expect-error: onboardingStatus during runtime can be one of self onboarding statuses\n    EmployeeSelfOnboardingStatuses.has(employee.onboardingStatus)\n  ) {\n    actions.push('cancel_self_onboarding')\n  }\n\n  // Review action - available when employee completed self-onboarding\n  if (\n    employee.onboardingStatus === EmployeeOnboardingStatus.SELF_ONBOARDING_COMPLETED_BY_EMPLOYEE\n  ) {\n    actions.push('review')\n  }\n\n  // Delete action - available for non-onboarded employees\n  if (!employee.onboarded) {\n    actions.push('delete')\n  }\n\n  // Tab-specific actions for ManagementEmployeeList\n  if (employeeType === 'active') {\n    actions.push('dismiss')\n  }\n\n  if (employeeType === 'terminated') {\n    actions.push('rehire')\n  }\n\n  return actions\n}\n\nexport function useEmployeeList({\n  companyId,\n  employeeType,\n}: UseEmployeeListProps): UseEmployeeListResult {\n  const { currentPage, itemsPerPage, getPaginationProps } = usePagination()\n\n  const queryParams = useMemo(() => {\n    const baseParams = {\n      companyId,\n      page: currentPage,\n      per: itemsPerPage,\n    }\n\n    switch (employeeType) {\n      case 'active':\n        return { ...baseParams, onboardedActive: true }\n      case 'onboarding':\n        return { ...baseParams, onboarded: false }\n      case 'terminated':\n        return { ...baseParams, terminated: true }\n      default:\n        return baseParams\n    }\n  }, [companyId, currentPage, itemsPerPage, employeeType])\n\n  const employeesQuery = useEmployeesList(queryParams, { placeholderData: keepPreviousData })\n\n  const deleteEmployeeMutation = useEmployeesDeleteMutation()\n  const updateOnboardingStatusMutation = useEmployeesUpdateOnboardingStatusMutation()\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('EmployeeList')\n\n  const errorHandling = composeErrorHandler([employeesQuery], { submitError, setSubmitError })\n\n  const isPending = deleteEmployeeMutation.isPending || updateOnboardingStatusMutation.isPending\n\n  const { data, isFetching } = employeesQuery\n\n  const employees = useMemo<EmployeeWithActions[]>(() => {\n    return (data?.showEmployees ?? []).map(employee => {\n      const primaryJob = employee.jobs?.find(job => job.primary === true)\n\n      return {\n        ...employee,\n        allowedActions: deriveAllowedActions(employee, employeeType),\n        primaryJob,\n      }\n    })\n  }, [data?.showEmployees, employeeType])\n\n  const paginationProps = data?.httpMeta.response.headers\n    ? getPaginationProps(data.httpMeta.response.headers, isFetching)\n    : {\n        handleNextPage: () => {},\n        handleFirstPage: () => {},\n        handleLastPage: () => {},\n        handlePreviousPage: () => {},\n        handleItemsPerPageChange: () => {},\n        currentPage: 1,\n        totalPages: 1,\n        totalCount: 0,\n        itemsPerPage: 5 as const,\n      }\n\n  const onDelete = async (\n    employeeId: string,\n    callbacks?: EmployeeActionCallbacks,\n  ): Promise<HookSubmitResult<void> | undefined> => {\n    let submitResult: HookSubmitResult<void> | undefined\n\n    await baseSubmitHandler(employeeId, async id => {\n      await deleteEmployeeMutation.mutateAsync({\n        request: { employeeId: id },\n      })\n      callbacks?.onDelete?.(id)\n\n      submitResult = {\n        mode: 'update',\n        data: undefined,\n      }\n    })\n\n    return submitResult\n  }\n\n  const onReview = async (\n    employeeId: string,\n    callbacks?: EmployeeActionCallbacks,\n  ): Promise<HookSubmitResult<string> | undefined> => {\n    let submitResult: HookSubmitResult<string> | undefined\n\n    await baseSubmitHandler(employeeId, async id => {\n      const result = await updateOnboardingStatusMutation.mutateAsync({\n        request: {\n          employeeId: id,\n          requestBody: {\n            onboardingStatus: EmployeeOnboardingStatus.SELF_ONBOARDING_AWAITING_ADMIN_REVIEW,\n          },\n        },\n      })\n      callbacks?.onReview?.(id)\n\n      submitResult = {\n        mode: 'update',\n        data: result.employeeOnboardingStatus?.onboardingStatus ?? '',\n      }\n    })\n\n    return submitResult\n  }\n\n  const onCancelSelfOnboarding = async (\n    employeeId: string,\n    callbacks?: EmployeeActionCallbacks,\n  ): Promise<HookSubmitResult<string> | undefined> => {\n    let submitResult: HookSubmitResult<string> | undefined\n\n    await baseSubmitHandler(employeeId, async id => {\n      const result = await updateOnboardingStatusMutation.mutateAsync({\n        request: {\n          employeeId: id,\n          requestBody: {\n            onboardingStatus: EmployeeOnboardingStatus.ADMIN_ONBOARDING_INCOMPLETE,\n          },\n        },\n      })\n      callbacks?.onCancelSelfOnboarding?.(id)\n\n      submitResult = {\n        mode: 'update',\n        data: result.employeeOnboardingStatus?.onboardingStatus ?? '',\n      }\n    })\n\n    return submitResult\n  }\n\n  const isLoading = !data && isFetching\n\n  if (isLoading) {\n    return {\n      isLoading: true,\n      errorHandling,\n    }\n  }\n\n  return {\n    isLoading: false,\n    data: {\n      employees,\n    },\n    pagination: paginationProps,\n    status: { isFetching, isPending },\n    actions: { onDelete, onReview, onCancelSelfOnboarding },\n    errorHandling,\n  }\n}\n"],"names":["deriveAllowedActions","employee","employeeType","actions","EmployeeOnboardingStatus","EmployeeSelfOnboardingStatuses","useEmployeeList","companyId","currentPage","itemsPerPage","getPaginationProps","usePagination","queryParams","useMemo","baseParams","employeesQuery","useEmployeesList","keepPreviousData","deleteEmployeeMutation","useEmployeesDeleteMutation","updateOnboardingStatusMutation","useEmployeesUpdateOnboardingStatusMutation","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","isPending","data","isFetching","employees","primaryJob","job","paginationProps","onDelete","employeeId","callbacks","submitResult","id","onReview","result","onCancelSelfOnboarding"],"mappings":"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"}
+{"version":3,"file":"useEmployeeList.js","sources":["../../../../../src/components/Employee/EmployeeList/shared/useEmployeeList.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { useEmployeesList } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesList'\nimport type { Employee } from '@gusto/embedded-api-v-2025-11-15/models/components/employee'\nimport type { Job } from '@gusto/embedded-api-v-2025-11-15/models/components/job'\nimport type { EmployeeOnboardingStatus as EmployeeOnboardingStatusEntity } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeonboardingstatus'\nimport { useEmployeesDeleteMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesDelete'\nimport { useEmployeesUpdateOnboardingStatusMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesUpdateOnboardingStatus'\nimport { keepPreviousData } from '@tanstack/react-query'\nimport { usePagination } from '@/hooks/usePagination/usePagination'\nimport type { PaginationControlProps } from '@/components/Common/PaginationControl/PaginationControlTypes'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport { EmployeeOnboardingStatus, EmployeeSelfOnboardingStatuses } from '@/shared/constants'\nimport type { HookLoadingResult, BaseHookReady } from '@/partner-hook-utils/types'\n\n/**\n * Action that may be performed on an employee row, determined by the employee's onboarding state\n * and the `employeeType` filter passed to {@link useEmployeeList}.\n *\n * @public\n */\nexport type EmployeeAction =\n  | 'edit'\n  | 'delete'\n  | 'cancel_self_onboarding'\n  | 'review'\n  | 'dismiss'\n  | 'rehire'\n\n/**\n * An employee entity extended with the actions permitted on it and a reference to its primary job.\n *\n * @public\n */\nexport interface EmployeeWithActions extends Employee {\n  /** Actions permitted for this employee given its onboarding status and the active filter. */\n  allowedActions: EmployeeAction[]\n  /** The employee's primary job, if one is marked primary. */\n  primaryJob?: Job\n}\n\n/**\n * Filter applied to {@link useEmployeeList} that scopes the result set and tailors the per-row action list.\n *\n * @public\n */\nexport type EmployeeType = 'active' | 'onboarding' | 'terminated'\n\n/**\n * Props for {@link useEmployeeList}.\n *\n * @public\n */\nexport interface UseEmployeeListProps {\n  /** The associated company identifier. */\n  companyId: string\n  /** Filters the list and tailors the allowed actions. Omit to list all employees. */\n  employeeType?: EmployeeType\n}\n\n/**\n * Ready state of {@link useEmployeeList}.\n *\n * @public\n */\nexport interface UseEmployeeListReady extends BaseHookReady<\n  { employees: EmployeeWithActions[] },\n  { isFetching: boolean; isPending: boolean }\n> {\n  /** Pagination controls for the current employee list page. */\n  pagination: PaginationControlProps\n  /** Actions that mutate an employee's state, gated by the entry's `allowedActions`. */\n  actions: {\n    /** Deletes the employee. */\n    onDelete: (employeeId: string) => Promise<void>\n    /** Moves the employee into the admin-review onboarding status. Resolves to the updated record, or `undefined` if the call failed. */\n    onReview: (employeeId: string) => Promise<EmployeeOnboardingStatusEntity | undefined>\n    /** Reverts a self-onboarding employee to admin-driven onboarding. Resolves to the updated record, or `undefined` if the call failed. */\n    onCancelSelfOnboarding: (\n      employeeId: string,\n    ) => Promise<EmployeeOnboardingStatusEntity | undefined>\n  }\n}\n\n/**\n * Return type of {@link useEmployeeList}.\n *\n * @public\n */\nexport type UseEmployeeListResult = HookLoadingResult | UseEmployeeListReady\n\nfunction deriveAllowedActions(employee: Employee, employeeType?: EmployeeType): EmployeeAction[] {\n  const actions: EmployeeAction[] = []\n\n  // Edit action - available for certain onboarding statuses, but not for terminated employees\n  if (\n    employeeType !== 'terminated' &&\n    (employee.onboardingStatus === EmployeeOnboardingStatus.ADMIN_ONBOARDING_INCOMPLETE ||\n      employee.onboardingStatus === EmployeeOnboardingStatus.SELF_ONBOARDING_PENDING_INVITE ||\n      employee.onboardingStatus ===\n        EmployeeOnboardingStatus.SELF_ONBOARDING_AWAITING_ADMIN_REVIEW ||\n      employee.onboardingStatus === EmployeeOnboardingStatus.ONBOARDING_COMPLETED)\n  ) {\n    actions.push('edit')\n  }\n\n  // Cancel self onboarding - available for employees in self-onboarding flow\n  if (\n    employee.onboardingStatus &&\n    // @ts-expect-error: onboardingStatus during runtime can be one of self onboarding statuses\n    EmployeeSelfOnboardingStatuses.has(employee.onboardingStatus)\n  ) {\n    actions.push('cancel_self_onboarding')\n  }\n\n  // Review action - available when employee completed self-onboarding\n  if (\n    employee.onboardingStatus === EmployeeOnboardingStatus.SELF_ONBOARDING_COMPLETED_BY_EMPLOYEE\n  ) {\n    actions.push('review')\n  }\n\n  // Delete action - available for non-onboarded employees\n  if (!employee.onboarded) {\n    actions.push('delete')\n  }\n\n  // Tab-specific actions for ManagementEmployeeList\n  if (employeeType === 'active') {\n    actions.push('dismiss')\n  }\n\n  if (employeeType === 'terminated') {\n    actions.push('rehire')\n  }\n\n  return actions\n}\n\n/**\n * Fetches a paginated list of a company's employees and decorates each entry with the actions\n * allowed for its current onboarding state.\n *\n * @remarks\n * `employeeType` maps to a server-side filter and changes which actions appear on each row:\n * `'active'` adds `dismiss`, `'terminated'` adds `rehire`, `'onboarding'` adds none. Omit it\n * to list every employee.\n *\n * Page changes use placeholder data: the previous page stays rendered while the next one loads,\n * and `status.isFetching` flips to `true` during the request.\n *\n * @param input - Company and optional filter for the list.\n * @returns A {@link HookLoadingResult} while the first page is in flight, or a {@link UseEmployeeListReady} once data has arrived.\n * @public\n *\n * @example\n * ```tsx\n * import { useEmployeeList } from '@gusto/embedded-react-sdk'\n *\n * function EmployeeListPage({ companyId }: { companyId: string }) {\n *   const employeeList = useEmployeeList({ companyId, employeeType: 'onboarding' })\n *\n *   if (employeeList.isLoading) return <div>Loading...</div>\n *\n *   return (\n *     <ul>\n *       {employeeList.data.employees.map(employee => (\n *         <li key={employee.uuid}>\n *           {employee.firstName} {employee.lastName}\n *           {employee.allowedActions.includes('delete') && (\n *             <button onClick={() => employeeList.actions.onDelete(employee.uuid)}>Delete</button>\n *           )}\n *         </li>\n *       ))}\n *     </ul>\n *   )\n * }\n * ```\n */\nexport function useEmployeeList({\n  companyId,\n  employeeType,\n}: UseEmployeeListProps): UseEmployeeListResult {\n  const { currentPage, itemsPerPage, getPaginationProps } = usePagination()\n\n  const queryParams = useMemo(() => {\n    const baseParams = {\n      companyId,\n      page: currentPage,\n      per: itemsPerPage,\n    }\n\n    switch (employeeType) {\n      case 'active':\n        return { ...baseParams, onboardedActive: true }\n      case 'onboarding':\n        return { ...baseParams, onboarded: false }\n      case 'terminated':\n        return { ...baseParams, terminated: true }\n      default:\n        return baseParams\n    }\n  }, [companyId, currentPage, itemsPerPage, employeeType])\n\n  const employeesQuery = useEmployeesList(queryParams, { placeholderData: keepPreviousData })\n\n  const deleteEmployeeMutation = useEmployeesDeleteMutation()\n  const updateOnboardingStatusMutation = useEmployeesUpdateOnboardingStatusMutation()\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('EmployeeList')\n\n  const errorHandling = composeErrorHandler([employeesQuery], { submitError, setSubmitError })\n\n  const isPending = deleteEmployeeMutation.isPending || updateOnboardingStatusMutation.isPending\n\n  const { data, isFetching } = employeesQuery\n\n  const employees = useMemo<EmployeeWithActions[]>(() => {\n    return (data?.showEmployees ?? []).map(employee => {\n      const primaryJob = employee.jobs?.find(job => job.primary === true)\n\n      return {\n        ...employee,\n        allowedActions: deriveAllowedActions(employee, employeeType),\n        primaryJob,\n      }\n    })\n  }, [data?.showEmployees, employeeType])\n\n  const paginationProps = data?.httpMeta.response.headers\n    ? getPaginationProps(data.httpMeta.response.headers, isFetching)\n    : {\n        handleNextPage: () => {},\n        handleFirstPage: () => {},\n        handleLastPage: () => {},\n        handlePreviousPage: () => {},\n        handleItemsPerPageChange: () => {},\n        currentPage: 1,\n        totalPages: 1,\n        totalCount: 0,\n        itemsPerPage: 5 as const,\n      }\n\n  const onDelete = async (employeeId: string): Promise<void> => {\n    await baseSubmitHandler(employeeId, async id => {\n      await deleteEmployeeMutation.mutateAsync({\n        request: { employeeId: id },\n      })\n    })\n  }\n\n  const onReview = async (\n    employeeId: string,\n  ): Promise<EmployeeOnboardingStatusEntity | undefined> => {\n    let onboardingStatus: EmployeeOnboardingStatusEntity | undefined\n\n    await baseSubmitHandler(employeeId, async id => {\n      const result = await updateOnboardingStatusMutation.mutateAsync({\n        request: {\n          employeeId: id,\n          requestBody: {\n            onboardingStatus: EmployeeOnboardingStatus.SELF_ONBOARDING_AWAITING_ADMIN_REVIEW,\n          },\n        },\n      })\n\n      onboardingStatus = result.employeeOnboardingStatus\n    })\n\n    return onboardingStatus\n  }\n\n  const onCancelSelfOnboarding = async (\n    employeeId: string,\n  ): Promise<EmployeeOnboardingStatusEntity | undefined> => {\n    let onboardingStatus: EmployeeOnboardingStatusEntity | undefined\n\n    await baseSubmitHandler(employeeId, async id => {\n      const result = await updateOnboardingStatusMutation.mutateAsync({\n        request: {\n          employeeId: id,\n          requestBody: {\n            onboardingStatus: EmployeeOnboardingStatus.ADMIN_ONBOARDING_INCOMPLETE,\n          },\n        },\n      })\n\n      onboardingStatus = result.employeeOnboardingStatus\n    })\n\n    return onboardingStatus\n  }\n\n  const isLoading = !data && isFetching\n\n  if (isLoading) {\n    return {\n      isLoading: true,\n      errorHandling,\n    }\n  }\n\n  return {\n    isLoading: false,\n    data: {\n      employees,\n    },\n    pagination: paginationProps,\n    status: { isFetching, isPending },\n    actions: { onDelete, onReview, onCancelSelfOnboarding },\n    errorHandling,\n  }\n}\n"],"names":["deriveAllowedActions","employee","employeeType","actions","EmployeeOnboardingStatus","EmployeeSelfOnboardingStatuses","useEmployeeList","companyId","currentPage","itemsPerPage","getPaginationProps","usePagination","queryParams","useMemo","baseParams","employeesQuery","useEmployeesList","keepPreviousData","deleteEmployeeMutation","useEmployeesDeleteMutation","updateOnboardingStatusMutation","useEmployeesUpdateOnboardingStatusMutation","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","isPending","data","isFetching","employees","primaryJob","job","paginationProps","onDelete","employeeId","id","onReview","onboardingStatus","onCancelSelfOnboarding"],"mappings":"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"}

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

@@ -1,2 +1,36 @@
 import { EmployeeListFlowProps } from './EmployeeListFlowComponents';
+/**
+ * Top-level workflow that renders the employee list and transitions into the dashboard, termination, and onboarding flows.
+ *
+ * @remarks
+ * Drop-in entry point for managing all employees in a company. Begins on the
+ * management employee list and routes into {@link DashboardFlow},
+ * {@link TerminationFlow}, or {@link EmployeeOnboarding.OnboardingExecutionFlow | OnboardingExecutionFlow} based on the
+ * action the admin invokes on a row (or the "Add employee" CTA). A "Back to
+ * employees" header is added to each sub-flow so the admin can return to the
+ * list at any time.
+ *
+ * The flow forwards every event emitted by its sub-components to `onEvent`;
+ * see the events table on each sub-component for the full set of events and
+ * payloads observable from this flow.
+ *
+ * @param props - See {@link EmployeeListFlowProps}.
+ * @returns The employee list workflow with internal navigation to the dashboard, termination, and onboarding flows.
+ * @public
+ * @group Flow Components
+ *
+ * @example
+ * ```tsx
+ * import { EmployeeManagement } from '@gusto/embedded-react-sdk'
+ *
+ * function MyApp() {
+ *   return (
+ *     <EmployeeManagement.EmployeeListFlow
+ *       companyId="a007e1ab-3595-43c2-ab4b-af7a5af2e365"
+ *       onEvent={() => {}}
+ *     />
+ *   )
+ * }
+ * ```
+ */
 export declare const EmployeeListFlow: ({ companyId, onEvent }: EmployeeListFlowProps) => import("react").JSX.Element;

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

@@ -1 +1 @@
-{"version":3,"file":"EmployeeListFlow.js","sources":["../../../../src/components/Employee/EmployeeListFlow/EmployeeListFlow.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport { employeeListStateMachine } from './employeeListStateMachine'\nimport {\n  EmployeeListContextual,\n  type EmployeeListFlowContextInterface,\n  type EmployeeListFlowProps,\n} from './EmployeeListFlowComponents'\nimport { Flow } from '@/components/Flow/Flow'\n\nexport const EmployeeListFlow = ({ companyId, onEvent }: EmployeeListFlowProps) => {\n  const machine = useMemo(\n    () =>\n      createMachine(\n        'list',\n        employeeListStateMachine,\n        (initialContext: EmployeeListFlowContextInterface) => ({\n          ...initialContext,\n          component: EmployeeListContextual,\n          companyId,\n        }),\n      ),\n    [companyId],\n  )\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n"],"names":["EmployeeListFlow","companyId","onEvent","machine","useMemo","createMachine","employeeListStateMachine","initialContext","EmployeeListContextual","jsx","Flow"],"mappings":";;;;;;AAUO,MAAMA,IAAmB,CAAC,EAAE,WAAAC,GAAW,SAAAC,QAAqC;AACjF,QAAMC,IAAUC;AAAA,IACd,MACEC;AAAA,MACE;AAAA,MACAC;AAAA,MACA,CAACC,OAAsD;AAAA,QACrD,GAAGA;AAAA,QACH,WAAWC;AAAA,QACX,WAAAP;AAAA,MAAA;AAAA,IACF;AAAA,IAEJ,CAACA,CAAS;AAAA,EAAA;AAEZ,SAAO,gBAAAQ,EAACC,GAAA,EAAK,SAAAP,GAAkB,SAAAD,EAAA,CAAkB;AACnD;"}
+{"version":3,"file":"EmployeeListFlow.js","sources":["../../../../src/components/Employee/EmployeeListFlow/EmployeeListFlow.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport { employeeListStateMachine } from './employeeListStateMachine'\nimport {\n  EmployeeListContextual,\n  type EmployeeListFlowContextInterface,\n  type EmployeeListFlowProps,\n} from './EmployeeListFlowComponents'\nimport { Flow } from '@/components/Flow/Flow'\n\n/**\n * Top-level workflow that renders the employee list and transitions into the dashboard, termination, and onboarding flows.\n *\n * @remarks\n * Drop-in entry point for managing all employees in a company. Begins on the\n * management employee list and routes into {@link DashboardFlow},\n * {@link TerminationFlow}, or {@link EmployeeOnboarding.OnboardingExecutionFlow | OnboardingExecutionFlow} based on the\n * action the admin invokes on a row (or the \"Add employee\" CTA). A \"Back to\n * employees\" header is added to each sub-flow so the admin can return to the\n * list at any time.\n *\n * The flow forwards every event emitted by its sub-components to `onEvent`;\n * see the events table on each sub-component for the full set of events and\n * payloads observable from this flow.\n *\n * @param props - See {@link EmployeeListFlowProps}.\n * @returns The employee list workflow with internal navigation to the dashboard, termination, and onboarding flows.\n * @public\n * @group Flow Components\n *\n * @example\n * ```tsx\n * import { EmployeeManagement } from '@gusto/embedded-react-sdk'\n *\n * function MyApp() {\n *   return (\n *     <EmployeeManagement.EmployeeListFlow\n *       companyId=\"a007e1ab-3595-43c2-ab4b-af7a5af2e365\"\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport const EmployeeListFlow = ({ companyId, onEvent }: EmployeeListFlowProps) => {\n  const machine = useMemo(\n    () =>\n      createMachine(\n        'list',\n        employeeListStateMachine,\n        (initialContext: EmployeeListFlowContextInterface) => ({\n          ...initialContext,\n          component: EmployeeListContextual,\n          companyId,\n        }),\n      ),\n    [companyId],\n  )\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n"],"names":["EmployeeListFlow","companyId","onEvent","machine","useMemo","createMachine","employeeListStateMachine","initialContext","EmployeeListContextual","jsx","Flow"],"mappings":";;;;;;AA4CO,MAAMA,IAAmB,CAAC,EAAE,WAAAC,GAAW,SAAAC,QAAqC;AACjF,QAAMC,IAAUC;AAAA,IACd,MACEC;AAAA,MACE;AAAA,MACAC;AAAA,MACA,CAACC,OAAsD;AAAA,QACrD,GAAGA;AAAA,QACH,WAAWC;AAAA,QACX,WAAAP;AAAA,MAAA;AAAA,IACF;AAAA,IAEJ,CAACA,CAAS;AAAA,EAAA;AAEZ,SAAO,gBAAAQ,EAACC,GAAA,EAAK,SAAAP,GAAkB,SAAAD,EAAA,CAAkB;AACnD;"}

package/dist/components/Employee/EmployeeListFlow/EmployeeListFlowComponents.d.ts

@@ -1,13 +1,24 @@
 import { FlowContextInterface } from '../../Flow/useFlow';
 import { BaseComponentInterface } from '../../Base';
+/**
+ * Props for {@link EmployeeListFlow}.
+ *
+ * @public
+ */
 export interface EmployeeListFlowProps extends BaseComponentInterface {
+    /** The associated company identifier. */
     companyId: string;
 }
+/** @internal */
 export interface EmployeeListFlowContextInterface extends FlowContextInterface {
     companyId: string;
     employeeId?: string;
 }
+/** @internal */
 export declare function EmployeeListContextual(): import("react").JSX.Element;
+/** @internal */
 export declare function DashboardFlowContextual(): import("react").JSX.Element;
+/** @internal */
 export declare function TerminationFlowContextual(): import("react").JSX.Element;
+/** @internal */
 export declare function OnboardingExecutionFlowContextual(): import("react").JSX.Element;

package/dist/components/Employee/EmployeeListFlow/EmployeeListFlowComponents.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmployeeListFlowComponents.js","sources":["../../../../src/components/Employee/EmployeeListFlow/EmployeeListFlowComponents.tsx"],"sourcesContent":["import { ManagementEmployeeList } from '../EmployeeList/management/ManagementEmployeeList'\nimport { DashboardFlow } from '../Dashboard'\nimport { TerminationFlow } from '../Terminations/TerminationFlow/TerminationFlow'\nimport { OnboardingExecutionFlow } from '../OnboardingExecutionFlow/OnboardingExecutionFlow'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport type { BaseComponentInterface } from '@/components/Base'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\nexport interface EmployeeListFlowProps extends BaseComponentInterface {\n  companyId: string\n}\n\nexport interface EmployeeListFlowContextInterface extends FlowContextInterface {\n  companyId: string\n  employeeId?: string\n}\n\nexport function EmployeeListContextual() {\n  const { companyId, onEvent } = useFlow<EmployeeListFlowContextInterface>()\n  return <ManagementEmployeeList companyId={ensureRequired(companyId)} onEvent={onEvent} />\n}\n\nexport function DashboardFlowContextual() {\n  const { employeeId, onEvent } = useFlow<EmployeeListFlowContextInterface>()\n  return <DashboardFlow employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n\nexport function TerminationFlowContextual() {\n  const { companyId, employeeId, onEvent } = useFlow<EmployeeListFlowContextInterface>()\n  return (\n    <TerminationFlow\n      companyId={ensureRequired(companyId)}\n      employeeId={ensureRequired(employeeId)}\n      onEvent={onEvent}\n    />\n  )\n}\n\nexport function OnboardingExecutionFlowContextual() {\n  const { companyId, onEvent } = useFlow<EmployeeListFlowContextInterface>()\n  return <OnboardingExecutionFlow companyId={ensureRequired(companyId)} onEvent={onEvent} />\n}\n"],"names":["EmployeeListContextual","companyId","onEvent","useFlow","ManagementEmployeeList","ensureRequired","DashboardFlowContextual","employeeId","DashboardFlow","TerminationFlowContextual","jsx","TerminationFlow","OnboardingExecutionFlowContextual","OnboardingExecutionFlow"],"mappings":";;;;;;;AAiBO,SAASA,IAAyB;AACvC,QAAM,EAAE,WAAAC,GAAW,SAAAC,EAAA,IAAYC,EAAA;AAC/B,2BAAQC,GAAA,EAAuB,WAAWC,EAAeJ,CAAS,GAAG,SAAAC,GAAkB;AACzF;AAEO,SAASI,IAA0B;AACxC,QAAM,EAAE,YAAAC,GAAY,SAAAL,EAAA,IAAYC,EAAA;AAChC,2BAAQK,GAAA,EAAc,YAAYH,EAAeE,CAAU,GAAG,SAAAL,GAAkB;AAClF;AAEO,SAASO,IAA4B;AAC1C,QAAM,EAAE,WAAAR,GAAW,YAAAM,GAAY,SAAAL,EAAA,IAAYC,EAAA;AAC3C,SACE,gBAAAO;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,WAAWN,EAAeJ,CAAS;AAAA,MACnC,YAAYI,EAAeE,CAAU;AAAA,MACrC,SAAAL;AAAA,IAAA;AAAA,EAAA;AAGN;AAEO,SAASU,IAAoC;AAClD,QAAM,EAAE,WAAAX,GAAW,SAAAC,EAAA,IAAYC,EAAA;AAC/B,2BAAQU,GAAA,EAAwB,WAAWR,EAAeJ,CAAS,GAAG,SAAAC,GAAkB;AAC1F;"}
+{"version":3,"file":"EmployeeListFlowComponents.js","sources":["../../../../src/components/Employee/EmployeeListFlow/EmployeeListFlowComponents.tsx"],"sourcesContent":["import { ManagementEmployeeList } from '../EmployeeList/management/ManagementEmployeeList'\nimport { DashboardFlow } from '../Dashboard'\nimport { TerminationFlow } from '../Terminations/TerminationFlow/TerminationFlow'\nimport { OnboardingExecutionFlow } from '../OnboardingExecutionFlow/OnboardingExecutionFlow'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport type { BaseComponentInterface } from '@/components/Base'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/**\n * Props for {@link EmployeeListFlow}.\n *\n * @public\n */\nexport interface EmployeeListFlowProps extends BaseComponentInterface {\n  /** The associated company identifier. */\n  companyId: string\n}\n\n/** @internal */\nexport interface EmployeeListFlowContextInterface extends FlowContextInterface {\n  companyId: string\n  employeeId?: string\n}\n\n/** @internal */\nexport function EmployeeListContextual() {\n  const { companyId, onEvent } = useFlow<EmployeeListFlowContextInterface>()\n  return <ManagementEmployeeList companyId={ensureRequired(companyId)} onEvent={onEvent} />\n}\n\n/** @internal */\nexport function DashboardFlowContextual() {\n  const { employeeId, onEvent } = useFlow<EmployeeListFlowContextInterface>()\n  return <DashboardFlow employeeId={ensureRequired(employeeId)} onEvent={onEvent} />\n}\n\n/** @internal */\nexport function TerminationFlowContextual() {\n  const { companyId, employeeId, onEvent } = useFlow<EmployeeListFlowContextInterface>()\n  return (\n    <TerminationFlow\n      companyId={ensureRequired(companyId)}\n      employeeId={ensureRequired(employeeId)}\n      onEvent={onEvent}\n    />\n  )\n}\n\n/** @internal */\nexport function OnboardingExecutionFlowContextual() {\n  const { companyId, onEvent } = useFlow<EmployeeListFlowContextInterface>()\n  return <OnboardingExecutionFlow companyId={ensureRequired(companyId)} onEvent={onEvent} />\n}\n"],"names":["EmployeeListContextual","companyId","onEvent","useFlow","ManagementEmployeeList","ensureRequired","DashboardFlowContextual","employeeId","DashboardFlow","TerminationFlowContextual","jsx","TerminationFlow","OnboardingExecutionFlowContextual","OnboardingExecutionFlow"],"mappings":";;;;;;;AAyBO,SAASA,IAAyB;AACvC,QAAM,EAAE,WAAAC,GAAW,SAAAC,EAAA,IAAYC,EAAA;AAC/B,2BAAQC,GAAA,EAAuB,WAAWC,EAAeJ,CAAS,GAAG,SAAAC,GAAkB;AACzF;AAGO,SAASI,IAA0B;AACxC,QAAM,EAAE,YAAAC,GAAY,SAAAL,EAAA,IAAYC,EAAA;AAChC,2BAAQK,GAAA,EAAc,YAAYH,EAAeE,CAAU,GAAG,SAAAL,GAAkB;AAClF;AAGO,SAASO,IAA4B;AAC1C,QAAM,EAAE,WAAAR,GAAW,YAAAM,GAAY,SAAAL,EAAA,IAAYC,EAAA;AAC3C,SACE,gBAAAO;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,WAAWN,EAAeJ,CAAS;AAAA,MACnC,YAAYI,EAAeE,CAAU;AAAA,MACrC,SAAAL;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASU,IAAoC;AAClD,QAAM,EAAE,WAAAX,GAAW,SAAAC,EAAA,IAAYC,EAAA;AAC/B,2BAAQU,GAAA,EAAwB,WAAWR,EAAeJ,CAAS,GAAG,SAAAC,GAAkB;AAC1F;"}

package/dist/components/Employee/EmployeeListFlow/employeeListStateMachine.d.ts

@@ -1,3 +1,4 @@
+/** @internal */
 export declare const employeeListStateMachine: {
     list: import('robot3').MachineState<any>;
     dashboard: import('robot3').MachineState<any>;

package/dist/components/Employee/EmployeeListFlow/employeeListStateMachine.js.map

@@ -1 +1 @@
-{"version":3,"file":"employeeListStateMachine.js","sources":["../../../../src/components/Employee/EmployeeListFlow/employeeListStateMachine.ts"],"sourcesContent":["import { transition, reduce, state } from 'robot3'\nimport {\n  DashboardFlowContextual,\n  EmployeeListContextual,\n  OnboardingExecutionFlowContextual,\n  TerminationFlowContextual,\n  type EmployeeListFlowContextInterface,\n} from './EmployeeListFlowComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineEventType, MachineTransition } from '@/types/Helpers'\nimport type { FlowHeaderConfig } from '@/components/Flow/useFlow'\n\ntype EventPayloads = {\n  [componentEvents.EMPLOYEE_UPDATE]: { employeeId: string }\n  [componentEvents.EMPLOYEE_DISMISS]: { employeeId: string }\n}\n\nconst backToListHeader: FlowHeaderConfig = {\n  type: 'minimal',\n  back: {\n    labelKey: 'backToListCta',\n    namespace: 'Employee.ManagementEmployeeList',\n    event: componentEvents.EMPLOYEE_RETURN_TO_LIST,\n  },\n}\n\nconst returnToList = reduce(\n  (ctx: EmployeeListFlowContextInterface): EmployeeListFlowContextInterface => ({\n    ...ctx,\n    component: EmployeeListContextual,\n    header: null,\n    employeeId: undefined,\n  }),\n)\n\nexport const employeeListStateMachine = {\n  list: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_UPDATE,\n      'dashboard',\n      reduce(\n        (\n          ctx: EmployeeListFlowContextInterface,\n          ev: MachineEventType<EventPayloads, typeof componentEvents.EMPLOYEE_UPDATE>,\n        ): EmployeeListFlowContextInterface => ({\n          ...ctx,\n          component: DashboardFlowContextual,\n          header: backToListHeader,\n          employeeId: ev.payload.employeeId,\n        }),\n      ),\n    ),\n    transition(\n      componentEvents.EMPLOYEE_DISMISS,\n      'terminate',\n      reduce(\n        (\n          ctx: EmployeeListFlowContextInterface,\n          ev: MachineEventType<EventPayloads, typeof componentEvents.EMPLOYEE_DISMISS>,\n        ): EmployeeListFlowContextInterface => ({\n          ...ctx,\n          component: TerminationFlowContextual,\n          header: backToListHeader,\n          employeeId: ev.payload.employeeId,\n        }),\n      ),\n    ),\n    transition(\n      componentEvents.EMPLOYEE_CREATE,\n      'onboard',\n      reduce(\n        (ctx: EmployeeListFlowContextInterface): EmployeeListFlowContextInterface => ({\n          ...ctx,\n          component: OnboardingExecutionFlowContextual,\n          header: backToListHeader,\n        }),\n      ),\n    ),\n  ),\n  dashboard: state<MachineTransition>(\n    transition(componentEvents.EMPLOYEE_RETURN_TO_LIST, 'list', returnToList),\n  ),\n  terminate: state<MachineTransition>(\n    transition(componentEvents.EMPLOYEE_RETURN_TO_LIST, 'list', returnToList),\n  ),\n  onboard: state<MachineTransition>(\n    transition(componentEvents.EMPLOYEE_RETURN_TO_LIST, 'list', returnToList),\n    transition(componentEvents.EMPLOYEES_LIST, 'list', returnToList),\n    transition(componentEvents.CANCEL, 'list', returnToList),\n  ),\n}\n"],"names":["backToListHeader","componentEvents","returnToList","reduce","ctx","EmployeeListContextual","employeeListStateMachine","state","transition","ev","DashboardFlowContextual","TerminationFlowContextual","OnboardingExecutionFlowContextual"],"mappings":";;;AAiBA,MAAMA,IAAqC;AAAA,EACzC,MAAM;AAAA,EACN,MAAM;AAAA,IACJ,UAAU;AAAA,IACV,WAAW;AAAA,IACX,OAAOC,EAAgB;AAAA,EAAA;AAE3B,GAEMC,IAAeC;AAAA,EACnB,CAACC,OAA6E;AAAA,IAC5E,GAAGA;AAAA,IACH,WAAWC;AAAA,IACX,QAAQ;AAAA,IACR,YAAY;AAAA,EAAA;AAEhB,GAEaC,IAA2B;AAAA,EACtC,MAAMC;AAAA,IACJC;AAAA,MACEP,EAAgB;AAAA,MAChB;AAAA,MACAE;AAAA,QACE,CACEC,GACAK,OACsC;AAAA,UACtC,GAAGL;AAAA,UACH,WAAWM;AAAA,UACX,QAAQV;AAAA,UACR,YAAYS,EAAG,QAAQ;AAAA,QAAA;AAAA,MACzB;AAAA,IACF;AAAA,IAEFD;AAAA,MACEP,EAAgB;AAAA,MAChB;AAAA,MACAE;AAAA,QACE,CACEC,GACAK,OACsC;AAAA,UACtC,GAAGL;AAAA,UACH,WAAWO;AAAA,UACX,QAAQX;AAAA,UACR,YAAYS,EAAG,QAAQ;AAAA,QAAA;AAAA,MACzB;AAAA,IACF;AAAA,IAEFD;AAAA,MACEP,EAAgB;AAAA,MAChB;AAAA,MACAE;AAAA,QACE,CAACC,OAA6E;AAAA,UAC5E,GAAGA;AAAA,UACH,WAAWQ;AAAA,UACX,QAAQZ;AAAA,QAAA;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAAA,EAEF,WAAWO;AAAA,IACTC,EAAWP,EAAgB,yBAAyB,QAAQC,CAAY;AAAA,EAAA;AAAA,EAE1E,WAAWK;AAAA,IACTC,EAAWP,EAAgB,yBAAyB,QAAQC,CAAY;AAAA,EAAA;AAAA,EAE1E,SAASK;AAAA,IACPC,EAAWP,EAAgB,yBAAyB,QAAQC,CAAY;AAAA,IACxEM,EAAWP,EAAgB,gBAAgB,QAAQC,CAAY;AAAA,IAC/DM,EAAWP,EAAgB,QAAQ,QAAQC,CAAY;AAAA,EAAA;AAE3D;"}
+{"version":3,"file":"employeeListStateMachine.js","sources":["../../../../src/components/Employee/EmployeeListFlow/employeeListStateMachine.ts"],"sourcesContent":["import { transition, reduce, state } from 'robot3'\nimport {\n  DashboardFlowContextual,\n  EmployeeListContextual,\n  OnboardingExecutionFlowContextual,\n  TerminationFlowContextual,\n  type EmployeeListFlowContextInterface,\n} from './EmployeeListFlowComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineEventType, MachineTransition } from '@/types/Helpers'\nimport type { FlowHeaderConfig } from '@/components/Flow/useFlow'\n\ntype EventPayloads = {\n  [componentEvents.EMPLOYEE_UPDATE]: { employeeId: string }\n  [componentEvents.EMPLOYEE_DISMISS]: { employeeId: string }\n}\n\nconst backToListHeader: FlowHeaderConfig = {\n  type: 'minimal',\n  back: {\n    labelKey: 'backToListCta',\n    namespace: 'Employee.ManagementEmployeeList',\n    event: componentEvents.EMPLOYEE_RETURN_TO_LIST,\n  },\n}\n\nconst returnToList = reduce(\n  (ctx: EmployeeListFlowContextInterface): EmployeeListFlowContextInterface => ({\n    ...ctx,\n    component: EmployeeListContextual,\n    header: null,\n    employeeId: undefined,\n  }),\n)\n\n/** @internal */\nexport const employeeListStateMachine = {\n  list: state<MachineTransition>(\n    transition(\n      componentEvents.EMPLOYEE_UPDATE,\n      'dashboard',\n      reduce(\n        (\n          ctx: EmployeeListFlowContextInterface,\n          ev: MachineEventType<EventPayloads, typeof componentEvents.EMPLOYEE_UPDATE>,\n        ): EmployeeListFlowContextInterface => ({\n          ...ctx,\n          component: DashboardFlowContextual,\n          header: backToListHeader,\n          employeeId: ev.payload.employeeId,\n        }),\n      ),\n    ),\n    transition(\n      componentEvents.EMPLOYEE_DISMISS,\n      'terminate',\n      reduce(\n        (\n          ctx: EmployeeListFlowContextInterface,\n          ev: MachineEventType<EventPayloads, typeof componentEvents.EMPLOYEE_DISMISS>,\n        ): EmployeeListFlowContextInterface => ({\n          ...ctx,\n          component: TerminationFlowContextual,\n          header: backToListHeader,\n          employeeId: ev.payload.employeeId,\n        }),\n      ),\n    ),\n    transition(\n      componentEvents.EMPLOYEE_CREATE,\n      'onboard',\n      reduce(\n        (ctx: EmployeeListFlowContextInterface): EmployeeListFlowContextInterface => ({\n          ...ctx,\n          component: OnboardingExecutionFlowContextual,\n          header: backToListHeader,\n        }),\n      ),\n    ),\n  ),\n  dashboard: state<MachineTransition>(\n    transition(componentEvents.EMPLOYEE_RETURN_TO_LIST, 'list', returnToList),\n  ),\n  terminate: state<MachineTransition>(\n    transition(componentEvents.EMPLOYEE_RETURN_TO_LIST, 'list', returnToList),\n  ),\n  onboard: state<MachineTransition>(\n    transition(componentEvents.EMPLOYEE_RETURN_TO_LIST, 'list', returnToList),\n    transition(componentEvents.EMPLOYEES_LIST, 'list', returnToList),\n    transition(componentEvents.CANCEL, 'list', returnToList),\n  ),\n}\n"],"names":["backToListHeader","componentEvents","returnToList","reduce","ctx","EmployeeListContextual","employeeListStateMachine","state","transition","ev","DashboardFlowContextual","TerminationFlowContextual","OnboardingExecutionFlowContextual"],"mappings":";;;AAiBA,MAAMA,IAAqC;AAAA,EACzC,MAAM;AAAA,EACN,MAAM;AAAA,IACJ,UAAU;AAAA,IACV,WAAW;AAAA,IACX,OAAOC,EAAgB;AAAA,EAAA;AAE3B,GAEMC,IAAeC;AAAA,EACnB,CAACC,OAA6E;AAAA,IAC5E,GAAGA;AAAA,IACH,WAAWC;AAAA,IACX,QAAQ;AAAA,IACR,YAAY;AAAA,EAAA;AAEhB,GAGaC,IAA2B;AAAA,EACtC,MAAMC;AAAA,IACJC;AAAA,MACEP,EAAgB;AAAA,MAChB;AAAA,MACAE;AAAA,QACE,CACEC,GACAK,OACsC;AAAA,UACtC,GAAGL;AAAA,UACH,WAAWM;AAAA,UACX,QAAQV;AAAA,UACR,YAAYS,EAAG,QAAQ;AAAA,QAAA;AAAA,MACzB;AAAA,IACF;AAAA,IAEFD;AAAA,MACEP,EAAgB;AAAA,MAChB;AAAA,MACAE;AAAA,QACE,CACEC,GACAK,OACsC;AAAA,UACtC,GAAGL;AAAA,UACH,WAAWO;AAAA,UACX,QAAQX;AAAA,UACR,YAAYS,EAAG,QAAQ;AAAA,QAAA;AAAA,MACzB;AAAA,IACF;AAAA,IAEFD;AAAA,MACEP,EAAgB;AAAA,MAChB;AAAA,MACAE;AAAA,QACE,CAACC,OAA6E;AAAA,UAC5E,GAAGA;AAAA,UACH,WAAWQ;AAAA,UACX,QAAQZ;AAAA,QAAA;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAAA,EAEF,WAAWO;AAAA,IACTC,EAAWP,EAAgB,yBAAyB,QAAQC,CAAY;AAAA,EAAA;AAAA,EAE1E,WAAWK;AAAA,IACTC,EAAWP,EAAgB,yBAAyB,QAAQC,CAAY;AAAA,EAAA;AAAA,EAE1E,SAASK;AAAA,IACPC,EAAWP,EAAgB,yBAAyB,QAAQC,CAAY;AAAA,IACxEM,EAAWP,EAAgB,gBAAgB,QAAQC,CAAY;AAAA,IAC/DM,EAAWP,EAAgB,QAAQ,QAAQC,CAAY;AAAA,EAAA;AAE3D;"}

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

@@ -1,6 +1,3 @@
 import "./types/i18next.d.ts"
-export { FederalTaxes, FederalTaxesCard, FederalTaxesEditForm } from './management';
-export type { FederalTaxesProps, FederalTaxesCardProps, FederalTaxesEditFormProps, } from './management';
-export { useFederalTaxesForm, createFederalTaxesSchema, FederalTaxesErrorCodes, FILING_STATUS_VALUES, } from './shared/useFederalTaxesForm';
-export type { FederalTaxesOptionalFieldsToRequire, UseFederalTaxesFormProps, UseFederalTaxesFormResult, UseFederalTaxesFormReady, FederalTaxesFieldsMetadata, FederalTaxesFormFields, FederalTaxesFields, FederalTaxesErrorCode, FederalTaxesFormData, FederalTaxesFormOutputs, FederalTaxesField, FilingStatusValue, FederalTaxesRequiredValidation, FilingStatusFieldProps, TwoJobsFieldProps, DependentsAmountFieldProps, OtherIncomeFieldProps, DeductionsFieldProps, ExtraWithholdingFieldProps, } from './shared/useFederalTaxesForm';
-export { useFederalTaxesSummary, type UseFederalTaxesSummaryParams, type UseFederalTaxesSummaryReady, type UseFederalTaxesSummaryResult, } from './shared/useFederalTaxesSummary';
+export { FederalTaxes } from './management';
+export type { FederalTaxesProps } from './management';

package/dist/components/Employee/FederalTaxes/management/FederalTaxes.d.ts

@@ -1,8 +1,35 @@
 import { BaseComponentInterface, CommonComponentInterface } from '../../../Base';
 import { EventType } from '../../../../shared/constants';
 import { OnEventType } from '../../../Base/useBase';
+/**
+ * Props for {@link FederalTaxes}.
+ *
+ * @public
+ */
 export interface FederalTaxesProps extends CommonComponentInterface<'Employee.Management.FederalTaxes'> {
+    /** The associated employee identifier. */
     employeeId: string;
+    /** Callback invoked when the block emits an event. See the events table on {@link FederalTaxes} for the available event types and payloads. */
     onEvent: OnEventType<EventType, unknown>;
 }
+/**
+ * Self-contained block for viewing and editing an employee's federal tax (W-4) withholdings — the same experience the dashboard surfaces, but as a drop-in component that doesn't require the surrounding dashboard chrome.
+ *
+ * @remarks
+ * Renders a read-only card showing filing status, multiple-jobs flag, dependents, other income, deductions, and extra withholding, with an Edit CTA that swaps to the edit form. Submitting the form returns to the card; cancelling returns without saving. Wraps everything in error and suspense boundaries.
+ *
+ * The card and form surfaces ({@link FederalTaxesCard}, {@link FederalTaxesEditForm}) are also exported individually for cases where that orchestration is the wrong fit — for example, when the form needs to render in a modal or drawer, when the card needs to appear read-only with no edit affordance, or when the swap is driven by a router. Using them directly means owning the swap and any cross-component state yourself.
+ *
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `employee/management/federalTaxes/card/editRequested` | Fired when the card's Edit CTA is clicked; the block opens the edit form | `{ employeeId: string }` |
+ * | `employee/management/federalTaxes/editForm/submitted` | Fired after the edit form is saved; the block returns to the card view | The updated `EmployeeFederalTax` entity |
+ * | `employee/management/federalTaxes/editForm/cancelled` | Fired when the user cancels the edit form; the block returns to the card view | — |
+ * | `employee/management/federalTaxes/alertDismissed` | Fired when the user dismisses an alert above the card | `null` |
+ *
+ * @param props - See {@link FederalTaxesProps}.
+ * @returns The rendered federal taxes block.
+ * @public
+ * @group Block Components
+ */
 export declare function FederalTaxes({ dictionary, FallbackComponent, ...props }: FederalTaxesProps & BaseComponentInterface<'Employee.Management.FederalTaxes'>): import("react").JSX.Element;

package/dist/components/Employee/FederalTaxes/management/FederalTaxes.js

@@ -1,17 +1,16 @@
 import { jsx as a } from "react/jsx-runtime";
-import { createMachine as n } from "robot3";
+import { createMachine as m } from "robot3";
 import { useMemo as t } from "react";
 import { FederalTaxesCardContextual as i } from "./FederalTaxesComponents.js";
 import { federalTaxesStateMachine as s } from "./federalTaxesStateMachine.js";
 import { Flow as l } from "../../../Flow/Flow.js";
-import { BaseBoundaries as p } from "../../../Base/Base.js";
-import "../../../Base/useBase.js";
-import { useComponentDictionary as c, useI18n as f } from "../../../../i18n/I18n.js";
+import { BaseBoundaries as c } from "../../../Base/Base.js";
+import { useComponentDictionary as p, useI18n as f } from "../../../../i18n/I18n.js";
 function u({ employeeId: e, onEvent: r }) {
   f("Employee.Management.FederalTaxes");
   const o = t(
-    () => n("card", s, (m) => ({
-      ...m,
+    () => m("card", s, (n) => ({
+      ...n,
       component: i,
       employeeId: e,
       successAlert: null
@@ -20,13 +19,13 @@ function u({ employeeId: e, onEvent: r }) {
   );
   return /* @__PURE__ */ a(l, { machine: o, onEvent: r });
 }
-function E({
+function C({
   dictionary: e,
   FallbackComponent: r,
   ...o
 }) {
-  return c("Employee.Management.FederalTaxes", e), /* @__PURE__ */ a(
-    p,
+  return p("Employee.Management.FederalTaxes", e), /* @__PURE__ */ a(
+    c,
     {
       componentName: "Employee.Management.FederalTaxes",
       FallbackComponent: r,
@@ -35,6 +34,6 @@ function E({
   );
 }
 export {
-  E as FederalTaxes
+  C as FederalTaxes
 };
 //# sourceMappingURL=FederalTaxes.js.map

package/dist/components/Employee/FederalTaxes/management/FederalTaxes.js.map

@@ -1 +1 @@
-{"version":3,"file":"FederalTaxes.js","sources":["../../../../../src/components/Employee/FederalTaxes/management/FederalTaxes.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport {\n  FederalTaxesCardContextual,\n  type FederalTaxesContextInterface,\n} from './FederalTaxesComponents'\nimport { federalTaxesStateMachine } from './federalTaxesStateMachine'\nimport { Flow } from '@/components/Flow/Flow'\nimport {\n  BaseBoundaries,\n  type BaseComponentInterface,\n  type CommonComponentInterface,\n} from '@/components/Base'\nimport { type EventType } from '@/shared/constants'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport { useI18n } from '@/i18n'\nimport type { OnEventType } from '@/components/Base/useBase'\n\nexport interface FederalTaxesProps extends CommonComponentInterface<'Employee.Management.FederalTaxes'> {\n  employeeId: string\n  onEvent: OnEventType<EventType, unknown>\n}\n\nfunction FederalTaxesFlow({ employeeId, onEvent }: FederalTaxesProps) {\n  useI18n('Employee.Management.FederalTaxes')\n\n  const machine = useMemo(\n    () =>\n      createMachine('card', federalTaxesStateMachine, (ctx: FederalTaxesContextInterface) => ({\n        ...ctx,\n        component: FederalTaxesCardContextual,\n        employeeId,\n        successAlert: null,\n      })),\n    [employeeId],\n  )\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n\nexport function FederalTaxes({\n  dictionary,\n  FallbackComponent,\n  ...props\n}: FederalTaxesProps & BaseComponentInterface<'Employee.Management.FederalTaxes'>) {\n  useComponentDictionary('Employee.Management.FederalTaxes', dictionary)\n  return (\n    <BaseBoundaries\n      componentName=\"Employee.Management.FederalTaxes\"\n      FallbackComponent={FallbackComponent}\n    >\n      <FederalTaxesFlow {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["FederalTaxesFlow","employeeId","onEvent","useI18n","machine","useMemo","createMachine","federalTaxesStateMachine","ctx","FederalTaxesCardContextual","jsx","Flow","FederalTaxes","dictionary","FallbackComponent","props","useComponentDictionary","BaseBoundaries"],"mappings":";;;;;;;;;AAuBA,SAASA,EAAiB,EAAE,YAAAC,GAAY,SAAAC,KAA8B;AACpE,EAAAC,EAAQ,kCAAkC;AAE1C,QAAMC,IAAUC;AAAA,IACd,MACEC,EAAc,QAAQC,GAA0B,CAACC,OAAuC;AAAA,MACtF,GAAGA;AAAA,MACH,WAAWC;AAAA,MACX,YAAAR;AAAA,MACA,cAAc;AAAA,IAAA,EACd;AAAA,IACJ,CAACA,CAAU;AAAA,EAAA;AAGb,SAAO,gBAAAS,EAACC,GAAA,EAAK,SAAAP,GAAkB,SAAAF,EAAA,CAAkB;AACnD;AAEO,SAASU,EAAa;AAAA,EAC3B,YAAAC;AAAA,EACA,mBAAAC;AAAA,EACA,GAAGC;AACL,GAAmF;AACjF,SAAAC,EAAuB,oCAAoCH,CAAU,GAEnE,gBAAAH;AAAA,IAACO;AAAA,IAAA;AAAA,MACC,eAAc;AAAA,MACd,mBAAAH;AAAA,MAEA,UAAA,gBAAAJ,EAACV,GAAA,EAAkB,GAAGe,EAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAGnC;"}
+{"version":3,"file":"FederalTaxes.js","sources":["../../../../../src/components/Employee/FederalTaxes/management/FederalTaxes.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport {\n  FederalTaxesCardContextual,\n  type FederalTaxesContextInterface,\n} from './FederalTaxesComponents'\nimport { federalTaxesStateMachine } from './federalTaxesStateMachine'\nimport { Flow } from '@/components/Flow/Flow'\nimport {\n  BaseBoundaries,\n  type BaseComponentInterface,\n  type CommonComponentInterface,\n} from '@/components/Base'\nimport { type EventType } from '@/shared/constants'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport { useI18n } from '@/i18n'\nimport type { OnEventType } from '@/components/Base/useBase'\n\n/**\n * Props for {@link FederalTaxes}.\n *\n * @public\n */\nexport interface FederalTaxesProps extends CommonComponentInterface<'Employee.Management.FederalTaxes'> {\n  /** The associated employee identifier. */\n  employeeId: string\n  /** Callback invoked when the block emits an event. See the events table on {@link FederalTaxes} for the available event types and payloads. */\n  onEvent: OnEventType<EventType, unknown>\n}\n\nfunction FederalTaxesFlow({ employeeId, onEvent }: FederalTaxesProps) {\n  useI18n('Employee.Management.FederalTaxes')\n\n  const machine = useMemo(\n    () =>\n      createMachine('card', federalTaxesStateMachine, (ctx: FederalTaxesContextInterface) => ({\n        ...ctx,\n        component: FederalTaxesCardContextual,\n        employeeId,\n        successAlert: null,\n      })),\n    [employeeId],\n  )\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n\n/**\n * Self-contained block for viewing and editing an employee's federal tax (W-4) withholdings — the same experience the dashboard surfaces, but as a drop-in component that doesn't require the surrounding dashboard chrome.\n *\n * @remarks\n * Renders a read-only card showing filing status, multiple-jobs flag, dependents, other income, deductions, and extra withholding, with an Edit CTA that swaps to the edit form. Submitting the form returns to the card; cancelling returns without saving. Wraps everything in error and suspense boundaries.\n *\n * The card and form surfaces ({@link FederalTaxesCard}, {@link FederalTaxesEditForm}) are also exported individually for cases where that orchestration is the wrong fit — for example, when the form needs to render in a modal or drawer, when the card needs to appear read-only with no edit affordance, or when the swap is driven by a router. Using them directly means owning the swap and any cross-component state yourself.\n *\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/management/federalTaxes/card/editRequested` | Fired when the card's Edit CTA is clicked; the block opens the edit form | `{ employeeId: string }` |\n * | `employee/management/federalTaxes/editForm/submitted` | Fired after the edit form is saved; the block returns to the card view | The updated `EmployeeFederalTax` entity |\n * | `employee/management/federalTaxes/editForm/cancelled` | Fired when the user cancels the edit form; the block returns to the card view | — |\n * | `employee/management/federalTaxes/alertDismissed` | Fired when the user dismisses an alert above the card | `null` |\n *\n * @param props - See {@link FederalTaxesProps}.\n * @returns The rendered federal taxes block.\n * @public\n * @group Block Components\n */\nexport function FederalTaxes({\n  dictionary,\n  FallbackComponent,\n  ...props\n}: FederalTaxesProps & BaseComponentInterface<'Employee.Management.FederalTaxes'>) {\n  useComponentDictionary('Employee.Management.FederalTaxes', dictionary)\n  return (\n    <BaseBoundaries\n      componentName=\"Employee.Management.FederalTaxes\"\n      FallbackComponent={FallbackComponent}\n    >\n      <FederalTaxesFlow {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["FederalTaxesFlow","employeeId","onEvent","useI18n","machine","useMemo","createMachine","federalTaxesStateMachine","ctx","FederalTaxesCardContextual","jsx","Flow","FederalTaxes","dictionary","FallbackComponent","props","useComponentDictionary","BaseBoundaries"],"mappings":";;;;;;;;AA8BA,SAASA,EAAiB,EAAE,YAAAC,GAAY,SAAAC,KAA8B;AACpE,EAAAC,EAAQ,kCAAkC;AAE1C,QAAMC,IAAUC;AAAA,IACd,MACEC,EAAc,QAAQC,GAA0B,CAACC,OAAuC;AAAA,MACtF,GAAGA;AAAA,MACH,WAAWC;AAAA,MACX,YAAAR;AAAA,MACA,cAAc;AAAA,IAAA,EACd;AAAA,IACJ,CAACA,CAAU;AAAA,EAAA;AAGb,SAAO,gBAAAS,EAACC,GAAA,EAAK,SAAAP,GAAkB,SAAAF,EAAA,CAAkB;AACnD;AAsBO,SAASU,EAAa;AAAA,EAC3B,YAAAC;AAAA,EACA,mBAAAC;AAAA,EACA,GAAGC;AACL,GAAmF;AACjF,SAAAC,EAAuB,oCAAoCH,CAAU,GAEnE,gBAAAH;AAAA,IAACO;AAAA,IAAA;AAAA,MACC,eAAc;AAAA,MACd,mBAAAH;AAAA,MAEA,UAAA,gBAAAJ,EAACV,GAAA,EAAkB,GAAGe,EAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAGnC;"}

package/dist/components/Employee/FederalTaxes/management/FederalTaxesCard/FederalTaxesCard.d.ts

@@ -1,7 +1,14 @@
 import { EventType } from '../../../../../shared/constants';
 import { OnEventType } from '../../../../Base/useBase';
+/**
+ * Props for {@link FederalTaxesCard}.
+ *
+ * @public
+ */
 export interface FederalTaxesCardProps {
+    /** The associated employee identifier. */
     employeeId: string;
+    /** Callback invoked when the card emits an event. See the events table on {@link FederalTaxesCard} for the available event types and payloads. */
     onEvent: OnEventType<EventType, unknown>;
 }
 /**
@@ -10,5 +17,7 @@ export interface FederalTaxesCardProps {
  * `EMPLOYEE_MANAGEMENT_FEDERAL_TAXES_CARD_EDIT_REQUESTED` when the Edit
  * button is clicked. The card has no alert API — alert rendering (when
  * introduced) is the orchestrator's responsibility.
+ *
+ * @public
  */
 export declare function FederalTaxesCard(props: FederalTaxesCardProps): import("react").JSX.Element;