@allxsmith/bestax-bulma 5.66.2 → 5.67.1

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

@@ -95,7 +95,7 @@ export interface CommandActionsProps extends CommandBaseProps {
      * @defaultValue 'No results'
      */
     empty?: React.ReactNode;
-    /** @internal With `actions`, the Command renders its own parts. */
+    /** With `actions`, the Command renders its own parts. */
     children?: never;
 }
 /** Props for a Command built from parts. */
@@ -108,13 +108,13 @@ export interface CommandPartsProps extends CommandBaseProps {
      * with a warning in development.
      */
     children?: React.ReactNode;
-    /** @internal Built from parts, the app renders the items. */
+    /** Built from parts, the app renders the items. */
     actions?: never;
-    /** @internal Built from parts, the app filters. */
+    /** Built from parts, the app filters. */
     filter?: never;
-    /** @internal Built from parts, `Command.Input` takes the placeholder. */
+    /** Built from parts, `Command.Input` takes the placeholder. */
     placeholder?: never;
-    /** @internal Built from parts, `Command.Empty` is the empty message. */
+    /** Built from parts, `Command.Empty` is the empty message. */
     empty?: never;
 }
 /**

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

@@ -38,7 +38,11 @@ export interface DropdownProps extends Omit<React.HTMLAttributes<HTMLDivElement>
     onActiveChange?: (active: boolean) => void;
     /** Close dropdown when a menu item is clicked, or activated with Enter or Space. */
     closeOnClick?: boolean;
-    /** Root element ID (for aria-controls, etc). */
+    /**
+     * Root element ID. The trigger gets `<id>-trigger` and the menu `<id>-menu`,
+     * which the trigger's `aria-controls` and the menu's `aria-labelledby` point
+     * at. Without one, both ids come from `useId`.
+     */
     id?: string;
 }
 /**

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

@@ -90,10 +90,8 @@ export interface HoverCardProps extends Omit<React.HTMLAttributes<HTMLSpanElemen
      * it only after the rest of the page, and focus leaving the trigger on the
      * way closes it, so keyboard users can open it, read it and close it with
      * Escape, and whatever it links to has to be reachable from the page as
-     * well. It is measured against the trigger when it opens and on resize and
-     * scroll, so it doesn't follow content that changes size while it is open.
-     * Theming variables set on an ancestor of the trigger reach it only when its
-     * container is inside that ancestor.
+     * well. Theming variables set on an ancestor of the trigger reach it only
+     * when its container is inside that ancestor.
      * @defaultValue false
      */
     appendToBody?: boolean;

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

@@ -48,9 +48,12 @@ export interface ModalProps extends Omit<React.HTMLAttributes<HTMLDivElement>, '
      */
     closeOnEscape?: boolean;
     /**
-     * Lock body scroll while the modal is active. Ref-counted and shared with
-     * `Dialog`, `Sidebar` and `Loading`, so whichever overlay closes first does
-     * not unlock the page underneath one that is still open.
+     * Lock page scroll while the modal is active, padding the page by the room
+     * its scrollbar took so the content stays put. An element fixed to the
+     * window's right edge, such as a `fixed` Navbar, isn't padded, and moves by
+     * the scrollbar's width while the page is locked. Ref-counted and shared
+     * with `Dialog`, `Sidebar` and `Loading`, so whichever overlay closes first
+     * does not unlock the page underneath one that is still open.
      * @defaultValue true
      */
     lockScroll?: boolean;

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

@@ -61,9 +61,7 @@ export interface PopoverProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
      * `ConfigProvider` sets, `document.body` by default, fixed to the viewport,
      * so an ancestor's `overflow`, `transform` or stacking context can't clip
      * it. The panel then shows from the commit after hydration, never in server
-     * markup. It is measured against the trigger when it opens and on resize
-     * and scroll, so it doesn't follow content that changes size while it is
-     * open. Theming variables set on an ancestor of the trigger reach it only
+     * markup. Theming variables set on an ancestor of the trigger reach it only
      * when its container is inside that ancestor.
      * @defaultValue false
      */

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

@@ -33,7 +33,7 @@ export interface SidebarProps extends Omit<React.HTMLAttributes<HTMLElement>, 'c
     fullWidth?: boolean;
     /**
      * Show an overlay behind the sidebar, which makes it modal: it gets
-     * `aria-modal="true"`, locks body scroll, and keeps Tab and Shift+Tab
+     * `aria-modal="true"`, locks page scroll, and keeps Tab and Shift+Tab
      * inside it while it is the topmost modal overlay. A Modal or Dialog opened
      * over it, even one rendered inside it, holds Tab until it closes. Without
      * an overlay the sidebar isn't modal and holds no Tab: on the page, Tab
@@ -60,7 +60,11 @@ export interface SidebarProps extends Omit<React.HTMLAttributes<HTMLElement>, 'c
     canCancel?: boolean;
     /** Content to display in the sidebar. */
     children?: React.ReactNode;
-    /** Renders inline instead of using a portal. */
+    /**
+     * Renders inline instead of using a portal. Without it, the sidebar renders
+     * inline on the server and while hydrating, moving into the portal once the
+     * client takes over, so hydration matches.
+     */
     inline?: boolean;
 }
 /**

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

@@ -57,7 +57,9 @@ export interface ToastProps extends Omit<React.HTMLAttributes<HTMLDivElement>, '
      */
     container?: string | HTMLElement;
     /**
-     * Renders inline instead of using a portal. Through `toast.show()`, a toast
+     * Renders inline instead of using a portal. Without it, a toast renders
+     * inline on the server and while hydrating, moving into the portal once the
+     * client takes over, so hydration matches. Through `toast.show()`, a toast
      * already renders inline in `ToastContainer`'s stack for its position, and
      * `inline` keeps one with a `container` in that stack too.
      */

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

@@ -39,7 +39,7 @@ export interface IconButtonLabelledBy {
     /** The id of the element whose text names the button, in place of `aria-label`. */
     'aria-labelledby': string;
     /**
-     * @internal Not with `aria-labelledby`, which already names the button.
+     * Not with `aria-labelledby`, which already names the button.
      * Declared so the two can't be passed together.
      */
     'aria-label'?: undefined;
@@ -54,10 +54,7 @@ export interface IconButtonLabel {
      * development.
      */
     'aria-label': string;
-    /**
-     * @internal Not with `aria-label`. Declared so the two can't be passed
-     * together.
-     */
+    /** Not with `aria-label`. Declared so the two can't be passed together. */
     'aria-labelledby'?: undefined;
 }
 /**

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

@@ -165,7 +165,7 @@ interface ComboboxDataBaseProps extends ComboboxBaseProps {
      * `Combobox.Input`.
      */
     'aria-labelledby'?: string;
-    /** @internal With `data`, the Combobox renders its own parts. */
+    /** With `data`, the Combobox renders its own parts. */
     children?: never;
 }
 /** Props for a Combobox given `data`, with one value. */
@@ -205,7 +205,7 @@ export interface ComboboxSingleDataProps extends ComboboxDataBaseProps {
      * `multiple` the array.
      */
     onChange?: (value: string | null) => void;
-    /** @internal With one value there are no tags to name. */
+    /** With one value there are no tags to name. */
     ariaCloseLabel?: never;
 }
 /** Props for a Combobox given `data`, with several values. */
@@ -253,27 +253,27 @@ export interface ComboboxPartsProps extends ComboboxBaseProps {
      * @defaultValue false
      */
     multiple?: boolean;
-    /** @internal Built from parts, there's no `data`. */
+    /** Built from parts, there's no `data`. */
     data?: never;
-    /** @internal Built from parts, the app keeps the value. */
+    /** Built from parts, the app keeps the value. */
     value?: never;
-    /** @internal Built from parts, the app keeps the value. */
+    /** Built from parts, the app keeps the value. */
     defaultValue?: never;
-    /** @internal Built from parts, `onSelect` reports a pick. */
+    /** Built from parts, `onSelect` reports a pick. */
     onChange?: never;
-    /** @internal Built from parts, `Combobox.Input` takes the placeholder. */
+    /** Built from parts, `Combobox.Input` takes the placeholder. */
     placeholder?: never;
-    /** @internal Built from parts, the app posts the value. */
+    /** Built from parts, the app posts the value. */
     name?: never;
-    /** @internal Built from parts, `Combobox.Empty` is the empty message. */
+    /** Built from parts, `Combobox.Empty` is the empty message. */
     empty?: never;
-    /** @internal Built from parts, `Combobox.Item` renders its own content. */
+    /** Built from parts, `Combobox.Item` renders its own content. */
     itemTemplate?: never;
-    /** @internal Built from parts, `Combobox.Input` takes `disabled`. */
+    /** Built from parts, `Combobox.Input` takes `disabled`. */
     disabled?: never;
-    /** @internal Built from parts, `Combobox.Input` takes `required`. */
+    /** Built from parts, `Combobox.Input` takes `required`. */
     required?: never;
-    /** @internal Built from parts, the app posts the value. */
+    /** Built from parts, the app posts the value. */
     form?: never;
 }
 /**

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

@@ -78,7 +78,14 @@ export interface DateInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLI
      * the two can differ.
      */
     locale?: string;
-    /** Render the calendar inline (no popover). */
+    /**
+     * Render the calendar inline (no popover).
+     * On a server-rendered page it marks today once the page hydrates, by
+     * the browser's clock rather than the server's. With no `value` or
+     * `defaultValue` it opens on the month the clock reads, and around the end
+     * of a month the server's clock and the browser's can read different
+     * months, so give it a date both render the same.
+     */
     inline?: boolean;
     /**
      * Use `<input type="date">` on coarse-pointer + small-viewport devices. At

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

@@ -65,6 +65,11 @@ export interface DateRangeInputBaseProps extends Omit<React.HTMLAttributes<HTMLD
     /**
      * Render the calendar inline, with no inputs and no popover. The hidden
      * form inputs still carry the range.
+     * On a server-rendered page it marks today once the page hydrates, by
+     * the browser's clock rather than the server's. With no `value` or
+     * `defaultValue` it opens on the month the clock reads, and around the end
+     * of a month the server's clock and the browser's can read different
+     * months, so give it a date both render the same.
      */
     inline?: boolean;
     /**

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

@@ -59,7 +59,14 @@ export interface DateTimeInputBaseProps extends Omit<React.InputHTMLAttributes<H
      * the two can differ.
      */
     locale?: string;
-    /** Render the panel inline (no popover). */
+    /**
+     * Render the panel inline (no popover).
+     * On a server-rendered page it marks today once the page hydrates, by
+     * the browser's clock rather than the server's. With no `value` or
+     * `defaultValue` it opens on the month the clock reads, and around the end
+     * of a month the server's clock and the browser's can read different
+     * months, so give it a date both render the same.
+     */
     inline?: boolean;
     /** Use `<input type="datetime-local">` on coarse-pointer devices. */
     mobileNative?: boolean | 'auto';

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

@@ -209,9 +209,9 @@ export interface TreeSelectSingleProps extends TreeSelectBaseProps {
      * @defaultValue true
      */
     closeOnSelect?: boolean;
-    /** @internal Read with the checkbox modes only. */
+    /** Read with the checkbox modes only. */
     checkedStrategy?: never;
-    /** @internal Read with the checkbox modes only. */
+    /** Read with the checkbox modes only. */
     ariaCloseLabel?: never;
 }
 /** Props for a TreeSelect with a box on every item. */
@@ -253,9 +253,9 @@ export interface TreeSelectCheckboxProps extends TreeSelectBaseProps {
     checkedStrategy?: TreeSelectCheckedStrategy;
     /** Names each tag's button, in place of "Remove" and the item's label, as on Combobox. */
     ariaCloseLabel?: string;
-    /** @internal Read with `'single'` only. */
+    /** Read with `'single'` only. */
     parentsSelectable?: never;
-    /** @internal Read with `'single'` only: the panel stays open while boxes are checked. */
+    /** Read with `'single'` only: the panel stays open while boxes are checked. */
     closeOnSelect?: never;
 }
 /**

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

@@ -1,9 +1,9 @@
 /**
- * Locks (and ref-counted-ly unlocks) `document.body` scrolling while `active`
- * is true. Safe to call from multiple components at once — the body scroll
- * is only restored once every active caller has released its lock.
+ * Locks (and ref-counted-ly unlocks) the page's scrolling while `active` is
+ * true. Safe to call from multiple components at once: the page is only
+ * given back once every active caller has released its lock.
  *
  * @function useScrollLock
- * @param active - Whether this caller wants the body scroll locked.
+ * @param active - Whether this caller wants the page's scrolling locked.
  */
 export declare function useScrollLock(active: boolean): void;

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

@@ -62,11 +62,11 @@ export interface UseAnchoredPositionOptions {
      */
     matchWidth?: boolean;
     /**
-     * Measures again after each render of the component holding the hook, for
-     * a panel whose content changes while it's open, as a filtered list's
-     * does. A fixed panel above its anchor is placed from its height, and
-     * `auto` reads the height too, so a measurement taken when it opened goes
-     * stale as the content changes.
+     * Measures again after each render of the component holding the hook,
+     * before the panel paints, for a panel whose content that component
+     * changes while it's open, as a filtered list's does. A change in size is
+     * followed without it too, but a frame later, so a panel above its anchor
+     * would show for a frame where its old height put it.
      * @defaultValue false
      */
     followContent?: boolean;
@@ -80,14 +80,16 @@ export declare function marginGap(panel: HTMLElement): number;
 /**
  * Places a floating panel against its anchor: resolves `auto` to a corner
  * and, for a panel fixed to the viewport, works out its coordinates. It
- * measures again on resize and on any scroll of the anchor's window (an
- * iframe's, when the anchor renders into one), so a fixed panel follows its
- * anchor, and with `followContent` after each render too. A measurement that
- * changes nothing doesn't render again.
+ * measures again on resize, on any scroll of the anchor's window (an
+ * iframe's, when the anchor renders into one), and when the panel or the
+ * anchor changes size, so a fixed panel follows its anchor and its own
+ * content. Those measure once in the next frame, however many arrive before
+ * it. With `followContent` it also measures after each render. A
+ * measurement that changes nothing doesn't render again.
  *
- * Measuring happens in a layout effect, so the panel is placed before it
- * paints. It needs both elements on the page while `active` is on, and
- * keeps the last placement when either is missing.
+ * The first measurement happens in a layout effect, so the panel is placed
+ * before it paints. It needs both elements on the page while `active` is
+ * on, and keeps the last placement when either is missing.
  *
  * @function useAnchoredPosition
  * @param anchorRef - The element the panel opens from.

package/dist/types/layout/Level.d.ts

@@ -5,6 +5,16 @@ import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses.js';
  * Props for the Level component.
  */
 export interface LevelProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /**
+     * HTML element to render (default: `nav`, as in Bulma's markup). A `nav` is
+     * a `navigation` landmark, so keep it for a row of links. A row that is not
+     * navigation, such as figures or a toolbar, takes `div`, which is no
+     * landmark. `header` suits a level that opens a section and `footer` one
+     * that closes it. A `header` is a `banner` landmark, and a `footer` a
+     * `contentinfo` one, only when no `section`, `article`, `aside`, `nav` or
+     * `main` is around it.
+     */
+    as?: 'nav' | 'div' | 'header' | 'footer';
     /** Keeps the level horizontal on mobile (Bulma `is-mobile`). Without it
      * the level stacks vertically below tablet. */
     isMobile?: boolean;

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

@@ -95,7 +95,7 @@ export interface CommandActionsProps extends CommandBaseProps {
      * @defaultValue 'No results'
      */
     empty?: React.ReactNode;
-    /** @internal With `actions`, the Command renders its own parts. */
+    /** With `actions`, the Command renders its own parts. */
     children?: never;
 }
 /** Props for a Command built from parts. */
@@ -108,13 +108,13 @@ export interface CommandPartsProps extends CommandBaseProps {
      * with a warning in development.
      */
     children?: React.ReactNode;
-    /** @internal Built from parts, the app renders the items. */
+    /** Built from parts, the app renders the items. */
     actions?: never;
-    /** @internal Built from parts, the app filters. */
+    /** Built from parts, the app filters. */
     filter?: never;
-    /** @internal Built from parts, `Command.Input` takes the placeholder. */
+    /** Built from parts, `Command.Input` takes the placeholder. */
     placeholder?: never;
-    /** @internal Built from parts, `Command.Empty` is the empty message. */
+    /** Built from parts, `Command.Empty` is the empty message. */
     empty?: never;
 }
 /**

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

@@ -38,7 +38,11 @@ export interface DropdownProps extends Omit<React.HTMLAttributes<HTMLDivElement>
     onActiveChange?: (active: boolean) => void;
     /** Close dropdown when a menu item is clicked, or activated with Enter or Space. */
     closeOnClick?: boolean;
-    /** Root element ID (for aria-controls, etc). */
+    /**
+     * Root element ID. The trigger gets `<id>-trigger` and the menu `<id>-menu`,
+     * which the trigger's `aria-controls` and the menu's `aria-labelledby` point
+     * at. Without one, both ids come from `useId`.
+     */
     id?: string;
 }
 /**

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

@@ -90,10 +90,8 @@ export interface HoverCardProps extends Omit<React.HTMLAttributes<HTMLSpanElemen
      * it only after the rest of the page, and focus leaving the trigger on the
      * way closes it, so keyboard users can open it, read it and close it with
      * Escape, and whatever it links to has to be reachable from the page as
-     * well. It is measured against the trigger when it opens and on resize and
-     * scroll, so it doesn't follow content that changes size while it is open.
-     * Theming variables set on an ancestor of the trigger reach it only when its
-     * container is inside that ancestor.
+     * well. Theming variables set on an ancestor of the trigger reach it only
+     * when its container is inside that ancestor.
      * @defaultValue false
      */
     appendToBody?: boolean;

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

@@ -48,9 +48,12 @@ export interface ModalProps extends Omit<React.HTMLAttributes<HTMLDivElement>, '
      */
     closeOnEscape?: boolean;
     /**
-     * Lock body scroll while the modal is active. Ref-counted and shared with
-     * `Dialog`, `Sidebar` and `Loading`, so whichever overlay closes first does
-     * not unlock the page underneath one that is still open.
+     * Lock page scroll while the modal is active, padding the page by the room
+     * its scrollbar took so the content stays put. An element fixed to the
+     * window's right edge, such as a `fixed` Navbar, isn't padded, and moves by
+     * the scrollbar's width while the page is locked. Ref-counted and shared
+     * with `Dialog`, `Sidebar` and `Loading`, so whichever overlay closes first
+     * does not unlock the page underneath one that is still open.
      * @defaultValue true
      */
     lockScroll?: boolean;

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

@@ -61,9 +61,7 @@ export interface PopoverProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
      * `ConfigProvider` sets, `document.body` by default, fixed to the viewport,
      * so an ancestor's `overflow`, `transform` or stacking context can't clip
      * it. The panel then shows from the commit after hydration, never in server
-     * markup. It is measured against the trigger when it opens and on resize
-     * and scroll, so it doesn't follow content that changes size while it is
-     * open. Theming variables set on an ancestor of the trigger reach it only
+     * markup. Theming variables set on an ancestor of the trigger reach it only
      * when its container is inside that ancestor.
      * @defaultValue false
      */

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

@@ -33,7 +33,7 @@ export interface SidebarProps extends Omit<React.HTMLAttributes<HTMLElement>, 'c
     fullWidth?: boolean;
     /**
      * Show an overlay behind the sidebar, which makes it modal: it gets
-     * `aria-modal="true"`, locks body scroll, and keeps Tab and Shift+Tab
+     * `aria-modal="true"`, locks page scroll, and keeps Tab and Shift+Tab
      * inside it while it is the topmost modal overlay. A Modal or Dialog opened
      * over it, even one rendered inside it, holds Tab until it closes. Without
      * an overlay the sidebar isn't modal and holds no Tab: on the page, Tab
@@ -60,7 +60,11 @@ export interface SidebarProps extends Omit<React.HTMLAttributes<HTMLElement>, 'c
     canCancel?: boolean;
     /** Content to display in the sidebar. */
     children?: React.ReactNode;
-    /** Renders inline instead of using a portal. */
+    /**
+     * Renders inline instead of using a portal. Without it, the sidebar renders
+     * inline on the server and while hydrating, moving into the portal once the
+     * client takes over, so hydration matches.
+     */
     inline?: boolean;
 }
 /**

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

@@ -57,7 +57,9 @@ export interface ToastProps extends Omit<React.HTMLAttributes<HTMLDivElement>, '
      */
     container?: string | HTMLElement;
     /**
-     * Renders inline instead of using a portal. Through `toast.show()`, a toast
+     * Renders inline instead of using a portal. Without it, a toast renders
+     * inline on the server and while hydrating, moving into the portal once the
+     * client takes over, so hydration matches. Through `toast.show()`, a toast
      * already renders inline in `ToastContainer`'s stack for its position, and
      * `inline` keeps one with a `container` in that stack too.
      */

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

@@ -39,7 +39,7 @@ export interface IconButtonLabelledBy {
     /** The id of the element whose text names the button, in place of `aria-label`. */
     'aria-labelledby': string;
     /**
-     * @internal Not with `aria-labelledby`, which already names the button.
+     * Not with `aria-labelledby`, which already names the button.
      * Declared so the two can't be passed together.
      */
     'aria-label'?: undefined;
@@ -54,10 +54,7 @@ export interface IconButtonLabel {
      * development.
      */
     'aria-label': string;
-    /**
-     * @internal Not with `aria-label`. Declared so the two can't be passed
-     * together.
-     */
+    /** Not with `aria-label`. Declared so the two can't be passed together. */
     'aria-labelledby'?: undefined;
 }
 /**

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

@@ -165,7 +165,7 @@ interface ComboboxDataBaseProps extends ComboboxBaseProps {
      * `Combobox.Input`.
      */
     'aria-labelledby'?: string;
-    /** @internal With `data`, the Combobox renders its own parts. */
+    /** With `data`, the Combobox renders its own parts. */
     children?: never;
 }
 /** Props for a Combobox given `data`, with one value. */
@@ -205,7 +205,7 @@ export interface ComboboxSingleDataProps extends ComboboxDataBaseProps {
      * `multiple` the array.
      */
     onChange?: (value: string | null) => void;
-    /** @internal With one value there are no tags to name. */
+    /** With one value there are no tags to name. */
     ariaCloseLabel?: never;
 }
 /** Props for a Combobox given `data`, with several values. */
@@ -253,27 +253,27 @@ export interface ComboboxPartsProps extends ComboboxBaseProps {
      * @defaultValue false
      */
     multiple?: boolean;
-    /** @internal Built from parts, there's no `data`. */
+    /** Built from parts, there's no `data`. */
     data?: never;
-    /** @internal Built from parts, the app keeps the value. */
+    /** Built from parts, the app keeps the value. */
     value?: never;
-    /** @internal Built from parts, the app keeps the value. */
+    /** Built from parts, the app keeps the value. */
     defaultValue?: never;
-    /** @internal Built from parts, `onSelect` reports a pick. */
+    /** Built from parts, `onSelect` reports a pick. */
     onChange?: never;
-    /** @internal Built from parts, `Combobox.Input` takes the placeholder. */
+    /** Built from parts, `Combobox.Input` takes the placeholder. */
     placeholder?: never;
-    /** @internal Built from parts, the app posts the value. */
+    /** Built from parts, the app posts the value. */
     name?: never;
-    /** @internal Built from parts, `Combobox.Empty` is the empty message. */
+    /** Built from parts, `Combobox.Empty` is the empty message. */
     empty?: never;
-    /** @internal Built from parts, `Combobox.Item` renders its own content. */
+    /** Built from parts, `Combobox.Item` renders its own content. */
     itemTemplate?: never;
-    /** @internal Built from parts, `Combobox.Input` takes `disabled`. */
+    /** Built from parts, `Combobox.Input` takes `disabled`. */
     disabled?: never;
-    /** @internal Built from parts, `Combobox.Input` takes `required`. */
+    /** Built from parts, `Combobox.Input` takes `required`. */
     required?: never;
-    /** @internal Built from parts, the app posts the value. */
+    /** Built from parts, the app posts the value. */
     form?: never;
 }
 /**

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

@@ -78,7 +78,14 @@ export interface DateInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLI
      * the two can differ.
      */
     locale?: string;
-    /** Render the calendar inline (no popover). */
+    /**
+     * Render the calendar inline (no popover).
+     * On a server-rendered page it marks today once the page hydrates, by
+     * the browser's clock rather than the server's. With no `value` or
+     * `defaultValue` it opens on the month the clock reads, and around the end
+     * of a month the server's clock and the browser's can read different
+     * months, so give it a date both render the same.
+     */
     inline?: boolean;
     /**
      * Use `<input type="date">` on coarse-pointer + small-viewport devices. At

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

@@ -65,6 +65,11 @@ export interface DateRangeInputBaseProps extends Omit<React.HTMLAttributes<HTMLD
     /**
      * Render the calendar inline, with no inputs and no popover. The hidden
      * form inputs still carry the range.
+     * On a server-rendered page it marks today once the page hydrates, by
+     * the browser's clock rather than the server's. With no `value` or
+     * `defaultValue` it opens on the month the clock reads, and around the end
+     * of a month the server's clock and the browser's can read different
+     * months, so give it a date both render the same.
      */
     inline?: boolean;
     /**

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

@@ -59,7 +59,14 @@ export interface DateTimeInputBaseProps extends Omit<React.InputHTMLAttributes<H
      * the two can differ.
      */
     locale?: string;
-    /** Render the panel inline (no popover). */
+    /**
+     * Render the panel inline (no popover).
+     * On a server-rendered page it marks today once the page hydrates, by
+     * the browser's clock rather than the server's. With no `value` or
+     * `defaultValue` it opens on the month the clock reads, and around the end
+     * of a month the server's clock and the browser's can read different
+     * months, so give it a date both render the same.
+     */
     inline?: boolean;
     /** Use `<input type="datetime-local">` on coarse-pointer devices. */
     mobileNative?: boolean | 'auto';

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

@@ -209,9 +209,9 @@ export interface TreeSelectSingleProps extends TreeSelectBaseProps {
      * @defaultValue true
      */
     closeOnSelect?: boolean;
-    /** @internal Read with the checkbox modes only. */
+    /** Read with the checkbox modes only. */
     checkedStrategy?: never;
-    /** @internal Read with the checkbox modes only. */
+    /** Read with the checkbox modes only. */
     ariaCloseLabel?: never;
 }
 /** Props for a TreeSelect with a box on every item. */
@@ -253,9 +253,9 @@ export interface TreeSelectCheckboxProps extends TreeSelectBaseProps {
     checkedStrategy?: TreeSelectCheckedStrategy;
     /** Names each tag's button, in place of "Remove" and the item's label, as on Combobox. */
     ariaCloseLabel?: string;
-    /** @internal Read with `'single'` only. */
+    /** Read with `'single'` only. */
     parentsSelectable?: never;
-    /** @internal Read with `'single'` only: the panel stays open while boxes are checked. */
+    /** Read with `'single'` only: the panel stays open while boxes are checked. */
     closeOnSelect?: never;
 }
 /**