@gusto/embedded-react-sdk 0.46.3 → 0.47.1

package/CHANGELOG.md

@@ -1,5 +1,72 @@
 # Changelog
 
+## [0.47.1](https://github.com/Gusto/embedded-react-sdk/compare/v0.47.0...v0.47.1) (2026-06-09)
+
+### Features & Enhancements
+
+- add create-design-prototype skill ([#2062](https://github.com/Gusto/embedded-react-sdk/issues/2062)) ([6618bfe](https://github.com/Gusto/embedded-react-sdk/commit/6618bfe44a1422706ad251c1674f09c0b546f368))
+- re-export onboarding status constants from public entry ([#2080](https://github.com/Gusto/embedded-react-sdk/issues/2080)) ([64edd32](https://github.com/Gusto/embedded-react-sdk/commit/64edd323f2703a58bf58e61404cf2051c4c6caa6))
+
+### Fixes
+
+- tighten federal taxes form field spacing ([#2063](https://github.com/Gusto/embedded-react-sdk/issues/2063)) ([8644bee](https://github.com/Gusto/embedded-react-sdk/commit/8644bee5d7be93f472201f1066147b6490c1bf3c))
+
+### Chores & Maintenance
+
+- **deps-dev:** bump @microsoft/api-extractor from 7.58.7 to 7.58.8 ([#2070](https://github.com/Gusto/embedded-react-sdk/issues/2070)) ([e8153e5](https://github.com/Gusto/embedded-react-sdk/commit/e8153e53fb8597be925e35ccf90f9332b4c71fa8))
+- **deps-dev:** bump @storybook/addon-docs from 10.4.1 to 10.4.2 ([#2071](https://github.com/Gusto/embedded-react-sdk/issues/2071)) ([1321422](https://github.com/Gusto/embedded-react-sdk/commit/132142240b23631601bc5da9edb6157fafa903fe))
+- **deps-dev:** bump @typescript-eslint/rule-tester from 8.60.1 to 8.61.0 ([#2074](https://github.com/Gusto/embedded-react-sdk/issues/2074)) ([5ea4631](https://github.com/Gusto/embedded-react-sdk/commit/5ea463124eca514a514a44845d4583c1896daa06))
+- **deps-dev:** bump @typescript-eslint/utils from 8.60.1 to 8.61.0 ([#2072](https://github.com/Gusto/embedded-react-sdk/issues/2072)) ([69080d8](https://github.com/Gusto/embedded-react-sdk/commit/69080d883513c5485883635ac39df957d3ce2d43))
+- **deps-dev:** bump shell-quote from 1.8.3 to 1.8.4 in the npm_and_yarn group across 1 directory ([#2075](https://github.com/Gusto/embedded-react-sdk/issues/2075)) ([d8b3a5b](https://github.com/Gusto/embedded-react-sdk/commit/d8b3a5bc12ba829664f58a6e2aaad209ac27e042))
+- **deps-dev:** bump typescript-eslint from 8.60.1 to 8.61.0 ([#2073](https://github.com/Gusto/embedded-react-sdk/issues/2073)) ([0f58397](https://github.com/Gusto/embedded-react-sdk/commit/0f58397965ecbceb74cc4785d2ea415ce0c42f73))
+- move EmployeeDocuments export from EmployeeManagement to EmployeeOnboarding ([#2065](https://github.com/Gusto/embedded-react-sdk/issues/2065)) ([d07bd90](https://github.com/Gusto/embedded-react-sdk/commit/d07bd90b8d5e120d540d7e22a30d3717011b2ad0))
+- **SDK-1010:** backfill phase 5 ([#2061](https://github.com/Gusto/embedded-react-sdk/issues/2061)) ([2a02b30](https://github.com/Gusto/embedded-react-sdk/commit/2a02b30597c37f846576a617330f7e84f7273909))
+- **SDK-1011:** backfill phase 6 ([#2064](https://github.com/Gusto/embedded-react-sdk/issues/2064)) ([7d8a165](https://github.com/Gusto/embedded-react-sdk/commit/7d8a165f5656380f8fe9d0a088b704859b02939c))
+
+## [0.47.0](https://github.com/Gusto/embedded-react-sdk/compare/v0.46.3...v0.47.0) (2026-06-08)
+
+### Breaking Changes
+
+- Compensation wage-label i18n keys were consolidated under a single source of truth. If you override compensation labels, update your translation overrides in the `Employee.Compensation` namespace ([#1984](https://github.com/Gusto/embedded-react-sdk/issues/1984)):
+
+  ```diff
+  - "Employee.Compensation.amount": "Compensation amount"
+  - "Employee.Compensation.paymentUnitLabel": "Wage frequency"
+  - "Employee.Compensation.management.wageLabel": "Wage"
+  - "Employee.Compensation.management.wageFrequencyLabel": "Wage frequency"
+  + "Employee.Compensation.wageLabel": "Wage"
+  + "Employee.Compensation.wageFrequencyLabel": "Wage frequency"
+  ```
+
+  The Add and Management compensation forms now share these top-level `wageLabel` / `wageFrequencyLabel` keys (both display "Wage" instead of the former "Compensation amount").
+
+### Features & Enhancements
+
+- Extract every `DashboardFlow` card into a standalone, independently-consumable management block — `Profile`, `HomeAddress`, `WorkAddress`, `Compensation`, `Deductions`, `Documents`, `Paystubs`, `PaymentMethod`, and `Federal`/`State` taxes — so each can be embedded on its own ([#1976](https://github.com/Gusto/embedded-react-sdk/issues/1976), [#1992](https://github.com/Gusto/embedded-react-sdk/issues/1992), [#2007](https://github.com/Gusto/embedded-react-sdk/issues/2007), [#2036](https://github.com/Gusto/embedded-react-sdk/issues/2036), [#2008](https://github.com/Gusto/embedded-react-sdk/issues/2008), [#2030](https://github.com/Gusto/embedded-react-sdk/issues/2030), [#2011](https://github.com/Gusto/embedded-react-sdk/issues/2011), [#2006](https://github.com/Gusto/embedded-react-sdk/issues/2006), [#2022](https://github.com/Gusto/embedded-react-sdk/issues/2022), [#2021](https://github.com/Gusto/embedded-react-sdk/issues/2021))
+- Add `OnboardingExecutionFlow` and skip the redundant employee list in `EmployeeListFlow` ([#1990](https://github.com/Gusto/embedded-react-sdk/issues/1990))
+- Surface FLSA-aware alerts in compensation forms — commission-only federal-minimum-pay and minimum-wage warnings, plus an owner reasonable-salary reminder — via new `useCompensationForm` `status` flags (`showCommissionFederalMinimumPayAlert`, `showCommissionMinimumWageAlert`, `showOwnerSalaryAlert`). Wage and wage-frequency inputs are hidden for commission-only statuses ([#1984](https://github.com/Gusto/embedded-react-sdk/issues/1984))
+- `PayrollList`: disable Run Payroll on regular rows while transition payrolls are pending ([#1989](https://github.com/Gusto/embedded-react-sdk/issues/1989))
+
+### Fixes
+
+- Surface home address submit errors inside the edit/create modal instead of at the page level ([#1993](https://github.com/Gusto/embedded-react-sdk/issues/1993))
+- Pin the Current home address card to the active row ([#1985](https://github.com/Gusto/embedded-react-sdk/issues/1985))
+- Show deduction cap fields consistently across the create and edit forms ([#1997](https://github.com/Gusto/embedded-react-sdk/issues/1997))
+- Stop showing "0% per paycheck" for fixed-cap garnishments ([#1998](https://github.com/Gusto/embedded-react-sdk/issues/1998))
+- Return to the dashboard after signing a document ([#1999](https://github.com/Gusto/embedded-react-sdk/issues/1999))
+- Stop a failed PDF preview fetch from surfacing as a signing error ([#2032](https://github.com/Gusto/embedded-react-sdk/issues/2032))
+- Align the onboarding compensation form layout and alert conditions with the management forms ([#2046](https://github.com/Gusto/embedded-react-sdk/issues/2046))
+- Add clarifying copy to the remove-secondary-jobs warning ([#2005](https://github.com/Gusto/embedded-react-sdk/issues/2005))
+- Remove the gap between tabs and table in the management employee list ([#2051](https://github.com/Gusto/embedded-react-sdk/issues/2051))
+
+### Chores & Maintenance
+
+- Upgrade to the `@gusto/embedded-api-v-2025-11-15` API package ([#1814](https://github.com/Gusto/embedded-react-sdk/issues/1814))
+- Standardize management card loading with per-card Suspense boundaries and normalize `useCompensationManagement` return shape ([#2054](https://github.com/Gusto/embedded-react-sdk/issues/2054), [#2048](https://github.com/Gusto/embedded-react-sdk/issues/2048))
+- Share PaymentMethod bank/split form bodies via an injected dictionary and give Profile/HomeAddress their own management i18n namespaces ([#2045](https://github.com/Gusto/embedded-react-sdk/issues/2045), [#2053](https://github.com/Gusto/embedded-react-sdk/issues/2053), [#2044](https://github.com/Gusto/embedded-react-sdk/issues/2044))
+- Expand TSDoc coverage across models, internal hooks, and PaymentMethod docs ([#2043](https://github.com/Gusto/embedded-react-sdk/issues/2043))
+- Bump dependencies (`react-hook-form`, `i18next`, `dompurify`, `vite`, `react-router-dom`, `typescript-eslint`, `@storybook/*`, `fuse.js`, `axe-core`, and others)
+
 ## [0.46.3](https://github.com/Gusto/embedded-react-sdk/compare/v0.46.2...v0.46.3) (2026-06-01)
 
 ### Features & Enhancements

package/dist/components/Base/Base.d.ts

@@ -5,32 +5,121 @@ import { EventType } from '../../shared/constants';
 import { ResourceDictionary, Resources } from '../../types/Helpers';
 import { LoadingIndicatorContextProps } from '../../contexts/LoadingIndicatorProvider/useLoadingIndicator';
 import { SDKError } from '../../types/sdkError';
+/**
+ * Props common to all SDK feature components, including children, an optional className, default form values, and an i18n resource dictionary override.
+ *
+ * @typeParam TResourceKey - The i18n resource namespace key whose dictionary entries can be overridden.
+ * @public
+ */
 export interface CommonComponentInterface<TResourceKey extends keyof Resources = keyof Resources> {
+    /** Optional child content rendered inside the component's layout. */
     children?: ReactNode;
+    /** CSS class name applied to the component's root element. */
     className?: string;
+    /**
+     * Initial values pre-populated into the component's form fields before the user interacts.
+     * The exact shape depends on the specific component — refer to each component's own props type.
+     */
     defaultValues?: unknown;
+    /**
+     * Overrides for the component's i18n strings. Supply a partial object whose keys match the
+     * component's resource namespace — any omitted keys fall back to SDK defaults.
+     * See the [Translation guide](https://docs.gusto.com/embedded-payroll/docs/translation) for details.
+     */
     dictionary?: ResourceDictionary<TResourceKey>;
 }
+/**
+ * Props for SDK feature components that participate in the standard error/loading/observability surface.
+ *
+ * @remarks
+ * Extends {@link CommonComponentInterface} with the `onEvent` callback that emits component events
+ * and optional overrides for the error-boundary fallback and loading indicator. This is the prop
+ * shape mixed into every public SDK feature component.
+ *
+ * @typeParam TResourceKey - The i18n resource namespace key whose dictionary entries can be overridden.
+ * @public
+ */
 export interface BaseComponentInterface<TResourceKey extends keyof Resources = keyof Resources> extends CommonComponentInterface<TResourceKey> {
+    /**
+     * Custom React component rendered in place of the component when an unhandled error is caught
+     * by the component-level error boundary. Receives `error` and `resetErrorBoundary` as props.
+     * Defaults to the SDK's built-in `InternalError` fallback.
+     */
     FallbackComponent?: BaseBoundariesProps['FallbackComponent'];
+    /**
+     * Custom loading indicator rendered while the component's async data is fetching.
+     * Overrides the indicator configured on `GustoProvider` for this component instance only.
+     */
     LoaderComponent?: LoadingIndicatorContextProps['LoadingIndicator'];
+    /**
+     * Callback invoked each time the component emits an event — user interactions, successful API
+     * responses, step transitions, or errors. Receives the event type constant and an optional
+     * payload whose shape varies by event. See the [Event Handling guide](https://docs.gusto.com/embedded-payroll/docs/event-handling)
+     * and each component's event table for the full list of emitted events.
+     */
     onEvent: OnEventType<EventType, unknown>;
 }
 interface InternalBaseComponentProps {
     componentName?: string;
 }
-export declare const BaseComponent: <TResourceKey extends keyof Resources = keyof Resources>({ children, FallbackComponent, LoaderComponent: LoadingIndicatorFromProps, onEvent, componentName, }: BaseComponentInterface<TResourceKey> & InternalBaseComponentProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Wraps SDK feature components with the standard error boundary, suspense fallback, form-submission handler, and observability wiring.
+ *
+ * @remarks
+ * Provides a {@link BaseContext} value to descendants exposing `error`, `setError`, `onEvent`, and
+ * `baseSubmitHandler`, then renders children inside {@link BaseBoundaries} and {@link BaseLayout}.
+ * Errors caught by the React error boundary are normalized, emitted to observability, and re-emitted
+ * via `onEvent`.
+ *
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `componentEvents.ERROR` | Emitted when an unhandled rendering error is caught by the component's error boundary | The raw error value caught by the boundary |
+ *
+ * @typeParam TResourceKey - The i18n resource namespace key whose dictionary entries can be overridden.
+ * @param props - Component props extending {@link BaseComponentInterface}.
+ * @returns A React element wrapping `children` with the SDK's standard error, loading, and event-emission surface.
+ * @internal
+ */
+export declare const BaseComponent: <TResourceKey extends keyof Resources = keyof Resources>({ children, FallbackComponent, LoaderComponent: LoadingIndicatorFromProps, onEvent, componentName, }: BaseComponentInterface<TResourceKey> & InternalBaseComponentProps) => JSX.Element;
+/** @internal */
 export interface BaseLayoutProps {
     children?: ReactNode;
     error?: SDKError | SDKError[] | null;
     isLoading?: boolean;
 }
-export declare const BaseLayout: ({ children, error, isLoading }: BaseLayoutProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Renders the standard SDK layout with normalized error display, suspense-aware loading state, and the children content.
+ *
+ * @remarks
+ * When `isLoading` is true and there are no errors, renders the configured loading indicator.
+ * Otherwise renders a fade-in wrapper that displays a single error alert, an aggregated alert when
+ * multiple errors are present, or no alert when errors are absent. Field-level errors are rendered
+ * as a list, validation errors as preformatted Zod output, and all other errors as a generic
+ * message — see {@link https://github.com/Gusto/embedded-react-sdk/blob/main/docs/integration-guide/error-handling.md | the Error Handling guide}.
+ *
+ * @param props - Component props matching {@link BaseLayoutProps}.
+ * @returns A React element with the SDK's standard error rendering and loading behavior wrapped around `children`.
+ * @internal
+ */
+export declare const BaseLayout: ({ children, error, isLoading }: BaseLayoutProps) => JSX.Element;
+/** @internal */
 export interface BaseBoundariesProps {
     children?: ReactNode;
     FallbackComponent?: (props: FallbackProps) => JSX.Element;
     onErrorBoundaryError?: (error: unknown, info: ErrorInfo) => void;
     componentName?: string;
 }
-export declare const BaseBoundaries: ({ children, FallbackComponent, onErrorBoundaryError, componentName, }: BaseBoundariesProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Composes the SDK's React error boundary, TanStack Query reset boundary, and Suspense fallback around children.
+ *
+ * @remarks
+ * Resetting the error boundary also resets any TanStack Query errors so suspended queries refetch
+ * cleanly. While children suspend, a metrics-instrumented loading indicator is rendered that emits
+ * an `sdk.component.loading_duration` observability metric on unmount.
+ *
+ * @param props - Component props matching {@link BaseBoundariesProps}.
+ * @returns A React element wrapping `children` with the SDK's error and suspense boundaries.
+ * @internal
+ */
+export declare const BaseBoundaries: ({ children, FallbackComponent, onErrorBoundaryError, componentName, }: BaseBoundariesProps) => JSX.Element;
 export {};

package/dist/components/Base/Base.js

@@ -7,13 +7,12 @@ import { FadeIn as I } from "../Common/FadeIn/FadeIn.js";
 import { BaseContext as R } from "./useBase.js";
 import { useBaseSubmit as x } from "./useBaseSubmit.js";
 import { componentEvents as D } from "../../shared/constants.js";
-import "classnames";
 import { InternalError as f } from "../Common/InternalError/InternalError.js";
 import { useComponentContext as g } from "../../contexts/ComponentAdapter/useComponentContext.js";
 import { useLoadingIndicator as d } from "../../contexts/LoadingIndicatorProvider/useLoadingIndicator.js";
 import { useObservability as E } from "../../contexts/ObservabilityProvider/useObservability.js";
 import { normalizeToSDKError as F } from "../../types/sdkError.js";
-const N = ({
+const $ = ({
   children: r,
   FallbackComponent: t = f,
   LoaderComponent: s,
@@ -142,7 +141,7 @@ const _ = ({
 ) });
 export {
   _ as BaseBoundaries,
-  N as BaseComponent,
+  $ as BaseComponent,
   j as BaseLayout
 };
 //# sourceMappingURL=Base.js.map

package/dist/components/Base/Base.js.map

@@ -1 +1 @@
-{"version":3,"file":"Base.js","sources":["../../../src/components/Base/Base.tsx"],"sourcesContent":["import type { ReactNode, JSX, ErrorInfo } from 'react'\nimport { Suspense, useEffect, useRef } from 'react'\nimport type { FallbackProps } from 'react-error-boundary'\nimport { ErrorBoundary } from 'react-error-boundary'\nimport { useTranslation } from 'react-i18next'\nimport { QueryErrorResetBoundary } from '@tanstack/react-query'\nimport { FadeIn } from '../Common/FadeIn/FadeIn'\nimport { BaseContext, type OnEventType } from './useBase'\nimport { useBaseSubmit } from './useBaseSubmit'\nimport { componentEvents, type EventType } from '@/shared/constants'\nimport { InternalError } from '@/components/Common'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport type { ResourceDictionary, Resources } from '@/types/Helpers'\nimport { useLoadingIndicator } from '@/contexts/LoadingIndicatorProvider/useLoadingIndicator'\nimport type { LoadingIndicatorContextProps } from '@/contexts/LoadingIndicatorProvider/useLoadingIndicator'\nimport { useObservability } from '@/contexts/ObservabilityProvider/useObservability'\nimport { normalizeToSDKError, type SDKError } from '@/types/sdkError'\n\nexport interface CommonComponentInterface<TResourceKey extends keyof Resources = keyof Resources> {\n  children?: ReactNode\n  className?: string\n  defaultValues?: unknown\n  dictionary?: ResourceDictionary<TResourceKey>\n}\n\nexport interface BaseComponentInterface<\n  TResourceKey extends keyof Resources = keyof Resources,\n> extends CommonComponentInterface<TResourceKey> {\n  FallbackComponent?: BaseBoundariesProps['FallbackComponent']\n  LoaderComponent?: LoadingIndicatorContextProps['LoadingIndicator']\n  onEvent: OnEventType<EventType, unknown>\n}\n\ninterface InternalBaseComponentProps {\n  componentName?: string\n}\n\nexport const BaseComponent = <TResourceKey extends keyof Resources = keyof Resources>({\n  children,\n  FallbackComponent = InternalError,\n  LoaderComponent: LoadingIndicatorFromProps,\n  onEvent,\n  componentName,\n}: BaseComponentInterface<TResourceKey> & InternalBaseComponentProps) => {\n  const { error, baseSubmitHandler, setError } = useBaseSubmit(componentName)\n  const { observability } = useObservability()\n\n  const { LoadingIndicator: LoadingIndicatorFromContext } = useLoadingIndicator()\n  const LoaderComponent = LoadingIndicatorFromProps ?? LoadingIndicatorFromContext\n\n  const onErrorBoundaryError = (boundaryError: unknown, errorInfo: ErrorInfo) => {\n    onEvent(componentEvents.ERROR, boundaryError)\n\n    const sdkError = normalizeToSDKError(boundaryError)\n\n    observability?.onError?.({\n      ...sdkError,\n      timestamp: Date.now(),\n      componentName,\n      componentStack: errorInfo.componentStack ?? undefined,\n    })\n  }\n\n  return (\n    <BaseContext.Provider\n      value={{\n        error,\n        setError,\n        onEvent,\n        baseSubmitHandler,\n        LoadingIndicator: LoaderComponent,\n        componentName,\n      }}\n    >\n      <BaseBoundaries\n        FallbackComponent={FallbackComponent}\n        onErrorBoundaryError={onErrorBoundaryError}\n        componentName={componentName}\n      >\n        <BaseLayout error={error}>{children}</BaseLayout>\n      </BaseBoundaries>\n    </BaseContext.Provider>\n  )\n}\n\nexport interface BaseLayoutProps {\n  children?: ReactNode\n  error?: SDKError | SDKError[] | null\n  isLoading?: boolean\n}\n\nfunction SingleErrorContent({ error }: { error: SDKError }) {\n  const Components = useComponentContext()\n  const { t } = useTranslation()\n  const hasFieldErrors = error.fieldErrors.length > 0\n\n  return (\n    <Components.Alert label={t('status.errorEncountered')} status=\"error\">\n      {hasFieldErrors && (\n        <Components.UnorderedList\n          items={error.fieldErrors\n            .filter(fieldError => fieldError.message)\n            .map(fieldError => (\n              <span key={fieldError.field}>{fieldError.message}</span>\n            ))}\n        />\n      )}\n      {!hasFieldErrors && error.category === 'validation_error' && (\n        <Components.Text as=\"pre\">\n          {error.raw &&\n          typeof error.raw === 'object' &&\n          'pretty' in error.raw &&\n          typeof (error.raw as { pretty: unknown }).pretty === 'function'\n            ? (error.raw as { pretty: () => string }).pretty()\n            : error.message}\n        </Components.Text>\n      )}\n      {!hasFieldErrors && error.category !== 'validation_error' && (\n        <Components.Text>{error.message || t('errors.unknownError')}</Components.Text>\n      )}\n    </Components.Alert>\n  )\n}\n\nfunction MultipleErrorsContent({ errors }: { errors: SDKError[] }) {\n  const Components = useComponentContext()\n  const { t } = useTranslation()\n\n  return (\n    <Components.Alert label={t('status.multipleErrorsEncountered')} status=\"error\">\n      <Components.UnorderedList\n        items={errors\n          .filter(error => error.message || error.fieldErrors.length > 0)\n          .map((error, index) => {\n            const visibleFieldErrors = error.fieldErrors.filter(fieldError => fieldError.message)\n\n            if (visibleFieldErrors.length === 0) {\n              return <span key={index}>{error.message || t('errors.unknownError')}</span>\n            }\n\n            return (\n              <span key={index}>\n                {error.message || t('errors.unknownError')}\n                <Components.UnorderedList\n                  items={visibleFieldErrors.map(fieldError => (\n                    <span key={fieldError.field}>{fieldError.message}</span>\n                  ))}\n                />\n              </span>\n            )\n          })}\n      />\n    </Components.Alert>\n  )\n}\n\nexport const BaseLayout = ({ children, error, isLoading }: BaseLayoutProps) => {\n  const { LoadingIndicator } = useLoadingIndicator()\n\n  const errors = Array.isArray(error) ? error : error ? [error] : []\n  const hasErrors = errors.length > 0\n\n  if (isLoading && !hasErrors) {\n    return <LoadingIndicator />\n  }\n\n  const [firstError] = errors\n\n  return (\n    <FadeIn>\n      {errors.length > 1 && <MultipleErrorsContent errors={errors} />}\n      {errors.length === 1 && firstError && <SingleErrorContent error={firstError} />}\n      {children}\n    </FadeIn>\n  )\n}\n\ninterface LoaderWithMetricsProps {\n  LoaderComponent: LoadingIndicatorContextProps['LoadingIndicator']\n  observability: ReturnType<typeof useObservability>['observability']\n  componentName?: string\n}\n\nconst LoaderWithMetrics = ({\n  LoaderComponent,\n  observability,\n  componentName,\n}: LoaderWithMetricsProps) => {\n  const loadingStartTime = useRef(Date.now())\n  const observabilityRef = useRef(observability)\n  const componentNameRef = useRef(componentName)\n\n  useEffect(() => {\n    observabilityRef.current = observability\n    componentNameRef.current = componentName\n  }, [observability, componentName])\n\n  useEffect(() => {\n    return () => {\n      const duration = Date.now() - loadingStartTime.current\n      observabilityRef.current?.onMetric?.({\n        name: 'sdk.component.loading_duration',\n        value: duration,\n        unit: 'ms',\n        tags: componentNameRef.current ? { component: componentNameRef.current } : undefined,\n        timestamp: Date.now(),\n      })\n    }\n  }, [])\n\n  return <LoaderComponent />\n}\n\nfunction SuspenseFallback({ componentName }: { componentName?: string }) {\n  const { LoadingIndicator } = useLoadingIndicator()\n  const { observability } = useObservability()\n  return (\n    <LoaderWithMetrics\n      LoaderComponent={LoadingIndicator}\n      observability={observability}\n      componentName={componentName}\n    />\n  )\n}\n\nexport interface BaseBoundariesProps {\n  children?: ReactNode\n  FallbackComponent?: (props: FallbackProps) => JSX.Element\n  onErrorBoundaryError?: (error: unknown, info: ErrorInfo) => void\n  componentName?: string\n}\n\nexport const BaseBoundaries = ({\n  children,\n  FallbackComponent = InternalError,\n  onErrorBoundaryError,\n  componentName,\n}: BaseBoundariesProps) => {\n  return (\n    <QueryErrorResetBoundary>\n      {({ reset: resetQueries }) => (\n        <ErrorBoundary\n          FallbackComponent={FallbackComponent}\n          onReset={resetQueries}\n          onError={onErrorBoundaryError}\n        >\n          <Suspense fallback={<SuspenseFallback componentName={componentName} />}>\n            {children}\n          </Suspense>\n        </ErrorBoundary>\n      )}\n    </QueryErrorResetBoundary>\n  )\n}\n"],"names":["BaseComponent","children","FallbackComponent","InternalError","LoadingIndicatorFromProps","onEvent","componentName","error","baseSubmitHandler","setError","useBaseSubmit","observability","useObservability","LoadingIndicatorFromContext","useLoadingIndicator","LoaderComponent","onErrorBoundaryError","boundaryError","errorInfo","componentEvents","sdkError","normalizeToSDKError","jsx","BaseContext","BaseBoundaries","BaseLayout","SingleErrorContent","Components","useComponentContext","t","useTranslation","hasFieldErrors","jsxs","fieldError","MultipleErrorsContent","errors","index","visibleFieldErrors","isLoading","LoadingIndicator","hasErrors","firstError","FadeIn","LoaderWithMetrics","loadingStartTime","useRef","observabilityRef","componentNameRef","useEffect","duration","SuspenseFallback","QueryErrorResetBoundary","resetQueries","ErrorBoundary","Suspense"],"mappings":"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"}
+{"version":3,"file":"Base.js","sources":["../../../src/components/Base/Base.tsx"],"sourcesContent":["import type { ReactNode, JSX, ErrorInfo } from 'react'\nimport { Suspense, useEffect, useRef } from 'react'\nimport type { FallbackProps } from 'react-error-boundary'\nimport { ErrorBoundary } from 'react-error-boundary'\nimport { useTranslation } from 'react-i18next'\nimport { QueryErrorResetBoundary } from '@tanstack/react-query'\nimport { FadeIn } from '../Common/FadeIn/FadeIn'\nimport { BaseContext, type OnEventType } from './useBase'\nimport { useBaseSubmit } from './useBaseSubmit'\nimport { componentEvents, type EventType } from '@/shared/constants'\nimport { InternalError } from '@/components/Common'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport type { ResourceDictionary, Resources } from '@/types/Helpers'\nimport { useLoadingIndicator } from '@/contexts/LoadingIndicatorProvider/useLoadingIndicator'\nimport type { LoadingIndicatorContextProps } from '@/contexts/LoadingIndicatorProvider/useLoadingIndicator'\nimport { useObservability } from '@/contexts/ObservabilityProvider/useObservability'\nimport { normalizeToSDKError, type SDKError } from '@/types/sdkError'\n\n/**\n * Props common to all SDK feature components, including children, an optional className, default form values, and an i18n resource dictionary override.\n *\n * @typeParam TResourceKey - The i18n resource namespace key whose dictionary entries can be overridden.\n * @public\n */\nexport interface CommonComponentInterface<TResourceKey extends keyof Resources = keyof Resources> {\n  /** Optional child content rendered inside the component's layout. */\n  children?: ReactNode\n  /** CSS class name applied to the component's root element. */\n  className?: string\n  /**\n   * Initial values pre-populated into the component's form fields before the user interacts.\n   * The exact shape depends on the specific component — refer to each component's own props type.\n   */\n  defaultValues?: unknown\n  /**\n   * Overrides for the component's i18n strings. Supply a partial object whose keys match the\n   * component's resource namespace — any omitted keys fall back to SDK defaults.\n   * See the [Translation guide](https://docs.gusto.com/embedded-payroll/docs/translation) for details.\n   */\n  dictionary?: ResourceDictionary<TResourceKey>\n}\n\n/**\n * Props for SDK feature components that participate in the standard error/loading/observability surface.\n *\n * @remarks\n * Extends {@link CommonComponentInterface} with the `onEvent` callback that emits component events\n * and optional overrides for the error-boundary fallback and loading indicator. This is the prop\n * shape mixed into every public SDK feature component.\n *\n * @typeParam TResourceKey - The i18n resource namespace key whose dictionary entries can be overridden.\n * @public\n */\nexport interface BaseComponentInterface<\n  TResourceKey extends keyof Resources = keyof Resources,\n> extends CommonComponentInterface<TResourceKey> {\n  /**\n   * Custom React component rendered in place of the component when an unhandled error is caught\n   * by the component-level error boundary. Receives `error` and `resetErrorBoundary` as props.\n   * Defaults to the SDK's built-in `InternalError` fallback.\n   */\n  FallbackComponent?: BaseBoundariesProps['FallbackComponent']\n  /**\n   * Custom loading indicator rendered while the component's async data is fetching.\n   * Overrides the indicator configured on `GustoProvider` for this component instance only.\n   */\n  LoaderComponent?: LoadingIndicatorContextProps['LoadingIndicator']\n  /**\n   * Callback invoked each time the component emits an event — user interactions, successful API\n   * responses, step transitions, or errors. Receives the event type constant and an optional\n   * payload whose shape varies by event. See the [Event Handling guide](https://docs.gusto.com/embedded-payroll/docs/event-handling)\n   * and each component's event table for the full list of emitted events.\n   */\n  onEvent: OnEventType<EventType, unknown>\n}\n\ninterface InternalBaseComponentProps {\n  componentName?: string\n}\n\n/**\n * Wraps SDK feature components with the standard error boundary, suspense fallback, form-submission handler, and observability wiring.\n *\n * @remarks\n * Provides a {@link BaseContext} value to descendants exposing `error`, `setError`, `onEvent`, and\n * `baseSubmitHandler`, then renders children inside {@link BaseBoundaries} and {@link BaseLayout}.\n * Errors caught by the React error boundary are normalized, emitted to observability, and re-emitted\n * via `onEvent`.\n *\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `componentEvents.ERROR` | Emitted when an unhandled rendering error is caught by the component's error boundary | The raw error value caught by the boundary |\n *\n * @typeParam TResourceKey - The i18n resource namespace key whose dictionary entries can be overridden.\n * @param props - Component props extending {@link BaseComponentInterface}.\n * @returns A React element wrapping `children` with the SDK's standard error, loading, and event-emission surface.\n * @internal\n */\nexport const BaseComponent = <TResourceKey extends keyof Resources = keyof Resources>({\n  children,\n  FallbackComponent = InternalError,\n  LoaderComponent: LoadingIndicatorFromProps,\n  onEvent,\n  componentName,\n}: BaseComponentInterface<TResourceKey> & InternalBaseComponentProps) => {\n  const { error, baseSubmitHandler, setError } = useBaseSubmit(componentName)\n  const { observability } = useObservability()\n\n  const { LoadingIndicator: LoadingIndicatorFromContext } = useLoadingIndicator()\n  const LoaderComponent = LoadingIndicatorFromProps ?? LoadingIndicatorFromContext\n\n  const onErrorBoundaryError = (boundaryError: unknown, errorInfo: ErrorInfo) => {\n    onEvent(componentEvents.ERROR, boundaryError)\n\n    const sdkError = normalizeToSDKError(boundaryError)\n\n    observability?.onError?.({\n      ...sdkError,\n      timestamp: Date.now(),\n      componentName,\n      componentStack: errorInfo.componentStack ?? undefined,\n    })\n  }\n\n  return (\n    <BaseContext.Provider\n      value={{\n        error,\n        setError,\n        onEvent,\n        baseSubmitHandler,\n        LoadingIndicator: LoaderComponent,\n        componentName,\n      }}\n    >\n      <BaseBoundaries\n        FallbackComponent={FallbackComponent}\n        onErrorBoundaryError={onErrorBoundaryError}\n        componentName={componentName}\n      >\n        <BaseLayout error={error}>{children}</BaseLayout>\n      </BaseBoundaries>\n    </BaseContext.Provider>\n  )\n}\n\n/** @internal */\nexport interface BaseLayoutProps {\n  children?: ReactNode\n  error?: SDKError | SDKError[] | null\n  isLoading?: boolean\n}\n\nfunction SingleErrorContent({ error }: { error: SDKError }) {\n  const Components = useComponentContext()\n  const { t } = useTranslation()\n  const hasFieldErrors = error.fieldErrors.length > 0\n\n  return (\n    <Components.Alert label={t('status.errorEncountered')} status=\"error\">\n      {hasFieldErrors && (\n        <Components.UnorderedList\n          items={error.fieldErrors\n            .filter(fieldError => fieldError.message)\n            .map(fieldError => (\n              <span key={fieldError.field}>{fieldError.message}</span>\n            ))}\n        />\n      )}\n      {!hasFieldErrors && error.category === 'validation_error' && (\n        <Components.Text as=\"pre\">\n          {error.raw &&\n          typeof error.raw === 'object' &&\n          'pretty' in error.raw &&\n          typeof (error.raw as { pretty: unknown }).pretty === 'function'\n            ? (error.raw as { pretty: () => string }).pretty()\n            : error.message}\n        </Components.Text>\n      )}\n      {!hasFieldErrors && error.category !== 'validation_error' && (\n        <Components.Text>{error.message || t('errors.unknownError')}</Components.Text>\n      )}\n    </Components.Alert>\n  )\n}\n\nfunction MultipleErrorsContent({ errors }: { errors: SDKError[] }) {\n  const Components = useComponentContext()\n  const { t } = useTranslation()\n\n  return (\n    <Components.Alert label={t('status.multipleErrorsEncountered')} status=\"error\">\n      <Components.UnorderedList\n        items={errors\n          .filter(error => error.message || error.fieldErrors.length > 0)\n          .map((error, index) => {\n            const visibleFieldErrors = error.fieldErrors.filter(fieldError => fieldError.message)\n\n            if (visibleFieldErrors.length === 0) {\n              return <span key={index}>{error.message || t('errors.unknownError')}</span>\n            }\n\n            return (\n              <span key={index}>\n                {error.message || t('errors.unknownError')}\n                <Components.UnorderedList\n                  items={visibleFieldErrors.map(fieldError => (\n                    <span key={fieldError.field}>{fieldError.message}</span>\n                  ))}\n                />\n              </span>\n            )\n          })}\n      />\n    </Components.Alert>\n  )\n}\n\n/**\n * Renders the standard SDK layout with normalized error display, suspense-aware loading state, and the children content.\n *\n * @remarks\n * When `isLoading` is true and there are no errors, renders the configured loading indicator.\n * Otherwise renders a fade-in wrapper that displays a single error alert, an aggregated alert when\n * multiple errors are present, or no alert when errors are absent. Field-level errors are rendered\n * as a list, validation errors as preformatted Zod output, and all other errors as a generic\n * message — see {@link https://github.com/Gusto/embedded-react-sdk/blob/main/docs/integration-guide/error-handling.md | the Error Handling guide}.\n *\n * @param props - Component props matching {@link BaseLayoutProps}.\n * @returns A React element with the SDK's standard error rendering and loading behavior wrapped around `children`.\n * @internal\n */\nexport const BaseLayout = ({ children, error, isLoading }: BaseLayoutProps) => {\n  const { LoadingIndicator } = useLoadingIndicator()\n\n  const errors = Array.isArray(error) ? error : error ? [error] : []\n  const hasErrors = errors.length > 0\n\n  if (isLoading && !hasErrors) {\n    return <LoadingIndicator />\n  }\n\n  const [firstError] = errors\n\n  return (\n    <FadeIn>\n      {errors.length > 1 && <MultipleErrorsContent errors={errors} />}\n      {errors.length === 1 && firstError && <SingleErrorContent error={firstError} />}\n      {children}\n    </FadeIn>\n  )\n}\n\ninterface LoaderWithMetricsProps {\n  LoaderComponent: LoadingIndicatorContextProps['LoadingIndicator']\n  observability: ReturnType<typeof useObservability>['observability']\n  componentName?: string\n}\n\nconst LoaderWithMetrics = ({\n  LoaderComponent,\n  observability,\n  componentName,\n}: LoaderWithMetricsProps) => {\n  const loadingStartTime = useRef(Date.now())\n  const observabilityRef = useRef(observability)\n  const componentNameRef = useRef(componentName)\n\n  useEffect(() => {\n    observabilityRef.current = observability\n    componentNameRef.current = componentName\n  }, [observability, componentName])\n\n  useEffect(() => {\n    return () => {\n      const duration = Date.now() - loadingStartTime.current\n      observabilityRef.current?.onMetric?.({\n        name: 'sdk.component.loading_duration',\n        value: duration,\n        unit: 'ms',\n        tags: componentNameRef.current ? { component: componentNameRef.current } : undefined,\n        timestamp: Date.now(),\n      })\n    }\n  }, [])\n\n  return <LoaderComponent />\n}\n\nfunction SuspenseFallback({ componentName }: { componentName?: string }) {\n  const { LoadingIndicator } = useLoadingIndicator()\n  const { observability } = useObservability()\n  return (\n    <LoaderWithMetrics\n      LoaderComponent={LoadingIndicator}\n      observability={observability}\n      componentName={componentName}\n    />\n  )\n}\n\n/** @internal */\nexport interface BaseBoundariesProps {\n  children?: ReactNode\n  FallbackComponent?: (props: FallbackProps) => JSX.Element\n  onErrorBoundaryError?: (error: unknown, info: ErrorInfo) => void\n  componentName?: string\n}\n\n/**\n * Composes the SDK's React error boundary, TanStack Query reset boundary, and Suspense fallback around children.\n *\n * @remarks\n * Resetting the error boundary also resets any TanStack Query errors so suspended queries refetch\n * cleanly. While children suspend, a metrics-instrumented loading indicator is rendered that emits\n * an `sdk.component.loading_duration` observability metric on unmount.\n *\n * @param props - Component props matching {@link BaseBoundariesProps}.\n * @returns A React element wrapping `children` with the SDK's error and suspense boundaries.\n * @internal\n */\nexport const BaseBoundaries = ({\n  children,\n  FallbackComponent = InternalError,\n  onErrorBoundaryError,\n  componentName,\n}: BaseBoundariesProps) => {\n  return (\n    <QueryErrorResetBoundary>\n      {({ reset: resetQueries }) => (\n        <ErrorBoundary\n          FallbackComponent={FallbackComponent}\n          onReset={resetQueries}\n          onError={onErrorBoundaryError}\n        >\n          <Suspense fallback={<SuspenseFallback componentName={componentName} />}>\n            {children}\n          </Suspense>\n        </ErrorBoundary>\n      )}\n    </QueryErrorResetBoundary>\n  )\n}\n"],"names":["BaseComponent","children","FallbackComponent","InternalError","LoadingIndicatorFromProps","onEvent","componentName","error","baseSubmitHandler","setError","useBaseSubmit","observability","useObservability","LoadingIndicatorFromContext","useLoadingIndicator","LoaderComponent","onErrorBoundaryError","boundaryError","errorInfo","componentEvents","sdkError","normalizeToSDKError","jsx","BaseContext","BaseBoundaries","BaseLayout","SingleErrorContent","Components","useComponentContext","t","useTranslation","hasFieldErrors","jsxs","fieldError","MultipleErrorsContent","errors","index","visibleFieldErrors","isLoading","LoadingIndicator","hasErrors","firstError","FadeIn","LoaderWithMetrics","loadingStartTime","useRef","observabilityRef","componentNameRef","useEffect","duration","SuspenseFallback","QueryErrorResetBoundary","resetQueries","ErrorBoundary","Suspense"],"mappings":";;;;;;;;;;;;;;AAkGO,MAAMA,IAAgB,CAAyD;AAAA,EACpF,UAAAC;AAAA,EACA,mBAAAC,IAAoBC;AAAA,EACpB,iBAAiBC;AAAA,EACjB,SAAAC;AAAA,EACA,eAAAC;AACF,MAAyE;AACvE,QAAM,EAAE,OAAAC,GAAO,mBAAAC,GAAmB,UAAAC,EAAA,IAAaC,EAAcJ,CAAa,GACpE,EAAE,eAAAK,EAAA,IAAkBC,EAAA,GAEpB,EAAE,kBAAkBC,EAAA,IAAgCC,EAAA,GACpDC,IAAkBX,KAA6BS,GAE/CG,IAAuB,CAACC,GAAwBC,MAAyB;AAC7E,IAAAb,EAAQc,EAAgB,OAAOF,CAAa;AAE5C,UAAMG,IAAWC,EAAoBJ,CAAa;AAElD,IAAAN,GAAe,UAAU;AAAA,MACvB,GAAGS;AAAA,MACH,WAAW,KAAK,IAAA;AAAA,MAChB,eAAAd;AAAA,MACA,gBAAgBY,EAAU,kBAAkB;AAAA,IAAA,CAC7C;AAAA,EACH;AAEA,SACE,gBAAAI;AAAA,IAACC,EAAY;AAAA,IAAZ;AAAA,MACC,OAAO;AAAA,QACL,OAAAhB;AAAA,QACA,UAAAE;AAAA,QACA,SAAAJ;AAAA,QACA,mBAAAG;AAAA,QACA,kBAAkBO;AAAA,QAClB,eAAAT;AAAA,MAAA;AAAA,MAGF,UAAA,gBAAAgB;AAAA,QAACE;AAAA,QAAA;AAAA,UACC,mBAAAtB;AAAA,UACA,sBAAAc;AAAA,UACA,eAAAV;AAAA,UAEA,UAAA,gBAAAgB,EAACG,GAAA,EAAW,OAAAlB,GAAe,UAAAN,EAAA,CAAS;AAAA,QAAA;AAAA,MAAA;AAAA,IACtC;AAAA,EAAA;AAGN;AASA,SAASyB,EAAmB,EAAE,OAAAnB,KAA8B;AAC1D,QAAMoB,IAAaC,EAAA,GACb,EAAE,GAAAC,EAAA,IAAMC,EAAA,GACRC,IAAiBxB,EAAM,YAAY,SAAS;AAElD,SACE,gBAAAyB,EAACL,EAAW,OAAX,EAAiB,OAAOE,EAAE,yBAAyB,GAAG,QAAO,SAC3D,UAAA;AAAA,IAAAE,KACC,gBAAAT;AAAA,MAACK,EAAW;AAAA,MAAX;AAAA,QACC,OAAOpB,EAAM,YACV,OAAO,CAAA0B,MAAcA,EAAW,OAAO,EACvC,IAAI,CAAAA,wBACF,QAAA,EAA6B,UAAAA,EAAW,QAAA,GAA9BA,EAAW,KAA2B,CAClD;AAAA,MAAA;AAAA,IAAA;AAAA,IAGN,CAACF,KAAkBxB,EAAM,aAAa,sBACrC,gBAAAe,EAACK,EAAW,MAAX,EAAgB,IAAG,OACjB,UAAApB,EAAM,OACP,OAAOA,EAAM,OAAQ,YACrB,YAAYA,EAAM,OAClB,OAAQA,EAAM,IAA4B,UAAW,aAChDA,EAAM,IAAiC,OAAA,IACxCA,EAAM,QAAA,CACZ;AAAA,IAED,CAACwB,KAAkBxB,EAAM,aAAa,sBACrC,gBAAAe,EAACK,EAAW,MAAX,EAAiB,UAAApB,EAAM,WAAWsB,EAAE,qBAAqB,EAAA,CAAE;AAAA,EAAA,GAEhE;AAEJ;AAEA,SAASK,EAAsB,EAAE,QAAAC,KAAkC;AACjE,QAAMR,IAAaC,EAAA,GACb,EAAE,GAAAC,EAAA,IAAMC,EAAA;AAEd,SACE,gBAAAR,EAACK,EAAW,OAAX,EAAiB,OAAOE,EAAE,kCAAkC,GAAG,QAAO,SACrE,UAAA,gBAAAP;AAAA,IAACK,EAAW;AAAA,IAAX;AAAA,MACC,OAAOQ,EACJ,OAAO,CAAA5B,MAASA,EAAM,WAAWA,EAAM,YAAY,SAAS,CAAC,EAC7D,IAAI,CAACA,GAAO6B,MAAU;AACrB,cAAMC,IAAqB9B,EAAM,YAAY,OAAO,CAAA0B,MAAcA,EAAW,OAAO;AAEpF,eAAII,EAAmB,WAAW,sBACxB,QAAA,EAAkB,UAAA9B,EAAM,WAAWsB,EAAE,qBAAqB,KAAhDO,CAAkD,sBAInE,QAAA,EACE,UAAA;AAAA,UAAA7B,EAAM,WAAWsB,EAAE,qBAAqB;AAAA,UACzC,gBAAAP;AAAA,YAACK,EAAW;AAAA,YAAX;AAAA,cACC,OAAOU,EAAmB,IAAI,CAAAJ,MAC5B,gBAAAX,EAAC,UAA6B,UAAAW,EAAW,WAA9BA,EAAW,KAA2B,CAClD;AAAA,YAAA;AAAA,UAAA;AAAA,QACH,EAAA,GANSG,CAOX;AAAA,MAEJ,CAAC;AAAA,IAAA;AAAA,EAAA,GAEP;AAEJ;AAgBO,MAAMX,IAAa,CAAC,EAAE,UAAAxB,GAAU,OAAAM,GAAO,WAAA+B,QAAiC;AAC7E,QAAM,EAAE,kBAAAC,EAAA,IAAqBzB,EAAA,GAEvBqB,IAAS,MAAM,QAAQ5B,CAAK,IAAIA,IAAQA,IAAQ,CAACA,CAAK,IAAI,CAAA,GAC1DiC,IAAYL,EAAO,SAAS;AAElC,MAAIG,KAAa,CAACE;AAChB,6BAAQD,GAAA,EAAiB;AAG3B,QAAM,CAACE,CAAU,IAAIN;AAErB,2BACGO,GAAA,EACE,UAAA;AAAA,IAAAP,EAAO,SAAS,KAAK,gBAAAb,EAACY,GAAA,EAAsB,QAAAC,GAAgB;AAAA,IAC5DA,EAAO,WAAW,KAAKM,KAAc,gBAAAnB,EAACI,GAAA,EAAmB,OAAOe,GAAY;AAAA,IAC5ExC;AAAA,EAAA,GACH;AAEJ,GAQM0C,IAAoB,CAAC;AAAA,EACzB,iBAAA5B;AAAA,EACA,eAAAJ;AAAA,EACA,eAAAL;AACF,MAA8B;AAC5B,QAAMsC,IAAmBC,EAAO,KAAK,IAAA,CAAK,GACpCC,IAAmBD,EAAOlC,CAAa,GACvCoC,IAAmBF,EAAOvC,CAAa;AAE7C,SAAA0C,EAAU,MAAM;AACd,IAAAF,EAAiB,UAAUnC,GAC3BoC,EAAiB,UAAUzC;AAAA,EAC7B,GAAG,CAACK,GAAeL,CAAa,CAAC,GAEjC0C,EAAU,MACD,MAAM;AACX,UAAMC,IAAW,KAAK,IAAA,IAAQL,EAAiB;AAC/C,IAAAE,EAAiB,SAAS,WAAW;AAAA,MACnC,MAAM;AAAA,MACN,OAAOG;AAAA,MACP,MAAM;AAAA,MACN,MAAMF,EAAiB,UAAU,EAAE,WAAWA,EAAiB,YAAY;AAAA,MAC3E,WAAW,KAAK,IAAA;AAAA,IAAI,CACrB;AAAA,EACH,GACC,CAAA,CAAE,qBAEGhC,GAAA,EAAgB;AAC1B;AAEA,SAASmC,EAAiB,EAAE,eAAA5C,KAA6C;AACvE,QAAM,EAAE,kBAAAiC,EAAA,IAAqBzB,EAAA,GACvB,EAAE,eAAAH,EAAA,IAAkBC,EAAA;AAC1B,SACE,gBAAAU;AAAA,IAACqB;AAAA,IAAA;AAAA,MACC,iBAAiBJ;AAAA,MACjB,eAAA5B;AAAA,MACA,eAAAL;AAAA,IAAA;AAAA,EAAA;AAGN;AAsBO,MAAMkB,IAAiB,CAAC;AAAA,EAC7B,UAAAvB;AAAA,EACA,mBAAAC,IAAoBC;AAAA,EACpB,sBAAAa;AAAA,EACA,eAAAV;AACF,wBAEK6C,GAAA,EACE,UAAA,CAAC,EAAE,OAAOC,QACT,gBAAA9B;AAAA,EAAC+B;AAAA,EAAA;AAAA,IACC,mBAAAnD;AAAA,IACA,SAASkD;AAAA,IACT,SAASpC;AAAA,IAET,4BAACsC,GAAA,EAAS,4BAAWJ,GAAA,EAAiB,eAAA5C,GAA8B,GACjE,UAAAL,EAAA,CACH;AAAA,EAAA;AAAA,GAGN;"}

package/dist/components/Base/createCompoundContext.d.ts

@@ -1 +1,15 @@
+/**
+ * Creates a React context paired with a hook that throws if used outside of its provider.
+ *
+ * @remarks
+ * Used to build compound components that share state between a top-level container and its
+ * subcomponents. The returned hook reads the context value and throws an error referencing
+ * `contextName` when no provider is mounted, eliminating the need for a null-check at each call site.
+ *
+ * @typeParam T - The shape of the context value.
+ * @param contextName - Human-readable name used in the error message when the hook is called outside a provider.
+ * @param defaultValue - Optional default value for the underlying context; defaults to `null`.
+ * @returns A tuple of `[useContext, Provider]` where `useContext` reads the value or throws, and `Provider` is the React context provider component.
+ * @internal
+ */
 export declare function createCompoundContext<T>(contextName: string, defaultValue?: T | null): readonly [() => NonNullable<T>, import('react').Provider<T | null>];

package/dist/components/Base/createCompoundContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"createCompoundContext.js","sources":["../../../src/components/Base/createCompoundContext.tsx"],"sourcesContent":["import { createContext, useContext } from 'react'\n\nexport function createCompoundContext<T>(contextName: string, defaultValue: T | null = null) {\n  const context = createContext(defaultValue)\n\n  const useCompoundContext = () => {\n    const ctx = useContext(context)\n    if (!ctx) {\n      throw new Error(`${contextName} must be used within its Provider.`)\n    }\n    return ctx\n  }\n\n  return [useCompoundContext, context.Provider] as const\n}\n"],"names":["createCompoundContext","contextName","defaultValue","context","createContext","ctx","useContext"],"mappings":";AAEO,SAASA,EAAyBC,GAAqBC,IAAyB,MAAM;AAC3F,QAAMC,IAAUC,EAAcF,CAAY;AAU1C,SAAO,CARoB,MAAM;AAC/B,UAAMG,IAAMC,EAAWH,CAAO;AAC9B,QAAI,CAACE;AACH,YAAM,IAAI,MAAM,GAAGJ,CAAW,oCAAoC;AAEpE,WAAOI;AAAA,EACT,GAE4BF,EAAQ,QAAQ;AAC9C;"}
+{"version":3,"file":"createCompoundContext.js","sources":["../../../src/components/Base/createCompoundContext.tsx"],"sourcesContent":["import { createContext, useContext } from 'react'\n\n/**\n * Creates a React context paired with a hook that throws if used outside of its provider.\n *\n * @remarks\n * Used to build compound components that share state between a top-level container and its\n * subcomponents. The returned hook reads the context value and throws an error referencing\n * `contextName` when no provider is mounted, eliminating the need for a null-check at each call site.\n *\n * @typeParam T - The shape of the context value.\n * @param contextName - Human-readable name used in the error message when the hook is called outside a provider.\n * @param defaultValue - Optional default value for the underlying context; defaults to `null`.\n * @returns A tuple of `[useContext, Provider]` where `useContext` reads the value or throws, and `Provider` is the React context provider component.\n * @internal\n */\nexport function createCompoundContext<T>(contextName: string, defaultValue: T | null = null) {\n  const context = createContext(defaultValue)\n\n  const useCompoundContext = () => {\n    const ctx = useContext(context)\n    if (!ctx) {\n      throw new Error(`${contextName} must be used within its Provider.`)\n    }\n    return ctx\n  }\n\n  return [useCompoundContext, context.Provider] as const\n}\n"],"names":["createCompoundContext","contextName","defaultValue","context","createContext","ctx","useContext"],"mappings":";AAgBO,SAASA,EAAyBC,GAAqBC,IAAyB,MAAM;AAC3F,QAAMC,IAAUC,EAAcF,CAAY;AAU1C,SAAO,CARoB,MAAM;AAC/B,UAAMG,IAAMC,EAAWH,CAAO;AAC9B,QAAI,CAACE;AACH,YAAM,IAAI,MAAM,GAAGJ,CAAW,oCAAoC;AAEpE,WAAOI;AAAA,EACT,GAE4BF,EAAQ,QAAQ;AAC9C;"}

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

@@ -1,4 +1,4 @@
 import "./types/i18next.d.ts"
-export { BaseComponent, BaseBoundaries, BaseLayout, type BaseComponentInterface, type BaseLayoutProps, type BaseBoundariesProps, type CommonComponentInterface, } from './Base';
+export { BaseComponent, BaseBoundaries, BaseLayout, type BaseComponentInterface, type CommonComponentInterface, } from './Base';
 export { createCompoundContext } from './createCompoundContext';
 export { useBase } from './useBase';

package/dist/components/Base/useBase.d.ts

@@ -1,6 +1,19 @@
 import { EventType } from '../../shared/constants';
 import { LoadingIndicatorContextProps } from '../../contexts/LoadingIndicatorProvider/useLoadingIndicator';
 import { SDKError } from '../../types/sdkError';
+/**
+ * Callback signature for an SDK component event emitter, invoked with an event key and optional payload.
+ *
+ * @remarks
+ * Supply a function of this shape as the `onEvent` prop on any SDK feature component.
+ * The `type` argument is always one of the constants from `componentEvents`. The `data`
+ * argument is event-specific — some events carry no payload while others include the full
+ * API response body. Refer to each component's event table for details.
+ *
+ * @typeParam K - The discriminating event-key type, typically a {@link componentEvents} member.
+ * @typeParam T - The shape of the optional event payload.
+ * @public
+ */
 export type OnEventType<K, T> = (type: K, data?: T) => void;
 interface BaseContextProps {
     error: SDKError | null;
@@ -10,6 +23,18 @@ interface BaseContextProps {
     LoadingIndicator: LoadingIndicatorContextProps['LoadingIndicator'];
     componentName?: string;
 }
+/**
+ * React context holding the shared error state, submit handler, event emitter, and loading indicator provided by {@link BaseComponent}.
+ *
+ * @internal
+ */
 export declare const BaseContext: import('react').Context<BaseContextProps | undefined>;
+/**
+ * Reads the {@link BaseContext} value provided by {@link BaseComponent}, throwing if used outside one.
+ *
+ * @returns The context value containing `error`, `setError`, `onEvent`, `baseSubmitHandler`, `LoadingIndicator`, and the optional `componentName`.
+ * @throws Throws an `Error` when called outside of a {@link BaseComponent} (or other `BaseContext.Provider`) subtree.
+ * @internal
+ */
 export declare const useBase: () => BaseContextProps;
 export {};

package/dist/components/Base/useBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBase.js","sources":["../../../src/components/Base/useBase.tsx"],"sourcesContent":["import { createContext, useContext } from 'react'\nimport { type EventType } from '@/shared/constants'\nimport type { LoadingIndicatorContextProps } from '@/contexts/LoadingIndicatorProvider/useLoadingIndicator'\nimport type { SDKError } from '@/types/sdkError'\n\nexport type OnEventType<K, T> = (type: K, data?: T) => void\n\ninterface BaseContextProps {\n  error: SDKError | null\n  setError: (err: SDKError | null) => void\n  onEvent: OnEventType<EventType, unknown>\n  baseSubmitHandler: <T>(\n    formData: T,\n    componentHandler: (payload: T) => Promise<void>,\n  ) => Promise<void>\n  LoadingIndicator: LoadingIndicatorContextProps['LoadingIndicator']\n  componentName?: string\n}\n\nexport const BaseContext = createContext<BaseContextProps | undefined>(undefined)\n\nexport const useBase = () => {\n  const context = useContext(BaseContext)\n  if (!context) {\n    throw new Error('useBase must be used within a BaseProvider')\n  }\n  return context\n}\n"],"names":["BaseContext","createContext","useBase","context","useContext"],"mappings":";AAmBO,MAAMA,IAAcC,EAA4C,MAAS,GAEnEC,IAAU,MAAM;AAC3B,QAAMC,IAAUC,EAAWJ,CAAW;AACtC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,4CAA4C;AAE9D,SAAOA;AACT;"}
+{"version":3,"file":"useBase.js","sources":["../../../src/components/Base/useBase.tsx"],"sourcesContent":["import { createContext, useContext } from 'react'\nimport { type EventType } from '@/shared/constants'\nimport type { LoadingIndicatorContextProps } from '@/contexts/LoadingIndicatorProvider/useLoadingIndicator'\nimport type { SDKError } from '@/types/sdkError'\n\n/**\n * Callback signature for an SDK component event emitter, invoked with an event key and optional payload.\n *\n * @remarks\n * Supply a function of this shape as the `onEvent` prop on any SDK feature component.\n * The `type` argument is always one of the constants from `componentEvents`. The `data`\n * argument is event-specific — some events carry no payload while others include the full\n * API response body. Refer to each component's event table for details.\n *\n * @typeParam K - The discriminating event-key type, typically a {@link componentEvents} member.\n * @typeParam T - The shape of the optional event payload.\n * @public\n */\nexport type OnEventType<K, T> = (type: K, data?: T) => void\n\ninterface BaseContextProps {\n  error: SDKError | null\n  setError: (err: SDKError | null) => void\n  onEvent: OnEventType<EventType, unknown>\n  baseSubmitHandler: <T>(\n    formData: T,\n    componentHandler: (payload: T) => Promise<void>,\n  ) => Promise<void>\n  LoadingIndicator: LoadingIndicatorContextProps['LoadingIndicator']\n  componentName?: string\n}\n\n/**\n * React context holding the shared error state, submit handler, event emitter, and loading indicator provided by {@link BaseComponent}.\n *\n * @internal\n */\nexport const BaseContext = createContext<BaseContextProps | undefined>(undefined)\n\n/**\n * Reads the {@link BaseContext} value provided by {@link BaseComponent}, throwing if used outside one.\n *\n * @returns The context value containing `error`, `setError`, `onEvent`, `baseSubmitHandler`, `LoadingIndicator`, and the optional `componentName`.\n * @throws Throws an `Error` when called outside of a {@link BaseComponent} (or other `BaseContext.Provider`) subtree.\n * @internal\n */\nexport const useBase = () => {\n  const context = useContext(BaseContext)\n  if (!context) {\n    throw new Error('useBase must be used within a BaseProvider')\n  }\n  return context\n}\n"],"names":["BaseContext","createContext","useBase","context","useContext"],"mappings":";AAqCO,MAAMA,IAAcC,EAA4C,MAAS,GASnEC,IAAU,MAAM;AAC3B,QAAMC,IAAUC,EAAWJ,CAAW;AACtC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,4CAA4C;AAE9D,SAAOA;AACT;"}

package/dist/components/Base/useBaseSubmit.d.ts

@@ -1,5 +1,20 @@
 import { SDKError } from '../../types/sdkError';
 type SubmitHandler<T> = (data: T) => Promise<void>;
+/**
+ * Provides the standard SDK form-submit wrapper with normalized error state and observability instrumentation.
+ *
+ * @remarks
+ * The returned `baseSubmitHandler` clears prior error state, awaits the caller's handler, normalizes
+ * any caught `APIError`, `SDKValidationError`, `UnprocessableEntityError`, `GustoEmbeddedError`, or
+ * `SDKInternalError` into an {@link SDKError}, and surfaces it on the `error` field. Any other thrown
+ * value is re-thrown asynchronously so the nearest React error boundary catches it. An
+ * `sdk.form.submit_duration` observability metric is emitted on every attempt, tagged with success or
+ * error status.
+ *
+ * @param componentName - Optional component identifier used to tag observability errors and metrics.
+ * @returns An object containing `baseSubmitHandler`, the current `error`, and `setError`.
+ * @internal
+ */
 export declare const useBaseSubmit: (componentName?: string) => {
     baseSubmitHandler: <T>(data: T, componentHandler: SubmitHandler<T>) => Promise<void>;
     error: SDKError | null;

package/dist/components/Base/useBaseSubmit.js

@@ -1,8 +1,8 @@
 import { useState as f, useCallback as m } from "react";
-import { APIError as E } from "@gusto/embedded-api/models/errors/apierror";
-import { GustoEmbeddedError as b } from "@gusto/embedded-api/models/errors/gustoembeddederror";
-import { SDKValidationError as d } from "@gusto/embedded-api/models/errors/sdkvalidationerror";
-import { UnprocessableEntityError as p } from "@gusto/embedded-api/models/errors/unprocessableentityerror";
+import { APIError as E } from "@gusto/embedded-api-v-2025-11-15/models/errors/apierror";
+import { GustoEmbeddedError as b } from "@gusto/embedded-api-v-2025-11-15/models/errors/gustoembeddederror";
+import { SDKValidationError as d } from "@gusto/embedded-api-v-2025-11-15/models/errors/sdkvalidationerror";
+import { UnprocessableEntityError as p } from "@gusto/embedded-api-v-2025-11-15/models/errors/unprocessableentityerror";
 import { useAsyncError as y } from "../../hooks/useAsyncError.js";
 import { useObservability as D } from "../../contexts/ObservabilityProvider/useObservability.js";
 import { normalizeToSDKError as S, SDKInternalError as w } from "../../types/sdkError.js";

package/dist/components/Base/useBaseSubmit.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBaseSubmit.js","sources":["../../../src/components/Base/useBaseSubmit.ts"],"sourcesContent":["import { useState, useCallback } from 'react'\nimport { APIError } from '@gusto/embedded-api/models/errors/apierror'\nimport { GustoEmbeddedError } from '@gusto/embedded-api/models/errors/gustoembeddederror'\nimport { SDKValidationError } from '@gusto/embedded-api/models/errors/sdkvalidationerror'\nimport { UnprocessableEntityError } from '@gusto/embedded-api/models/errors/unprocessableentityerror'\nimport { useAsyncError } from '@/hooks/useAsyncError'\nimport { useObservability } from '@/contexts/ObservabilityProvider/useObservability'\nimport { type SDKError, SDKInternalError, normalizeToSDKError } from '@/types/sdkError'\n\ntype SubmitHandler<T> = (data: T) => Promise<void>\n\nexport const useBaseSubmit = (componentName?: string) => {\n  const [error, setError] = useState<SDKError | null>(null)\n  const throwError = useAsyncError()\n  const { observability } = useObservability()\n\n  const processError = useCallback(\n    (caughtError: GustoEmbeddedError | SDKValidationError | SDKInternalError) => {\n      const sdkError = normalizeToSDKError(caughtError)\n\n      setError(sdkError)\n\n      observability?.onError?.({ ...sdkError, timestamp: Date.now(), componentName })\n    },\n    [observability, componentName],\n  )\n\n  const baseSubmitHandler = useCallback(\n    async <T>(data: T, componentHandler: SubmitHandler<T>) => {\n      const startTime = Date.now()\n      setError(null)\n\n      let success = false\n\n      try {\n        await componentHandler(data)\n        success = true\n      } catch (err) {\n        if (\n          err instanceof APIError ||\n          err instanceof SDKValidationError ||\n          err instanceof UnprocessableEntityError ||\n          err instanceof GustoEmbeddedError ||\n          err instanceof SDKInternalError\n        ) {\n          processError(err)\n        } else throwError(err)\n      } finally {\n        const duration = Date.now() - startTime\n        observability?.onMetric?.({\n          name: 'sdk.form.submit_duration',\n          value: duration,\n          unit: 'ms',\n          tags: {\n            status: success ? 'success' : 'error',\n            ...(componentName && { component: componentName }),\n          },\n          timestamp: Date.now(),\n        })\n      }\n    },\n    [setError, throwError, observability, componentName, processError],\n  )\n\n  return {\n    baseSubmitHandler,\n    error,\n    setError,\n  }\n}\n"],"names":["useBaseSubmit","componentName","error","setError","useState","throwError","useAsyncError","observability","useObservability","processError","useCallback","caughtError","sdkError","normalizeToSDKError","data","componentHandler","startTime","success","err","APIError","SDKValidationError","UnprocessableEntityError","GustoEmbeddedError","SDKInternalError","duration"],"mappings":";;;;;;;;AAWO,MAAMA,IAAgB,CAACC,MAA2B;AACvD,QAAM,CAACC,GAAOC,CAAQ,IAAIC,EAA0B,IAAI,GAClDC,IAAaC,EAAA,GACb,EAAE,eAAAC,EAAA,IAAkBC,EAAA,GAEpBC,IAAeC;AAAA,IACnB,CAACC,MAA4E;AAC3E,YAAMC,IAAWC,EAAoBF,CAAW;AAEhD,MAAAR,EAASS,CAAQ,GAEjBL,GAAe,UAAU,EAAE,GAAGK,GAAU,WAAW,KAAK,OAAO,eAAAX,GAAe;AAAA,IAChF;AAAA,IACA,CAACM,GAAeN,CAAa;AAAA,EAAA;AAwC/B,SAAO;AAAA,IACL,mBAtCwBS;AAAA,MACxB,OAAUI,GAASC,MAAuC;AACxD,cAAMC,IAAY,KAAK,IAAA;AACvB,QAAAb,EAAS,IAAI;AAEb,YAAIc,IAAU;AAEd,YAAI;AACF,gBAAMF,EAAiBD,CAAI,GAC3BG,IAAU;AAAA,QACZ,SAASC,GAAK;AACZ,UACEA,aAAeC,KACfD,aAAeE,KACfF,aAAeG,KACfH,aAAeI,KACfJ,aAAeK,IAEfd,EAAaS,CAAG,MACAA,CAAG;AAAA,QACvB,UAAA;AACE,gBAAMM,IAAW,KAAK,IAAA,IAAQR;AAC9B,UAAAT,GAAe,WAAW;AAAA,YACxB,MAAM;AAAA,YACN,OAAOiB;AAAA,YACP,MAAM;AAAA,YACN,MAAM;AAAA,cACJ,QAAQP,IAAU,YAAY;AAAA,cAC9B,GAAIhB,KAAiB,EAAE,WAAWA,EAAA;AAAA,YAAc;AAAA,YAElD,WAAW,KAAK,IAAA;AAAA,UAAI,CACrB;AAAA,QACH;AAAA,MACF;AAAA,MACA,CAACE,GAAUE,GAAYE,GAAeN,GAAeQ,CAAY;AAAA,IAAA;AAAA,IAKjE,OAAAP;AAAA,IACA,UAAAC;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useBaseSubmit.js","sources":["../../../src/components/Base/useBaseSubmit.ts"],"sourcesContent":["import { useState, useCallback } from 'react'\nimport { APIError } from '@gusto/embedded-api-v-2025-11-15/models/errors/apierror'\nimport { GustoEmbeddedError } from '@gusto/embedded-api-v-2025-11-15/models/errors/gustoembeddederror'\nimport { SDKValidationError } from '@gusto/embedded-api-v-2025-11-15/models/errors/sdkvalidationerror'\nimport { UnprocessableEntityError } from '@gusto/embedded-api-v-2025-11-15/models/errors/unprocessableentityerror'\nimport { useAsyncError } from '@/hooks/useAsyncError'\nimport { useObservability } from '@/contexts/ObservabilityProvider/useObservability'\nimport { type SDKError, SDKInternalError, normalizeToSDKError } from '@/types/sdkError'\n\ntype SubmitHandler<T> = (data: T) => Promise<void>\n\n/**\n * Provides the standard SDK form-submit wrapper with normalized error state and observability instrumentation.\n *\n * @remarks\n * The returned `baseSubmitHandler` clears prior error state, awaits the caller's handler, normalizes\n * any caught `APIError`, `SDKValidationError`, `UnprocessableEntityError`, `GustoEmbeddedError`, or\n * `SDKInternalError` into an {@link SDKError}, and surfaces it on the `error` field. Any other thrown\n * value is re-thrown asynchronously so the nearest React error boundary catches it. An\n * `sdk.form.submit_duration` observability metric is emitted on every attempt, tagged with success or\n * error status.\n *\n * @param componentName - Optional component identifier used to tag observability errors and metrics.\n * @returns An object containing `baseSubmitHandler`, the current `error`, and `setError`.\n * @internal\n */\nexport const useBaseSubmit = (componentName?: string) => {\n  const [error, setError] = useState<SDKError | null>(null)\n  const throwError = useAsyncError()\n  const { observability } = useObservability()\n\n  const processError = useCallback(\n    (caughtError: GustoEmbeddedError | SDKValidationError | SDKInternalError) => {\n      const sdkError = normalizeToSDKError(caughtError)\n\n      setError(sdkError)\n\n      observability?.onError?.({ ...sdkError, timestamp: Date.now(), componentName })\n    },\n    [observability, componentName],\n  )\n\n  const baseSubmitHandler = useCallback(\n    async <T>(data: T, componentHandler: SubmitHandler<T>) => {\n      const startTime = Date.now()\n      setError(null)\n\n      let success = false\n\n      try {\n        await componentHandler(data)\n        success = true\n      } catch (err) {\n        if (\n          err instanceof APIError ||\n          err instanceof SDKValidationError ||\n          err instanceof UnprocessableEntityError ||\n          err instanceof GustoEmbeddedError ||\n          err instanceof SDKInternalError\n        ) {\n          processError(err)\n        } else throwError(err)\n      } finally {\n        const duration = Date.now() - startTime\n        observability?.onMetric?.({\n          name: 'sdk.form.submit_duration',\n          value: duration,\n          unit: 'ms',\n          tags: {\n            status: success ? 'success' : 'error',\n            ...(componentName && { component: componentName }),\n          },\n          timestamp: Date.now(),\n        })\n      }\n    },\n    [setError, throwError, observability, componentName, processError],\n  )\n\n  return {\n    baseSubmitHandler,\n    error,\n    setError,\n  }\n}\n"],"names":["useBaseSubmit","componentName","error","setError","useState","throwError","useAsyncError","observability","useObservability","processError","useCallback","caughtError","sdkError","normalizeToSDKError","data","componentHandler","startTime","success","err","APIError","SDKValidationError","UnprocessableEntityError","GustoEmbeddedError","SDKInternalError","duration"],"mappings":";;;;;;;;AA0BO,MAAMA,IAAgB,CAACC,MAA2B;AACvD,QAAM,CAACC,GAAOC,CAAQ,IAAIC,EAA0B,IAAI,GAClDC,IAAaC,EAAA,GACb,EAAE,eAAAC,EAAA,IAAkBC,EAAA,GAEpBC,IAAeC;AAAA,IACnB,CAACC,MAA4E;AAC3E,YAAMC,IAAWC,EAAoBF,CAAW;AAEhD,MAAAR,EAASS,CAAQ,GAEjBL,GAAe,UAAU,EAAE,GAAGK,GAAU,WAAW,KAAK,OAAO,eAAAX,GAAe;AAAA,IAChF;AAAA,IACA,CAACM,GAAeN,CAAa;AAAA,EAAA;AAwC/B,SAAO;AAAA,IACL,mBAtCwBS;AAAA,MACxB,OAAUI,GAASC,MAAuC;AACxD,cAAMC,IAAY,KAAK,IAAA;AACvB,QAAAb,EAAS,IAAI;AAEb,YAAIc,IAAU;AAEd,YAAI;AACF,gBAAMF,EAAiBD,CAAI,GAC3BG,IAAU;AAAA,QACZ,SAASC,GAAK;AACZ,UACEA,aAAeC,KACfD,aAAeE,KACfF,aAAeG,KACfH,aAAeI,KACfJ,aAAeK,IAEfd,EAAaS,CAAG,MACAA,CAAG;AAAA,QACvB,UAAA;AACE,gBAAMM,IAAW,KAAK,IAAA,IAAQR;AAC9B,UAAAT,GAAe,WAAW;AAAA,YACxB,MAAM;AAAA,YACN,OAAOiB;AAAA,YACP,MAAM;AAAA,YACN,MAAM;AAAA,cACJ,QAAQP,IAAU,YAAY;AAAA,cAC9B,GAAIhB,KAAiB,EAAE,WAAWA,EAAA;AAAA,YAAc;AAAA,YAElD,WAAW,KAAK,IAAA;AAAA,UAAI,CACrB;AAAA,QACH;AAAA,MACF;AAAA,MACA,CAACE,GAAUE,GAAYE,GAAeN,GAAeQ,CAAY;AAAA,IAAA;AAAA,IAKjE,OAAAP;AAAA,IACA,UAAAC;AAAA,EAAA;AAEJ;"}

package/dist/components/Common/ActionsLayout/ActionsLayout.d.ts

@@ -3,5 +3,6 @@ interface ActionsLayoutProps {
     children: React.ReactNode;
     justifyContent?: GridProps['justifyContent'];
 }
-export declare const ActionsLayout: ({ children, justifyContent }: ActionsLayoutProps) => import("react/jsx-runtime").JSX.Element;
+/** @internal */
+export declare const ActionsLayout: ({ children, justifyContent }: ActionsLayoutProps) => import("react").JSX.Element;
 export {};

package/dist/components/Common/ActionsLayout/ActionsLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActionsLayout.js","sources":["../../../../src/components/Common/ActionsLayout/ActionsLayout.tsx"],"sourcesContent":["import { Children } from 'react'\nimport { Grid, type GridProps } from '../Grid/Grid'\n\ninterface ActionsLayoutProps {\n  children: React.ReactNode\n  justifyContent?: GridProps['justifyContent']\n}\n\nexport const ActionsLayout = ({ children, justifyContent = 'end' }: ActionsLayoutProps) => {\n  const childrenArray = Children.toArray(children).filter(Boolean)\n  return (\n    <Grid\n      gridTemplateColumns={{\n        base: '1fr',\n        small: `repeat(${childrenArray.length}, max-content)`,\n      }}\n      justifyContent={justifyContent}\n      gap={12}\n    >\n      {children}\n    </Grid>\n  )\n}\n"],"names":["ActionsLayout","children","justifyContent","childrenArray","Children","jsx","Grid"],"mappings":";;;AAQO,MAAMA,IAAgB,CAAC,EAAE,UAAAC,GAAU,gBAAAC,IAAiB,YAAgC;AACzF,QAAMC,IAAgBC,EAAS,QAAQH,CAAQ,EAAE,OAAO,OAAO;AAC/D,SACE,gBAAAI;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,qBAAqB;AAAA,QACnB,MAAM;AAAA,QACN,OAAO,UAAUH,EAAc,MAAM;AAAA,MAAA;AAAA,MAEvC,gBAAAD;AAAA,MACA,KAAK;AAAA,MAEJ,UAAAD;AAAA,IAAA;AAAA,EAAA;AAGP;"}
+{"version":3,"file":"ActionsLayout.js","sources":["../../../../src/components/Common/ActionsLayout/ActionsLayout.tsx"],"sourcesContent":["import { Children } from 'react'\nimport { Grid, type GridProps } from '../Grid/Grid'\n\ninterface ActionsLayoutProps {\n  children: React.ReactNode\n  justifyContent?: GridProps['justifyContent']\n}\n\n/** @internal */\nexport const ActionsLayout = ({ children, justifyContent = 'end' }: ActionsLayoutProps) => {\n  const childrenArray = Children.toArray(children).filter(Boolean)\n  return (\n    <Grid\n      gridTemplateColumns={{\n        base: '1fr',\n        small: `repeat(${childrenArray.length}, max-content)`,\n      }}\n      justifyContent={justifyContent}\n      gap={12}\n    >\n      {children}\n    </Grid>\n  )\n}\n"],"names":["ActionsLayout","children","justifyContent","childrenArray","Children","jsx","Grid"],"mappings":";;;AASO,MAAMA,IAAgB,CAAC,EAAE,UAAAC,GAAU,gBAAAC,IAAiB,YAAgC;AACzF,QAAMC,IAAgBC,EAAS,QAAQH,CAAQ,EAAE,OAAO,OAAO;AAC/D,SACE,gBAAAI;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,qBAAqB;AAAA,QACnB,MAAM;AAAA,QACN,OAAO,UAAUH,EAAc,MAAM;AAAA,MAAA;AAAA,MAEvC,gBAAAD;AAAA,MACA,KAAK;AAAA,MAEJ,UAAAD;AAAA,IAAA;AAAA,EAAA;AAGP;"}

package/dist/components/Common/Alert/Alert.d.ts

@@ -1,3 +1,4 @@
+/** @internal */
 export interface AlertProps {
     variant?: 'info' | 'success' | 'warning' | 'error';
     label: string;
@@ -6,4 +7,5 @@ export interface AlertProps {
         title?: string;
     }>;
 }
-export declare function Alert({ label, children, variant, icon }: AlertProps): import("react/jsx-runtime").JSX.Element;
+/** @internal */
+export declare function Alert({ label, children, variant, icon }: AlertProps): import("react").JSX.Element;

package/dist/components/Common/DataView/DataCards/DataCards.d.ts

@@ -1,5 +1,6 @@
 import { useDataViewPropReturn, SelectionMode } from '../useDataView';
 import { TableProps } from '../../UI/Table/TableTypes';
+/** @internal */
 export type DataCardsProps<T> = {
     label: string;
     columns: useDataViewPropReturn<T>['columns'];
@@ -14,4 +15,5 @@ export type DataCardsProps<T> = {
     selectionMode?: SelectionMode;
     isWithinBox?: TableProps['isWithinBox'];
 };
-export declare const DataCards: <T>({ label, data, columns, itemMenu, onSelect, onSelectAll, getIsItemSelected, hideSelectAll, emptyState, footer, selectionMode, isWithinBox, }: DataCardsProps<T>) => import("react/jsx-runtime").JSX.Element;
+/** @internal */
+export declare const DataCards: <T>({ label, data, columns, itemMenu, onSelect, onSelectAll, getIsItemSelected, hideSelectAll, emptyState, footer, selectionMode, isWithinBox, }: DataCardsProps<T>) => import("react").JSX.Element;

package/dist/components/Common/DataView/DataCards/DataCards.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataCards.js","sources":["../../../../../src/components/Common/DataView/DataCards/DataCards.tsx"],"sourcesContent":["import { useId } from 'react'\nimport cn from 'classnames'\nimport { useTranslation } from 'react-i18next'\nimport styles from './DataCards.module.scss'\nimport type { useDataViewPropReturn, SelectionMode } from '@/components/Common/DataView/useDataView'\nimport type { TableProps } from '@/components/Common/UI/Table/TableTypes'\nimport { useSelectionState } from '@/components/Common/DataView/useSelectionState'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\nexport type DataCardsProps<T> = {\n  label: string\n  columns: useDataViewPropReturn<T>['columns']\n  data: useDataViewPropReturn<T>['data']\n  itemMenu?: useDataViewPropReturn<T>['itemMenu']\n  onSelect?: (item: T, checked: boolean) => void\n  onSelectAll?: (checked: boolean, visibleData: T[]) => void\n  getIsItemSelected?: (item: T) => boolean\n  hideSelectAll?: useDataViewPropReturn<T>['hideSelectAll']\n  emptyState?: useDataViewPropReturn<T>['emptyState']\n  footer?: useDataViewPropReturn<T>['footer']\n  selectionMode?: SelectionMode\n  isWithinBox?: TableProps['isWithinBox']\n}\n\nexport const DataCards = <T,>({\n  label,\n  data,\n  columns,\n  itemMenu,\n  onSelect,\n  onSelectAll,\n  getIsItemSelected,\n  hideSelectAll,\n  emptyState,\n  footer,\n  selectionMode = 'multiple',\n  isWithinBox,\n}: DataCardsProps<T>) => {\n  const Components = useComponentContext()\n  const { t } = useTranslation('common')\n  const radioGroupName = useId()\n  const { allSelected } = useSelectionState(data, getIsItemSelected)\n\n  const renderAction = (item: T, index: number) => {\n    if (!onSelect) return undefined\n\n    const isSelected = getIsItemSelected?.(item) ?? false\n\n    if (selectionMode === 'single') {\n      return (\n        <Components.Radio\n          name={radioGroupName}\n          value={isSelected}\n          onChange={() => {\n            onSelect(item, true)\n          }}\n          label={t('card.selectRowLabel')}\n          shouldVisuallyHideLabel\n        />\n      )\n    }\n\n    return (\n      <Components.Checkbox\n        value={isSelected}\n        onChange={(checked: boolean) => {\n          onSelect(item, checked)\n        }}\n        label={t('card.selectRowLabel')}\n        shouldVisuallyHideLabel\n      />\n    )\n  }\n\n  return (\n    <div className={cn(styles.root, isWithinBox && styles.withinBox)} data-testid=\"data-cards\">\n      {onSelect &&\n        getIsItemSelected &&\n        selectionMode === 'multiple' &&\n        !hideSelectAll &&\n        data.length > 0 && (\n          <div className={styles.selectAllRow}>\n            <Components.Checkbox\n              value={allSelected}\n              onChange={(checked: boolean) => onSelectAll?.(checked, data)}\n              label={t('card.selectAllRowsLabel')}\n            />\n          </div>\n        )}\n      <div role=\"list\" aria-label={label}>\n        {data.length === 0 && emptyState && (\n          <div role=\"listitem\">\n            <Components.Card className={isWithinBox ? styles.flushCard : undefined}>\n              {emptyState()}\n            </Components.Card>\n          </div>\n        )}\n        {data.map((item, index) => (\n          <div role=\"listitem\" key={index}>\n            <Components.Card\n              menu={itemMenu && itemMenu(item)}\n              action={renderAction(item, index)}\n              className={isWithinBox ? styles.flushCard : undefined}\n            >\n              {columns.map((column, colIndex) => (\n                <Flex key={colIndex} flexDirection=\"column\" gap={0}>\n                  {column.title && <h5 className={styles.columnTitle}>{column.title}</h5>}\n                  <div className={styles.columnData}>\n                    {' '}\n                    {column.render ? column.render(item) : String(item[column.key as keyof T])}\n                  </div>\n                </Flex>\n              ))}\n            </Components.Card>\n          </div>\n        ))}\n        {footer && (\n          <div role=\"listitem\">\n            <Components.Card className={isWithinBox ? styles.flushCard : undefined}>\n              {(() => {\n                const footerContent = footer()\n\n                return Object.entries(footerContent).map(([key, content]) => {\n                  const columnIndex = key.startsWith('column-')\n                    ? parseInt(key.replace('column-', ''), 10)\n                    : -1\n                  const columnTitle = columnIndex >= 0 ? columns[columnIndex]?.title : undefined\n\n                  return (\n                    <Flex key={key} flexDirection=\"column\" gap={0}>\n                      {columnTitle && <h5 className={styles.columnTitle}>{columnTitle}</h5>}\n                      <div className={styles.footerItem}>{content}</div>\n                    </Flex>\n                  )\n                })\n              })()}\n            </Components.Card>\n          </div>\n        )}\n      </div>\n    </div>\n  )\n}\n"],"names":["DataCards","label","data","columns","itemMenu","onSelect","onSelectAll","getIsItemSelected","hideSelectAll","emptyState","footer","selectionMode","isWithinBox","Components","useComponentContext","t","useTranslation","radioGroupName","useId","allSelected","useSelectionState","renderAction","item","index","isSelected","jsx","checked","jsxs","cn","styles","column","colIndex","Flex","footerContent","key","content","columnIndex","columnTitle"],"mappings":"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"}
+{"version":3,"file":"DataCards.js","sources":["../../../../../src/components/Common/DataView/DataCards/DataCards.tsx"],"sourcesContent":["import { useId } from 'react'\nimport cn from 'classnames'\nimport { useTranslation } from 'react-i18next'\nimport styles from './DataCards.module.scss'\nimport type { useDataViewPropReturn, SelectionMode } from '@/components/Common/DataView/useDataView'\nimport type { TableProps } from '@/components/Common/UI/Table/TableTypes'\nimport { useSelectionState } from '@/components/Common/DataView/useSelectionState'\nimport { Flex } from '@/components/Common/Flex/Flex'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\n/** @internal */\nexport type DataCardsProps<T> = {\n  label: string\n  columns: useDataViewPropReturn<T>['columns']\n  data: useDataViewPropReturn<T>['data']\n  itemMenu?: useDataViewPropReturn<T>['itemMenu']\n  onSelect?: (item: T, checked: boolean) => void\n  onSelectAll?: (checked: boolean, visibleData: T[]) => void\n  getIsItemSelected?: (item: T) => boolean\n  hideSelectAll?: useDataViewPropReturn<T>['hideSelectAll']\n  emptyState?: useDataViewPropReturn<T>['emptyState']\n  footer?: useDataViewPropReturn<T>['footer']\n  selectionMode?: SelectionMode\n  isWithinBox?: TableProps['isWithinBox']\n}\n\n/** @internal */\nexport const DataCards = <T,>({\n  label,\n  data,\n  columns,\n  itemMenu,\n  onSelect,\n  onSelectAll,\n  getIsItemSelected,\n  hideSelectAll,\n  emptyState,\n  footer,\n  selectionMode = 'multiple',\n  isWithinBox,\n}: DataCardsProps<T>) => {\n  const Components = useComponentContext()\n  const { t } = useTranslation('common')\n  const radioGroupName = useId()\n  const { allSelected } = useSelectionState(data, getIsItemSelected)\n\n  const renderAction = (item: T, index: number) => {\n    if (!onSelect) return undefined\n\n    const isSelected = getIsItemSelected?.(item) ?? false\n\n    if (selectionMode === 'single') {\n      return (\n        <Components.Radio\n          name={radioGroupName}\n          value={isSelected}\n          onChange={() => {\n            onSelect(item, true)\n          }}\n          label={t('card.selectRowLabel')}\n          shouldVisuallyHideLabel\n        />\n      )\n    }\n\n    return (\n      <Components.Checkbox\n        value={isSelected}\n        onChange={(checked: boolean) => {\n          onSelect(item, checked)\n        }}\n        label={t('card.selectRowLabel')}\n        shouldVisuallyHideLabel\n      />\n    )\n  }\n\n  return (\n    <div className={cn(styles.root, isWithinBox && styles.withinBox)} data-testid=\"data-cards\">\n      {onSelect &&\n        getIsItemSelected &&\n        selectionMode === 'multiple' &&\n        !hideSelectAll &&\n        data.length > 0 && (\n          <div className={styles.selectAllRow}>\n            <Components.Checkbox\n              value={allSelected}\n              onChange={(checked: boolean) => onSelectAll?.(checked, data)}\n              label={t('card.selectAllRowsLabel')}\n            />\n          </div>\n        )}\n      <div role=\"list\" aria-label={label}>\n        {data.length === 0 && emptyState && (\n          <div role=\"listitem\">\n            <Components.Card className={isWithinBox ? styles.flushCard : undefined}>\n              {emptyState()}\n            </Components.Card>\n          </div>\n        )}\n        {data.map((item, index) => (\n          <div role=\"listitem\" key={index}>\n            <Components.Card\n              menu={itemMenu && itemMenu(item)}\n              action={renderAction(item, index)}\n              className={isWithinBox ? styles.flushCard : undefined}\n            >\n              {columns.map((column, colIndex) => (\n                <Flex key={colIndex} flexDirection=\"column\" gap={0}>\n                  {column.title && <h5 className={styles.columnTitle}>{column.title}</h5>}\n                  <div className={styles.columnData}>\n                    {' '}\n                    {column.render ? column.render(item) : String(item[column.key as keyof T])}\n                  </div>\n                </Flex>\n              ))}\n            </Components.Card>\n          </div>\n        ))}\n        {footer && (\n          <div role=\"listitem\">\n            <Components.Card className={isWithinBox ? styles.flushCard : undefined}>\n              {(() => {\n                const footerContent = footer()\n\n                return Object.entries(footerContent).map(([key, content]) => {\n                  const columnIndex = key.startsWith('column-')\n                    ? parseInt(key.replace('column-', ''), 10)\n                    : -1\n                  const columnTitle = columnIndex >= 0 ? columns[columnIndex]?.title : undefined\n\n                  return (\n                    <Flex key={key} flexDirection=\"column\" gap={0}>\n                      {columnTitle && <h5 className={styles.columnTitle}>{columnTitle}</h5>}\n                      <div className={styles.footerItem}>{content}</div>\n                    </Flex>\n                  )\n                })\n              })()}\n            </Components.Card>\n          </div>\n        )}\n      </div>\n    </div>\n  )\n}\n"],"names":["DataCards","label","data","columns","itemMenu","onSelect","onSelectAll","getIsItemSelected","hideSelectAll","emptyState","footer","selectionMode","isWithinBox","Components","useComponentContext","t","useTranslation","radioGroupName","useId","allSelected","useSelectionState","renderAction","item","index","isSelected","jsx","checked","jsxs","cn","styles","column","colIndex","Flex","footerContent","key","content","columnIndex","columnTitle"],"mappings":"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"}

package/dist/components/Common/DataView/DataTable/DataTable.d.ts

@@ -1,5 +1,6 @@
 import { useDataViewPropReturn, SelectionMode } from '../useDataView';
 import { TableProps } from '../../UI/Table/TableTypes';
+/** @internal */
 export type DataTableProps<T> = {
     label: string;
     columns: useDataViewPropReturn<T>['columns'];
@@ -14,4 +15,5 @@ export type DataTableProps<T> = {
     isWithinBox?: TableProps['isWithinBox'];
     selectionMode?: SelectionMode;
 };
-export declare const DataTable: <T>({ label, data, columns, itemMenu, onSelect, onSelectAll, getIsItemSelected, hideSelectAll, emptyState, footer, isWithinBox, selectionMode, }: DataTableProps<T>) => import("react/jsx-runtime").JSX.Element;
+/** @internal */
+export declare const DataTable: <T>({ label, data, columns, itemMenu, onSelect, onSelectAll, getIsItemSelected, hideSelectAll, emptyState, footer, isWithinBox, selectionMode, }: DataTableProps<T>) => import("react").JSX.Element;