@allxsmith/bestax-bulma 5.26.0 → 5.26.2

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

@@ -74,7 +74,12 @@ export interface DateInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLI
     editable?: boolean;
     /** Whether the calendar popover exists. `false` makes the field input-only (segmented typing, no popover). */
     popover?: boolean;
-    /** Open the popover when the input is focused. */
+    /**
+     * Open the popover when the input is focused. Focus that a closing popover
+     * hands back to the input leaves it closed. Dismissing it commits nothing:
+     * an empty field stays empty, and leaving afterwards commits only what was
+     * typed since.
+     */
     openOnFocus?: boolean;
     /** Close the popover after a date is selected. */
     closeOnSelect?: boolean;

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

@@ -45,7 +45,12 @@ export interface DateTimeInputBaseProps extends Omit<React.InputHTMLAttributes<H
     editable?: boolean;
     /** Whether the calendar + time popover exists. `false` makes the field input-only (segmented typing with no popover). Default `true`. */
     popover?: boolean;
-    /** Open the popover on focus. Default `true`. */
+    /**
+     * Open the popover on focus. Default `true`. Focus that a closing popover
+     * hands back to the input leaves it closed. Dismissing it commits nothing:
+     * an empty field stays empty, and leaving afterwards commits only what was
+     * typed since.
+     */
     openOnFocus?: boolean;
     /** Off by default — users typically tweak both halves before committing. */
     closeOnSelect?: boolean;

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

@@ -44,7 +44,12 @@ export interface TimeInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLI
     editable?: boolean;
     /** Whether the spinner popover exists. `false` makes the field input-only (segmented typing, no popover). */
     popover?: boolean;
-    /** Open the popover when the input is focused. */
+    /**
+     * Open the popover when the input is focused. Focus that a closing popover
+     * hands back to the input leaves it closed. Dismissing it commits nothing:
+     * an empty field stays empty, and leaving afterwards commits only what was
+     * typed since.
+     */
     openOnFocus?: boolean;
     /** Close the popover after a time is selected (off by default). */
     closeOnSelect?: boolean;

package/dist/types/form/_pickerInternals/PickerPopover.d.ts

@@ -15,6 +15,13 @@ export interface PickerPopoverProps {
     ariaLabelledBy?: string;
     role?: 'dialog' | 'group';
     id?: string;
+    /**
+     * Where focus goes when the popover closes. Without it, focus goes back to
+     * whatever had it when the focus trap turned on, which is read after the
+     * panel's content mounts: a calendar that focuses a cell as it mounts
+     * would be recorded instead, and that cell leaves with the panel.
+     */
+    restoreFocusRef?: React.RefObject<HTMLElement | null>;
 }
 export declare const PickerPopover: React.FC<PickerPopoverProps>;
 export default PickerPopover;

package/dist/types/form/_pickerInternals/useSegmentedEntry.d.ts

@@ -46,6 +46,11 @@ export interface UseSegmentedEntryParams {
     openOnFocus?: boolean;
     closeOnSelect?: boolean;
     isOpen: boolean;
+    /**
+     * The host's open-state setter. The hook asks it to open on focus, click
+     * or ArrowDown, but not on the focus the popover's focus trap hands back
+     * to the input as it closes, which is not the user arriving.
+     */
     setOpen: (next: boolean) => void;
     inputRef: React.RefObject<HTMLInputElement | null>;
     containerRef: React.RefObject<HTMLElement | null>;

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

@@ -55,11 +55,20 @@ type BulmaVars = Partial<Record<BulmaVarKey, string>>;
  */
 export interface ThemeProps extends Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     children: ReactNode;
+    /**
+     * Additional CSS classes for the wrapper div. A root Theme (`isRoot`) has no
+     * wrapper, so there this does nothing, and says so in development.
+     */
     className?: string;
     /**
      * Inject the variables globally at `:root` instead of scoping them to a
      * wrapper div. Default: false.
      *
+     * A root Theme renders its children with no wrapper, so `className` and the
+     * helper props, such as `m` or `shadow`, have no element to land on. They
+     * do nothing, and say so in development. `radius` and `columnGap` describe
+     * what each does at the root.
+     *
      * Several root Themes can be mounted at once, and each contributes its own
      * variables. Where two set the same one, the inner or later-mounted Theme
      * wins, as with nested scoped Themes, and unmounting a Theme removes only

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

@@ -74,7 +74,12 @@ export interface DateInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLI
     editable?: boolean;
     /** Whether the calendar popover exists. `false` makes the field input-only (segmented typing, no popover). */
     popover?: boolean;
-    /** Open the popover when the input is focused. */
+    /**
+     * Open the popover when the input is focused. Focus that a closing popover
+     * hands back to the input leaves it closed. Dismissing it commits nothing:
+     * an empty field stays empty, and leaving afterwards commits only what was
+     * typed since.
+     */
     openOnFocus?: boolean;
     /** Close the popover after a date is selected. */
     closeOnSelect?: boolean;

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

@@ -45,7 +45,12 @@ export interface DateTimeInputBaseProps extends Omit<React.InputHTMLAttributes<H
     editable?: boolean;
     /** Whether the calendar + time popover exists. `false` makes the field input-only (segmented typing with no popover). Default `true`. */
     popover?: boolean;
-    /** Open the popover on focus. Default `true`. */
+    /**
+     * Open the popover on focus. Default `true`. Focus that a closing popover
+     * hands back to the input leaves it closed. Dismissing it commits nothing:
+     * an empty field stays empty, and leaving afterwards commits only what was
+     * typed since.
+     */
     openOnFocus?: boolean;
     /** Off by default — users typically tweak both halves before committing. */
     closeOnSelect?: boolean;

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

@@ -44,7 +44,12 @@ export interface TimeInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLI
     editable?: boolean;
     /** Whether the spinner popover exists. `false` makes the field input-only (segmented typing, no popover). */
     popover?: boolean;
-    /** Open the popover when the input is focused. */
+    /**
+     * Open the popover when the input is focused. Focus that a closing popover
+     * hands back to the input leaves it closed. Dismissing it commits nothing:
+     * an empty field stays empty, and leaving afterwards commits only what was
+     * typed since.
+     */
     openOnFocus?: boolean;
     /** Close the popover after a time is selected (off by default). */
     closeOnSelect?: boolean;

package/dist/types-cjs/form/_pickerInternals/PickerPopover.d.ts

@@ -15,6 +15,13 @@ export interface PickerPopoverProps {
     ariaLabelledBy?: string;
     role?: 'dialog' | 'group';
     id?: string;
+    /**
+     * Where focus goes when the popover closes. Without it, focus goes back to
+     * whatever had it when the focus trap turned on, which is read after the
+     * panel's content mounts: a calendar that focuses a cell as it mounts
+     * would be recorded instead, and that cell leaves with the panel.
+     */
+    restoreFocusRef?: React.RefObject<HTMLElement | null>;
 }
 export declare const PickerPopover: React.FC<PickerPopoverProps>;
 export default PickerPopover;

package/dist/types-cjs/form/_pickerInternals/useSegmentedEntry.d.ts

@@ -46,6 +46,11 @@ export interface UseSegmentedEntryParams {
     openOnFocus?: boolean;
     closeOnSelect?: boolean;
     isOpen: boolean;
+    /**
+     * The host's open-state setter. The hook asks it to open on focus, click
+     * or ArrowDown, but not on the focus the popover's focus trap hands back
+     * to the input as it closes, which is not the user arriving.
+     */
     setOpen: (next: boolean) => void;
     inputRef: React.RefObject<HTMLInputElement | null>;
     containerRef: React.RefObject<HTMLElement | null>;

package/dist/types-cjs/helpers/Theme.d.ts

@@ -55,11 +55,20 @@ type BulmaVars = Partial<Record<BulmaVarKey, string>>;
  */
 export interface ThemeProps extends Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     children: ReactNode;
+    /**
+     * Additional CSS classes for the wrapper div. A root Theme (`isRoot`) has no
+     * wrapper, so there this does nothing, and says so in development.
+     */
     className?: string;
     /**
      * Inject the variables globally at `:root` instead of scoping them to a
      * wrapper div. Default: false.
      *
+     * A root Theme renders its children with no wrapper, so `className` and the
+     * helper props, such as `m` or `shadow`, have no element to land on. They
+     * do nothing, and say so in development. `radius` and `columnGap` describe
+     * what each does at the root.
+     *
      * Several root Themes can be mounted at once, and each contributes its own
      * variables. Where two set the same one, the inner or later-mounted Theme
      * wins, as with nested scoped Themes, and unmounting a Theme removes only

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allxsmith/bestax-bulma",
-  "version": "5.26.0",
+  "version": "5.26.2",
   "description": "A fully-typed React component library for the Bulma CSS framework. Build modern UIs quickly with reusable, accessible, and customizable Bulma-based React components.",
   "main": "dist/index.cjs",
   "module": "dist/index.esm.js",