@nxgt/material 2.12.0 → 2.14.0

package/dist/{flowDiagram-KWPJA3E3-BOEc9KSn.js → flowDiagram-KWPJA3E3-BQEK3XTl.js}

@@ -6,12 +6,12 @@ import "./chunk-MBY4JIJT-BFIqOe-8.js";
 import "./chunk-7PRAP22T-0C6_H8Li.js";
 import "./chunk-7INBJB4K-k-I67NSP.js";
 import "./chunk-5DYCD2WN-Cd1zazNp.js";
-import "./chunk-Z7XXMR3K-vmLFt9Cr.js";
+import "./chunk-Z7XXMR3K-BzO1efzA.js";
 import "./chunk-GWA4HPMP-B8jXI0Tl.js";
 import "./chunk-XXDRQBXY-dKXxu_aj.js";
 import "./chunk-WEXAMYUT-CbFOhEve.js";
 import "./chunk-UA2S7LBM-ChuksCDg.js";
-import "./chunk-GNY47TPC-DCFqYc_z.js";
+import "./chunk-GNY47TPC-CGgBmY0O.js";
 import "./chunk-LNGE3PJU-DJjGTS7O.js";
-import { n as e } from "./chunk-7M6MHVWA-NPaJJ6Gy.js";
+import { n as e } from "./chunk-7M6MHVWA-Uf-8NCRF.js";
 export { e as diagram };

package/dist/{ganttDiagram-FUAMR5RP-DdxLcLNx.js → ganttDiagram-FUAMR5RP-WYm8XV7U.js}

@@ -1,5 +1,5 @@
 import { a as e, t } from "./rolldown-runtime-BFFgcFxR.js";
-import { $ as n, G as r, H as i, J as a, K as o, Q as s, U as c, W as l, X as u, Y as d, Z as f, et as p, lt as m, nt as h, q as g, rt as _, tt as v, ut as y } from "./components-BYxsGbyO.js";
+import { $ as n, G as r, H as i, J as a, K as o, Q as s, U as c, W as l, X as u, Y as d, Z as f, et as p, lt as m, nt as h, q as g, rt as _, tt as v, ut as y } from "./components-qTUjhFuo.js";
 import { a as b, c as x, g as S, h as C, l as w, m as T, o as E } from "./string-BqyOfyFV.js";
 import { i as D, n as O, t as k } from "./src-CsLQInsN.js";
 import { g as A } from "./chunk-ZIGJFQKS-9VXArDKF.js";

package/dist/{graphlib-DLjE3QPd.js → graphlib-CbcZi5bx.js}

@@ -1,9 +1,9 @@
-import { _ as e, a as t, f as n, g as r, i, o as a, v as o, y as s } from "./translator-BfqVlNGW.js";
-import { a as c, o as l } from "./_overRest-DMn4Dt71.js";
-import { A as u, C as d, O as f, b as p, v as m, x as ee, y as h } from "./async-slice-DhZDjEtw.js";
-import { d as te, n as ne } from "./_Uint8Array-azThpjEP.js";
-import { n as re, r as ie, t as g } from "./isArrayLikeObject-CO-5KAzG.js";
-import { i as _, n as ae, t as v } from "./isEmpty-Bl1drJE7.js";
+import { _ as e, a as t, f as n, g as r, i, o as a, v as o, y as s } from "./translator-BMFC0lBV.js";
+import { a as c, o as l } from "./_overRest-C21ZmKyH.js";
+import { A as u, C as d, O as f, b as p, v as m, x as ee, y as h } from "./async-slice-TBZ6Taw2.js";
+import { d as te, n as ne } from "./_Uint8Array-QCcRMhXd.js";
+import { n as re, r as ie, t as g } from "./isArrayLikeObject-COiPdhFP.js";
+import { i as _, n as ae, t as v } from "./isEmpty-B7UlCLih.js";
 //#region ../../node_modules/lodash-es/noop.js
 function oe() {}
 //#endregion

package/dist/hooks.js

@@ -1,11 +1,11 @@
-import { r as e } from "./i18n-provider-CQL7fqLy.js";
-import { i as t, n, o as r, r as i, s as a, t as o } from "./use-heading-spy-DvZVu15k.js";
-import { L as s, t as c } from "./number.utils-BiBN2hWJ.js";
-import { useCallback as l, useMemo as u } from "react";
-import { useNavigate as d, useSearchParams as f } from "react-router";
-import { createFormatters as p } from "@nxgt/material-core/print-format";
+import { r as e } from "./i18n-provider-D5hkauu6.js";
+import { l as t, n, o as r, r as i, s as a, t as o, u as s } from "./use-heading-spy-wlOv87q3.js";
+import { L as c, t as l } from "./number.utils-BiBN2hWJ.js";
+import { useCallback as u, useMemo as d } from "react";
+import { useNavigate as f, useSearchParams as p } from "react-router";
+import { createFormatters as m } from "@nxgt/material-core/print-format";
 //#region lib/hooks/use-allowed-transitions.ts
-function m(e, t, n) {
+function h(e, t, n) {
 	return (t[e] || []).map((e) => {
 		let t = n[e];
 		return t ? {
@@ -16,18 +16,18 @@ function m(e, t, n) {
 }
 //#endregion
 //#region lib/hooks/use-formatters.ts
-function h(t = {}) {
+function g(t = {}) {
 	let n = e(), r = t.locale ?? n?.language ?? "en", { timeZone: i } = t;
-	return u(() => p({
+	return d(() => m({
 		locale: r,
 		timeZone: i
 	}), [r, i]);
 }
 //#endregion
 //#region lib/hooks/use-navigation.ts
-function g(e, t) {
-	let n = d();
-	return l(() => {
+function _(e, t) {
+	let n = f();
+	return u(() => {
 		n(e, t);
 	}, [
 		n,
@@ -35,21 +35,21 @@ function g(e, t) {
 		t
 	]);
 }
-function _(e) {
-	let t = d();
-	return u(() => e.map(({ to: e, options: n }) => () => {
+function v(e) {
+	let t = f();
+	return d(() => e.map(({ to: e, options: n }) => () => {
 		t(e, n);
 	}), [t, e]);
 }
 //#endregion
 //#region lib/hooks/use-number-formatter.ts
-function v() {
-	let t = e(), n = l((e, n) => c(e, {
+function y() {
+	let t = e(), n = u((e, n) => l(e, {
 		...n,
 		language: t?.language
 	}), [t?.language]);
 	return {
-		formatCurrency: l((e, t) => n(e, {
+		formatCurrency: u((e, t) => n(e, {
 			...t,
 			currency: t?.currency,
 			style: t?.currency ? "currency" : void 0
@@ -59,7 +59,7 @@ function v() {
 }
 //#endregion
 //#region lib/hooks/use-options.ts
-function y(e, { filter: t, value: n, label: r, expanded: i }) {
+function b(e, { filter: t, value: n, label: r, expanded: i }) {
 	return e.filter((e) => e && (t?.(e) ?? !0)).map((e) => {
 		let t = typeof n == "function" ? n(e) : e[n]?.toString() ?? "", a = "";
 		return a = typeof r == "function" ? r(e) : Array.isArray(r) ? r.map((t) => e[t]).filter(Boolean).join(" ") : e[r]?.toString() ?? "", {
@@ -69,9 +69,9 @@ function y(e, { filter: t, value: n, label: r, expanded: i }) {
 		};
 	});
 }
-function b(e, t) {
+function x(e, t) {
 	let { filter: n, value: r, label: i, expanded: a } = t;
-	return u(() => y(e, {
+	return d(() => b(e, {
 		filter: n,
 		value: r,
 		label: i,
@@ -84,14 +84,14 @@ function b(e, t) {
 		a
 	]);
 }
-function x(e) {
+function S(e) {
 	return e?.edges?.map((e) => e.node) ?? [];
 }
 //#endregion
 //#region lib/hooks/use-search-param.ts
-function S(e) {
-	let [t, n] = f();
-	return u(() => t.get(e), [t, e]);
+function C(e) {
+	let [t, n] = p();
+	return d(() => t.get(e), [t, e]);
 }
 //#endregion
-export { r as applyResolvedTheme, y as buildOptions, x as extractNode, a as resolveTheme, m as useAllowedTransitions, h as useFormatters, o as useHeadingSpy, s as useIsClient, i as useIsMobile, n as useLocalizedDate, g as useNavigationHandler, _ as useNavigationHandlers, v as useNumberFormatter, b as useOptions, S as useSearchParam, t as useTheme };
+export { t as applyResolvedTheme, b as buildOptions, S as extractNode, s as resolveTheme, h as useAllowedTransitions, r as useCspNonce, g as useFormatters, o as useHeadingSpy, c as useIsClient, i as useIsMobile, n as useLocalizedDate, _ as useNavigationHandler, v as useNavigationHandlers, y as useNumberFormatter, x as useOptions, C as useSearchParam, a as useTheme };

package/dist/{i18n-provider-CQL7fqLy.js → i18n-provider-D5hkauu6.js}

@@ -1,4 +1,4 @@
-import { a as e, i as t, t as n } from "./stored-language-BW32owje.js";
+import { a as e, i as t, t as n } from "./stored-language-g121Yv0w.js";
 import { jsx as r } from "react/jsx-runtime";
 import { createContext as i, useCallback as a, useContext as o, useMemo as s, useState as c } from "react";
 //#region lib/i18n/i18n-provider.tsx

package/dist/i18n.js

@@ -1,9 +1,9 @@
-import { a as e, i as t, o as n, r } from "./stored-language-BW32owje.js";
-import { n as i, r as a, t as o } from "./i18n-provider-CQL7fqLy.js";
-import { n as s, r as c, t as l } from "./translator-BfqVlNGW.js";
-import { o as u, t as d } from "./merge-CwwtONfp.js";
-import { t as f } from "./translate-material-ZEzF-LKH.js";
-import { t as p } from "./use-material-translation-B2GUtxUY.js";
+import { a as e, i as t, o as n, r } from "./stored-language-g121Yv0w.js";
+import { n as i, r as a, t as o } from "./i18n-provider-D5hkauu6.js";
+import { n as s, r as c, t as l } from "./translator-BMFC0lBV.js";
+import { o as u, t as d } from "./merge-KEf_u3Zy.js";
+import { t as f } from "./translate-material-D3Hp_AI5.js";
+import { t as p } from "./use-material-translation-BGFp1yXp.js";
 import { useCallback as m } from "react";
 //#region lib/i18n/merge-resources.ts
 function h(e, t, n = "") {

package/dist/{isArrayLikeObject-CO-5KAzG.js → isArrayLikeObject-COiPdhFP.js}

@@ -1,6 +1,6 @@
-import { x as e } from "./translator-BfqVlNGW.js";
-import { i as t, o as n, t as r } from "./_overRest-DMn4Dt71.js";
-import { d as i } from "./_Uint8Array-azThpjEP.js";
+import { x as e } from "./translator-BMFC0lBV.js";
+import { i as t, o as n, t as r } from "./_overRest-C21ZmKyH.js";
+import { d as i } from "./_Uint8Array-QCcRMhXd.js";
 //#region ../../node_modules/lodash-es/_baseRest.js
 function a(e, i) {
 	return t(r(e, i, n), e + "");

package/dist/{isEmpty-Bl1drJE7.js → isEmpty-B7UlCLih.js}

@@ -1,6 +1,6 @@
-import { C as e, o as t, s as n, v as r } from "./translator-BfqVlNGW.js";
-import { S as i, j as a, k as o } from "./async-slice-DhZDjEtw.js";
-import { a as s, c, d as l, f as u, l as d, p as f, u as p } from "./_Uint8Array-azThpjEP.js";
+import { C as e, o as t, s as n, v as r } from "./translator-BMFC0lBV.js";
+import { S as i, j as a, k as o } from "./async-slice-TBZ6Taw2.js";
+import { a as s, c, d as l, f as u, l as d, p as f, u as p } from "./_Uint8Array-QCcRMhXd.js";
 //#region ../../node_modules/lodash-es/_isFlattenable.js
 var m = e ? e.isConcatSpreadable : void 0;
 function h(e) {

package/dist/{journeyDiagram-ZHPQQLJL-BIzB9BVn.js → journeyDiagram-ZHPQQLJL-p90NnenY.js}

@@ -1,4 +1,4 @@
-import { ct as e } from "./components-BYxsGbyO.js";
+import { ct as e } from "./components-qTUjhFuo.js";
 import { t } from "./src-CsLQInsN.js";
 import { n } from "./chunk-Y2CYZVJY-BAad7w_K.js";
 import { H as r, U as i, a, c as o, q as s, v as c, w as l, x as u, y as d } from "./chunk-O7XYJQB3-BChweQ_V.js";

package/dist/lib/components/ui/fields/attributes/attribute-form/consts.d.ts

@@ -2,7 +2,11 @@ import { default as z } from 'zod';
 import { MaterialLocaleKey } from '../../../../../i18n/types';
 import { TFormValues } from './types';
 export declare const ATTRIBUTE_TYPES: readonly ["COLOR", "DATE", "DATETIME", "MULTI_SELECT", "NUMBER", "RICH_TEXT", "SELECT", "STRING", "TEXT", "TIME"];
-export declare const schema: z.ZodObject<{
+/**
+ * The attribute form's schema, built on the first call (inside `AttributeForm`'s
+ * render), never when the module loads: see `openingHoursSchema`.
+ */
+export declare const attributeFormSchema: () => z.ZodObject<{
     defaultValue: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     priority: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;

package/dist/lib/components/ui/fields/attributes/attribute-form/types.d.ts

@@ -1,3 +1,3 @@
 import { z } from 'zod';
-import { schema } from './consts';
-export type TFormValues = z.infer<typeof schema>;
+import { attributeFormSchema } from './consts';
+export type TFormValues = z.infer<ReturnType<typeof attributeFormSchema>>;

package/dist/lib/components/ui/fields/opening-hours/consts.d.ts

@@ -1,11 +1,22 @@
 import { default as z } from 'zod';
 import { MaterialLocaleKey } from '../../../../i18n/types';
-export declare const OpeningHoursSchema: z.ZodObject<{
+/**
+ * The schema of one opening hour: `dayOfWeek` `0`-`6` (coerced from a
+ * string), `openTime` and `closeTime` as `HH:mm`, `isClosed`. Built on the
+ * first call, then the same schema: nothing is built when the module loads,
+ * so an app under a strict CSP can call `z.config({ jitless: true })` first.
+ */
+export declare const openingHoursSchema: () => z.ZodObject<{
     openTime: z.ZodOptional<z.ZodString>;
     closeTime: z.ZodOptional<z.ZodString>;
     isClosed: z.ZodOptional<z.ZodBoolean>;
     dayOfWeek: z.ZodCoercedNumber<unknown>;
 }, z.core.$strip>;
+/**
+ * @deprecated Use `openingHoursSchema()`; removed in 3.0. Built on its first
+ * use, and behaves as the schema the factory returns (not the same object).
+ */
+export declare const OpeningHoursSchema: ReturnType<typeof openingHoursSchema>;
 /** English fallback for every `material.opening-hours.days.*` key. */
 export declare const DAY_OF_WEEK_FALLBACKS: readonly ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
 /**

package/dist/lib/components/ui/fields/search-field/index.d.ts

@@ -1,5 +1,5 @@
-export type { Debounced } from './debounce';
-export { debounce } from './debounce';
+export type { Debounced } from '@nxgt/material-core/debounce';
+export { debounce } from '@nxgt/material-core/debounce';
 export type { SearchFieldProps } from './search-field';
 export { SearchField } from './search-field';
 export * from './search-form-field';

package/dist/lib/components/ui/media/image-cropper/image-crop-aspects.d.ts

@@ -0,0 +1,6 @@
+import { ImageCropAspectId } from './types';
+/** The aspect picker of `ImageCropper`: free, then the fixed ratios. */
+export declare function ImageCropAspects({ value, onChange, }: {
+    value: ImageCropAspectId;
+    onChange: (value: ImageCropAspectId) => void;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/media/image-cropper/use-frame-size.d.ts

@@ -0,0 +1,4 @@
+import { RefObject } from 'react';
+import { CropSize } from './crop-resize-handles';
+/** The frame's client size, kept current by a `ResizeObserver`. */
+export declare function useFrameSize(frameRef: RefObject<HTMLDivElement | null>): CropSize | null;

package/dist/lib/components/ui/primitives/index.d.ts

@@ -10,6 +10,7 @@ export * from './input';
 export * from './input-group';
 export * from './kbd';
 export * from './label';
+export * from './nonce-provider';
 export * from './scroll-area';
 export * from './separator';
 export * from './table';

package/dist/lib/components/ui/primitives/nonce-provider/index.d.ts

@@ -0,0 +1 @@
+export * from './nonce-provider';

package/dist/lib/components/ui/primitives/nonce-provider/nonce-provider.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+export type NonceProviderProps = {
+    /**
+     * This request's Content Security Policy nonce: the one in the
+     * `style-src-elem 'nonce-…'` directive, and the one given to
+     * `renderToPipeableStream({ nonce })`. Empty or `undefined`, the nearest
+     * outer `NonceProvider`'s nonce carries on.
+     */
+    nonce: string | undefined;
+    children?: ReactNode;
+};
+/**
+ * Gives the page's CSP nonce to every component below: the `<style>`
+ * elements of `ScrollArea` and `Select`, and the styles `RichTextEditor`
+ * injects (`useCspNonce`). On the client it also
+ * keeps it for the code that runs outside React (`setCspNonce`), which the
+ * modals' scroll lock reads. Render it once, at the root, on the server and
+ * on the client, with the same nonce.
+ */
+export declare function NonceProvider({ nonce, children }: NonceProviderProps): import("react").JSX.Element;

package/dist/lib/components/ui/selection/autocomplete/autocomplete.d.ts

@@ -1,37 +1,5 @@
-import { ReactNode } from 'react';
-import { InputGroupFieldProps } from '../../fields/input-group-field/input-group-field';
 import { AutocompleteChips } from './partials/autocomplete-chips';
-export type AutocompleteOption = {
-    value: string;
-    label: string;
-};
-export type AutocompleteProps<T extends AutocompleteOption = AutocompleteOption> = Omit<InputGroupFieldProps, 'renderInput'> & {
-    label?: ReactNode;
-    placeholder?: ReactNode;
-    helperText?: ReactNode;
-    error?: boolean;
-    leading?: ReactNode;
-    trailing?: ReactNode;
-    options: T[];
-    getOptionValue?: (option: T) => string;
-    getOptionLabel?: (option: T) => string;
-    empty?: ReactNode;
-    freeSolo?: boolean;
-    freeSoloLabel?: (query: string) => string;
-    name?: string;
-    disabled?: boolean;
-    renderOption?: (option: T) => ReactNode;
-    renderSelectedLeading?: (option: T) => ReactNode;
-    actions?: ReactNode | ((query: string) => ReactNode);
-    onQueryChange?: (query: string) => void;
-} & ({
-    mode: 'single';
-    value: string;
-    onValueChange?: (value?: string | null) => void;
-} | {
-    mode: 'multiple';
-    value: string[];
-    onValueChange?: (value?: string[] | null) => void;
-});
+import { AutocompleteOption, AutocompleteProps } from './types';
+export type { AutocompleteFilter, AutocompleteOption, AutocompleteProps, AutocompleteSearch, AutocompleteSearchContext, AutocompleteSearchProps, } from './types';
 export declare function Autocomplete<T extends AutocompleteOption = AutocompleteOption>({ getOptionValue, getOptionLabel, ...props }: AutocompleteProps<T>): import("react").JSX.Element;
 export { AutocompleteChips };

package/dist/lib/components/ui/selection/autocomplete/partials/autocomplete-announcer.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+/**
+ * The field's polite live region: always in the page (a region that mounts
+ * with its text is not read), visually hidden, and holding a sentence only
+ * once the list has something to say — "Loading…", "3 results", "No
+ * results" or the failure.
+ */
+export declare function AutocompleteAnnouncer({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/selection/autocomplete/partials/autocomplete-chips.d.ts

@@ -1,8 +1,13 @@
-import { RefObject } from 'react';
-import { AutocompleteOption, AutocompleteProps } from '../autocomplete';
-/** The label, the chips of the selected options, the input and the helper text. */
+import { ReactNode, RefObject } from 'react';
+import { AutocompleteOption, AutocompleteProps } from '../types';
+/**
+ * The label, the chips of the selected options, the input, the helper text
+ * and the field's live region.
+ */
 export declare function AutocompleteChips<T extends AutocompleteOption>({ slot, values, getOptionValue, getOptionLabel, ...props }: AutocompleteProps<T> & {
     onRemove: (value: string) => void;
     anchor: RefObject<HTMLDivElement | null>;
     values: string[];
+    /** What the field's polite live region says about the list. */
+    announcement?: ReactNode;
 }): import("react").JSX.Element;

package/dist/lib/components/ui/selection/autocomplete/partials/autocomplete-list-status.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+type ListStatusProps = {
+    loading: boolean;
+    failure: ReactNode;
+    hint: ReactNode;
+};
+/**
+ * The row above the options that says the list is loading, why the search
+ * failed, or how much to type. Seen, not announced: the field's polite
+ * status (`AutocompleteAnnouncer`) says it once.
+ */
+export declare function AutocompleteListStatus({ loading, failure, hint, }: ListStatusProps): import("react").JSX.Element | null;
+export {};

package/dist/lib/components/ui/selection/autocomplete/partials/autocomplete-popup.d.ts

@@ -0,0 +1,26 @@
+import { ReactNode, RefObject } from 'react';
+import { AutocompleteOption, AutocompleteProps } from '../types';
+type PopupProps<T extends AutocompleteOption> = Pick<AutocompleteProps<T>, 'actions' | 'freeSoloLabel' | 'renderOption' | 'name' | 'value'> & {
+    anchor: RefObject<HTMLDivElement | null>;
+    container: HTMLElement | null;
+    query: string;
+    /** The free-solo button, when the query can be added. */
+    showAddButton: boolean;
+    onAdd: () => void;
+    /** The empty text, when nothing matches and nothing can be added. */
+    emptyText: ReactNode;
+    /** A search is running: the list is `aria-busy` and says so. */
+    loading: boolean;
+    /** Why the search failed, shown in place of the options. */
+    failure: ReactNode;
+    /** The minimum query length `onSearch` waits for, as a sentence. */
+    hint: ReactNode;
+    getOptionValue: (option: T) => string;
+    getOptionLabel: (option: T) => string;
+};
+/**
+ * The list: the actions row, its status (loading, failure, minimum length),
+ * the empty state (or the free-solo button), the options.
+ */
+export declare function AutocompletePopup<T extends AutocompleteOption>(props: PopupProps<T>): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/selection/autocomplete/types.d.ts

@@ -0,0 +1,72 @@
+import { ReactNode } from 'react';
+import { InputGroupFieldProps } from '../../fields/input-group-field/input-group-field';
+export type AutocompleteOption = {
+    value: string;
+    label: string;
+};
+/**
+ * How the list is filtered as the user types: `'accent-insensitive'` (the
+ * default without `onSearch`) keeps the options whose label or value holds
+ * the query, ignoring case and accents; `'none'` shows the options as given
+ * (the default with `onSearch`, or when you filter on a server); a function
+ * decides per option, given the trimmed query (never called for an empty one).
+ */
+export type AutocompleteFilter<T> = 'accent-insensitive' | 'none' | ((option: T, query: string) => boolean);
+/** What `onSearch` is handed besides the query: aborted once it is stale. */
+export type AutocompleteSearchContext = {
+    signal: AbortSignal;
+};
+/** A server search: the options for `query`. Pass `signal` on to `fetch`. */
+export type AutocompleteSearch<T> = (query: string, context: AutocompleteSearchContext) => Promise<T[]>;
+/** The async and filtering props; see the Autocomplete page of the docs. */
+export type AutocompleteSearchProps<T> = {
+    /**
+     * Server search: called once typing pauses (`debounceMs`) with the query
+     * and an `AbortSignal`; its results become the list. A response that
+     * lands after a newer query's is dropped. `options` then only needs the
+     * selected option(s), for their chips.
+     */
+    onSearch?: AutocompleteSearch<T>;
+    /** Called when `onSearch` rejects (an abort is not a rejection). */
+    onSearchError?: (error: unknown) => void;
+    /** Controlled loading, when you fetch `options` yourself from `onQueryChange`. */
+    loading?: boolean;
+    /** Controlled failure text, shown and announced in place of the options. */
+    searchError?: ReactNode;
+    /** The pause before `onSearch` and `onQueryChange` run, in ms. Default 250. */
+    debounceMs?: number;
+    /** `onSearch` waits for this many characters. Default 1. */
+    minQueryLength?: number;
+    /** Default `'accent-insensitive'`, or `'none'` with `onSearch`. */
+    filter?: AutocompleteFilter<T>;
+};
+export type AutocompleteProps<T extends AutocompleteOption = AutocompleteOption> = Omit<InputGroupFieldProps, 'renderInput'> & {
+    label?: ReactNode;
+    placeholder?: ReactNode;
+    helperText?: ReactNode;
+    error?: boolean;
+    leading?: ReactNode;
+    trailing?: ReactNode;
+    /** The options; with `onSearch`, only those to show before a search (the selected ones). */
+    options?: T[];
+    getOptionValue?: (option: T) => string;
+    getOptionLabel?: (option: T) => string;
+    empty?: ReactNode;
+    freeSolo?: boolean;
+    freeSoloLabel?: (query: string) => string;
+    name?: string;
+    disabled?: boolean;
+    renderOption?: (option: T) => ReactNode;
+    renderSelectedLeading?: (option: T) => ReactNode;
+    actions?: ReactNode | ((query: string) => ReactNode);
+    /** The query, once typing pauses (`debounceMs`). */
+    onQueryChange?: (query: string) => void;
+} & AutocompleteSearchProps<T> & ({
+    mode: 'single';
+    value: string;
+    onValueChange?: (value?: string | null) => void;
+} | {
+    mode: 'multiple';
+    value: string[];
+    onValueChange?: (value?: string[] | null) => void;
+});

package/dist/lib/components/ui/selection/autocomplete/use-autocomplete-filter.d.ts

@@ -0,0 +1,13 @@
+import { AutocompleteFilter } from './types';
+type Readers<T> = {
+    getOptionValue: (option: T) => string;
+    getOptionLabel: (option: T) => string;
+};
+/**
+ * The filter the Combobox runs as the user types, from `filter`: `null`
+ * (show the options as given) for `'none'`, which `onSearch` defaults to;
+ * otherwise a match on the label or the value, accent- and case-insensitive
+ * in the provider's language.
+ */
+export declare function useAutocompleteFilter<T>(filter: AutocompleteFilter<T> | undefined, searching: boolean, { getOptionValue, getOptionLabel }: Readers<T>): ((option: T, query: string) => boolean) | null;
+export {};

package/dist/lib/components/ui/selection/autocomplete/use-autocomplete-handlers.d.ts

@@ -0,0 +1,17 @@
+import { Dispatch, SetStateAction } from 'react';
+import { ChangeEventDetails } from '../combobox/combobox';
+import { AutocompleteOption, AutocompleteProps } from './types';
+type State<T> = {
+    setQuery: Dispatch<SetStateAction<string>>;
+    setOpen: Dispatch<SetStateAction<boolean>>;
+    getOptionValue: (option: T) => string;
+    /** Keeps the picked options, for their chips once the list moves on. */
+    remember: (options: T[]) => void;
+};
+/** What the Combobox and the chips call back: a pick, a removal, typing. */
+export declare function useAutocompleteHandlers<T extends AutocompleteOption>(props: AutocompleteProps<T>, { setQuery, setOpen, getOptionValue: readValue, remember }: State<T>): {
+    handleRemove: (value: string) => void;
+    handleValueChange: (value: any) => void;
+    handleInputValueChange: (value: string, eventDetails: ChangeEventDetails) => void;
+};
+export {};

package/dist/lib/components/ui/selection/autocomplete/use-autocomplete-search.d.ts

@@ -0,0 +1,8 @@
+import { AsyncSearchState } from '@nxgt/material-core/async-search';
+import { AutocompleteSearchProps } from './types';
+/**
+ * `onSearch`'s state while the list is open: searched once typing pauses,
+ * each run aborting the last, and a stale response dropped (core's
+ * `createAsyncSearch`). `null` without `onSearch`.
+ */
+export declare function useAutocompleteSearch<T>(props: Pick<AutocompleteSearchProps<T>, 'onSearch' | 'onSearchError' | 'debounceMs' | 'minQueryLength'>, query: string, open: boolean): AsyncSearchState<T> | null;

package/dist/lib/components/ui/selection/autocomplete/use-autocomplete-status.d.ts

@@ -0,0 +1,28 @@
+import { AsyncSearchState } from '@nxgt/material-core/async-search';
+import { ReactNode } from 'react';
+import { AutocompleteProps } from './types';
+type StatusProps = Pick<AutocompleteProps, 'loading' | 'searchError' | 'empty' | 'freeSolo' | 'minQueryLength'> & {
+    debounceMs: number;
+};
+type List = {
+    query: string;
+    open: boolean;
+    /** `onSearch`'s state, `null` without it. */
+    search: AsyncSearchState<unknown> | null;
+    /** How many options the list shows for the query. */
+    count: number;
+};
+/**
+ * What the list says besides its options — loading, a failure, the minimum
+ * query length, the empty text — and the polite announcement: "Loading…",
+ * then the count once the search answered or typing paused, never on every
+ * keystroke.
+ */
+export declare function useAutocompleteStatus(props: StatusProps, list: List): {
+    loading: boolean;
+    failure: ReactNode;
+    hint: string | null;
+    emptyText: string | number | bigint | true | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null;
+    announcement: ReactNode;
+};
+export {};