@allxsmith/bestax-bulma 5.65.1 → 5.66.1

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

@@ -130,6 +130,77 @@ export interface ModalCloseProps extends React.ButtonHTMLAttributes<HTMLButtonEl
     /** Button variant. 'delete' (default) for modal card headers, 'floating' for overlay close button. */
     variant?: 'delete' | 'floating';
 }
+/**
+ * Modal.Background - Renders the modal background overlay. Pass it
+ * `onClick={onClose}` for a click on it to close the modal.
+ *
+ * @function
+ * @param {ModalBackgroundProps} props - Component props.
+ * @returns {JSX.Element} Modal background element.
+ */
+export declare const ModalBackground: React.FC<ModalBackgroundProps>;
+/**
+ * Modal.Content - Renders modal content wrapper for custom content.
+ *
+ * @function
+ * @param {ModalContentProps} props - Component props.
+ * @returns {JSX.Element} Modal content element.
+ */
+export declare const ModalContent: React.FC<ModalContentProps>;
+/**
+ * Modal.Card.Head - Renders modal card header section.
+ *
+ * @function
+ * @param {ModalCardHeadProps} props - Component props.
+ * @returns {JSX.Element} Modal card header element.
+ */
+export declare const ModalCardHead: React.FC<ModalCardHeadProps>;
+/**
+ * Modal.Card.Title - Renders modal card title.
+ *
+ * @function
+ * @param {ModalCardTitleProps} props - Component props.
+ * @returns {JSX.Element} Modal card title element.
+ */
+export declare const ModalCardTitle: React.FC<ModalCardTitleProps>;
+/**
+ * Modal.Card.Body - Renders modal card body section.
+ *
+ * @function
+ * @param {ModalCardBodyProps} props - Component props.
+ * @returns {JSX.Element} Modal card body element.
+ */
+export declare const ModalCardBody: React.FC<ModalCardBodyProps>;
+/**
+ * Modal.Card.Foot - Renders modal card footer section.
+ *
+ * @function
+ * @param {ModalCardFootProps} props - Component props.
+ * @returns {JSX.Element} Modal card footer element.
+ */
+export declare const ModalCardFoot: React.FC<ModalCardFootProps>;
+export declare const ModalCard: React.FC<ModalCardProps> & {
+    Head: React.FC<ModalCardHeadProps>;
+    Title: React.FC<ModalCardTitleProps>;
+    Body: React.FC<ModalCardBodyProps>;
+    Foot: React.FC<ModalCardFootProps>;
+};
+/**
+ * Modal.Close - Renders modal close button with two variant styles. It calls
+ * the modal's `onClose` unless given an `onClick` of its own.
+ *
+ * @function
+ * @param {ModalCloseProps} props - Component props.
+ * @returns {JSX.Element} Close button element.
+ *
+ * @remarks
+ * Supports two variants:
+ * - 'delete' (default): For use in modal card headers, renders with 'delete' class
+ * - 'floating': For floating overlay close button, renders with 'modal-close' class
+ *
+ * The size prop only applies to the 'floating' variant.
+ */
+export declare const ModalClose: React.FC<ModalCloseProps>;
 export declare const Modal: React.ForwardRefExoticComponent<ModalProps & React.RefAttributes<HTMLDivElement>> & {
     Background: React.FC<ModalBackgroundProps>;
     Content: React.FC<ModalContentProps>;

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

@@ -96,7 +96,17 @@ export interface NavbarItemOwnProps extends Omit<BulmaClassesProps, 'color' | 'b
     backgroundColor?: never;
     /** Additional CSS classes. */
     className?: string;
-    /** Whether the item is active. */
+    /**
+     * Marks the item as the current one. It adds Bulma's `is-active` class, and
+     * `aria-current="page"` on the element `as` renders, so assistive tech can
+     * tell which item is current too. An `aria-current` you pass wins, even
+     * `undefined`: use it to say something else (`"location"` for a section of
+     * one page, say), or `aria-current={false}` to turn it off. An `active` item
+     * that isn't navigation takes `aria-current={false}`: an `as="button"`
+     * control, say, or a `has-dropdown` container like the
+     * `<Navbar.Item as="div" className="has-dropdown" active>` older
+     * bestax-migrate versions wrote. That one can be a `Navbar.Dropdown` instead.
+     */
     active?: boolean;
     /** Text color for the item. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';

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

@@ -48,7 +48,11 @@ export interface PopoverProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
      */
     onOpenChange?: (open: boolean) => void;
     /**
-     * Where the panel opens against the trigger.
+     * Where the panel opens against the trigger. Left out, it opens below and
+     * lines up with the trigger's start edge, which is its right edge on a
+     * right-to-left page, so a trigger at the start of the line doesn't push
+     * the panel off the screen. A corner you pass stays physical, so
+     * `bottom-left` lines up the left edges on either page.
      * @defaultValue 'bottom-left'
      */
     position?: PopoverPosition;

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

@@ -110,6 +110,15 @@ export interface SegmentedControlSegmentProps extends Omit<ButtonOwnProps, 'colo
      */
     'aria-pressed'?: never;
 }
+/**
+ * One option in the row: a `<button role="radio">` that's checked while the group's value is its `value`, filled with the group's `color` and marked `is-selected`.
+ *
+ * @function
+ * @param {SegmentedControlSegmentProps} props - Props for the segment.
+ * @param {React.Ref<HTMLButtonElement>} ref - Forwarded ref to the `<button>`.
+ * @returns {JSX.Element} The rendered segment.
+ */
+export declare const SegmentedControlSegment: React.ForwardRefExoticComponent<SegmentedControlSegmentProps & React.RefAttributes<HTMLButtonElement>>;
 export declare const SegmentedControl: React.ForwardRefExoticComponent<SegmentedControlProps & React.RefAttributes<HTMLDivElement>> & {
     Segment: React.ForwardRefExoticComponent<SegmentedControlSegmentProps & React.RefAttributes<HTMLButtonElement>>;
 };

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

@@ -66,38 +66,78 @@ export interface SidebarProps extends Omit<React.HTMLAttributes<HTMLElement>, 'c
 /**
  * Props for the SidebarHeader component.
  */
-interface SidebarHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
+export interface SidebarHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
     /** Header content. */
     children?: React.ReactNode;
 }
+/**
+ * Container for the sidebar header.
+ *
+ * @function
+ * @param {SidebarHeaderProps} props - Props for the SidebarHeader component.
+ * @returns {JSX.Element} The rendered sidebar header.
+ */
+export declare const SidebarHeader: React.FC<SidebarHeaderProps>;
 /**
  * Props for the SidebarTitle component.
  */
-interface SidebarTitleProps extends React.HTMLAttributes<HTMLParagraphElement> {
+export interface SidebarTitleProps extends React.HTMLAttributes<HTMLParagraphElement> {
     /** Title content. */
     children?: React.ReactNode;
 }
+/**
+ * Title text inside the header.
+ *
+ * @function
+ * @param {SidebarTitleProps} props - Props for the SidebarTitle component.
+ * @returns {JSX.Element} The rendered sidebar title.
+ */
+export declare const SidebarTitle: React.FC<SidebarTitleProps>;
 /**
  * Props for the SidebarClose component.
  * Extends standard button attributes.
  * @extraProp {'button' | 'submit' | 'reset'} [type='button'] - Button type. Defaults to `'button'`, so a close button inside a form does not submit it. Pass `'submit'` or `'reset'` and yours is used; any other value, or a spread carrying `type: undefined`, renders `'button'`.
  * @extraProp {string} [aria-label='Close'] - Accessible name. Pass your own to replace it. An empty one, or a spread carrying `'aria-label': undefined`, keeps the default rather than leaving the button unnamed.
  */
-type SidebarCloseProps = React.ButtonHTMLAttributes<HTMLButtonElement>;
+export type SidebarCloseProps = React.ButtonHTMLAttributes<HTMLButtonElement>;
+/**
+ * Close button for the sidebar.
+ *
+ * @function
+ * @param {SidebarCloseProps} props - Props for the SidebarClose component.
+ * @returns {JSX.Element} The rendered close button.
+ */
+export declare const SidebarClose: React.FC<SidebarCloseProps>;
 /**
  * Props for the SidebarBody component.
  */
-interface SidebarBodyProps extends React.HTMLAttributes<HTMLDivElement> {
+export interface SidebarBodyProps extends React.HTMLAttributes<HTMLDivElement> {
     /** Body content. */
     children?: React.ReactNode;
 }
+/**
+ * Main content area of the sidebar.
+ *
+ * @function
+ * @param {SidebarBodyProps} props - Props for the SidebarBody component.
+ * @returns {JSX.Element} The rendered sidebar body.
+ */
+export declare const SidebarBody: React.FC<SidebarBodyProps>;
 /**
  * Props for the SidebarFooter component.
  */
-interface SidebarFooterProps extends React.HTMLAttributes<HTMLDivElement> {
+export interface SidebarFooterProps extends React.HTMLAttributes<HTMLDivElement> {
     /** Footer content. */
     children?: React.ReactNode;
 }
+/**
+ * Footer area of the sidebar.
+ *
+ * @function
+ * @param {SidebarFooterProps} props - Props for the SidebarFooter component.
+ * @returns {JSX.Element} The rendered sidebar footer.
+ */
+export declare const SidebarFooter: React.FC<SidebarFooterProps>;
 export declare const Sidebar: React.ForwardRefExoticComponent<SidebarProps & React.RefAttributes<HTMLElement>> & {
     Header: React.FC<SidebarHeaderProps>;
     Title: React.FC<SidebarTitleProps>;

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

@@ -13,6 +13,17 @@ export interface FigureCaptionProps extends React.HTMLAttributes<HTMLElement>, O
     /** Content to be rendered inside the figcaption. */
     children?: React.ReactNode;
 }
+/**
+ * FigureCaption component for rendering a styled figcaption element.
+ *
+ * A FigureCaption wraps the HTML `<figcaption>` element with Bulma helper class integration.
+ * Use it inside Figure components to provide captions for images or other media.
+ *
+ * @function
+ * @param {FigureCaptionProps} props - Props for the FigureCaption component.
+ * @returns {JSX.Element} The rendered figcaption element.
+ */
+export declare const FigureCaption: React.FC<FigureCaptionProps>;
 /**
  * Props for the Figure component.
  */

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

@@ -63,7 +63,13 @@ export interface ColorInputBaseProps extends Omit<React.InputHTMLAttributes<HTML
     openOnFocus?: boolean;
     /** Closes the panel once a swatch is chosen. */
     closeOnSwatchClick?: boolean;
-    /** The panel's place relative to the field. */
+    /**
+     * Where the panel opens against the field. Left out, it opens below and
+     * lines up with the field's start edge, which is its right edge when the
+     * picker reads right to left. A corner you pass stays physical, so
+     * `bottom-left` lines up the left edges either way.
+     * @defaultValue 'bottom-left'
+     */
     position?: PickerPosition;
     /**
      * Renders the panel through a portal, into the `portalContainer` a

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

@@ -103,7 +103,13 @@ export interface DateInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLI
     openOnFocus?: boolean;
     /** Close the popover after a date is selected. */
     closeOnSelect?: boolean;
-    /** Popover anchor position relative to the input. */
+    /**
+     * Where the popover opens against the field. Left out, it opens below and
+     * lines up with the field's start edge, which is its right edge when the
+     * picker reads right to left. A corner you pass stays physical, so
+     * `bottom-left` lines up the left edges either way.
+     * @defaultValue 'bottom-left'
+     */
     position?: PickerPosition;
     /**
      * Render the popover through a portal, into the `portalContainer` a

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

@@ -90,7 +90,13 @@ export interface DateRangeInputBaseProps extends Omit<React.HTMLAttributes<HTMLD
      * marks the start, never closes it.
      */
     closeOnSelect?: boolean;
-    /** Popover anchor position relative to the field. */
+    /**
+     * Where the popover opens against the field. Left out, it opens below and
+     * lines up with the field's start edge, which is its right edge when the
+     * picker reads right to left. A corner you pass stays physical, so
+     * `bottom-left` lines up the left edges either way.
+     * @defaultValue 'bottom-left'
+     */
     position?: PickerPosition;
     /**
      * Render the popover through a portal, into the `portalContainer` a

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

@@ -76,7 +76,13 @@ export interface DateTimeInputBaseProps extends Omit<React.InputHTMLAttributes<H
     openOnFocus?: boolean;
     /** Off by default — users typically tweak both halves before committing. */
     closeOnSelect?: boolean;
-    /** Popover anchor position. */
+    /**
+     * Where the popover opens against the field. Left out, it opens below and
+     * lines up with the field's start edge, which is its right edge when the
+     * picker reads right to left. A corner you pass stays physical, so
+     * `bottom-left` lines up the left edges either way.
+     * @defaultValue 'bottom-left'
+     */
     position?: PickerPosition;
     /**
      * Render the popover through a portal, into the `portalContainer` a

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

@@ -65,7 +65,13 @@ export interface TimeInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLI
     openOnFocus?: boolean;
     /** Close the popover after a time is selected (off by default). */
     closeOnSelect?: boolean;
-    /** Popover anchor position relative to the input. */
+    /**
+     * Where the popover opens against the field. Left out, it opens below and
+     * lines up with the field's start edge, which is its right edge when the
+     * picker reads right to left. A corner you pass stays physical, so
+     * `bottom-left` lines up the left edges either way.
+     * @defaultValue 'bottom-left'
+     */
     position?: PickerPosition;
     /**
      * Render the popover through a portal, into the `portalContainer` a

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

@@ -157,7 +157,10 @@ interface TreeSelectBaseProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
     /** Rounds the field's corners (Bulma's `is-rounded`). */
     isRounded?: boolean;
     /**
-     * Where the panel opens, relative to the field, as on the pickers.
+     * Where the panel opens against the field, as on the pickers. Left out, it
+     * opens below and lines up with the field's start edge, which is its right
+     * edge on a right-to-left page. A corner you pass stays physical, so
+     * `bottom-left` lines up the left edges either way.
      * @defaultValue 'bottom-left'
      */
     position?: PickerPosition;

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

@@ -6,6 +6,11 @@ export interface PickerPopoverProps {
     onClose: () => void;
     anchorRef: React.RefObject<HTMLElement | null>;
     children: React.ReactNode;
+    /**
+     * The corner it opens from. Left out, it's `bottom-left` lined up with the
+     * anchor's start edge: the stylesheet's `is-start-aligned` rule in place,
+     * and the anchor's direction when portaled.
+     */
     position?: PickerPosition;
     appendToBody?: boolean;
     className?: string;

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

@@ -28,6 +28,18 @@ export interface PickerLocaleScope {
  * picker's own formatting reports it.
  */
 export declare function usePickerLocaleScope(ownLocale: string | undefined, ownDir: string | undefined): PickerLocaleScope;
+/**
+ * The `dir` a picker's root ends up with: the one passed to it, else its own
+ * locale's inside a `LocaleProvider`, else none, so it follows the page. A
+ * picker that renders its own `Control` puts it there too. Bulma places the
+ * Control's icon and loading spinner against the Control's direction, and
+ * the launcher sits inside the picker's root, so the two have to agree or a
+ * French picker in an Arabic section puts the icon on top of the launcher.
+ * Returned as attributes to spread, empty when there's no `dir` to set.
+ */
+export declare function usePickerDirAttrs(ownLocale: string | undefined, ownDir: string | undefined): {
+    dir?: string;
+};
 /**
  * Whether a picker's `dayNames` replace the calendar's own, which `Calendar`
  * does only for a full week of seven.

package/dist/types-cjs/form/_selectInternals/DialogSelect.d.ts

@@ -55,6 +55,7 @@ export interface DialogSelectProps extends Omit<React.HTMLAttributes<HTMLDivElem
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
     size?: 'small' | 'medium' | 'large';
     isRounded?: boolean;
+    /** Left out, the panel lines up with the field's start edge. */
     position?: PickerPosition;
     appendToBody?: boolean;
     /** Holds the field, which focus goes back to. */

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

@@ -22,8 +22,15 @@ export interface AnchoredPosition {
 export interface UseAnchoredPositionOptions {
     /** Whether the panel is on the page. Nothing is measured while it is not. */
     active: boolean;
-    /** The corner asked for, or `auto` to pick one that keeps the panel in the viewport. */
-    position: PickerPosition;
+    /**
+     * The corner asked for, or `auto` to pick one that keeps the panel in the
+     * viewport. A named corner is physical, whatever the page's direction.
+     * Left out, the corner is `bottom-left` lined up with the anchor's inline
+     * start, which is its right edge right to left. A panel in place gets that
+     * from its stylesheet, as Popover's and the pickers' do; a fixed panel's
+     * coordinates read the anchor's direction.
+     */
+    position?: PickerPosition;
     /**
      * Whether the panel is fixed to the viewport (it was portaled away from the
      * anchor), which needs coordinates. Otherwise the panel's CSS places it