@allxsmith/bestax-bulma 5.57.4 → 5.58.0

package/dist/index.esm.js

@@ -56,6 +56,7 @@ export { Link } from './esm/elements/Link.js';
 export { ListItem } from './esm/elements/ListItem.js';
 export { Loader } from './esm/elements/Loader.js';
 export { Notification, NotificationContainer, notification } from './esm/elements/Notification.js';
+export { NumberFormatter } from './esm/elements/NumberFormatter.js';
 export { OrderedList } from './esm/elements/OrderedList.js';
 export { Paragraph } from './esm/elements/Paragraph.js';
 export { Pre } from './esm/elements/Pre.js';
@@ -124,6 +125,7 @@ export { ClientOnly } from './esm/helpers/ClientOnly.js';
 export { useIsHydrated } from './esm/helpers/useIsHydrated.js';
 export { Portal } from './esm/helpers/portal.js';
 export { LocaleProvider, useLocale } from './esm/helpers/LocaleProvider.js';
+export { useNumberFormat } from './esm/helpers/localeFormat.js';
 export { useFocusTrap } from './esm/helpers/useFocusTrap.js';
 export { Container } from './esm/layout/Container.js';
 export { Footer } from './esm/layout/Footer.js';

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

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

@@ -2,9 +2,11 @@ import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses.js';
 /**
  * How items are picked: `none`, nothing is; `single`, one item at a time;
- * `checkbox`, any number, with a box on every item and mixed parents.
+ * `checkbox`, any number, with a box on every item and mixed parents;
+ * `checkbox-independent`, any number, with a box on every item that checks
+ * that item alone.
  */
-export type TreeViewSelectionMode = 'none' | 'single' | 'checkbox';
+export type TreeViewSelectionMode = 'none' | 'single' | 'checkbox' | 'checkbox-independent';
 /**
  * Props for the TreeView component. The helper props, the other attributes
  * and the `ref` land on the `<ul role="tree">`.
@@ -25,6 +27,9 @@ export interface TreeViewProps extends Omit<React.HTMLAttributes<HTMLUListElemen
      * `single`: one item, picked with Enter, Space or a click.
      * `checkbox`: any number, checked with Space or a click. A check reaches
      * every enabled item under it, and a parent with some of them checked is mixed.
+     * `checkbox-independent`: any number, checked with Space or a click, each
+     * box for its own item. A check reaches nothing under it, and no parent is
+     * mixed (Mantine's and Ant Design's `checkStrictly`).
      */
     selectionMode?: TreeViewSelectionMode;
     /**
@@ -42,18 +47,22 @@ export interface TreeViewProps extends Omit<React.HTMLAttributes<HTMLUListElemen
     onSelectedChange?: (value: string) => void;
     /**
      * The checked items' values when you hold the state. Read with `checkbox`
-     * only. A value checks its item, and an enabled item also counts as checked
-     * when any item above it is in the list, so a parent's value stands for its
-     * whole branch, loaded or not. A disabled item is checked only by its own value.
+     * and `checkbox-independent` only. A value checks its item. In `checkbox`,
+     * an enabled item also counts as checked when any item above it is in the
+     * list, so a parent's value stands for its whole branch, loaded or not, and
+     * a disabled item is checked only by its own value. In
+     * `checkbox-independent`, a value checks its own item and nothing else.
      */
     checked?: string[];
-    /** The values checked to begin with, when the tree holds its own state. Read with `checkbox` only. */
+    /** The values checked to begin with, when the tree holds its own state. Read with `checkbox` and `checkbox-independent` only. */
     defaultChecked?: string[];
     /**
-     * Called after a check or an uncheck with every item that now shows
-     * checked, parents included, plus any earlier value that matches no item
-     * the tree knows, left as it was. The order means nothing. Passed back as
-     * `checked`, the list shows the same boxes.
+     * Called after a check or an uncheck. In `checkbox`, with every item that
+     * now shows checked, parents included, plus any earlier value that matches
+     * no item the tree knows, left as it was, and the order means nothing. In
+     * `checkbox-independent`, with the list as it was, the item's value added
+     * at the end or every copy of it taken out, and everything else in the
+     * same order. Passed back as `checked`, the list shows the same boxes.
      */
     onCheckedChange?: (checked: string[]) => void;
     /**
@@ -103,7 +112,7 @@ export interface TreeViewItemProps extends Omit<React.LiHTMLAttributes<HTMLLIEle
     icon?: React.ReactNode;
     /**
      * `TreeView.Item`s under this one. Render them whenever you have them,
-     * open or not: the tree hides them while it's closed, and a checkbox tree
+     * open or not: the tree hides them while it's closed, and a `checkbox` tree
      * needs them to know what a check reaches.
      */
     children?: React.ReactNode;

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

@@ -0,0 +1,62 @@
+import React from 'react';
+import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses.js';
+/**
+ * Props for the NumberFormatter component. The helper props, the other
+ * attributes and the `ref` land on the `<data>`.
+ *
+ * @extraProp {React.Ref<HTMLDataElement>} [ref] - Ref forwarded to the `<data>`.
+ */
+export interface NumberFormatterProps extends Omit<React.DataHTMLAttributes<HTMLDataElement>, 'value' | 'color' | 'children'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
+    className?: string;
+    /**
+     * The number. The text is what `Intl.NumberFormat` writes for it, `NaN`
+     * and `Infinity` included. The `<data>` element's `value` attribute holds
+     * it as `String()` writes it, except that `-0` keeps its sign, so
+     * `Number()` reads it back: `1234.5`, `1e+21` for a very large one and
+     * `1e-7` for a very small one, `NaN`, `Infinity` and `-0`.
+     */
+    value: number;
+    /**
+     * `Intl.NumberFormat` options: a currency, a percentage, a unit, compact
+     * notation, the fraction digits, the sign. Options `Intl` refuses, such as
+     * `style: 'currency'` with no `currency`, throw its error.
+     */
+    format?: Intl.NumberFormatOptions;
+    /**
+     * BCP 47 locale tag. Unset, it's the `locale` of a `LocaleProvider` around
+     * it, and with neither, the runtime's own. On a server render that's the
+     * server's, so give it a locale, here or through a `LocaleProvider`, where
+     * the server's and the browser's can differ. A tag `Intl` refuses, such as
+     * `"en_US"`, is ignored, with a warning in development, as
+     * `LocaleProvider` ignores one.
+     */
+    locale?: string;
+    /** Text color helper. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+}
+/**
+ * The `NumberFormatter` component writes a number the way a locale writes it, such as a price, a percentage or a count, in a `<data>` element that keeps the number itself in its `value`.
+ *
+ * It formats with `Intl.NumberFormat`, in its own `locale`, else the
+ * `LocaleProvider`'s around it, else the runtime's, with `format` as the
+ * options. The `<data>` has no role and no class of its own, so a screen
+ * reader reads the formatted text and it takes the look of the text around
+ * it. For text outside JSX, such as an `aria-label`, `useNumberFormat`
+ * gives the same formatting as a function.
+ *
+ * @function
+ * @param {NumberFormatterProps} props - Props for the NumberFormatter component.
+ * @param {React.Ref<HTMLDataElement>} ref - Forwarded ref to the `<data>`.
+ * @returns {JSX.Element} The rendered number.
+ *
+ * @example
+ * <NumberFormatter
+ *   value={8456.4}
+ *   format={{ style: 'currency', currency: 'USD' }}
+ * />
+ */
+export declare const NumberFormatter: React.ForwardRefExoticComponent<NumberFormatterProps & React.RefAttributes<HTMLDataElement>>;
+export default NumberFormatter;

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

@@ -36,6 +36,13 @@ export interface LocaleProviderProps extends Omit<React.HTMLAttributes<HTMLDivEl
     /** The part of the app it covers. */
     children?: React.ReactNode;
 }
+/**
+ * INTERNAL, deliberately not exported from `src/index.ts`. A tag in
+ * canonical form, or `undefined` for an empty or missing one and for one
+ * `Intl` refuses, which `refused` reports: by default the provider's own
+ * development warning, once per tag.
+ */
+export declare function validLocale(tag: string | undefined, refused?: (tag: string) => void): string | undefined;
 /**
  * Sets the language and writing direction for the part of the app inside it, on a wrapper `<div>` and on what the library portals out of it.
  *

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

@@ -1,17 +1,39 @@
 /** Formats a number for display, with `Intl.NumberFormat` options. */
-export type NumberFormatter = (value: number, options?: Intl.NumberFormatOptions) => string;
+export type NumberFormatFunction = (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.
+ * A function that writes numbers for display in a locale: `locale` when given, else the `LocaleProvider`'s around the component, else the runtime's.
+ *
+ * Formatters are kept per locale and set of options, since building one is
+ * the expensive part, and shared, so many numbers written the same way build
+ * one. The function is the same from one render to the next for the same
+ * locale, so it's safe in a dependency array. Use it for text outside JSX,
+ * such as an `aria-label`, a `placeholder` or a chart's axis; in JSX,
+ * `NumberFormatter` also marks the number up. On a server render the
+ * runtime's locale is the server's, so give it a locale, here or through a
+ * `LocaleProvider`, where the server's and the browser's can differ. A tag
+ * `Intl` refuses is ignored, with a warning in development, as
+ * `LocaleProvider` ignores one. Options `Intl` refuses throw its error when
+ * the function is called.
+ *
+ * @function
+ * @param locale - A BCP 47 locale tag, which wins over the provider's.
+ * @returns {NumberFormatFunction} Writes `value` with `Intl.NumberFormat` options.
  *
- * @param own - The component's own locale, such as a picker's `locale`,
- * which wins inside a provider.
+ * @example
+ * const format = useNumberFormat();
+ * const placeholder = format(1500, { style: 'currency', currency: 'EUR' });
+ */
+export declare function useNumberFormat(locale?: string): NumberFormatFunction;
+/**
+ * INTERNAL, deliberately not exported from `src/index.ts`. Number formatting
+ * for a component that shows a number in passing, as `useNumberFormat`
+ * writes it in the `LocaleProvider`'s locale, or `null` outside a provider
+ * and inside one that gives no locale, as a provider with only a `dir`
+ * doesn't, where the component keeps the formatting it has always had.
  */
-export declare function useNumberFormat(own?: string): NumberFormatter | null;
+export declare function useScopedNumberFormat(): NumberFormatFunction | 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

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

@@ -30,7 +30,8 @@ export interface TreeViewPosition {
 }
 /**
  * What an item shows of the selection: `selected` in a `single` tree,
- * `checked` in a `checkbox` tree, and neither with `none`.
+ * `checked` in a `checkbox` or `checkbox-independent` tree, and neither with
+ * `none`.
  */
 export interface TreeViewItemState {
     selected?: boolean;
@@ -55,9 +56,12 @@ export interface TreeViewEngine {
     treeRef: React.MutableRefObject<HTMLUListElement | null>;
     /**
      * Whether a closed item still renders its children, drawing nothing, so a
-     * check knows everything under it. Only a checkbox tree needs to.
+     * check knows everything under it. Only a `checkbox` tree needs to: a check
+     * in a `checkbox-independent` tree reaches nothing under it.
      */
     rendersClosed: boolean;
+    /** Whether any number of items can be checked, in either checkbox mode. */
+    multiselectable: boolean;
     /** The item that holds `tabIndex={0}`. */
     tabStop: string | null;
     isOpen: (value: string) => boolean;
@@ -97,10 +101,12 @@ export interface TreeViewEngine {
  * browser (#1171), read off the page once the tree has mounted.
  *
  * Every item registers its value, its parent and whether it's disabled from
- * a layout effect. In a checkbox tree a closed item's children still render
- * and register while drawing nothing, so the registry knows every item and a
- * check reaches all of them. The keys read the items on the page, in
- * document order, each time they need them.
+ * a layout effect. In a `checkbox` tree a closed item's children still
+ * render and register while drawing nothing, so the registry knows every item
+ * and a check reaches all of them. A `checkbox-independent` tree reads each
+ * box off the checked list alone, so a check adds or takes out its own value
+ * and nothing else. The keys read the items on the page, in document order,
+ * each time they need them.
  *
  * @function useTreeView
  * @param options - The TreeView's props.

package/dist/types/index.d.ts

@@ -55,6 +55,7 @@ export * from './elements/Link.js';
 export * from './elements/ListItem.js';
 export * from './elements/Loader.js';
 export * from './elements/Notification.js';
+export * from './elements/NumberFormatter.js';
 export * from './elements/OrderedList.js';
 export * from './elements/Paragraph.js';
 export * from './elements/Pre.js';
@@ -144,6 +145,8 @@ 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 { useNumberFormat } from './helpers/localeFormat.js';
+export type { NumberFormatFunction } from './helpers/localeFormat.js';
 export { useFocusTrap } from './helpers/useFocusTrap.js';
 export type { UseFocusTrapOptions } from './helpers/useFocusTrap.js';
 export * from './layout/Container.js';

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

@@ -2,9 +2,11 @@ import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses.js';
 /**
  * How items are picked: `none`, nothing is; `single`, one item at a time;
- * `checkbox`, any number, with a box on every item and mixed parents.
+ * `checkbox`, any number, with a box on every item and mixed parents;
+ * `checkbox-independent`, any number, with a box on every item that checks
+ * that item alone.
  */
-export type TreeViewSelectionMode = 'none' | 'single' | 'checkbox';
+export type TreeViewSelectionMode = 'none' | 'single' | 'checkbox' | 'checkbox-independent';
 /**
  * Props for the TreeView component. The helper props, the other attributes
  * and the `ref` land on the `<ul role="tree">`.
@@ -25,6 +27,9 @@ export interface TreeViewProps extends Omit<React.HTMLAttributes<HTMLUListElemen
      * `single`: one item, picked with Enter, Space or a click.
      * `checkbox`: any number, checked with Space or a click. A check reaches
      * every enabled item under it, and a parent with some of them checked is mixed.
+     * `checkbox-independent`: any number, checked with Space or a click, each
+     * box for its own item. A check reaches nothing under it, and no parent is
+     * mixed (Mantine's and Ant Design's `checkStrictly`).
      */
     selectionMode?: TreeViewSelectionMode;
     /**
@@ -42,18 +47,22 @@ export interface TreeViewProps extends Omit<React.HTMLAttributes<HTMLUListElemen
     onSelectedChange?: (value: string) => void;
     /**
      * The checked items' values when you hold the state. Read with `checkbox`
-     * only. A value checks its item, and an enabled item also counts as checked
-     * when any item above it is in the list, so a parent's value stands for its
-     * whole branch, loaded or not. A disabled item is checked only by its own value.
+     * and `checkbox-independent` only. A value checks its item. In `checkbox`,
+     * an enabled item also counts as checked when any item above it is in the
+     * list, so a parent's value stands for its whole branch, loaded or not, and
+     * a disabled item is checked only by its own value. In
+     * `checkbox-independent`, a value checks its own item and nothing else.
      */
     checked?: string[];
-    /** The values checked to begin with, when the tree holds its own state. Read with `checkbox` only. */
+    /** The values checked to begin with, when the tree holds its own state. Read with `checkbox` and `checkbox-independent` only. */
     defaultChecked?: string[];
     /**
-     * Called after a check or an uncheck with every item that now shows
-     * checked, parents included, plus any earlier value that matches no item
-     * the tree knows, left as it was. The order means nothing. Passed back as
-     * `checked`, the list shows the same boxes.
+     * Called after a check or an uncheck. In `checkbox`, with every item that
+     * now shows checked, parents included, plus any earlier value that matches
+     * no item the tree knows, left as it was, and the order means nothing. In
+     * `checkbox-independent`, with the list as it was, the item's value added
+     * at the end or every copy of it taken out, and everything else in the
+     * same order. Passed back as `checked`, the list shows the same boxes.
      */
     onCheckedChange?: (checked: string[]) => void;
     /**
@@ -103,7 +112,7 @@ export interface TreeViewItemProps extends Omit<React.LiHTMLAttributes<HTMLLIEle
     icon?: React.ReactNode;
     /**
      * `TreeView.Item`s under this one. Render them whenever you have them,
-     * open or not: the tree hides them while it's closed, and a checkbox tree
+     * open or not: the tree hides them while it's closed, and a `checkbox` tree
      * needs them to know what a check reaches.
      */
     children?: React.ReactNode;

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

@@ -0,0 +1,62 @@
+import React from 'react';
+import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses.js';
+/**
+ * Props for the NumberFormatter component. The helper props, the other
+ * attributes and the `ref` land on the `<data>`.
+ *
+ * @extraProp {React.Ref<HTMLDataElement>} [ref] - Ref forwarded to the `<data>`.
+ */
+export interface NumberFormatterProps extends Omit<React.DataHTMLAttributes<HTMLDataElement>, 'value' | 'color' | 'children'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
+    className?: string;
+    /**
+     * The number. The text is what `Intl.NumberFormat` writes for it, `NaN`
+     * and `Infinity` included. The `<data>` element's `value` attribute holds
+     * it as `String()` writes it, except that `-0` keeps its sign, so
+     * `Number()` reads it back: `1234.5`, `1e+21` for a very large one and
+     * `1e-7` for a very small one, `NaN`, `Infinity` and `-0`.
+     */
+    value: number;
+    /**
+     * `Intl.NumberFormat` options: a currency, a percentage, a unit, compact
+     * notation, the fraction digits, the sign. Options `Intl` refuses, such as
+     * `style: 'currency'` with no `currency`, throw its error.
+     */
+    format?: Intl.NumberFormatOptions;
+    /**
+     * BCP 47 locale tag. Unset, it's the `locale` of a `LocaleProvider` around
+     * it, and with neither, the runtime's own. On a server render that's the
+     * server's, so give it a locale, here or through a `LocaleProvider`, where
+     * the server's and the browser's can differ. A tag `Intl` refuses, such as
+     * `"en_US"`, is ignored, with a warning in development, as
+     * `LocaleProvider` ignores one.
+     */
+    locale?: string;
+    /** Text color helper. */
+    textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
+    bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+}
+/**
+ * The `NumberFormatter` component writes a number the way a locale writes it, such as a price, a percentage or a count, in a `<data>` element that keeps the number itself in its `value`.
+ *
+ * It formats with `Intl.NumberFormat`, in its own `locale`, else the
+ * `LocaleProvider`'s around it, else the runtime's, with `format` as the
+ * options. The `<data>` has no role and no class of its own, so a screen
+ * reader reads the formatted text and it takes the look of the text around
+ * it. For text outside JSX, such as an `aria-label`, `useNumberFormat`
+ * gives the same formatting as a function.
+ *
+ * @function
+ * @param {NumberFormatterProps} props - Props for the NumberFormatter component.
+ * @param {React.Ref<HTMLDataElement>} ref - Forwarded ref to the `<data>`.
+ * @returns {JSX.Element} The rendered number.
+ *
+ * @example
+ * <NumberFormatter
+ *   value={8456.4}
+ *   format={{ style: 'currency', currency: 'USD' }}
+ * />
+ */
+export declare const NumberFormatter: React.ForwardRefExoticComponent<NumberFormatterProps & React.RefAttributes<HTMLDataElement>>;
+export default NumberFormatter;

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

@@ -36,6 +36,13 @@ export interface LocaleProviderProps extends Omit<React.HTMLAttributes<HTMLDivEl
     /** The part of the app it covers. */
     children?: React.ReactNode;
 }
+/**
+ * INTERNAL, deliberately not exported from `src/index.ts`. A tag in
+ * canonical form, or `undefined` for an empty or missing one and for one
+ * `Intl` refuses, which `refused` reports: by default the provider's own
+ * development warning, once per tag.
+ */
+export declare function validLocale(tag: string | undefined, refused?: (tag: string) => void): string | undefined;
 /**
  * Sets the language and writing direction for the part of the app inside it, on a wrapper `<div>` and on what the library portals out of it.
  *

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

@@ -1,17 +1,39 @@
 /** Formats a number for display, with `Intl.NumberFormat` options. */
-export type NumberFormatter = (value: number, options?: Intl.NumberFormatOptions) => string;
+export type NumberFormatFunction = (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.
+ * A function that writes numbers for display in a locale: `locale` when given, else the `LocaleProvider`'s around the component, else the runtime's.
+ *
+ * Formatters are kept per locale and set of options, since building one is
+ * the expensive part, and shared, so many numbers written the same way build
+ * one. The function is the same from one render to the next for the same
+ * locale, so it's safe in a dependency array. Use it for text outside JSX,
+ * such as an `aria-label`, a `placeholder` or a chart's axis; in JSX,
+ * `NumberFormatter` also marks the number up. On a server render the
+ * runtime's locale is the server's, so give it a locale, here or through a
+ * `LocaleProvider`, where the server's and the browser's can differ. A tag
+ * `Intl` refuses is ignored, with a warning in development, as
+ * `LocaleProvider` ignores one. Options `Intl` refuses throw its error when
+ * the function is called.
+ *
+ * @function
+ * @param locale - A BCP 47 locale tag, which wins over the provider's.
+ * @returns {NumberFormatFunction} Writes `value` with `Intl.NumberFormat` options.
  *
- * @param own - The component's own locale, such as a picker's `locale`,
- * which wins inside a provider.
+ * @example
+ * const format = useNumberFormat();
+ * const placeholder = format(1500, { style: 'currency', currency: 'EUR' });
+ */
+export declare function useNumberFormat(locale?: string): NumberFormatFunction;
+/**
+ * INTERNAL, deliberately not exported from `src/index.ts`. Number formatting
+ * for a component that shows a number in passing, as `useNumberFormat`
+ * writes it in the `LocaleProvider`'s locale, or `null` outside a provider
+ * and inside one that gives no locale, as a provider with only a `dir`
+ * doesn't, where the component keeps the formatting it has always had.
  */
-export declare function useNumberFormat(own?: string): NumberFormatter | null;
+export declare function useScopedNumberFormat(): NumberFormatFunction | 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

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

@@ -30,7 +30,8 @@ export interface TreeViewPosition {
 }
 /**
  * What an item shows of the selection: `selected` in a `single` tree,
- * `checked` in a `checkbox` tree, and neither with `none`.
+ * `checked` in a `checkbox` or `checkbox-independent` tree, and neither with
+ * `none`.
  */
 export interface TreeViewItemState {
     selected?: boolean;
@@ -55,9 +56,12 @@ export interface TreeViewEngine {
     treeRef: React.MutableRefObject<HTMLUListElement | null>;
     /**
      * Whether a closed item still renders its children, drawing nothing, so a
-     * check knows everything under it. Only a checkbox tree needs to.
+     * check knows everything under it. Only a `checkbox` tree needs to: a check
+     * in a `checkbox-independent` tree reaches nothing under it.
      */
     rendersClosed: boolean;
+    /** Whether any number of items can be checked, in either checkbox mode. */
+    multiselectable: boolean;
     /** The item that holds `tabIndex={0}`. */
     tabStop: string | null;
     isOpen: (value: string) => boolean;
@@ -97,10 +101,12 @@ export interface TreeViewEngine {
  * browser (#1171), read off the page once the tree has mounted.
  *
  * Every item registers its value, its parent and whether it's disabled from
- * a layout effect. In a checkbox tree a closed item's children still render
- * and register while drawing nothing, so the registry knows every item and a
- * check reaches all of them. The keys read the items on the page, in
- * document order, each time they need them.
+ * a layout effect. In a `checkbox` tree a closed item's children still
+ * render and register while drawing nothing, so the registry knows every item
+ * and a check reaches all of them. A `checkbox-independent` tree reads each
+ * box off the checked list alone, so a check adds or takes out its own value
+ * and nothing else. The keys read the items on the page, in document order,
+ * each time they need them.
  *
  * @function useTreeView
  * @param options - The TreeView's props.

package/dist/types-cjs/index.d.ts

@@ -55,6 +55,7 @@ export * from './elements/Link.js';
 export * from './elements/ListItem.js';
 export * from './elements/Loader.js';
 export * from './elements/Notification.js';
+export * from './elements/NumberFormatter.js';
 export * from './elements/OrderedList.js';
 export * from './elements/Paragraph.js';
 export * from './elements/Pre.js';
@@ -144,6 +145,8 @@ 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 { useNumberFormat } from './helpers/localeFormat.js';
+export type { NumberFormatFunction } from './helpers/localeFormat.js';
 export { useFocusTrap } from './helpers/useFocusTrap.js';
 export type { UseFocusTrapOptions } from './helpers/useFocusTrap.js';
 export * from './layout/Container.js';