@nxgt/material 2.17.0 → 2.18.1

package/dist/{mermaid.core-DW7UlwJu.js → mermaid.core-BHmjz3IJ.js}

@@ -8,9 +8,9 @@ import { a as he } from "./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-C8MhuVIi.js";
+import "./chunk-Z7XXMR3K-DDFBvLN4.js";
 import "./chunk-UA2S7LBM-ChuksCDg.js";
-import { n as ge } from "./chunk-GNY47TPC-DdqgSBxM.js";
+import { n as ge } from "./chunk-GNY47TPC-AFxr6Xhs.js";
 import { n as _e, t as ve } from "./chunk-LNGE3PJU-DJjGTS7O.js";
 //#region ../../node_modules/es-toolkit/dist/compat/_internal/isPrototype.mjs
 function ye(e) {
@@ -302,7 +302,7 @@ var qe = "c4", Je = {
 	id: Ye,
 	detector: /* @__PURE__ */ p((e) => /^\s*(graph|flowchart)/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./flowDiagram-KWPJA3E3-CDzuzre6.js");
+		let { diagram: e } = await import("./flowDiagram-KWPJA3E3-CAt7iv16.js");
 		return {
 			id: Ye,
 			diagram: e
@@ -312,7 +312,7 @@ var qe = "c4", Je = {
 	id: Ze,
 	detector: /* @__PURE__ */ p((e) => /^\s*agentflow-beta\b/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./diagram-22UHCM2B-DREk9ku4.js");
+		let { diagram: e } = await import("./diagram-22UHCM2B-B1mxqDwI.js");
 		return {
 			id: Ze,
 			diagram: e
@@ -322,7 +322,7 @@ var qe = "c4", Je = {
 	id: $e,
 	detector: /* @__PURE__ */ p((e) => /^\s*swimlane-beta\b/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./swimlanesDiagram-TC7HE7FX-Dt6Tqj4h.js");
+		let { diagram: e } = await import("./swimlanesDiagram-TC7HE7FX-Jk8do14f.js");
 		return {
 			id: $e,
 			diagram: e
@@ -332,7 +332,7 @@ var qe = "c4", Je = {
 	id: tt,
 	detector: /* @__PURE__ */ p((e) => /^\s*erDiagram/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./erDiagram-OPXOYQCR-CTfn8QUl.js");
+		let { diagram: e } = await import("./erDiagram-OPXOYQCR-nyCpuYg6.js");
 		return {
 			id: tt,
 			diagram: e
@@ -352,7 +352,7 @@ var qe = "c4", Je = {
 	id: at,
 	detector: /* @__PURE__ */ p((e) => /^\s*gantt/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./ganttDiagram-FUAMR5RP-Ci-9ZJz5.js");
+		let { diagram: e } = await import("./ganttDiagram-FUAMR5RP-g4YEKVC-.js");
 		return {
 			id: at,
 			diagram: e
@@ -372,7 +372,7 @@ var qe = "c4", Je = {
 	id: lt,
 	detector: /* @__PURE__ */ p((e) => /^\s*pie/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./pieDiagram-5QR66LMP-C-dfffj5.js");
+		let { diagram: e } = await import("./pieDiagram-5QR66LMP-5nOKLXqH.js");
 		return {
 			id: lt,
 			diagram: e
@@ -382,7 +382,7 @@ var qe = "c4", Je = {
 	id: dt,
 	detector: /* @__PURE__ */ p((e) => /^\s*quadrantChart/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./quadrantDiagram-O4NWA36T-DZ0TivLD.js");
+		let { diagram: e } = await import("./quadrantDiagram-O4NWA36T-B0RNQlBB.js");
 		return {
 			id: dt,
 			diagram: e
@@ -392,7 +392,7 @@ var qe = "c4", Je = {
 	id: pt,
 	detector: /* @__PURE__ */ p((e) => /^\s*xychart(-beta)?/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./xychartDiagram-PMCCYNJV-Cleaihn8.js");
+		let { diagram: e } = await import("./xychartDiagram-PMCCYNJV-CQJbSV7N.js");
 		return {
 			id: pt,
 			diagram: e
@@ -402,7 +402,7 @@ var qe = "c4", Je = {
 	id: ht,
 	detector: /* @__PURE__ */ p((e) => /^\s*requirement(Diagram)?/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./requirementDiagram-PLB6GJNP-3brF-h1L.js");
+		let { diagram: e } = await import("./requirementDiagram-PLB6GJNP-Cw85zSzP.js");
 		return {
 			id: ht,
 			diagram: e
@@ -422,7 +422,7 @@ var qe = "c4", Je = {
 	id: yt,
 	detector: /* @__PURE__ */ p((e) => /^\s*classDiagram/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./classDiagram-v2-NBCMYWYE-ByUAGkfa.js");
+		let { diagram: e } = await import("./classDiagram-v2-NBCMYWYE-Cx1q9jwX.js");
 		return {
 			id: yt,
 			diagram: e
@@ -432,7 +432,7 @@ var qe = "c4", Je = {
 	id: xt,
 	detector: /* @__PURE__ */ p((e) => /^\s*stateDiagram/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./stateDiagram-v2-GCMORJYK-BGavr7Nm.js");
+		let { diagram: e } = await import("./stateDiagram-v2-GCMORJYK-CfSjJkc3.js");
 		return {
 			id: xt,
 			diagram: e
@@ -442,7 +442,7 @@ var qe = "c4", Je = {
 	id: Ct,
 	detector: /* @__PURE__ */ p((e) => /^\s*journey/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./journeyDiagram-ZHPQQLJL-CwFYd51O.js");
+		let { diagram: e } = await import("./journeyDiagram-ZHPQQLJL-v7NsJ_vl.js");
 		return {
 			id: Ct,
 			diagram: e
@@ -460,7 +460,7 @@ var qe = "c4", Je = {
 	id: Ot,
 	detector: /* @__PURE__ */ p((e, t = {}) => /^\s*flowchart-elk/.test(e) ? (t.layout = "elk", !0) : !1, "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./flowDiagram-KWPJA3E3-CDzuzre6.js");
+		let { diagram: e } = await import("./flowDiagram-KWPJA3E3-CAt7iv16.js");
 		return {
 			id: Ot,
 			diagram: e
@@ -470,7 +470,7 @@ var qe = "c4", Je = {
 	id: At,
 	detector: /* @__PURE__ */ p((e) => /^\s*timeline/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./timeline-definition-EJHVYXUP-CE-3KwYd.js");
+		let { diagram: e } = await import("./timeline-definition-EJHVYXUP-Bc40K9sk.js");
 		return {
 			id: At,
 			diagram: e
@@ -480,7 +480,7 @@ var qe = "c4", Je = {
 	id: Mt,
 	detector: /* @__PURE__ */ p((e) => /^\s*mindmap/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./mindmap-definition-NLK3R4M7-CsLyIyEF.js");
+		let { diagram: e } = await import("./mindmap-definition-NLK3R4M7-xOeGZSSo.js");
 		return {
 			id: Mt,
 			diagram: e
@@ -500,7 +500,7 @@ var qe = "c4", Je = {
 	id: It,
 	detector: /* @__PURE__ */ p((e) => /^\s*sankey(-beta)?/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./sankeyDiagram-IPEJSGJF-BY-LLyiZ.js");
+		let { diagram: e } = await import("./sankeyDiagram-IPEJSGJF-APZoNvA9.js");
 		return {
 			id: It,
 			diagram: e
@@ -530,7 +530,7 @@ var qe = "c4", Je = {
 	id: Ht,
 	detector: /* @__PURE__ */ p((e) => /^\s*block(-beta)?/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./blockDiagram-BEXU5L5S-K2MjXCm9.js");
+		let { diagram: e } = await import("./blockDiagram-BEXU5L5S-iNiTd2F6.js");
 		return {
 			id: Ht,
 			diagram: e
@@ -590,7 +590,7 @@ var qe = "c4", Je = {
 	id: en,
 	detector: /* @__PURE__ */ p((e) => /^\s*treemap/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./diagram-3UASUU5V-CYkPaos5.js");
+		let { diagram: e } = await import("./diagram-3UASUU5V-DKbBxWI5.js");
 		return {
 			id: en,
 			diagram: e
@@ -600,7 +600,7 @@ var qe = "c4", Je = {
 	id: nn,
 	detector: /* @__PURE__ */ p((e) => /^\s*usecase-beta(?:\s|$)/.test(e), "detector"),
 	loader: /* @__PURE__ */ p(async () => {
-		let { diagram: e } = await import("./usecaseDiagram-POWQR4AR-CPOCe5We.js");
+		let { diagram: e } = await import("./usecaseDiagram-POWQR4AR-CKd5UWWw.js");
 		return {
 			id: nn,
 			diagram: e

package/dist/{mindmap-definition-NLK3R4M7-CsLyIyEF.js → mindmap-definition-NLK3R4M7-xOeGZSSo.js}

@@ -7,11 +7,11 @@ 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-C8MhuVIi.js";
+import "./chunk-Z7XXMR3K-DDFBvLN4.js";
 import { t as u } from "./chunk-XXDRQBXY-dKXxu_aj.js";
 import { t as d } from "./chunk-WEXAMYUT-CbFOhEve.js";
 import "./chunk-UA2S7LBM-ChuksCDg.js";
-import { r as f, t as p } from "./chunk-GNY47TPC-DdqgSBxM.js";
+import { r as f, t as p } from "./chunk-GNY47TPC-AFxr6Xhs.js";
 //#region ../../node_modules/uuid/dist/stringify.js
 var m = [];
 for (let e = 0; e < 256; ++e) m.push((e + 256).toString(16).slice(1));

package/dist/{pieDiagram-5QR66LMP-C-dfffj5.js → pieDiagram-5QR66LMP-5nOKLXqH.js}

@@ -1,4 +1,4 @@
-import { ct as e, ot as t } from "./components-CIYQrI45.js";
+import { ct as e, ot as t } from "./components-CEXxj5QP.js";
 import { n } from "./src-CsLQInsN.js";
 import { i as r, p as i } from "./chunk-ZIGJFQKS-9VXArDKF.js";
 import { t as a } from "./ordinal-DwxdXP1t.js";

package/dist/{quadrantDiagram-O4NWA36T-DZ0TivLD.js → quadrantDiagram-O4NWA36T-B0RNQlBB.js}

@@ -1,4 +1,4 @@
-import { rt as e } from "./components-CIYQrI45.js";
+import { rt as e } from "./components-CEXxj5QP.js";
 import { n as t, t as n } from "./src-CsLQInsN.js";
 import { n as r } from "./chunk-Y2CYZVJY-BAad7w_K.js";
 import { D as i, H as a, U as o, a as s, c, f as l, q as u, v as d, w as f, x as p, y as m, z as h } from "./chunk-O7XYJQB3-BChweQ_V.js";

package/dist/{requirementDiagram-PLB6GJNP-3brF-h1L.js → requirementDiagram-PLB6GJNP-Cw85zSzP.js}

@@ -8,11 +8,11 @@ import "./chunk-7PRAP22T-0C6_H8Li.js";
 import { a as p, i as m, o as h, r as g } from "./chunk-J5ZVWO5B-DmRRmhon.js";
 import "./chunk-7INBJB4K-k-I67NSP.js";
 import "./chunk-5DYCD2WN-Cd1zazNp.js";
-import "./chunk-Z7XXMR3K-C8MhuVIi.js";
+import "./chunk-Z7XXMR3K-DDFBvLN4.js";
 import { t as _ } from "./chunk-XXDRQBXY-dKXxu_aj.js";
 import { t as v } from "./chunk-WEXAMYUT-CbFOhEve.js";
 import "./chunk-UA2S7LBM-ChuksCDg.js";
-import { r as y, t as b } from "./chunk-GNY47TPC-DdqgSBxM.js";
+import { r as y, t as b } from "./chunk-GNY47TPC-AFxr6Xhs.js";
 //#region ../../node_modules/mermaid/dist/chunks/mermaid.core/requirementDiagram-PLB6GJNP.mjs
 var x = (function() {
 	var e = /* @__PURE__ */ n(function(e, t, n, r) {

package/dist/{sankeyDiagram-IPEJSGJF-BY-LLyiZ.js → sankeyDiagram-IPEJSGJF-APZoNvA9.js}

@@ -1,4 +1,4 @@
-import { V as e } from "./components-CIYQrI45.js";
+import { V as e } from "./components-CEXxj5QP.js";
 import { t } from "./src-CsLQInsN.js";
 import { t as n } from "./ordinal-DwxdXP1t.js";
 import { n as r } from "./chunk-Y2CYZVJY-BAad7w_K.js";

package/dist/{stateDiagram-v2-GCMORJYK-BGavr7Nm.js → stateDiagram-v2-GCMORJYK-CfSjJkc3.js}

@@ -8,12 +8,12 @@ import "./chunk-7PRAP22T-0C6_H8Li.js";
 import { a as h, i as g, o as _, r as v } from "./chunk-J5ZVWO5B-DmRRmhon.js";
 import "./chunk-7INBJB4K-k-I67NSP.js";
 import "./chunk-5DYCD2WN-Cd1zazNp.js";
-import "./chunk-Z7XXMR3K-C8MhuVIi.js";
+import "./chunk-Z7XXMR3K-DDFBvLN4.js";
 import { t as y } from "./chunk-GWA4HPMP-B8jXI0Tl.js";
 import { t as b } from "./chunk-XXDRQBXY-dKXxu_aj.js";
 import { t as x } from "./chunk-WEXAMYUT-CbFOhEve.js";
 import "./chunk-UA2S7LBM-ChuksCDg.js";
-import { r as S, t as C } from "./chunk-GNY47TPC-DdqgSBxM.js";
+import { r as S, t as C } from "./chunk-GNY47TPC-AFxr6Xhs.js";
 //#region ../../node_modules/mermaid/dist/chunks/mermaid.core/stateDiagram-v2-GCMORJYK.mjs
 var w = (function() {
 	var e = /* @__PURE__ */ i(function(e, t, n, r) {

package/dist/{swimlanes-2SLR337P-B6Fkr7-U.js → swimlanes-2SLR337P-Bv2VKn_d.js}

@@ -7,10 +7,10 @@ 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-C8MhuVIi.js";
+import "./chunk-Z7XXMR3K-DDFBvLN4.js";
 import "./chunk-UA2S7LBM-ChuksCDg.js";
-import { r as n } from "./chunk-3FUC2YCW-6KyD6CAZ.js";
-import { t as r } from "./chunk-NETBCI7D-ZnunhYtw.js";
+import { r as n } from "./chunk-3FUC2YCW-C3_88DyD.js";
+import { t as r } from "./chunk-NETBCI7D-DUZYHta0.js";
 //#region ../../node_modules/mermaid/dist/chunks/mermaid.core/swimlanes-2SLR337P.mjs
 function i(e, { measure: t }) {
 	let n = e.config?.swimlane?.lineHops;

package/dist/{swimlanesDiagram-TC7HE7FX-Dt6Tqj4h.js → swimlanesDiagram-TC7HE7FX-Jk8do14f.js}

@@ -7,14 +7,14 @@ 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-C8MhuVIi.js";
+import "./chunk-Z7XXMR3K-DDFBvLN4.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-DdqgSBxM.js";
+import "./chunk-GNY47TPC-AFxr6Xhs.js";
 import "./chunk-LNGE3PJU-DJjGTS7O.js";
-import { r as t, t as n } from "./chunk-7M6MHVWA-CNWcBB_6.js";
+import { r as t, t as n } from "./chunk-7M6MHVWA-DSA5AJyK.js";
 //#region ../../node_modules/mermaid/dist/chunks/mermaid.core/swimlanesDiagram-TC7HE7FX.mjs
 var r = n({ styles: /* @__PURE__ */ e((e) => `${t(e)}
   .swimlane.cluster:not([data-color-id]) rect {

package/dist/{timeline-definition-EJHVYXUP-CE-3KwYd.js → timeline-definition-EJHVYXUP-Bc40K9sk.js}

@@ -1,4 +1,4 @@
-import { ct as e } from "./components-CIYQrI45.js";
+import { ct as e } from "./components-CEXxj5QP.js";
 import { n as t, t as n } from "./src-CsLQInsN.js";
 import { p as r } from "./chunk-ZIGJFQKS-9VXArDKF.js";
 import { n as i, t as a } from "./chunk-Y2CYZVJY-BAad7w_K.js";

package/dist/{usecaseDiagram-POWQR4AR-CPOCe5We.js → usecaseDiagram-POWQR4AR-CKd5UWWw.js}

@@ -8,11 +8,11 @@ import "./chunk-7PRAP22T-0C6_H8Li.js";
 import { a as g, i as _, o as v, r as y } from "./chunk-J5ZVWO5B-DmRRmhon.js";
 import "./chunk-7INBJB4K-k-I67NSP.js";
 import "./chunk-5DYCD2WN-Cd1zazNp.js";
-import "./chunk-Z7XXMR3K-C8MhuVIi.js";
+import "./chunk-Z7XXMR3K-DDFBvLN4.js";
 import { t as ee } from "./chunk-XXDRQBXY-dKXxu_aj.js";
 import { t as te } from "./chunk-WEXAMYUT-CbFOhEve.js";
 import "./chunk-UA2S7LBM-ChuksCDg.js";
-import { r as ne, t as re } from "./chunk-GNY47TPC-DdqgSBxM.js";
+import { r as ne, t as re } from "./chunk-GNY47TPC-AFxr6Xhs.js";
 //#region ../../node_modules/chevrotain/node_modules/lodash-es/_freeGlobal.js
 var ie = typeof global == "object" && global && global.Object === Object && global, ae = typeof self == "object" && self && self.Object === Object && self, b = ie || ae || Function("return this")(), oe = b.Symbol, se = Object.prototype, ce = se.hasOwnProperty, le = se.toString, ue = oe ? oe.toStringTag : void 0;
 function de(e) {

package/dist/{xychartDiagram-PMCCYNJV-Cleaihn8.js → xychartDiagram-PMCCYNJV-CQJbSV7N.js}

@@ -1,4 +1,4 @@
-import { at as e, rt as t, st as n } from "./components-CIYQrI45.js";
+import { at as e, rt as t, st as n } from "./components-CEXxj5QP.js";
 import { n as r } from "./src-CsLQInsN.js";
 import { i } from "./chunk-ZIGJFQKS-9VXArDKF.js";
 import { n as a } from "./chunk-Y2CYZVJY-BAad7w_K.js";

package/docs/components/feedback-and-status.md

@@ -149,6 +149,8 @@ the element that had it when it opened (the button of yours that opened a
 controlled `AlertDialog`, too), unless focus already went elsewhere or your
 `onCloseAutoFocus` calls `event.preventDefault()`.
 
+`AlertDialogContent` is capped to the viewport height and scrolls inside itself, like `DialogContent` ([Dialog](overlays-and-menus.md#dialog)).
+
 **Storybook:** `Feedback & status/AlertDialog` · **Vue:** `AlertDialog` (same parts)
 
 ---

package/docs/components/overlays-and-menus.md

@@ -109,6 +109,21 @@ export function Terms() {
 | `asChild` (`DialogTrigger`) | `boolean` | **`true`** | the trigger is its child — pass one element, usually a `Button` |
 | `variant`, `color` (`DialogClose`) | as `IconButton` | `'ghost'` | a top-right X button, named "Close" (`material.buttons.close`, translated) while it shows only the icon; text children or an `aria-label` name it instead, and icon-only children leave it unnamed; children replace the X |
 
+`DialogContent` and `AlertDialogContent` are capped at `100dvh - 2rem` (`100vh`
+where `dvh` is unsupported) and scroll inside themselves, so a long body never
+pushes the title off-screen on a phone. A close button inside the content scrolls with it (`DialogContent` renders no X itself). On
+browsers with `dvh` support, your own `max-h-*` through `className` wins over the
+cap. To remove the cap and the scroll, pass `className="max-h-none overflow-visible"`:
+
+```tsx
+<DialogContent className="max-h-none overflow-visible">
+```
+
+Content wider than the dialog now scrolls horizontally or is clipped
+(`overflow-visible` restores the old behaviour). `DialogScrollContent` is for a
+dialog that should grow taller than the screen and scroll inside the overlay
+instead of capping; it does not pin the header or footer.
+
 `DialogContent` does not render a close button by itself — add `DialogClose`.
 It ignores outside clicks that land on an open `Combobox` list, so a combobox
 inside a dialog works. On open it moves focus into the dialog: to its first
@@ -191,6 +206,9 @@ Parts: `Sheet`, `SheetTrigger`, `SheetContent`, `SheetHeader`, `SheetTitle`,
 | `withCloseButton` (`SheetContent`) | `boolean` | — | adds a tonal X button top-right, named "Close" (`material.buttons.close`, translated) |
 | `defaultOpen` / `open`, `onOpenChange`, `modal` (`Sheet`) | as `Dialog` | — | a sheet is a Radix dialog |
 
+`SheetContent` scrolls inside itself, and a top or bottom sheet is capped at
+`100dvh`. Override the cap with `max-h-*` through `className`.
+
 `SheetTrigger` is **not** `asChild` by default, unlike `DialogTrigger`.
 `SheetContent` moves focus in on open and hands it back on close as
 `DialogContent` does: back to the

package/docs/components/selection-and-choice.md

@@ -287,17 +287,17 @@ Parts: `Autocomplete`, `AutocompleteChips` (the chips row it uses in
 | `mode` | `'single' \| 'multiple'` | — | required; decides the `value` type |
 | `value` | `string` / `string[]` | — | required, per `mode` |
 | `onValueChange` | `(value?: string \| null) => void` / `(value?: string[] \| null) => void` | — | per `mode` |
-| `options` | `T[]` (`{ value, label }` by default) | `[]` | the items; with `onSearch`, the list before a search and the selected options' labels |
+| `options` | `T[]` (`{ value, label, disabled? }` by default) | `[]` | the items (`disabled` on one: listed, announced as disabled, never picked); with `onSearch`, the list before a search and the selected options' labels |
 | `getOptionValue`, `getOptionLabel` | `(option: T) => string` | `.value`, `.label` | for other option shapes |
 | `filter` | `'accent-insensitive' \| 'none' \| (option: T, query: string) => boolean` | `'accent-insensitive'`, `'none'` with `onSearch` | how the list is filtered as the user types: label or value, ignoring case and accents (`e` finds "École") in the provider's language; `'none'` shows `options` as given; a function gets the trimmed query, never an empty one |
 | `freeSolo` | `boolean` | — | accept a typed value that is not an option |
 | `onSearch` | `(query: string, { signal }: { signal: AbortSignal }) => Promise<T[]>` | — | server search: called once typing pauses; its results become the list. Each search aborts the previous one, and a response that lands after a newer one is dropped |
 | `onSearchError` | `(error: unknown) => void` | — | `onSearch` rejected (an abort is not a rejection) |
 | `minQueryLength` | `number` | `1` | `onSearch` waits for this many characters; below it the list says "Type at least N characters to search." |
-| `debounceMs` | `number` | `250` | the pause before `onSearch` and `onQueryChange` run |
-| `onQueryChange` | `(query: string) => void` | — | the query once typing pauses — fetch `options` yourself here |
+| `debounceMs` | `number` | `250` | the pause before `onSearch` and `onQueryChange` run on typed text; an emptied query is reported to `onQueryChange` at once, and `onSearch` never runs on it unless `minQueryLength` is `0` (then it follows the pause) |
+| `onQueryChange` | `(query: string) => void` | — | the query once typing pauses, and `''` at once when it empties (a pick, a clear) — fetch `options` yourself here |
 | `loading` | `boolean` | — | with `onQueryChange`: "Loading…" in the list, `aria-busy` on the listbox, announced |
-| `searchError` | `ReactNode` | — | with `onQueryChange`: shown and announced in place of the options |
+| `searchError` | `ReactNode` | — | shown and announced in place of the options; with `onSearch` it replaces the generic "The search failed. Try again." |
 | `empty` | `ReactNode` | "No option found." | text when nothing matches |
 | `actions` | `ReactNode \| ((query: string) => ReactNode)` | — | buttons at the end of the list ("Create …") |
 | `required` | `boolean` | — | the asterisk, and `aria-required` on the `combobox` input, which the label names |
@@ -346,7 +346,10 @@ export function PersonField() {
 With `onSearch`, `minQueryLength` defaults to 1, `debounceMs` to 250 and `filter` to `'none'`
 (the server filters). A rejected search shows and announces "The search
 failed. Try again." by itself and hands the error to `onSearchError`; an abort is
-never an error. Type your search with `AutocompleteSearch<T>` (its second
+never an error. To say why instead (the API's own refusal, "the service is
+unreachable"), keep the reason in your state from `onSearchError` and pass it as
+`searchError`: it takes precedence over the generic text, in the list and in the
+live region. Type your search with `AutocompleteSearch<T>` (its second
 argument is `AutocompleteSearchContext`, `{ signal }`); `AutocompleteFilter<T>`
 and `AutocompleteSearchProps<T>` are exported from `@nxgt/material/components` too.
 
@@ -354,6 +357,11 @@ To fetch it yourself instead, keep `options` and `loading` in your state,
 update them from `onQueryChange`, and pass `filter="none"` when the server
 already filtered.
 
+A disabled option (`disabled: true` on it, in `options` or in what `onSearch`
+returns) is greyed out, carries `aria-disabled`, and is never picked, by click
+or by Enter, in `single` and `multiple` mode. As in the combobox pattern, the
+arrow keys still reach it so that it is announced; Enter on it does nothing.
+
 **Accessibility.** A polite live region (`role="status"`) says "Loading…",
 then "3 results" or "No results" (or the failure) once the search answers or
 typing pauses — never on every keystroke. The listbox is `aria-busy` while

package/docs/troubleshooting.md

@@ -27,6 +27,7 @@ words in your error.
 - [Dialogs, toasts or buttons no longer animate](#dialogs-toasts-or-buttons-no-longer-animate)
 - [A Content-Security-Policy reports a `data:` image on every form with a required field](#a-content-security-policy-reports-a-data-image-on-every-form-with-a-required-field)
 - [A Button's label overflows a card on a phone](#a-buttons-label-overflows-a-card-on-a-phone)
+- [A dialog or sheet scrolls, or clips a child, after upgrading](#a-dialog-or-sheet-scrolls-or-clips-a-child-after-upgrading)
 
 **Feedback**
 
@@ -150,7 +151,10 @@ words in your error.
 - [A test no longer finds `aria-invalid` on a `Switch` row or an `Autocomplete`'s chips](#a-test-no-longer-finds-aria-invalid-on-a-switch-row-or-an-autocompletes-chips)
 - [An `Autocomplete` lists more options than before, or "ecole" finds "École"](#an-autocomplete-lists-more-options-than-before-or-ecole-finds-école)
 - [`onQueryChange` runs more often after upgrading](#onquerychange-runs-more-often-after-upgrading)
+- [A click on the next field right after an `Autocomplete` pick is lost](#a-click-on-the-next-field-right-after-an-autocomplete-pick-is-lost)
 - [An older search's results replace the newer ones in an `Autocomplete`](#an-older-searchs-results-replace-the-newer-ones-in-an-autocomplete)
+- [An `Autocomplete` option does nothing on click or Enter](#an-autocomplete-option-does-nothing-on-click-or-enter)
+- ["The search failed. Try again." no longer shows in an `Autocomplete`](#the-search-failed-try-again-no-longer-shows-in-an-autocomplete)
 - [A test no longer finds `aria-invalid` on an `OtpField` slot](#a-test-no-longer-finds-aria-invalid-on-an-otpfield-slot)
 - [A test no longer finds the breadcrumb's home button](#a-test-no-longer-finds-the-breadcrumbs-home-button)
 - [A test no longer finds a sidebar entry by the `button` role](#a-test-no-longer-finds-a-sidebar-entry-by-the-button-role)
@@ -616,6 +620,27 @@ your own through `className`. With `asChild`, put the label in a `<span>`:
 </Button>
 ```
 
+### A dialog or sheet scrolls, or clips a child, after upgrading
+
+**When:** after upgrading, a tall `DialogContent`, `AlertDialogContent` or
+`SheetContent` shows a scrollbar, or a child that stuck out of it (a popover, a
+focus ring, a wide table) is clipped.
+**Why:** these contents are now capped to the viewport (`max-h-[calc(100dvh-2rem)]`,
+`100vh` where `dvh` is unsupported; a top or bottom sheet is capped at `100dvh`)
+and carry `overflow-y-auto`, so a long body scrolls inside them instead of
+leaving the title off-screen. Setting `overflow-y` makes `overflow-x` clip or
+scroll too.
+**Fix:** to keep the old behaviour on one dialog, remove the cap and the scroll
+with `className="max-h-none overflow-visible"`; to change the cap, pass your own
+`max-h-*` (it wins on browsers with `dvh` support):
+
+```tsx
+<DialogContent className="max-h-none overflow-visible">
+```
+
+For a dialog that should grow taller than the screen and scroll inside the
+overlay instead of capping, use `DialogScrollContent`.
+
 ## Feedback
 
 ### A toast with an action never goes away
@@ -2887,6 +2912,20 @@ was a fixed 1 s.
 **Fix:** set the pause you had, `debounceMs={1000}`, or move the fetch to `onSearch`, which
 also aborts the previous request and drops a stale response.
 
+### A click on the next field right after an `Autocomplete` pick is lost
+
+**When:** before 2.18.1, in a dialog, a `Select` (or any field) right below an
+`Autocomplete` whose `onQueryChange` shows or hides something (a line naming
+who is already linked, a result count): a click on that field's option just
+after a pick does nothing, now and then (more often in Firefox and on a slow
+machine; an end-to-end test flakes).
+**Why:** a pick empties the query, and `onQueryChange('')` came only after
+`debounceMs`. The line it removed then shrank the centred dialog, which moved
+the open list by half that height between the pointer's press and its release:
+the release landed on another option, and nothing was chosen.
+**Fix:** upgrade: an emptied query is reported at once, with the pick, before
+the next click. Waiting in a test until no `listbox` is left only hid it.
+
 ### An older search's results replace the newer ones in an `Autocomplete`
 
 **When:** you fetch `options` yourself from `onQueryChange`, and a slow response
@@ -2909,6 +2948,51 @@ an older query, even from an API that ignores the signal:
 />
 ```
 
+### An `Autocomplete` option does nothing on click or Enter
+
+**When:** one option of an `Autocomplete` is greyed out and clicking it, or
+pressing Enter on it, changes nothing, with no error.
+**Why:** that option has `disabled: true` (in the local `options` or in what
+`onSearch` returns). It is listed and announced with `aria-disabled`, and never
+picked, in `single` and `multiple` mode; the arrow keys still reach a disabled option so that it is announced, but Enter does not pick it.
+**Fix:** drop `disabled` from the option, or build it only for the options that
+may be chosen:
+
+```tsx
+<Autocomplete
+	mode="single"
+	value={value}
+	onValueChange={setValue}
+	options={[
+		{ value: 'a', label: 'Alpha', disabled: true }, // listed, never picked
+		{ value: 'b', label: 'Beta' },
+	]}
+/>
+```
+
+### "The search failed. Try again." no longer shows in an `Autocomplete`
+
+**When:** after upgrading, an `Autocomplete` whose `onSearch` rejects shows
+your own text, or nothing generic, where it used to say "The search failed. Try
+again."
+**Why:** `searchError` now takes precedence over the generic text with `onSearch`
+too, in the list and in the live announcement. The generic text only shows
+while `searchError` is unset.
+**Fix:** nothing, if the reason is what you want. To get the generic text back,
+leave `searchError` unset or empty; to show a reason, keep it from `onSearchError` and pass it
+back:
+
+```tsx
+<Autocomplete
+	mode="single"
+	value={value}
+	onValueChange={setValue}
+	onSearch={search}
+	onSearchError={() => setReason('Directory unreachable')}
+	searchError={reason}
+/>
+```
+
 ### A test no longer finds `aria-invalid` on an `OtpField` slot
 
 **When:** `[data-slot="input-otp-slot"][aria-invalid]` (or

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nxgt/material",
-	"version": "2.17.0",
+	"version": "2.18.1",
 	"license": "MIT",
 	"bugs": {
 		"email": "stevegires@gmail.com"