@allxsmith/bestax-bulma 5.52.0 → 5.54.0

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

@@ -0,0 +1,26 @@
+/** Formats a number for display, with `Intl.NumberFormat` options. */
+export type NumberFormatter = (value: number, options?: Intl.NumberFormatOptions) => string;
+/** Whether `text` contains `query`, as the locale compares letters. */
+export type TextMatcher = (text: string, query: string) => boolean;
+/**
+ * A formatter for numbers shown on screen, in the locale of the
+ * `LocaleProvider` around the component, or `null` outside one that gives a
+ * locale. Formatters are kept per set of options, since building one is the
+ * expensive part.
+ *
+ * @param own - The component's own locale, such as a picker's `locale`,
+ * which wins inside a provider.
+ */
+export declare function useNumberFormat(own?: string): NumberFormatter | null;
+/**
+ * A matcher for filtering a list by what was typed, in the locale of the
+ * `LocaleProvider` around the component, or `null` outside one that gives a
+ * locale. It compares with `Intl.Collator` at `usage: 'search'` and
+ * `sensitivity: 'base'`, so it ignores case and accents where the language
+ * treats the letters as the same: "cafe" finds "Café", while in Swedish "a"
+ * doesn't find "å", a letter of its own there. Marks the language ignores
+ * count for nothing on either side, so in Arabic محمد finds مُحَمَّد and the
+ * other way round. An empty query, or one of nothing but such marks,
+ * matches everything.
+ */
+export declare function useLocaleMatcher(): TextMatcher | null;

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

@@ -0,0 +1,23 @@
+import type { DayOfWeek } from '../form/_pickerInternals/pickerTypes.js';
+/**
+ * The canonical form of a BCP 47 tag (`"en-us"` becomes `"en-US"`), or
+ * `undefined` for an empty or missing one. Throws a `RangeError` for a tag
+ * `Intl` refuses, as `Intl.DateTimeFormat` would.
+ */
+export declare function canonicalLocale(tag: string | undefined): string | undefined;
+/**
+ * The direction a locale's script is written in: from `Intl.Locale`'s text
+ * info, else from the script `maximize()` fills in, else from the language.
+ *
+ * @param locale - A canonical tag, as `canonicalLocale` returns.
+ */
+export declare function localeDirection(locale: string): 'ltr' | 'rtl';
+/**
+ * The day a locale's week starts on, 0 for Sunday, as `getWeekInfo()` reads
+ * it: the tag's `-u-fw-` keyword, else the region its `-u-rg-` keyword names,
+ * else its own region or the one `maximize()` fills in, looked up in CLDR's
+ * week data, where a region not listed starts on Monday.
+ *
+ * @param locale - A canonical tag, as `canonicalLocale` returns.
+ */
+export declare function localeFirstDay(locale: string): DayOfWeek;

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

@@ -75,6 +75,17 @@ export interface PortalProps {
  * also reaches what the library's components portal, such as Popover's
  * `appendToBody` panel or a `Modal` with `portal`.
  *
+ * Inside a `LocaleProvider`, the children keep its `dir` and `lang`. A
+ * container inside the provider's own wrapper takes the children as they
+ * are, and they follow the provider through the page. Any other,
+ * `document.body` included, gets them inside one `<div>` carrying the
+ * provider's values, with `display: contents` so it adds no box. It is
+ * still an element, so content that must be the container's direct child,
+ * a `<tr>` in a `<tbody>`, or that a direct-child selector styles, belongs
+ * in a container inside the provider. Which of the two is settled when the
+ * children mount, so a change of locale updates them in place rather than
+ * remounting them.
+ *
  * Tab order and focus follow the DOM too. Content portaled from inside a
  * focus trap is no longer inside the trapped element, so the trap neither
  * reaches it nor holds focus there: render nested overlays inside the

package/dist/types/index.d.ts

@@ -78,6 +78,7 @@ export * from './form/CheckboxCard.js';
 export * from './form/Checkboxes.js';
 export * from './form/Control.js';
 export * from './form/Field.js';
+export * from './form/Fieldset.js';
 export * from './form/File.js';
 export * from './form/Radio.js';
 export * from './form/RadioCard.js';
@@ -133,6 +134,8 @@ export type { ClientOnlyProps } from './helpers/ClientOnly.js';
 export { useIsHydrated } from './helpers/useIsHydrated.js';
 export { Portal } from './helpers/portal.js';
 export type { PortalProps } from './helpers/portal.js';
+export { LocaleProvider, useLocale } from './helpers/LocaleProvider.js';
+export type { LocaleContextValue, LocaleProviderProps, TextDirection, } from './helpers/LocaleProvider.js';
 export { useFocusTrap } from './helpers/useFocusTrap.js';
 export type { UseFocusTrapOptions } from './helpers/useFocusTrap.js';
 export * from './layout/Container.js';

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

@@ -19,7 +19,7 @@ export interface AvatarsProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
     spacing?: AvatarsSpacing | number;
     /** Lay the avatars out side by side (non-overlapping), using `spacing` as the gap. */
     spaced?: boolean;
-    /** Builds the surplus avatar's accessible name from the hidden count, for localization. Default: `` `${count} more` ``. */
+    /** Builds the surplus avatar's accessible name from the hidden count, for localization. Default: `` `${count} more` ``. Inside a `LocaleProvider` with a `locale`, the visible `+count` and the count in the default name are written the way that locale writes numbers. */
     surplusLabel?: (count: number) => string;
     /** `Avatar` elements to render inside the group. */
     children?: React.ReactNode;

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

@@ -15,7 +15,7 @@ export interface BadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>,
     className?: string;
     /** Additional CSS classes applied to the badge pill itself (unprefixed, like `Tooltip`'s `tooltipClassName`). */
     badgeClassName?: string;
-    /** Count, short text, or a custom node to display; omit with `dot` for a plain dot. `max`/`showZero` apply only to numeric content. */
+    /** Count, short text, or a custom node to display; omit with `dot` for a plain dot. `max`/`showZero` apply only to numeric content. A numeric count is written the way the `locale` of a `LocaleProvider` around it writes numbers. */
     content?: React.ReactNode;
     /** Numeric `content` above this renders as `"{max}+"`. A negative or non-integer value falls back to the default. */
     max?: number;

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

@@ -74,8 +74,10 @@ export interface CommandActionsProps extends CommandBaseProps {
     /**
      * The actions, for a Command that renders the field, the list, the groups
      * and the empty message itself. Typing filters them by label, keywords and
-     * description, ignoring case, with label matches first. Leave it out to
-     * build the Command from parts.
+     * description, ignoring case, with label matches first. Inside a
+     * `LocaleProvider` with a `locale`, it ignores accents too where that
+     * language does, so "cafe" finds "Café". Leave it out to build the
+     * Command from parts.
      */
     actions: CommandAction[];
     /**

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

@@ -61,6 +61,9 @@ export interface PaginationProps extends React.HTMLAttributes<HTMLElement>, Omit
     /**
      * The accessible name of a page's link, when rendering from `total`, since
      * its content is only the number (`page => 'Page ' + page` by default).
+     * Inside a `LocaleProvider` with a `locale`, the number on the link, and
+     * in the default name, is written the way that locale writes numbers, so
+     * the name still holds the text on screen.
      */
     getPageLabel?: (page: number) => string;
     /** Additional CSS classes. */

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

@@ -105,7 +105,10 @@ export interface StepProps extends Omit<React.LiHTMLAttributes<HTMLLIElement>, '
     clickable?: boolean;
     /** Click handler */
     onClick?: () => void;
-    /** Step number to display in marker (1-indexed) */
+    /**
+     * Step number to display in marker (1-indexed), written the way the
+     * `locale` of a `LocaleProvider` around it writes numbers.
+     */
     stepNumber?: number;
     /**
      * Icon shown when the step is completed.

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

@@ -35,8 +35,9 @@ export interface RingProgressProps extends Omit<React.HTMLAttributes<HTMLDivElem
      * Several values around one ring, in order clockwise from the top, each
      * with its own color and label. The ring is then an image whose name
      * writes them out, such as "Storage: Documents 40%, Photos 15%", since a
-     * screen reader can't take several values from one element. A total over
-     * `max` fills the ring and stops.
+     * screen reader can't take several values from one element. Inside a
+     * `LocaleProvider` with a `locale`, the shares are written as that locale
+     * writes a percentage. A total over `max` fills the ring and stops.
      */
     sections?: RingProgressSection[];
     /**

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

@@ -27,7 +27,12 @@ export interface AutocompleteProps extends Omit<React.HTMLAttributes<HTMLDivElem
     };
     /** Applied to the inner text input (the labellable control), not the wrapper div. */
     id?: string;
-    /** The options data to display (required). */
+    /**
+     * The options data to display (required). The list shows the options that
+     * contain what's typed, ignoring case, and inside a `LocaleProvider` with a
+     * `locale`, ignoring accents too where that language does, so "cafe" finds
+     * "Café".
+     */
     data: AutocompleteItem[] | string[];
     /** The current input value (controlled). */
     value?: string;

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

@@ -174,8 +174,9 @@ export interface ComboboxSingleDataProps extends ComboboxDataBaseProps {
      * The items, for a Combobox that renders the field, the menu, the list,
      * the groups and the empty message itself. A string is an item whose label
      * is its value, and an object is `{ value, label?, disabled?, group? }`.
-     * Typing filters the items by label, ignoring case, and the Combobox keeps
-     * the value. Leave it out to build the Combobox from parts.
+     * Typing filters the items by label, ignoring case, and inside a
+     * `LocaleProvider` with a `locale`, ignoring accents too where that
+     * language does, so "cafe" finds "Café". The Combobox keeps the value. Leave it out to build the Combobox from parts.
      */
     data: (string | ComboboxItemData)[];
     /**

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

@@ -68,7 +68,15 @@ export interface DateInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLI
      * format leaves out, such as the time of day.
      */
     parse?: (s: string) => Date | null;
-    /** BCP-47 locale tag for day/month names and Intl formatting. */
+    /**
+     * BCP-47 locale tag for day/month names and Intl formatting. Unset, it is
+     * the `locale` of a `LocaleProvider` around the picker, and with neither,
+     * `Intl` uses the runtime's own locale. On a server render that is the
+     * server's, so an `inline` calendar rendered there names its days in the
+     * server's language and the browser's own render names them in the
+     * browser's: give it a locale, here or through a `LocaleProvider`, where
+     * the two can differ.
+     */
     locale?: string;
     /** Render the calendar inline (no popover). */
     inline?: boolean;
@@ -119,9 +127,23 @@ export interface DateInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLI
     shouldDisableDate?: (d: Date) => boolean;
     /** Convenience array of disabled dates; merged with `shouldDisableDate`. Matched by calendar day and also rejected during manual typing. */
     unselectableDates?: Date[];
-    /** Day the week starts on (0 = Sunday). */
+    /**
+     * Day the week starts on (0 = Sunday). Unset inside a `LocaleProvider`,
+     * it is the first day of the week in the picker's locale, its own `locale`
+     * or else the provider's, such as Monday for `"de"`. Elsewhere, with no
+     * locale from either, or with seven `dayNames` of your own, it is Sunday:
+     * set it with `dayNames` to start the week on another day.
+     * @defaultValue 0
+     */
     firstDayOfWeek?: DayOfWeek;
-    /** Override the 7 day-name labels (in calendar order, post-rotation). */
+    /**
+     * Override the 7 day-name labels (in calendar order, post-rotation). They
+     * are shown exactly as given, from the first column, so they have to start
+     * on the day the week does. With them, an unset `firstDayOfWeek` stays
+     * Sunday even inside a `LocaleProvider`, so names written Sunday first keep
+     * matching their columns; to start on the locale's day, set
+     * `firstDayOfWeek` too and list the names from that day.
+     */
     dayNames?: string[];
     /** Override the 12 month-name labels. */
     monthNames?: string[];

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

@@ -52,7 +52,15 @@ export interface DateRangeInputBaseProps extends Omit<React.HTMLAttributes<HTMLD
      * Enter and leaving an input call it only if the user changed its text.
      */
     parse?: (s: string) => Date | null;
-    /** BCP-47 locale tag for day/month names and Intl formatting. */
+    /**
+     * BCP-47 locale tag for day/month names and Intl formatting. Unset, it is
+     * the `locale` of a `LocaleProvider` around the picker, and with neither,
+     * `Intl` uses the runtime's own locale. On a server render that is the
+     * server's, so an `inline` calendar rendered there names its days in the
+     * server's language and the browser's own render names them in the
+     * browser's: give it a locale, here or through a `LocaleProvider`, where
+     * the two can differ.
+     */
     locale?: string;
     /**
      * Render the calendar inline, with no inputs and no popover. The hidden
@@ -115,9 +123,23 @@ export interface DateRangeInputBaseProps extends Omit<React.HTMLAttributes<HTMLD
      * between, so off, a span too long to walk is refused as well.
      */
     allowDisabledInRange?: boolean;
-    /** Day the week starts on (0 = Sunday). */
+    /**
+     * Day the week starts on (0 = Sunday). Unset inside a `LocaleProvider`,
+     * it is the first day of the week in the picker's locale, its own `locale`
+     * or else the provider's, such as Monday for `"de"`. Elsewhere, with no
+     * locale from either, or with seven `dayNames` of your own, it is Sunday:
+     * set it with `dayNames` to start the week on another day.
+     * @defaultValue 0
+     */
     firstDayOfWeek?: DayOfWeek;
-    /** Override the 7 day-name labels (in calendar order, post-rotation). */
+    /**
+     * Override the 7 day-name labels (in calendar order, post-rotation). They
+     * are shown exactly as given, from the first column, so they have to start
+     * on the day the week does. With them, an unset `firstDayOfWeek` stays
+     * Sunday even inside a `LocaleProvider`, so names written Sunday first keep
+     * matching their columns; to start on the locale's day, set
+     * `firstDayOfWeek` too and list the names from that day.
+     */
     dayNames?: string[];
     /** Override the 12 month-name labels. */
     monthNames?: string[];

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

@@ -49,7 +49,15 @@ export interface DateTimeInputBaseProps extends Omit<React.InputHTMLAttributes<H
      * keeps what the format leaves out, such as seconds.
      */
     parse?: (s: string) => Date | null;
-    /** BCP-47 locale tag. */
+    /**
+     * BCP-47 locale tag for day/month names and Intl formatting. Unset, it is
+     * the `locale` of a `LocaleProvider` around the picker, and with neither,
+     * `Intl` uses the runtime's own locale. On a server render that is the
+     * server's, so an `inline` calendar rendered there names its days in the
+     * server's language and the browser's own render names them in the
+     * browser's: give it a locale, here or through a `LocaleProvider`, where
+     * the two can differ.
+     */
     locale?: string;
     /** Render the panel inline (no popover). */
     inline?: boolean;
@@ -96,9 +104,23 @@ export interface DateTimeInputBaseProps extends Omit<React.InputHTMLAttributes<H
     shouldDisableDate?: (d: Date) => boolean;
     /** Convenience array of disabled dates, matched by calendar day; also rejected by manual typing. */
     unselectableDates?: Date[];
-    /** Day the calendar week starts on. */
+    /**
+     * Day the week starts on (0 = Sunday). Unset inside a `LocaleProvider`,
+     * it is the first day of the week in the picker's locale, its own `locale`
+     * or else the provider's, such as Monday for `"de"`. Elsewhere, with no
+     * locale from either, or with seven `dayNames` of your own, it is Sunday:
+     * set it with `dayNames` to start the week on another day.
+     * @defaultValue 0
+     */
     firstDayOfWeek?: DayOfWeek;
-    /** Override the 7 day-name labels. */
+    /**
+     * Override the 7 day-name labels (in calendar order, post-rotation). They
+     * are shown exactly as given, from the first column, so they have to start
+     * on the day the week does. With them, an unset `firstDayOfWeek` stays
+     * Sunday even inside a `LocaleProvider`, so names written Sunday first keep
+     * matching their columns; to start on the locale's day, set
+     * `firstDayOfWeek` too and list the names from that day.
+     */
     dayNames?: string[];
     /** Override the 12 month-name labels. */
     monthNames?: string[];

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

@@ -0,0 +1,86 @@
+import React from 'react';
+import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses.js';
+import type { FormFieldProps } from './fieldProps.js';
+/** The looks a Fieldset comes in. */
+export type FieldsetVariant = 'default' | 'filled' | 'unstyled';
+/**
+ * Props for the Fieldset component. The helper props, the other attributes
+ * and the `ref` land on its `<fieldset>`.
+ *
+ * @extraProp {React.Ref<HTMLFieldSetElement>} [ref] - Ref forwarded to the `<fieldset>`, whose `elements` lists the controls inside.
+ * @extraProp {string} [aria-describedby] - Ids of more text that describes the group. The `message`'s id is added after them.
+ * @extraProp {string} [name] - The fieldset's name in its form's `elements`. Nothing is submitted under it.
+ */
+export interface FieldsetProps extends Omit<React.FieldsetHTMLAttributes<HTMLFieldSetElement>, 'color'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /**
+     * The group's name, shown in a `<legend>`, which names the fieldset with no
+     * ids to wire. The `default` and `filled` variants draw it on the border,
+     * and `unstyled` above the content. Controls you put in it, such as a
+     * `Checkbox` that turns the section on, stay enabled when the Fieldset is
+     * disabled, as the browser leaves them.
+     */
+    legend?: React.ReactNode;
+    /** Props for the `<legend>`, such as an `id` or a `className`. */
+    legendProps?: React.HTMLAttributes<HTMLLegendElement>;
+    /**
+     * The look: `default` draws a border round the group, `filled` adds a
+     * tinted background, and `unstyled` draws no box at all, which suits a
+     * Fieldset that's there to name or disable a group.
+     */
+    variant?: FieldsetVariant;
+    /**
+     * Disables every control inside. The browser disables the native ones and
+     * leaves them out of the form's data, and each bestax input with a
+     * `disabled` prop takes this as that prop's default, which also stops
+     * widgets the browser doesn't reach, such as `Rate`'s stars and the time
+     * wheels, and gives them their disabled look. An input's own `disabled`
+     * still wins when you set it, though the browser keeps its native parts
+     * disabled whatever it says. Links and `LinkButton`s stay operable, as in
+     * plain HTML.
+     */
+    disabled?: boolean;
+    /**
+     * Help text under the group. It describes the fieldset through
+     * `aria-describedby`, alongside any ids you pass there. Nothing passes it
+     * to the inputs, so each still shows its own errors.
+     */
+    message?: React.ReactNode;
+    /** Bulma color for the message. */
+    messageColor?: FormFieldProps['messageColor'];
+    /** Text color helper, for the text in the group. The legend keeps its own color. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Additional CSS classes. */
+    className?: string;
+    /** The group's content, such as `Field`s and inputs. */
+    children?: React.ReactNode;
+}
+/**
+ * The `Fieldset` component groups a section of a form in a native
+ * `<fieldset>`, named by its `legend`, which a `disabled` switches off as a
+ * whole.
+ *
+ * It starts its own Field scope: inside it, nothing reads as inside a
+ * `Field` or `Control`, so the convenience inputs render their own `Field`,
+ * and a labeled `Field` around the Fieldset names nothing in it.
+ *
+ * @function
+ * @param {FieldsetProps} props - Props for the Fieldset component.
+ * @returns {JSX.Element} The rendered fieldset.
+ *
+ * @example
+ * <Fieldset legend="Shipping address" message="We only ship within the EU.">
+ *   <Input label="Street" name="street" />
+ *   <Input label="City" name="city" />
+ * </Fieldset>
+ *
+ * @example
+ * // A form that's saving
+ * <Fieldset disabled={saving} variant="unstyled">
+ *   <Input label="Name" name="name" />
+ *   <Rate label="Rating" name="rating" />
+ * </Fieldset>
+ */
+export declare const Fieldset: React.ForwardRefExoticComponent<FieldsetProps & React.RefAttributes<HTMLFieldSetElement>>;
+export default Fieldset;

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

@@ -66,7 +66,8 @@ export interface FileProps extends Omit<React.InputHTMLAttributes<HTMLInputEleme
     fileName?: string;
     /**
      * Builds the text `hasName` shows when several files are picked, from their count, for
-     * localization. Default: `` `${count} files` ``. A single pick shows its file's name.
+     * localization. Default: `` `${count} files` ``, with the count written the way the `locale`
+     * of a `LocaleProvider` around it writes numbers. A single pick shows its file's name.
      */
     pickedFilesLabel?: (count: number) => string;
 }

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

@@ -14,6 +14,18 @@ export declare const useInsideControl: () => boolean;
 export declare const FieldProvider: React.Provider<boolean>;
 /** Provider for Control context — used internally by Control component. */
 export declare const ControlProvider: React.Provider<boolean>;
+/**
+ * An input's `disabled`: its own prop when the caller set one, otherwise
+ * whether a disabled `Fieldset` holds it. A `<fieldset disabled>` disables the
+ * native controls inside on its own, and this carries the same state to what
+ * the browser doesn't reach, such as Rate's stars, the time wheels, and the
+ * `is-disabled` classes. The content of a Fieldset's legend reads the state
+ * from outside that Fieldset, as the browser leaves the first legend's
+ * controls enabled. Internal; not part of the public API.
+ */
+export declare const useFieldsetDisabled: (disabled: boolean | undefined) => boolean;
+/** Provider for a Fieldset's disabled state, used internally by Fieldset. */
+export declare const FieldsetDisabledProvider: React.Provider<boolean>;
 /** The wrapper props that change what its own `Field` renders. */
 interface FieldShapingProps {
     /** Rendered as the `Field`'s label. */

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

@@ -53,7 +53,10 @@ export interface RateProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'o
     size?: RateSize;
     /** Whether the rating is disabled. */
     disabled?: boolean;
-    /** Show the numeric score next to stars. */
+    /**
+     * Show the numeric score next to stars, written the way the `locale` of a
+     * `LocaleProvider` around it writes numbers.
+     */
     showScore?: boolean;
     /** Show custom text based on value. */
     showText?: boolean;

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

@@ -52,11 +52,18 @@ interface SliderBaseProps extends Omit<React.InputHTMLAttributes<HTMLInputElemen
     marks?: SliderMark[];
     /** Orientation of the slider. */
     orientation?: SliderOrientation;
-    /** Function to scale the displayed value. */
+    /**
+     * Function to scale the displayed value. With it, and no `getAriaValueText`,
+     * the scaled value is also the thumb's `aria-valuetext`.
+     */
     scale?: (value: number) => number;
     /** Function to generate the `aria-valuetext` attribute. */
     getAriaValueText?: (value: number) => string;
-    /** Format function for output display. */
+    /**
+     * Format function for output display. Without it, the output shows the
+     * value as it is, or inside a `LocaleProvider` with a `locale`, written
+     * the way that locale writes numbers, to at most three decimals.
+     */
     formatOutput?: (value: number) => string;
 }
 /**

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

@@ -42,7 +42,10 @@ export interface TaginputProps extends Omit<React.HTMLAttributes<HTMLDivElement>
      * Autocomplete suggestions. With `data` set, even to an empty array, the
      * text input is a `role="combobox"` that controls the suggestion list and
      * points `aria-activedescendant` at the highlighted suggestion. Without it
-     * there's no list, so the input stays a plain text field.
+     * there's no list, so the input stays a plain text field. The list shows
+     * the suggestions that contain what's typed, ignoring case, and inside a
+     * `LocaleProvider` with a `locale`, ignoring accents too where that
+     * language does, so "cafe" finds "Café".
      */
     data?: string[];
     /** Placeholder text when no tags. */
@@ -81,7 +84,10 @@ export interface TaginputProps extends Omit<React.HTMLAttributes<HTMLDivElement>
     rounded?: boolean;
     /** Truncates long tag text with ellipsis. */
     ellipsis?: boolean;
-    /** Shows a counter of the number of tags. */
+    /**
+     * Shows a counter of the number of tags, written the way the `locale` of
+     * a `LocaleProvider` around it writes numbers.
+     */
     hasCounter?: boolean;
     /**
      * Characters that split pasted text into tags. Each part goes through the

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

@@ -42,7 +42,11 @@ export interface TimeInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLI
      * keeps what the format leaves out, such as seconds and the date.
      */
     parse?: (s: string) => Date | null;
-    /** BCP-47 locale tag for Intl formatting. */
+    /**
+     * BCP-47 locale tag for Intl formatting. Unset, it is the `locale` of a
+     * `LocaleProvider` around the picker, and with neither, `Intl` uses the
+     * runtime's own locale.
+     */
     locale?: string;
     /** Render the spinner inline (no popover). */
     inline?: boolean;

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

@@ -1,4 +1,5 @@
 import React from 'react';
+import { type PortalLocale } from '../../helpers/LocaleProvider.js';
 import { PickerPosition } from './pickerTypes.js';
 export interface PickerPopoverProps {
     isOpen: boolean;
@@ -29,6 +30,11 @@ export interface PickerPopoverProps {
      * nothing matches, or the match can't take focus, the first tab stop does.
      */
     initialFocusSelector?: string;
+    /**
+     * The `dir` and `lang` the panel carries when it portals, in place of a
+     * `LocaleProvider`'s: the picker's own, from `usePickerLocaleScope`.
+     */
+    localeScope?: PortalLocale;
 }
 export declare const PickerPopover: React.FC<PickerPopoverProps>;
 export default PickerPopover;

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

@@ -0,0 +1,49 @@
+import { type PortalLocale } from '../../helpers/LocaleProvider.js';
+import type { DayOfWeek } from './pickerTypes.js';
+/**
+ * A picker's locale: its own `locale`, else the one a `LocaleProvider` around
+ * it sets, else `undefined`, which leaves `Intl` to use the runtime's.
+ */
+export declare function usePickerLocale(own: string | undefined): string | undefined;
+/** Where a picker's own language and direction go, inside a `LocaleProvider`. */
+export interface PickerLocaleScope {
+    /**
+     * The `lang` and `dir` for the picker's root, so what renders inside it,
+     * an inline calendar or a popover in place, follows them. Empty unless the
+     * picker has a `locale` of its own.
+     */
+    rootAttrs: {
+        lang?: string;
+        dir?: string;
+    };
+    /** What its portaled panel carries; unset outside a provider. */
+    panel?: PortalLocale;
+}
+/**
+ * A picker's language and direction inside a `LocaleProvider`, by the rule a
+ * nested provider follows: its `lang` is its own `locale`, else the
+ * provider's, and its `dir` is the `dir` passed to it, else its own locale's
+ * direction when it has one, else the provider's. Outside a provider it
+ * changes nothing. A `locale` `Intl` refuses counts as none here, since the
+ * picker's own formatting reports it.
+ */
+export declare function usePickerLocaleScope(ownLocale: string | undefined, ownDir: string | undefined): PickerLocaleScope;
+/**
+ * Whether a picker's `dayNames` replace the calendar's own, which `Calendar`
+ * does only for a full week of seven.
+ */
+export declare function hasOwnDayNames(dayNames: string[] | undefined): boolean;
+/**
+ * The day a picker's week starts on: its own `firstDayOfWeek`, else, inside a
+ * `LocaleProvider`, the first day of the locale the picker uses, else Sunday.
+ * Outside a provider it stays Sunday whatever the locale, as it always has,
+ * and so does a picker inside one with no locale from either, since the
+ * runtime's own differs between the server and the browser.
+ *
+ * It also stays Sunday for a picker that brings its own `dayNames`. The
+ * calendar shows those exactly as given, in calendar order, and before the
+ * provider an unset `firstDayOfWeek` was always Sunday, so names written
+ * Sunday first would sit a day or more off their columns if the week moved
+ * under them.
+ */
+export declare function usePickerFirstDayOfWeek(own: DayOfWeek | undefined, locale: string | undefined, hasDayNames: boolean): DayOfWeek;