@nxgt/material 3.57.0 → 3.58.0

package/dist/lib/components/ui/collections/data-grid/partials/grid-cell-access.d.ts

@@ -0,0 +1,26 @@
+import { GridPos } from '@nxgt/material-core/data-grid';
+import { Cell, RowData } from '@tanstack/react-table';
+import { DataTableFeatures } from '../../data-table/features.js';
+import { DataGridContextValue } from '../data-grid-context.js';
+/**
+ * What the cell at `pos` allows, and whether it says so (`said`, with the
+ * shared description's id). A row header with no editor is the row's name,
+ * not a field: it says nothing (its row's tag tells the row's state).
+ */
+export declare function describedBy<TData extends RowData>(grid: DataGridContextValue<TData>, pos: GridPos): {
+    access: import('@nxgt/material-core/data-grid').GridAccess;
+    said: boolean;
+    id: undefined;
+} | {
+    access: "locked" | "readonly" | "computed";
+    said: boolean;
+    id: string;
+};
+/** Whether Escape on the active cell is the grid's: a range to collapse, the paste problems to close. */
+export declare function keepsEscape<TData extends RowData>(grid: DataGridContextValue<TData>, pos: GridPos): boolean;
+/** The classes of a body cell: the grid's, the virtual one, the row header's, the control and selected ones, the column's own. */
+export declare function cellClassName<TData extends RowData>(grid: DataGridContextValue<TData>, cell: Cell<DataTableFeatures, TData, unknown>, flags: {
+    header: boolean;
+    control: boolean;
+    selected?: boolean;
+}): string;

package/dist/lib/components/ui/collections/data-grid/partials/grid-header-name.d.ts

@@ -0,0 +1,15 @@
+import { Column, Header, RowData } from '@tanstack/react-table';
+import { DataTableFeatures } from '../../data-table/features.js';
+/** The classes of a header cell: the virtual and sortable ones, the menu's and grip's room, the column's own. */
+export declare function headerClassName<TData extends RowData>(column: Column<DataTableFeatures, TData, unknown>, flags: {
+    fixed: boolean;
+    cut: boolean;
+    hasMenu: boolean;
+    canResize: boolean;
+}): string;
+/** A header's name (its `labelId` is what the cell is labelled by) and its sort arrow. */
+export declare function GridHeaderName<TData extends RowData>({ header, labelId, sorted, }: {
+    header: Header<DataTableFeatures, TData, unknown>;
+    labelId: string;
+    sorted: false | 'asc' | 'desc';
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/data-grid/partials/header-menu-button.d.ts

@@ -0,0 +1,17 @@
+import { Ref } from 'react';
+/**
+ * The button of a header's menu: a plain one with the menu button's ARIA
+ * (`aria-haspopup`, `aria-expanded`, `aria-controls` once open). A press
+ * opens it (`onShow(true)`), a second press closes it (`onClose`); Enter,
+ * Space and ArrowDown open it from the keyboard. Its clicks never sort.
+ */
+export declare function HeaderMenuButton({ ref, id, menuId, isOpen, label, onShow, onClose, }: {
+    ref: Ref<HTMLButtonElement>;
+    id: string;
+    menuId: string;
+    isOpen: boolean;
+    /** The column's label, which the button's name carries. */
+    label: string;
+    onShow: (pointer?: boolean) => void;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/data-grid/partials/open-header-menu.d.ts

@@ -0,0 +1,14 @@
+import { RowData } from '@tanstack/react-table';
+import { DataGridContextValue } from '../data-grid-context.js';
+import { GridColumn } from '../use-grid-model.js';
+/** The open menu, anchored over its header's button, which names it. */
+export declare function OpenHeaderMenu<TData extends RowData>({ grid, column, buttonId, menuId, byKeyboard, onClose, afterMenu, openWidth, }: {
+    grid: DataGridContextValue<TData>;
+    column: GridColumn<TData>;
+    buttonId: string;
+    menuId: string;
+    byKeyboard: boolean;
+    onClose: () => void;
+    afterMenu: (event: Event) => void;
+    openWidth: () => void;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/data-grid/partials/width-field.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The width field of `WidthStepper`: a plain spinbutton `<input>` and its
+ * unit, isolated left to right so a right-to-left page reads "144 px".
+ */
+export declare function WidthField({ titleId, bounds, width, draft, onDraft, onStep, onType, onDone, onLeave, }: {
+    titleId: string;
+    bounds: {
+        min: number;
+        max: number;
+    };
+    width: number;
+    draft: string | null;
+    onDraft: (draft: string | null) => void;
+    onStep: (up: boolean, shift: boolean) => void;
+    onType: (width: number) => void;
+    onDone: () => void;
+    onLeave: () => void;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/data-grid/phone/phone-item.d.ts

@@ -7,8 +7,8 @@ export declare function PhoneBadges({ state }: {
 /**
  * One row of the phone list: a button at least 44px tall with the row's
  * label and its badges, its summary under them (the app's `renderPhoneItem`,
- * else the cells' values), and a locked or read-only row's reason. Opens
- * the row panel.
+ * else the cells' values), and a locked or read-only row's reason. Its
+ * accessible name is all of that text, label first. Opens the row panel.
  */
 export declare function PhoneItem({ id, label, state, summary, onOpen, }: {
     id: string;

package/dist/lib/components/ui/collections/data-table/partials/layouts/data-table-card-list.d.ts

@@ -0,0 +1,17 @@
+import { RowData } from '@tanstack/react-table';
+import { HTMLAttributes } from 'react';
+import { DataTableProps, DataTableTable } from '../../types.js';
+/**
+ * The `<ul>` of `DataTableCards`: one card (or tile) per row of the table,
+ * or, while loading with nothing to show, placeholder cards.
+ */
+export declare function DataTableCardList<TData extends RowData>({ layout, table, props, listProps, selectable, }: {
+    layout: 'cards' | 'tiles';
+    table: DataTableTable<TData>;
+    props: DataTableProps<TData>;
+    /** The list's own attributes (role, ref, density, busy), built by the parent. */
+    listProps: HTMLAttributes<HTMLUListElement> & {
+        ref?: React.Ref<HTMLUListElement>;
+    };
+    selectable: boolean;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/data-table/partials/layouts/list-bar-clear.d.ts

@@ -0,0 +1,10 @@
+import { RowData } from '@tanstack/react-table';
+import { RefObject } from 'react';
+import { DataTableTable } from '../../types.js';
+/** The list bar's "Clear selection": an icon on a narrow list, still named and with a tooltip. */
+export declare function ListBarClear<TData extends RowData>({ table, rootRef, label, }: {
+    table: DataTableTable<TData>;
+    /** The list's root, where the focus goes once the button is gone. */
+    rootRef?: RefObject<HTMLElement | null>;
+    label: string;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/data-table/partials/layouts/list-bar-in-row.d.ts

@@ -0,0 +1,18 @@
+import { RowData } from '@tanstack/react-table';
+import { ReactNode } from 'react';
+import { DataTableListSlots } from '../../data-table-list-slots.js';
+import { DataTableTable } from '../../types.js';
+/**
+ * The list bar on a phone, when the host gives the list a row of its own:
+ * its start group (the select-all box, with a short visible label the count
+ * replaces in place, and "Clear selection") goes to the host's start slot,
+ * the sort to its sort slot.
+ */
+export declare function ListBarInRow<TData extends RowData>({ table, slots, count, countText, selectAll, clear, }: {
+    table: DataTableTable<TData>;
+    slots: DataTableListSlots;
+    count: number;
+    countText: string;
+    selectAll: (visibleLabel?: string) => ReactNode;
+    clear: ReactNode;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/data-table/partials/page-button.d.ts

@@ -0,0 +1,12 @@
+/**
+ * One of the pager's four icon buttons: a tonal `IconButton` in a tooltip
+ * that says `label`, which a screen reader gets as well. `wide` (first and
+ * last page) hides it below the `lg` breakpoint.
+ */
+export declare function PageButton({ label, icon, wide, onClick, disabled, }: {
+    label: string;
+    icon: 'chevrons-left' | 'chevron-left' | 'chevron-right' | 'chevrons-right';
+    wide?: boolean;
+    onClick: () => void;
+    disabled: boolean;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/data-table/partials/page-icon-control.d.ts

@@ -0,0 +1,21 @@
+import { ReactNode } from 'react';
+import { DataTableLinkComponent, DataTablePageTarget } from '../types.js';
+/** What an inert control looks like: it takes no pointer and is dimmed, as
+ * the sort headers' are while loading. */
+export declare const INERT = "aria-disabled:pointer-events-none aria-disabled:opacity-50";
+/**
+ * The icon-only "Previous" or "Next" of the server footer
+ * (`pageControls: 'icon'`): a tonal icon button with a tooltip and a name
+ * that says the page, a link when the target is an href, else a button.
+ */
+export declare function PageIconControl({ previous, target, Link, glyph, slot, inert, gone, }: {
+    previous: boolean;
+    target?: DataTablePageTarget | null;
+    Link: DataTableLinkComponent;
+    glyph: ReactNode;
+    slot: string;
+    /** `true` while the table is loading. */
+    inert: true | undefined;
+    /** `true` when the page is not there, or the table is loading. */
+    gone: true | undefined;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/data-table/partials/pager-buttons.d.ts

@@ -0,0 +1,7 @@
+import { RowData, Table } from '@tanstack/react-table';
+import { DataTableFeatures } from '../features.js';
+/** The pager's first, previous, next and last page buttons (first and last from the `lg` breakpoint). */
+export declare function PagerButtons<TData extends RowData>({ table, disabled, }: {
+    table: Table<DataTableFeatures, TData>;
+    disabled: boolean;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/data-table/use-data-table-setup.d.ts

@@ -0,0 +1,36 @@
+import { RowData } from '@tanstack/react-table';
+import { DataTableProps } from './types.js';
+/**
+ * What `DataTable` decides before it renders: its layout (a list of cards
+ * is neither virtualized nor given an expanded row), the virtual option,
+ * the TanStack table, the focus it records and whether the data is filtered.
+ */
+export declare function useDataTableSetup<TData extends RowData>(props: DataTableProps<TData>): {
+    layout: import('./layout-types.js').DataTableLayout;
+    list: boolean;
+    virtual: import('./virtual-option.js').DataTableVirtualOptions | undefined;
+    unpaged: boolean;
+    table: import('@tanstack/react-table').ReactTable<{
+        columnFilteringFeature: import('@tanstack/table-core').TableFeature;
+        columnVisibilityFeature: import('@tanstack/table-core').TableFeature;
+        columnOrderingFeature: import('@tanstack/table-core').TableFeature;
+        columnSizingFeature: import('@tanstack/table-core').TableFeature;
+        columnResizingFeature: import('@tanstack/table-core').TableFeature;
+        rowSelectionFeature: import('@tanstack/table-core').TableFeature;
+        rowSortingFeature: import('@tanstack/table-core').TableFeature;
+        rowExpandingFeature: import('@tanstack/table-core').TableFeature;
+        rowPaginationFeature: import('@tanstack/table-core').TableFeature;
+        filteredRowModel: (table: import('@tanstack/table-core').Table<any, any>) => () => import('@tanstack/table-core').RowModel<any, any>;
+        sortedRowModel: (table: import('@tanstack/table-core').Table<any, any>) => () => import('@tanstack/table-core').RowModel<any, any>;
+        paginatedRowModel: (table: import('@tanstack/table-core').Table<any, any>) => () => import('@tanstack/table-core').RowModel<any, any>;
+        expandedRowModel: (table: import('@tanstack/table-core').Table<any, any>) => () => import('@tanstack/table-core').RowModel<any, any>;
+    }, TData, import('@tanstack/table-core').TableState_ColumnFiltering & import('@tanstack/table-core').TableState_ColumnOrdering & import('@tanstack/table-core').TableState_ColumnResizing & import('@tanstack/table-core').TableState_ColumnSizing & import('@tanstack/table-core').TableState_ColumnVisibility & import('@tanstack/table-core').TableState_RowExpanding & import('@tanstack/table-core').TableState_RowPagination & import('@tanstack/table-core').TableState_RowSelection & import('@tanstack/table-core').TableState_RowSorting>;
+    focusable: boolean;
+    focus: {
+        ref: import('react').RefCallback<HTMLTableElement>;
+        listRef: import('react').RefCallback<HTMLElement>;
+        onFocus: (event: import('react').FocusEvent) => void;
+        controls: import('./slots.js').DataTableControls;
+    };
+    filtered: boolean;
+};

package/dist/lib/components/ui/collections/facet-group/partials/facet-group-header.d.ts

@@ -0,0 +1,11 @@
+import { ElementType, Ref } from 'react';
+import { FacetGroupProps } from '../types.js';
+type FacetGroupHeaderProps = Pick<FacetGroupProps, 'title' | 'hint' | 'activeCount' | 'onClear'> & {
+    Heading: ElementType;
+    shown: boolean;
+    toggle: Ref<HTMLButtonElement>;
+    clear: () => void;
+};
+/** The header row: the disclosure toggle (title, hint, count, chevron) and Clear beside it. */
+export declare function FacetGroupHeader({ title, hint, activeCount, onClear, Heading, shown, toggle, clear, }: FacetGroupHeaderProps): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/collections/filter/filter-field-config-base.utils.d.ts

@@ -0,0 +1,13 @@
+import { FilterField } from './types.js';
+/** What every generic field built from a filter field carries. */
+export declare function baseFieldConfig(field: FilterField, error?: string, disabled?: boolean): {
+    id: string;
+    name: string;
+    label: string;
+    placeholder: string | undefined;
+    disabled: boolean | undefined;
+    error: boolean;
+    helperText: string | undefined;
+    className: string | undefined;
+};
+export type BaseFieldConfig = ReturnType<typeof baseFieldConfig>;

package/dist/lib/components/ui/collections/filter/filter-field-config-choice.utils.d.ts

@@ -0,0 +1,5 @@
+import { FieldConfig } from '../../fields/field/types.js';
+import { BaseFieldConfig } from './filter-field-config-base.utils.js';
+import { FilterField } from './types.js';
+/** The choice fields (select, multi-select, chips, radio and checkbox groups) as generic fields. */
+export declare function choiceFieldConfig(field: FilterField, baseConfig: BaseFieldConfig, value: any, onChange: (value: any) => void): FieldConfig | null;

package/dist/lib/components/ui/collections/filter/filter-field-config-value.utils.d.ts

@@ -0,0 +1,5 @@
+import { FieldConfig } from '../../fields/field/types.js';
+import { BaseFieldConfig } from './filter-field-config-base.utils.js';
+import { FilterField } from './types.js';
+/** The value fields (text, number, switch, date, date range, slider) as generic fields. */
+export declare function valueFieldConfig(field: FilterField, baseConfig: BaseFieldConfig, value: any, onChange: (value: any) => void): FieldConfig | null;

package/dist/lib/components/ui/collections/filter/filter-field-config.utils.d.ts

@@ -0,0 +1,6 @@
+import { FieldConfig } from '../../fields/field/types.js';
+import { FilterField } from './types.js';
+/**
+ * Map a FilterField to FieldConfig for use with generic Field component
+ */
+export declare function mapFilterFieldToFieldConfig(field: FilterField, value: any, onChange: (value: any) => void, error?: string, disabled?: boolean): FieldConfig | null;

package/dist/lib/components/ui/collections/filter/filter-legacy.d.ts

@@ -59,4 +59,4 @@ export type FilterProps = Omit<FilterProviderProps, 'children'> & {
  * />
  * ```
  */
-export declare function FilterLegacy({ variant, schema, values, defaultValues, onChange, onApply, onReset, persistence, presetConfig, liveUpdate, disabled, showActions, contentClassName, actionsClassName, trigger, title, description, triggerLabel, showTriggerCount, side, direction, align, popoverSide, className, }: FilterProps): import("react").JSX.Element;
+export declare function FilterLegacy(props: FilterProps): import("react").JSX.Element;

package/dist/lib/components/ui/collections/filter/filter-persistence-url-value.utils.d.ts

@@ -0,0 +1,9 @@
+import { FilterField, FilterValue } from './types.js';
+/**
+ * Serialize filter value to URL param string
+ */
+export declare function serializeFilterValue(field: FilterField, value: FilterValue): string | null;
+/**
+ * Parse URL param string to filter value
+ */
+export declare function parseFilterValue(field: FilterField, paramValue: string): FilterValue;

package/dist/lib/components/ui/collections/filter/filter-schema.utils.d.ts

@@ -1,4 +1,3 @@
-import { FieldConfig } from '../../fields/field/types.js';
 import { FilterField, FilterGroup, FilterSchema, FilterValues } from './types.js';
 /**
  * Get a filter field by ID from schema
@@ -28,7 +27,4 @@ export declare function isFieldVisible(field: FilterField, values: FilterValues)
  * Get all visible fields from schema
  */
 export declare function getVisibleFields(schema: FilterSchema, values: FilterValues): FilterField[];
-/**
- * Map a FilterField to FieldConfig for use with generic Field component
- */
-export declare function mapFilterFieldToFieldConfig(field: FilterField, value: any, onChange: (value: any) => void, error?: string, disabled?: boolean): FieldConfig | null;
+export { mapFilterFieldToFieldConfig } from './filter-field-config.utils.js';

package/dist/lib/components/ui/collections/filter/filter-validation-presets.utils.d.ts

@@ -0,0 +1,24 @@
+import { FilterValidationRule } from './types.js';
+/**
+ * Common validation patterns
+ */
+export declare const VALIDATION_PATTERNS: {
+    readonly EMAIL: RegExp;
+    readonly URL: RegExp;
+    readonly PHONE: RegExp;
+    readonly ZIP_CODE: RegExp;
+    readonly ALPHANUMERIC: RegExp;
+    readonly NUMERIC: RegExp;
+};
+/**
+ * Common validation rule presets
+ */
+export declare const VALIDATION_PRESETS: {
+    readonly required: () => FilterValidationRule;
+    readonly email: () => FilterValidationRule;
+    readonly url: () => FilterValidationRule;
+    readonly phone: () => FilterValidationRule;
+    readonly positiveNumber: () => FilterValidationRule;
+    readonly percentage: () => FilterValidationRule;
+    readonly range: (min: number, max: number) => FilterValidationRule;
+};

package/dist/lib/components/ui/collections/filter/filter-validation-rules.utils.d.ts

@@ -0,0 +1,11 @@
+import { FilterField, FilterValidationRule, FilterValue } from './types.js';
+type FilterRules = FilterValidationRule;
+/** A text field: minimum and maximum length, pattern. */
+export declare function validateTextValue(field: FilterField, value: FilterValue, rules: FilterRules): string | null;
+/** A number field: minimum and maximum. */
+export declare function validateNumberValue(field: FilterField, value: FilterValue, rules: FilterRules): string | null;
+/** A number range: required ends, min less than max, and the field limits. */
+export declare function validateNumberRangeValue(field: FilterField, value: FilterValue, rules: FilterRules): string | null;
+/** A multi-select or checkbox group: minimum and maximum count. */
+export declare function validateArrayValue(value: FilterValue, rules: FilterRules): string | null;
+export {};

package/dist/lib/components/ui/collections/filter/filter-validation.utils.d.ts

@@ -23,26 +23,4 @@ export declare function getValidationError(errors: FilterValidationErrors, field
  * Create a validation rule helper
  */
 export declare function createValidationRule(rule: Partial<FilterValidationRule>): FilterValidationRule;
-/**
- * Common validation patterns
- */
-export declare const VALIDATION_PATTERNS: {
-    readonly EMAIL: RegExp;
-    readonly URL: RegExp;
-    readonly PHONE: RegExp;
-    readonly ZIP_CODE: RegExp;
-    readonly ALPHANUMERIC: RegExp;
-    readonly NUMERIC: RegExp;
-};
-/**
- * Common validation rule presets
- */
-export declare const VALIDATION_PRESETS: {
-    readonly required: () => FilterValidationRule;
-    readonly email: () => FilterValidationRule;
-    readonly url: () => FilterValidationRule;
-    readonly phone: () => FilterValidationRule;
-    readonly positiveNumber: () => FilterValidationRule;
-    readonly percentage: () => FilterValidationRule;
-    readonly range: (min: number, max: number) => FilterValidationRule;
-};
+export { VALIDATION_PATTERNS, VALIDATION_PRESETS, } from './filter-validation-presets.utils.js';

package/dist/lib/components/ui/collections/filter/partials/filter-field-special.d.ts

@@ -0,0 +1,8 @@
+import { FilterFieldProps } from '../filter-field.js';
+import { useFilterFieldConfig } from '../use-filter-field-config.js';
+type FilterFieldSpecialProps = Pick<FilterFieldProps, 'field' | 'value' | 'onChange' | 'onBlur' | 'error' | 'disabled' | 'className'> & {
+    commonProps: ReturnType<typeof useFilterFieldConfig>['commonProps'];
+};
+/** The types the generic `Field` does not render: a range slider, a number range. */
+export declare function FilterFieldSpecial({ field, value, onChange, onBlur, error, disabled, className, commonProps, }: FilterFieldSpecialProps): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/collections/filter/partials/filter-form-field-variant.d.ts

@@ -0,0 +1,10 @@
+import { ComponentProps } from 'react';
+import { FilterFormFieldProps } from '../filter-form-field.js';
+import { FilterInline } from '../filter-inline.js';
+type FilterFormFieldVariantProps = Pick<FilterFormFieldProps<Record<string, any>>, 'variant' | 'showActions' | 'contentClassName' | 'actionsClassName' | 'trigger' | 'title' | 'description' | 'triggerLabel' | 'showTriggerCount' | 'side'> & {
+    /** The props every variant takes, from the form controller. */
+    common: Pick<ComponentProps<typeof FilterInline>, 'schema' | 'values' | 'onChange' | 'onApply' | 'liveUpdate' | 'disabled' | 'className'>;
+};
+/** The variant of the filter (inline, dialog, sheet, drawer, popover) the form field renders. */
+export declare function FilterFormFieldVariant({ variant, common: commonProps, showActions, contentClassName, actionsClassName, trigger, title, description, triggerLabel, showTriggerCount, side, }: FilterFormFieldVariantProps): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/collections/filter/partials/filter-group-fields.d.ts

@@ -0,0 +1,5 @@
+import { FilterField as FilterFieldType } from '../types.js';
+/** The responsive grid of a group's visible fields, wired to the filter context. */
+export declare function FilterGroupFields({ fields }: {
+    fields: FilterFieldType[];
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/filter/partials/filter-legacy-variant.d.ts

@@ -0,0 +1,3 @@
+import { FilterProps } from '../filter-legacy.js';
+/** The variant (dialog, sheet, drawer, popover or inline) `FilterLegacy` renders. */
+export declare function FilterLegacyVariant(props: FilterProps): import("react").JSX.Element;

package/dist/lib/components/ui/collections/filter/partials/filter-preset-fields.d.ts

@@ -0,0 +1,9 @@
+/** The two fields of the save dialog: the preset's name (with its usage count) and description. */
+export declare function FilterPresetFields({ name, description, onName, onDescription, count, max, }: {
+    name: string;
+    description: string;
+    onName: (value: string) => void;
+    onDescription: (value: string) => void;
+    count: number;
+    max: number;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/filter/partials/filter-presets-menu-items.d.ts

@@ -0,0 +1,13 @@
+import { FilterPreset, FilterPresetsProps } from '../types.js';
+/** A preset row of the menu: its icon, name, description, default star and current check. */
+export declare function FilterPresetLoadItem({ preset, current, onLoad, }: {
+    preset: FilterPreset;
+    current: boolean;
+    onLoad: FilterPresetsProps['onLoad'];
+}): import("react").JSX.Element;
+/** A row of the menu's Manage section: set or unset the default, or delete. */
+export declare function FilterPresetManageItem({ preset, onDelete, onSetDefault, }: {
+    preset: FilterPreset;
+    onDelete: FilterPresetsProps['onDelete'];
+    onSetDefault: FilterPresetsProps['onSetDefault'];
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/filter/partials/filter-presets-menu.d.ts

@@ -0,0 +1,5 @@
+import { FilterPresetsProps } from '../types.js';
+type FilterPresetsMenuProps = Pick<FilterPresetsProps, 'presets' | 'currentPresetId' | 'onLoad' | 'onDelete' | 'onSetDefault' | 'disabled'>;
+/** The dropdown that loads a saved preset and manages them (default, delete). */
+export declare function FilterPresetsMenu({ presets, currentPresetId, onLoad, onDelete, onSetDefault, disabled, }: FilterPresetsMenuProps): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/collections/filter/partials/filter-presets-save-dialog.d.ts

@@ -0,0 +1,7 @@
+import { FilterPresetsProps } from '../types.js';
+type FilterPresetsSaveDialogProps = Pick<FilterPresetsProps, 'onSave' | 'maxPresets' | 'disabled' | 'cancelVariant'> & {
+    count: number;
+};
+/** The "+" button and its dialog that names and saves the current filters as a preset. */
+export declare function FilterPresetsSaveDialog({ onSave, count, maxPresets, disabled, cancelVariant, }: FilterPresetsSaveDialogProps): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/collections/filter/partials/filter-presets-save-trigger.d.ts

@@ -0,0 +1,7 @@
+import { ComponentProps } from 'react';
+import { IconButton } from '../../../actions/icon-button/icon-button.js';
+/** The "+" button that opens the save dialog, titled with the preset limit when it is reached. */
+export declare function FilterPresetsSaveTrigger({ canSave, max, ...props }: ComponentProps<typeof IconButton> & {
+    canSave: boolean;
+    max: number;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/filter/query/types.d.ts

@@ -1,45 +1,9 @@
-import { FilterApply, FilterCountsOption, FilterDefaults, FilterFieldErrors, FilterLockedCondition, FilterModel, FilterPreviewCount, FilterQuery, FilterSearchApplyMode, FilterShortcutsOption } from '@nxgt/material-core/filter';
+import { FilterApply, FilterCountsOption, FilterDefaults, FilterFieldErrors, FilterLockedCondition, FilterModel, FilterPreviewCount, FilterQuery, FilterShortcutsOption } from '@nxgt/material-core/filter';
 import { ReactNode } from 'react';
 import { ButtonVariant } from '../../../actions/button/button.js';
 import { FilterBarFieldProps } from '../editors/custom-types.js';
-/** The bar's spacing: `compact` draws small chips; every target stays 24px or more. */
-export type FilterDensity = 'comfortable' | 'compact';
-/** The props `FilterBarView` and `FilterFacets` share. */
-export type FilterViewProps = {
-    label?: string;
-    searchLabel?: string;
-    searchPlaceholder?: string;
-    className?: string;
-    /**
-     * The page lays out the active filters and "Clear all" itself, outside
-     * the bar (`ServerTable`'s row under its band): it holds the `search`
-     * landmark around both, and `rootRef` on an element around them, so the
-     * focus finds the chips.
-     */
-    detachedChips?: boolean;
-    /**
-     * `false`: no "Filters (N)" of the bar's own; the page places a
-     * `FilterSheetTrigger` elsewhere. The bar still mounts the sheet, and `F`
-     * still opens it.
-     */
-    sheetTrigger?: boolean;
-    /** `'compact'`: 6px back under the bar; see `FilterQueryProps`. */
-    bandDensity?: 'comfortable' | 'compact';
-    /**
-     * The variant of the secondary button in the sheet's and the staged
-     * panel's footer ("Clear all", "Reset"). Default `'tonal'`; `'outlined'`
-     * restores the earlier look.
-     */
-    cancelVariant?: ButtonVariant;
-};
-/**
- * When the search text reaches the query: `'live'` (the default) as it is
- * typed, applied after `liveDelayMs`; `'enter'` only when Enter is pressed,
- * then at once. In `'enter'`, clearing the field applies at once too.
- */
-export type FilterSearchApply = FilterSearchApplyMode;
-/** The query-driven variants of `Filter`: the bar, and the facets panel. */
-export type FilterQueryVariant = 'bar' | 'facets';
+import { FilterDensity, FilterQueryVariant, FilterSearchApply } from './view-types.js';
+export type { FilterDensity, FilterQueryVariant, FilterSearchApply, FilterViewProps, } from './view-types.js';
 /**
  * `Filter variant="bar"` and `variant="facets"`: a thin shell over
  * `@nxgt/material-core/filter`. Both become the phone sheet below 768px.

package/dist/lib/components/ui/collections/filter/query/use-filter-query-options.d.ts

@@ -8,7 +8,7 @@ export declare function viewOptions({ defaults, errors, searchError, formError,
     errorSummary: boolean;
     loading: boolean;
     resultCount: number | undefined;
-    density: import('./types.js').FilterDensity;
+    density: import('./view-types.js').FilterDensity;
     apply: import('@nxgt/material-core/filter').FilterApply;
     searchApply: import('@nxgt/material-core/filter').FilterSearchApplyMode;
     searchMinLength: number;

package/dist/lib/components/ui/collections/filter/query/use-filter-query-value.d.ts

@@ -27,9 +27,9 @@ export declare function useFilterQueryValue(props: FilterQueryProps): {
     addedCount: number;
     loading: boolean;
     resultCount?: number;
-    density: import('./types.js').FilterDensity;
+    density: import('./view-types.js').FilterDensity;
     apply: import('@nxgt/material-core/filter').FilterApply;
-    searchApply: import('./types.js').FilterSearchApply;
+    searchApply: import('./view-types.js').FilterSearchApply;
     searchMinLength: number;
     previewCount?: import('@nxgt/material-core/filter').FilterPreviewCount;
     counts?: import('@nxgt/material-core/filter').FilterCountsOption;

package/dist/lib/components/ui/collections/filter/query/view-types.d.ts

@@ -0,0 +1,40 @@
+import { FilterSearchApplyMode } from '@nxgt/material-core/filter';
+import { ButtonVariant } from '../../../actions/button/button.js';
+/** The bar's spacing: `compact` draws small chips; every target stays 24px or more. */
+export type FilterDensity = 'comfortable' | 'compact';
+/** The props `FilterBarView` and `FilterFacets` share. */
+export type FilterViewProps = {
+    label?: string;
+    searchLabel?: string;
+    searchPlaceholder?: string;
+    className?: string;
+    /**
+     * The page lays out the active filters and "Clear all" itself, outside
+     * the bar (`ServerTable`'s row under its band): it holds the `search`
+     * landmark around both, and `rootRef` on an element around them, so the
+     * focus finds the chips.
+     */
+    detachedChips?: boolean;
+    /**
+     * `false`: no "Filters (N)" of the bar's own; the page places a
+     * `FilterSheetTrigger` elsewhere. The bar still mounts the sheet, and `F`
+     * still opens it.
+     */
+    sheetTrigger?: boolean;
+    /** `'compact'`: 6px back under the bar; see `FilterQueryProps`. */
+    bandDensity?: 'comfortable' | 'compact';
+    /**
+     * The variant of the secondary button in the sheet's and the staged
+     * panel's footer ("Clear all", "Reset"). Default `'tonal'`; `'outlined'`
+     * restores the earlier look.
+     */
+    cancelVariant?: ButtonVariant;
+};
+/**
+ * When the search text reaches the query: `'live'` (the default) as it is
+ * typed, applied after `liveDelayMs`; `'enter'` only when Enter is pressed,
+ * then at once. In `'enter'`, clearing the field applies at once too.
+ */
+export type FilterSearchApply = FilterSearchApplyMode;
+/** The query-driven variants of `Filter`: the bar, and the facets panel. */
+export type FilterQueryVariant = 'bar' | 'facets';

package/dist/lib/components/ui/collections/filter/sections/use-filter-search.d.ts

@@ -0,0 +1,14 @@
+import { KeyboardEvent } from 'react';
+/**
+ * The bar search's text and its handlers: the draft the field shows (a query
+ * that changes elsewhere replaces it), what is sent while typing, and what
+ * Enter or clearing applies at once in `searchApply="enter"`.
+ */
+export declare function useFilterSearch(): {
+    draft: string;
+    short: boolean;
+    enter: boolean;
+    onValueChange: (next: string) => void;
+    onClear: () => void;
+    onKeyDown: (event: KeyboardEvent<HTMLInputElement>) => void;
+};