@gusto/embedded-react-sdk 0.52.0 → 0.52.2

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [0.52.2](https://github.com/Gusto/embedded-react-sdk/compare/v0.52.1...v0.52.2) (2026-07-17)
+
+### Features & Enhancements
+
+- The contractor W-9 signature form now shows an on-file SSN/EIN as a masked, disabled field with a "Change SSN"/"Change EIN" button, rather than exposing it as an editable value. ([#2406](https://github.com/Gusto/embedded-react-sdk/issues/2406))
+- While a contractor is mid self-onboarding, the admin's contractor list menu no longer offers "Edit" — only "Cancel self-onboarding" and "Delete" — so the admin must cancel self-onboarding to regain edit access. ([#2407](https://github.com/Gusto/embedded-react-sdk/issues/2407))
+- Admins editing a contractor's profile or address now see a warning when the contractor already has a signed W-9 on file, since the edit will require collecting an updated, signed W-9. ([#2394](https://github.com/Gusto/embedded-react-sdk/issues/2394))
+
+### Fixes
+
+- Fix `StateTaxes` getting stuck on the list view after clicking "Continue" — state rows are now still editable afterward instead of becoming permanently inert. ([#2416](https://github.com/Gusto/embedded-react-sdk/issues/2416))
+
+### Chores & Maintenance
+
+- Bump dev dependencies (`@typescript-eslint/parser`, `typescript-eslint`, `eslint-plugin-storybook`, `fuse.js`, `tsx`)
+
+## [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

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 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 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 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 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":";;;;;;;;;;;;;;AA+GO,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/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/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;"}

package/dist/components/Common/UI/Select/SelectTypes.d.ts

@@ -1,10 +1,10 @@
 import { Ref, SelectHTMLAttributes } from 'react';
 import { SharedFieldLayoutProps } from '../../FieldLayout/FieldLayoutTypes';
 /**
- * Option entry your `Select` implementation receives in the `options` array when rendering each item in the dropdown.
+ * Option entry your {@link SelectProps | Select} implementation receives in the `options` array when rendering each item in the dropdown.
  *
  * @public
- * @group Utility types
+ * @childOf {@link SelectProps}
  */
 export interface SelectOption {
     /**

package/dist/components/Common/UI/Table/TableTypes.d.ts

@@ -1,9 +1,9 @@
 import { ReactNode, TableHTMLAttributes } from 'react';
 /**
- * Shape of a single cell your `Table` implementation receives for headers, rows, and footers.
+ * Shape of a single cell your {@link TableProps | Table} implementation receives for headers, rows, and footers.
  *
  * @public
- * @group Utility types
+ * @childOf {@link TableProps}
  */
 export interface TableData {
     /**
@@ -16,10 +16,10 @@ export interface TableData {
     content: ReactNode;
 }
 /**
- * Shape of a single row your `Table` implementation receives, containing an ordered list of cells.
+ * Shape of a single row your {@link TableProps | Table} implementation receives, containing an ordered list of cells.
  *
  * @public
- * @group Utility types
+ * @childOf {@link TableProps}
  */
 export interface TableRow {
     /**

package/dist/components/Common/UI/Table/TableTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"TableTypes.js","sources":["../../../../../src/components/Common/UI/Table/TableTypes.ts"],"sourcesContent":["import type { ReactNode, TableHTMLAttributes } from 'react'\n\n/**\n * Shape of a single cell your `Table` implementation receives for headers, rows, and footers.\n *\n * @public\n * @group Utility types\n */\nexport interface TableData {\n  /**\n   * Unique identifier for the table cell\n   */\n  key: string\n  /**\n   * Content to be displayed in the table cell\n   */\n  content: ReactNode\n}\n\n/**\n * Shape of a single row your `Table` implementation receives, containing an ordered list of cells.\n *\n * @public\n * @group Utility types\n */\nexport interface TableRow {\n  /**\n   * Unique identifier for the table row\n   */\n  key: string\n  /**\n   * Array of cells to be displayed in the row\n   */\n  data: TableData[]\n}\n\n/**\n * Props your `Table` implementation must accept from the component adapter.\n * Renders a table with column headers, body rows, an optional footer row, and an optional empty state.\n *\n * @public\n * @group Component props\n */\nexport interface TableProps extends Pick<\n  TableHTMLAttributes<HTMLTableElement>,\n  'className' | 'aria-label' | 'id' | 'role' | 'aria-labelledby' | 'aria-describedby'\n> {\n  /**\n   * Array of header cells for the table\n   */\n  headers: TableData[]\n  /**\n   * Array of rows to be displayed in the table\n   */\n  rows: TableRow[]\n  /**\n   * Array of footer cells for the table\n   */\n  footer?: TableData[]\n  /**\n   * Content to display when the table has no rows\n   */\n  emptyState?: ReactNode\n  /**\n   * Removes borders and background for use inside a Box component\n   *\n   * @defaultValue `false`\n   */\n  isWithinBox?: boolean\n  /**\n   * Whether the first column contains checkboxes (affects which column gets leading variant)\n   *\n   * @defaultValue `false`\n   */\n  hasCheckboxColumn?: boolean\n}\n\n/**\n * Default prop values for the Table component.\n *\n * @internal\n */\nexport const TableDefaults = {\n  isWithinBox: false,\n  hasCheckboxColumn: false,\n} as const satisfies Partial<TableProps>\n"],"names":["TableDefaults"],"mappings":"AAkFO,MAAMA,IAAgB;AAAA,EAC3B,aAAa;AAAA,EACb,mBAAmB;AACrB;"}
+{"version":3,"file":"TableTypes.js","sources":["../../../../../src/components/Common/UI/Table/TableTypes.ts"],"sourcesContent":["import type { ReactNode, TableHTMLAttributes } from 'react'\n\n/**\n * Shape of a single cell your {@link TableProps | Table} implementation receives for headers, rows, and footers.\n *\n * @public\n * @childOf {@link TableProps}\n */\nexport interface TableData {\n  /**\n   * Unique identifier for the table cell\n   */\n  key: string\n  /**\n   * Content to be displayed in the table cell\n   */\n  content: ReactNode\n}\n\n/**\n * Shape of a single row your {@link TableProps | Table} implementation receives, containing an ordered list of cells.\n *\n * @public\n * @childOf {@link TableProps}\n */\nexport interface TableRow {\n  /**\n   * Unique identifier for the table row\n   */\n  key: string\n  /**\n   * Array of cells to be displayed in the row\n   */\n  data: TableData[]\n}\n\n/**\n * Props your `Table` implementation must accept from the component adapter.\n * Renders a table with column headers, body rows, an optional footer row, and an optional empty state.\n *\n * @public\n * @group Component props\n */\nexport interface TableProps extends Pick<\n  TableHTMLAttributes<HTMLTableElement>,\n  'className' | 'aria-label' | 'id' | 'role' | 'aria-labelledby' | 'aria-describedby'\n> {\n  /**\n   * Array of header cells for the table\n   */\n  headers: TableData[]\n  /**\n   * Array of rows to be displayed in the table\n   */\n  rows: TableRow[]\n  /**\n   * Array of footer cells for the table\n   */\n  footer?: TableData[]\n  /**\n   * Content to display when the table has no rows\n   */\n  emptyState?: ReactNode\n  /**\n   * Removes borders and background for use inside a Box component\n   *\n   * @defaultValue `false`\n   */\n  isWithinBox?: boolean\n  /**\n   * Whether the first column contains checkboxes (affects which column gets leading variant)\n   *\n   * @defaultValue `false`\n   */\n  hasCheckboxColumn?: boolean\n}\n\n/**\n * Default prop values for the Table component.\n *\n * @internal\n */\nexport const TableDefaults = {\n  isWithinBox: false,\n  hasCheckboxColumn: false,\n} as const satisfies Partial<TableProps>\n"],"names":["TableDefaults"],"mappings":"AAkFO,MAAMA,IAAgB;AAAA,EAC3B,aAAa;AAAA,EACb,mBAAmB;AACrB;"}

package/dist/components/Common/UI/Tabs/TabsTypes.d.ts

@@ -1,9 +1,9 @@
 import { ReactNode } from 'react';
 /**
- * Shape of a single tab configuration your `Tabs` implementation receives in its `tabs` prop.
+ * Shape of a single tab configuration your {@link TabsProps | Tabs} implementation receives in its `tabs` prop.
  *
  * @public
- * @group Utility types
+ * @childOf {@link TabsProps}
  */
 export interface TabProps {
     /**

package/dist/components/Company/DocumentSigner/shared/useSignCompanyForm/fields.js

@@ -1,11 +1,11 @@
 import { jsx as o } from "react/jsx-runtime";
-import { CheckboxHookField as e } from "../../../../../partner-hook-utils/form/fields/CheckboxHookField.js";
-import { TextInputHookField as i } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
+import { TextInputHookField as e } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
+import { CheckboxHookField as i } from "../../../../../partner-hook-utils/form/fields/CheckboxHookField.js";
 function u(r) {
-  return /* @__PURE__ */ o(i, { ...r, name: "signature" });
+  return /* @__PURE__ */ o(e, { ...r, name: "signature" });
 }
 function f(r) {
-  return /* @__PURE__ */ o(e, { ...r, name: "confirmSignature" });
+  return /* @__PURE__ */ o(i, { ...r, name: "confirmSignature" });
 }
 export {
   f as ConfirmSignatureField,

package/dist/components/Company/PaySchedule/shared/usePayScheduleForm/fields.js

@@ -1,17 +1,17 @@
 import { jsx as o } from "react/jsx-runtime";
+import { TextInputHookField as t } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
+import { SelectHookField as i } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
 import { NumberInputHookField as n } from "../../../../../partner-hook-utils/form/fields/NumberInputHookField.js";
 import { DatePickerHookField as r } from "../../../../../partner-hook-utils/form/fields/DatePickerHookField.js";
-import { RadioGroupHookField as t } from "../../../../../partner-hook-utils/form/fields/RadioGroupHookField.js";
-import { SelectHookField as i } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
-import { TextInputHookField as m } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
+import { RadioGroupHookField as m } from "../../../../../partner-hook-utils/form/fields/RadioGroupHookField.js";
 function F(e) {
-  return /* @__PURE__ */ o(m, { ...e, name: "customName" });
+  return /* @__PURE__ */ o(t, { ...e, name: "customName" });
 }
 function p(e) {
   return /* @__PURE__ */ o(i, { ...e, name: "frequency" });
 }
 function y(e) {
-  return /* @__PURE__ */ o(t, { ...e, name: "customTwicePerMonth" });
+  return /* @__PURE__ */ o(m, { ...e, name: "customTwicePerMonth" });
 }
 function P(e) {
   return /* @__PURE__ */ o(r, { ...e, name: "anchorPayDate" });

package/dist/components/Company/StateTaxes/stateTaxesStateMachine.d.ts

@@ -2,5 +2,4 @@
 export declare const stateTaxesStateMachine: {
     viewStateTaxes: import('robot3').MachineState<any>;
     editStateTaxes: import('robot3').MachineState<any>;
-    done: import('robot3').MachineState<any>;
 };

package/dist/components/Company/StateTaxes/stateTaxesStateMachine.js

@@ -1,26 +1,25 @@
-import { state as o, transition as e, reduce as T } from "robot3";
+import { state as T, transition as e, reduce as a } from "robot3";
 import { StateTaxesListContextual as n, StateTaxesFormContextual as i } from "./StateTaxesComponents.js";
-import { componentEvents as a } from "../../../shared/constants.js";
+import { componentEvents as o } from "../../../shared/constants.js";
 const S = {
-  viewStateTaxes: o(
+  viewStateTaxes: T(
     e(
-      a.COMPANY_STATE_TAX_EDIT,
+      o.COMPANY_STATE_TAX_EDIT,
       "editStateTaxes",
-      T(
+      a(
         (t, s) => ({
           ...t,
           component: i,
           state: s.payload.state
         })
       )
-    ),
-    e(a.COMPANY_STATE_TAX_DONE, "done")
+    )
   ),
-  editStateTaxes: o(
+  editStateTaxes: T(
     e(
-      a.COMPANY_STATE_TAX_UPDATED,
+      o.COMPANY_STATE_TAX_UPDATED,
       "viewStateTaxes",
-      T(
+      a(
         (t, s) => ({
           ...t,
           component: n,
@@ -29,16 +28,15 @@ const S = {
       )
     ),
     e(
-      a.CANCEL,
+      o.CANCEL,
       "viewStateTaxes",
-      T((t) => ({
+      a((t) => ({
         ...t,
         component: n,
         state: void 0
       }))
     )
-  ),
-  done: o()
+  )
 };
 export {
   S as stateTaxesStateMachine

package/dist/components/Company/StateTaxes/stateTaxesStateMachine.js.map

@@ -1 +1 @@
-{"version":3,"file":"stateTaxesStateMachine.js","sources":["../../../../src/components/Company/StateTaxes/stateTaxesStateMachine.tsx"],"sourcesContent":["import { reduce, state, state as final, transition } from 'robot3'\nimport type { ComponentType } from 'react'\nimport type { StateTaxesContextInterface } from './StateTaxesComponents'\nimport { StateTaxesFormContextual, StateTaxesListContextual } from './StateTaxesComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineEventType, MachineTransition } from '@/types/Helpers'\n\ntype EventPayloads = {\n  [componentEvents.COMPANY_STATE_TAX_UPDATED]: undefined\n  [componentEvents.COMPANY_STATE_TAX_EDIT]: { state: string }\n}\n\n/** @internal */\nexport const stateTaxesStateMachine = {\n  viewStateTaxes: state<MachineTransition>(\n    transition(\n      componentEvents.COMPANY_STATE_TAX_EDIT,\n      'editStateTaxes',\n      reduce(\n        (\n          ctx: StateTaxesContextInterface,\n          ev: MachineEventType<EventPayloads, typeof componentEvents.COMPANY_STATE_TAX_EDIT>,\n        ): StateTaxesContextInterface => ({\n          ...ctx,\n          component: StateTaxesFormContextual as ComponentType,\n          state: ev.payload.state,\n        }),\n      ),\n    ),\n    transition(componentEvents.COMPANY_STATE_TAX_DONE, 'done'),\n  ),\n  editStateTaxes: state<MachineTransition>(\n    transition(\n      componentEvents.COMPANY_STATE_TAX_UPDATED,\n      'viewStateTaxes',\n      reduce(\n        (\n          ctx: StateTaxesContextInterface,\n          ev: MachineEventType<EventPayloads, typeof componentEvents.COMPANY_STATE_TAX_UPDATED>,\n        ): StateTaxesContextInterface => ({\n          ...ctx,\n          component: StateTaxesListContextual as ComponentType,\n          state: undefined,\n        }),\n      ),\n    ),\n    transition(\n      componentEvents.CANCEL,\n      'viewStateTaxes',\n      reduce((ctx: StateTaxesContextInterface): StateTaxesContextInterface => ({\n        ...ctx,\n        component: StateTaxesListContextual as ComponentType,\n        state: undefined,\n      })),\n    ),\n  ),\n  done: final(),\n}\n"],"names":["stateTaxesStateMachine","state","transition","componentEvents","reduce","ctx","ev","StateTaxesFormContextual","StateTaxesListContextual","final"],"mappings":";;;AAaO,MAAMA,IAAyB;AAAA,EACpC,gBAAgBC;AAAA,IACdC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CACEC,GACAC,OACgC;AAAA,UAChC,GAAGD;AAAA,UACH,WAAWE;AAAA,UACX,OAAOD,EAAG,QAAQ;AAAA,QAAA;AAAA,MACpB;AAAA,IACF;AAAA,IAEFJ,EAAWC,EAAgB,wBAAwB,MAAM;AAAA,EAAA;AAAA,EAE3D,gBAAgBF;AAAA,IACdC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CACEC,GACAC,OACgC;AAAA,UAChC,GAAGD;AAAA,UACH,WAAWG;AAAA,UACX,OAAO;AAAA,QAAA;AAAA,MACT;AAAA,IACF;AAAA,IAEFN;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAiE;AAAA,QACvE,GAAGA;AAAA,QACH,WAAWG;AAAA,QACX,OAAO;AAAA,MAAA,EACP;AAAA,IAAA;AAAA,EACJ;AAAA,EAEF,MAAMC,EAAA;AACR;"}
+{"version":3,"file":"stateTaxesStateMachine.js","sources":["../../../../src/components/Company/StateTaxes/stateTaxesStateMachine.tsx"],"sourcesContent":["import { reduce, state, transition } from 'robot3'\nimport type { ComponentType } from 'react'\nimport type { StateTaxesContextInterface } from './StateTaxesComponents'\nimport { StateTaxesFormContextual, StateTaxesListContextual } from './StateTaxesComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineEventType, MachineTransition } from '@/types/Helpers'\n\ntype EventPayloads = {\n  [componentEvents.COMPANY_STATE_TAX_UPDATED]: undefined\n  [componentEvents.COMPANY_STATE_TAX_EDIT]: { state: string }\n}\n\n/** @internal */\nexport const stateTaxesStateMachine = {\n  viewStateTaxes: state<MachineTransition>(\n    transition(\n      componentEvents.COMPANY_STATE_TAX_EDIT,\n      'editStateTaxes',\n      reduce(\n        (\n          ctx: StateTaxesContextInterface,\n          ev: MachineEventType<EventPayloads, typeof componentEvents.COMPANY_STATE_TAX_EDIT>,\n        ): StateTaxesContextInterface => ({\n          ...ctx,\n          component: StateTaxesFormContextual as ComponentType,\n          state: ev.payload.state,\n        }),\n      ),\n    ),\n  ),\n  editStateTaxes: state<MachineTransition>(\n    transition(\n      componentEvents.COMPANY_STATE_TAX_UPDATED,\n      'viewStateTaxes',\n      reduce(\n        (\n          ctx: StateTaxesContextInterface,\n          ev: MachineEventType<EventPayloads, typeof componentEvents.COMPANY_STATE_TAX_UPDATED>,\n        ): StateTaxesContextInterface => ({\n          ...ctx,\n          component: StateTaxesListContextual as ComponentType,\n          state: undefined,\n        }),\n      ),\n    ),\n    transition(\n      componentEvents.CANCEL,\n      'viewStateTaxes',\n      reduce((ctx: StateTaxesContextInterface): StateTaxesContextInterface => ({\n        ...ctx,\n        component: StateTaxesListContextual as ComponentType,\n        state: undefined,\n      })),\n    ),\n  ),\n}\n"],"names":["stateTaxesStateMachine","state","transition","componentEvents","reduce","ctx","ev","StateTaxesFormContextual","StateTaxesListContextual"],"mappings":";;;AAaO,MAAMA,IAAyB;AAAA,EACpC,gBAAgBC;AAAA,IACdC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CACEC,GACAC,OACgC;AAAA,UAChC,GAAGD;AAAA,UACH,WAAWE;AAAA,UACX,OAAOD,EAAG,QAAQ;AAAA,QAAA;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AAAA,EAEF,gBAAgBL;AAAA,IACdC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CACEC,GACAC,OACgC;AAAA,UAChC,GAAGD;AAAA,UACH,WAAWG;AAAA,UACX,OAAO;AAAA,QAAA;AAAA,MACT;AAAA,IACF;AAAA,IAEFN;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAiE;AAAA,QACvE,GAAGA;AAAA,QACH,WAAWG;AAAA,QACX,OAAO;AAAA,MAAA,EACP;AAAA,IAAA;AAAA,EACJ;AAEJ;"}