@gusto/embedded-react-sdk 0.51.2 → 0.52.0

package/dist/contexts/ComponentAdapter/useComponentContext.d.ts

@@ -14,6 +14,7 @@ import { ButtonIconProps, ButtonProps } from '../../components/Common/UI/Button/
 import { AlertProps } from '../../components/Common/UI/Alert/AlertTypes';
 import { CardProps } from '../../components/Common/UI/Card/CardTypes';
 import { BoxProps } from '../../components/Common/UI/Box/BoxTypes';
+import { FormBoxProps } from '../../components/Common/UI/FormBox/FormBoxTypes';
 import { LinkProps } from '../../components/Common/UI/Link/LinkTypes';
 import { BadgeProps } from '../../components/Common/UI/Badge/BadgeTypes';
 import { BannerProps } from '../../components/Common/UI/Banner/BannerTypes';
@@ -34,6 +35,7 @@ import { LoadingSpinnerProps } from '../../components/Common/UI/LoadingSpinner/L
 import { DescriptionListProps } from '../../components/Common/UI/DescriptionList/DescriptionListTypes';
 import { FileInputProps } from '../../components/Common/UI/FileInput/FileInputTypes';
 import { BoxHeaderProps } from '../../components/Common/UI/BoxHeader/BoxHeaderTypes';
+import { FormBoxHeaderProps } from '../../components/Common/UI/FormBoxHeader/FormBoxHeaderTypes';
 import { MultiSelectComboBoxProps } from '../../components/Common/UI/MultiSelectComboBox/MultiSelectComboBoxTypes';
 import { PayrollLoadingProps } from '../../components/Common/PayrollLoading/PayrollLoadingTypes';
 /**
@@ -107,6 +109,10 @@ export interface ComponentsContextType {
     Box: FunctionComponent<BoxProps>;
     /** Header section of a Box with a title, optional description, and optional inline action. */
     BoxHeader: FunctionComponent<BoxHeaderProps>;
+    /** Bordered container for grouping related form fields, with an optional header slot. */
+    FormBox: FunctionComponent<FormBoxProps>;
+    /** Header section of a FormBox with a title, optional description, and optional inline action. */
+    FormBoxHeader: FunctionComponent<FormBoxHeaderProps>;
     /** Read-only calendar for visualizing a date range with optional highlighted dates. */
     CalendarPreview: FunctionComponent<CalendarPreviewProps>;
     /** Content container with an optional overflow menu and a leading action slot. */

package/dist/contexts/ComponentAdapter/useComponentContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"useComponentContext.js","sources":["../../../src/contexts/ComponentAdapter/useComponentContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\nimport type { FunctionComponent } from 'react'\nimport type { TextInputProps } from '@/components/Common/UI/TextInput/TextInputTypes'\nimport type { TextAreaProps } from '@/components/Common/UI/TextArea/TextAreaTypes'\nimport type { NumberInputProps } from '@/components/Common/UI/NumberInput/NumberInputTypes'\nimport type { CheckboxGroupProps } from '@/components/Common/UI/CheckboxGroup/CheckboxGroupTypes'\nimport type { ComboBoxProps } from '@/components/Common/UI/ComboBox/ComboBoxTypes'\nimport type { CheckboxProps } from '@/components/Common/UI/Checkbox/CheckboxTypes'\nimport type { DatePickerProps } from '@/components/Common/UI/DatePicker/DatePickerTypes'\nimport type { RadioProps } from '@/components/Common/UI/Radio/RadioTypes'\nimport type { RadioGroupProps } from '@/components/Common/UI/RadioGroup/RadioGroupTypes'\nimport type { SelectProps } from '@/components/Common/UI/Select/SelectTypes'\nimport type { SwitchProps } from '@/components/Common/UI/Switch/SwitchTypes'\nimport type { ButtonIconProps, ButtonProps } from '@/components/Common/UI/Button/ButtonTypes'\nimport type { AlertProps } from '@/components/Common/UI/Alert/AlertTypes'\nimport type { CardProps } from '@/components/Common/UI/Card/CardTypes'\nimport type { BoxProps } from '@/components/Common/UI/Box/BoxTypes'\nimport type { LinkProps } from '@/components/Common/UI/Link/LinkTypes'\nimport type { BadgeProps } from '@/components/Common/UI/Badge/BadgeTypes'\nimport type { BannerProps } from '@/components/Common/UI/Banner/BannerTypes'\nimport type { MenuProps } from '@/components/Common/UI/Menu/MenuTypes'\nimport type { TableProps } from '@/components/Common/UI/Table/TableTypes'\nimport type { OrderedListProps, UnorderedListProps } from '@/components/Common/UI/List/ListTypes'\nimport type { HeadingProps } from '@/components/Common/UI/Heading/HeadingTypes'\nimport type { PaginationControlProps } from '@/components/Common/PaginationControl/PaginationControlTypes'\nimport type { TextProps } from '@/components/Common/UI/Text/TextTypes'\nimport type { CalendarPreviewProps } from '@/components/Common/UI/CalendarPreview/CalendarPreviewTypes'\nimport type { DateRangePickerProps } from '@/components/Common/UI/DateRangePicker/DateRangePickerTypes'\nimport type { ProgressBarProps } from '@/components/Common/UI/ProgressBar/ProgressBarTypes'\nimport type { BreadcrumbsProps } from '@/components/Common/UI/Breadcrumbs/BreadcrumbsTypes'\nimport type { TabsProps } from '@/components/Common/UI/Tabs/TabsTypes'\nimport type { DialogProps } from '@/components/Common/UI/Dialog/DialogTypes'\nimport type { ModalProps } from '@/components/Common/UI/Modal/ModalTypes'\nimport type { LoadingSpinnerProps } from '@/components/Common/UI/LoadingSpinner/LoadingSpinnerTypes'\nimport type { DescriptionListProps } from '@/components/Common/UI/DescriptionList/DescriptionListTypes'\nimport type { FileInputProps } from '@/components/Common/UI/FileInput/FileInputTypes'\nimport type { BoxHeaderProps } from '@/components/Common/UI/BoxHeader/BoxHeaderTypes'\nimport type { MultiSelectComboBoxProps } from '@/components/Common/UI/MultiSelectComboBox/MultiSelectComboBoxTypes'\nimport type { PayrollLoadingProps } from '@/components/Common/PayrollLoading/PayrollLoadingTypes'\n\n/**\n * Full map of UI components used by the SDK. Every property is a React component that the\n * SDK renders internally — override any of them to substitute your own design system.\n *\n * Pass a `Partial<ComponentsContextType>` to {@link GustoProvider} via the `components` prop to\n * replace specific components while keeping SDK defaults for the rest.\n *\n * To take full control of every UI component (and eliminate the React Aria dependency),\n * pass a complete {@link ComponentsContextType} to {@link GustoProviderCustomUIAdapter} instead.\n * All properties are then required except `PaginationControl` and `PayrollLoading`,\n * which fall back to built-in SDK implementations when omitted.\n *\n * @public\n * @group Utility types\n *\n * @example Partial override with GustoProvider\n * ```tsx\n * import { GustoProvider } from '@gusto/embedded-react-sdk'\n *\n * function App() {\n *   return (\n *     <GustoProvider\n *       config={{ baseUrl: '/api/gusto/' }}\n *       components={{\n *         Button: MyButton,\n *         TextInput: MyTextInput,\n *       }}\n *     >\n *       <EmployeeOnboardingFlow companyId=\"company_123\" />\n *     </GustoProvider>\n *   )\n * }\n * ```\n *\n * @example Full replacement with GustoProviderCustomUIAdapter\n * ```tsx\n * import { GustoProviderCustomUIAdapter, type ComponentsContextType } from '@gusto/embedded-react-sdk'\n *\n * const myComponents: ComponentsContextType = {\n *   Alert: props => <MyAlert {...props} />,\n *   Button: props => <MyButton {...props} />,\n *   // ... all required components\n * }\n *\n * function App() {\n *   return (\n *     <GustoProviderCustomUIAdapter\n *       config={{ baseUrl: '/api/gusto/' }}\n *       components={myComponents}\n *     >\n *       <EmployeeOnboardingFlow companyId=\"company_123\" />\n *     </GustoProviderCustomUIAdapter>\n *   )\n * }\n * ```\n */\nexport interface ComponentsContextType {\n  /** Status message with an optional dismiss action; used for errors, warnings, success, and info. */\n  Alert: FunctionComponent<AlertProps>\n  /** Small inline label for status, counts, or tags; optionally dismissible. */\n  Badge: FunctionComponent<BadgeProps>\n  /** Full-width notification banner for prominent warnings and errors. */\n  Banner: FunctionComponent<BannerProps>\n  /** HTML `<button>` with primary, secondary, tertiary, and error variants. */\n  Button: FunctionComponent<ButtonProps>\n  /** Icon-only `<button>`; requires `aria-label` since there is no visible text for assistive technologies. */\n  ButtonIcon: FunctionComponent<ButtonIconProps>\n  /** Sectioned layout container with distinct header, body, and footer areas. */\n  Box: FunctionComponent<BoxProps>\n  /** Header section of a Box with a title, optional description, and optional inline action. */\n  BoxHeader: FunctionComponent<BoxHeaderProps>\n  /** Read-only calendar for visualizing a date range with optional highlighted dates. */\n  CalendarPreview: FunctionComponent<CalendarPreviewProps>\n  /** Content container with an optional overflow menu and a leading action slot. */\n  Card: FunctionComponent<CardProps>\n  /** Form field wrapping a single `<input type=\"checkbox\" />`. */\n  Checkbox: FunctionComponent<CheckboxProps>\n  /** Form field grouping `<input type=\"checkbox\" />` elements for multi-option selection. */\n  CheckboxGroup: FunctionComponent<CheckboxGroupProps>\n  /** Form field wrapping a typeahead `<input />` for single-option selection. */\n  ComboBox: FunctionComponent<ComboBoxProps>\n  /** Form field wrapping an `<input type=\"date\" />` with a calendar picker popover. */\n  DatePicker: FunctionComponent<DatePickerProps>\n  /** Form field wrapping paired `<input type=\"date\" />` elements for a date range. */\n  DateRangePicker: FunctionComponent<DateRangePickerProps>\n  /** HTML `<dl>` of term/description pairs in stacked or horizontal layout. */\n  DescriptionList: FunctionComponent<DescriptionListProps>\n  /** Modal confirmation dialog with a primary action and a cancel action. */\n  Dialog: FunctionComponent<DialogProps>\n  /** Form field wrapping an `<input type=\"file\" />`. */\n  FileInput: FunctionComponent<FileInputProps>\n  /** HTML `<h1>`–`<h6>` with visual style controlled independently from semantic level. */\n  Heading: FunctionComponent<HeadingProps>\n  /** HTML `<a>` for inline navigation. */\n  Link: FunctionComponent<LinkProps>\n  /** Spinner shown while data or an action is pending. */\n  LoadingSpinner: FunctionComponent<LoadingSpinnerProps>\n  /** Popover menu of actions anchored to a trigger element. */\n  Menu: FunctionComponent<MenuProps>\n  /** Overlay modal with customizable body content and footer. */\n  Modal: FunctionComponent<ModalProps>\n  /** Form field wrapping a typeahead `<input />` for multi-option selection. */\n  MultiSelectComboBox: FunctionComponent<MultiSelectComboBoxProps>\n  /** Form field wrapping a numeric `<input />` for currency, decimal, or percent values. */\n  NumberInput: FunctionComponent<NumberInputProps>\n  /** HTML `<ol>` for a numbered list of items. */\n  OrderedList: FunctionComponent<OrderedListProps>\n  /** Step-based progress indicator for multi-step flows. */\n  ProgressBar: FunctionComponent<ProgressBarProps>\n  /** Navigation breadcrumb trail showing the user's position in a multi-step flow. */\n  Breadcrumbs: FunctionComponent<BreadcrumbsProps>\n  /** Form field wrapping a single `<input type=\"radio\" />`. */\n  Radio: FunctionComponent<RadioProps>\n  /** Form field grouping `<input type=\"radio\" />` elements for single-option selection. */\n  RadioGroup: FunctionComponent<RadioGroupProps>\n  /** Form field wrapping a single-select dropdown. */\n  Select: FunctionComponent<SelectProps>\n  /** Form field wrapping an `<input type=\"checkbox\" />` styled as a toggle. */\n  Switch: FunctionComponent<SwitchProps>\n  /** Tabbed navigation with associated content panels. */\n  Tabs: FunctionComponent<TabsProps>\n  /** Tabular data display with headers, rows, optional footer, and empty state. */\n  Table: FunctionComponent<TableProps>\n  /** Body text element rendered as `<p>`, `<span>`, `<div>`, or `<pre>`. */\n  Text: FunctionComponent<TextProps>\n  /** Form field wrapping an `<input />`. */\n  TextInput: FunctionComponent<TextInputProps>\n  /** Form field wrapping a `<textarea>`. */\n  TextArea: FunctionComponent<TextAreaProps>\n  /** HTML `<ul>` for an unordered list of items. */\n  UnorderedList: FunctionComponent<UnorderedListProps>\n\n  /** Pagination controls for list views. Defaults to the SDK's built-in pagination UI when omitted. */\n  PaginationControl?: FunctionComponent<PaginationControlProps>\n  /** Loading indicator for payroll calculation. Defaults to the SDK's built-in loading state when omitted. */\n  PayrollLoading?: FunctionComponent<PayrollLoadingProps>\n}\n\n/** @internal */\nexport const ComponentsContext = createContext<ComponentsContextType | null>(null)\n\n/** @internal */\nexport const useComponentContext = () => {\n  const context = useContext(ComponentsContext)\n  if (!context) {\n    throw new Error('useComponentContext must be used within a ComponentsProvider')\n  }\n  return context\n}\n"],"names":["ComponentsContext","createContext","useComponentContext","context","useContext"],"mappings":";AAmLO,MAAMA,IAAoBC,EAA4C,IAAI,GAGpEC,IAAsB,MAAM;AACvC,QAAMC,IAAUC,EAAWJ,CAAiB;AAC5C,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,8DAA8D;AAEhF,SAAOA;AACT;"}
+{"version":3,"file":"useComponentContext.js","sources":["../../../src/contexts/ComponentAdapter/useComponentContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\nimport type { FunctionComponent } from 'react'\nimport type { TextInputProps } from '@/components/Common/UI/TextInput/TextInputTypes'\nimport type { TextAreaProps } from '@/components/Common/UI/TextArea/TextAreaTypes'\nimport type { NumberInputProps } from '@/components/Common/UI/NumberInput/NumberInputTypes'\nimport type { CheckboxGroupProps } from '@/components/Common/UI/CheckboxGroup/CheckboxGroupTypes'\nimport type { ComboBoxProps } from '@/components/Common/UI/ComboBox/ComboBoxTypes'\nimport type { CheckboxProps } from '@/components/Common/UI/Checkbox/CheckboxTypes'\nimport type { DatePickerProps } from '@/components/Common/UI/DatePicker/DatePickerTypes'\nimport type { RadioProps } from '@/components/Common/UI/Radio/RadioTypes'\nimport type { RadioGroupProps } from '@/components/Common/UI/RadioGroup/RadioGroupTypes'\nimport type { SelectProps } from '@/components/Common/UI/Select/SelectTypes'\nimport type { SwitchProps } from '@/components/Common/UI/Switch/SwitchTypes'\nimport type { ButtonIconProps, ButtonProps } from '@/components/Common/UI/Button/ButtonTypes'\nimport type { AlertProps } from '@/components/Common/UI/Alert/AlertTypes'\nimport type { CardProps } from '@/components/Common/UI/Card/CardTypes'\nimport type { BoxProps } from '@/components/Common/UI/Box/BoxTypes'\nimport type { FormBoxProps } from '@/components/Common/UI/FormBox/FormBoxTypes'\nimport type { LinkProps } from '@/components/Common/UI/Link/LinkTypes'\nimport type { BadgeProps } from '@/components/Common/UI/Badge/BadgeTypes'\nimport type { BannerProps } from '@/components/Common/UI/Banner/BannerTypes'\nimport type { MenuProps } from '@/components/Common/UI/Menu/MenuTypes'\nimport type { TableProps } from '@/components/Common/UI/Table/TableTypes'\nimport type { OrderedListProps, UnorderedListProps } from '@/components/Common/UI/List/ListTypes'\nimport type { HeadingProps } from '@/components/Common/UI/Heading/HeadingTypes'\nimport type { PaginationControlProps } from '@/components/Common/PaginationControl/PaginationControlTypes'\nimport type { TextProps } from '@/components/Common/UI/Text/TextTypes'\nimport type { CalendarPreviewProps } from '@/components/Common/UI/CalendarPreview/CalendarPreviewTypes'\nimport type { DateRangePickerProps } from '@/components/Common/UI/DateRangePicker/DateRangePickerTypes'\nimport type { ProgressBarProps } from '@/components/Common/UI/ProgressBar/ProgressBarTypes'\nimport type { BreadcrumbsProps } from '@/components/Common/UI/Breadcrumbs/BreadcrumbsTypes'\nimport type { TabsProps } from '@/components/Common/UI/Tabs/TabsTypes'\nimport type { DialogProps } from '@/components/Common/UI/Dialog/DialogTypes'\nimport type { ModalProps } from '@/components/Common/UI/Modal/ModalTypes'\nimport type { LoadingSpinnerProps } from '@/components/Common/UI/LoadingSpinner/LoadingSpinnerTypes'\nimport type { DescriptionListProps } from '@/components/Common/UI/DescriptionList/DescriptionListTypes'\nimport type { FileInputProps } from '@/components/Common/UI/FileInput/FileInputTypes'\nimport type { BoxHeaderProps } from '@/components/Common/UI/BoxHeader/BoxHeaderTypes'\nimport type { FormBoxHeaderProps } from '@/components/Common/UI/FormBoxHeader/FormBoxHeaderTypes'\nimport type { MultiSelectComboBoxProps } from '@/components/Common/UI/MultiSelectComboBox/MultiSelectComboBoxTypes'\nimport type { PayrollLoadingProps } from '@/components/Common/PayrollLoading/PayrollLoadingTypes'\n\n/**\n * Full map of UI components used by the SDK. Every property is a React component that the\n * SDK renders internally — override any of them to substitute your own design system.\n *\n * Pass a `Partial<ComponentsContextType>` to {@link GustoProvider} via the `components` prop to\n * replace specific components while keeping SDK defaults for the rest.\n *\n * To take full control of every UI component (and eliminate the React Aria dependency),\n * pass a complete {@link ComponentsContextType} to {@link GustoProviderCustomUIAdapter} instead.\n * All properties are then required except `PaginationControl` and `PayrollLoading`,\n * which fall back to built-in SDK implementations when omitted.\n *\n * @public\n * @group Utility types\n *\n * @example Partial override with GustoProvider\n * ```tsx\n * import { GustoProvider } from '@gusto/embedded-react-sdk'\n *\n * function App() {\n *   return (\n *     <GustoProvider\n *       config={{ baseUrl: '/api/gusto/' }}\n *       components={{\n *         Button: MyButton,\n *         TextInput: MyTextInput,\n *       }}\n *     >\n *       <EmployeeOnboardingFlow companyId=\"company_123\" />\n *     </GustoProvider>\n *   )\n * }\n * ```\n *\n * @example Full replacement with GustoProviderCustomUIAdapter\n * ```tsx\n * import { GustoProviderCustomUIAdapter, type ComponentsContextType } from '@gusto/embedded-react-sdk'\n *\n * const myComponents: ComponentsContextType = {\n *   Alert: props => <MyAlert {...props} />,\n *   Button: props => <MyButton {...props} />,\n *   // ... all required components\n * }\n *\n * function App() {\n *   return (\n *     <GustoProviderCustomUIAdapter\n *       config={{ baseUrl: '/api/gusto/' }}\n *       components={myComponents}\n *     >\n *       <EmployeeOnboardingFlow companyId=\"company_123\" />\n *     </GustoProviderCustomUIAdapter>\n *   )\n * }\n * ```\n */\nexport interface ComponentsContextType {\n  /** Status message with an optional dismiss action; used for errors, warnings, success, and info. */\n  Alert: FunctionComponent<AlertProps>\n  /** Small inline label for status, counts, or tags; optionally dismissible. */\n  Badge: FunctionComponent<BadgeProps>\n  /** Full-width notification banner for prominent warnings and errors. */\n  Banner: FunctionComponent<BannerProps>\n  /** HTML `<button>` with primary, secondary, tertiary, and error variants. */\n  Button: FunctionComponent<ButtonProps>\n  /** Icon-only `<button>`; requires `aria-label` since there is no visible text for assistive technologies. */\n  ButtonIcon: FunctionComponent<ButtonIconProps>\n  /** Sectioned layout container with distinct header, body, and footer areas. */\n  Box: FunctionComponent<BoxProps>\n  /** Header section of a Box with a title, optional description, and optional inline action. */\n  BoxHeader: FunctionComponent<BoxHeaderProps>\n  /** Bordered container for grouping related form fields, with an optional header slot. */\n  FormBox: FunctionComponent<FormBoxProps>\n  /** Header section of a FormBox with a title, optional description, and optional inline action. */\n  FormBoxHeader: FunctionComponent<FormBoxHeaderProps>\n  /** Read-only calendar for visualizing a date range with optional highlighted dates. */\n  CalendarPreview: FunctionComponent<CalendarPreviewProps>\n  /** Content container with an optional overflow menu and a leading action slot. */\n  Card: FunctionComponent<CardProps>\n  /** Form field wrapping a single `<input type=\"checkbox\" />`. */\n  Checkbox: FunctionComponent<CheckboxProps>\n  /** Form field grouping `<input type=\"checkbox\" />` elements for multi-option selection. */\n  CheckboxGroup: FunctionComponent<CheckboxGroupProps>\n  /** Form field wrapping a typeahead `<input />` for single-option selection. */\n  ComboBox: FunctionComponent<ComboBoxProps>\n  /** Form field wrapping an `<input type=\"date\" />` with a calendar picker popover. */\n  DatePicker: FunctionComponent<DatePickerProps>\n  /** Form field wrapping paired `<input type=\"date\" />` elements for a date range. */\n  DateRangePicker: FunctionComponent<DateRangePickerProps>\n  /** HTML `<dl>` of term/description pairs in stacked or horizontal layout. */\n  DescriptionList: FunctionComponent<DescriptionListProps>\n  /** Modal confirmation dialog with a primary action and a cancel action. */\n  Dialog: FunctionComponent<DialogProps>\n  /** Form field wrapping an `<input type=\"file\" />`. */\n  FileInput: FunctionComponent<FileInputProps>\n  /** HTML `<h1>`–`<h6>` with visual style controlled independently from semantic level. */\n  Heading: FunctionComponent<HeadingProps>\n  /** HTML `<a>` for inline navigation. */\n  Link: FunctionComponent<LinkProps>\n  /** Spinner shown while data or an action is pending. */\n  LoadingSpinner: FunctionComponent<LoadingSpinnerProps>\n  /** Popover menu of actions anchored to a trigger element. */\n  Menu: FunctionComponent<MenuProps>\n  /** Overlay modal with customizable body content and footer. */\n  Modal: FunctionComponent<ModalProps>\n  /** Form field wrapping a typeahead `<input />` for multi-option selection. */\n  MultiSelectComboBox: FunctionComponent<MultiSelectComboBoxProps>\n  /** Form field wrapping a numeric `<input />` for currency, decimal, or percent values. */\n  NumberInput: FunctionComponent<NumberInputProps>\n  /** HTML `<ol>` for a numbered list of items. */\n  OrderedList: FunctionComponent<OrderedListProps>\n  /** Step-based progress indicator for multi-step flows. */\n  ProgressBar: FunctionComponent<ProgressBarProps>\n  /** Navigation breadcrumb trail showing the user's position in a multi-step flow. */\n  Breadcrumbs: FunctionComponent<BreadcrumbsProps>\n  /** Form field wrapping a single `<input type=\"radio\" />`. */\n  Radio: FunctionComponent<RadioProps>\n  /** Form field grouping `<input type=\"radio\" />` elements for single-option selection. */\n  RadioGroup: FunctionComponent<RadioGroupProps>\n  /** Form field wrapping a single-select dropdown. */\n  Select: FunctionComponent<SelectProps>\n  /** Form field wrapping an `<input type=\"checkbox\" />` styled as a toggle. */\n  Switch: FunctionComponent<SwitchProps>\n  /** Tabbed navigation with associated content panels. */\n  Tabs: FunctionComponent<TabsProps>\n  /** Tabular data display with headers, rows, optional footer, and empty state. */\n  Table: FunctionComponent<TableProps>\n  /** Body text element rendered as `<p>`, `<span>`, `<div>`, or `<pre>`. */\n  Text: FunctionComponent<TextProps>\n  /** Form field wrapping an `<input />`. */\n  TextInput: FunctionComponent<TextInputProps>\n  /** Form field wrapping a `<textarea>`. */\n  TextArea: FunctionComponent<TextAreaProps>\n  /** HTML `<ul>` for an unordered list of items. */\n  UnorderedList: FunctionComponent<UnorderedListProps>\n\n  /** Pagination controls for list views. Defaults to the SDK's built-in pagination UI when omitted. */\n  PaginationControl?: FunctionComponent<PaginationControlProps>\n  /** Loading indicator for payroll calculation. Defaults to the SDK's built-in loading state when omitted. */\n  PayrollLoading?: FunctionComponent<PayrollLoadingProps>\n}\n\n/** @internal */\nexport const ComponentsContext = createContext<ComponentsContextType | null>(null)\n\n/** @internal */\nexport const useComponentContext = () => {\n  const context = useContext(ComponentsContext)\n  if (!context) {\n    throw new Error('useComponentContext must be used within a ComponentsProvider')\n  }\n  return context\n}\n"],"names":["ComponentsContext","createContext","useComponentContext","context","useContext"],"mappings":";AAyLO,MAAMA,IAAoBC,EAA4C,IAAI,GAGpEC,IAAsB,MAAM;AACvC,QAAMC,IAAUC,EAAWJ,CAAiB;AAC5C,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,8DAA8D;AAEhF,SAAOA;AACT;"}

package/dist/contexts/GustoProvider/GustoProvider.d.ts

@@ -1,7 +1,7 @@
 import { default as React } from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { ComponentsContextType } from '../ComponentAdapter/useComponentContext';
-import { GustoProviderProps } from './GustoProviderCustomUIAdapter';
+import { GustoBaseProviderProps } from './GustoProviderCustomUIAdapter';
 /**
  * Props for {@link GustoProvider}.
  *
@@ -11,7 +11,7 @@ import { GustoProviderProps } from './GustoProviderCustomUIAdapter';
  *
  * @public
  */
-export interface GustoApiProps extends Omit<GustoProviderProps, 'components'> {
+export interface GustoProviderProps extends Omit<GustoBaseProviderProps, 'components'> {
     /** Optional TanStack Query `QueryClient` to share with the rest of your app. When omitted, the SDK creates its own client configured for Gusto's API. */
     queryClient?: QueryClient;
     /** Partial component overrides. Any component you do not supply uses the SDK's default React Aria implementation. */
@@ -31,9 +31,8 @@ export interface GustoApiProps extends Omit<GustoProviderProps, 'components'> {
  * For full UI control without the bundled React Aria defaults, use {@link GustoProviderCustomUIAdapter}
  * instead and supply a complete component map.
  *
- * @param props - See {@link GustoApiProps}.
+ * @param props - See {@link GustoProviderProps}.
  * @returns The configured provider tree wrapping `children`.
  * @public
  */
-declare const GustoProvider: React.FC<GustoApiProps>;
-export { GustoProvider };
+export declare function GustoProvider(props: GustoProviderProps): React.JSX.Element;

package/dist/contexts/GustoProvider/GustoProvider.js

@@ -2,20 +2,20 @@ import { jsx as r } from "react/jsx-runtime";
 import { I18nProvider as p } from "react-aria-components";
 import { createComponents as s } from "../ComponentAdapter/createComponentsWithDefaults.js";
 import { GustoProviderCustomUIAdapter as c } from "./GustoProviderCustomUIAdapter.js";
-const f = (e) => {
-  const { children: t, components: n = {}, locale: o, queryClient: m, ...i } = e;
+function a(e) {
+  const { children: t, components: n = {}, locale: o, queryClient: i, ...m } = e;
   return /* @__PURE__ */ r(
     c,
     {
       locale: o,
-      queryClient: m,
-      ...i,
+      queryClient: i,
+      ...m,
       components: s(n),
       children: /* @__PURE__ */ r(p, { locale: o, children: t })
     }
   );
-};
+}
 export {
-  f as GustoProvider
+  a as GustoProvider
 };
 //# sourceMappingURL=GustoProvider.js.map

package/dist/contexts/GustoProvider/GustoProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"GustoProvider.js","sources":["../../../src/contexts/GustoProvider/GustoProvider.tsx"],"sourcesContent":["import type React from 'react'\n// GustoProvider uses react-aria as the default components so we need to include the react-aria I18nProvider here.\n// For use without react-aria, the GustoProviderCustomUIAdapter can be used which does not includes it.\n// eslint-disable-next-line no-restricted-imports\nimport { I18nProvider } from 'react-aria-components'\nimport type { QueryClient } from '@tanstack/react-query'\nimport { createComponents } from '../ComponentAdapter/createComponentsWithDefaults'\nimport type { ComponentsContextType } from '../ComponentAdapter/useComponentContext'\nimport {\n  GustoProviderCustomUIAdapter,\n  type GustoProviderProps,\n} from './GustoProviderCustomUIAdapter'\n\n/**\n * Props for {@link GustoProvider}.\n *\n * @remarks\n * Extends {@link GustoProviderProps} but makes `components` optional and partial: any components\n * you do not supply fall back to the SDK's built-in React Aria implementations.\n *\n * @public\n */\nexport interface GustoApiProps extends Omit<GustoProviderProps, 'components'> {\n  /** Optional TanStack Query `QueryClient` to share with the rest of your app. When omitted, the SDK creates its own client configured for Gusto's API. */\n  queryClient?: QueryClient\n  /** Partial component overrides. Any component you do not supply uses the SDK's default React Aria implementation. */\n  components?: Partial<ComponentsContextType>\n  /** The application tree that should have access to the SDK. */\n  children?: React.ReactNode\n}\n\n/**\n * Top-level provider that configures the SDK at the application level.\n *\n * @remarks\n * Wrap your application's component tree with `GustoProvider` so that any SDK component below it\n * has access to the API client, theme, locale, translations, and UI components. Components you\n * provide via the `components` prop override the SDK's React Aria defaults; any component you do\n * not supply uses the default.\n *\n * For full UI control without the bundled React Aria defaults, use {@link GustoProviderCustomUIAdapter}\n * instead and supply a complete component map.\n *\n * @param props - See {@link GustoApiProps}.\n * @returns The configured provider tree wrapping `children`.\n * @public\n */\nconst GustoProvider: React.FC<GustoApiProps> = props => {\n  const { children, components = {}, locale, queryClient, ...remainingProps } = props\n\n  return (\n    <GustoProviderCustomUIAdapter\n      locale={locale}\n      queryClient={queryClient}\n      {...remainingProps}\n      components={createComponents(components)}\n    >\n      {/* react-aria locale provider that exposes correct locale to number formatters */}\n      <I18nProvider locale={locale}>{children}</I18nProvider>\n    </GustoProviderCustomUIAdapter>\n  )\n}\n\nexport { GustoProvider }\n"],"names":["GustoProvider","props","children","components","locale","queryClient","remainingProps","jsx","GustoProviderCustomUIAdapter","createComponents","I18nProvider"],"mappings":";;;;AA+CA,MAAMA,IAAyC,CAAAC,MAAS;AACtD,QAAM,EAAE,UAAAC,GAAU,YAAAC,IAAa,CAAA,GAAI,QAAAC,GAAQ,aAAAC,GAAa,GAAGC,EAAA,IAAmBL;AAE9E,SACE,gBAAAM;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,QAAAJ;AAAA,MACA,aAAAC;AAAA,MACC,GAAGC;AAAA,MACJ,YAAYG,EAAiBN,CAAU;AAAA,MAGvC,UAAA,gBAAAI,EAACG,GAAA,EAAa,QAAAN,GAAiB,UAAAF,EAAA,CAAS;AAAA,IAAA;AAAA,EAAA;AAG9C;"}
+{"version":3,"file":"GustoProvider.js","sources":["../../../src/contexts/GustoProvider/GustoProvider.tsx"],"sourcesContent":["import type React from 'react'\n// GustoProvider uses react-aria as the default components so we need to include the react-aria I18nProvider here.\n// For use without react-aria, the GustoProviderCustomUIAdapter can be used which does not includes it.\n// eslint-disable-next-line no-restricted-imports\nimport { I18nProvider } from 'react-aria-components'\nimport type { QueryClient } from '@tanstack/react-query'\nimport { createComponents } from '../ComponentAdapter/createComponentsWithDefaults'\nimport type { ComponentsContextType } from '../ComponentAdapter/useComponentContext'\nimport type { GustoBaseProviderProps } from './GustoProviderCustomUIAdapter'\nimport { GustoProviderCustomUIAdapter } from './GustoProviderCustomUIAdapter'\n\n/**\n * Props for {@link GustoProvider}.\n *\n * @remarks\n * Extends {@link GustoProviderProps} but makes `components` optional and partial: any components\n * you do not supply fall back to the SDK's built-in React Aria implementations.\n *\n * @public\n */\nexport interface GustoProviderProps extends Omit<GustoBaseProviderProps, 'components'> {\n  /** Optional TanStack Query `QueryClient` to share with the rest of your app. When omitted, the SDK creates its own client configured for Gusto's API. */\n  queryClient?: QueryClient\n  /** Partial component overrides. Any component you do not supply uses the SDK's default React Aria implementation. */\n  components?: Partial<ComponentsContextType>\n  /** The application tree that should have access to the SDK. */\n  children?: React.ReactNode\n}\n\n/**\n * Top-level provider that configures the SDK at the application level.\n *\n * @remarks\n * Wrap your application's component tree with `GustoProvider` so that any SDK component below it\n * has access to the API client, theme, locale, translations, and UI components. Components you\n * provide via the `components` prop override the SDK's React Aria defaults; any component you do\n * not supply uses the default.\n *\n * For full UI control without the bundled React Aria defaults, use {@link GustoProviderCustomUIAdapter}\n * instead and supply a complete component map.\n *\n * @param props - See {@link GustoProviderProps}.\n * @returns The configured provider tree wrapping `children`.\n * @public\n */\nexport function GustoProvider(props: GustoProviderProps) {\n  const { children, components = {}, locale, queryClient, ...remainingProps } = props\n\n  return (\n    <GustoProviderCustomUIAdapter\n      locale={locale}\n      queryClient={queryClient}\n      {...remainingProps}\n      components={createComponents(components)}\n    >\n      {/* react-aria locale provider that exposes correct locale to number formatters */}\n      <I18nProvider locale={locale}>{children}</I18nProvider>\n    </GustoProviderCustomUIAdapter>\n  )\n}\n"],"names":["GustoProvider","props","children","components","locale","queryClient","remainingProps","jsx","GustoProviderCustomUIAdapter","createComponents","I18nProvider"],"mappings":";;;;AA6CO,SAASA,EAAcC,GAA2B;AACvD,QAAM,EAAE,UAAAC,GAAU,YAAAC,IAAa,CAAA,GAAI,QAAAC,GAAQ,aAAAC,GAAa,GAAGC,EAAA,IAAmBL;AAE9E,SACE,gBAAAM;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,QAAAJ;AAAA,MACA,aAAAC;AAAA,MACC,GAAGC;AAAA,MACJ,YAAYG,EAAiBN,CAAU;AAAA,MAGvC,UAAA,gBAAAI,EAACG,GAAA,EAAa,QAAAN,GAAiB,UAAAF,EAAA,CAAS;AAAA,IAAA;AAAA,EAAA;AAG9C;"}

package/dist/contexts/GustoProvider/GustoProviderCustomUIAdapter.d.ts

@@ -1,7 +1,6 @@
-import { default as React } from 'react';
+import { default as React, JSX, ReactNode } from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { ComponentsContextType } from '../ComponentAdapter/useComponentContext';
-import { LoadingIndicatorContextProps } from '../LoadingIndicatorProvider/useLoadingIndicator';
 import { GustoSDKTheme } from '../ThemeProvider/theme';
 import { GlobalResourceDictionary } from '../../types/Helpers';
 import { SDKHooks } from '../../types/hooks';
@@ -26,7 +25,7 @@ export interface APIConfig {
  *
  * @public
  */
-export interface GustoProviderProps {
+export interface GustoBaseProviderProps {
     /** API client configuration, including the proxy `baseUrl`, request hooks, and observability. See {@link APIConfig}. */
     config: APIConfig;
     /** Translation overrides keyed by language and i18next namespace. Strings supplied here replace the SDK defaults for the matching keys. */
@@ -46,14 +45,16 @@ export interface GustoProviderProps {
     /** Complete map of UI components the SDK renders. Required because this adapter ships no defaults. */
     components: ComponentsContextType;
     /** Loading indicator rendered while SDK queries are pending. Overrides the SDK default spinner. */
-    LoaderComponent?: LoadingIndicatorContextProps['LoadingIndicator'];
+    LoaderComponent?: ({ children }: {
+        children?: ReactNode;
+    }) => JSX.Element;
 }
 /**
  * Props for {@link GustoProviderCustomUIAdapter}.
  *
  * @public
  */
-export interface GustoProviderCustomUIAdapterProps extends GustoProviderProps {
+export interface GustoProviderCustomUIAdapterProps extends GustoBaseProviderProps {
     /** The application tree that should have access to the SDK. */
     children?: React.ReactNode;
 }
@@ -70,5 +71,4 @@ export interface GustoProviderCustomUIAdapterProps extends GustoProviderProps {
  * @returns The configured provider tree wrapping `children`.
  * @public
  */
-declare const GustoProviderCustomUIAdapter: React.FC<GustoProviderCustomUIAdapterProps>;
-export { GustoProviderCustomUIAdapter };
+export declare function GustoProviderCustomUIAdapter(props: GustoProviderCustomUIAdapterProps): JSX.Element;

package/dist/contexts/GustoProvider/GustoProviderCustomUIAdapter.js

@@ -14,7 +14,7 @@ import "../LocaleProvider/useLocale.js";
 import { ThemeProvider as U } from "../ThemeProvider/ThemeProvider.js";
 import { normalizeToSDKError as T } from "../../types/sdkError.js";
 import { ObservabilityProvider as w } from "../ObservabilityProvider/ObservabilityProvider.js";
-const X = (s) => {
+function X(s) {
   const {
     children: l,
     config: r,
@@ -23,10 +23,10 @@ const X = (s) => {
     locale: c = "en-US",
     currency: d = "USD",
     theme: p,
-    portalContainer: v,
-    components: f,
-    LoaderComponent: b,
-    queryClient: u
+    portalContainer: f,
+    components: v,
+    LoaderComponent: u,
+    queryClient: b
   } = s;
   if (i)
     for (const t in i) {
@@ -55,17 +55,17 @@ const X = (s) => {
         r.observability.onError(E);
       };
   }, [r.observability]);
-  return /* @__PURE__ */ o(S, { value: f, children: /* @__PURE__ */ o(L, { value: b, children: /* @__PURE__ */ o(w, { observability: r.observability, children: /* @__PURE__ */ o(g, { FallbackComponent: z, onError: h, children: /* @__PURE__ */ o(U, { theme: p, portalContainer: v, children: /* @__PURE__ */ o(D, { locale: c, currency: d, children: /* @__PURE__ */ o(P, { i18n: m, children: /* @__PURE__ */ o(
+  return /* @__PURE__ */ o(S, { value: v, children: /* @__PURE__ */ o(L, { value: u, children: /* @__PURE__ */ o(w, { observability: r.observability, children: /* @__PURE__ */ o(g, { FallbackComponent: z, onError: h, children: /* @__PURE__ */ o(U, { theme: p, portalContainer: f, children: /* @__PURE__ */ o(D, { locale: c, currency: d, children: /* @__PURE__ */ o(P, { i18n: m, children: /* @__PURE__ */ o(
     I,
     {
       url: r.baseUrl,
       headers: r.headers,
       hooks: r.hooks,
-      queryClient: u,
+      queryClient: b,
       children: l
     }
   ) }, n) }) }) }) }) }) });
-};
+}
 export {
   X as GustoProviderCustomUIAdapter
 };

package/dist/contexts/GustoProvider/GustoProviderCustomUIAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"GustoProviderCustomUIAdapter.js","sources":["../../../src/contexts/GustoProvider/GustoProviderCustomUIAdapter.tsx"],"sourcesContent":["import type React from 'react'\nimport type { ErrorInfo } from 'react'\nimport { ErrorBoundary } from 'react-error-boundary'\nimport { I18nextProvider } from 'react-i18next'\nimport type { QueryClient } from '@tanstack/react-query'\nimport { useEffect, useMemo } from 'react'\nimport { ComponentsProvider } from '../ComponentAdapter/ComponentsProvider'\nimport type { ComponentsContextType } from '../ComponentAdapter/useComponentContext'\nimport { ApiProvider } from '../ApiProvider/ApiProvider'\nimport { LoadingIndicatorProvider } from '../LoadingIndicatorProvider/LoadingIndicatorProvider'\nimport type { LoadingIndicatorContextProps } from '../LoadingIndicatorProvider/useLoadingIndicator'\nimport { ObservabilityProvider } from '../ObservabilityProvider'\nimport { sanitizeError } from '../ObservabilityProvider/sanitization'\nimport { SDKI18next } from './SDKI18next'\nimport { InternalError } from '@/components/Common'\nimport { LocaleProvider } from '@/contexts/LocaleProvider'\nimport { ThemeProvider } from '@/contexts/ThemeProvider'\nimport type { GustoSDKTheme } from '@/contexts/ThemeProvider/theme'\nimport type { GlobalResourceDictionary, SupportedLanguages } from '@/types/Helpers'\nimport type { SDKHooks } from '@/types/hooks'\nimport type { ObservabilityHook } from '@/types/observability'\nimport { normalizeToSDKError } from '@/types/sdkError'\n\n/**\n * API client configuration passed to {@link GustoProvider} (and {@link GustoProviderCustomUIAdapter}).\n *\n * @public\n */\nexport interface APIConfig {\n  /** URL of your backend proxy that forwards SDK requests to the Gusto Embedded API. SDK components never call Gusto directly. */\n  baseUrl: string\n  /** Extra headers applied to every API request. Combined with any headers your proxy adds. */\n  headers?: HeadersInit\n  /** Request interceptor hooks. Use these to inspect, modify, or react to requests and responses. See {@link SDKHooks}. */\n  hooks?: SDKHooks\n  /** Observability hook for surfacing errors and metrics from the SDK to your monitoring stack. See {@link ObservabilityHook}. */\n  observability?: ObservabilityHook\n}\n\n/**\n * Shared configuration props accepted by {@link GustoProvider} and {@link GustoProviderCustomUIAdapter}.\n *\n * @public\n */\nexport interface GustoProviderProps {\n  /** API client configuration, including the proxy `baseUrl`, request hooks, and observability. See {@link APIConfig}. */\n  config: APIConfig\n  /** Translation overrides keyed by language and i18next namespace. Strings supplied here replace the SDK defaults for the matching keys. */\n  dictionary?: GlobalResourceDictionary\n  /** Active i18next language. Defaults to `'en'`. */\n  lng?: string\n  /** BCP 47 locale used for number, date, and currency formatting throughout the SDK. Defaults to `'en-US'`. */\n  locale?: string\n  /** ISO 4217 currency code used for monetary formatting. Defaults to `'USD'`. */\n  currency?: string\n  /** Theme overrides applied to SDK components. See {@link GustoSDKTheme}. */\n  theme?: Partial<GustoSDKTheme>\n  /** Element to use as the portal container for SDK popovers and dropdowns. Useful when rendering inside a modal or shadow root. */\n  portalContainer?: HTMLElement\n  /** Optional TanStack Query `QueryClient`. When omitted, the SDK creates its own client configured for Gusto's API. */\n  queryClient?: QueryClient\n  /** Complete map of UI components the SDK renders. Required because this adapter ships no defaults. */\n  components: ComponentsContextType\n  /** Loading indicator rendered while SDK queries are pending. Overrides the SDK default spinner. */\n  LoaderComponent?: LoadingIndicatorContextProps['LoadingIndicator']\n}\n\n/**\n * Props for {@link GustoProviderCustomUIAdapter}.\n *\n * @public\n */\nexport interface GustoProviderCustomUIAdapterProps extends GustoProviderProps {\n  /** The application tree that should have access to the SDK. */\n  children?: React.ReactNode\n}\n\n/**\n * Top-level provider that requires a complete component map and ships no UI defaults.\n *\n * @remarks\n * Use this adapter when you want full control over every UI primitive the SDK renders, or when\n * you want to avoid the React Aria dependency for tree-shaking. Unlike {@link GustoProvider}, the\n * `components` prop on {@link GustoProviderProps} is required and must supply every component the\n * SDK renders.\n *\n * @param props - See {@link GustoProviderCustomUIAdapterProps}.\n * @returns The configured provider tree wrapping `children`.\n * @public\n */\nconst GustoProviderCustomUIAdapter: React.FC<GustoProviderCustomUIAdapterProps> = props => {\n  const {\n    children,\n    config,\n    dictionary,\n    lng = 'en',\n    locale = 'en-US',\n    currency = 'USD',\n    theme,\n    portalContainer,\n    components,\n    LoaderComponent,\n    queryClient,\n  } = props\n\n  if (dictionary) {\n    for (const language in dictionary) {\n      const lang = language as SupportedLanguages\n      for (const ns in dictionary[lang]) {\n        SDKI18next.addResourceBundle(\n          lang,\n          ns,\n          (dictionary[lang] as Record<string, unknown>)[ns],\n          true,\n          true,\n        )\n      }\n    }\n  }\n\n  useEffect(() => {\n    void (async () => {\n      await SDKI18next.changeLanguage(lng)\n    })()\n  }, [lng])\n\n  const handleTopLevelError = useMemo(() => {\n    if (!config.observability?.onError) return undefined\n\n    return (error: unknown, errorInfo: ErrorInfo) => {\n      if (!config.observability?.onError) return\n\n      const sdkError = normalizeToSDKError(error)\n\n      const observabilityError = {\n        ...sdkError,\n        timestamp: Date.now(),\n        componentStack: errorInfo.componentStack ?? undefined,\n      }\n\n      const sanitizedError = sanitizeError(observabilityError, config.observability.sanitization)\n\n      config.observability.onError(sanitizedError)\n    }\n  }, [config.observability])\n  return (\n    <ComponentsProvider value={components}>\n      <LoadingIndicatorProvider value={LoaderComponent}>\n        <ObservabilityProvider observability={config.observability}>\n          <ErrorBoundary FallbackComponent={InternalError} onError={handleTopLevelError}>\n            <ThemeProvider theme={theme} portalContainer={portalContainer}>\n              <LocaleProvider locale={locale} currency={currency}>\n                <I18nextProvider i18n={SDKI18next} key={lng}>\n                  <ApiProvider\n                    url={config.baseUrl}\n                    headers={config.headers}\n                    hooks={config.hooks}\n                    queryClient={queryClient}\n                  >\n                    {children}\n                  </ApiProvider>\n                </I18nextProvider>\n              </LocaleProvider>\n            </ThemeProvider>\n          </ErrorBoundary>\n        </ObservabilityProvider>\n      </LoadingIndicatorProvider>\n    </ComponentsProvider>\n  )\n}\n\nexport { GustoProviderCustomUIAdapter }\n"],"names":["GustoProviderCustomUIAdapter","props","children","config","dictionary","lng","locale","currency","theme","portalContainer","components","LoaderComponent","queryClient","language","lang","ns","SDKI18next","useEffect","handleTopLevelError","useMemo","error","errorInfo","observabilityError","normalizeToSDKError","sanitizedError","sanitizeError","jsx","ComponentsProvider","LoadingIndicatorProvider","ObservabilityProvider","ErrorBoundary","InternalError","ThemeProvider","LocaleProvider","I18nextProvider","ApiProvider"],"mappings":";;;;;;;;;;;;;;;;AA0FA,MAAMA,IAA4E,CAAAC,MAAS;AACzF,QAAM;AAAA,IACJ,UAAAC;AAAA,IACA,QAAAC;AAAA,IACA,YAAAC;AAAA,IACA,KAAAC,IAAM;AAAA,IACN,QAAAC,IAAS;AAAA,IACT,UAAAC,IAAW;AAAA,IACX,OAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,YAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,aAAAC;AAAA,EAAA,IACEX;AAEJ,MAAIG;AACF,eAAWS,KAAYT,GAAY;AACjC,YAAMU,IAAOD;AACb,iBAAWE,KAAMX,EAAWU,CAAI;AAC9B,QAAAE,EAAW;AAAA,UACTF;AAAA,UACAC;AAAA,UACCX,EAAWU,CAAI,EAA8BC,CAAE;AAAA,UAChD;AAAA,UACA;AAAA,QAAA;AAAA,IAGN;AAGF,EAAAE,EAAU,MAAM;AACd,KAAM,YACJ,MAAMD,EAAW,eAAeX,CAAG;AAAA,EAEvC,GAAG,CAACA,CAAG,CAAC;AAER,QAAMa,IAAsBC,EAAQ,MAAM;AACxC,QAAKhB,EAAO,eAAe;AAE3B,aAAO,CAACiB,GAAgBC,MAAyB;AAC/C,YAAI,CAAClB,EAAO,eAAe,QAAS;AAIpC,cAAMmB,IAAqB;AAAA,UACzB,GAHeC,EAAoBH,CAAK;AAAA,UAIxC,WAAW,KAAK,IAAA;AAAA,UAChB,gBAAgBC,EAAU,kBAAkB;AAAA,QAAA,GAGxCG,IAAiBC,EAAcH,GAAoBnB,EAAO,cAAc,YAAY;AAE1F,QAAAA,EAAO,cAAc,QAAQqB,CAAc;AAAA,MAC7C;AAAA,EACF,GAAG,CAACrB,EAAO,aAAa,CAAC;AACzB,SACE,gBAAAuB,EAACC,GAAA,EAAmB,OAAOjB,GACzB,UAAA,gBAAAgB,EAACE,GAAA,EAAyB,OAAOjB,GAC/B,UAAA,gBAAAe,EAACG,GAAA,EAAsB,eAAe1B,EAAO,eAC3C,UAAA,gBAAAuB,EAACI,GAAA,EAAc,mBAAmBC,GAAe,SAASb,GACxD,UAAA,gBAAAQ,EAACM,GAAA,EAAc,OAAAxB,GAAc,iBAAAC,GAC3B,UAAA,gBAAAiB,EAACO,GAAA,EAAe,QAAA3B,GAAgB,UAAAC,GAC9B,UAAA,gBAAAmB,EAACQ,GAAA,EAAgB,MAAMlB,GACrB,UAAA,gBAAAU;AAAA,IAACS;AAAA,IAAA;AAAA,MACC,KAAKhC,EAAO;AAAA,MACZ,SAASA,EAAO;AAAA,MAChB,OAAOA,EAAO;AAAA,MACd,aAAAS;AAAA,MAEC,UAAAV;AAAA,IAAA;AAAA,EAAA,KAPmCG,CASxC,GACF,GACF,EAAA,CACF,EAAA,CACF,GACF,GACF;AAEJ;"}
+{"version":3,"file":"GustoProviderCustomUIAdapter.js","sources":["../../../src/contexts/GustoProvider/GustoProviderCustomUIAdapter.tsx"],"sourcesContent":["import type React from 'react'\nimport type { ErrorInfo, JSX, ReactNode } from 'react'\nimport { ErrorBoundary } from 'react-error-boundary'\nimport { I18nextProvider } from 'react-i18next'\nimport type { QueryClient } from '@tanstack/react-query'\nimport { useEffect, useMemo } from 'react'\nimport { ComponentsProvider } from '../ComponentAdapter/ComponentsProvider'\nimport type { ComponentsContextType } from '../ComponentAdapter/useComponentContext'\nimport { ApiProvider } from '../ApiProvider/ApiProvider'\nimport { LoadingIndicatorProvider } from '../LoadingIndicatorProvider/LoadingIndicatorProvider'\nimport { ObservabilityProvider } from '../ObservabilityProvider'\nimport { sanitizeError } from '../ObservabilityProvider/sanitization'\nimport { SDKI18next } from './SDKI18next'\nimport { InternalError } from '@/components/Common'\nimport { LocaleProvider } from '@/contexts/LocaleProvider'\nimport { ThemeProvider } from '@/contexts/ThemeProvider'\nimport type { GustoSDKTheme } from '@/contexts/ThemeProvider/theme'\nimport type { GlobalResourceDictionary, SupportedLanguages } from '@/types/Helpers'\nimport type { SDKHooks } from '@/types/hooks'\nimport type { ObservabilityHook } from '@/types/observability'\nimport { normalizeToSDKError } from '@/types/sdkError'\n\n/**\n * API client configuration passed to {@link GustoProvider} (and {@link GustoProviderCustomUIAdapter}).\n *\n * @public\n */\nexport interface APIConfig {\n  /** URL of your backend proxy that forwards SDK requests to the Gusto Embedded API. SDK components never call Gusto directly. */\n  baseUrl: string\n  /** Extra headers applied to every API request. Combined with any headers your proxy adds. */\n  headers?: HeadersInit\n  /** Request interceptor hooks. Use these to inspect, modify, or react to requests and responses. See {@link SDKHooks}. */\n  hooks?: SDKHooks\n  /** Observability hook for surfacing errors and metrics from the SDK to your monitoring stack. See {@link ObservabilityHook}. */\n  observability?: ObservabilityHook\n}\n\n/**\n * Shared configuration props accepted by {@link GustoProvider} and {@link GustoProviderCustomUIAdapter}.\n *\n * @public\n */\nexport interface GustoBaseProviderProps {\n  /** API client configuration, including the proxy `baseUrl`, request hooks, and observability. See {@link APIConfig}. */\n  config: APIConfig\n  /** Translation overrides keyed by language and i18next namespace. Strings supplied here replace the SDK defaults for the matching keys. */\n  dictionary?: GlobalResourceDictionary\n  /** Active i18next language. Defaults to `'en'`. */\n  lng?: string\n  /** BCP 47 locale used for number, date, and currency formatting throughout the SDK. Defaults to `'en-US'`. */\n  locale?: string\n  /** ISO 4217 currency code used for monetary formatting. Defaults to `'USD'`. */\n  currency?: string\n  /** Theme overrides applied to SDK components. See {@link GustoSDKTheme}. */\n  theme?: Partial<GustoSDKTheme>\n  /** Element to use as the portal container for SDK popovers and dropdowns. Useful when rendering inside a modal or shadow root. */\n  portalContainer?: HTMLElement\n  /** Optional TanStack Query `QueryClient`. When omitted, the SDK creates its own client configured for Gusto's API. */\n  queryClient?: QueryClient\n  /** Complete map of UI components the SDK renders. Required because this adapter ships no defaults. */\n  components: ComponentsContextType\n  /** Loading indicator rendered while SDK queries are pending. Overrides the SDK default spinner. */\n  LoaderComponent?: ({ children }: { children?: ReactNode }) => JSX.Element\n}\n\n/**\n * Props for {@link GustoProviderCustomUIAdapter}.\n *\n * @public\n */\nexport interface GustoProviderCustomUIAdapterProps extends GustoBaseProviderProps {\n  /** The application tree that should have access to the SDK. */\n  children?: React.ReactNode\n}\n\n/**\n * Top-level provider that requires a complete component map and ships no UI defaults.\n *\n * @remarks\n * Use this adapter when you want full control over every UI primitive the SDK renders, or when\n * you want to avoid the React Aria dependency for tree-shaking. Unlike {@link GustoProvider}, the\n * `components` prop on {@link GustoProviderProps} is required and must supply every component the\n * SDK renders.\n *\n * @param props - See {@link GustoProviderCustomUIAdapterProps}.\n * @returns The configured provider tree wrapping `children`.\n * @public\n */\nexport function GustoProviderCustomUIAdapter(props: GustoProviderCustomUIAdapterProps) {\n  const {\n    children,\n    config,\n    dictionary,\n    lng = 'en',\n    locale = 'en-US',\n    currency = 'USD',\n    theme,\n    portalContainer,\n    components,\n    LoaderComponent,\n    queryClient,\n  } = props\n\n  if (dictionary) {\n    for (const language in dictionary) {\n      const lang = language as SupportedLanguages\n      for (const ns in dictionary[lang]) {\n        SDKI18next.addResourceBundle(\n          lang,\n          ns,\n          (dictionary[lang] as Record<string, unknown>)[ns],\n          true,\n          true,\n        )\n      }\n    }\n  }\n\n  useEffect(() => {\n    void (async () => {\n      await SDKI18next.changeLanguage(lng)\n    })()\n  }, [lng])\n\n  const handleTopLevelError = useMemo(() => {\n    if (!config.observability?.onError) return undefined\n\n    return (error: unknown, errorInfo: ErrorInfo) => {\n      if (!config.observability?.onError) return\n\n      const sdkError = normalizeToSDKError(error)\n\n      const observabilityError = {\n        ...sdkError,\n        timestamp: Date.now(),\n        componentStack: errorInfo.componentStack ?? undefined,\n      }\n\n      const sanitizedError = sanitizeError(observabilityError, config.observability.sanitization)\n\n      config.observability.onError(sanitizedError)\n    }\n  }, [config.observability])\n  return (\n    <ComponentsProvider value={components}>\n      <LoadingIndicatorProvider value={LoaderComponent}>\n        <ObservabilityProvider observability={config.observability}>\n          <ErrorBoundary FallbackComponent={InternalError} onError={handleTopLevelError}>\n            <ThemeProvider theme={theme} portalContainer={portalContainer}>\n              <LocaleProvider locale={locale} currency={currency}>\n                <I18nextProvider i18n={SDKI18next} key={lng}>\n                  <ApiProvider\n                    url={config.baseUrl}\n                    headers={config.headers}\n                    hooks={config.hooks}\n                    queryClient={queryClient}\n                  >\n                    {children}\n                  </ApiProvider>\n                </I18nextProvider>\n              </LocaleProvider>\n            </ThemeProvider>\n          </ErrorBoundary>\n        </ObservabilityProvider>\n      </LoadingIndicatorProvider>\n    </ComponentsProvider>\n  )\n}\n"],"names":["GustoProviderCustomUIAdapter","props","children","config","dictionary","lng","locale","currency","theme","portalContainer","components","LoaderComponent","queryClient","language","lang","ns","SDKI18next","useEffect","handleTopLevelError","useMemo","error","errorInfo","observabilityError","normalizeToSDKError","sanitizedError","sanitizeError","jsx","ComponentsProvider","LoadingIndicatorProvider","ObservabilityProvider","ErrorBoundary","InternalError","ThemeProvider","LocaleProvider","I18nextProvider","ApiProvider"],"mappings":";;;;;;;;;;;;;;;;AAyFO,SAASA,EAA6BC,GAA0C;AACrF,QAAM;AAAA,IACJ,UAAAC;AAAA,IACA,QAAAC;AAAA,IACA,YAAAC;AAAA,IACA,KAAAC,IAAM;AAAA,IACN,QAAAC,IAAS;AAAA,IACT,UAAAC,IAAW;AAAA,IACX,OAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,YAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,aAAAC;AAAA,EAAA,IACEX;AAEJ,MAAIG;AACF,eAAWS,KAAYT,GAAY;AACjC,YAAMU,IAAOD;AACb,iBAAWE,KAAMX,EAAWU,CAAI;AAC9B,QAAAE,EAAW;AAAA,UACTF;AAAA,UACAC;AAAA,UACCX,EAAWU,CAAI,EAA8BC,CAAE;AAAA,UAChD;AAAA,UACA;AAAA,QAAA;AAAA,IAGN;AAGF,EAAAE,EAAU,MAAM;AACd,KAAM,YACJ,MAAMD,EAAW,eAAeX,CAAG;AAAA,EAEvC,GAAG,CAACA,CAAG,CAAC;AAER,QAAMa,IAAsBC,EAAQ,MAAM;AACxC,QAAKhB,EAAO,eAAe;AAE3B,aAAO,CAACiB,GAAgBC,MAAyB;AAC/C,YAAI,CAAClB,EAAO,eAAe,QAAS;AAIpC,cAAMmB,IAAqB;AAAA,UACzB,GAHeC,EAAoBH,CAAK;AAAA,UAIxC,WAAW,KAAK,IAAA;AAAA,UAChB,gBAAgBC,EAAU,kBAAkB;AAAA,QAAA,GAGxCG,IAAiBC,EAAcH,GAAoBnB,EAAO,cAAc,YAAY;AAE1F,QAAAA,EAAO,cAAc,QAAQqB,CAAc;AAAA,MAC7C;AAAA,EACF,GAAG,CAACrB,EAAO,aAAa,CAAC;AACzB,SACE,gBAAAuB,EAACC,GAAA,EAAmB,OAAOjB,GACzB,UAAA,gBAAAgB,EAACE,GAAA,EAAyB,OAAOjB,GAC/B,UAAA,gBAAAe,EAACG,GAAA,EAAsB,eAAe1B,EAAO,eAC3C,UAAA,gBAAAuB,EAACI,GAAA,EAAc,mBAAmBC,GAAe,SAASb,GACxD,UAAA,gBAAAQ,EAACM,GAAA,EAAc,OAAAxB,GAAc,iBAAAC,GAC3B,UAAA,gBAAAiB,EAACO,GAAA,EAAe,QAAA3B,GAAgB,UAAAC,GAC9B,UAAA,gBAAAmB,EAACQ,GAAA,EAAgB,MAAMlB,GACrB,UAAA,gBAAAU;AAAA,IAACS;AAAA,IAAA;AAAA,MACC,KAAKhC,EAAO;AAAA,MACZ,SAASA,EAAO;AAAA,MAChB,OAAOA,EAAO;AAAA,MACd,aAAAS;AAAA,MAEC,UAAAV;AAAA,IAAA;AAAA,EAAA,KAPmCG,CASxC,GACF,GACF,EAAA,CACF,EAAA,CACF,GACF,GACF;AAEJ;"}

package/dist/contexts/GustoProvider/index.d.ts

@@ -1,3 +1,3 @@
 export { GustoProvider } from './GustoProvider';
-export type { GustoApiProps } from './GustoProvider';
+export type { GustoProviderProps } from './GustoProvider';
 export { GustoProviderCustomUIAdapter } from './GustoProviderCustomUIAdapter';

package/dist/contexts/index.d.ts

@@ -1,10 +1,6 @@
 export { GustoProvider, GustoProviderCustomUIAdapter } from './GustoProvider';
-export type { GustoProviderProps, GustoProviderCustomUIAdapterProps, APIConfig, } from './GustoProvider/GustoProviderCustomUIAdapter';
-export type { GustoApiProps } from './GustoProvider';
-export { ApiProvider } from './ApiProvider/ApiProvider';
-export type { ApiProviderProps } from './ApiProvider/ApiProvider';
+export type { GustoBaseProviderProps, GustoProviderCustomUIAdapterProps, APIConfig, } from './GustoProvider/GustoProviderCustomUIAdapter';
+export type { GustoProviderProps } from './GustoProvider';
 export type { ComponentsContextType } from './ComponentAdapter/useComponentContext';
 export * from './ComponentAdapter/componentAdapterTypes';
-export { ObservabilityProvider, useObservability } from './ObservabilityProvider';
-export type { ObservabilityProviderProps, ObservabilityContextValue } from './ObservabilityProvider';
 export type { GustoSDKTheme, GustoSDKThemeColors } from './ThemeProvider/theme';

package/dist/i18n/en/Contractor.ContractorList.json.js

@@ -1,28 +1,30 @@
-const t = "Add a contractor", o = "+ Add another contractor", a = "A list of contractors", c = "Edit", n = "Delete", e = "Add contractors to get them setup for payroll.", r = "You haven't added any contractors yet", s = { name: "Name", status: "Status" }, d = "Contractors", i = "Continue", l = "Back to contractors", C = {
+const t = "Add a contractor", o = "+ Add another contractor", a = "A list of contractors", e = "Edit", c = "Review", n = "Delete", r = "Add contractors to get them setup for payroll.", s = "You haven't added any contractors yet", d = { name: "Name", status: "Status" }, i = "Contractors", l = "Continue", C = "Back to contractors", p = {
   addContractorCta: t,
   addAnotherCta: o,
   contractorListLabel: a,
-  editCta: c,
+  editCta: e,
+  reviewCta: c,
   deleteCta: n,
-  emptyTableDescription: e,
-  emptyTableTitle: r,
-  listHeaders: s,
-  title: d,
-  continueCta: i,
-  progressBarCta: l
+  emptyTableDescription: r,
+  emptyTableTitle: s,
+  listHeaders: d,
+  title: i,
+  continueCta: l,
+  progressBarCta: C
 };
 export {
   o as addAnotherCta,
   t as addContractorCta,
-  i as continueCta,
+  l as continueCta,
   a as contractorListLabel,
-  C as default,
+  p as default,
   n as deleteCta,
-  c as editCta,
-  e as emptyTableDescription,
-  r as emptyTableTitle,
-  s as listHeaders,
-  l as progressBarCta,
-  d as title
+  e as editCta,
+  r as emptyTableDescription,
+  s as emptyTableTitle,
+  d as listHeaders,
+  C as progressBarCta,
+  c as reviewCta,
+  i as title
 };
 //# sourceMappingURL=Contractor.ContractorList.json.js.map

package/dist/i18n/en/Contractor.ContractorList.json.js.map

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

package/dist/i18n/en/Contractor.SignatureForm.json.js

@@ -1,4 +1,4 @@
-const e = "Signature required", t = "See the IRS Form W-9 for instructions on completing this form", i = "<downloadLink>Download document</downloadLink>", o = { exemptions: "Exemptions", address: "Address", tin: "Taxpayer Identification Number (TIN)", certification: "Certification" }, n = { exemptions: "See section 4 of IRS Form W-9 for instructions.", address: "See sections 5-7 of IRS Form W-9 for instructions.", tin: "For individuals, this is generally your social security number (SSN). For other entities, this will be your employer identification number (EIN).", tinSecondary: "See Part 1 of the IRS Form W-9 for instructions.", certification: "See Part 2 of the IRS Form W-9 for instructions." }, r = "Under penalties of perjury, I certify that:", a = { taxpayerId: "The number shown on this form is my correct taxpayer identification number (or I am waiting for a number to be issued to me);", backupWithholding: "I am not subject to backup withholding because (a) I am exempt from backup withholding, or (b) I have not been notified by the Internal Revenue Service (IRS) that I am subject to backup withholding as a result of a failure to report all interest or dividends, or (c) the IRS has notified me that I am no longer subject to backup withholding;", usPerson: "I am a U.S. citizen or other U.S. person (defined below);", fatca: "The FATCA code(s) entered on this form (if any) indicating that I am exempt from FATCA reporting is correct." }, s = { name: { label: "Entity or individual name (1)", description: "Your individual or business name. For a sole proprietor or disregarded entity, enter the owner's name here, and enter the business/disregarded entity's name in the Business name field below." }, business_name: { label: "Business name (2)", description: "The name of your business, if different than above." }, taxClassification: { label: "Federal tax classification (3)", description: "Select the type of business you are." }, llcClassificationCode: { label: "LLC tax classification code", description: "Select the appropriate code for the LLC, unless it is a disregarded entity. A disregarded entity should instead check the appropriate selection for the tax classification of its owner." }, other_text: { label: "Other" }, foreign_partners: { label: "Foreign partners/owners/beneficiaries (3b)", description: "If you selected “Partnership”, “Trust/Estate” or checked “LLC” and entered “P” as the tax classification, and you are providing this form to a partnership, trust, or estate in which you have an ownership interest, check this box if you have any foreign partners, owners, or beneficiaries." }, exempt_payee_code: { label: "Exempt payee code" }, exemption_from_FATCA: { label: "Exemption from FATCA reporting code (4b)", description: "Enter the code (if any) indicating you are exempt from reporting under the Foreign Account Tax Compliance Act." }, home_address_street_1: { label: "Street 1" }, home_address_street_2: { label: "Street 2" }, home_address_city: { label: "City" }, home_address_state: { label: "State" }, home_address_zip: { label: "Zip code" }, account_number: { label: "Account numbers" }, company_name: { label: "Requester's name and address" }, ssn: { label: "Social Security Number (SSN)" }, ein: { label: "Employer Identification Number (EIN)" }, signature_text: { label: "Signature" } }, c = { taxClassification: { individual_proprietor: "Individual/sole proprietor", c_corporation: "C-Corporation", s_corporation: "S-Corporation", partnership: "Partnership", trust_estate: "Trust/estate", limited_liability_company: "LLC", other: "Other" }, llcClassificationCode: { placeholder: "Select...", c: "C = C-Corporation", s: "S = S-Corporation", p: "P = Partnership" } }, d = "I agree to electronically sign this form.", l = { required: "This field is required.", agreeRequired: "You must agree to electronically sign this form.", invalidSsn: "Enter a valid Social Security Number.", invalidEin: "Enter a valid Employer Identification Number." }, u = "Back", p = "Sign", m = "Signing…", h = "Acknowledge", f = "Acknowledging…", b = {
+const e = "Signature required", t = "See the IRS Form W-9 for instructions on completing this form", i = "<downloadLink>Download document</downloadLink>", o = { exemptions: "Exemptions", address: "Address", tin: "Taxpayer Identification Number (TIN)", certification: "Certification" }, n = { exemptions: "See section 4 of IRS Form W-9 for instructions.", address: "See sections 5-7 of IRS Form W-9 for instructions.", tin: "For individuals, this is generally your social security number (SSN). For other entities, this will be your employer identification number (EIN).", tinSecondary: "See Part 1 of the IRS Form W-9 for instructions.", certification: "See Part 2 of the IRS Form W-9 for instructions." }, r = "Under penalties of perjury, I certify that:", a = { taxpayerId: "The number shown on this form is my correct taxpayer identification number (or I am waiting for a number to be issued to me);", backupWithholding: "I am not subject to backup withholding because (a) I am exempt from backup withholding, or (b) I have not been notified by the Internal Revenue Service (IRS) that I am subject to backup withholding as a result of a failure to report all interest or dividends, or (c) the IRS has notified me that I am no longer subject to backup withholding;", usPerson: "I am a U.S. citizen or other U.S. person (defined below);", usPersonDefinition: "For federal tax purposes, you are considered a U.S. person if you are: an individual who is a U.S. citizen or U.S. resident alien; a partnership, corporation, company, or association created or organized in the United States or under the laws of the United States; an estate (other than a foreign estate); or a domestic trust (as defined in Regulations section 301.7701-7).", fatca: "The FATCA code(s) entered on this form (if any) indicating that I am exempt from FATCA reporting is correct." }, s = { name: { label: "Entity or individual name (1)", description: "Your individual or business name. For a sole proprietor or disregarded entity, enter the owner's name here, and enter the business/disregarded entity's name in the Business name field below." }, business_name: { label: "Business name (2)", description: "The name of your business, if different than above." }, taxClassification: { label: "Federal tax classification (3)", description: "Select the type of business you are." }, llcClassificationCode: { label: "LLC tax classification code", description: "Select the appropriate code for the LLC, unless it is a disregarded entity. A disregarded entity should instead check the appropriate selection for the tax classification of its owner." }, other_text: { label: "Other" }, foreign_partners: { label: "Foreign partners/owners/beneficiaries (3b)", description: "If you selected “Partnership”, “Trust/Estate” or checked “LLC” and entered “P” as the tax classification, and you are providing this form to a partnership, trust, or estate in which you have an ownership interest, check this box if you have any foreign partners, owners, or beneficiaries." }, exempt_payee_code: { label: "Exempt payee code" }, exemption_from_FATCA: { label: "Exemption from FATCA reporting code (4b)", description: "Enter the code (if any) indicating you are exempt from reporting under the Foreign Account Tax Compliance Act." }, home_address_street_1: { label: "Street 1" }, home_address_street_2: { label: "Street 2" }, home_address_city: { label: "City" }, home_address_state: { label: "State" }, home_address_zip: { label: "Zip code" }, account_number: { label: "Account numbers" }, company_name: { label: "Requester's name and address" }, ssn: { label: "Social Security Number (SSN)" }, ein: { label: "Employer Identification Number (EIN)" }, signature_text: { label: "Signature" } }, c = { taxClassification: { individual_proprietor: "Individual/sole proprietor", c_corporation: "C-Corporation", s_corporation: "S-Corporation", partnership: "Partnership", trust_estate: "Trust/estate", limited_liability_company: "LLC", other: "Other" }, llcClassificationCode: { placeholder: "Select...", c: "C = C-Corporation", s: "S = S-Corporation", p: "P = Partnership" } }, d = "I agree to electronically sign this form.", l = { required: "This field is required.", agreeRequired: "You must agree to electronically sign this form.", invalidSsn: "Enter a valid Social Security Number.", invalidEin: "Enter a valid Employer Identification Number." }, u = "Back", p = "Sign", h = "Signing…", m = "Acknowledge", f = "Acknowledging…", b = {
   signatureRequired: e,
   instructions: t,
   downloadPrompt: i,
@@ -12,12 +12,12 @@ const e = "Signature required", t = "See the IRS Form W-9 for instructions on co
   validation: l,
   backCta: u,
   signCta: p,
-  signingCta: m,
-  acknowledgeCta: h,
+  signingCta: h,
+  acknowledgeCta: m,
   acknowledgingCta: f
 };
 export {
-  h as acknowledgeCta,
+  m as acknowledgeCta,
   f as acknowledgingCta,
   d as agreeLabel,
   u as backCta,
@@ -32,7 +32,7 @@ export {
   o as sections,
   p as signCta,
   e as signatureRequired,
-  m as signingCta,
+  h as signingCta,
   l as validation
 };
 //# sourceMappingURL=Contractor.SignatureForm.json.js.map

package/dist/i18n/en/Employee.OnboardingSummary.json.js

@@ -1,30 +1,34 @@
-const e = "Missing Requirements", t = "Please complete the following steps in order to continue.", i = "That's it! {{name}} is ready to get paid!", o = "We'll begin withholding and reporting their taxes.", s = "You've completed setup!", n = "Your account will now be reviewed by your company admin.", r = "Done", d = "New Hire report", a = "Missing requirements", l = "Please complete the following steps in order to continue.", p = { personal_details: "Personal details", compensation_details: "Job and compensation", add_work_address: "Work address", add_home_address: "Home address", federal_tax_setup: "Federal tax details", state_tax_setup: "State tax details", direct_deposit_setup: "Payment method", employee_form_signing: "Employee form signing", file_new_hire_report: "File new hire report", admin_review: "Admin review" }, m = { personal_details: "Basic employee information and their home address.", compensation_details: " What the employee’s role(s) will be and their compensation.", add_work_address: "Work address", add_home_address: "Home address", federal_tax_setup: "Federal tax withholdings.", state_tax_setup: "State tax withholdings", direct_deposit_setup: "How the employee will be paid.", employee_form_signing: "Documents requiring employee signature", file_new_hire_report: "Indicate if new hire report needs to be filed", admin_review: "Admin review" }, _ = {
+const e = "Missing Requirements", t = "Please complete the following steps in order to continue.", i = "That's it! {{name}} is ready to get paid!", s = "We'll begin withholding and reporting their taxes.", o = "{{name}}'s invite is on its way", n = "They'll complete the remaining setup steps on their own.", d = "You've completed setup!", r = "Your account will now be reviewed by your company admin.", a = "Done", l = "New Hire report", p = "Missing requirements", m = "Please complete the following steps in order to continue.", c = { personal_details: "Personal details", compensation_details: "Job and compensation", add_work_address: "Work address", add_home_address: "Home address", federal_tax_setup: "Federal tax details", state_tax_setup: "State tax details", direct_deposit_setup: "Payment method", employee_form_signing: "Employee form signing", file_new_hire_report: "File new hire report", admin_review: "Admin review" }, _ = { personal_details: "Basic employee information and their home address.", compensation_details: " What the employee’s role(s) will be and their compensation.", add_work_address: "Work address", add_home_address: "Home address", federal_tax_setup: "Federal tax withholdings.", state_tax_setup: "State tax withholdings", direct_deposit_setup: "How the employee will be paid.", employee_form_signing: "Documents requiring employee signature", file_new_hire_report: "Indicate if new hire report needs to be filed", admin_review: "Admin review" }, h = {
   subTitle: e,
   description: t,
   onboardedAdminSubtitle: i,
-  onboardedAdminDescription: o,
-  onboardedSelfSubtitle: s,
-  onboardedSelfDescription: n,
-  doneCta: r,
-  newHireReportCta: d,
-  missingRequirementsSubtitle: a,
-  missingRequirementsDescription: l,
-  steps: p,
-  stepsDescriptions: m
+  onboardedAdminDescription: s,
+  handedOffAdminSubtitle: o,
+  handedOffAdminDescription: n,
+  onboardedSelfSubtitle: d,
+  onboardedSelfDescription: r,
+  doneCta: a,
+  newHireReportCta: l,
+  missingRequirementsSubtitle: p,
+  missingRequirementsDescription: m,
+  steps: c,
+  stepsDescriptions: _
 };
 export {
-  _ as default,
+  h as default,
   t as description,
-  r as doneCta,
-  l as missingRequirementsDescription,
-  a as missingRequirementsSubtitle,
-  d as newHireReportCta,
-  o as onboardedAdminDescription,
+  a as doneCta,
+  n as handedOffAdminDescription,
+  o as handedOffAdminSubtitle,
+  m as missingRequirementsDescription,
+  p as missingRequirementsSubtitle,
+  l as newHireReportCta,
+  s as onboardedAdminDescription,
   i as onboardedAdminSubtitle,
-  n as onboardedSelfDescription,
-  s as onboardedSelfSubtitle,
-  p as steps,
-  m as stepsDescriptions,
+  r as onboardedSelfDescription,
+  d as onboardedSelfSubtitle,
+  c as steps,
+  _ as stepsDescriptions,
   e as subTitle
 };
 //# sourceMappingURL=Employee.OnboardingSummary.json.js.map

package/dist/i18n/en/Employee.OnboardingSummary.json.js.map

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

package/dist/i18n/types.d.ts

@@ -1746,6 +1746,8 @@ export namespace Translations {
     contractorListLabel: string
     /** @defaultValue `"Edit"` */
     editCta: string
+    /** @defaultValue `"Review"` */
+    reviewCta: string
     /** @defaultValue `"Delete"` */
     deleteCta: string
     /** @defaultValue `"Add contractors to get them setup for payroll."` */
@@ -2491,6 +2493,8 @@ export namespace Translations {
       backupWithholding: string
       /** @defaultValue `"I am a U.S. citizen or other U.S. person (defined below);"` */
       usPerson: string
+      /** @defaultValue `"For federal tax purposes, you are considered a U.S. person if you are: an individual who is a U.S. citizen or U.S. resident alien; a partnership, corporation, company, or association created or organized in the United States or under the laws of the United States; an estate (other than a foreign estate); or a domestic trust (as defined in Regulations section 301.7701-7)."` */
+      usPersonDefinition: string
       /** @defaultValue `"The FATCA code(s) entered on this form (if any) indicating that I am exempt from FATCA reporting is correct."` */
       fatca: string
     }
@@ -4929,6 +4933,10 @@ export namespace Translations {
     onboardedAdminSubtitle: string
     /** @defaultValue `"We'll begin withholding and reporting their taxes."` */
     onboardedAdminDescription: string
+    /** @defaultValue `"{{name}}'s invite is on its way"` */
+    handedOffAdminSubtitle: string
+    /** @defaultValue `"They'll complete the remaining setup steps on their own."` */
+    handedOffAdminDescription: string
     /** @defaultValue `"You've completed setup!"` */
     onboardedSelfSubtitle: string
     /** @defaultValue `"Your account will now be reviewed by your company admin."` */

package/dist/index.d.ts

@@ -8,19 +8,20 @@ export * from './contexts';
  * @public
  */
 export type * as APIModels from './models/external';
+export type { WARiskClassCode } from './models/WA_RISK_CODES';
 export { componentEvents, EmployeeOnboardingStatus, EmployeeSelfOnboardingStatuses, ContractorOnboardingStatus, ContractorSelfOnboardingStatuses, PAY_PERIODS, I9_FORM_NAME, STATES_ABBR, } from './shared/constants';
 export type { EventType, StateAbbreviation } from './shared/constants';
 export type { BeforeCreateRequestHook, BeforeRequestHook, AfterSuccessHook, AfterErrorHook, BeforeCreateRequestContext, BeforeRequestContext, AfterSuccessContext, AfterErrorContext, SDKHooks, } from './types/hooks';
 export type { SDKError, SDKErrorCategory, SDKFieldError } from './types/sdkError';
-export { SDKErrorCategories, normalizeToSDKError, SDKInternalError } from './types/sdkError';
+export { SDKErrorCategories } from './types/sdkError';
 export type { ObservabilityHook, ObservabilityError, ObservabilityMetric, ObservabilityMetricUnit, SanitizationConfig, } from './types/observability';
 export type { BaseComponentInterface, CommonComponentInterface, OnEventType, } from './components/Base';
-export type { ResourceDictionary, GlobalResourceDictionary, Resources, Translations, DeepPartial, SupportedLanguages, } from './types/Helpers';
+export type { ResourceDictionary, GlobalResourceDictionary, Resources, Translations, DeepPartial, SupportedLanguages, DataAttributes, RequireAtLeastOne, } from './types/Helpers';
 export { composeErrorHandler, SDKFormProvider, composeSubmitHandler } from './partner-hook-utils';
-export type { MixedErrorSource, SubmitStateForErrorHandling, HookFormInternals, HookLoadingResult, HookSubmitResult, HookErrorHandling, BaseHookReady, BaseFormHookReady, FormHookResult, FieldMetadata, FieldMetadataWithOptions, FieldsMetadata, ValidationMessages, BaseFieldProps, HookFieldProps, TextInputHookFieldProps, SelectHookFieldProps, CheckboxHookFieldProps, NumberInputHookFieldProps, DatePickerHookFieldProps, RadioGroupHookFieldProps, SwitchHookFieldProps, SharedFieldLayoutProps, SharedHorizontalFieldLayoutProps, TextInputProps, SelectProps, SelectOption, CheckboxProps, NumberInputProps, DatePickerProps, RadioGroupProps, RadioGroupOption, SwitchProps, } from './partner-hook-utils';
+export type { MixedErrorSource, QueryWithRefetch, SubmitStateForErrorHandling, SDKFormProviderProps, ComposeSubmitInput, ComposeSubmitHandlerResult, ComposableFormHookResult, HookFormInternals, HookLoadingResult, HookSubmitResult, HookErrorHandling, BaseHookReady, BaseFormHookReady, FormHookResult, FieldMetadata, FieldMetadataWithOptions, FieldsMetadata, ValidationMessages, BaseFieldProps, HookFieldProps, InputProps, TextInputHookFieldProps, SelectHookFieldProps, CheckboxHookFieldProps, NumberInputHookFieldProps, DatePickerHookFieldProps, RadioGroupHookFieldProps, SwitchHookFieldProps, SharedFieldLayoutProps, SharedHorizontalFieldLayoutProps, TextInputProps, SelectProps, SelectOption, CheckboxProps, NumberInputProps, DatePickerProps, RadioGroupProps, RadioGroupOption, SwitchProps, } from './partner-hook-utils';
 export { useDeductionForm, DeductionFormErrorCodes, } from './components/Employee/Deductions/shared/useDeductionForm';
 export type { UseDeductionFormProps, UseDeductionFormResult, UseDeductionFormReady, DeductionFormFields, DeductionFormFieldsMetadata, DeductionFormErrorCode, DeductionFormOptionalFieldsToRequire, DeductionFormData, DeductionFormRequiredValidation, DeductionFormNegativeAmountValidation, DeductionFormAmountValidation, DeductionFormCapValidation, DescriptionFieldProps, RecurringFieldProps, DeductAsPercentageFieldProps, AmountFieldProps as DeductionAmountFieldProps, TotalAmountFieldProps, AnnualMaximumFieldProps, GarnishmentTypeFieldProps, } from './components/Employee/Deductions/shared/useDeductionForm';
-export { useChildSupportGarnishmentForm, ChildSupportGarnishmentFormErrorCodes, getRequiredAttrKeys, SUPPORTED_REQUIRED_ATTR_KEYS, } from './components/Employee/Deductions/shared/useChildSupportGarnishmentForm';
+export { useChildSupportGarnishmentForm, ChildSupportGarnishmentFormErrorCodes, SUPPORTED_REQUIRED_ATTR_KEYS, } from './components/Employee/Deductions/shared/useChildSupportGarnishmentForm';
 export type { UseChildSupportGarnishmentFormProps, UseChildSupportGarnishmentFormResult, UseChildSupportGarnishmentFormReady, ChildSupportGarnishmentFormFields, ChildSupportGarnishmentFormFieldsMetadata, ChildSupportGarnishmentFormErrorCode, ChildSupportGarnishmentFormData, SupportedRequiredAttrKey, ChildSupportGarnishmentRequiredValidation, ChildSupportGarnishmentNegativeAmountValidation, ChildSupportGarnishmentPercentValidation, PayPeriodMaximumValidation, ChildSupportGarnishmentAmountValidation, StateFieldEntry, CountyEntry, ChildSupportGarnishmentStateFieldProps, FipsCodeFieldProps, CaseNumberFieldProps, OrderNumberFieldProps, RemittanceNumberFieldProps, PayPeriodMaximumFieldProps, ChildSupportGarnishmentAmountFieldProps, PaymentPeriodFieldProps, } from './components/Employee/Deductions/shared/useChildSupportGarnishmentForm';
 export { useCompensationForm, CompensationErrorCodes, } from './components/Employee/Compensation/shared/useCompensationForm';
 export type { CompensationSubmitOptions, UseCompensationFormProps, UseCompensationFormResult, UseCompensationFormReady, CompensationFieldsMetadata, CompensationFormFields, CompensationErrorCode, CompensationOptionalFieldsToRequire, CompensationFormData, RequiredValidation as CompensationRequiredValidation, RateValidation, EffectiveDateValidation as CompensationEffectiveDateValidation, TitleFieldProps as CompensationTitleFieldProps, EffectiveDateFieldProps as CompensationEffectiveDateFieldProps, FlsaStatusFieldProps, RateFieldProps, PaymentUnitFieldProps, AdjustForMinimumWageFieldProps, MinimumWageIdFieldProps, } from './components/Employee/Compensation/shared/useCompensationForm';
@@ -47,10 +48,10 @@ export type { UsePaymentMethodFormProps, UsePaymentMethodFormResult, UsePaymentM
 export { useSplitPaymentsForm, SplitPaymentsFormErrorCodes, SPLIT_BY_VALUES, } from './components/Employee/PaymentMethod/shared/useSplitPaymentsForm';
 export type { UseSplitPaymentsFormProps, UseSplitPaymentsFormResult, UseSplitPaymentsFormReady, SplitPaymentsFormFields, SplitPaymentsFormFieldsMetadata, SplitPaymentsFormErrorCode, SplitPaymentsFormData, SplitPaymentsFormField, SplitPaymentsFormOptionalFieldsToRequire, SplitByValue, SplitPaymentsFormRequiredValidation, SplitByFieldProps, SplitFieldEntry, SplitFieldProps, SplitFieldValidation, WorkingSplit, } from './components/Employee/PaymentMethod/shared/useSplitPaymentsForm';
 export { useFederalTaxesForm, FederalTaxesErrorCodes, FILING_STATUS_VALUES, } from './components/Employee/FederalTaxes/shared/useFederalTaxesForm';
-export { useEmployeeStateTaxesForm, EmployeeStateTaxesErrorCodes, createStateFields, useStateFields, getQuestionVariant, } from './components/Employee/StateTaxes/shared';
-export type { UseEmployeeStateTaxesFormProps, UseEmployeeStateTaxesFormResult, UseEmployeeStateTaxesFormReady, EmployeeStateTaxesFieldsMetadata, EmployeeStateTaxesFormFields, EmployeeStateTaxesErrorCode, EmployeeStateTaxesFormData, EmployeeStateTaxesSchemaOptions, EmployeeStateTaxesQuestionMeta, EmployeeStateTaxesMetadataConfig, StateTaxValue, StateTaxQuestionVariant, StateTaxFieldsGroup, StateTaxFields, StateTaxQuestionFieldEntry, SharedQuestionMetadata, SelectStateTaxQuestion, RadioStateTaxQuestion, TextStateTaxQuestion, NumberStateTaxQuestion, CurrencyStateTaxQuestion, DateStateTaxQuestion, CreateStateFieldsOptions, BaseStateTaxFieldProps, StateTaxValidationMessages, SelectStateTaxFieldProps, RadioStateTaxFieldProps, TextStateTaxFieldProps, NumberStateTaxFieldProps, CurrencyStateTaxFieldProps, DateStateTaxFieldProps, } from './components/Employee/StateTaxes/shared';
+export { useEmployeeStateTaxesForm, EmployeeStateTaxesErrorCodes, useStateFields, } from './components/Employee/StateTaxes/shared';
+export type { UseEmployeeStateTaxesFormProps, UseEmployeeStateTaxesFormResult, UseEmployeeStateTaxesFormReady, EmployeeStateTaxesFieldsMetadata, EmployeeStateTaxesFormFields, EmployeeStateTaxesErrorCode, EmployeeStateTaxesFormData, StateTaxValue, StateTaxQuestionVariant, StateTaxFieldsGroup, StateTaxFields, StateTaxQuestionFieldEntry, SharedQuestionMetadata, SelectStateTaxQuestion, RadioStateTaxQuestion, TextStateTaxQuestion, NumberStateTaxQuestion, CurrencyStateTaxQuestion, DateStateTaxQuestion, BaseStateTaxFieldProps, StateTaxValidationMessages, SelectStateTaxFieldProps, RadioStateTaxFieldProps, TextStateTaxFieldProps, NumberStateTaxFieldProps, CurrencyStateTaxFieldProps, DateStateTaxFieldProps, } from './components/Employee/StateTaxes/shared';
 export type { FederalTaxesOptionalFieldsToRequire, UseFederalTaxesFormProps, UseFederalTaxesFormResult, UseFederalTaxesFormReady, FederalTaxesFieldsMetadata, FederalTaxesFormFields, FederalTaxesErrorCode, FederalTaxesFormData, FederalTaxesField, FilingStatusValue, FederalTaxesRequiredValidation, FilingStatusFieldProps, TwoJobsFieldProps, DependentsAmountFieldProps, OtherIncomeFieldProps, DeductionsFieldProps, ExtraWithholdingFieldProps, } from './components/Employee/FederalTaxes/shared/useFederalTaxesForm';
-export { useSignEmployeeForm, SignEmployeeFormErrorCodes, MAX_PREPARERS, PREPARER_FIELDS_BY_INDEX, preparerFieldName, } from './components/Employee/Documents/shared/useSignEmployeeForm';
+export { useSignEmployeeForm, SignEmployeeFormErrorCodes, MAX_PREPARERS, PREPARER_FIELDS_BY_INDEX, } from './components/Employee/Documents/shared/useSignEmployeeForm';
 export type { UseSignEmployeeFormProps, UseSignEmployeeFormResult, UseSignEmployeeFormReady, SignEmployeeFormFieldsMetadata, SignEmployeeBaseFieldsMetadata, SignEmployeeI9FieldsMetadata, SignEmployeeFormFields, PreparerFieldGroup, SignEmployeeFormErrorCode, SignEmployeeFormData, SignEmployeeFormField, PreparerIndex, PreparerFieldSuffix, SignEmployeeFormRequiredValidation, SignatureFieldProps as SignEmployeeFormSignatureFieldProps, ConfirmSignatureFieldProps as SignEmployeeFormConfirmSignatureFieldProps, UsedPreparerFieldProps, PreparerTextFieldProps, PreparerSelectFieldProps, PreparerCheckboxFieldProps, } from './components/Employee/Documents/shared/useSignEmployeeForm';
 export { useEmployeeList } from './components/Employee/EmployeeList/shared';
 export type { UseEmployeeListProps, UseEmployeeListResult, UseEmployeeListReady, EmployeeType, EmployeeAction, EmployeeWithActions, } from './components/Employee/EmployeeList/shared';