@ostack.tech/ui 0.6.4 → 0.7.0

package/dist/types/components/Button/Button.d.ts

@@ -70,25 +70,50 @@ export interface ButtonProps extends ComponentPropsWithoutRef<"button"> {
      */
     disabled?: boolean;
     /**
-     * Whether to display the button in "loading" state by presenting a spinner as
-     * icon. The position of the spinner may be controlled via `iconPlacement`.
+     * Renders the button in a **loading** state.
      *
-     * Setting this property will automatically disable the button.
+     * When `true`, the button is “soft-disabled”: it looks disabled and ignores
+     * user interaction but remains focusable. By default, a spinner is shown as
+     * the button's icon (_i.e._, `showSpinner` is set to `true` unless
+     * overridden).
      *
-     * @default false
-     */
-    loading?: boolean;
-    /**
-     * Whether the button should be enabled when `loading` is `true`.
+     * The button's content while loading can be controlled via `loadingContent`.
+     * The position of the spinner may be controlled via `iconPlacement`.
+     *
+     * To only show a spinner without “soft-disabling” the button, set
+     * `showSpinner` instead.
+     *
+     * @example
+     *
+     * ```tsx
+     * <Button loading={saving} loadingContent="Saving…">
+     *   Save
+     * </Button>;
+     * ```
      *
      * @default false
      */
-    enabledWhenLoading?: boolean;
+    loading?: boolean;
     /**
-     * Content of the button when it is in "loading" state. If not provided, the
+     * Content of the button when it is in “loading” state. If not provided, the
      * button content will remain unchanged.
      */
     loadingContent?: ReactNode;
+    /**
+     * Whether to show a spinner as the button's icon.
+     *
+     * Defaults to the value of the `loading` property. In most cases, prefer
+     * `loading`, which also “soft-disables” the button.
+     *
+     * Use `showSpinner` when you want a spinner **without** “soft-disabling” the
+     * button. To “soft-disable” **without** a spinner, set `loading` to `true`
+     * and `showSpinner` to `false`.
+     *
+     * The position of the spinner may be controlled via `iconPlacement`.
+     *
+     * @default loading
+     */
+    showSpinner?: boolean;
     /** Properties to pass to the icon component. */
     iconProps?: Omit<ComponentPropsWithRef<typeof Icon>, "icon">;
     /** Properties to pass to the spinner component. */

package/dist/types/components/Checkbox/Checkbox.d.ts

@@ -21,12 +21,36 @@ export interface CheckboxProps extends Omit<ComponentPropsWithoutRef<typeof Chec
     /** Sets the checkbox as read-only. */
     readOnly?: boolean;
     /**
-     * Adds a spinner to the checkbox to indicate activity. Note that it doesn't
-     * automatically disable the checkbox.
+     * Renders the checkbox in a **loading** state.
+     *
+     * When `true`, the checkbox is “soft-disabled”: it looks disabled and ignores
+     * user interaction but remains focusable. By default, a spinner is shown
+     * (_i.e._, `showSpinner` is set to `true` unless overridden).
+     *
+     * The checkbox's accessible description while loading can be controlled via
+     * `loadingDescription`.
+     *
+     * To only show a spinner without “soft-disabling” the checkbox, set
+     * `showSpinner` instead.
      *
      * @default false
      */
     loading?: boolean;
+    /** Accessible description of the checkbox when it is in a “loading” state. */
+    loadingDescription?: ReactNode;
+    /**
+     * Whether to show a spinner next to the checkbox.
+     *
+     * Defaults to the value of the `loading` property. In most cases, prefer
+     * `loading`, which also “soft-disables” the checkbox.
+     *
+     * Use `showSpinner` when you want a spinner **without** “soft-disabling” the
+     * checkbox. To “soft-disable” **without** a spinner, set `loading` to `true`
+     * and `showSpinner` to `false`.
+     *
+     * @default loading
+     */
+    showSpinner?: boolean;
     /**
      * Function called when the focus moves out of the control as a whole.
      *

package/dist/types/components/CheckboxGroup/CheckboxGroup.d.ts

@@ -21,12 +21,39 @@ export interface CheckboxGroupProps extends ComponentPropsWithoutRef<"div"> {
     /** Checkbox group name. */
     name?: string;
     /**
-     * Adds a spinner to the checkbox group to indicate activity. Note that it
-     * doesn't automatically disable the control.
+     * Renders the checkbox group in a **loading** state.
+     *
+     * When `true`, the checkbox group is “soft-disabled”: it looks disabled and
+     * ignores user interaction but remains focusable. By default, a spinner is
+     * shown (_i.e._, `showSpinner` is set to `true` unless overridden).
+     *
+     * The checkbox group's accessible description while loading can be controlled
+     * via `loadingDescription`.
+     *
+     * To only show a spinner without “soft-disabling” the checkbox group, set
+     * `showSpinner` instead.
      *
      * @default false
      */
     loading?: boolean;
+    /**
+     * Accessible description of the checkbox group when it is in a “loading”
+     * state.
+     */
+    loadingDescription?: ReactNode;
+    /**
+     * Whether to show a spinner next to the checkbox group.
+     *
+     * Defaults to the value of the `loading` property. In most cases, prefer
+     * `loading`, which also “soft-disables” the checkbox group.
+     *
+     * Use `showSpinner` when you want a spinner **without** “soft-disabling” the
+     * checkbox group. To “soft-disable” **without** a spinner, set `loading` to
+     * `true` and `showSpinner` to `false`.
+     *
+     * @default loading
+     */
+    showSpinner?: boolean;
     /** Whether the field is required. */
     required?: boolean;
     /** Whether to disable the checkbox group. */

package/dist/types/components/CheckboxGroup/CheckboxGroupContext.d.ts

@@ -2,6 +2,10 @@ export interface CheckboxGroupContextValue {
     name?: string;
     value: string[];
     onCheckedChange: (value: string, checked: boolean) => void;
+    loadingDescriptionId?: string;
+    errorMessageIds?: string[];
+    ariaDescribedBy?: string;
+    descriptionIds?: string[];
 }
 /** Checkbox group context. */
 export declare const CheckboxGroupContext: import('react').Context<CheckboxGroupContextValue | null>;

package/dist/types/components/CommandMenu/CommandMenuItem.d.ts

@@ -1,7 +1,7 @@
 import { Command as CommandPrimitive } from 'cmdk';
 import { ComponentPropsWithoutRef } from 'react';
 import { MenuListItemProps } from '../MenuList';
-export interface CommandMenuItemProps extends Omit<ComponentPropsWithoutRef<typeof CommandPrimitive.Item>, "asChild" | "color">, Pick<MenuListItemProps, "selected" | "color" | "loading" | "enabledWhenLoading" | "loadingContent" | "icon" | "iconPlacement" | "href" | "target" | "rel" | "actionProps" | "contentProps" | "iconProps" | "spinnerProps"> {
+export interface CommandMenuItemProps extends Omit<ComponentPropsWithoutRef<typeof CommandPrimitive.Item>, "asChild" | "color">, Pick<MenuListItemProps, "selected" | "color" | "loading" | "loadingContent" | "showSpinner" | "icon" | "iconPlacement" | "href" | "target" | "rel" | "actionProps" | "contentProps" | "iconProps" | "spinnerProps"> {
     /**
      * Render the item as a link. When set, you can pass `href`, `target`, and
      * `rel` properties to the item.

package/dist/types/components/DateRangeInput/DateRangeInput.d.ts

@@ -54,26 +54,61 @@ export interface DateRangeInputProps extends Omit<ComponentPropsWithoutRef<"div"
     /** Maximum year allowed. */
     maxYear?: number;
     /**
-     * Adds a spinner to the start/end inputs to indicate activity. Note that it
-     * doesn't automatically disable the input.
+     * Renders the date-range input in a **loading** state.
+     *
+     * When `true`, the date-range input is “soft-disabled”: it looks disabled and
+     * ignores user interaction but remains focusable. By default, spinners are
+     * shown (_i.e._, `showSpinners` is set to `true` unless overridden).
+     *
+     * The date-range input's accessible description while loading can be
+     * controlled via `loadingDescription`.
+     *
+     * To only show spinners without “soft-disabling” the date-range input, set
+     * `showSpinners` instead.
+     *
+     * @example
+     *
+     * ```tsx
+     * <DateRangeInput loading={fetching} loadingDescription="Fetching…" />;
+     * ```
      *
      * @default false
      */
     loading?: boolean;
     /**
-     * Adds a spinner to the start input to indicate activity. Note that it
-     * doesn't automatically disable the input.
+     * Accessible description of the date-range input when it is in a “loading”
+     * state.
+     */
+    loadingDescription?: ReactNode;
+    /**
+     * Whether to show spinners in the start and end parts of the date-range
+     * input.
+     *
+     * Defaults to the value of the `loading` property. In most cases, prefer
+     * `loading`, which also “soft-disables” the date-range input.
+     *
+     * Use `showSpinners` when you want spinners **without** “soft-disabling” the
+     * date-range input. To “soft-disable” **without** spinners, set `loading` to
+     * `true` and `showSpinners` to `false`.
+     *
+     * Use `showStartSpinner` or `showEndSpinner` to individually control whether
+     * to show a spinner in the start or end parts of the date-range input.
      *
      * @default loading
      */
-    startLoading?: boolean;
+    showSpinners?: boolean;
     /**
-     * Adds a spinner to the end input to indicate activity. Note that it doesn't
-     * automatically disable the input.
+     * Whether to show the start input spinner.
      *
-     * @default loading
+     * @default showSpinners
+     */
+    showStartSpinner?: boolean;
+    /**
+     * Whether to show the end input spinner.
+     *
+     * @default showSpinners
      */
-    endLoading?: boolean;
+    showEndSpinner?: boolean;
     /** Sets the inputs' text align. */
     align?: Responsive<CSSProperties["textAlign"]>;
     /** Date-range input's start adornment. */
@@ -104,17 +139,17 @@ export interface DateRangeInputProps extends Omit<ComponentPropsWithoutRef<"div"
      */
     fullFormat?: string;
     /** Description of the short format provided to assistive technologies. */
-    formatDescription?: string;
+    formatDescription?: ReactNode;
     /**
      * Label announced to assistive technologies for the start input (so that the
      * user knows that they are interacting with the start input).
      */
-    startInputLabel?: string;
+    startInputLabel?: ReactNode;
     /**
      * Label announced to assistive technologies for the end input (so that the
      * user knows that they are interacting with the end input).
      */
-    endInputLabel?: string;
+    endInputLabel?: ReactNode;
     /**
      * Function that should return the label to provide to the button that opens
      * the input's calendar.

package/dist/types/components/DropdownMenu/DropdownMenuCheckboxItem.d.ts

@@ -4,7 +4,7 @@ import { CheckboxChecked } from '../Checkbox';
 import { Icon } from '../Icon';
 import { MenuListItemProps } from '../MenuList';
 /** Properties of the dropdown menu checkbox item. */
-export interface DropdownMenuCheckboxItemProps extends Omit<ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.CheckboxItem>, "asChild" | "color">, Pick<MenuListItemProps, "color" | "loading" | "enabledWhenLoading" | "loadingContent" | "iconPlacement" | "actionProps" | "contentProps" | "iconProps" | "spinnerProps"> {
+export interface DropdownMenuCheckboxItemProps extends Omit<ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.CheckboxItem>, "asChild" | "color">, Pick<MenuListItemProps, "color" | "loading" | "loadingContent" | "showSpinner" | "iconPlacement" | "actionProps" | "contentProps" | "iconProps" | "spinnerProps"> {
     /**
      * Whether to show the checkbox.
      *

package/dist/types/components/DropdownMenu/DropdownMenuItem.d.ts

@@ -2,7 +2,7 @@ import { DropdownMenu as DropdownMenuPrimitive } from 'radix-ui';
 import { ComponentPropsWithoutRef } from 'react';
 import { MenuListItemProps } from '../MenuList';
 /** Properties of the dropdown menu item. */
-export interface DropdownMenuItemProps extends Omit<ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Item>, "asChild" | "color">, Pick<MenuListItemProps, "selected" | "color" | "loading" | "enabledWhenLoading" | "loadingContent" | "icon" | "iconPlacement" | "href" | "target" | "rel" | "actionProps" | "contentProps" | "iconProps" | "spinnerProps"> {
+export interface DropdownMenuItemProps extends Omit<ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Item>, "asChild" | "color">, Pick<MenuListItemProps, "selected" | "color" | "loading" | "loadingContent" | "showSpinner" | "icon" | "iconPlacement" | "href" | "target" | "rel" | "actionProps" | "contentProps" | "iconProps" | "spinnerProps"> {
     /**
      * Render the item as a link. When set, you can pass `href`, `target`, and
      * `rel` properties to the item.

package/dist/types/components/DropdownMenu/DropdownMenuRadioItem.d.ts

@@ -2,7 +2,7 @@ import { DropdownMenu as DropdownMenuPrimitive } from 'radix-ui';
 import { ComponentPropsWithoutRef, ComponentPropsWithRef } from 'react';
 import { MenuListItemProps } from '../MenuList';
 /** Properties of the dropdown menu radio item. */
-export interface DropdownMenuRadioItemProps extends Omit<ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.RadioItem>, "asChild" | "color">, Pick<MenuListItemProps, "color" | "loading" | "enabledWhenLoading" | "loadingContent" | "iconPlacement" | "actionProps" | "contentProps" | "iconProps" | "spinnerProps"> {
+export interface DropdownMenuRadioItemProps extends Omit<ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.RadioItem>, "asChild" | "color">, Pick<MenuListItemProps, "color" | "loading" | "loadingContent" | "showSpinner" | "iconPlacement" | "actionProps" | "contentProps" | "iconProps" | "spinnerProps"> {
     /**
      * Whether to show the radio.
      *

package/dist/types/components/Field/FieldContext.d.ts

@@ -61,6 +61,7 @@ export declare function useFieldDescriptionIds(): string[] | undefined;
 export declare function useFieldErrorMessageIds(): string[] | undefined;
 /** Hook that makes a field aware of its control's information. */
 export declare function useSetFieldControl(controlId: string | undefined, controlTagName: string | undefined, controlCodeId: string | undefined, controlHasCode?: boolean | undefined, controlRequired?: boolean | undefined): {
+    generatedId: string;
     controlId: string;
     codeId: string | undefined;
 };

package/dist/types/components/IconButton/IconButton.d.ts

@@ -61,23 +61,50 @@ export interface IconButtonProps extends Omit<ComponentPropsWithoutRef<"button">
      */
     disabled?: boolean;
     /**
-     * Whether to display the button in "loading" state. This makes it so the icon
-     * button displays a spinner instead of its icon.
+     * Renders the icon button in a **loading** state.
      *
-     * @default false
-     */
-    loading?: boolean;
-    /**
-     * Whether the icon button should be enabled when `loading` is `true`.
+     * When `true`, the button is “soft-disabled”: it looks disabled and ignores
+     * user interaction but remains focusable. By default, a spinner is shown as
+     * the button's icon (_i.e._, `showSpinner` is set to `true` unless
+     * overridden).
+     *
+     * The button's label while loading can be controlled via `loadingLabel`.
+     *
+     * To only show a spinner without “soft-disabling” the button, set
+     * `showSpinner` instead.
+     *
+     * @example
+     *
+     * ```tsx
+     * <IconButton
+     *   icon={faFloppyDisk}
+     *   label="Save"
+     *   loading={saving}
+     *   loadingLabel="Saving…"
+     * />;
+     * ```
      *
      * @default false
      */
-    enabledWhenLoading?: boolean;
+    loading?: boolean;
     /**
      * Label of the icon button when it is in "loading" state. If not provided,
      * the label will remain unchanged.
      */
     loadingLabel?: ReactNode;
+    /**
+     * Whether to show a spinner as the icon button's icon.
+     *
+     * Defaults to the value of the `loading` property. In most cases, prefer
+     * `loading`, which also “soft-disables” the button.
+     *
+     * Use `showSpinner` when you want a spinner **without** “soft-disabling” the
+     * button. To “soft-disable” **without** a spinner, set `loading` to `true`
+     * and `showSpinner` to `false`.
+     *
+     * @default loading
+     */
+    showSpinner?: boolean;
     /**
      * Whether to disable showing the icon button's label in a tooltip. Disabling
      * the tooltip does **not** affect the button's accessibility.

package/dist/types/components/Input/Input.d.ts

@@ -27,12 +27,42 @@ export interface InputPropsBase {
     /** Input code. */
     code?: ReactNode;
     /**
-     * Adds a spinner to the input to indicate activity. Note that it doesn't
-     * automatically disable the input.
+     * Renders the input in a **loading** state.
+     *
+     * When `true`, the input is “soft-disabled”: it looks disabled and ignores
+     * user interaction but remains focusable. By default, a spinner is shown
+     * (_i.e._, `showSpinner` is set to `true` unless overridden).
+     *
+     * The input's accessible description while loading can be controlled via
+     * `loadingDescription`.
+     *
+     * To only show a spinner without “soft-disabling” the input, set
+     * `showSpinner` instead.
+     *
+     * @example
+     *
+     * ```tsx
+     * <Input loading={fetching} loadingDescription="Fetching…" />;
+     * ```
      *
      * @default false
      */
     loading?: boolean;
+    /** Accessible description of the input when it is in a “loading” state. */
+    loadingDescription?: ReactNode;
+    /**
+     * Whether to show a spinner in the input.
+     *
+     * Defaults to the value of the `loading` property. In most cases, prefer
+     * `loading`, which also “soft-disables” the input.
+     *
+     * Use `showSpinner` when you want a spinner **without** “soft-disabling” the
+     * input. To “soft-disable” **without** a spinner, set `loading` to `true` and
+     * `showSpinner` to `false`.
+     *
+     * @default loading
+     */
+    showSpinner?: boolean;
     /** Sets the input's text align. */
     align?: Responsive<CSSProperties["textAlign"]>;
     /** Input's start adornment. */

package/dist/types/components/MenuList/MenuListItem.d.ts

@@ -30,25 +30,48 @@ export interface MenuListItemProps extends Omit<ComponentPropsWithoutRef<"li">,
     /** Accent colour of the menu list item. */
     color?: MenuListItemColor;
     /**
-     * Whether to display the item in "loading" state by presenting a spinner as
-     * icon. The position of the spinner may be controlled via `iconPlacement`.
-     *
-     * Setting this property will automatically disable the item.
+     * Whether the item should be disabled.
      *
      * @default false
      */
-    loading?: boolean;
+    disabled?: boolean;
     /**
-     * Whether the item should be enabled when `loading` is `true`.
+     * Renders the item in a **loading** state.
+     *
+     * When `true`, the item is “soft-disabled”: it looks disabled and ignores
+     * user interaction but remains focusable. By default, a spinner is shown as
+     * the item's icon (_i.e._, `showSpinner` is set to `true` unless
+     * overridden).
+     *
+     * The item's content while loading can be controlled via `loadingContent`.
+     * The position of the spinner may be controlled via `iconPlacement`.
+     *
+     * To only show a spinner without “soft-disabling” the item, set `showSpinner`
+     * instead.
      *
      * @default false
      */
-    enabledWhenLoading?: boolean;
+    loading?: boolean;
     /**
      * Content of the item when it is in "loading" state. If not provided, the
      * item content will remain unchanged.
      */
     loadingContent?: ReactNode;
+    /**
+     * Whether to show a spinner as the item's icon.
+     *
+     * Defaults to the value of the `loading` property. In most cases, prefer
+     * `loading`, which also “soft-disables” the item.
+     *
+     * Use `showSpinner` when you want a spinner **without** “soft-disabling” the
+     * item. To “soft-disable” **without** a spinner, set `loading` to `true` and
+     * `showSpinner` to `false`.
+     *
+     * The position of the spinner may be controlled via `iconPlacement`.
+     *
+     * @default loading
+     */
+    showSpinner?: boolean;
     /**
      * Optional item icon.
      *
@@ -61,12 +84,6 @@ export interface MenuListItemProps extends Omit<ComponentPropsWithoutRef<"li">,
      * @default start
      */
     iconPlacement?: MenuListIconPlacement;
-    /**
-     * Whether the item should be disabled.
-     *
-     * @default false
-     */
-    disabled?: boolean;
     /** Href for the link, when `itemType` is set to `"link"`. */
     href?: ComponentProps<"a">["href"];
     /** Target of the link, when `itemType` is set to `"link"`. */

package/dist/types/components/Output/Output.d.ts

@@ -1,7 +1,25 @@
-import { ComponentPropsWithoutRef } from 'react';
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
 import { InputPropsBase } from '../Input';
 /** Properties of the output component. */
-export interface OutputProps extends Omit<InputPropsBase, "asChild" | "children" | "showClearButton" | "clearButtonLabel">, ComponentPropsWithoutRef<"output"> {
+export interface OutputProps extends Omit<InputPropsBase, "asChild" | "disabled" | "loading" | "loadingDescription" | "showClearButton" | "clearButtonLabel" | "onValueChange" | "onBlurToOutside" | "clearButtonProps" | "children">, ComponentPropsWithoutRef<"output"> {
+    /**
+     * Renders the output in a **pending** state.
+     *
+     * When `true`, the value should be treated as not final (for example, it is
+     * still being calculated or refreshed). While pending, the output is marked
+     * as busy for assistive technologies.
+     *
+     * The output's content while pending can be controlled via `pendingContent`.
+     *
+     * To show a spinner without marking the output as `pending`, set
+     * `showSpinner` instead.
+     */
+    pending?: boolean;
+    /**
+     * Content to show while the output is in a **pending** state. If not
+     * provided, the output content will remain unchanged.
+     */
+    pendingContent?: ReactNode;
 }
 /**
  * The output component is used to display the result of a calculation or user

package/dist/types/components/RadioGroup/Radio.d.ts

@@ -15,12 +15,36 @@ export interface RadioProps extends Omit<ComponentPropsWithoutRef<typeof RadioGr
     /** Sets the radio as read-only. */
     readOnly?: boolean;
     /**
-     * Adds a spinner to the checkbox to indicate activity. Note that it doesn't
-     * automatically disable the checkbox.
+     * Renders the radio in a **loading** state.
+     *
+     * When `true`, the radio is “soft-disabled”: it looks disabled and ignores
+     * user interaction but remains focusable. By default, a spinner is shown
+     * (_i.e._, `showSpinner` is set to `true` unless overridden).
+     *
+     * The radio's accessible description while loading can be controlled via
+     * `loadingDescription`.
+     *
+     * To only show a spinner without “soft-disabling” the radio, set
+     * `showSpinner` instead.
      *
      * @default false
      */
     loading?: boolean;
+    /** Accessible description of the radio when it is in a “loading” state. */
+    loadingDescription?: ReactNode;
+    /**
+     * Whether to show a spinner next to the radio.
+     *
+     * Defaults to the value of the `loading` property. In most cases, prefer
+     * `loading`, which also “soft-disables” the radio.
+     *
+     * Use `showSpinner` when you want a spinner **without** “soft-disabling” the
+     * radio. To “soft-disable” **without** a spinner, set `loading` to `true` and
+     * `showSpinner` to `false`.
+     *
+     * @default loading
+     */
+    showSpinner?: boolean;
     /** Properties to pass to the root component. */
     rootProps?: ComponentPropsWithRef<"div">;
     /** Properties to pass to the code component. */

package/dist/types/components/RadioGroup/RadioGroup.d.ts

@@ -19,12 +19,36 @@ export interface RadioGroupProps extends Omit<ComponentPropsWithoutRef<typeof Ra
     /** Sets the radio group as read-only. */
     readOnly?: boolean;
     /**
-     * Adds a spinner to the radio group to indicate activity. Note that it
-     * doesn't automatically disable the control.
+     * Renders the radio group in a **loading** state.
+     *
+     * When `true`, the radio group is “soft-disabled”: it looks disabled and
+     * ignores user interaction but remains focusable. By default, a spinner is
+     * shown (_i.e._, `showSpinner` is set to `true` unless overridden).
+     *
+     * The radio group's accessible description while loading can be controlled
+     * via `loadingDescription`.
+     *
+     * To only show a spinner without “soft-disabling” the radio group, set
+     * `showSpinner` instead.
      *
      * @default false
      */
     loading?: boolean;
+    /** Accessible description of the radio group when it is in a “loading” state. */
+    loadingDescription?: ReactNode;
+    /**
+     * Whether to show a spinner next to the radio group.
+     *
+     * Defaults to the value of the `loading` property. In most cases, prefer
+     * `loading`, which also “soft-disables” the radio group.
+     *
+     * Use `showSpinner` when you want a spinner **without** “soft-disabling” the
+     * radio group. To “soft-disable” **without** a spinner, set `loading` to
+     * `true` and `showSpinner` to `false`.
+     *
+     * @default loading
+     */
+    showSpinner?: boolean;
     /** Radio group code. */
     code?: ReactNode;
     /**

package/dist/types/components/Select/Select.d.ts

@@ -5,7 +5,7 @@ import { Input } from '../Input';
 import { PopoverContent, PopoverTrigger } from '../Popover';
 import { Tag } from '../Tag';
 /** Base properties of the select component. */
-export interface SelectPropsBase<T extends string | number | readonly string[] = string | number | readonly string[]> extends ComponentPropsWithoutRef<typeof PopoverTrigger>, Pick<ComponentPropsWithoutRef<typeof Input>, "name" | "required" | "variant" | "status" | "code" | "readOnly" | "loading" | "align" | "startAdornment" | "endAdornment" | "showClearButton" | "onBlurToOutside" | "rootProps" | "codeProps" | "containerProps" | "clearButtonProps" | "spinnerProps">, Pick<ComponentPropsWithoutRef<typeof CommandMenu>, "searchPlaceholder" | "searchValue" | "onSearchValueChange"> {
+export interface SelectPropsBase<T extends string | number | readonly string[] = string | number | readonly string[]> extends ComponentPropsWithoutRef<typeof PopoverTrigger>, Pick<ComponentPropsWithoutRef<typeof Input>, "name" | "required" | "variant" | "status" | "code" | "readOnly" | "loading" | "loadingDescription" | "showSpinner" | "align" | "startAdornment" | "endAdornment" | "showClearButton" | "onBlurToOutside" | "rootProps" | "codeProps" | "containerProps" | "clearButtonProps" | "spinnerProps">, Pick<ComponentPropsWithoutRef<typeof CommandMenu>, "searchPlaceholder" | "searchValue" | "onSearchValueChange"> {
     /**
      * Whether multiple options can be selected. If not set, at most one option
      * can be selected at a time.

package/dist/types/index.d.ts

@@ -67,16 +67,17 @@ export * from './providers/PrefixProvider';
 export * from './providers/ToastManagerProvider';
 export * from './utils/boolDataAttr.ts';
 export * from './utils/breakpoints.ts';
+export * from './utils/combineAriaIds.ts';
 export * from './utils/combineEventHandlers.ts';
 export * from './utils/control.ts';
 export * from './utils/cx.ts';
 export * from './utils/filtering.ts';
 export * from './utils/keyboardShortcut.ts';
-export * from './utils/mergeAriaIds.ts';
 export * from './utils/nativeControls.ts';
 export * from './utils/navigate.ts';
 export * from './utils/numericStringUtils.ts';
 export * from './utils/parseDateStrict.ts';
+export * from './utils/setNativeProperty.ts';
 export * from './utils/sorting.ts';
 export * from './utils/stringHash.ts';
 export * from './utils/useCombinedRef.ts';

package/dist/types/providers/LocalizationProvider/LocalizationObject.d.ts

@@ -38,7 +38,7 @@ export interface LocalizationObject {
     Feedback: Pick<FeedbackProps, "visuallyHiddenPrefix">;
     FeedbackPopover: Pick<FeedbackPopoverProps, "label">;
     FieldGroupHeader: Pick<FieldGroupHeaderProps, "visuallyHiddenCodePrefix">;
-    Input: Pick<InputProps, "clearButtonLabel">;
+    Input: Pick<InputProps, "loadingDescription" | "clearButtonLabel">;
     Label: Pick<LabelProps, "requiredIconLabel" | "helperButtonLabel">;
     NumericInput: Pick<NumericInputProps, "decimalSeparator" | "groupingStyle" | "groupSeparator">;
     Select: Pick<SelectProps, "searchPlaceholder" | "emptyMessage" | "optionsLabel" | "loadingOptionsLabel">;

package/dist/types/utils/combineAriaIds.d.ts

@@ -0,0 +1,2 @@
+/** Combines `aria` identifiers for usage in, for example, `aria-describedby`. */
+export declare function combineAriaIds(...args: unknown[]): string | undefined;

package/dist/types/utils/control.d.ts

@@ -12,6 +12,7 @@ export interface ControlContextValue {
     variant?: ControlVariant;
     status?: ControlStatus;
     disabled?: boolean;
+    loading?: boolean;
     readOnly?: boolean;
 }
 /** Control context. */

package/dist/types/utils/setNativeProperty.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sets the native property of an HTML element in a way that bypasses React’s
+ * value tracker interference, meaning that we can then dispatch an event that
+ * React will handle.
+ *
+ * See: https://github.com/facebook/react/issues/10135
+ */
+export declare function setNativeProperty(element: HTMLElement, prop: string, value: unknown): void;