@gusto/embedded-react-sdk 0.51.2 → 0.52.1

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## [0.52.1](https://github.com/Gusto/embedded-react-sdk/compare/v0.52.0...v0.52.1) (2026-07-14)
+
+### Features & Enhancements
+
+- Contractor self-onboarding now mirrors the employee self-onboarding experience, giving contractors a guided flow to complete their own profile, address, and signature steps. ([#2385](https://github.com/Gusto/embedded-react-sdk/issues/2385))
+- The Contractor `Submit` step now lets contractors download their signed W-9. ([#2392](https://github.com/Gusto/embedded-react-sdk/issues/2392))
+
+### Fixes
+
+- The contractor new hire report is now only triggered during the initial onboarding pass, so re-editing an already-onboarded contractor no longer re-files the report. ([#2386](https://github.com/Gusto/embedded-react-sdk/issues/2386))
+
+### Chores & Maintenance
+
+- Bump dev dependencies (`storybook` and its addons to 10.5.0, `eslint`, `@eslint/js`, `@typescript-eslint/rule-tester`, `@typescript-eslint/utils`)
+- Bump dependencies (`dompurify`)
+
+## [0.52.0](https://github.com/Gusto/embedded-react-sdk/compare/v0.51.2...v0.52.0) (2026-07-10)
+
+### ⚠ Breaking Changes
+
+- **`@gusto/embedded-api` is now pinned to the dated `v2026-06-15` package** ([#2371](https://github.com/Gusto/embedded-react-sdk/issues/2371)). Update your dependency and imports from `@gusto/embedded-api-v-2026-02-01` to `@gusto/embedded-api-v-2026-06-15`.
+  - `EmployeeCompensations` money fields (`grossPay`, `netPay`, `checkAmount`) are now `string` instead of `number`.
+  - `@gusto/embedded-api/models/components/payroll` was renamed to `@gusto/embedded-api/models/components/payrollshow`.
+  - Company tax requirement records now report `setupStatus` instead of `setupComplete`.
+  - A few exports were renamed: `WageType` → `ContractorWageType`, `SortOrder` → `QueryParamSortOrder`, `Include` → `GetV1CompaniesCompanyIdEmployeesQueryParamInclude`, `ContractorOnboardingStatus1` → `OnboardingStatus`.
+- **`ApiProvider` and `ApiProviderProps` are no longer exported** ([#2376](https://github.com/Gusto/embedded-react-sdk/issues/2376)). If you composed the provider stack manually, use `GustoProvider` or `GustoProviderCustomUIAdapter` instead — both wrap `ApiProvider` internally.
+- **`ObservabilityProvider`, `useObservability`, `ObservabilityProviderProps`, and `ObservabilityContextValue` are no longer exported** ([#2376](https://github.com/Gusto/embedded-react-sdk/issues/2376)). Configure observability via the `observability` field on the `config` prop passed to `GustoProvider` / `GustoProviderCustomUIAdapter` instead.
+- **`GustoApiProps` (the props type for `GustoProvider`) was renamed to `GustoProviderProps`** ([#2376](https://github.com/Gusto/embedded-react-sdk/issues/2376)). The previous `GustoProviderProps` (props for `GustoProviderCustomUIAdapter`) was renamed to `GustoBaseProviderProps`. Update any direct references to these type names.
+
+### Features & Enhancements
+
+- Added `FormBox`, a UI primitive for grouping form sections, alongside the existing `Box` component. Override it via the component adapter like any other UI primitive. ([#2359](https://github.com/Gusto/embedded-react-sdk/issues/2359))
+- `StateTaxes` and `StateTaxesList` accept a new `showContinueButton` prop (defaults to `true`) to hide the Continue button when either is embedded as a step inside a larger flow with its own navigation. ([#2381](https://github.com/Gusto/embedded-react-sdk/issues/2381))
+
+### Fixes
+
+- `OnboardingSummary` now shows confirmation copy instead of a "Missing requirements" checklist when an employee has been invited to self-onboard, since those steps are owned by the employee rather than the admin. ([#2369](https://github.com/Gusto/embedded-react-sdk/issues/2369))
+- `Contractor.SignatureForm` now includes the "U.S. person" definition below the W-9 certification checklist. ([#2382](https://github.com/Gusto/embedded-react-sdk/issues/2382))
+
+### Chores & Maintenance
+
+- Bump dev dependencies (`@commitlint/cli`, `msw`, `prettier`, `ws`)
+- Bump dependencies (`i18next`, `react-i18next`)
+
 ## [0.51.2](https://github.com/Gusto/embedded-react-sdk/compare/v0.51.1...v0.51.2) (2026-07-07)
 
 ### Fixes

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

@@ -9,6 +9,7 @@ import { SDKError } from '../../types/sdkError';
  *
  * @typeParam TResourceKey - The i18n resource namespace key whose dictionary entries can be overridden.
  * @public
+ * @page workflows-and-blocks
  */
 export interface CommonComponentInterface<TResourceKey extends keyof Resources = keyof Resources> {
     /** Optional child content rendered inside the component's layout. */
@@ -37,6 +38,7 @@ export interface CommonComponentInterface<TResourceKey extends keyof Resources =
  *
  * @typeParam TResourceKey - The i18n resource namespace key whose dictionary entries can be overridden.
  * @public
+ * @page workflows-and-blocks
  */
 export interface BaseComponentInterface<TResourceKey extends keyof Resources = keyof Resources> extends CommonComponentInterface<TResourceKey> {
     /**

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\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?: (props: FallbackProps) => JSX.Element\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?: ({ children }: { children?: ReactNode }) => JSX.Element\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\n/**\n * Keys unique to the BaseComponentInterface\n *\n * @internal\n */\nexport type BaseComponentKeys = Exclude<\n  keyof BaseComponentInterface,\n  keyof CommonComponentInterface\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 * @events\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":"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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 * @page workflows-and-blocks\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 * @page workflows-and-blocks\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?: (props: FallbackProps) => JSX.Element\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?: ({ children }: { children?: ReactNode }) => JSX.Element\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\n/**\n * Keys unique to the BaseComponentInterface\n *\n * @internal\n */\nexport type BaseComponentKeys = Exclude<\n  keyof BaseComponentInterface,\n  keyof CommonComponentInterface\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 * @events\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":"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"}

package/dist/components/Common/FlowBreadcrumbs/FlowBreadcrumbsTypes.d.ts

@@ -11,7 +11,7 @@ import { EventType } from '../../../types/Helpers';
  * `startDate` and `endDate` keys) are auto-formatted with the active locale's
  * short-with-year date format before interpolation.
  *
- * @public
+ * @internal
  */
 export interface FlowBreadcrumb {
     /**

package/dist/components/Common/OnboardingStatusBadge/index.d.ts

@@ -1,4 +1,4 @@
-import { ContractorOnboardingStatus1 } from '@gusto/embedded-api/models/components/contractor';
+import { OnboardingStatus as ContractorOnboardingStatus1 } from '@gusto/embedded-api/models/components/contractor';
 import { OnboardingStatus } from '@gusto/embedded-api/models/operations/putv1employeesemployeeidonboardingstatus';
 type OnboardingStatuses = ContractorOnboardingStatus1 | OnboardingStatus;
 interface OnboardingStatusBadgeProps<T extends OnboardingStatuses> {

package/dist/components/Common/OnboardingStatusBadge/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/components/Common/OnboardingStatusBadge/index.tsx"],"sourcesContent":["import type { ContractorOnboardingStatus1 } from '@gusto/embedded-api/models/components/contractor'\nimport type { OnboardingStatus } from '@gusto/embedded-api/models/operations/putv1employeesemployeeidonboardingstatus'\nimport { useTranslation } from 'react-i18next'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\ntype OnboardingStatuses = ContractorOnboardingStatus1 | OnboardingStatus\n\ninterface OnboardingStatusBadgeProps<T extends OnboardingStatuses> {\n  onboarded?: boolean\n  onboardingEntity: 'contractor' | 'employee'\n  onboardingStatus?: T | null\n}\n/** @internal */\nexport const OnboardingStatusBadge = <T extends OnboardingStatuses>({\n  onboarded,\n  onboardingEntity,\n  onboardingStatus,\n}: OnboardingStatusBadgeProps<T>) => {\n  const { Badge } = useComponentContext()\n  const { t } = useTranslation()\n\n  //HACK: `never` should instead be a better type\n  return (\n    <Badge status={onboarded ? 'success' : 'warning'}>\n      {t(`onboardingStatus.${onboardingEntity}.${onboardingStatus ?? 'undefined'}` as never)}\n    </Badge>\n  )\n}\n\ninterface ContractorOnboardingStatusBadgeProps {\n  onboarded?: boolean\n  onboardingStatus?: ContractorOnboardingStatus1 | null\n}\n/** @internal */\nexport const ContractorOnboardingStatusBadge = (props: ContractorOnboardingStatusBadgeProps) => (\n  <OnboardingStatusBadge {...props} onboardingEntity=\"contractor\" />\n)\n\ninterface EmployeeOnboardingStatusBadgeProps {\n  onboarded?: boolean\n  onboardingStatus?: OnboardingStatus | null\n}\n/** @internal */\nexport const EmployeeOnboardingStatusBadge = (props: EmployeeOnboardingStatusBadgeProps) => (\n  <OnboardingStatusBadge {...props} onboardingEntity=\"employee\" />\n)\n"],"names":["OnboardingStatusBadge","onboarded","onboardingEntity","onboardingStatus","Badge","useComponentContext","t","useTranslation","jsx","ContractorOnboardingStatusBadge","props","EmployeeOnboardingStatusBadge"],"mappings":";;;AAaO,MAAMA,IAAwB,CAA+B;AAAA,EAClE,WAAAC;AAAA,EACA,kBAAAC;AAAA,EACA,kBAAAC;AACF,MAAqC;AACnC,QAAM,EAAE,OAAAC,EAAA,IAAUC,EAAA,GACZ,EAAE,GAAAC,EAAA,IAAMC,EAAA;AAGd,SACE,gBAAAC,EAACJ,GAAA,EAAM,QAAQH,IAAY,YAAY,WACpC,UAAAK,EAAE,oBAAoBJ,CAAgB,IAAIC,KAAoB,WAAW,EAAW,GACvF;AAEJ,GAOaM,IAAkC,CAACC,MAC9C,gBAAAF,EAACR,KAAuB,GAAGU,GAAO,kBAAiB,aAAA,CAAa,GAQrDC,IAAgC,CAACD,MAC5C,gBAAAF,EAACR,KAAuB,GAAGU,GAAO,kBAAiB,WAAA,CAAW;"}
+{"version":3,"file":"index.js","sources":["../../../../src/components/Common/OnboardingStatusBadge/index.tsx"],"sourcesContent":["import type { OnboardingStatus as ContractorOnboardingStatus1 } from '@gusto/embedded-api/models/components/contractor'\nimport type { OnboardingStatus } from '@gusto/embedded-api/models/operations/putv1employeesemployeeidonboardingstatus'\nimport { useTranslation } from 'react-i18next'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\ntype OnboardingStatuses = ContractorOnboardingStatus1 | OnboardingStatus\n\ninterface OnboardingStatusBadgeProps<T extends OnboardingStatuses> {\n  onboarded?: boolean\n  onboardingEntity: 'contractor' | 'employee'\n  onboardingStatus?: T | null\n}\n/** @internal */\nexport const OnboardingStatusBadge = <T extends OnboardingStatuses>({\n  onboarded,\n  onboardingEntity,\n  onboardingStatus,\n}: OnboardingStatusBadgeProps<T>) => {\n  const { Badge } = useComponentContext()\n  const { t } = useTranslation()\n\n  //HACK: `never` should instead be a better type\n  return (\n    <Badge status={onboarded ? 'success' : 'warning'}>\n      {t(`onboardingStatus.${onboardingEntity}.${onboardingStatus ?? 'undefined'}` as never)}\n    </Badge>\n  )\n}\n\ninterface ContractorOnboardingStatusBadgeProps {\n  onboarded?: boolean\n  onboardingStatus?: ContractorOnboardingStatus1 | null\n}\n/** @internal */\nexport const ContractorOnboardingStatusBadge = (props: ContractorOnboardingStatusBadgeProps) => (\n  <OnboardingStatusBadge {...props} onboardingEntity=\"contractor\" />\n)\n\ninterface EmployeeOnboardingStatusBadgeProps {\n  onboarded?: boolean\n  onboardingStatus?: OnboardingStatus | null\n}\n/** @internal */\nexport const EmployeeOnboardingStatusBadge = (props: EmployeeOnboardingStatusBadgeProps) => (\n  <OnboardingStatusBadge {...props} onboardingEntity=\"employee\" />\n)\n"],"names":["OnboardingStatusBadge","onboarded","onboardingEntity","onboardingStatus","Badge","useComponentContext","t","useTranslation","jsx","ContractorOnboardingStatusBadge","props","EmployeeOnboardingStatusBadge"],"mappings":";;;AAaO,MAAMA,IAAwB,CAA+B;AAAA,EAClE,WAAAC;AAAA,EACA,kBAAAC;AAAA,EACA,kBAAAC;AACF,MAAqC;AACnC,QAAM,EAAE,OAAAC,EAAA,IAAUC,EAAA,GACZ,EAAE,GAAAC,EAAA,IAAMC,EAAA;AAGd,SACE,gBAAAC,EAACJ,GAAA,EAAM,QAAQH,IAAY,YAAY,WACpC,UAAAK,EAAE,oBAAoBJ,CAAgB,IAAIC,KAAoB,WAAW,EAAW,GACvF;AAEJ,GAOaM,IAAkC,CAACC,MAC9C,gBAAAF,EAACR,KAAuB,GAAGU,GAAO,kBAAiB,aAAA,CAAa,GAQrDC,IAAgC,CAACD,MAC5C,gBAAAF,EAACR,KAAuB,GAAGU,GAAO,kBAAiB,WAAA,CAAW;"}

package/dist/components/Common/PaginationControl/PaginationControlTypes.d.ts

@@ -1,6 +1,9 @@
 /**
+ * Allowed page-size values a {@link PaginationControlProps | PaginationControl} offers for
+ * how many items to show per page.
+ *
  * @public
- * @group Utility types
+ * @childOf {@link PaginationControlProps}
  */
 export type PaginationItemsPerPage = 5 | 10 | 25 | 50;
 /**

package/dist/components/Common/UI/Breadcrumbs/BreadcrumbsTypes.d.ts

@@ -3,7 +3,7 @@ import { ReactNode } from 'react';
  * Single entry in a {@link BreadcrumbsProps | Breadcrumbs} trail.
  *
  * @public
- * @group Utility types
+ * @childOf {@link BreadcrumbsProps}
  */
 export interface Breadcrumb {
     /**

package/dist/components/Common/UI/Breadcrumbs/BreadcrumbsTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"BreadcrumbsTypes.js","sources":["../../../../../src/components/Common/UI/Breadcrumbs/BreadcrumbsTypes.ts"],"sourcesContent":["import type { ReactNode } from 'react'\n\n/**\n * Single entry in a {@link BreadcrumbsProps | Breadcrumbs} trail.\n *\n * @public\n * @group Utility types\n */\nexport interface Breadcrumb {\n  /**\n   * Unique identifier for the breadcrumb. Matches against `currentBreadcrumbId` and is passed to `onClick`.\n   */\n  id: string\n  /**\n   * Display content rendered for the breadcrumb.\n   */\n  label: ReactNode\n  /**\n   * When false, the breadcrumb is rendered as plain text even if onClick is provided.\n   * Defaults to true.\n   */\n  isClickable?: boolean\n}\n/**\n * Props your `Breadcrumbs` implementation must accept from the component adapter.\n * Renders a navigation breadcrumb trail showing the user's position in a multi-step flow.\n *\n * @public\n * @group Component props\n */\nexport interface BreadcrumbsProps {\n  /**\n   * Array of breadcrumbs\n   */\n  breadcrumbs: Breadcrumb[]\n  /**\n   * Current breadcrumb id\n   */\n  currentBreadcrumbId?: string\n  /**\n   * Accessibility label for the breadcrumbs\n   *\n   * @defaultValue `'Breadcrumbs'`\n   */\n  'aria-label'?: string\n  /**\n   * Additional CSS class name for the breadcrumbs container\n   */\n  className?: string\n  /**\n   * Event handler for breadcrumb navigation\n   */\n  onClick?: (id: string) => void\n  /**\n   * Passed to the breadcrumbs when the container size is small (640px and below)\n   * At this size, the breadcrumb typically does not have sufficient size to render\n   * completely. In our implementation, we switch to a condensed mobile version of\n   * the breadcrumbs\n   *\n   * @defaultValue `false`\n   */\n  isSmallContainer?: boolean\n}\n\n/**\n * Default prop values for Breadcrumbs component.\n *\n * @internal\n */\nexport const BreadcrumbsDefaults = {\n  isSmallContainer: false,\n  'aria-label': 'Breadcrumbs',\n} as const satisfies Partial<BreadcrumbsProps>\n"],"names":["BreadcrumbsDefaults"],"mappings":"AAqEO,MAAMA,IAAsB;AAAA,EACjC,kBAAkB;AAAA,EAClB,cAAc;AAChB;"}
+{"version":3,"file":"BreadcrumbsTypes.js","sources":["../../../../../src/components/Common/UI/Breadcrumbs/BreadcrumbsTypes.ts"],"sourcesContent":["import type { ReactNode } from 'react'\n\n/**\n * Single entry in a {@link BreadcrumbsProps | Breadcrumbs} trail.\n *\n * @public\n * @childOf {@link BreadcrumbsProps}\n */\nexport interface Breadcrumb {\n  /**\n   * Unique identifier for the breadcrumb. Matches against `currentBreadcrumbId` and is passed to `onClick`.\n   */\n  id: string\n  /**\n   * Display content rendered for the breadcrumb.\n   */\n  label: ReactNode\n  /**\n   * When false, the breadcrumb is rendered as plain text even if onClick is provided.\n   * Defaults to true.\n   */\n  isClickable?: boolean\n}\n/**\n * Props your `Breadcrumbs` implementation must accept from the component adapter.\n * Renders a navigation breadcrumb trail showing the user's position in a multi-step flow.\n *\n * @public\n * @group Component props\n */\nexport interface BreadcrumbsProps {\n  /**\n   * Array of breadcrumbs\n   */\n  breadcrumbs: Breadcrumb[]\n  /**\n   * Current breadcrumb id\n   */\n  currentBreadcrumbId?: string\n  /**\n   * Accessibility label for the breadcrumbs\n   *\n   * @defaultValue `'Breadcrumbs'`\n   */\n  'aria-label'?: string\n  /**\n   * Additional CSS class name for the breadcrumbs container\n   */\n  className?: string\n  /**\n   * Event handler for breadcrumb navigation\n   */\n  onClick?: (id: string) => void\n  /**\n   * Passed to the breadcrumbs when the container size is small (640px and below)\n   * At this size, the breadcrumb typically does not have sufficient size to render\n   * completely. In our implementation, we switch to a condensed mobile version of\n   * the breadcrumbs\n   *\n   * @defaultValue `false`\n   */\n  isSmallContainer?: boolean\n}\n\n/**\n * Default prop values for Breadcrumbs component.\n *\n * @internal\n */\nexport const BreadcrumbsDefaults = {\n  isSmallContainer: false,\n  'aria-label': 'Breadcrumbs',\n} as const satisfies Partial<BreadcrumbsProps>\n"],"names":["BreadcrumbsDefaults"],"mappings":"AAqEO,MAAMA,IAAsB;AAAA,EACjC,kBAAkB;AAAA,EAClB,cAAc;AAChB;"}

package/dist/components/Common/UI/CheckboxGroup/CheckboxGroupTypes.d.ts

@@ -4,7 +4,7 @@ import { SharedFieldLayoutProps } from '../../FieldLayout/FieldLayoutTypes';
  * Option entry rendered as a single checkbox within a {@link CheckboxGroupProps | CheckboxGroup}.
  *
  * @public
- * @group Utility types
+ * @childOf {@link CheckboxGroupProps}
  */
 export interface CheckboxGroupOption {
     /**

package/dist/components/Common/UI/CheckboxGroup/CheckboxGroupTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"CheckboxGroupTypes.js","sources":["../../../../../src/components/Common/UI/CheckboxGroup/CheckboxGroupTypes.ts"],"sourcesContent":["import type { FieldsetHTMLAttributes, Ref } from 'react'\nimport type { SharedFieldLayoutProps } from '@/components/Common/FieldLayout/FieldLayoutTypes'\n\n/**\n * Option entry rendered as a single checkbox within a {@link CheckboxGroupProps | CheckboxGroup}.\n *\n * @public\n * @group Utility types\n */\nexport interface CheckboxGroupOption {\n  /**\n   * Label text or content for the checkbox option\n   */\n  label: React.ReactNode\n  /**\n   * Value of the option that will be passed to onChange\n   */\n  value: string\n  /**\n   * Disables this specific checkbox option\n   */\n  isDisabled?: boolean\n  /**\n   * Optional description text for the checkbox option\n   */\n  description?: React.ReactNode\n}\n\n/**\n * Props your `CheckboxGroup` implementation must accept from the component adapter.\n * Renders a form field wrapping multiple `<input type=\"checkbox\" />` elements with a label, optional description, and error message.\n *\n * @public\n * @group Component props\n */\nexport interface CheckboxGroupProps\n  extends SharedFieldLayoutProps, Pick<FieldsetHTMLAttributes<HTMLFieldSetElement>, 'className'> {\n  /**\n   * Indicates if the checkbox group is in an invalid state\n   *\n   * @defaultValue `false`\n   */\n  isInvalid?: boolean\n  /**\n   * Disables all checkbox options in the group\n   *\n   * @defaultValue `false`\n   */\n  isDisabled?: boolean\n  /**\n   * Array of checkbox options to display\n   */\n  options: Array<CheckboxGroupOption>\n  /**\n   * Array of currently selected values\n   */\n  value?: string[]\n  /**\n   * Callback when selection changes\n   */\n  onChange?: (value: string[]) => void\n  /**\n   * React ref for the first checkbox input element\n   */\n  inputRef?: Ref<HTMLInputElement>\n}\n\n/**\n * Default prop values for the CheckboxGroup component.\n *\n * @internal\n */\nexport const CheckboxGroupDefaults = {\n  isRequired: false,\n  isInvalid: false,\n  isDisabled: false,\n  shouldVisuallyHideLabel: false,\n} as const satisfies Partial<CheckboxGroupProps>\n"],"names":["CheckboxGroupDefaults"],"mappings":"AAwEO,MAAMA,IAAwB;AAAA,EACnC,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,yBAAyB;AAC3B;"}
+{"version":3,"file":"CheckboxGroupTypes.js","sources":["../../../../../src/components/Common/UI/CheckboxGroup/CheckboxGroupTypes.ts"],"sourcesContent":["import type { FieldsetHTMLAttributes, Ref } from 'react'\nimport type { SharedFieldLayoutProps } from '@/components/Common/FieldLayout/FieldLayoutTypes'\n\n/**\n * Option entry rendered as a single checkbox within a {@link CheckboxGroupProps | CheckboxGroup}.\n *\n * @public\n * @childOf {@link CheckboxGroupProps}\n */\nexport interface CheckboxGroupOption {\n  /**\n   * Label text or content for the checkbox option\n   */\n  label: React.ReactNode\n  /**\n   * Value of the option that will be passed to onChange\n   */\n  value: string\n  /**\n   * Disables this specific checkbox option\n   */\n  isDisabled?: boolean\n  /**\n   * Optional description text for the checkbox option\n   */\n  description?: React.ReactNode\n}\n\n/**\n * Props your `CheckboxGroup` implementation must accept from the component adapter.\n * Renders a form field wrapping multiple `<input type=\"checkbox\" />` elements with a label, optional description, and error message.\n *\n * @public\n * @group Component props\n */\nexport interface CheckboxGroupProps\n  extends SharedFieldLayoutProps, Pick<FieldsetHTMLAttributes<HTMLFieldSetElement>, 'className'> {\n  /**\n   * Indicates if the checkbox group is in an invalid state\n   *\n   * @defaultValue `false`\n   */\n  isInvalid?: boolean\n  /**\n   * Disables all checkbox options in the group\n   *\n   * @defaultValue `false`\n   */\n  isDisabled?: boolean\n  /**\n   * Array of checkbox options to display\n   */\n  options: Array<CheckboxGroupOption>\n  /**\n   * Array of currently selected values\n   */\n  value?: string[]\n  /**\n   * Callback when selection changes\n   */\n  onChange?: (value: string[]) => void\n  /**\n   * React ref for the first checkbox input element\n   */\n  inputRef?: Ref<HTMLInputElement>\n}\n\n/**\n * Default prop values for the CheckboxGroup component.\n *\n * @internal\n */\nexport const CheckboxGroupDefaults = {\n  isRequired: false,\n  isInvalid: false,\n  isDisabled: false,\n  shouldVisuallyHideLabel: false,\n} as const satisfies Partial<CheckboxGroupProps>\n"],"names":["CheckboxGroupDefaults"],"mappings":"AAwEO,MAAMA,IAAwB;AAAA,EACnC,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,yBAAyB;AAC3B;"}

package/dist/components/Common/UI/ComboBox/ComboBoxTypes.d.ts

@@ -1,10 +1,10 @@
 import { InputHTMLAttributes, Ref } from 'react';
 import { SharedFieldLayoutProps } from '../../FieldLayout/FieldLayoutTypes';
 /**
- * Option entry for the ComboBox dropdown list.
+ * Option entry for the {@link ComboBoxProps | ComboBox} dropdown list.
  *
  * @public
- * @group Utility types
+ * @childOf {@link ComboBoxProps}
  */
 export interface ComboBoxOption {
     /**

package/dist/components/Common/UI/DateRangePicker/DateRangePickerTypes.d.ts

@@ -1,8 +1,9 @@
 /**
- * Inclusive start/end pair representing a selected date range.
+ * Inclusive start/end pair representing a date range selected in a
+ * {@link DateRangePickerProps | DateRangePicker}.
  *
  * @public
- * @group Utility types
+ * @childOf {@link DateRangePickerProps}
  */
 export interface DateRange {
     /**

package/dist/components/Common/UI/DescriptionList/DescriptionListTypes.d.ts

@@ -3,7 +3,7 @@ import { ReactNode } from 'react';
  * Single term/description pair rendered as a row within a {@link DescriptionListProps | DescriptionList}.
  *
  * @public
- * @group Utility types
+ * @childOf {@link DescriptionListProps}
  */
 export interface DescriptionListItem {
     /**

package/dist/components/Common/UI/DescriptionList/DescriptionListTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"DescriptionListTypes.js","sources":["../../../../../src/components/Common/UI/DescriptionList/DescriptionListTypes.ts"],"sourcesContent":["import type { ReactNode } from 'react'\n\n/**\n * Single term/description pair rendered as a row within a {@link DescriptionListProps | DescriptionList}.\n *\n * @public\n * @group Utility types\n */\nexport interface DescriptionListItem {\n  /**\n   * Term content (the `<dt>`). Pass an array to render multiple `<dt>` elements for the same description.\n   */\n  term: ReactNode | ReactNode[]\n  /**\n   * Description content (the `<dd>`). Pass an array to render multiple `<dd>` elements for the same term.\n   */\n  description: ReactNode | ReactNode[]\n}\n\n/**\n * Props your `DescriptionList` implementation must accept from the component adapter.\n * Renders an HTML `<dl>` of term/description pairs in either a stacked or horizontal layout.\n *\n * @public\n * @group Component props\n */\nexport interface DescriptionListProps {\n  /**\n   * Term/description pairs to render in order.\n   */\n  items: DescriptionListItem[]\n  /**\n   * Visual arrangement of each term/description pair. Defaults to `'stacked'`.\n   *\n   * @defaultValue `'stacked'`\n   */\n  layout?: 'stacked' | 'horizontal'\n  /**\n   * Whether to render dividers between rows. Defaults to `true`.\n   *\n   * @defaultValue `true`\n   */\n  showSeparators?: boolean\n  /**\n   * Additional class name applied to the root `<dl>`.\n   */\n  className?: string\n}\n\n/**\n * Default prop values for the DescriptionList component.\n *\n * @internal\n */\nexport const DescriptionListDefaults = {\n  layout: 'stacked',\n  showSeparators: true,\n} as const satisfies Partial<DescriptionListProps>\n"],"names":["DescriptionListDefaults"],"mappings":"AAsDO,MAAMA,IAA0B;AAAA,EACrC,QAAQ;AAAA,EACR,gBAAgB;AAClB;"}
+{"version":3,"file":"DescriptionListTypes.js","sources":["../../../../../src/components/Common/UI/DescriptionList/DescriptionListTypes.ts"],"sourcesContent":["import type { ReactNode } from 'react'\n\n/**\n * Single term/description pair rendered as a row within a {@link DescriptionListProps | DescriptionList}.\n *\n * @public\n * @childOf {@link DescriptionListProps}\n */\nexport interface DescriptionListItem {\n  /**\n   * Term content (the `<dt>`). Pass an array to render multiple `<dt>` elements for the same description.\n   */\n  term: ReactNode | ReactNode[]\n  /**\n   * Description content (the `<dd>`). Pass an array to render multiple `<dd>` elements for the same term.\n   */\n  description: ReactNode | ReactNode[]\n}\n\n/**\n * Props your `DescriptionList` implementation must accept from the component adapter.\n * Renders an HTML `<dl>` of term/description pairs in either a stacked or horizontal layout.\n *\n * @public\n * @group Component props\n */\nexport interface DescriptionListProps {\n  /**\n   * Term/description pairs to render in order.\n   */\n  items: DescriptionListItem[]\n  /**\n   * Visual arrangement of each term/description pair. Defaults to `'stacked'`.\n   *\n   * @defaultValue `'stacked'`\n   */\n  layout?: 'stacked' | 'horizontal'\n  /**\n   * Whether to render dividers between rows. Defaults to `true`.\n   *\n   * @defaultValue `true`\n   */\n  showSeparators?: boolean\n  /**\n   * Additional class name applied to the root `<dl>`.\n   */\n  className?: string\n}\n\n/**\n * Default prop values for the DescriptionList component.\n *\n * @internal\n */\nexport const DescriptionListDefaults = {\n  layout: 'stacked',\n  showSeparators: true,\n} as const satisfies Partial<DescriptionListProps>\n"],"names":["DescriptionListDefaults"],"mappings":"AAsDO,MAAMA,IAA0B;AAAA,EACrC,QAAQ;AAAA,EACR,gBAAgB;AAClB;"}

package/dist/components/Common/UI/FormBox/FormBox.d.ts

@@ -0,0 +1,9 @@
+import { FormBoxProps } from './FormBoxTypes';
+/**
+ * Renders a bordered container used to group related form fields, with an optional header slot.
+ *
+ * @param props - The {@link FormBoxProps} controlling the form box contents, header, and padding.
+ * @returns The rendered form box.
+ * @internal
+ */
+export declare function FormBox({ children, header, withPadding, className }: FormBoxProps): import("react").JSX.Element;

package/dist/components/Common/UI/FormBox/FormBox.js

@@ -0,0 +1,13 @@
+import { jsxs as m, jsx as s } from "react/jsx-runtime";
+import i from "classnames";
+import t from "./FormBox.module.scss.js";
+function l({ children: r, header: o, withPadding: e = !0, className: a }) {
+  return /* @__PURE__ */ m("div", { className: i(t.root, a), "data-testid": "data-form-box", children: [
+    o && /* @__PURE__ */ s("div", { className: t.header, children: o }),
+    /* @__PURE__ */ s("div", { className: e ? t.content : t.contentFlush, children: r })
+  ] });
+}
+export {
+  l as FormBox
+};
+//# sourceMappingURL=FormBox.js.map

package/dist/components/Common/UI/FormBox/FormBox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormBox.js","sources":["../../../../../src/components/Common/UI/FormBox/FormBox.tsx"],"sourcesContent":["import cn from 'classnames'\nimport styles from './FormBox.module.scss'\nimport type { FormBoxProps } from '@/components/Common/UI/FormBox/FormBoxTypes'\n\n/**\n * Renders a bordered container used to group related form fields, with an optional header slot.\n *\n * @param props - The {@link FormBoxProps} controlling the form box contents, header, and padding.\n * @returns The rendered form box.\n * @internal\n */\nexport function FormBox({ children, header, withPadding = true, className }: FormBoxProps) {\n  return (\n    <div className={cn(styles.root, className)} data-testid=\"data-form-box\">\n      {header && <div className={styles.header}>{header}</div>}\n      <div className={withPadding ? styles.content : styles.contentFlush}>{children}</div>\n    </div>\n  )\n}\n"],"names":["FormBox","children","header","withPadding","className","jsxs","cn","styles","jsx"],"mappings":";;;AAWO,SAASA,EAAQ,EAAE,UAAAC,GAAU,QAAAC,GAAQ,aAAAC,IAAc,IAAM,WAAAC,KAA2B;AACzF,SACE,gBAAAC,EAAC,SAAI,WAAWC,EAAGC,EAAO,MAAMH,CAAS,GAAG,eAAY,iBACrD,UAAA;AAAA,IAAAF,KAAU,gBAAAM,EAAC,OAAA,EAAI,WAAWD,EAAO,QAAS,UAAAL,GAAO;AAAA,IAClD,gBAAAM,EAAC,SAAI,WAAWL,IAAcI,EAAO,UAAUA,EAAO,cAAe,UAAAN,EAAA,CAAS;AAAA,EAAA,GAChF;AAEJ;"}

package/dist/components/Common/UI/FormBox/FormBox.module.scss.js

@@ -0,0 +1,14 @@
+const t = "_root_c61dy_1", o = "_header_c61dy_12", n = "_content_c61dy_17", c = "_contentFlush_c61dy_22", e = {
+  root: t,
+  header: o,
+  content: n,
+  contentFlush: c
+};
+export {
+  n as content,
+  c as contentFlush,
+  e as default,
+  o as header,
+  t as root
+};
+//# sourceMappingURL=FormBox.module.scss.js.map

package/dist/components/Common/UI/FormBox/FormBox.module.scss.js.map

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

package/dist/components/Common/UI/FormBox/FormBoxTypes.d.ts

@@ -0,0 +1,26 @@
+import { ReactNode } from 'react';
+/**
+ * Props your `FormBox` implementation must accept from the component adapter.
+ * Renders a sectioned container used to group related form fields, with an optional header slot.
+ *
+ * @public
+ * @group Component props
+ */
+export interface FormBoxProps {
+    /**
+     * Content rendered inside the form box body.
+     */
+    children: ReactNode;
+    /**
+     * Optional content rendered above the body in the form box header section.
+     */
+    header?: ReactNode;
+    /**
+     * Whether the body should apply the default inner padding. Defaults to true; set to false for content that needs to be flush with the form box edges.
+     */
+    withPadding?: boolean;
+    /**
+     * CSS className to be applied to the root element.
+     */
+    className?: string;
+}

package/dist/components/Common/UI/FormBoxHeader/FormBoxHeader.d.ts

@@ -0,0 +1,9 @@
+import { FormBoxHeaderProps } from './FormBoxHeaderTypes';
+/**
+ * Renders a titled header for a {@link FormBoxProps | FormBox}, with optional description and inline action slot.
+ *
+ * @param rawProps - The {@link FormBoxHeaderProps} controlling the title, description, action, and heading level.
+ * @returns The rendered form box header.
+ * @internal
+ */
+export declare function FormBoxHeader(rawProps: FormBoxHeaderProps): import("react").JSX.Element;

package/dist/components/Common/UI/FormBoxHeader/FormBoxHeader.js

@@ -0,0 +1,23 @@
+import { jsx as e, jsxs as r } from "react/jsx-runtime";
+import { FormBoxHeaderDefaults as p } from "./FormBoxHeaderTypes.js";
+import i from "./FormBoxHeader.module.scss.js";
+import { applyMissingDefaults as c } from "../../../../helpers/applyMissingDefaults.js";
+import { useComponentContext as d } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { Flex as n } from "../../Flex/Flex.js";
+function D(s) {
+  const { title: a, description: o, action: m, headingLevel: l } = c(
+    s,
+    p
+  ), t = d();
+  return /* @__PURE__ */ e("div", { className: i.root, children: /* @__PURE__ */ r(n, { flexDirection: "row", gap: 16, justifyContent: "space-between", alignItems: "center", children: [
+    /* @__PURE__ */ r(n, { flexDirection: "column", gap: 4, children: [
+      /* @__PURE__ */ e(t.Heading, { as: l, className: i.headerTitle, children: a }),
+      o && /* @__PURE__ */ e(t.Text, { as: "p", variant: "supporting", children: o })
+    ] }),
+    m
+  ] }) });
+}
+export {
+  D as FormBoxHeader
+};
+//# sourceMappingURL=FormBoxHeader.js.map

package/dist/components/Common/UI/FormBoxHeader/FormBoxHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormBoxHeader.js","sources":["../../../../../src/components/Common/UI/FormBoxHeader/FormBoxHeader.tsx"],"sourcesContent":["import { type FormBoxHeaderProps, FormBoxHeaderDefaults } from './FormBoxHeaderTypes'\nimport styles from './FormBoxHeader.module.scss'\nimport { applyMissingDefaults } from '@/helpers/applyMissingDefaults'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { Flex } from '@/components/Common/Flex'\n\n/**\n * Renders a titled header for a {@link FormBoxProps | FormBox}, with optional description and inline action slot.\n *\n * @param rawProps - The {@link FormBoxHeaderProps} controlling the title, description, action, and heading level.\n * @returns The rendered form box header.\n * @internal\n */\nexport function FormBoxHeader(rawProps: FormBoxHeaderProps) {\n  const { title, description, action, headingLevel } = applyMissingDefaults(\n    rawProps,\n    FormBoxHeaderDefaults,\n  )\n  const Components = useComponentContext()\n\n  return (\n    <div className={styles.root}>\n      <Flex flexDirection=\"row\" gap={16} justifyContent=\"space-between\" alignItems=\"center\">\n        <Flex flexDirection=\"column\" gap={4}>\n          <Components.Heading as={headingLevel!} className={styles.headerTitle}>\n            {title}\n          </Components.Heading>\n          {description && (\n            <Components.Text as=\"p\" variant=\"supporting\">\n              {description}\n            </Components.Text>\n          )}\n        </Flex>\n\n        {action}\n      </Flex>\n    </div>\n  )\n}\n"],"names":["FormBoxHeader","rawProps","title","description","action","headingLevel","applyMissingDefaults","FormBoxHeaderDefaults","Components","useComponentContext","jsx","styles","jsxs","Flex"],"mappings":";;;;;;AAaO,SAASA,EAAcC,GAA8B;AAC1D,QAAM,EAAE,OAAAC,GAAO,aAAAC,GAAa,QAAAC,GAAQ,cAAAC,MAAiBC;AAAA,IACnDL;AAAA,IACAM;AAAA,EAAA,GAEIC,IAAaC,EAAA;AAEnB,SACE,gBAAAC,EAAC,OAAA,EAAI,WAAWC,EAAO,MACrB,UAAA,gBAAAC,EAACC,GAAA,EAAK,eAAc,OAAM,KAAK,IAAI,gBAAe,iBAAgB,YAAW,UAC3E,UAAA;AAAA,IAAA,gBAAAD,EAACC,GAAA,EAAK,eAAc,UAAS,KAAK,GAChC,UAAA;AAAA,MAAA,gBAAAH,EAACF,EAAW,SAAX,EAAmB,IAAIH,GAAe,WAAWM,EAAO,aACtD,UAAAT,EAAA,CACH;AAAA,MACCC,uBACEK,EAAW,MAAX,EAAgB,IAAG,KAAI,SAAQ,cAC7B,UAAAL,EAAA,CACH;AAAA,IAAA,GAEJ;AAAA,IAECC;AAAA,EAAA,EAAA,CACH,EAAA,CACF;AAEJ;"}

package/dist/components/Common/UI/FormBoxHeader/FormBoxHeader.module.scss.js

@@ -0,0 +1,8 @@
+const o = "_root_1vjsj_1", t = {
+  root: o
+};
+export {
+  t as default,
+  o as root
+};
+//# sourceMappingURL=FormBoxHeader.module.scss.js.map

package/dist/components/Common/UI/FormBoxHeader/FormBoxHeader.module.scss.js.map

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

package/dist/components/Common/UI/FormBoxHeader/FormBoxHeaderTypes.d.ts

@@ -0,0 +1,36 @@
+import { ReactNode } from 'react';
+/**
+ * Props your `FormBoxHeader` implementation must accept from the component adapter.
+ * Renders the header section of a FormBox, combining a title, optional description, and an optional inline action slot.
+ *
+ * @public
+ * @group Component props
+ */
+export interface FormBoxHeaderProps {
+    /**
+     * Title content rendered as the heading.
+     */
+    title: ReactNode;
+    /**
+     * Optional supporting description rendered below the title.
+     */
+    description?: ReactNode;
+    /**
+     * Optional action content (e.g. a Button) rendered inline opposite the title.
+     */
+    action?: ReactNode;
+    /**
+     * Semantic heading level for the title. Defaults to `h3`.
+     *
+     * @defaultValue `'h3'`
+     */
+    headingLevel?: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+}
+/**
+ * Default prop values for FormBoxHeader component.
+ *
+ * @internal
+ */
+export declare const FormBoxHeaderDefaults: {
+    readonly headingLevel: "h3";
+};

package/dist/components/Common/UI/FormBoxHeader/FormBoxHeaderTypes.js

@@ -0,0 +1,7 @@
+const e = {
+  headingLevel: "h3"
+};
+export {
+  e as FormBoxHeaderDefaults
+};
+//# sourceMappingURL=FormBoxHeaderTypes.js.map

package/dist/components/Common/UI/FormBoxHeader/FormBoxHeaderTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormBoxHeaderTypes.js","sources":["../../../../../src/components/Common/UI/FormBoxHeader/FormBoxHeaderTypes.ts"],"sourcesContent":["import type { ReactNode } from 'react'\n\n/**\n * Props your `FormBoxHeader` implementation must accept from the component adapter.\n * Renders the header section of a FormBox, combining a title, optional description, and an optional inline action slot.\n *\n * @public\n * @group Component props\n */\nexport interface FormBoxHeaderProps {\n  /**\n   * Title content rendered as the heading.\n   */\n  title: ReactNode\n  /**\n   * Optional supporting description rendered below the title.\n   */\n  description?: ReactNode\n  /**\n   * Optional action content (e.g. a Button) rendered inline opposite the title.\n   */\n  action?: ReactNode\n  /**\n   * Semantic heading level for the title. Defaults to `h3`.\n   *\n   * @defaultValue `'h3'`\n   */\n  headingLevel?: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6'\n}\n\n/**\n * Default prop values for FormBoxHeader component.\n *\n * @internal\n */\nexport const FormBoxHeaderDefaults = {\n  headingLevel: 'h3',\n} as const satisfies Partial<FormBoxHeaderProps>\n"],"names":["FormBoxHeaderDefaults"],"mappings":"AAmCO,MAAMA,IAAwB;AAAA,EACnC,cAAc;AAChB;"}

package/dist/components/Common/UI/FormBoxHeader/index.d.ts

@@ -0,0 +1 @@
+export { FormBoxHeader } from './FormBoxHeader';

package/dist/components/Common/UI/Input/InputTypes.d.ts

@@ -7,6 +7,7 @@ import { InputHTMLAttributes, ReactNode, Ref } from 'react';
  * `adornmentStart` and `adornmentEnd` slots from this interface.
  *
  * @public
+ * @group Component props
  */
 export interface InputProps extends Pick<InputHTMLAttributes<HTMLInputElement>, 'className' | 'id' | 'name' | 'placeholder' | 'type' | 'value' | 'onChange' | 'onBlur' | 'onFocus' | 'aria-describedby' | 'aria-labelledby' | 'aria-invalid' | 'min' | 'max' | 'maxLength'> {
     /**

package/dist/components/Common/UI/Input/InputTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"InputTypes.js","sources":["../../../../../src/components/Common/UI/Input/InputTypes.ts"],"sourcesContent":["import type { InputHTMLAttributes, ReactNode, Ref } from 'react'\n\n/**\n * Base text-input primitive used internally by `TextInput` and `NumberInput`.\n *\n * @remarks\n * Higher-level field components like TextInput and NumberInput reuse the\n * `adornmentStart` and `adornmentEnd` slots from this interface.\n *\n * @public\n */\nexport interface InputProps extends Pick<\n  InputHTMLAttributes<HTMLInputElement>,\n  | 'className'\n  | 'id'\n  | 'name'\n  | 'placeholder'\n  | 'type'\n  | 'value'\n  | 'onChange'\n  | 'onBlur'\n  | 'onFocus'\n  | 'aria-describedby'\n  | 'aria-labelledby'\n  | 'aria-invalid'\n  | 'min'\n  | 'max'\n  | 'maxLength'\n> {\n  /**\n   * Ref for the input element\n   */\n  inputRef?: Ref<HTMLInputElement>\n\n  /**\n   * Content to display at the start of the input\n   */\n  adornmentStart?: ReactNode\n\n  /**\n   * Content to display at the end of the input\n   */\n  adornmentEnd?: ReactNode\n\n  /**\n   * Whether the input is disabled\n   * @defaultValue `false`\n   */\n  isDisabled?: boolean\n}\n\n/**\n * Default prop values for the Input primitive, applied through the component adapter.\n *\n * @internal\n */\nexport const InputDefaults = {\n  isDisabled: false,\n} as const satisfies Partial<InputProps>\n"],"names":["InputDefaults"],"mappings":"AAwDO,MAAMA,IAAgB;AAAA,EAC3B,YAAY;AACd;"}
+{"version":3,"file":"InputTypes.js","sources":["../../../../../src/components/Common/UI/Input/InputTypes.ts"],"sourcesContent":["import type { InputHTMLAttributes, ReactNode, Ref } from 'react'\n\n/**\n * Base text-input primitive used internally by `TextInput` and `NumberInput`.\n *\n * @remarks\n * Higher-level field components like TextInput and NumberInput reuse the\n * `adornmentStart` and `adornmentEnd` slots from this interface.\n *\n * @public\n * @group Component props\n */\nexport interface InputProps extends Pick<\n  InputHTMLAttributes<HTMLInputElement>,\n  | 'className'\n  | 'id'\n  | 'name'\n  | 'placeholder'\n  | 'type'\n  | 'value'\n  | 'onChange'\n  | 'onBlur'\n  | 'onFocus'\n  | 'aria-describedby'\n  | 'aria-labelledby'\n  | 'aria-invalid'\n  | 'min'\n  | 'max'\n  | 'maxLength'\n> {\n  /**\n   * Ref for the input element\n   */\n  inputRef?: Ref<HTMLInputElement>\n\n  /**\n   * Content to display at the start of the input\n   */\n  adornmentStart?: ReactNode\n\n  /**\n   * Content to display at the end of the input\n   */\n  adornmentEnd?: ReactNode\n\n  /**\n   * Whether the input is disabled\n   * @defaultValue `false`\n   */\n  isDisabled?: boolean\n}\n\n/**\n * Default prop values for the Input primitive, applied through the component adapter.\n *\n * @internal\n */\nexport const InputDefaults = {\n  isDisabled: false,\n} as const satisfies Partial<InputProps>\n"],"names":["InputDefaults"],"mappings":"AAyDO,MAAMA,IAAgB;AAAA,EAC3B,YAAY;AACd;"}

package/dist/components/Common/UI/Menu/MenuTypes.d.ts

@@ -1,11 +1,11 @@
 import { ReactNode, RefObject } from 'react';
 import { DataAttributes } from '../../../../types/Helpers';
 /**
- * Action entry your `Menu` implementation must accept for each entry in its `items` array
- * from the component adapter.
+ * Action entry your {@link MenuProps | Menu} implementation must accept for each entry in its
+ * `items` array from the component adapter.
  *
  * @public
- * @group Utility types
+ * @childOf {@link MenuProps}
  */
 export interface MenuItem extends DataAttributes {
     /**

package/dist/components/Common/UI/Menu/MenuTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"MenuTypes.js","sources":["../../../../../src/components/Common/UI/Menu/MenuTypes.ts"],"sourcesContent":["import type { ReactNode, RefObject } from 'react'\nimport type { DataAttributes } from '@/types/Helpers'\n\n/**\n * Action entry your `Menu` implementation must accept for each entry in its `items` array\n * from the component adapter.\n *\n * @public\n * @group Utility types\n */\nexport interface MenuItem extends DataAttributes {\n  /**\n   * Text label for the menu item\n   */\n  label: string\n  /**\n   * Optional icon to display before the label\n   */\n  icon?: ReactNode\n  /**\n   * Callback function when the menu item is clicked\n   */\n  onClick: () => void\n  /**\n   * Disables the menu item and prevents interaction\n   */\n  isDisabled?: boolean\n  /**\n   * Optional URL to navigate to when clicked\n   */\n  href?: string\n}\n\n/**\n * Props your `Menu` implementation must accept from the component adapter.\n * Renders a popover menu of actions anchored to a trigger element.\n *\n * @public\n * @group Component props\n */\nexport interface MenuProps extends DataAttributes {\n  /**\n   * Reference to the element that triggers the menu\n   */\n  triggerRef?: RefObject<Element | null>\n  /**\n   * Array of menu items to display\n   */\n  items?: MenuItem[]\n  /**\n   * Controls whether the menu is currently open\n   *\n   * @defaultValue `false`\n   */\n  isOpen?: boolean\n  /**\n   * Callback when the menu is closed\n   */\n  onClose?: () => void\n  /**\n   * Accessible label describing the menu's purpose\n   */\n  'aria-label': string\n  /**\n   * Element to use as the portal container for the menu popover.\n   * Overrides the default SDK root container from context.\n   */\n  portalContainer?: HTMLElement\n  /**\n   * Controls the placement of the menu popover relative to the trigger\n   *\n   * @defaultValue `'bottom start'`\n   */\n  placement?:\n    'top' | 'top start' | 'top end' | 'bottom' | 'bottom start' | 'bottom end' | 'left' | 'right'\n}\n\n/**\n * Default prop values for the {@link Menu} component.\n *\n * @internal\n */\nexport const MenuDefaults = {\n  isOpen: false,\n  placement: 'bottom start',\n} as const satisfies Partial<MenuProps>\n"],"names":["MenuDefaults"],"mappings":"AAkFO,MAAMA,IAAe;AAAA,EAC1B,QAAQ;AAAA,EACR,WAAW;AACb;"}
+{"version":3,"file":"MenuTypes.js","sources":["../../../../../src/components/Common/UI/Menu/MenuTypes.ts"],"sourcesContent":["import type { ReactNode, RefObject } from 'react'\nimport type { DataAttributes } from '@/types/Helpers'\n\n/**\n * Action entry your {@link MenuProps | Menu} implementation must accept for each entry in its\n * `items` array from the component adapter.\n *\n * @public\n * @childOf {@link MenuProps}\n */\nexport interface MenuItem extends DataAttributes {\n  /**\n   * Text label for the menu item\n   */\n  label: string\n  /**\n   * Optional icon to display before the label\n   */\n  icon?: ReactNode\n  /**\n   * Callback function when the menu item is clicked\n   */\n  onClick: () => void\n  /**\n   * Disables the menu item and prevents interaction\n   */\n  isDisabled?: boolean\n  /**\n   * Optional URL to navigate to when clicked\n   */\n  href?: string\n}\n\n/**\n * Props your `Menu` implementation must accept from the component adapter.\n * Renders a popover menu of actions anchored to a trigger element.\n *\n * @public\n * @group Component props\n */\nexport interface MenuProps extends DataAttributes {\n  /**\n   * Reference to the element that triggers the menu\n   */\n  triggerRef?: RefObject<Element | null>\n  /**\n   * Array of menu items to display\n   */\n  items?: MenuItem[]\n  /**\n   * Controls whether the menu is currently open\n   *\n   * @defaultValue `false`\n   */\n  isOpen?: boolean\n  /**\n   * Callback when the menu is closed\n   */\n  onClose?: () => void\n  /**\n   * Accessible label describing the menu's purpose\n   */\n  'aria-label': string\n  /**\n   * Element to use as the portal container for the menu popover.\n   * Overrides the default SDK root container from context.\n   */\n  portalContainer?: HTMLElement\n  /**\n   * Controls the placement of the menu popover relative to the trigger\n   *\n   * @defaultValue `'bottom start'`\n   */\n  placement?:\n    'top' | 'top start' | 'top end' | 'bottom' | 'bottom start' | 'bottom end' | 'left' | 'right'\n}\n\n/**\n * Default prop values for the {@link Menu} component.\n *\n * @internal\n */\nexport const MenuDefaults = {\n  isOpen: false,\n  placement: 'bottom start',\n} as const satisfies Partial<MenuProps>\n"],"names":["MenuDefaults"],"mappings":"AAkFO,MAAMA,IAAe;AAAA,EAC1B,QAAQ;AAAA,EACR,WAAW;AACb;"}

package/dist/components/Common/UI/MultiSelectComboBox/MultiSelectComboBoxTypes.d.ts

@@ -1,10 +1,10 @@
 import { InputHTMLAttributes, Ref } from 'react';
 import { SharedFieldLayoutProps } from '../../FieldLayout/FieldLayoutTypes';
 /**
- * Option entry for a `MultiSelectComboBox` dropdown list.
+ * Option entry for a {@link MultiSelectComboBoxProps | MultiSelectComboBox} dropdown list.
  *
  * @public
- * @group Utility types
+ * @childOf {@link MultiSelectComboBoxProps}
  */
 export interface MultiSelectComboBoxOption {
     /**

package/dist/components/Common/UI/RadioGroup/RadioGroupTypes.d.ts

@@ -1,10 +1,10 @@
 import { FieldsetHTMLAttributes, Ref } from 'react';
 import { SharedFieldLayoutProps } from '../../FieldLayout/FieldLayoutTypes';
 /**
- * Option entry your `RadioGroup` implementation receives in the `options` array when rendering each radio button.
+ * Option entry your {@link RadioGroupProps | RadioGroup} implementation receives in the `options` array when rendering each radio button.
  *
  * @public
- * @group Utility types
+ * @childOf {@link RadioGroupProps}
  */
 export interface RadioGroupOption {
     /**

package/dist/components/Common/UI/RadioGroup/RadioGroupTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"RadioGroupTypes.js","sources":["../../../../../src/components/Common/UI/RadioGroup/RadioGroupTypes.ts"],"sourcesContent":["import type { FieldsetHTMLAttributes, Ref } from 'react'\nimport type { SharedFieldLayoutProps } from '@/components/Common/FieldLayout/FieldLayoutTypes'\n\n/**\n * Option entry your `RadioGroup` implementation receives in the `options` array when rendering each radio button.\n *\n * @public\n * @group Utility types\n */\nexport interface RadioGroupOption {\n  /**\n   * Label text or content for the radio option\n   */\n  label: React.ReactNode\n  /**\n   * Value of the option that will be passed to onChange\n   */\n  value: string\n  /**\n   * Disables this specific radio option\n   */\n  isDisabled?: boolean\n  /**\n   * Optional description text for the radio option\n   */\n  description?: React.ReactNode\n}\n\n/**\n * Props your `RadioGroup` implementation must accept from the component adapter.\n * Renders a form field wrapping multiple `<input type=\"radio\" />` elements with a label, optional description, and error message.\n *\n * @public\n * @group Component props\n */\nexport interface RadioGroupProps\n  extends SharedFieldLayoutProps, Pick<FieldsetHTMLAttributes<HTMLFieldSetElement>, 'className'> {\n  /**\n   * Indicates that the field has an error\n   *\n   * @defaultValue `false`\n   */\n  isInvalid?: boolean\n  /**\n   * Disables all radio options in the group\n   *\n   * @defaultValue `false`\n   */\n  isDisabled?: boolean\n  /**\n   * Array of radio options to display\n   */\n  options: Array<RadioGroupOption>\n  /**\n   * Currently selected value\n   */\n  value?: string | null\n  /**\n   * Initially selected value\n   */\n  defaultValue?: string\n  /**\n   * Callback when selection changes\n   */\n  onChange?: (value: string) => void\n  /**\n   * React ref for the first radio input element\n   */\n  inputRef?: Ref<HTMLInputElement>\n}\n\n/**\n * Default prop values for the RadioGroup component.\n *\n * @internal\n */\nexport const RadioGroupDefaults = {\n  isRequired: false,\n  isInvalid: false,\n  isDisabled: false,\n  shouldVisuallyHideLabel: false,\n} as const satisfies Partial<RadioGroupProps>\n"],"names":["RadioGroupDefaults"],"mappings":"AA4EO,MAAMA,IAAqB;AAAA,EAChC,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,yBAAyB;AAC3B;"}
+{"version":3,"file":"RadioGroupTypes.js","sources":["../../../../../src/components/Common/UI/RadioGroup/RadioGroupTypes.ts"],"sourcesContent":["import type { FieldsetHTMLAttributes, Ref } from 'react'\nimport type { SharedFieldLayoutProps } from '@/components/Common/FieldLayout/FieldLayoutTypes'\n\n/**\n * Option entry your {@link RadioGroupProps | RadioGroup} implementation receives in the `options` array when rendering each radio button.\n *\n * @public\n * @childOf {@link RadioGroupProps}\n */\nexport interface RadioGroupOption {\n  /**\n   * Label text or content for the radio option\n   */\n  label: React.ReactNode\n  /**\n   * Value of the option that will be passed to onChange\n   */\n  value: string\n  /**\n   * Disables this specific radio option\n   */\n  isDisabled?: boolean\n  /**\n   * Optional description text for the radio option\n   */\n  description?: React.ReactNode\n}\n\n/**\n * Props your `RadioGroup` implementation must accept from the component adapter.\n * Renders a form field wrapping multiple `<input type=\"radio\" />` elements with a label, optional description, and error message.\n *\n * @public\n * @group Component props\n */\nexport interface RadioGroupProps\n  extends SharedFieldLayoutProps, Pick<FieldsetHTMLAttributes<HTMLFieldSetElement>, 'className'> {\n  /**\n   * Indicates that the field has an error\n   *\n   * @defaultValue `false`\n   */\n  isInvalid?: boolean\n  /**\n   * Disables all radio options in the group\n   *\n   * @defaultValue `false`\n   */\n  isDisabled?: boolean\n  /**\n   * Array of radio options to display\n   */\n  options: Array<RadioGroupOption>\n  /**\n   * Currently selected value\n   */\n  value?: string | null\n  /**\n   * Initially selected value\n   */\n  defaultValue?: string\n  /**\n   * Callback when selection changes\n   */\n  onChange?: (value: string) => void\n  /**\n   * React ref for the first radio input element\n   */\n  inputRef?: Ref<HTMLInputElement>\n}\n\n/**\n * Default prop values for the RadioGroup component.\n *\n * @internal\n */\nexport const RadioGroupDefaults = {\n  isRequired: false,\n  isInvalid: false,\n  isDisabled: false,\n  shouldVisuallyHideLabel: false,\n} as const satisfies Partial<RadioGroupProps>\n"],"names":["RadioGroupDefaults"],"mappings":"AA4EO,MAAMA,IAAqB;AAAA,EAChC,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,yBAAyB;AAC3B;"}