@allxsmith/bestax-bulma 5.19.0 → 5.22.0

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

@@ -6,14 +6,21 @@ import { BulmaClassesProps } from '../helpers/useBulmaClasses.js';
  * @extraProp {string} [className] - Additional CSS classes.
  */
 export interface CollapseProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'color'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
-    /** Controlled open state. If provided, component is controlled. */
+    /**
+     * Controlled open state. If provided, component is controlled, and the
+     * trigger only reports through `onOpenChange`. Inside a `Collapses` group, a
+     * Collapse that sets `open` stays yours: the group neither overrides it nor
+     * closes it when another item opens.
+     */
     open?: boolean;
-    /** Initial open state for uncontrolled usage. */
+    /** Initial open state for uncontrolled usage. Ignored inside a `Collapses` group, whose `defaultValue` decides. */
     defaultOpen?: boolean;
-    /** Callback when collapse opens. */
+    /** Called when the trigger opens the Collapse. Fires only while the Collapse keeps its own state: not when `open` is set, and not when a `Collapses` group manages it. `onOpenChange` reports in every mode. */
     onOpen?: () => void;
-    /** Callback when collapse closes. */
+    /** Called when the trigger closes the Collapse. Fires only while the Collapse keeps its own state: not when `open` is set, and not when a `Collapses` group manages it. `onOpenChange` reports in every mode. */
     onClose?: () => void;
+    /** Called with the state the trigger asks for (`true` to open) each time it is clicked or activated with Enter or Space, in every mode. Pair it with `open` to let the trigger drive a controlled Collapse. */
+    onOpenChange?: (open: boolean) => void;
     /** The clickable trigger element (header/button). */
     trigger?: React.ReactNode;
     /** Animation style, or `false` to disable. */
@@ -46,12 +53,9 @@ export interface CollapseProps extends Omit<React.HTMLAttributes<HTMLDivElement>
  * </Collapse>
  *
  * @example
- * // Controlled collapse
+ * // Controlled collapse, driven by its own trigger
  * const [isOpen, setIsOpen] = useState(false);
- * <Collapse
- *   open={isOpen}
- *   trigger={<button onClick={() => setIsOpen(!isOpen)}>Toggle</button>}
- * >
+ * <Collapse open={isOpen} onOpenChange={setIsOpen} trigger={<strong>Toggle</strong>}>
  *   <p>Content</p>
  * </Collapse>
  *

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

@@ -0,0 +1,53 @@
+import React from 'react';
+import { BulmaClassesProps } from '../helpers/useBulmaClasses.js';
+/**
+ * Props shared by both modes of the Collapses component.
+ */
+interface CollapsesBaseProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'color' | 'defaultValue' | 'onChange'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Joins the items into one block, with no gap between them and only the outer corners rounded. The joins show on `bordered` items. */
+    seamless?: boolean;
+    /** Additional CSS classes to apply. */
+    className?: string;
+    /** The `Collapse` items. Each child element is one item, indexed from 0 in order, with the children of a fragment counted one by one. A child that sets its own `open` keeps it: the group leaves that item alone. */
+    children?: React.ReactNode;
+}
+/**
+ * Props for Collapses in single mode, the accordion: opening one item closes the others.
+ */
+export interface CollapsesSingleProps extends CollapsesBaseProps {
+    /**
+     * Lets items open independently. Without it, opening one item closes the others.
+     * @defaultValue false
+     */
+    multiple?: false;
+    /** Controlled open items: the index of the open item, or `null` for none. With `multiple`, an array of indexes. An index is a position among the children, so rendering an item conditionally or reordering them moves the open state onto a neighbour: render every item and hide one with `visibility="hidden"`, or keep `value` in step yourself. */
+    value?: number | null;
+    /** Open items for uncontrolled use, as an index or `null` (the default, none open). With `multiple`, an array of indexes, empty by default. Indexes are positions among the children, as for `value`. */
+    defaultValue?: number | null;
+    /** Called with the new open items each time a trigger asks for a change, whether or not `value` is set: an index or `null`, or with `multiple` an array of indexes in ascending order. Indexes are positions among the children, as for `value`. */
+    onChange?: (value: number | null) => void;
+}
+/**
+ * Props for Collapses with `multiple`: items open and close independently.
+ */
+export interface CollapsesMultipleProps extends CollapsesBaseProps {
+    /**
+     * Lets items open independently. Without it, opening one item closes the others.
+     * @defaultValue false
+     */
+    multiple: true;
+    /** Controlled open items: the index of the open item, or `null` for none. With `multiple`, an array of indexes. An index is a position among the children, so rendering an item conditionally or reordering them moves the open state onto a neighbour: render every item and hide one with `visibility="hidden"`, or keep `value` in step yourself. */
+    value?: number[];
+    /** Open items for uncontrolled use, as an index or `null` (the default, none open). With `multiple`, an array of indexes, empty by default. Indexes are positions among the children, as for `value`. */
+    defaultValue?: number[];
+    /** Called with the new open items each time a trigger asks for a change, whether or not `value` is set: an index or `null`, or with `multiple` an array of indexes in ascending order. Indexes are positions among the children, as for `value`. */
+    onChange?: (value: number[]) => void;
+}
+/**
+ * Props for the Collapses component, a discriminated union on `multiple`: the open items are an index (or `null`) in single mode and an array of indexes with `multiple`.
+ */
+export type CollapsesProps = CollapsesSingleProps | CollapsesMultipleProps;
+export declare const Collapses: React.FC<CollapsesProps> & {
+    Collapse: React.FC<import("./Collapse.js").CollapseProps>;
+};
+export default Collapses;

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

@@ -0,0 +1,19 @@
+/**
+ * What a `Collapses` group hands the item it wraps: whether that item is open,
+ * and how to ask the group for a change.
+ *
+ * This module is internal. `index.ts` re-exports `Collapse` and `Collapses`
+ * whole, so the context lives here, where neither re-export reaches it.
+ */
+export interface CollapsesItemContextValue {
+    /** Whether the group has this item open. */
+    open: boolean;
+    /** Asks the group to open (`true`) or close (`false`) this item. */
+    setOpen: (open: boolean) => void;
+}
+/**
+ * `null` outside a group. A `Collapse` also resets it to `null` for its own
+ * subtree, so a Collapse nested in an item's content keeps its own state
+ * instead of answering to its ancestor's slot in the group.
+ */
+export declare const CollapsesItemContext: import("react").Context<CollapsesItemContextValue | null>;

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

@@ -21,7 +21,11 @@ export interface ButtonOwnProps extends Omit<BulmaClassesProps, 'color' | 'backg
     isLight?: boolean;
     /** Makes the button rounded. */
     isRounded?: boolean;
-    /** Displays a loading spinner. */
+    /**
+     * Displays a loading spinner.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Makes the button non-interactive. */
     isStatic?: boolean;

package/dist/types/elements/Loader.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+import { BulmaClassesProps } from '../helpers/useBulmaClasses.js';
+/**
+ * Props for the Loader component.
+ *
+ * There is no color prop, and the text and background color helpers are left
+ * out on purpose: Bulma draws the ring in `--bulma-border`, so a text color
+ * never reaches it. For a colored spinner over a region, use `Loading`.
+ *
+ * @extraProp {React.Ref<HTMLSpanElement>} [ref] - Ref forwarded to the loader element.
+ */
+export interface LoaderProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'color' | 'children'>, Omit<BulmaClassesProps, 'color' | 'colorShade' | 'backgroundColor' | 'backgroundColorShade'> {
+    /** Additional CSS classes to apply. */
+    className?: string;
+    /**
+     * Accessible name of the progress indicator. Name what is loading
+     * (`"Saving row"`) when more than one loader can be on screen at once.
+     */
+    ariaLabel?: string;
+}
+/**
+ * The `Loader` component renders Bulma's `.loader`, a small spinning ring for inline loading states.
+ *
+ * The ring is `1em` square, so `textSize` scales it. It is exposed as an
+ * indeterminate `progressbar` named by `ariaLabel`, and it stops spinning
+ * under `prefers-reduced-motion: reduce` while staying drawn.
+ *
+ * @function
+ * @param {LoaderProps} props - Props for the Loader component.
+ * @param {React.Ref<HTMLSpanElement>} ref - Forwarded ref to the loader element.
+ * @returns {JSX.Element} The rendered loader element.
+ *
+ * @example
+ * <Loader />
+ *
+ * @example
+ * <Loader textSize="3" ariaLabel="Saving" />
+ */
+export declare const Loader: React.ForwardRefExoticComponent<LoaderProps & React.RefAttributes<HTMLSpanElement>>;

package/dist/types/form/Autocomplete.d.ts

@@ -51,7 +51,11 @@ export interface AutocompleteProps extends Omit<React.HTMLAttributes<HTMLDivElem
     maxHeight?: number;
     /** Render as dropdown style. */
     dropdown?: boolean;
-    /** Show loading state. */
+    /**
+     * Show a loading spinner in the input.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     loading?: boolean;
     /** Whether the input is disabled. */
     disabled?: boolean;

package/dist/types/form/Control.d.ts

@@ -9,7 +9,11 @@ export interface ControlBaseProps extends React.HTMLAttributes<HTMLDivElement>,
     hasIconsLeft?: boolean;
     /** Adds right icon container. */
     hasIconsRight?: boolean;
-    /** Shows loading indicator. */
+    /**
+     * Shows a loading spinner inside the control.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Makes the control expand to fill available space. */
     isExpanded?: boolean;

package/dist/types/form/DateInput.d.ts

@@ -34,7 +34,11 @@ export interface DateInputProps extends DateInputBaseProps {
     hasIconsLeft?: boolean;
     /** Force the right icon container. */
     hasIconsRight?: boolean;
-    /** Show a loading indicator on the control. */
+    /**
+     * Show a loading spinner on the control.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Expand the control to fill its container. */
     isExpanded?: boolean;

package/dist/types/form/DateTimeInput.d.ts

@@ -32,7 +32,11 @@ export interface DateTimeInputProps extends DateTimeInputBaseProps {
     hasIconsLeft?: boolean;
     /** Force the right icon container. */
     hasIconsRight?: boolean;
-    /** Show a loading indicator on the control. */
+    /**
+     * Show a loading spinner on the control.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Expand the control to fill its container. */
     isExpanded?: boolean;

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

@@ -34,7 +34,11 @@ export interface InputProps extends InputBaseProps {
     hasIconsLeft?: boolean;
     /** Force right icon container. */
     hasIconsRight?: boolean;
-    /** Shows loading indicator. */
+    /**
+     * Shows a loading spinner on the wrapping Control.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Expand the control. */
     isExpanded?: boolean;

package/dist/types/form/Numberinput.d.ts

@@ -53,7 +53,11 @@ export interface NumberinputProps extends Omit<React.InputHTMLAttributes<HTMLInp
     disabled?: boolean;
     /** Whether the input can be typed in. */
     editable?: boolean;
-    /** Shows a loading state. */
+    /**
+     * Shows a loading spinner on the input's control.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Enables exponential step increments when holding buttons. */
     exponential?: boolean;

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

@@ -26,7 +26,11 @@ export interface SelectProps extends SelectBaseProps {
     iconLeftSize?: ControlBaseProps['iconLeftSize'];
     /** Force left icon container. */
     hasIconsLeft?: boolean;
-    /** Shows loading indicator. */
+    /**
+     * Replaces the chevron with a loading spinner.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Expand the control. */
     isExpanded?: boolean;

package/dist/types/form/SelectBase.d.ts

@@ -10,7 +10,11 @@ export interface SelectBaseProps extends Omit<React.SelectHTMLAttributes<HTMLSel
     size?: 'small' | 'medium' | 'large';
     /** Rounded select corners. */
     isRounded?: boolean;
-    /** Shows loading indicator. */
+    /**
+     * Replaces the chevron with a loading spinner.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Applies Bulma's is-active modifier. */
     isActive?: boolean;

package/dist/types/form/Taginput.d.ts

@@ -76,7 +76,11 @@ export interface TaginputProps extends Omit<React.HTMLAttributes<HTMLDivElement>
     keepFirst?: boolean;
     /** Keeps the autocomplete dropdown open after selection. */
     keepOpen?: boolean;
-    /** Shows a loading indicator. */
+    /**
+     * Shows a loading spinner in the input.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     loading?: boolean;
     /** ARIA label for tag close buttons. */
     ariaCloseLabel?: string;

package/dist/types/form/TextArea.d.ts

@@ -18,7 +18,11 @@ export interface TextAreaProps extends TextAreaBaseProps {
     labelProps?: FieldProps['labelProps'];
     /** Horizontal field layout. */
     horizontal?: boolean;
-    /** Shows loading indicator on the wrapping Control. */
+    /**
+     * Shows a loading spinner on the wrapping Control.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Control size. */
     controlSize?: ControlBaseProps['size'];

package/dist/types/form/TimeInput.d.ts

@@ -34,7 +34,11 @@ export interface TimeInputProps extends TimeInputBaseProps {
     hasIconsLeft?: boolean;
     /** Force the right icon container. */
     hasIconsRight?: boolean;
-    /** Show a loading indicator on the control. */
+    /**
+     * Show a loading spinner on the control.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Expand the control to fill its container. */
     isExpanded?: boolean;

package/dist/types/helpers/ClientOnly.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+/**
+ * Props for the ClientOnly component.
+ */
+export interface ClientOnlyProps {
+    /**
+     * Content to render once the page has hydrated. A function is called only
+     * then, so an inline expression that reads `window`, `document` or
+     * `localStorage` never runs on the server.
+     */
+    children?: React.ReactNode | (() => React.ReactNode);
+    /**
+     * Rendered on the server and during hydration instead of `children`, such
+     * as a placeholder the same size as the content so the layout doesn't
+     * shift when it arrives.
+     * @defaultValue null
+     */
+    fallback?: React.ReactNode;
+}
+/**
+ * Renders its children only in the browser, after hydration, and a `fallback` until then, so content that depends on browser-only state doesn't cause a hydration mismatch.
+ *
+ * The server render and the hydrating client render both show `fallback`,
+ * which keeps them identical; the children replace it in the commit that
+ * follows. In an app without server rendering the children show on the first
+ * render.
+ *
+ * @function
+ * @param {ClientOnlyProps} props - Props for the ClientOnly component.
+ * @returns The children once hydrated, otherwise the fallback.
+ *
+ * @example
+ * // The server's time zone is not the reader's.
+ * <ClientOnly fallback={<Skeleton variant="lines" lines={1} />}>
+ *   {() => (
+ *     <p>Times are shown in {Intl.DateTimeFormat().resolvedOptions().timeZone}.</p>
+ *   )}
+ * </ClientOnly>
+ */
+export declare function ClientOnly({ children, fallback }: ClientOnlyProps): React.JSX.Element;

package/dist/types/helpers/inertProps.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+/**
+ * The prop that makes an element inert, spelled for the React in use, or
+ * nothing when `inert` is false.
+ *
+ * Both majors must render `inert=""`, and each warns on the other's spelling
+ * and then drops the attribute. React 19 treats `inert` as a boolean and
+ * rejects the empty string. React 18 does not know the attribute, so it
+ * passes a string through and rejects `true`.
+ */
+export declare const inertProps: (inert: boolean, major?: number) => React.HTMLAttributes<HTMLElement>;

package/dist/types/helpers/useIsHydrated.d.ts

@@ -6,6 +6,11 @@
  * DOM-only behaviour (such as portalling) past hydration so the first client
  * render matches the server markup instead of tripping hydration recovery.
  *
+ * Only a component that hydrates ever sees `false` on the client. One that
+ * mounts later (after a route change, or in an app with no server rendering)
+ * gets `true` on its first render, so it pays for no extra render. It
+ * subscribes to nothing, so no later render flips it back.
+ *
  * @function useIsHydrated
  * @returns `true` once the hydrating render has completed, otherwise `false`.
  */

package/dist/types/index.d.ts

@@ -15,6 +15,7 @@ export * from './components/Panel.js';
 export * from './components/Tabs.js';
 export * from './components/Loading.js';
 export * from './components/Collapse.js';
+export * from './components/Collapses.js';
 export * from './components/Tooltip.js';
 export * from './components/Steps.js';
 export * from './components/Sidebar.js';
@@ -38,6 +39,7 @@ export * from './elements/IconText.js';
 export * from './elements/Image.js';
 export * from './elements/Link.js';
 export * from './elements/ListItem.js';
+export * from './elements/Loader.js';
 export * from './elements/Notification.js';
 export * from './elements/OrderedList.js';
 export * from './elements/Paragraph.js';
@@ -105,6 +107,9 @@ export * from './helpers/mergeBulmaStyles.js';
 export * from './helpers/useBulmaClasses.js';
 export * from './helpers/Theme.js';
 export * from './helpers/Config.js';
+export { ClientOnly } from './helpers/ClientOnly.js';
+export type { ClientOnlyProps } from './helpers/ClientOnly.js';
+export { useIsHydrated } from './helpers/useIsHydrated.js';
 export * from './layout/Container.js';
 export * from './layout/Footer.js';
 export * from './layout/Hero.js';

package/dist/types-cjs/components/Collapse.d.ts

@@ -6,14 +6,21 @@ import { BulmaClassesProps } from '../helpers/useBulmaClasses.js';
  * @extraProp {string} [className] - Additional CSS classes.
  */
 export interface CollapseProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'color'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
-    /** Controlled open state. If provided, component is controlled. */
+    /**
+     * Controlled open state. If provided, component is controlled, and the
+     * trigger only reports through `onOpenChange`. Inside a `Collapses` group, a
+     * Collapse that sets `open` stays yours: the group neither overrides it nor
+     * closes it when another item opens.
+     */
     open?: boolean;
-    /** Initial open state for uncontrolled usage. */
+    /** Initial open state for uncontrolled usage. Ignored inside a `Collapses` group, whose `defaultValue` decides. */
     defaultOpen?: boolean;
-    /** Callback when collapse opens. */
+    /** Called when the trigger opens the Collapse. Fires only while the Collapse keeps its own state: not when `open` is set, and not when a `Collapses` group manages it. `onOpenChange` reports in every mode. */
     onOpen?: () => void;
-    /** Callback when collapse closes. */
+    /** Called when the trigger closes the Collapse. Fires only while the Collapse keeps its own state: not when `open` is set, and not when a `Collapses` group manages it. `onOpenChange` reports in every mode. */
     onClose?: () => void;
+    /** Called with the state the trigger asks for (`true` to open) each time it is clicked or activated with Enter or Space, in every mode. Pair it with `open` to let the trigger drive a controlled Collapse. */
+    onOpenChange?: (open: boolean) => void;
     /** The clickable trigger element (header/button). */
     trigger?: React.ReactNode;
     /** Animation style, or `false` to disable. */
@@ -46,12 +53,9 @@ export interface CollapseProps extends Omit<React.HTMLAttributes<HTMLDivElement>
  * </Collapse>
  *
  * @example
- * // Controlled collapse
+ * // Controlled collapse, driven by its own trigger
  * const [isOpen, setIsOpen] = useState(false);
- * <Collapse
- *   open={isOpen}
- *   trigger={<button onClick={() => setIsOpen(!isOpen)}>Toggle</button>}
- * >
+ * <Collapse open={isOpen} onOpenChange={setIsOpen} trigger={<strong>Toggle</strong>}>
  *   <p>Content</p>
  * </Collapse>
  *

package/dist/types-cjs/components/Collapses.d.ts

@@ -0,0 +1,53 @@
+import React from 'react';
+import { BulmaClassesProps } from '../helpers/useBulmaClasses.js';
+/**
+ * Props shared by both modes of the Collapses component.
+ */
+interface CollapsesBaseProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'color' | 'defaultValue' | 'onChange'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Joins the items into one block, with no gap between them and only the outer corners rounded. The joins show on `bordered` items. */
+    seamless?: boolean;
+    /** Additional CSS classes to apply. */
+    className?: string;
+    /** The `Collapse` items. Each child element is one item, indexed from 0 in order, with the children of a fragment counted one by one. A child that sets its own `open` keeps it: the group leaves that item alone. */
+    children?: React.ReactNode;
+}
+/**
+ * Props for Collapses in single mode, the accordion: opening one item closes the others.
+ */
+export interface CollapsesSingleProps extends CollapsesBaseProps {
+    /**
+     * Lets items open independently. Without it, opening one item closes the others.
+     * @defaultValue false
+     */
+    multiple?: false;
+    /** Controlled open items: the index of the open item, or `null` for none. With `multiple`, an array of indexes. An index is a position among the children, so rendering an item conditionally or reordering them moves the open state onto a neighbour: render every item and hide one with `visibility="hidden"`, or keep `value` in step yourself. */
+    value?: number | null;
+    /** Open items for uncontrolled use, as an index or `null` (the default, none open). With `multiple`, an array of indexes, empty by default. Indexes are positions among the children, as for `value`. */
+    defaultValue?: number | null;
+    /** Called with the new open items each time a trigger asks for a change, whether or not `value` is set: an index or `null`, or with `multiple` an array of indexes in ascending order. Indexes are positions among the children, as for `value`. */
+    onChange?: (value: number | null) => void;
+}
+/**
+ * Props for Collapses with `multiple`: items open and close independently.
+ */
+export interface CollapsesMultipleProps extends CollapsesBaseProps {
+    /**
+     * Lets items open independently. Without it, opening one item closes the others.
+     * @defaultValue false
+     */
+    multiple: true;
+    /** Controlled open items: the index of the open item, or `null` for none. With `multiple`, an array of indexes. An index is a position among the children, so rendering an item conditionally or reordering them moves the open state onto a neighbour: render every item and hide one with `visibility="hidden"`, or keep `value` in step yourself. */
+    value?: number[];
+    /** Open items for uncontrolled use, as an index or `null` (the default, none open). With `multiple`, an array of indexes, empty by default. Indexes are positions among the children, as for `value`. */
+    defaultValue?: number[];
+    /** Called with the new open items each time a trigger asks for a change, whether or not `value` is set: an index or `null`, or with `multiple` an array of indexes in ascending order. Indexes are positions among the children, as for `value`. */
+    onChange?: (value: number[]) => void;
+}
+/**
+ * Props for the Collapses component, a discriminated union on `multiple`: the open items are an index (or `null`) in single mode and an array of indexes with `multiple`.
+ */
+export type CollapsesProps = CollapsesSingleProps | CollapsesMultipleProps;
+export declare const Collapses: React.FC<CollapsesProps> & {
+    Collapse: React.FC<import("./Collapse.js").CollapseProps>;
+};
+export default Collapses;

package/dist/types-cjs/components/collapsesContext.d.ts

@@ -0,0 +1,19 @@
+/**
+ * What a `Collapses` group hands the item it wraps: whether that item is open,
+ * and how to ask the group for a change.
+ *
+ * This module is internal. `index.ts` re-exports `Collapse` and `Collapses`
+ * whole, so the context lives here, where neither re-export reaches it.
+ */
+export interface CollapsesItemContextValue {
+    /** Whether the group has this item open. */
+    open: boolean;
+    /** Asks the group to open (`true`) or close (`false`) this item. */
+    setOpen: (open: boolean) => void;
+}
+/**
+ * `null` outside a group. A `Collapse` also resets it to `null` for its own
+ * subtree, so a Collapse nested in an item's content keeps its own state
+ * instead of answering to its ancestor's slot in the group.
+ */
+export declare const CollapsesItemContext: import("react").Context<CollapsesItemContextValue | null>;

package/dist/types-cjs/elements/Button.d.ts

@@ -21,7 +21,11 @@ export interface ButtonOwnProps extends Omit<BulmaClassesProps, 'color' | 'backg
     isLight?: boolean;
     /** Makes the button rounded. */
     isRounded?: boolean;
-    /** Displays a loading spinner. */
+    /**
+     * Displays a loading spinner.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Makes the button non-interactive. */
     isStatic?: boolean;

package/dist/types-cjs/elements/Loader.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+import { BulmaClassesProps } from '../helpers/useBulmaClasses.js';
+/**
+ * Props for the Loader component.
+ *
+ * There is no color prop, and the text and background color helpers are left
+ * out on purpose: Bulma draws the ring in `--bulma-border`, so a text color
+ * never reaches it. For a colored spinner over a region, use `Loading`.
+ *
+ * @extraProp {React.Ref<HTMLSpanElement>} [ref] - Ref forwarded to the loader element.
+ */
+export interface LoaderProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'color' | 'children'>, Omit<BulmaClassesProps, 'color' | 'colorShade' | 'backgroundColor' | 'backgroundColorShade'> {
+    /** Additional CSS classes to apply. */
+    className?: string;
+    /**
+     * Accessible name of the progress indicator. Name what is loading
+     * (`"Saving row"`) when more than one loader can be on screen at once.
+     */
+    ariaLabel?: string;
+}
+/**
+ * The `Loader` component renders Bulma's `.loader`, a small spinning ring for inline loading states.
+ *
+ * The ring is `1em` square, so `textSize` scales it. It is exposed as an
+ * indeterminate `progressbar` named by `ariaLabel`, and it stops spinning
+ * under `prefers-reduced-motion: reduce` while staying drawn.
+ *
+ * @function
+ * @param {LoaderProps} props - Props for the Loader component.
+ * @param {React.Ref<HTMLSpanElement>} ref - Forwarded ref to the loader element.
+ * @returns {JSX.Element} The rendered loader element.
+ *
+ * @example
+ * <Loader />
+ *
+ * @example
+ * <Loader textSize="3" ariaLabel="Saving" />
+ */
+export declare const Loader: React.ForwardRefExoticComponent<LoaderProps & React.RefAttributes<HTMLSpanElement>>;

package/dist/types-cjs/form/Autocomplete.d.ts

@@ -51,7 +51,11 @@ export interface AutocompleteProps extends Omit<React.HTMLAttributes<HTMLDivElem
     maxHeight?: number;
     /** Render as dropdown style. */
     dropdown?: boolean;
-    /** Show loading state. */
+    /**
+     * Show a loading spinner in the input.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     loading?: boolean;
     /** Whether the input is disabled. */
     disabled?: boolean;

package/dist/types-cjs/form/Control.d.ts

@@ -9,7 +9,11 @@ export interface ControlBaseProps extends React.HTMLAttributes<HTMLDivElement>,
     hasIconsLeft?: boolean;
     /** Adds right icon container. */
     hasIconsRight?: boolean;
-    /** Shows loading indicator. */
+    /**
+     * Shows a loading spinner inside the control.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Makes the control expand to fill available space. */
     isExpanded?: boolean;

package/dist/types-cjs/form/DateInput.d.ts

@@ -34,7 +34,11 @@ export interface DateInputProps extends DateInputBaseProps {
     hasIconsLeft?: boolean;
     /** Force the right icon container. */
     hasIconsRight?: boolean;
-    /** Show a loading indicator on the control. */
+    /**
+     * Show a loading spinner on the control.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Expand the control to fill its container. */
     isExpanded?: boolean;

package/dist/types-cjs/form/DateTimeInput.d.ts

@@ -32,7 +32,11 @@ export interface DateTimeInputProps extends DateTimeInputBaseProps {
     hasIconsLeft?: boolean;
     /** Force the right icon container. */
     hasIconsRight?: boolean;
-    /** Show a loading indicator on the control. */
+    /**
+     * Show a loading spinner on the control.
+     * Under `prefers-reduced-motion: reduce` the spinner stops and stays
+     * drawn (with bestax's CSS loaded).
+     */
     isLoading?: boolean;
     /** Expand the control to fill its container. */
     isExpanded?: boolean;