@gusto/embedded-react-sdk 0.46.3 → 0.47.0

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

@@ -7,7 +7,9 @@ export type { BoxHeaderProps } from '../../components/Common/UI/BoxHeader/BoxHea
 export type { CheckboxProps } from '../../components/Common/UI/Checkbox/CheckboxTypes';
 export type { CheckboxGroupProps, CheckboxGroupOption, } from '../../components/Common/UI/CheckboxGroup/CheckboxGroupTypes';
 export type { ComboBoxProps, ComboBoxOption } from '../../components/Common/UI/ComboBox/ComboBoxTypes';
+export type { MultiSelectComboBoxProps, MultiSelectComboBoxOption, } from '../../components/Common/UI/MultiSelectComboBox/MultiSelectComboBoxTypes';
 export type { DatePickerProps } from '../../components/Common/UI/DatePicker/DatePickerTypes';
+export type { DateRangePickerProps, DateRange, } from '../../components/Common/UI/DateRangePicker/DateRangePickerTypes';
 export type { LinkProps } from '../../components/Common/UI/Link/LinkTypes';
 export type { MenuProps, MenuItem } from '../../components/Common/UI/Menu/MenuTypes';
 export type { NumberInputProps } from '../../components/Common/UI/NumberInput/NumberInputTypes';

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

@@ -18,6 +18,7 @@ import { LoadingSpinnerProps } from '../../components/Common/UI/LoadingSpinner/L
 import { FileInputProps } from '../../components/Common/UI/FileInput/FileInputTypes';
 import { BoxHeaderProps } from '../../components/Common/UI/BoxHeader/BoxHeaderTypes';
 import { DescriptionListProps } from '../../components/Common/UI/DescriptionList/DescriptionListTypes';
+/** @internal */
 export declare const componentCreators: {
     readonly Alert: (customComponent: (props: AlertProps) => React.ReactElement | null) => {
         (props: AlertProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | null;
@@ -99,5 +100,7 @@ export declare const componentCreators: {
 /**
  * Creates components with automatic default prop handling.
  * Supports both partial (GustoProvider) and full (GustoProviderCustomUIAdapter) component sets.
+ *
+ * @internal
  */
 export declare function createComponents(providedComponents?: Partial<ComponentsContextType>): ComponentsContextType;

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

@@ -1 +1 @@
-{"version":3,"file":"createComponentsWithDefaults.js","sources":["../../../src/contexts/ComponentAdapter/createComponentsWithDefaults.ts"],"sourcesContent":["import type React from 'react'\nimport type { ComponentsContextType } from './useComponentContext'\nimport { defaultComponents } from './adapters/defaultComponentAdapter'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\n// Import prop types and their defaults\nimport type { AlertProps } from '@/components/Common/UI/Alert/AlertTypes'\nimport { AlertDefaults } from '@/components/Common/UI/Alert/AlertTypes'\nimport type { BadgeProps } from '@/components/Common/UI/Badge/BadgeTypes'\nimport { BadgeDefaults } from '@/components/Common/UI/Badge/BadgeTypes'\nimport type { BannerProps } from '@/components/Common/UI/Banner/BannerTypes'\nimport { BannerDefaults } from '@/components/Common/UI/Banner/BannerTypes'\nimport type { ButtonProps, ButtonIconProps } from '@/components/Common/UI/Button/ButtonTypes'\nimport { ButtonDefaults, ButtonIconDefaults } from '@/components/Common/UI/Button/ButtonTypes'\nimport type { CheckboxProps } from '@/components/Common/UI/Checkbox/CheckboxTypes'\nimport { CheckboxDefaults } from '@/components/Common/UI/Checkbox/CheckboxTypes'\nimport type { CheckboxGroupProps } from '@/components/Common/UI/CheckboxGroup/CheckboxGroupTypes'\nimport { CheckboxGroupDefaults } from '@/components/Common/UI/CheckboxGroup/CheckboxGroupTypes'\nimport type { MenuProps } from '@/components/Common/UI/Menu/MenuTypes'\nimport { MenuDefaults } from '@/components/Common/UI/Menu/MenuTypes'\nimport type { RadioProps } from '@/components/Common/UI/Radio/RadioTypes'\nimport { RadioDefaults } from '@/components/Common/UI/Radio/RadioTypes'\nimport type { RadioGroupProps } from '@/components/Common/UI/RadioGroup/RadioGroupTypes'\nimport { RadioGroupDefaults } from '@/components/Common/UI/RadioGroup/RadioGroupTypes'\nimport type { SwitchProps } from '@/components/Common/UI/Switch/SwitchTypes'\nimport { SwitchDefaults } from '@/components/Common/UI/Switch/SwitchTypes'\nimport type { TableProps } from '@/components/Common/UI/Table/TableTypes'\nimport { TableDefaults } from '@/components/Common/UI/Table/TableTypes'\nimport type { TextProps } from '@/components/Common/UI/Text/TextTypes'\nimport { TextDefaults } from '@/components/Common/UI/Text/TextTypes'\nimport type { TextInputProps } from '@/components/Common/UI/TextInput/TextInputTypes'\nimport { TextInputDefaults } from '@/components/Common/UI/TextInput/TextInputTypes'\nimport type { DialogProps } from '@/components/Common/UI/Dialog/DialogTypes'\nimport { DialogDefaults } from '@/components/Common/UI/Dialog/DialogTypes'\nimport type { LoadingSpinnerProps } from '@/components/Common/UI/LoadingSpinner/LoadingSpinnerTypes'\nimport { LoadingSpinnerDefaults } from '@/components/Common/UI/LoadingSpinner/LoadingSpinnerTypes'\nimport type { FileInputProps } from '@/components/Common/UI/FileInput/FileInputTypes'\nimport { FileInputDefaults } from '@/components/Common/UI/FileInput/FileInputTypes'\nimport type { BoxHeaderProps } from '@/components/Common/UI/BoxHeader/BoxHeaderTypes'\nimport { BoxHeaderDefaults } from '@/components/Common/UI/BoxHeader/BoxHeaderTypes'\nimport type { DescriptionListProps } from '@/components/Common/UI/DescriptionList/DescriptionListTypes'\nimport { DescriptionListDefaults } from '@/components/Common/UI/DescriptionList/DescriptionListTypes'\n\nfunction composeWithDefaults<TProps>(defaults: Partial<TProps>, componentName: string) {\n  return (customComponent: (props: TProps) => React.ReactElement | null) => {\n    const wrappedComponent = (props: TProps) => {\n      const propsWithDefaults = applyMissingDefaults(props, defaults)\n      return customComponent(propsWithDefaults)\n    }\n    wrappedComponent.displayName = `withAutoDefault(${componentName})`\n    return wrappedComponent\n  }\n}\n\n// Component creators with defaults\nexport const componentCreators = {\n  Alert: composeWithDefaults<AlertProps>(AlertDefaults, 'Alert'),\n  Badge: composeWithDefaults<BadgeProps>(BadgeDefaults, 'Badge'),\n  Banner: composeWithDefaults<BannerProps>(BannerDefaults, 'Banner'),\n  Button: composeWithDefaults<ButtonProps>(ButtonDefaults, 'Button'),\n  ButtonIcon: composeWithDefaults<ButtonIconProps>(ButtonIconDefaults, 'ButtonIcon'),\n  Checkbox: composeWithDefaults<CheckboxProps>(CheckboxDefaults, 'Checkbox'),\n  CheckboxGroup: composeWithDefaults<CheckboxGroupProps>(CheckboxGroupDefaults, 'CheckboxGroup'),\n  Menu: composeWithDefaults<MenuProps>(MenuDefaults, 'Menu'),\n  Radio: composeWithDefaults<RadioProps>(RadioDefaults, 'Radio'),\n  RadioGroup: composeWithDefaults<RadioGroupProps>(RadioGroupDefaults, 'RadioGroup'),\n  Switch: composeWithDefaults<SwitchProps>(SwitchDefaults, 'Switch'),\n  Table: composeWithDefaults<TableProps>(TableDefaults, 'Table'),\n  Text: composeWithDefaults<TextProps>(TextDefaults, 'Text'),\n  TextInput: composeWithDefaults<TextInputProps>(TextInputDefaults, 'TextInput'),\n  Dialog: composeWithDefaults<DialogProps>(DialogDefaults, 'Dialog'),\n  LoadingSpinner: composeWithDefaults<LoadingSpinnerProps>(\n    LoadingSpinnerDefaults,\n    'LoadingSpinner',\n  ),\n  FileInput: composeWithDefaults<FileInputProps>(FileInputDefaults, 'FileInput'),\n  BoxHeader: composeWithDefaults<BoxHeaderProps>(BoxHeaderDefaults, 'BoxHeader'),\n  DescriptionList: composeWithDefaults<DescriptionListProps>(\n    DescriptionListDefaults,\n    'DescriptionList',\n  ),\n} as const\n\n/**\n * Creates components with automatic default prop handling.\n * Supports both partial (GustoProvider) and full (GustoProviderCustomUIAdapter) component sets.\n */\nexport function createComponents(\n  providedComponents: Partial<ComponentsContextType> = {},\n): ComponentsContextType {\n  const components = { ...defaultComponents }\n\n  for (const [componentName, providedComponent] of Object.entries(providedComponents)) {\n    const typedComponentName = componentName as keyof ComponentsContextType\n\n    if (componentName in componentCreators) {\n      const creatorKey = componentName as keyof typeof componentCreators\n      const creator = componentCreators[creatorKey]\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      components[typedComponentName] = creator(providedComponent as any) as any\n    } else {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      components[typedComponentName] = providedComponent as any\n    }\n  }\n\n  return components\n}\n"],"names":["composeWithDefaults","defaults","componentName","customComponent","wrappedComponent","props","propsWithDefaults","applyMissingDefaults","componentCreators","AlertDefaults","BadgeDefaults","BannerDefaults","ButtonDefaults","ButtonIconDefaults","CheckboxDefaults","CheckboxGroupDefaults","MenuDefaults","RadioDefaults","RadioGroupDefaults","SwitchDefaults","TableDefaults","TextDefaults","TextInputDefaults","DialogDefaults","LoadingSpinnerDefaults","FileInputDefaults","BoxHeaderDefaults","DescriptionListDefaults","createComponents","providedComponents","components","defaultComponents","providedComponent","typedComponentName","creator"],"mappings":";;;;;;;;;;;;;;;;;;;;AA0CA,SAASA,EAA4BC,GAA2BC,GAAuB;AACrF,SAAO,CAACC,MAAkE;AACxE,UAAMC,IAAmB,CAACC,MAAkB;AAC1C,YAAMC,IAAoBC,EAAqBF,GAAOJ,CAAQ;AAC9D,aAAOE,EAAgBG,CAAiB;AAAA,IAC1C;AACA,WAAAF,EAAiB,cAAc,mBAAmBF,CAAa,KACxDE;AAAA,EACT;AACF;AAGO,MAAMI,IAAoB;AAAA,EAC/B,OAAOR,EAAgCS,GAAe,OAAO;AAAA,EAC7D,OAAOT,EAAgCU,GAAe,OAAO;AAAA,EAC7D,QAAQV,EAAiCW,GAAgB,QAAQ;AAAA,EACjE,QAAQX,EAAiCY,GAAgB,QAAQ;AAAA,EACjE,YAAYZ,EAAqCa,GAAoB,YAAY;AAAA,EACjF,UAAUb,EAAmCc,GAAkB,UAAU;AAAA,EACzE,eAAed,EAAwCe,GAAuB,eAAe;AAAA,EAC7F,MAAMf,EAA+BgB,GAAc,MAAM;AAAA,EACzD,OAAOhB,EAAgCiB,GAAe,OAAO;AAAA,EAC7D,YAAYjB,EAAqCkB,GAAoB,YAAY;AAAA,EACjF,QAAQlB,EAAiCmB,GAAgB,QAAQ;AAAA,EACjE,OAAOnB,EAAgCoB,GAAe,OAAO;AAAA,EAC7D,MAAMpB,EAA+BqB,GAAc,MAAM;AAAA,EACzD,WAAWrB,EAAoCsB,GAAmB,WAAW;AAAA,EAC7E,QAAQtB,EAAiCuB,GAAgB,QAAQ;AAAA,EACjE,gBAAgBvB;AAAA,IACdwB;AAAA,IACA;AAAA,EAAA;AAAA,EAEF,WAAWxB,EAAoCyB,GAAmB,WAAW;AAAA,EAC7E,WAAWzB,EAAoC0B,GAAmB,WAAW;AAAA,EAC7E,iBAAiB1B;AAAA,IACf2B;AAAA,IACA;AAAA,EAAA;AAEJ;AAMO,SAASC,EACdC,IAAqD,IAC9B;AACvB,QAAMC,IAAa,EAAE,GAAGC,EAAA;AAExB,aAAW,CAAC7B,GAAe8B,CAAiB,KAAK,OAAO,QAAQH,CAAkB,GAAG;AACnF,UAAMI,IAAqB/B;AAE3B,QAAIA,KAAiBM,GAAmB;AAEtC,YAAM0B,IAAU1B,EADGN,CACyB;AAE5C,MAAA4B,EAAWG,CAAkB,IAAIC,EAAQF,CAAwB;AAAA,IACnE;AAEE,MAAAF,EAAWG,CAAkB,IAAID;AAAA,EAErC;AAEA,SAAOF;AACT;"}
+{"version":3,"file":"createComponentsWithDefaults.js","sources":["../../../src/contexts/ComponentAdapter/createComponentsWithDefaults.ts"],"sourcesContent":["import type React from 'react'\nimport type { ComponentsContextType } from './useComponentContext'\nimport { defaultComponents } from './adapters/defaultComponentAdapter'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\n// Import prop types and their defaults\nimport type { AlertProps } from '@/components/Common/UI/Alert/AlertTypes'\nimport { AlertDefaults } from '@/components/Common/UI/Alert/AlertTypes'\nimport type { BadgeProps } from '@/components/Common/UI/Badge/BadgeTypes'\nimport { BadgeDefaults } from '@/components/Common/UI/Badge/BadgeTypes'\nimport type { BannerProps } from '@/components/Common/UI/Banner/BannerTypes'\nimport { BannerDefaults } from '@/components/Common/UI/Banner/BannerTypes'\nimport type { ButtonProps, ButtonIconProps } from '@/components/Common/UI/Button/ButtonTypes'\nimport { ButtonDefaults, ButtonIconDefaults } from '@/components/Common/UI/Button/ButtonTypes'\nimport type { CheckboxProps } from '@/components/Common/UI/Checkbox/CheckboxTypes'\nimport { CheckboxDefaults } from '@/components/Common/UI/Checkbox/CheckboxTypes'\nimport type { CheckboxGroupProps } from '@/components/Common/UI/CheckboxGroup/CheckboxGroupTypes'\nimport { CheckboxGroupDefaults } from '@/components/Common/UI/CheckboxGroup/CheckboxGroupTypes'\nimport type { MenuProps } from '@/components/Common/UI/Menu/MenuTypes'\nimport { MenuDefaults } from '@/components/Common/UI/Menu/MenuTypes'\nimport type { RadioProps } from '@/components/Common/UI/Radio/RadioTypes'\nimport { RadioDefaults } from '@/components/Common/UI/Radio/RadioTypes'\nimport type { RadioGroupProps } from '@/components/Common/UI/RadioGroup/RadioGroupTypes'\nimport { RadioGroupDefaults } from '@/components/Common/UI/RadioGroup/RadioGroupTypes'\nimport type { SwitchProps } from '@/components/Common/UI/Switch/SwitchTypes'\nimport { SwitchDefaults } from '@/components/Common/UI/Switch/SwitchTypes'\nimport type { TableProps } from '@/components/Common/UI/Table/TableTypes'\nimport { TableDefaults } from '@/components/Common/UI/Table/TableTypes'\nimport type { TextProps } from '@/components/Common/UI/Text/TextTypes'\nimport { TextDefaults } from '@/components/Common/UI/Text/TextTypes'\nimport type { TextInputProps } from '@/components/Common/UI/TextInput/TextInputTypes'\nimport { TextInputDefaults } from '@/components/Common/UI/TextInput/TextInputTypes'\nimport type { DialogProps } from '@/components/Common/UI/Dialog/DialogTypes'\nimport { DialogDefaults } from '@/components/Common/UI/Dialog/DialogTypes'\nimport type { LoadingSpinnerProps } from '@/components/Common/UI/LoadingSpinner/LoadingSpinnerTypes'\nimport { LoadingSpinnerDefaults } from '@/components/Common/UI/LoadingSpinner/LoadingSpinnerTypes'\nimport type { FileInputProps } from '@/components/Common/UI/FileInput/FileInputTypes'\nimport { FileInputDefaults } from '@/components/Common/UI/FileInput/FileInputTypes'\nimport type { BoxHeaderProps } from '@/components/Common/UI/BoxHeader/BoxHeaderTypes'\nimport { BoxHeaderDefaults } from '@/components/Common/UI/BoxHeader/BoxHeaderTypes'\nimport type { DescriptionListProps } from '@/components/Common/UI/DescriptionList/DescriptionListTypes'\nimport { DescriptionListDefaults } from '@/components/Common/UI/DescriptionList/DescriptionListTypes'\n\n/** @internal */\nfunction composeWithDefaults<TProps>(defaults: Partial<TProps>, componentName: string) {\n  return (customComponent: (props: TProps) => React.ReactElement | null) => {\n    const wrappedComponent = (props: TProps) => {\n      const propsWithDefaults = applyMissingDefaults(props, defaults)\n      return customComponent(propsWithDefaults)\n    }\n    wrappedComponent.displayName = `withAutoDefault(${componentName})`\n    return wrappedComponent\n  }\n}\n\n/** @internal */\nexport const componentCreators = {\n  Alert: composeWithDefaults<AlertProps>(AlertDefaults, 'Alert'),\n  Badge: composeWithDefaults<BadgeProps>(BadgeDefaults, 'Badge'),\n  Banner: composeWithDefaults<BannerProps>(BannerDefaults, 'Banner'),\n  Button: composeWithDefaults<ButtonProps>(ButtonDefaults, 'Button'),\n  ButtonIcon: composeWithDefaults<ButtonIconProps>(ButtonIconDefaults, 'ButtonIcon'),\n  Checkbox: composeWithDefaults<CheckboxProps>(CheckboxDefaults, 'Checkbox'),\n  CheckboxGroup: composeWithDefaults<CheckboxGroupProps>(CheckboxGroupDefaults, 'CheckboxGroup'),\n  Menu: composeWithDefaults<MenuProps>(MenuDefaults, 'Menu'),\n  Radio: composeWithDefaults<RadioProps>(RadioDefaults, 'Radio'),\n  RadioGroup: composeWithDefaults<RadioGroupProps>(RadioGroupDefaults, 'RadioGroup'),\n  Switch: composeWithDefaults<SwitchProps>(SwitchDefaults, 'Switch'),\n  Table: composeWithDefaults<TableProps>(TableDefaults, 'Table'),\n  Text: composeWithDefaults<TextProps>(TextDefaults, 'Text'),\n  TextInput: composeWithDefaults<TextInputProps>(TextInputDefaults, 'TextInput'),\n  Dialog: composeWithDefaults<DialogProps>(DialogDefaults, 'Dialog'),\n  LoadingSpinner: composeWithDefaults<LoadingSpinnerProps>(\n    LoadingSpinnerDefaults,\n    'LoadingSpinner',\n  ),\n  FileInput: composeWithDefaults<FileInputProps>(FileInputDefaults, 'FileInput'),\n  BoxHeader: composeWithDefaults<BoxHeaderProps>(BoxHeaderDefaults, 'BoxHeader'),\n  DescriptionList: composeWithDefaults<DescriptionListProps>(\n    DescriptionListDefaults,\n    'DescriptionList',\n  ),\n} as const\n\n/**\n * Creates components with automatic default prop handling.\n * Supports both partial (GustoProvider) and full (GustoProviderCustomUIAdapter) component sets.\n *\n * @internal\n */\nexport function createComponents(\n  providedComponents: Partial<ComponentsContextType> = {},\n): ComponentsContextType {\n  const components = { ...defaultComponents }\n\n  for (const [componentName, providedComponent] of Object.entries(providedComponents)) {\n    const typedComponentName = componentName as keyof ComponentsContextType\n\n    if (componentName in componentCreators) {\n      const creatorKey = componentName as keyof typeof componentCreators\n      const creator = componentCreators[creatorKey]\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      components[typedComponentName] = creator(providedComponent as any) as any\n    } else {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      components[typedComponentName] = providedComponent as any\n    }\n  }\n\n  return components\n}\n"],"names":["composeWithDefaults","defaults","componentName","customComponent","wrappedComponent","props","propsWithDefaults","applyMissingDefaults","componentCreators","AlertDefaults","BadgeDefaults","BannerDefaults","ButtonDefaults","ButtonIconDefaults","CheckboxDefaults","CheckboxGroupDefaults","MenuDefaults","RadioDefaults","RadioGroupDefaults","SwitchDefaults","TableDefaults","TextDefaults","TextInputDefaults","DialogDefaults","LoadingSpinnerDefaults","FileInputDefaults","BoxHeaderDefaults","DescriptionListDefaults","createComponents","providedComponents","components","defaultComponents","providedComponent","typedComponentName","creator"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2CA,SAASA,EAA4BC,GAA2BC,GAAuB;AACrF,SAAO,CAACC,MAAkE;AACxE,UAAMC,IAAmB,CAACC,MAAkB;AAC1C,YAAMC,IAAoBC,EAAqBF,GAAOJ,CAAQ;AAC9D,aAAOE,EAAgBG,CAAiB;AAAA,IAC1C;AACA,WAAAF,EAAiB,cAAc,mBAAmBF,CAAa,KACxDE;AAAA,EACT;AACF;AAGO,MAAMI,IAAoB;AAAA,EAC/B,OAAOR,EAAgCS,GAAe,OAAO;AAAA,EAC7D,OAAOT,EAAgCU,GAAe,OAAO;AAAA,EAC7D,QAAQV,EAAiCW,GAAgB,QAAQ;AAAA,EACjE,QAAQX,EAAiCY,GAAgB,QAAQ;AAAA,EACjE,YAAYZ,EAAqCa,GAAoB,YAAY;AAAA,EACjF,UAAUb,EAAmCc,GAAkB,UAAU;AAAA,EACzE,eAAed,EAAwCe,GAAuB,eAAe;AAAA,EAC7F,MAAMf,EAA+BgB,GAAc,MAAM;AAAA,EACzD,OAAOhB,EAAgCiB,GAAe,OAAO;AAAA,EAC7D,YAAYjB,EAAqCkB,GAAoB,YAAY;AAAA,EACjF,QAAQlB,EAAiCmB,GAAgB,QAAQ;AAAA,EACjE,OAAOnB,EAAgCoB,GAAe,OAAO;AAAA,EAC7D,MAAMpB,EAA+BqB,GAAc,MAAM;AAAA,EACzD,WAAWrB,EAAoCsB,GAAmB,WAAW;AAAA,EAC7E,QAAQtB,EAAiCuB,GAAgB,QAAQ;AAAA,EACjE,gBAAgBvB;AAAA,IACdwB;AAAA,IACA;AAAA,EAAA;AAAA,EAEF,WAAWxB,EAAoCyB,GAAmB,WAAW;AAAA,EAC7E,WAAWzB,EAAoC0B,GAAmB,WAAW;AAAA,EAC7E,iBAAiB1B;AAAA,IACf2B;AAAA,IACA;AAAA,EAAA;AAEJ;AAQO,SAASC,EACdC,IAAqD,IAC9B;AACvB,QAAMC,IAAa,EAAE,GAAGC,EAAA;AAExB,aAAW,CAAC7B,GAAe8B,CAAiB,KAAK,OAAO,QAAQH,CAAkB,GAAG;AACnF,UAAMI,IAAqB/B;AAE3B,QAAIA,KAAiBM,GAAmB;AAEtC,YAAM0B,IAAU1B,EADGN,CACyB;AAE5C,MAAA4B,EAAWG,CAAkB,IAAIC,EAAQF,CAAwB;AAAA,IACnE;AAEE,MAAAF,EAAWG,CAAkB,IAAID;AAAA,EAErC;AAEA,SAAOF;AACT;"}

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

@@ -36,46 +36,142 @@ import { FileInputProps } from '../../components/Common/UI/FileInput/FileInputTy
 import { BoxHeaderProps } from '../../components/Common/UI/BoxHeader/BoxHeaderTypes';
 import { MultiSelectComboBoxProps } from '../../components/Common/UI/MultiSelectComboBox/MultiSelectComboBoxTypes';
 import { PayrollLoadingProps } from '../../components/Common/PayrollLoading/PayrollLoadingTypes';
+/**
+ * Full map of UI components used by the SDK. Every property is a React component that the
+ * SDK renders internally — override any of them to substitute your own design system.
+ *
+ * Pass a `Partial<ComponentsContextType>` to `GustoProvider` via the `components` prop to
+ * replace specific components while keeping SDK defaults for the rest.
+ *
+ * To take full control of every UI component (and eliminate the React Aria dependency),
+ * pass a complete `ComponentsContextType` to `GustoProviderCustomUIAdapter` instead.
+ * All properties are then required except `PaginationControl` and `PayrollLoading`,
+ * which fall back to built-in SDK implementations when omitted.
+ *
+ * @public
+ *
+ * @example Partial override with GustoProvider
+ * ```tsx
+ * import { GustoProvider } from '@gusto/embedded-react-sdk'
+ *
+ * function App() {
+ *   return (
+ *     <GustoProvider
+ *       config={{ baseUrl: '/api/gusto/' }}
+ *       components={{
+ *         Button: MyButton,
+ *         TextInput: MyTextInput,
+ *       }}
+ *     >
+ *       <EmployeeOnboardingFlow companyId="company_123" />
+ *     </GustoProvider>
+ *   )
+ * }
+ * ```
+ *
+ * @example Full replacement with GustoProviderCustomUIAdapter
+ * ```tsx
+ * import { GustoProviderCustomUIAdapter, type ComponentsContextType } from '@gusto/embedded-react-sdk'
+ *
+ * const myComponents: ComponentsContextType = {
+ *   Alert: props => <MyAlert {...props} />,
+ *   Button: props => <MyButton {...props} />,
+ *   // ... all required components
+ * }
+ *
+ * function App() {
+ *   return (
+ *     <GustoProviderCustomUIAdapter
+ *       config={{ baseUrl: '/api/gusto/' }}
+ *       components={myComponents}
+ *     >
+ *       <EmployeeOnboardingFlow companyId="company_123" />
+ *     </GustoProviderCustomUIAdapter>
+ *   )
+ * }
+ * ```
+ */
 export interface ComponentsContextType {
+    /** Status message with an optional dismiss action; used for errors, warnings, success, and info. */
     Alert: (props: AlertProps) => JSX.Element | null;
+    /** Small inline label for status, counts, or tags; optionally dismissible. */
     Badge: (props: BadgeProps) => JSX.Element | null;
+    /** Full-width notification banner for prominent warnings and errors. */
     Banner: (props: BannerProps) => JSX.Element | null;
+    /** HTML `<button>` with primary, secondary, tertiary, and error variants. */
     Button: (props: ButtonProps) => JSX.Element | null;
+    /** Icon-only `<button>`; requires `aria-label` since there is no visible text for assistive technologies. */
     ButtonIcon: (props: ButtonIconProps) => JSX.Element | null;
-    Card: (props: CardProps) => JSX.Element | null;
+    /** Sectioned layout container with distinct header, body, and footer areas. */
     Box: (props: BoxProps) => JSX.Element | null;
+    /** Header section of a Box with a title, optional description, and optional inline action. */
     BoxHeader: (props: BoxHeaderProps) => JSX.Element | null;
+    /** Read-only calendar for visualizing a date range with optional highlighted dates. */
+    CalendarPreview: (props: CalendarPreviewProps) => JSX.Element | null;
+    /** Content container with an optional overflow menu and a leading action slot. */
+    Card: (props: CardProps) => JSX.Element | null;
+    /** Form field wrapping a single `<input type="checkbox" />`. */
     Checkbox: (props: CheckboxProps) => JSX.Element | null;
+    /** Form field grouping `<input type="checkbox" />` elements for multi-option selection. */
     CheckboxGroup: (props: CheckboxGroupProps) => JSX.Element | null;
+    /** Form field wrapping a typeahead `<input />` for single-option selection. */
     ComboBox: (props: ComboBoxProps) => JSX.Element | null;
-    MultiSelectComboBox: (props: MultiSelectComboBoxProps) => JSX.Element | null;
+    /** Form field wrapping an `<input type="date" />` with a calendar picker popover. */
     DatePicker: (props: DatePickerProps) => JSX.Element | null;
+    /** Form field wrapping paired `<input type="date" />` elements for a date range. */
     DateRangePicker: (props: DateRangePickerProps) => JSX.Element | null;
-    OrderedList: (props: OrderedListProps) => JSX.Element | null;
-    UnorderedList: (props: UnorderedListProps) => JSX.Element | null;
+    /** HTML `<dl>` of term/description pairs in stacked or horizontal layout. */
+    DescriptionList: (props: DescriptionListProps) => JSX.Element | null;
+    /** Modal confirmation dialog with a primary action and a cancel action. */
+    Dialog: (props: DialogProps) => JSX.Element | null;
+    /** Form field wrapping an `<input type="file" />`. */
+    FileInput: (props: FileInputProps) => JSX.Element | null;
+    /** HTML `<h1>`–`<h6>` with visual style controlled independently from semantic level. */
+    Heading: (props: HeadingProps) => JSX.Element | null;
+    /** HTML `<a>` for inline navigation. */
+    Link: (props: LinkProps) => JSX.Element | null;
+    /** Spinner shown while data or an action is pending. */
+    LoadingSpinner: (props: LoadingSpinnerProps) => JSX.Element | null;
+    /** Popover menu of actions anchored to a trigger element. */
+    Menu: (props: MenuProps) => JSX.Element | null;
+    /** Overlay modal with customizable body content and footer. */
+    Modal: (props: ModalProps) => JSX.Element | null;
+    /** Form field wrapping a typeahead `<input />` for multi-option selection. */
+    MultiSelectComboBox: (props: MultiSelectComboBoxProps) => JSX.Element | null;
+    /** Form field wrapping a numeric `<input />` for currency, decimal, or percent values. */
     NumberInput: (props: NumberInputProps) => JSX.Element | null;
+    /** HTML `<ol>` for a numbered list of items. */
+    OrderedList: (props: OrderedListProps) => JSX.Element | null;
+    /** Step-based progress indicator for multi-step flows. */
+    ProgressBar: (props: ProgressBarProps) => JSX.Element | null;
+    /** Navigation breadcrumb trail showing the user's position in a multi-step flow. */
+    Breadcrumbs: (props: BreadcrumbsProps) => JSX.Element | null;
+    /** Form field wrapping a single `<input type="radio" />`. */
     Radio: (props: RadioProps) => JSX.Element | null;
+    /** Form field grouping `<input type="radio" />` elements for single-option selection. */
     RadioGroup: (props: RadioGroupProps) => JSX.Element | null;
+    /** Form field wrapping a single-select dropdown. */
     Select: (props: SelectProps) => JSX.Element | null;
+    /** Form field wrapping an `<input type="checkbox" />` styled as a toggle. */
     Switch: (props: SwitchProps) => JSX.Element | null;
+    /** Tabbed navigation with associated content panels. */
+    Tabs: (props: TabsProps) => JSX.Element | null;
+    /** Tabular data display with headers, rows, optional footer, and empty state. */
+    Table: (props: TableProps) => JSX.Element | null;
+    /** Body text element rendered as `<p>`, `<span>`, `<div>`, or `<pre>`. */
+    Text: (props: TextProps) => JSX.Element | null;
+    /** Form field wrapping an `<input />`. */
     TextInput: (props: TextInputProps) => JSX.Element | null;
+    /** Form field wrapping a `<textarea>`. */
     TextArea: (props: TextAreaProps) => JSX.Element | null;
-    Link: (props: LinkProps) => JSX.Element | null;
-    Menu: (props: MenuProps) => JSX.Element | null;
-    Table: (props: TableProps) => JSX.Element | null;
-    Heading: (props: HeadingProps) => JSX.Element | null;
+    /** HTML `<ul>` for an unordered list of items. */
+    UnorderedList: (props: UnorderedListProps) => JSX.Element | null;
+    /** Pagination controls for list views. Defaults to the SDK's built-in pagination UI when omitted. */
     PaginationControl?: (props: PaginationControlProps) => JSX.Element | null;
+    /** Loading indicator for payroll calculation. Defaults to the SDK's built-in loading state when omitted. */
     PayrollLoading?: (props: PayrollLoadingProps) => JSX.Element | null;
-    Text: (props: TextProps) => JSX.Element | null;
-    CalendarPreview: (props: CalendarPreviewProps) => JSX.Element | null;
-    ProgressBar: (props: ProgressBarProps) => JSX.Element | null;
-    Breadcrumbs: (props: BreadcrumbsProps) => JSX.Element | null;
-    Tabs: (props: TabsProps) => JSX.Element | null;
-    Dialog: (props: DialogProps) => JSX.Element | null;
-    Modal: (props: ModalProps) => JSX.Element | null;
-    LoadingSpinner: (props: LoadingSpinnerProps) => JSX.Element | null;
-    DescriptionList: (props: DescriptionListProps) => JSX.Element | null;
-    FileInput: (props: FileInputProps) => JSX.Element | null;
 }
+/** @internal */
 export declare const ComponentsContext: import('react').Context<ComponentsContextType | null>;
+/** @internal */
 export declare const useComponentContext: () => ComponentsContextType;

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 { JSX } 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\nexport interface ComponentsContextType {\n  Alert: (props: AlertProps) => JSX.Element | null\n  Badge: (props: BadgeProps) => JSX.Element | null\n  Banner: (props: BannerProps) => JSX.Element | null\n  Button: (props: ButtonProps) => JSX.Element | null\n  ButtonIcon: (props: ButtonIconProps) => JSX.Element | null\n  Card: (props: CardProps) => JSX.Element | null\n  Box: (props: BoxProps) => JSX.Element | null\n  BoxHeader: (props: BoxHeaderProps) => JSX.Element | null\n  Checkbox: (props: CheckboxProps) => JSX.Element | null\n  CheckboxGroup: (props: CheckboxGroupProps) => JSX.Element | null\n  ComboBox: (props: ComboBoxProps) => JSX.Element | null\n  MultiSelectComboBox: (props: MultiSelectComboBoxProps) => JSX.Element | null\n  DatePicker: (props: DatePickerProps) => JSX.Element | null\n  DateRangePicker: (props: DateRangePickerProps) => JSX.Element | null\n  OrderedList: (props: OrderedListProps) => JSX.Element | null\n  UnorderedList: (props: UnorderedListProps) => JSX.Element | null\n  NumberInput: (props: NumberInputProps) => JSX.Element | null\n  Radio: (props: RadioProps) => JSX.Element | null\n  RadioGroup: (props: RadioGroupProps) => JSX.Element | null\n  Select: (props: SelectProps) => JSX.Element | null\n  Switch: (props: SwitchProps) => JSX.Element | null\n  TextInput: (props: TextInputProps) => JSX.Element | null\n  TextArea: (props: TextAreaProps) => JSX.Element | null\n  Link: (props: LinkProps) => JSX.Element | null\n  Menu: (props: MenuProps) => JSX.Element | null\n  Table: (props: TableProps) => JSX.Element | null\n  Heading: (props: HeadingProps) => JSX.Element | null\n  PaginationControl?: (props: PaginationControlProps) => JSX.Element | null\n  PayrollLoading?: (props: PayrollLoadingProps) => JSX.Element | null\n  Text: (props: TextProps) => JSX.Element | null\n  CalendarPreview: (props: CalendarPreviewProps) => JSX.Element | null\n  ProgressBar: (props: ProgressBarProps) => JSX.Element | null\n  Breadcrumbs: (props: BreadcrumbsProps) => JSX.Element | null\n  Tabs: (props: TabsProps) => JSX.Element | null\n  Dialog: (props: DialogProps) => JSX.Element | null\n  Modal: (props: ModalProps) => JSX.Element | null\n  LoadingSpinner: (props: LoadingSpinnerProps) => JSX.Element | null\n  DescriptionList: (props: DescriptionListProps) => JSX.Element | null\n  FileInput: (props: FileInputProps) => JSX.Element | null\n}\n\nexport const ComponentsContext = createContext<ComponentsContextType | null>(null)\n\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":";AAkFO,MAAMA,IAAoBC,EAA4C,IAAI,GAEpEC,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 { JSX } 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 `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 `ComponentsContextType` to `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 *\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: (props: AlertProps) => JSX.Element | null\n  /** Small inline label for status, counts, or tags; optionally dismissible. */\n  Badge: (props: BadgeProps) => JSX.Element | null\n  /** Full-width notification banner for prominent warnings and errors. */\n  Banner: (props: BannerProps) => JSX.Element | null\n  /** HTML `<button>` with primary, secondary, tertiary, and error variants. */\n  Button: (props: ButtonProps) => JSX.Element | null\n  /** Icon-only `<button>`; requires `aria-label` since there is no visible text for assistive technologies. */\n  ButtonIcon: (props: ButtonIconProps) => JSX.Element | null\n  /** Sectioned layout container with distinct header, body, and footer areas. */\n  Box: (props: BoxProps) => JSX.Element | null\n  /** Header section of a Box with a title, optional description, and optional inline action. */\n  BoxHeader: (props: BoxHeaderProps) => JSX.Element | null\n  /** Read-only calendar for visualizing a date range with optional highlighted dates. */\n  CalendarPreview: (props: CalendarPreviewProps) => JSX.Element | null\n  /** Content container with an optional overflow menu and a leading action slot. */\n  Card: (props: CardProps) => JSX.Element | null\n  /** Form field wrapping a single `<input type=\"checkbox\" />`. */\n  Checkbox: (props: CheckboxProps) => JSX.Element | null\n  /** Form field grouping `<input type=\"checkbox\" />` elements for multi-option selection. */\n  CheckboxGroup: (props: CheckboxGroupProps) => JSX.Element | null\n  /** Form field wrapping a typeahead `<input />` for single-option selection. */\n  ComboBox: (props: ComboBoxProps) => JSX.Element | null\n  /** Form field wrapping an `<input type=\"date\" />` with a calendar picker popover. */\n  DatePicker: (props: DatePickerProps) => JSX.Element | null\n  /** Form field wrapping paired `<input type=\"date\" />` elements for a date range. */\n  DateRangePicker: (props: DateRangePickerProps) => JSX.Element | null\n  /** HTML `<dl>` of term/description pairs in stacked or horizontal layout. */\n  DescriptionList: (props: DescriptionListProps) => JSX.Element | null\n  /** Modal confirmation dialog with a primary action and a cancel action. */\n  Dialog: (props: DialogProps) => JSX.Element | null\n  /** Form field wrapping an `<input type=\"file\" />`. */\n  FileInput: (props: FileInputProps) => JSX.Element | null\n  /** HTML `<h1>`–`<h6>` with visual style controlled independently from semantic level. */\n  Heading: (props: HeadingProps) => JSX.Element | null\n  /** HTML `<a>` for inline navigation. */\n  Link: (props: LinkProps) => JSX.Element | null\n  /** Spinner shown while data or an action is pending. */\n  LoadingSpinner: (props: LoadingSpinnerProps) => JSX.Element | null\n  /** Popover menu of actions anchored to a trigger element. */\n  Menu: (props: MenuProps) => JSX.Element | null\n  /** Overlay modal with customizable body content and footer. */\n  Modal: (props: ModalProps) => JSX.Element | null\n  /** Form field wrapping a typeahead `<input />` for multi-option selection. */\n  MultiSelectComboBox: (props: MultiSelectComboBoxProps) => JSX.Element | null\n  /** Form field wrapping a numeric `<input />` for currency, decimal, or percent values. */\n  NumberInput: (props: NumberInputProps) => JSX.Element | null\n  /** HTML `<ol>` for a numbered list of items. */\n  OrderedList: (props: OrderedListProps) => JSX.Element | null\n  /** Step-based progress indicator for multi-step flows. */\n  ProgressBar: (props: ProgressBarProps) => JSX.Element | null\n  /** Navigation breadcrumb trail showing the user's position in a multi-step flow. */\n  Breadcrumbs: (props: BreadcrumbsProps) => JSX.Element | null\n  /** Form field wrapping a single `<input type=\"radio\" />`. */\n  Radio: (props: RadioProps) => JSX.Element | null\n  /** Form field grouping `<input type=\"radio\" />` elements for single-option selection. */\n  RadioGroup: (props: RadioGroupProps) => JSX.Element | null\n  /** Form field wrapping a single-select dropdown. */\n  Select: (props: SelectProps) => JSX.Element | null\n  /** Form field wrapping an `<input type=\"checkbox\" />` styled as a toggle. */\n  Switch: (props: SwitchProps) => JSX.Element | null\n  /** Tabbed navigation with associated content panels. */\n  Tabs: (props: TabsProps) => JSX.Element | null\n  /** Tabular data display with headers, rows, optional footer, and empty state. */\n  Table: (props: TableProps) => JSX.Element | null\n  /** Body text element rendered as `<p>`, `<span>`, `<div>`, or `<pre>`. */\n  Text: (props: TextProps) => JSX.Element | null\n  /** Form field wrapping an `<input />`. */\n  TextInput: (props: TextInputProps) => JSX.Element | null\n  /** Form field wrapping a `<textarea>`. */\n  TextArea: (props: TextAreaProps) => JSX.Element | null\n  /** HTML `<ul>` for an unordered list of items. */\n  UnorderedList: (props: UnorderedListProps) => JSX.Element | null\n\n  /** Pagination controls for list views. Defaults to the SDK's built-in pagination UI when omitted. */\n  PaginationControl?: (props: PaginationControlProps) => JSX.Element | null\n  /** Loading indicator for payroll calculation. Defaults to the SDK's built-in loading state when omitted. */\n  PayrollLoading?: (props: PayrollLoadingProps) => JSX.Element | null\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":";AAkLO,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/GustoProviderCustomUIAdapter.js

@@ -7,7 +7,6 @@ import { ApiProvider as I } from "../ApiProvider/ApiProvider.js";
 import { LoadingIndicatorProvider as L } from "../LoadingIndicatorProvider/LoadingIndicatorProvider.js";
 import { sanitizeError as x } from "../ObservabilityProvider/sanitization.js";
 import { SDKI18next as m } from "./SDKI18next.js";
-import "classnames";
 import "../../shared/constants.js";
 import { InternalError as z } from "../../components/Common/InternalError/InternalError.js";
 import { LocaleProvider as D } from "../LocaleProvider/LocaleProvider.js";
@@ -15,12 +14,12 @@ 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 Y = (s) => {
+const X = (s) => {
   const {
     children: l,
     config: r,
     dictionary: i,
-    lng: t = "en",
+    lng: n = "en",
     locale: c = "en-US",
     currency: d = "USD",
     theme: p,
@@ -30,8 +29,8 @@ const Y = (s) => {
     queryClient: u
   } = s;
   if (i)
-    for (const n in i) {
-      const e = n;
+    for (const t in i) {
+      const e = t;
       for (const a in i[e])
         m.addResourceBundle(
           e,
@@ -42,14 +41,14 @@ const Y = (s) => {
         );
     }
   k(() => {
-    (async () => await m.changeLanguage(t))();
-  }, [t]);
+    (async () => await m.changeLanguage(n))();
+  }, [n]);
   const h = C(() => {
     if (r.observability?.onError)
-      return (n, e) => {
+      return (t, e) => {
         if (!r.observability?.onError) return;
         const y = {
-          ...T(n),
+          ...T(t),
           timestamp: Date.now(),
           componentStack: e.componentStack ?? void 0
         }, E = x(y, r.observability.sanitization);
@@ -65,9 +64,9 @@ const Y = (s) => {
       queryClient: u,
       children: l
     }
-  ) }, t) }) }) }) }) }) });
+  ) }, n) }) }) }) }) }) });
 };
 export {
-  Y as GustoProviderCustomUIAdapter
+  X as GustoProviderCustomUIAdapter
 };
 //# sourceMappingURL=GustoProviderCustomUIAdapter.js.map

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 { ResourceDictionary, SupportedLanguages } from '@/types/Helpers'\nimport type { SDKHooks } from '@/types/hooks'\nimport type { ObservabilityHook } from '@/types/observability'\nimport { normalizeToSDKError } from '@/types/sdkError'\n\nexport interface APIConfig {\n  baseUrl: string\n  headers?: HeadersInit\n  hooks?: SDKHooks\n  observability?: ObservabilityHook\n}\n\nexport interface GustoProviderProps {\n  config: APIConfig\n  dictionary?: ResourceDictionary\n  lng?: string\n  locale?: string\n  currency?: string\n  theme?: GustoSDKTheme\n  portalContainer?: HTMLElement\n  queryClient?: QueryClient\n  components: ComponentsContextType\n  LoaderComponent?: LoadingIndicatorContextProps['LoadingIndicator']\n}\n\nexport interface GustoProviderCustomUIAdapterProps extends GustoProviderProps {\n  children?: React.ReactNode\n}\n\n/**\n * A provider that accepts UI component adapters through the components prop\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":";;;;;;;;;;;;;;;;;AAkDA,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 } 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 { ResourceDictionary, SupportedLanguages } from '@/types/Helpers'\nimport type { SDKHooks } from '@/types/hooks'\nimport type { ObservabilityHook } from '@/types/observability'\nimport { normalizeToSDKError } from '@/types/sdkError'\n\nexport interface APIConfig {\n  baseUrl: string\n  headers?: HeadersInit\n  hooks?: SDKHooks\n  observability?: ObservabilityHook\n}\n\nexport interface GustoProviderProps {\n  config: APIConfig\n  dictionary?: ResourceDictionary\n  lng?: string\n  locale?: string\n  currency?: string\n  theme?: GustoSDKTheme\n  portalContainer?: HTMLElement\n  queryClient?: QueryClient\n  components: ComponentsContextType\n  LoaderComponent?: LoadingIndicatorContextProps['LoadingIndicator']\n}\n\nexport interface GustoProviderCustomUIAdapterProps extends GustoProviderProps {\n  children?: React.ReactNode\n}\n\n/**\n * A provider that accepts UI component adapters through the components prop\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":";;;;;;;;;;;;;;;;AAkDA,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;"}

package/dist/contexts/LoadingIndicatorProvider/LoadingIndicatorProvider.d.ts

@@ -1,7 +1,19 @@
 import { ReactNode } from 'react';
 import { LoadingIndicatorContextProps } from './useLoadingIndicator';
+/** @internal */
 export interface LoadingIndicatorProviderProps {
     children: ReactNode;
     value?: LoadingIndicatorContextProps['LoadingIndicator'];
 }
-export declare function LoadingIndicatorProvider({ children, value }: LoadingIndicatorProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Provides the loading-indicator component to SDK base components via {@link LoadingIndicatorContext}.
+ *
+ * @remarks
+ * When `value` is omitted, the SDK's default `Loading` component is used. Composed by `GustoProvider`
+ * so a partner-supplied `LoaderComponent` flows through to every internal Suspense fallback.
+ *
+ * @param props - See {@link LoadingIndicatorProviderProps}.
+ * @returns A React subtree with the loading-indicator context applied.
+ * @internal
+ */
+export declare function LoadingIndicatorProvider({ children, value }: LoadingIndicatorProviderProps): import("react").JSX.Element;

package/dist/contexts/LoadingIndicatorProvider/LoadingIndicatorProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"LoadingIndicatorProvider.js","sources":["../../../src/contexts/LoadingIndicatorProvider/LoadingIndicatorProvider.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { LoadingIndicatorContext, type LoadingIndicatorContextProps } from './useLoadingIndicator'\nimport { Loading } from '@/components/Common/Loading/Loading'\n\nexport interface LoadingIndicatorProviderProps {\n  children: ReactNode\n  value?: LoadingIndicatorContextProps['LoadingIndicator']\n}\n\nexport function LoadingIndicatorProvider({ children, value }: LoadingIndicatorProviderProps) {\n  return (\n    <LoadingIndicatorContext.Provider value={{ LoadingIndicator: value ?? Loading }}>\n      {children}\n    </LoadingIndicatorContext.Provider>\n  )\n}\n"],"names":["LoadingIndicatorProvider","children","value","jsx","LoadingIndicatorContext","Loading"],"mappings":";;;AASO,SAASA,EAAyB,EAAE,UAAAC,GAAU,OAAAC,KAAwC;AAC3F,SACE,gBAAAC,EAACC,EAAwB,UAAxB,EAAiC,OAAO,EAAE,kBAAkBF,KAASG,KACnE,UAAAJ,GACH;AAEJ;"}
+{"version":3,"file":"LoadingIndicatorProvider.js","sources":["../../../src/contexts/LoadingIndicatorProvider/LoadingIndicatorProvider.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { LoadingIndicatorContext, type LoadingIndicatorContextProps } from './useLoadingIndicator'\nimport { Loading } from '@/components/Common/Loading/Loading'\n\n/** @internal */\nexport interface LoadingIndicatorProviderProps {\n  children: ReactNode\n  value?: LoadingIndicatorContextProps['LoadingIndicator']\n}\n\n/**\n * Provides the loading-indicator component to SDK base components via {@link LoadingIndicatorContext}.\n *\n * @remarks\n * When `value` is omitted, the SDK's default `Loading` component is used. Composed by `GustoProvider`\n * so a partner-supplied `LoaderComponent` flows through to every internal Suspense fallback.\n *\n * @param props - See {@link LoadingIndicatorProviderProps}.\n * @returns A React subtree with the loading-indicator context applied.\n * @internal\n */\nexport function LoadingIndicatorProvider({ children, value }: LoadingIndicatorProviderProps) {\n  return (\n    <LoadingIndicatorContext.Provider value={{ LoadingIndicator: value ?? Loading }}>\n      {children}\n    </LoadingIndicatorContext.Provider>\n  )\n}\n"],"names":["LoadingIndicatorProvider","children","value","jsx","LoadingIndicatorContext","Loading"],"mappings":";;;AAqBO,SAASA,EAAyB,EAAE,UAAAC,GAAU,OAAAC,KAAwC;AAC3F,SACE,gBAAAC,EAACC,EAAwB,UAAxB,EAAiC,OAAO,EAAE,kBAAkBF,KAASG,KACnE,UAAAJ,GACH;AAEJ;"}

package/dist/contexts/LoadingIndicatorProvider/useLoadingIndicator.d.ts

@@ -1,16 +1,32 @@
 import { JSX } from 'react';
+/**
+ * Shape of the value stored in {@link LoadingIndicatorContext}.
+ *
+ * @internal
+ */
 export interface LoadingIndicatorContextProps {
     LoadingIndicator: ({ children }: {
         children?: React.ReactNode;
     }) => JSX.Element;
 }
+/**
+ * React context holding the loading-indicator component used by SDK base components.
+ *
+ * @internal
+ */
 export declare const LoadingIndicatorContext: import('react').Context<{
     LoadingIndicator: ({ children }: {
         children?: React.ReactNode;
-    }) => import("react/jsx-runtime").JSX.Element;
+    }) => JSX.Element;
 }>;
+/**
+ * Reads the loading-indicator component from {@link LoadingIndicatorContext}.
+ *
+ * @returns The current {@link LoadingIndicatorContextProps} value, falling back to the SDK default `Loading` component.
+ * @internal
+ */
 export declare const useLoadingIndicator: () => {
     LoadingIndicator: ({ children }: {
         children?: React.ReactNode;
-    }) => import("react/jsx-runtime").JSX.Element;
+    }) => JSX.Element;
 };

package/dist/contexts/LoadingIndicatorProvider/useLoadingIndicator.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLoadingIndicator.js","sources":["../../../src/contexts/LoadingIndicatorProvider/useLoadingIndicator.tsx"],"sourcesContent":["import type { JSX } from 'react'\nimport { createContext, useContext } from 'react'\nimport { Loading } from '@/components/Common/Loading/Loading'\n\nexport interface LoadingIndicatorContextProps {\n  LoadingIndicator: ({ children }: { children?: React.ReactNode }) => JSX.Element\n}\nexport const LoadingIndicatorContext = createContext({\n  LoadingIndicator: ({ children }: { children?: React.ReactNode }) => <Loading>{children}</Loading>,\n})\n\nexport const useLoadingIndicator = () => useContext(LoadingIndicatorContext)\n"],"names":["LoadingIndicatorContext","createContext","children","jsx","Loading","useLoadingIndicator","useContext"],"mappings":";;;AAOO,MAAMA,IAA0BC,EAAc;AAAA,EACnD,kBAAkB,CAAC,EAAE,UAAAC,QAA+C,gBAAAC,EAACC,KAAS,UAAAF,EAAA,CAAS;AACzF,CAAC,GAEYG,IAAsB,MAAMC,EAAWN,CAAuB;"}
+{"version":3,"file":"useLoadingIndicator.js","sources":["../../../src/contexts/LoadingIndicatorProvider/useLoadingIndicator.tsx"],"sourcesContent":["import type { JSX } from 'react'\nimport { createContext, useContext } from 'react'\nimport { Loading } from '@/components/Common/Loading/Loading'\n\n/**\n * Shape of the value stored in {@link LoadingIndicatorContext}.\n *\n * @internal\n */\nexport interface LoadingIndicatorContextProps {\n  LoadingIndicator: ({ children }: { children?: React.ReactNode }) => JSX.Element\n}\n/**\n * React context holding the loading-indicator component used by SDK base components.\n *\n * @internal\n */\nexport const LoadingIndicatorContext = createContext({\n  LoadingIndicator: ({ children }: { children?: React.ReactNode }) => <Loading>{children}</Loading>,\n})\n\n/**\n * Reads the loading-indicator component from {@link LoadingIndicatorContext}.\n *\n * @returns The current {@link LoadingIndicatorContextProps} value, falling back to the SDK default `Loading` component.\n * @internal\n */\nexport const useLoadingIndicator = () => useContext(LoadingIndicatorContext)\n"],"names":["LoadingIndicatorContext","createContext","children","jsx","Loading","useLoadingIndicator","useContext"],"mappings":";;;AAiBO,MAAMA,IAA0BC,EAAc;AAAA,EACnD,kBAAkB,CAAC,EAAE,UAAAC,QAA+C,gBAAAC,EAACC,KAAS,UAAAF,EAAA,CAAS;AACzF,CAAC,GAQYG,IAAsB,MAAMC,EAAWN,CAAuB;"}

package/dist/contexts/LocaleProvider/LocaleProvider.d.ts

@@ -1,5 +1,21 @@
 import { LocaleProps } from './useLocale';
+/**
+ * Props for {@link LocaleProvider}: the {@link LocaleProps} settings plus any children to render within the locale scope.
+ *
+ * @internal
+ */
 export interface LocaleProviderProps extends LocaleProps {
     children?: React.ReactNode;
 }
-export declare function LocaleProvider({ locale, currency, children, }: LocaleProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Supplies locale and currency to descendant SDK components and sets the `lang` attribute on a wrapping `div`.
+ *
+ * @remarks
+ * Normally used internally by `GustoProvider`; render it directly only when composing the SDK
+ * outside of `GustoProvider`. Children access the active values through {@link useLocale}.
+ *
+ * @param props - The {@link LocaleProviderProps} controlling locale, currency, and children.
+ * @returns A `div` with `lang` set to the locale, wrapping `children` in the locale context.
+ * @internal
+ */
+export declare function LocaleProvider({ locale, currency, children, }: LocaleProviderProps): import("react").JSX.Element;

package/dist/contexts/LocaleProvider/LocaleProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocaleProvider.js","sources":["../../../src/contexts/LocaleProvider/LocaleProvider.tsx"],"sourcesContent":["import type { LocaleProps } from './useLocale'\nimport { LocaleContext } from './useLocale'\n\nexport interface LocaleProviderProps extends LocaleProps {\n  children?: React.ReactNode\n}\n\nexport function LocaleProvider({\n  locale = 'en-US',\n  currency = 'USD',\n  children,\n}: LocaleProviderProps) {\n  return (\n    <LocaleContext.Provider value={{ locale: locale, currency: currency }}>\n      <div lang={locale}>{children}</div>\n    </LocaleContext.Provider>\n  )\n}\n"],"names":["LocaleProvider","locale","currency","children","jsx","LocaleContext"],"mappings":";;AAOO,SAASA,EAAe;AAAA,EAC7B,QAAAC,IAAS;AAAA,EACT,UAAAC,IAAW;AAAA,EACX,UAAAC;AACF,GAAwB;AACtB,SACE,gBAAAC,EAACC,EAAc,UAAd,EAAuB,OAAO,EAAE,QAAAJ,GAAgB,UAAAC,EAAA,GAC/C,UAAA,gBAAAE,EAAC,OAAA,EAAI,MAAMH,GAAS,UAAAE,GAAS,GAC/B;AAEJ;"}
+{"version":3,"file":"LocaleProvider.js","sources":["../../../src/contexts/LocaleProvider/LocaleProvider.tsx"],"sourcesContent":["import type { LocaleProps } from './useLocale'\nimport { LocaleContext } from './useLocale'\n\n/**\n * Props for {@link LocaleProvider}: the {@link LocaleProps} settings plus any children to render within the locale scope.\n *\n * @internal\n */\nexport interface LocaleProviderProps extends LocaleProps {\n  children?: React.ReactNode\n}\n\n/**\n * Supplies locale and currency to descendant SDK components and sets the `lang` attribute on a wrapping `div`.\n *\n * @remarks\n * Normally used internally by `GustoProvider`; render it directly only when composing the SDK\n * outside of `GustoProvider`. Children access the active values through {@link useLocale}.\n *\n * @param props - The {@link LocaleProviderProps} controlling locale, currency, and children.\n * @returns A `div` with `lang` set to the locale, wrapping `children` in the locale context.\n * @internal\n */\nexport function LocaleProvider({\n  locale = 'en-US',\n  currency = 'USD',\n  children,\n}: LocaleProviderProps) {\n  return (\n    <LocaleContext.Provider value={{ locale: locale, currency: currency }}>\n      <div lang={locale}>{children}</div>\n    </LocaleContext.Provider>\n  )\n}\n"],"names":["LocaleProvider","locale","currency","children","jsx","LocaleContext"],"mappings":";;AAuBO,SAASA,EAAe;AAAA,EAC7B,QAAAC,IAAS;AAAA,EACT,UAAAC,IAAW;AAAA,EACX,UAAAC;AACF,GAAwB;AACtB,SACE,gBAAAC,EAACC,EAAc,UAAd,EAAuB,OAAO,EAAE,QAAAJ,GAAgB,UAAAC,EAAA,GAC/C,UAAA,gBAAAE,EAAC,OAAA,EAAI,MAAMH,GAAS,UAAAE,GAAS,GAC/B;AAEJ;"}

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

@@ -1,3 +1,3 @@
 import "./types/i18next.d.ts"
 export { LocaleProvider } from './LocaleProvider';
-export { useLocale, type LocaleProps } from './useLocale';
+export { useLocale } from './useLocale';

package/dist/contexts/LocaleProvider/useLocale.d.ts

@@ -1,10 +1,49 @@
+/**
+ * Locale and currency settings supplied to {@link LocaleProvider}.
+ *
+ * @remarks
+ * `locale` is a BCP 47 language tag (defaults to `en-US`) used for `Intl` formatting and the
+ * rendered wrapper's `lang` attribute. `currency` is an ISO 4217 currency code (defaults to
+ * `USD`) consumed by currency-aware inputs.
+ *
+ * @internal
+ */
 export interface LocaleProps {
     locale?: string;
     currency?: string;
 }
+/**
+ * React context backing {@link useLocale} and {@link useLocaleDateFormatter}.
+ *
+ * @internal
+ */
 export declare const LocaleContext: import('react').Context<LocaleProps | null>;
+/**
+ * Returns the active locale and currency from the surrounding {@link LocaleProvider}.
+ *
+ * @returns An object with `locale` (defaulting to `en-US`) and `currency` (defaulting to `USD`).
+ * @throws An `Error` when called outside a {@link LocaleProvider}.
+ * @internal
+ *
+ * @example
+ * ```tsx
+ * import { useLocale } from '@gusto/embedded-react-sdk'
+ *
+ * function Amount({ value }: { value: number }) {
+ *   const { locale, currency } = useLocale()
+ *   return <span>{new Intl.NumberFormat(locale, { style: 'currency', currency }).format(value)}</span>
+ * }
+ * ```
+ */
 export declare const useLocale: () => {
     locale: string;
     currency: string;
 };
+/**
+ * Returns an `Intl.DateTimeFormat` configured with the active locale and a long-month, numeric-year, two-digit-day style.
+ *
+ * @returns An `Intl.DateTimeFormat` instance bound to the provider's locale (or `en-US` if unset).
+ * @throws An `Error` when called outside a {@link LocaleProvider}.
+ * @internal
+ */
 export declare const useLocaleDateFormatter: () => Intl.DateTimeFormat;

package/dist/contexts/LocaleProvider/useLocale.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLocale.js","sources":["../../../src/contexts/LocaleProvider/useLocale.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\n\nexport interface LocaleProps {\n  locale?: string\n  currency?: string\n}\n\nexport const LocaleContext = createContext<LocaleProps | null>(null)\n\nexport const useLocale = () => {\n  const values = useContext(LocaleContext)\n  if (!values) {\n    throw new Error('useLocal used outside provider')\n  }\n  return {\n    locale: values.locale ?? 'en-US',\n    currency: values.currency ?? 'USD',\n  }\n}\nexport const useLocaleDateFormatter = () => {\n  const values = useContext(LocaleContext)\n  if (!values) {\n    throw new Error('useLocaleDateFormatter used outside provider')\n  }\n  return new Intl.DateTimeFormat(values.locale ?? 'en-US', {\n    year: 'numeric',\n    month: 'long',\n    day: '2-digit',\n  })\n}\n"],"names":["LocaleContext","createContext","useLocale","values","useContext","useLocaleDateFormatter"],"mappings":";AAOO,MAAMA,IAAgBC,EAAkC,IAAI,GAEtDC,IAAY,MAAM;AAC7B,QAAMC,IAASC,EAAWJ,CAAa;AACvC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,gCAAgC;AAElD,SAAO;AAAA,IACL,QAAQA,EAAO,UAAU;AAAA,IACzB,UAAUA,EAAO,YAAY;AAAA,EAAA;AAEjC,GACaE,IAAyB,MAAM;AAC1C,QAAMF,IAASC,EAAWJ,CAAa;AACvC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,8CAA8C;AAEhE,SAAO,IAAI,KAAK,eAAeA,EAAO,UAAU,SAAS;AAAA,IACvD,MAAM;AAAA,IACN,OAAO;AAAA,IACP,KAAK;AAAA,EAAA,CACN;AACH;"}
+{"version":3,"file":"useLocale.js","sources":["../../../src/contexts/LocaleProvider/useLocale.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\n\n/**\n * Locale and currency settings supplied to {@link LocaleProvider}.\n *\n * @remarks\n * `locale` is a BCP 47 language tag (defaults to `en-US`) used for `Intl` formatting and the\n * rendered wrapper's `lang` attribute. `currency` is an ISO 4217 currency code (defaults to\n * `USD`) consumed by currency-aware inputs.\n *\n * @internal\n */\nexport interface LocaleProps {\n  locale?: string\n  currency?: string\n}\n\n/**\n * React context backing {@link useLocale} and {@link useLocaleDateFormatter}.\n *\n * @internal\n */\nexport const LocaleContext = createContext<LocaleProps | null>(null)\n\n/**\n * Returns the active locale and currency from the surrounding {@link LocaleProvider}.\n *\n * @returns An object with `locale` (defaulting to `en-US`) and `currency` (defaulting to `USD`).\n * @throws An `Error` when called outside a {@link LocaleProvider}.\n * @internal\n *\n * @example\n * ```tsx\n * import { useLocale } from '@gusto/embedded-react-sdk'\n *\n * function Amount({ value }: { value: number }) {\n *   const { locale, currency } = useLocale()\n *   return <span>{new Intl.NumberFormat(locale, { style: 'currency', currency }).format(value)}</span>\n * }\n * ```\n */\nexport const useLocale = () => {\n  const values = useContext(LocaleContext)\n  if (!values) {\n    throw new Error('useLocal used outside provider')\n  }\n  return {\n    locale: values.locale ?? 'en-US',\n    currency: values.currency ?? 'USD',\n  }\n}\n/**\n * Returns an `Intl.DateTimeFormat` configured with the active locale and a long-month, numeric-year, two-digit-day style.\n *\n * @returns An `Intl.DateTimeFormat` instance bound to the provider's locale (or `en-US` if unset).\n * @throws An `Error` when called outside a {@link LocaleProvider}.\n * @internal\n */\nexport const useLocaleDateFormatter = () => {\n  const values = useContext(LocaleContext)\n  if (!values) {\n    throw new Error('useLocaleDateFormatter used outside provider')\n  }\n  return new Intl.DateTimeFormat(values.locale ?? 'en-US', {\n    year: 'numeric',\n    month: 'long',\n    day: '2-digit',\n  })\n}\n"],"names":["LocaleContext","createContext","useLocale","values","useContext","useLocaleDateFormatter"],"mappings":";AAsBO,MAAMA,IAAgBC,EAAkC,IAAI,GAmBtDC,IAAY,MAAM;AAC7B,QAAMC,IAASC,EAAWJ,CAAa;AACvC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,gCAAgC;AAElD,SAAO;AAAA,IACL,QAAQA,EAAO,UAAU;AAAA,IACzB,UAAUA,EAAO,YAAY;AAAA,EAAA;AAEjC,GAQaE,IAAyB,MAAM;AAC1C,QAAMF,IAASC,EAAWJ,CAAa;AACvC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,8CAA8C;AAEhE,SAAO,IAAI,KAAK,eAAeA,EAAO,UAAU,SAAS;AAAA,IACvD,MAAM;AAAA,IACN,OAAO;AAAA,IACP,KAAK;AAAA,EAAA,CACN;AACH;"}

package/dist/contexts/ObservabilityProvider/ObservabilityContext.d.ts

@@ -1,5 +1,16 @@
 import { ObservabilityHook } from '../../types/observability';
+/**
+ * Value provided by the SDK's observability context, exposing the configured observability hook to descendants.
+ *
+ * @internal
+ */
 export interface ObservabilityContextValue {
+    /** The partner-supplied observability hook, or `undefined` if none was configured. */
     observability: ObservabilityHook | undefined;
 }
+/**
+ * React context that carries the partner-supplied observability hook through the SDK provider tree.
+ *
+ * @internal
+ */
 export declare const ObservabilityContext: import('react').Context<ObservabilityContextValue | undefined>;

package/dist/contexts/ObservabilityProvider/ObservabilityContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObservabilityContext.js","sources":["../../../src/contexts/ObservabilityProvider/ObservabilityContext.ts"],"sourcesContent":["import { createContext } from 'react'\nimport type { ObservabilityHook } from '@/types/observability'\n\nexport interface ObservabilityContextValue {\n  observability: ObservabilityHook | undefined\n}\n\nexport const ObservabilityContext = createContext<ObservabilityContextValue | undefined>(undefined)\n"],"names":["ObservabilityContext","createContext"],"mappings":";AAOO,MAAMA,IAAuBC,EAAqD,MAAS;"}
+{"version":3,"file":"ObservabilityContext.js","sources":["../../../src/contexts/ObservabilityProvider/ObservabilityContext.ts"],"sourcesContent":["import { createContext } from 'react'\nimport type { ObservabilityHook } from '@/types/observability'\n\n/**\n * Value provided by the SDK's observability context, exposing the configured observability hook to descendants.\n *\n * @internal\n */\nexport interface ObservabilityContextValue {\n  /** The partner-supplied observability hook, or `undefined` if none was configured. */\n  observability: ObservabilityHook | undefined\n}\n\n/**\n * React context that carries the partner-supplied observability hook through the SDK provider tree.\n *\n * @internal\n */\nexport const ObservabilityContext = createContext<ObservabilityContextValue | undefined>(undefined)\n"],"names":["ObservabilityContext","createContext"],"mappings":";AAkBO,MAAMA,IAAuBC,EAAqD,MAAS;"}