@nxgt/material 3.57.0 → 3.59.0

package/dist/lib/components/ui/collections/list-pane/partials/list-pane-body.d.ts

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+/**
+ * A list pane's scrolling body. Its height reaches it as a CSS custom
+ * property set from script, never as an inline `style` in server markup.
+ * `bordered`: something (a header, the filter) sits above it.
+ */
+export declare function ListPaneBody({ height, bordered, className, children, }: {
+    height?: number | string;
+    bordered: boolean;
+    className?: string;
+    children?: ReactNode;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/list-pane/partials/list-pane-item-content.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+/**
+ * What a `ListPaneItem` holds when it is given no `children`: the leading
+ * control, the media tile, the title with its description (not when
+ * `compact`), the badge (from a 20rem pane) and the trailing buttons.
+ */
+export declare function ListPaneItemContent({ title, description, media, leading, badge, trailing, compact, }: {
+    title?: ReactNode;
+    description?: ReactNode;
+    media?: ReactNode;
+    leading?: ReactNode;
+    badge?: ReactNode;
+    trailing?: ReactNode;
+    compact: boolean;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/list-pane/partials/list-pane-search.d.ts

@@ -0,0 +1,8 @@
+/** A list pane's filter box, under its header. `topSpace`: there is no header above it. */
+export declare function ListPaneSearch({ value, label, disabled, topSpace, onChange, }: {
+    value?: string;
+    label: string;
+    disabled?: boolean;
+    topSpace: boolean;
+    onChange: (query: string) => void;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/pagination/pagination-bar-pages.d.ts

@@ -0,0 +1,8 @@
+import { paginationItems } from './pagination-items.js';
+/** The numbered buttons and gaps of a `PaginationBar`; the current page is filled and `aria-current`. */
+export declare function PaginationBarPages({ items, current, disabled, onGo, }: {
+    items: ReturnType<typeof paginationItems>;
+    current: number;
+    disabled?: boolean;
+    onGo: (page: number) => void;
+}): import("react").JSX.Element[];

package/dist/lib/components/ui/collections/server-table/partials/server-table-bulk-action-button.d.ts

@@ -0,0 +1,26 @@
+import { RowData } from '@tanstack/react-table';
+import { ServerTableBulkAction } from '../bulk-action.js';
+import { ServerTableSelection } from '../types.js';
+import { useBulkFocus } from './server-table-bulk-focus.js';
+import { useBulkTexts } from './server-table-bulk-texts.js';
+/**
+ * One declarative bulk action's button: "Label (n)" named "Label n rows" for
+ * assistive technology (or by the action's `name`, with a tooltip). Its
+ * `onClick` runs with the rows the action applies to, the selection and the
+ * focus context.
+ */
+export declare function BulkActionButton<T extends RowData>({ action, target, count, text, selection, focus, shrink, }: {
+    action: ServerTableBulkAction<T>;
+    target: {
+        ids: string[];
+        rows: T[];
+    };
+    count: number;
+    text: ReturnType<typeof useBulkTexts<T>>;
+    selection: ServerTableSelection;
+    focus: ReturnType<typeof useBulkFocus>;
+    /** In the one-row phone bar the inline action gives way, its label
+     * truncated, so the More trigger and Cancel keep their 44px and their
+     * place (#1880). Buttons are `shrink-0` otherwise. */
+    shrink: boolean;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/server-table/partials/server-table-bulk-buttons.d.ts

@@ -2,16 +2,7 @@ import { RowData } from '@tanstack/react-table';
 import { ServerTableBulkAction } from '../bulk-action.js';
 import { SelectedRows } from '../selected-rows.js';
 import { ServerTableSelection } from '../types.js';
-/**
- * The buttons of a declarative `bulkActions` list: "Label (n)", n being the
- * selected rows the action applies to, named "Label n rows" for assistive
- * technology (or by the action's `name`), and not rendered at all when n is
- * 0. Past the action's `max` its button gives way to its notice. An action
- * runs with the rows it applies to only, tested on the rows kept for the
- * selection (see `syncSelectedRows`), so the counts hold across pages. Its
- * `onClick` also gets the trigger and `focusTrigger()`.
- */
-export declare function ServerTableBulkButtons<T extends RowData>({ actions, ids, selectedRows, selection, onFocusLost, root, phone, }: {
+type ServerTableBulkButtonsProps<T extends RowData> = {
     actions: readonly ServerTableBulkAction<T>[];
     /** The selected ids, of every page. */
     ids: string[];
@@ -28,4 +19,15 @@ export declare function ServerTableBulkButtons<T extends RowData>({ actions, ids
      * others go into a "More" menu, each with its count. A number is how
      * many keep their button (the selection band's one row on a phone). */
     phone?: boolean | number;
-}): import("react").JSX.Element;
+};
+/**
+ * The buttons of a declarative `bulkActions` list: "Label (n)", n being the
+ * selected rows the action applies to, named "Label n rows" for assistive
+ * technology (or by the action's `name`), and not rendered at all when n is
+ * 0. Past the action's `max` its button gives way to its notice. An action
+ * runs with the rows it applies to only, tested on the rows kept for the
+ * selection (see `syncSelectedRows`), so the counts hold across pages. Its
+ * `onClick` also gets the trigger and `focusTrigger()`.
+ */
+export declare function ServerTableBulkButtons<T extends RowData>({ actions, ids, selectedRows, selection, onFocusLost, root, phone, }: ServerTableBulkButtonsProps<T>): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/collections/server-table/partials/server-table-bulk-entries.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+import { bulkEntries } from '../bulk-action-targets.js';
+import { BulkMoreEntry } from './server-table-bulk-more.js';
+import { useBulkTexts } from './server-table-bulk-texts.js';
+type Entries<T> = ReturnType<typeof bulkEntries<T>>;
+type Texts<T> = ReturnType<typeof useBulkTexts<T>>;
+/** The notice of each action past its `max`, by action id, for the live region. */
+export declare function overNotices<T>(targets: Entries<T>, text: Texts<T>): Map<string, ReactNode>;
+/** The actions in the phone's "More" menu, each with its label, name and notice. */
+export declare function moreEntries<T>(more: Entries<T>, text: Texts<T>): BulkMoreEntry<T>[];
+export {};

package/dist/lib/components/ui/collections/server-table/partials/server-table-bulk-focus.d.ts

@@ -1,32 +1,5 @@
 import { ServerTableBulkContext } from '../bulk-action.js';
-/** The id of the phone's "More" button in the focus bookkeeping. */
-export declare const MORE = "\0more";
-/** The attribute that gives a bulk button its stable key: the action's `id`. */
-export declare const ACTION_ATTRIBUTE = "data-bulk-action";
-/** The More button's attribute; its value lists the ids of the actions it holds. */
-export declare const MORE_ATTRIBUTE = "data-bulk-more";
-/** The attributes of an action's button: its stable key. */
-export declare const actionKey: (id: string) => {
-    "data-bulk-action": string;
-};
-/** The attributes of the More button: the ids of the actions in its menu. */
-export declare const moreKey: (ids: readonly string[]) => {
-    "data-bulk-more": string;
-};
-/**
- * The element of the bulk key `id` as it is in the DOM now, searched under
- * `root`: the action's button, else (the action lives in the More menu) the
- * More button, else `null` (the action is hidden). Never a remembered node:
- * the bar is drawn again by a resize, a rotation or the move between the
- * phone's bar and the toolbar, and a node kept before is disconnected.
- */
-export declare function findBulkElement(root: ParentNode, id: string): HTMLElement | null;
-/**
- * The element of the bulk key `id` under `scope`: `undefined` searches the
- * document, `null` (a given scope that is gone) finds nothing, never another
- * table's buttons.
- */
-export declare function resolveBulkElement(scope: ParentNode | null | undefined, id: string): HTMLElement | null;
+export { ACTION_ATTRIBUTE, actionKey, findBulkElement, MORE, MORE_ATTRIBUTE, moreKey, resolveBulkElement, } from './server-table-bulk-keys.js';
 /**
  * Where the focus of a declarative bulk list goes. It remembers the bulk
  * button that has it, so that:

package/dist/lib/components/ui/collections/server-table/partials/server-table-bulk-keys.d.ts

@@ -0,0 +1,37 @@
+import { ServerTableBulkContext } from '../bulk-action.js';
+/** The id of the phone's "More" button in the focus bookkeeping. */
+export declare const MORE = "\0more";
+/** The attribute that gives a bulk button its stable key: the action's `id`. */
+export declare const ACTION_ATTRIBUTE = "data-bulk-action";
+/** The More button's attribute; its value lists the ids of the actions it holds. */
+export declare const MORE_ATTRIBUTE = "data-bulk-more";
+/** The attributes of an action's button: its stable key. */
+export declare const actionKey: (id: string) => {
+    "data-bulk-action": string;
+};
+/** The attributes of the More button: the ids of the actions in its menu. */
+export declare const moreKey: (ids: readonly string[]) => {
+    "data-bulk-more": string;
+};
+/**
+ * The element of the bulk key `id` as it is in the DOM now, searched under
+ * `root`: the action's button, else (the action lives in the More menu) the
+ * More button, else `null` (the action is hidden). Never a remembered node:
+ * the bar is drawn again by a resize, a rotation or the move between the
+ * phone's bar and the toolbar, and a node kept before is disconnected.
+ */
+export declare function findBulkElement(root: ParentNode, id: string): HTMLElement | null;
+/**
+ * The element of the bulk key `id` under `scope`: `undefined` searches the
+ * document, `null` (a given scope that is gone) finds nothing, never another
+ * table's buttons.
+ */
+export declare function resolveBulkElement(scope: ParentNode | null | undefined, id: string): HTMLElement | null;
+/**
+ * Moves the focus on from the action `from` once its button is gone: to the
+ * next bulk button shown, else More, else `onLost` (the table's structural
+ * fallback).
+ */
+export declare function focusAfterBulk(find: (id: string) => HTMLElement | null, order: readonly string[], from: string, onLost: (() => void) | undefined): void;
+/** The context of `actionId`'s `onClick`, over a lookup made at call time. */
+export declare function bulkContext(actionId: string, find: (id: string) => HTMLElement | null, focusAfter: (from: string) => void): ServerTableBulkContext;

package/dist/lib/components/ui/collections/server-table/partials/server-table-grid-paging.d.ts

@@ -0,0 +1,8 @@
+import { RowData } from '@tanstack/react-table';
+import { DataTableProps } from '../../data-table/types.js';
+import { ServerTableProps } from '../types.js';
+import { useServerTable } from '../use-server-table.js';
+/** Whether there is one page only, and the caller hides its pager (`hideOnSinglePage`). */
+export declare function isSinglePage<T extends RowData>(props: ServerTableProps<T>, state: ReturnType<typeof useServerTable<T>>): boolean;
+/** The `pagination` the footer gets: none on a single page the caller hides, else the links, with `pageControls` when asked. */
+export declare function gridPagination<T extends RowData>(props: ServerTableProps<T>, state: ReturnType<typeof useServerTable<T>>, singlePage: boolean): DataTableProps<T>['pagination'];

package/dist/lib/components/ui/collections/server-table/types-filter.d.ts

@@ -0,0 +1,70 @@
+import { FilterDefaults, FilterFieldErrors, FilterLockedCondition, FilterModel } from '@nxgt/material-core/filter';
+import { ReactNode } from 'react';
+import { FilterBarFieldProps, FilterQueryProps } from '../filter/internal.js';
+/**
+ * The list's `Filter`, bound to the URL: `ServerTable` renders it in its top
+ * band (the bar by default) and reads and writes its query in the search
+ * params, back on the first page. The Filter then tells the count (its one
+ * live region): `ServerTable`'s own stays quiet.
+ */
+export type ServerTableFilter = {
+    /** The fields, from `defineFilterModel` (the module the loader parses the URL with). */
+    model: FilterModel;
+    /** The conditions the page imposes: a lock in the band, never in the URL. */
+    locked?: readonly FilterLockedCondition[];
+    /**
+     * The values of the `default: 'page'` fields, the same object as the
+     * loader's. The band shows a defaulted value (a hint chip, a pressed
+     * toggle), uncounted and with no ✕; the URL holds explicit choices only.
+     */
+    defaults?: FilterDefaults;
+    /**
+     * A server's refusal of a condition, by field id (`{ period: 'The period
+     * cannot exceed 366 days.' }`): the chip reads "Invalid", described by the
+     * message, the editor shows it and the live region tells it.
+     */
+    errors?: FilterFieldErrors;
+    /**
+     * A server's refusal of the search text: the search box reads "Invalid"
+     * with the message, described by it, and the live region tells it once.
+     * Cleared by the page when the search changes.
+     */
+    searchError?: ReactNode;
+    /**
+     * A refusal that belongs to no field: one error Alert under the bar, told
+     * once by the same live region. Cleared by the page when the query changes.
+     */
+    formError?: ReactNode;
+    /**
+     * Show the field errors' words under the bar (default `true`), after
+     * `formError`; `false` keeps the "Invalid" pills only.
+     */
+    errorSummary?: boolean;
+    /**
+     * How the page reads and writes the URL, to match the loader's
+     * `parseFilterQuery` / `serializeFilterQuery` options exactly:
+     * `keepKnownValues` keeps the readable values of a list condition,
+     * `encoding: 'standard'` writes `URLSearchParams`' own text. Without them
+     * the chips and the loader's rows can disagree.
+     */
+    codec?: {
+        keepKnownValues?: boolean;
+        encoding?: 'readable' | 'standard';
+    };
+    /** Each field's functions, by field id (an autocomplete's search, a custom field's render). */
+    fieldProps?: FilterBarFieldProps;
+    /** `'bar'` (default): the search, quick filters and "Add filter" in the
+     * band, the chips in a row under it from 768px. `'facets'`: a panel
+     * beside the table from 1024px. Both are the phone sheet below 768px. */
+    variant?: FilterQueryProps['variant'];
+    /** `false`: no "Filters (N)" in the bar; place a `FilterSheetTrigger`
+     * yourself, inside this `ServerTable` (`actions`, or anywhere else in its
+     * tree). `'facets'` keeps its own. Default `true`. */
+    sheetTrigger?: boolean;
+} & Pick<FilterQueryProps, 'quick' | 'density' | 'shortcuts' | 'previewCount' | 'counts' | 'liveDelayMs' | 'label' | 'searchLabel' | 'searchPlaceholder' | 'searchApply' | 'searchMinLength'>;
+/** What `ServerTable`'s `filterRef` holds. */
+export type ServerTableFilterHandle = {
+    /** Focuses the Filter's first control: its search, else the first quick
+     * filter, "Add filter" or "Filters (N)" the width shows. */
+    focus(): void;
+};

package/dist/lib/components/ui/collections/server-table/types-states.d.ts

@@ -0,0 +1,42 @@
+import { IconStyleInput } from '@nxgt/material-core/icons';
+import { ErrorStateKind } from '@nxgt/material-core/states';
+import { ReactNode } from 'react';
+import { StateHeadingLevel } from '../../feedback/state-frame/state-frame.js';
+import { ListEmptyContent } from '../list-empty/list-empty.js';
+/** What an empty page says: nothing at all yet, or nothing matching. */
+export type ServerTableEmpty = {
+    /** The list has nothing at all yet: a title, or a `ListEmptyPage`
+     * (`{ title, description?, illustration?, action? }`) for a scene and a
+     * call to action ("New"). */
+    none: ListEmptyContent;
+    /** Nothing matches the search or the filters: a title, or a
+     * `ListEmptyPage`. Its scene defaults to the "no results" one and its way
+     * out to "Clear"; an `action` replaces the way out. */
+    noMatch: ListEmptyContent;
+    /** The icon style of the scenes of the empty page and of the error
+     * (`{ family?, type? }`, a sprite file's name, or a list of them), as
+     * `IllustrationDefaults`'s `iconStyle`: for an app that serves only some
+     * sprites. */
+    iconStyle?: IconStyleInput;
+    /** The way out of "nothing matches" without `filter`. Default "Clear
+     * search and filters". */
+    clear?: string;
+    /** The level of the empty page's title (a heading, and the error's).
+     * Default 2. */
+    headingLevel?: StateHeadingLevel;
+};
+/** A failed fetch, as `ServerTable` shows it. */
+export type ServerTableError = {
+    /** The title. Default "Could not load the list"
+     * (`material.server-table.error`). */
+    title?: ReactNode;
+    /** The line under it. Default "Check your connection, then try again."
+     * (`material.server-table.error-hint`). */
+    description?: ReactNode;
+    /** The thrown value: its name, message and causes go in the collapsed
+     * technical details (never the stack). */
+    cause?: unknown;
+    /** Which failure it is: the illustration and icon follow it. Default
+     * `generic`. */
+    kind?: ErrorStateKind;
+};

package/dist/lib/components/ui/collections/server-table/types.d.ts

@@ -1,15 +1,13 @@
-import { FilterDefaults, FilterFieldErrors, FilterLockedCondition, FilterModel } from '@nxgt/material-core/filter';
-import { IconStyleInput } from '@nxgt/material-core/icons';
-import { ErrorStateKind } from '@nxgt/material-core/states';
 import { TableFilterBinding, TableSorting } from '@nxgt/material-core/table-url';
 import { RowData } from '@tanstack/react-table';
 import { ReactNode, Ref } from 'react';
-import { StateHeadingLevel } from '../../feedback/state-frame/state-frame.js';
 import { DataTableProps } from '../data-table/types.js';
-import { FilterBarFieldProps, FilterQueryProps } from '../filter/internal.js';
-import { ListEmptyContent } from '../list-empty/list-empty.js';
 import { ServerTableBulkAction } from './bulk-action.js';
+import { ServerTableFilter, ServerTableFilterHandle } from './types-filter.js';
 import { ServerTablePagingProps } from './types-paging.js';
+import { ServerTableEmpty, ServerTableError } from './types-states.js';
+export type { ServerTableFilter, ServerTableFilterHandle, } from './types-filter.js';
+export type { ServerTableEmpty, ServerTableError } from './types-states.js';
 /** What a bulk action can do to the selection once it acted. */
 export type ServerTableSelection = {
     /** Empties the selection; the table takes the focus the toolbar had. */
@@ -18,110 +16,6 @@ export type ServerTableSelection = {
      * none is left. */
     deselect(ids: readonly string[]): void;
 };
-/** What an empty page says: nothing at all yet, or nothing matching. */
-export type ServerTableEmpty = {
-    /** The list has nothing at all yet: a title, or a `ListEmptyPage`
-     * (`{ title, description?, illustration?, action? }`) for a scene and a
-     * call to action ("New"). */
-    none: ListEmptyContent;
-    /** Nothing matches the search or the filters: a title, or a
-     * `ListEmptyPage`. Its scene defaults to the "no results" one and its way
-     * out to "Clear"; an `action` replaces the way out. */
-    noMatch: ListEmptyContent;
-    /** The icon style of the scenes of the empty page and of the error
-     * (`{ family?, type? }`, a sprite file's name, or a list of them), as
-     * `IllustrationDefaults`'s `iconStyle`: for an app that serves only some
-     * sprites. */
-    iconStyle?: IconStyleInput;
-    /** The way out of "nothing matches" without `filter`. Default "Clear
-     * search and filters". */
-    clear?: string;
-    /** The level of the empty page's title (a heading, and the error's).
-     * Default 2. */
-    headingLevel?: StateHeadingLevel;
-};
-/** A failed fetch, as `ServerTable` shows it. */
-export type ServerTableError = {
-    /** The title. Default "Could not load the list"
-     * (`material.server-table.error`). */
-    title?: ReactNode;
-    /** The line under it. Default "Check your connection, then try again."
-     * (`material.server-table.error-hint`). */
-    description?: ReactNode;
-    /** The thrown value: its name, message and causes go in the collapsed
-     * technical details (never the stack). */
-    cause?: unknown;
-    /** Which failure it is: the illustration and icon follow it. Default
-     * `generic`. */
-    kind?: ErrorStateKind;
-};
-/**
- * The list's `Filter`, bound to the URL: `ServerTable` renders it in its top
- * band (the bar by default) and reads and writes its query in the search
- * params, back on the first page. The Filter then tells the count (its one
- * live region): `ServerTable`'s own stays quiet.
- */
-export type ServerTableFilter = {
-    /** The fields, from `defineFilterModel` (the module the loader parses the URL with). */
-    model: FilterModel;
-    /** The conditions the page imposes: a lock in the band, never in the URL. */
-    locked?: readonly FilterLockedCondition[];
-    /**
-     * The values of the `default: 'page'` fields, the same object as the
-     * loader's. The band shows a defaulted value (a hint chip, a pressed
-     * toggle), uncounted and with no ✕; the URL holds explicit choices only.
-     */
-    defaults?: FilterDefaults;
-    /**
-     * A server's refusal of a condition, by field id (`{ period: 'The period
-     * cannot exceed 366 days.' }`): the chip reads "Invalid", described by the
-     * message, the editor shows it and the live region tells it.
-     */
-    errors?: FilterFieldErrors;
-    /**
-     * A server's refusal of the search text: the search box reads "Invalid"
-     * with the message, described by it, and the live region tells it once.
-     * Cleared by the page when the search changes.
-     */
-    searchError?: ReactNode;
-    /**
-     * A refusal that belongs to no field: one error Alert under the bar, told
-     * once by the same live region. Cleared by the page when the query changes.
-     */
-    formError?: ReactNode;
-    /**
-     * Show the field errors' words under the bar (default `true`), after
-     * `formError`; `false` keeps the "Invalid" pills only.
-     */
-    errorSummary?: boolean;
-    /**
-     * How the page reads and writes the URL, to match the loader's
-     * `parseFilterQuery` / `serializeFilterQuery` options exactly:
-     * `keepKnownValues` keeps the readable values of a list condition,
-     * `encoding: 'standard'` writes `URLSearchParams`' own text. Without them
-     * the chips and the loader's rows can disagree.
-     */
-    codec?: {
-        keepKnownValues?: boolean;
-        encoding?: 'readable' | 'standard';
-    };
-    /** Each field's functions, by field id (an autocomplete's search, a custom field's render). */
-    fieldProps?: FilterBarFieldProps;
-    /** `'bar'` (default): the search, quick filters and "Add filter" in the
-     * band, the chips in a row under it from 768px. `'facets'`: a panel
-     * beside the table from 1024px. Both are the phone sheet below 768px. */
-    variant?: FilterQueryProps['variant'];
-    /** `false`: no "Filters (N)" in the bar; place a `FilterSheetTrigger`
-     * yourself, inside this `ServerTable` (`actions`, or anywhere else in its
-     * tree). `'facets'` keeps its own. Default `true`. */
-    sheetTrigger?: boolean;
-} & Pick<FilterQueryProps, 'quick' | 'density' | 'shortcuts' | 'previewCount' | 'counts' | 'liveDelayMs' | 'label' | 'searchLabel' | 'searchPlaceholder' | 'searchApply' | 'searchMinLength'>;
-/** What `ServerTable`'s `filterRef` holds. */
-export type ServerTableFilterHandle = {
-    /** Focuses the Filter's first control: its search, else the first quick
-     * filter, "Add filter" or "Filters (N)" the width shows. */
-    focus(): void;
-};
 /** The `DataTable` props `ServerTable` passes through as they are. */
 export type PassedThrough<T extends RowData> = Pick<DataTableProps<T>, 'columns' | 'maxHeight' | 'scrollLabel' | 'showViewOptions' | 'renderExpandedRow' | 'options' | 'loading' | 'loadingRows' | 'getRowHref' | 'onRowClick' | 'linkComponent' | 'density' | 'layout' | 'cardDensity' | 'renderCard' | 'renderTile' | 'enableRowSelection' | 'rowSelectionDisabledReason'>;
 export type ServerTableProps<T extends RowData> = PassedThrough<T> & ServerTablePagingProps & {

package/dist/lib/components/ui/collections/tree/tree-expand-button.d.ts

@@ -0,0 +1,6 @@
+/** A branch's chevron button (not a tab stop; the row's keys reach it), or the space it takes on a leaf. */
+export declare function TreeExpandButton({ expandable, expanded, onToggle, }: {
+    expandable: boolean;
+    expanded: boolean;
+    onToggle: () => void;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/tree/use-tree-keys.d.ts

@@ -0,0 +1,14 @@
+import { KeyboardEvent } from 'react';
+import { TreeRow } from './types.js';
+/**
+ * The tree's keyboard (WAI-ARIA treeview): the arrows move the focus, open
+ * and close a branch or climb to its parent, Home and End jump to the ends,
+ * Enter and Space select the focused row.
+ */
+export declare function useTreeKeyDown({ rows, tabbableId, setFocusedId, toggleExpanded, select, }: {
+    rows: TreeRow[];
+    tabbableId: string | null;
+    setFocusedId: (id: string | null) => void;
+    toggleExpanded: (id: string) => void;
+    select: (id: string) => void;
+}): (event: KeyboardEvent) => void;

package/dist/lib/components/ui/collections/tree/use-tree-select.d.ts

@@ -0,0 +1,14 @@
+import { TreeNode, TreeSelectionMode } from './types.js';
+/**
+ * `select(id)`: a click, Enter or Space on a row. A disabled row, or a tree
+ * with no selection, does nothing; `single` picks the row, `multiple`
+ * toggles it. The row also takes the focus.
+ */
+export declare function useTreeSelect({ nodes, selectionMode, selected, setSelected, setFocusedId, onSelect, }: {
+    nodes: TreeNode[];
+    selectionMode: TreeSelectionMode;
+    selected: string[];
+    setSelected: (ids: string[]) => void;
+    setFocusedId: (id: string | null) => void;
+    onSelect?: (id: string, node: TreeNode) => void;
+}): (id: string) => void;

package/dist/lib/components/ui/collections/tree/use-tree.d.ts

@@ -1,6 +1,5 @@
-import { KeyboardEvent } from 'react';
 import { TreeNode, TreeSelectionMode } from './types.js';
-export declare function useTree({ nodes, selectionMode, selectedIds, defaultSelectedIds, onSelectedIdsChange, expandedIds, defaultExpandedIds, onExpandedIdsChange, onSelect, }: {
+type UseTreeOptions = {
     nodes: TreeNode[];
     selectionMode?: TreeSelectionMode;
     selectedIds?: string[];
@@ -10,7 +9,8 @@ export declare function useTree({ nodes, selectionMode, selectedIds, defaultSele
     defaultExpandedIds?: string[];
     onExpandedIdsChange?: (ids: string[]) => void;
     onSelect?: (id: string, node: TreeNode) => void;
-}): {
+};
+export declare function useTree({ nodes, selectionMode, selectedIds, defaultSelectedIds, onSelectedIdsChange, expandedIds, defaultExpandedIds, onExpandedIdsChange, onSelect, }: UseTreeOptions): {
     rows: import('./types.js').TreeRow[];
     selected: string[];
     expanded: string[];
@@ -20,5 +20,6 @@ export declare function useTree({ nodes, selectionMode, selectedIds, defaultSele
     setFocusedId: import('react').Dispatch<import('react').SetStateAction<string | null>>;
     toggleExpanded: (id: string) => void;
     select: (id: string) => void;
-    onKeyDown: (event: KeyboardEvent) => void;
+    onKeyDown: (event: import('react').KeyboardEvent) => void;
 };
+export {};

package/dist/lib/components/ui/dates/calendar/calendar-year-button.d.ts

@@ -0,0 +1,10 @@
+type CalendarYearButtonProps = {
+    year: number;
+    selected: boolean;
+    thisYear: boolean;
+    disabled: boolean;
+    onSelect: (year: number) => void;
+};
+/** One year of the grid; the shown year is drawn as a chosen day is. */
+export declare function CalendarYearButton({ year, selected, thisYear, disabled, onSelect, }: CalendarYearButtonProps): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/dates/calendar/calendar-year-nav.d.ts

@@ -0,0 +1,9 @@
+type CalendarYearNavProps = {
+    page: number;
+    disablePrev: boolean;
+    disableNext: boolean;
+    onPage: (delta: number) => void;
+};
+/** The year grid's header: previous page, the page's range, next page. */
+export declare function CalendarYearNav({ page, disablePrev, disableNext, onPage, }: CalendarYearNavProps): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/dates/date-field/date-field-parts.d.ts

@@ -0,0 +1,78 @@
+import { ComponentProps, ReactNode, RefObject } from 'react';
+import { PickerTriggerAttrs } from '../picker-trigger/picker-trigger-attrs.js';
+import { DateFieldPopover } from './date-field-popover.js';
+import { DateFieldTyped } from './date-field-typed.js';
+/**
+ * What a zoned field does when the popover is dismissed: put back the true
+ * instant it opened with, not a wall time. `undefined` without a zone.
+ */
+export declare function zoneRestore(zone: string | undefined, instant: Date | undefined, opened: RefObject<Date | undefined>, emit?: (value?: Date) => void): (() => void) | undefined;
+type Typed = ComponentProps<typeof DateFieldTyped>;
+type SharedInput = Pick<Typed, 'open' | 'triggerAttrs' | 'value' | 'required' | 'error'> & {
+    isDisabled: boolean;
+};
+/** The props the field's trigger and its surface read alike. */
+export declare function sharedProps({ isDisabled, ...rest }: SharedInput, props: Pick<Typed, 'locale' | 'name' | 'showTimePicker' | 'hourCycle'>): {
+    disabled: boolean;
+    locale: Partial<import('react-day-picker').DayPickerLocale> | undefined;
+    name: string | undefined;
+    showTimePicker: boolean | undefined;
+    hourCycle: 12 | 24 | undefined;
+    value?: Date | undefined;
+    error?: boolean | undefined;
+    open: boolean;
+    required?: boolean | undefined;
+    triggerAttrs: PickerTriggerAttrs;
+};
+/** What names the field's trigger and the open calendar, and the ids they share. */
+export declare function useDateFieldModel({ label, placeholder, ariaLabel, ariaLabelledBy, helperText, triggerAttrs, }: {
+    label?: ReactNode;
+    placeholder?: string;
+    ariaLabel?: string;
+    ariaLabelledBy?: string;
+    helperText?: ReactNode;
+    triggerAttrs: PickerTriggerAttrs;
+}): {
+    naming: {
+        label: ReactNode;
+        placeholder: string | undefined;
+        'aria-label': string | undefined;
+        'aria-labelledby': string | undefined;
+    };
+    model: {
+        frameIds: {
+            labelId: string;
+            helperId: string;
+            triggerId: string;
+        };
+        ids: import('../picker-trigger/typed-group-name.js').TypedFieldIds;
+        labelledBy: string;
+        sheetTitle: ReactNode;
+    };
+};
+/**
+ * The calendar's open state and anchor, and the instant the field opened
+ * with: a zoned field puts that back, not a wall time.
+ */
+export declare function useDateFieldOpen(instant?: Date): {
+    anchor: RefObject<HTMLDivElement | null>;
+    open: boolean;
+    setOpen: (next: boolean) => void;
+    dir: "ltr" | "rtl" | undefined;
+    openedAt: RefObject<Date | undefined>;
+};
+type PopoverInput<P> = {
+    value?: Date;
+    required?: boolean;
+    props: P;
+    dayRule: ComponentProps<typeof DateFieldPopover>['disabled'];
+};
+/** What the open calendar gets besides its placement. */
+export declare function popoverProps<P extends object>({ value, required, props, dayRule }: PopoverInput<P>, onRestore: (() => void) | undefined): {
+    value: Date | undefined;
+    required: boolean | undefined;
+} & P & {
+    disabled: import('react-day-picker').Matcher | import('react-day-picker').Matcher[] | undefined;
+    onRestore: (() => void) | undefined;
+};
+export {};

package/dist/lib/components/ui/dates/date-range-field/partials/date-range-body-scroll.d.ts

@@ -0,0 +1,15 @@
+import { ComponentProps, ReactNode } from 'react';
+import { DateRangeFieldBodyProps } from './date-range-field-body.js';
+import { DateRangePresets } from './date-range-presets.js';
+type PresetsProps = Pick<ComponentProps<typeof DateRangePresets>, 'items' | 'onPick' | 'code'>;
+/**
+ * What scrolls when the viewport leaves too little room: the presets beside
+ * or above the calendar. The summary under it stays in view.
+ */
+export declare function DateRangeBodyScroll({ scroll, place, presets, children, }: {
+    scroll: DateRangeFieldBodyProps['scroll'];
+    place: ComponentProps<typeof DateRangePresets>['placement'];
+    presets: PresetsProps;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export {};