@allxsmith/bestax-bulma 5.19.0 → 5.22.0

package/dist/types-cjs/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-cjs/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-cjs/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-cjs/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-cjs/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-cjs/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-cjs/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-cjs/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-cjs/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-cjs/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-cjs/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';