@nxgt/material 3.38.0 → 3.41.0

package/dist/pdf-reader.js

@@ -1,3 +1,3 @@
-import { t as e } from "./public-CWIpzLzO.js";
+import { t as e } from "./public-ib0sK0Hr.js";
 import { configurePdfReader as t } from "@nxgt/material-core/pdf-reader";
 export { e as PdfReader, t as configurePdfReader };

package/dist/print.js

@@ -1,5 +1,5 @@
-import { r as e } from "./i18n-provider-C0RBM8rH.js";
-import { t } from "./translate-material-B84ufMSF.js";
+import { r as e } from "./i18n-provider-DkeMr5bw.js";
+import { t } from "./translate-material-BYRDtSEk.js";
 import { Children as n, createContext as r, isValidElement as i, useCallback as a, useContext as o, useEffect as s, useMemo as c, useState as l } from "react";
 import { jsx as u, jsxs as d } from "react/jsx-runtime";
 import { resolvePdfFileName as f } from "@nxgt/material-core/pdf-file-name";

package/dist/{public-CWIpzLzO.js → public-ib0sK0Hr.js}

@@ -6,18 +6,18 @@ import { c as i, i as a, l as o, n as s, o as c, s as l } from "./dist-lmHmz_bu.
 import { a as u, o as d } from "./tooltip-CkttDIab.js";
 import { i as f } from "./dist-C4wtXCjf.js";
 import { r as p, t as m } from "./in-dialog-Vwkyp-M5.js";
-import { C as h, D as g, E as _, O as v, S as y, T as b, _ as x, f as S, g as ee, k as te, r as ne, t as C, u as re, w } from "./dialog-BCsT_aLo.js";
-import { c as T, d as ie, f as E, i as ae, l as oe, n as se, o as D, t as ce, u as O } from "./dropdown-menu-Crt5QvTr.js";
-import { S as le, a as k, d as A, g as ue, h as de, i as fe, m as pe, n as j, r as me, t as M, u as he, w as ge } from "./toolbar-items-C97E5HRa.js";
-import { t as N } from "./use-material-translation-CiYhVc39.js";
-import { t as _e } from "./button-D52ron-a.js";
+import { C as h, D as g, E as _, O as v, S as y, T as b, _ as x, f as S, g as ee, k as te, r as ne, t as C, u as re, w } from "./dialog-uQld1gKm.js";
+import { c as T, d as ie, f as E, i as ae, l as oe, n as se, o as D, t as ce, u as O } from "./dropdown-menu-BA70o7HC.js";
+import { S as le, a as k, d as A, g as ue, h as de, i as fe, m as pe, n as j, r as me, t as M, u as he, w as ge } from "./toolbar-items-BLjrk8uU.js";
+import { t as N } from "./use-material-translation-CFF73jk5.js";
+import { t as _e } from "./button-CTsT_LqL.js";
 import { n as ve, t as ye } from "./icon-button-CN9r5TNE.js";
 import { t as be } from "./useEvent-2fKq-6w8.js";
 import { n as xe, t as Se } from "./toggle-group-BMJNcFAC.js";
 import { o as Ce } from "./escape-owner-C4W_sOAU.js";
 import { n as we } from "./use-slice-reducer-BGkeGtML.js";
 import { r as Te } from "./use-csp-nonce-ZKs9k-ov.js";
-import { n as Ee, t as De } from "./empty-state-DFWq2CWB.js";
+import { n as Ee, t as De } from "./empty-state-BzwyRX5J.js";
 import { t as Oe } from "./client-only.utils-3nHNzCki.js";
 import { t as ke } from "./use-scroll-away-PQRFZkT2.js";
 import { ArrowLeft as Ae, BookOpenText as je, ChevronDown as Me, ChevronLeft as Ne, ChevronRight as Pe, ChevronUp as Fe, Download as Ie, Eraser as Le, FileText as Re, FileWarning as ze, FileX2 as Be, Highlighter as Ve, KeyRound as He, LayoutGrid as Ue, List as We, Loader2 as Ge, Maximize as Ke, MessageSquareText as qe, Minimize as Je, MoreVertical as Ye, MousePointer2 as Xe, MoveHorizontal as Ze, PanelLeft as Qe, Pen as $e, PencilLine as et, Printer as tt, RotateCw as nt, Search as rt, StickyNote as it, Type as at, Underline as ot, Undo2 as st, Volume2 as ct, X as lt, XIcon as ut, ZoomIn as dt, ZoomOut as ft } from "lucide-react";

package/dist/{rich-code-block-C4aBv4cA.js → rich-code-block-D_PTTZWQ.js}

@@ -1,7 +1,7 @@
 import { t as e } from "./tooltip-CkttDIab.js";
-import { c as t, n, t as r } from "./dropdown-menu-Crt5QvTr.js";
-import { t as i } from "./use-material-translation-CiYhVc39.js";
-import { a, i as o, n as s, o as c, t as l } from "./code-language-items-C7prxl_7.js";
+import { c as t, n, t as r } from "./dropdown-menu-BA70o7HC.js";
+import { t as i } from "./use-material-translation-CFF73jk5.js";
+import { a, i as o, n as s, o as c, t as l } from "./code-language-items-CCRuLYpA.js";
 import { i as u, n as d, r as f, s as p } from "./dist-C3GR7kJd.js";
 import { t as m } from "./code-block-spec-CGLKRhwD.js";
 import { Check as h, ChevronDown as g, Copy as _, Maximize2 as v, WrapText as y } from "lucide-react";
@@ -143,7 +143,7 @@ function M({ node: e, editor: t, updateAttributes: n, editable: r, wrap: a, onWr
 }
 //#endregion
 //#region lib/components/ui/widgets/editor/extensions/code/code-block-open.tsx
-var N = x(() => import("./code-editor-BetIXpJ6.js").then((e) => e.n).then((e) => ({ default: e.CodeEditor })));
+var N = x(() => import("./code-editor-BWn0AXBf.js").then((e) => e.n).then((e) => ({ default: e.CodeEditor })));
 function P() {
 	let { t: e } = i();
 	return /* @__PURE__ */ T("div", {

package/dist/{sortable-provider-0uBi0zcP.js → sortable-provider-CrS51nKB.js}

@@ -1,6 +1,6 @@
 import { t as e } from "./utils-BLfntITJ.js";
 import { t } from "./dist-DVRQkaTK.js";
-import { t as n } from "./use-material-translation-CiYhVc39.js";
+import { t as n } from "./use-material-translation-CFF73jk5.js";
 import { t as r } from "./icon-button-CN9r5TNE.js";
 import { t as i } from "./compose-refs-DZ0iIVF-.js";
 import { GripVertical as a } from "lucide-react";

package/dist/{spinner-CuxEwO0d.js → spinner-DLd_IHev.js}

@@ -1,6 +1,6 @@
 import { t as e } from "./utils-BLfntITJ.js";
 import { o as t } from "./tooltip-CkttDIab.js";
-import { t as n } from "./use-material-translation-CiYhVc39.js";
+import { t as n } from "./use-material-translation-CFF73jk5.js";
 import { jsx as r } from "react/jsx-runtime";
 //#region lib/components/ui/feedback/spinner/spinner.tsx
 var i = t("transition-all duration-500", {

package/dist/{stored-language-D8aemZhx.js → stored-language-B5SMR-W2.js}

@@ -2012,6 +2012,7 @@ var t = {
 			"error-hint": "Check your connection, then try again.",
 			"bulk-action": "{label} ({count})",
 			"bulk-action-name": "{label} {count, plural, one {# row} other {# rows}}",
+			"bulk-max-notice": "Select {max, plural, one {# row} other {# rows}} or fewer to {label}",
 			"bulk-more": "More"
 		},
 		"list-empty": { clear: "Clear search and filters" },
@@ -2222,6 +2223,7 @@ var t = {
 			apply: "Apply",
 			"no-range": "No dates yet",
 			"type-date": "Type the date",
+			"type-date-time": "Type the date and time",
 			"type-range": "Type the dates",
 			"select-date": "Select date",
 			"select-dates": "Select dates",
@@ -2654,6 +2656,8 @@ var t = {
 			"no-data": "No data to show",
 			loading: "Loading chart",
 			"status-value": "{series} {value}",
+			"status-value-tone": "{series} {value} ({tone})",
+			"table-tone": "{series} tone",
 			"status-point": "{label}: {values}",
 			"table-caption": "{title}: the data",
 			"status-slice": "{label}: {value}, {share}",
@@ -2697,6 +2701,20 @@ var t = {
 			"zoom-reset": "Reset zoom",
 			"zoom-showing": "Showing {from} to {to}",
 			"zoom-range": "{from} to {to}",
+			tone: {
+				primary: "Primary",
+				secondary: "Secondary",
+				tertiary: "Tertiary",
+				success: "Success",
+				info: "Info",
+				warning: "Warning",
+				error: "Error",
+				neutral: "Neutral"
+			},
+			reference: {
+				band: "{label}: {from} to {to}",
+				threshold: "{label}: {value}"
+			},
 			kind: {
 				line: "line chart",
 				area: "area chart",
@@ -2716,6 +2734,11 @@ var t = {
 				range: "{count, plural, one {# point} other {# points}}, from {first} to {last}.",
 				series: "{series}: from {start} to {end}, highest {max} ({maxAt}), lowest {min} ({minAt}).",
 				hidden: "Hidden: {series}.",
+				bands: "Reference ranges: {list}.",
+				thresholds: "Thresholds: {list}.",
+				outside: "{series}: {count} of {total, plural, one {# point} other {# points}} outside {band}.",
+				tones: "{series}: {list}, of {total, plural, one {# point} other {# points}}.",
+				"tone-count": "{count} {tone}",
 				slices: "{count, plural, one {# slice} other {# slices}}, {total} in all.",
 				largest: "Largest: {list}.",
 				slice: "{label} {value} ({share})",
@@ -4759,6 +4782,7 @@ var t = {
 			"error-hint": "Vérifiez votre connexion, puis réessayez.",
 			"bulk-action": "{label} ({count})",
 			"bulk-action-name": "{label} : {count, plural, one {# ligne} other {# lignes}}",
+			"bulk-max-notice": "Sélectionnez {max, plural, one {# ligne} other {# lignes}} ou moins pour {label}",
 			"bulk-more": "Plus"
 		},
 		"list-empty": { clear: "Effacer la recherche et les filtres" },
@@ -4969,6 +4993,7 @@ var t = {
 			apply: "Appliquer",
 			"no-range": "Aucune date",
 			"type-date": "Saisir la date",
+			"type-date-time": "Saisir la date et l’heure",
 			"type-range": "Saisir les dates",
 			"select-date": "Choisir la date",
 			"select-dates": "Choisir les dates",
@@ -5401,6 +5426,8 @@ var t = {
 			"no-data": "Aucune donnée à afficher",
 			loading: "Chargement du graphique",
 			"status-value": "{series} {value}",
+			"status-value-tone": "{series} {value} ({tone})",
+			"table-tone": "{series} : ton",
 			"status-point": "{label} : {values}",
 			"table-caption": "{title} : les données",
 			"status-slice": "{label} : {value}, {share}",
@@ -5444,6 +5471,20 @@ var t = {
 			"zoom-reset": "Réinitialiser le zoom",
 			"zoom-showing": "Affichage de {from} à {to}",
 			"zoom-range": "{from} à {to}",
+			tone: {
+				primary: "Principal",
+				secondary: "Secondaire",
+				tertiary: "Tertiaire",
+				success: "Succès",
+				info: "Information",
+				warning: "Alerte",
+				error: "Erreur",
+				neutral: "Neutre"
+			},
+			reference: {
+				band: "{label} : de {from} à {to}",
+				threshold: "{label} : {value}"
+			},
 			kind: {
 				line: "graphique en courbes",
 				area: "graphique en aires",
@@ -5463,6 +5504,11 @@ var t = {
 				range: "{count, plural, one {# point} other {# points}}, de {first} à {last}.",
 				series: "{series} : de {start} à {end}, maximum {max} ({maxAt}), minimum {min} ({minAt}).",
 				hidden: "Masquées : {series}.",
+				bands: "Plages de référence : {list}.",
+				thresholds: "Seuils : {list}.",
+				outside: "{series} : {count} sur {total, plural, one {# point} other {# points}} hors de {band}.",
+				tones: "{series} : {list}, sur {total, plural, one {# point} other {# points}}.",
+				"tone-count": "{count} {tone}",
 				slices: "{count, plural, one {# part} other {# parts}}, {total} au total.",
 				largest: "Les plus grandes : {list}.",
 				slice: "{label} {value} ({share})",

package/dist/theme-picker.js

@@ -1,10 +1,10 @@
 import { t as e } from "./utils-BLfntITJ.js";
 import { a as t, i as n, n as r, o as i, r as a, t as o } from "./bubble-input-B7BVd9fX.js";
-import { t as s } from "./use-material-translation-CiYhVc39.js";
+import { t as s } from "./use-material-translation-CFF73jk5.js";
 import { a as c, r as l } from "./icon-sprites-CaYXzOL4.js";
 import { t as u } from "./use-theme-DMcyJ52N.js";
 import { a as d, r as f } from "./theme-context-Cofk6vgs.js";
-import { t as p } from "./theme-toggle-ik5nV1P5.js";
+import { t as p } from "./theme-toggle-wJYmnwgu.js";
 import { n as m, t as h } from "./nxgt-theme-ZS945iMP.js";
 import { Check as g } from "lucide-react";
 import { useContext as _ } from "react";

package/dist/{theme-toggle-ik5nV1P5.js → theme-toggle-wJYmnwgu.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./use-material-translation-CiYhVc39.js";
+import { t as e } from "./use-material-translation-CFF73jk5.js";
 import { i as t } from "./theme-store-CSl51uNH.js";
 import { n, t as r } from "./use-theme-DMcyJ52N.js";
 import { r as i } from "./theme-context-Cofk6vgs.js";

package/dist/{toolbar-items-C97E5HRa.js → toolbar-items-BLjrk8uU.js}

@@ -4,9 +4,9 @@ import { a as i, c as a, i as o, l as s, r as c, s as l } from "./dist-lmHmz_bu.
 import { b as u, c as d, d as f, f as p, l as m, t as h, u as g, x as _ } from "./tooltip-CkttDIab.js";
 import { i as v, n as y, r as b, t as x } from "./dist-C4wtXCjf.js";
 import { a as S, c as C, l as w, o as T, r as ee, s as te, t as E } from "./in-dialog-Vwkyp-M5.js";
-import { A as ne, M as re, N as ie, b as ae, d as oe, f as se, i as ce, j as le, l as ue, n as de, o as fe, r as pe, t as me, u as he, y as ge } from "./dropdown-menu-Crt5QvTr.js";
+import { A as ne, M as re, N as ie, b as ae, d as oe, f as se, i as ce, j as le, l as ue, n as de, o as fe, r as pe, t as me, u as he, y as ge } from "./dropdown-menu-BA70o7HC.js";
 import { a as _e, n as ve, r as ye, t as be } from "./dist-B7RjY7SL.js";
-import { t as xe } from "./use-material-translation-CiYhVc39.js";
+import { t as xe } from "./use-material-translation-CFF73jk5.js";
 import { t as Se } from "./warn-once-C_e47JM8.js";
 import { o as Ce } from "./escape-owner-C4W_sOAU.js";
 import { ChevronLeft as we, ChevronRightIcon as Te, MoreVertical as Ee } from "lucide-react";

package/dist/{translate-material-B84ufMSF.js → translate-material-BYRDtSEk.js}

@@ -1,5 +1,5 @@
-import "./stored-language-D8aemZhx.js";
-import { a as e, r as t } from "./translator-Bq8UHmvu.js";
+import "./stored-language-B5SMR-W2.js";
+import { a as e, r as t } from "./translator-C-_M57ZA.js";
 //#region lib/i18n/translate-material.ts
 function n(n, r, i, a) {
 	if (n) for (let e of /* @__PURE__ */ new Set([n, n.split("-")[0]])) {

package/dist/{translator-Bq8UHmvu.js → translator-C-_M57ZA.js}

@@ -1,5 +1,5 @@
 import { t as e } from "./is-production-GLw59WU8.js";
-import { a as t, i as n, r, t as i } from "./stored-language-D8aemZhx.js";
+import { a as t, i as n, r, t as i } from "./stored-language-B5SMR-W2.js";
 import { t as a } from "./get-CTzJAwfc.js";
 //#region ../../node_modules/@formatjs/fast-memoize/index.js
 function o(e, t) {

package/dist/{use-chat-composer-DmDcEGp4.js → use-chat-composer-DrFgIE3T.js}

@@ -7,21 +7,21 @@ import { a as o, c as s, i as c, l, n as u, o as d, r as f, s as p, t as m } fro
 import { _ as h, a as g, g as _, h as v, m as y, o as b, p as x, t as S, v as C, y as w } from "./tooltip-CkttDIab.js";
 import { a as T, i as E, n as D, r as O, t as k } from "./dist-C4wtXCjf.js";
 import { i as A, n as ee, t as j } from "./in-dialog-Vwkyp-M5.js";
-import { A as M, C as N, D as te, E as ne, O as P, S as re, T as ie, _ as F, b as ae, f as oe, g as se, k as I, l as ce, m as le, n as ue, o as de, r as fe, s as pe, t as me, u as he, v as ge, w as _e, x as ve, y as ye } from "./dialog-BCsT_aLo.js";
+import { A as M, C as N, D as te, E as ne, O as P, S as re, T as ie, _ as F, b as ae, f as oe, g as se, k as I, l as ce, m as le, n as ue, o as de, r as fe, s as pe, t as me, u as he, v as ge, w as _e, x as ve, y as ye } from "./dialog-uQld1gKm.js";
 import { A as be, C as xe, D as Se, E as Ce, O as we, S as Te, T as Ee, _ as De, a as Oe, b as ke, d as Ae, f as je, g as Me, h as Ne, i as Pe, k as Fe, l as Ie, m as Le, n as Re, o as ze, p as Be, r as Ve, s as He, t as Ue, u as We, v as Ge, w as Ke, x as qe, y as Je } from "./floating-ui.dom-KkZSW8_E.js";
-import { D as Ye, E as Xe, N as Ze, O as Qe, c as $e, d as et, f as tt, i as nt, k as rt, m as it, n as at, o as ot, p as st, t as ct, u as lt } from "./dropdown-menu-Crt5QvTr.js";
+import { D as Ye, E as Xe, N as Ze, O as Qe, c as $e, d as et, f as tt, i as nt, k as rt, m as it, n as at, o as ot, p as st, t as ct, u as lt } from "./dropdown-menu-BA70o7HC.js";
 import { a as ut, i as dt, n as ft } from "./field-blur-context-Cft9s7Hg.js";
-import { C as pt, S as mt, a as ht, c as gt, d as _t, l as vt, n as yt, o as bt, s as xt, u as St } from "./toolbar-items-C97E5HRa.js";
+import { C as pt, S as mt, a as ht, c as gt, d as _t, l as vt, n as yt, o as bt, s as xt, u as St } from "./toolbar-items-BLjrk8uU.js";
 import { a as Ct, i as wt, n as Tt, o as Et, t as Dt } from "./bubble-input-B7BVd9fX.js";
 import { i as Ot } from "./dist-B7RjY7SL.js";
-import "./stored-language-D8aemZhx.js";
-import { a as kt } from "./translator-Bq8UHmvu.js";
+import "./stored-language-B5SMR-W2.js";
+import { a as kt } from "./translator-C-_M57ZA.js";
 import { h as At } from "./get-CTzJAwfc.js";
 import { t as jt } from "./isEmpty-F_g3jLf8.js";
-import { t as L } from "./use-material-translation-CiYhVc39.js";
-import { t as Mt } from "./spinner-CuxEwO0d.js";
+import { t as L } from "./use-material-translation-CFF73jk5.js";
+import { t as Mt } from "./spinner-DLd_IHev.js";
 import { a as Nt } from "./button-tones-BwuVvAmd.js";
-import { a as Pt, i as Ft, o as It, r as Lt, t as Rt } from "./button-D52ron-a.js";
+import { a as Pt, i as Ft, o as It, r as Lt, t as Rt } from "./button-CTsT_LqL.js";
 import { t as R } from "./icon-button-CN9r5TNE.js";
 import { a as zt, r as Bt } from "./icon-sprites-CaYXzOL4.js";
 import { t as Vt } from "./use-ssr-media-query-C6M5m8sf.js";
@@ -35,10 +35,10 @@ import { a as tn, i as nn, o as rn } from "./escape-owner-C4W_sOAU.js";
 import { n as an } from "./use-slice-reducer-BGkeGtML.js";
 import { t as on } from "./browser-only-DQ94lWF8.js";
 import { t as sn } from "./compose-refs-DZ0iIVF-.js";
-import { n as cn, r as ln, t as un } from "./chip-0XYwSp9o.js";
-import { n as dn, t as fn } from "./icon-badge-XBoBIt_R.js";
+import { n as cn, r as ln, t as un } from "./chip-DP7EyhtT.js";
+import { n as dn, t as fn } from "./icon-badge-D_z5BGbc.js";
 import { r as pn } from "./use-csp-nonce-ZKs9k-ov.js";
-import { t as mn } from "./empty-state-DFWq2CWB.js";
+import { t as mn } from "./empty-state-BzwyRX5J.js";
 import { t as hn } from "./skeleton-DSdtr2qc.js";
 import { H as gn, V as _n, X as vn, bt as yn, it as bn, lt as xn, n as Sn, t as Cn, xt as wn, yt as Tn } from "./dist-moutbfbd.js";
 import { t as En } from "./markdown-Dw_uH7j7.js";
@@ -10909,7 +10909,7 @@ var jS = (e = {}) => Dn({
 		let [{ default: t }, { lowlight: n }, { richCodeBlock: r }] = await Promise.all([
 			import("./dist-CRMFGjng.js"),
 			import("./lowlight-OtcjU2Sa.js"),
-			import("./rich-code-block-C4aBv4cA.js")
+			import("./rich-code-block-D_PTTZWQ.js")
 		]);
 		return [r(t, {
 			lowlight: n,

package/dist/{use-heading-spy-BgG7Q47k.js → use-heading-spy-wElRpO2G.js}

@@ -1,4 +1,4 @@
-import { r as e } from "./i18n-provider-C0RBM8rH.js";
+import { r as e } from "./i18n-provider-DkeMr5bw.js";
 import { _ as t, g as n, h as r, n as i, v as a, y as o } from "./number.utils-BG_eEt5g.js";
 import { useCallback as s, useEffect as c, useMemo as l, useRef as u } from "react";
 //#region ../../node_modules/date-fns/locale/fr/_lib/formatDistance.js

package/dist/{use-material-translation-CiYhVc39.js → use-material-translation-CFF73jk5.js}

@@ -1,5 +1,5 @@
-import { r as e } from "./i18n-provider-C0RBM8rH.js";
-import { t } from "./translate-material-B84ufMSF.js";
+import { r as e } from "./i18n-provider-DkeMr5bw.js";
+import { t } from "./translate-material-BYRDtSEk.js";
 import { useCallback as n } from "react";
 //#region lib/i18n/use-material-translation.ts
 function r() {

package/docs/README.md

@@ -9,7 +9,7 @@ detail: every option, the second example, and the traps.
 | [Components](components/README.md) | You are looking for a component — one preview per category, then one page per category |
 | [Forms](guides/forms.md) | You are building a form: the field / `*FormField` pair, React Hook Form + Zod, what each field emits, server errors, multi-step forms |
 | [Themes for your app](guides/themes.md) | You define your own themes: `defineTheme` modules, the Vite plugin's `themes` option, the `nxgt-theme` command and its CI check, the tone warnings |
-| [Charts](guides/charts.md) | You draw charts with `@nxgt/material/charts`: each chart, the shared props, zoom and phone scroll, the keyboard, accessibility, theming the `--chart-1..5` tokens, and moving off the Nivo charts, removed in 3.0 |
+| [Charts](guides/charts.md) | You draw charts with `@nxgt/material/charts`: each chart, the shared props, reference bands, thresholds and point tones, zoom and phone scroll, the keyboard, accessibility, theming the `--chart-1..5` tokens, and moving off the Nivo charts, removed in 3.0 |
 | [Cards and tiles](guides/cards-and-tiles.md) | You want a `DataTable` as a list of cards or tiles: `layout`, `renderCard`, `renderTile`, the card's one link, selection, the sort control, columns by the list's width |
 | [DataGrid](guides/data-grid.md) | You are building an editable grid: columns and editors, save modes and conflicts, resizing, hiding and reordering columns, paste, fill and series, undo, totals, long lists, phones, custom editors, CSP |
 | [Code editor](guides/code-editor.md) | You want `CodeEditor` or `CodeDiff` in a theme preset or your own (`defineCodeTheme`), several themes on one page, Monaco bundled instead of the CDN, or the new `@nxgt/material/code-editor` import (the reader look, the view props, the `ref` handle and the file tabs are in the component's own page) |

package/docs/components/data-table-filter-and-lists.md

@@ -861,12 +861,12 @@ export default function Students() {
   ```
 - **Bulk actions that count and run only their rows.** `bulkActions` also
   takes a list of `ServerTableBulkAction<T>` (`{ id, label, icon?, appliesTo?,
-  onClick, variant?, color?, loading? }`). Each button reads "Label (n)", n
+  name?, max?, maxNotice?, onClick, variant?, color?, loading? }`). Each button reads "Label (n)", n
   being the selected rows the action applies to, and is named "Label n rows"
   (`material.server-table.bulk-action` and `bulk-action-name`, English and
   French); `variant` (default `'tonal'`) and `color` (`'destructive'` for a
   destructive one) style the button, `loading` makes it busy; the type is
-  exported as `ServerTableBulkAction`. It is not rendered when n is 0, so 5 rows selected with none
+  exported as `ServerTableBulkAction`, with `ServerTableBulkContext`. It is not rendered when n is 0, so 5 rows selected with none
   archived show no "Restore". `onClick(ids, selection, rows)` receives only
   those ids and rows. An action without `appliesTo` applies to the whole
   selection: it shows the selection's size and gets every id. **Across
@@ -880,6 +880,61 @@ export default function Students() {
   (an action without it still gets every selected id). A row's snapshot is
   dropped when it is deselected, when the selection is cleared and when the
   query changes.
+
+  **Name, maximum and focus (`name`, `max`, `maxNotice`, `onClick`'s fourth
+  argument).** All three are optional and additive:
+  - `name: (count) => string` is the button's accessible name and tooltip,
+    e.g. `(n) => `Archive ${n} people``, instead of the generic "Archive 2
+    rows". Start it with the visible `label`: the button reads "Archive (2)",
+    and a name that begins with it lets speech input ("click Archive") and
+    screen readers agree (WCAG 2.5.3, Label in Name). It applies to the
+    toolbar, the phone's bar and the More menu's items alike.
+  - `max: 100` is the most rows one call takes, counted on the rows the action
+    applies to. Above it the button is replaced by `maxNotice`: a short muted
+    text, by default "Select 100 rows or fewer to archive"
+    (`material.server-table.bulk-max-notice`, English and French), or your own
+    node or `(count, max) => node`. The notice is told politely once, when the
+    action goes past `max`; moving from 101 to 102 rows says nothing more.
+    Under `max` again, the button returns. On a phone an action in the bar
+    shows the notice inline; one in the More menu is a disabled item whose
+    notice is its description (`aria-describedby`), so it reads under its label.
+  - `onClick(ids, selection, rows, { trigger, focusTrigger })`: `trigger` is the
+    button the action started from (the "More" button for a More-menu item),
+    and `focusTrigger()` gives it the focus back, found again at call time, so
+    it works after a re-render. When the action is gone by then (its count fell
+    to 0, or past `max`) the focus goes to the next bulk action, else "More",
+    else the table's "Select all" (the table itself without one), never the
+    body. A handler that takes three parameters stays valid.
+  ```tsx
+  const [confirm, setConfirm] = useState<{ ids: string[]; focus: () => void } | null>(null);
+  <ServerTable<Person>
+    {...props}
+    bulkActions={[
+      {
+        id: 'archive',
+        label: 'Archive',
+        appliesTo: (person) => !person.archived,
+        name: (n) => `Archive ${n} ${n === 1 ? 'person' : 'people'}`,
+        max: 100,
+        onClick: (ids, _selection, _rows, { focusTrigger }) =>
+          setConfirm({ ids, focus: focusTrigger }),
+      },
+    ]}
+  />
+  <Dialog open={confirm != null} onOpenChange={(open) => !open && setConfirm(null)}>
+    <DialogContent
+      // Without this, the focus goes back to what Radix remembers, which is
+      // gone when the action was in the More menu or has disappeared.
+      onCloseAutoFocus={(event) => {
+        event.preventDefault();
+        confirm?.focus();
+      }}
+    >
+      {/* … */}
+    </DialogContent>
+  </Dialog>
+  ```
+
   ```tsx
   <ServerTable<Item>
     {...props}
@@ -932,7 +987,7 @@ Its props are `ServerTableProps<T>`; `filter` is a `ServerTableFilter`,
 | `error` | `ServerTableError \| null` | — | the fetch failed: the failure and a Retry replace the rows |
 | `onRetry` | `() => unknown` | — | the error's Retry; a returned promise keeps it loading |
 | `onClearFilters` | `() => void` | focus the table | without `filter`, after "clear" |
-| `bulkActions` | `(ids, selection: ServerTableSelection) => ReactNode \| ServerTableBulkAction<T>[]` | — | the selection's toolbar: your own buttons, or a list of actions with `appliesTo` that each count and run only the rows they apply to |
+| `bulkActions` | `(ids, selection: ServerTableSelection) => ReactNode \| ServerTableBulkAction<T>[]` | — | the selection's toolbar: your own buttons, or a list of actions (`appliesTo`, `name`, `max`, `maxNotice`; `onClick` also gets a `ServerTableBulkContext`) that each count and run only the rows they apply to |
 | `enableRowSelection`, `rowSelectionDisabledReason` | `boolean \| (row) => boolean`, `(row) => string \| undefined` | all rows, no reason | with `bulkActions`: which rows can be selected, and why one cannot ([DataTable](#datatable)) |
 | `pageHref` | `(params) => string` | `` `?${params}` `` | Previous / Next hrefs |
 | `pagingNames` | `{ after?, trail? }` | `after`, `trail` | the cursor's params |
@@ -965,7 +1020,7 @@ rows (the bulk bar is not drawn under it). With the declarative list form of
 line rather than scroll, and past the third action the rest go into a "More"
 menu (`material.server-table.bulk-more`), each item keeping its count. From
 768px the buttons read "Label (n)" as before. When the focused button
-disappears the focus goes to the next one, else to "Select all". The function
+disappears the focus goes to the next one, else to "More", else to "Select all"; an action past `max` shows its notice there (an inline text, or a disabled More item). The function
 form (`bulkActions={(ids) => node}`) is drawn whole in the row, so keep it to
 one or two compact buttons; the footer's polite status still tells the selection once. The cards'
 own list bar row is gone in this layout; the names, the sort menu and the

package/docs/components/date-and-time.md

@@ -177,7 +177,9 @@ export function Delivery() {
 | `onValueChange` | `(value?: Date) => void` | — | `undefined` when the day is unselected |
 | `entry` | `'typed'` | — | deprecated, no effect: the date is always typed in segments, with a button that opens the calendar (`'button'`, the 2.x trigger, was removed in 3.0) |
 | `clearable` | `boolean` | `!required` | a ✕ (named "Clear") that empties the typed field; shown only while it holds a date and is not `disabled` |
-| `showTimePicker` | `boolean` | — | adds a `TimePicker` and an OK button; the popover stays open. The time is picked there, not typed: the tiles, beside the calendar from 768px and under it in a sheet, with a Cancel button |
+| `showTimePicker` | `boolean` | — | adds the time of day (a day click in the calendar keeps it): its hours and minutes (and AM / PM on a 12-hour clock) are typed in segments after the date, and a `TimePicker` with an OK button and a Cancel button sits beside the calendar from 768px and under it in a sheet; the popover stays open. Typed and picked are one value. The field has a value once the date and the time are both complete (see [Time zones and typed time](#time-zones-and-typed-time)) |
+| `hourCycle` | `12 \| 24` | the language's | the clock of the typed time and of the picker (English 12, French 24); with `showTimePicker` |
+| `timeZone` | IANA name (`'Europe/Paris'`) | the machine's zone | the field reads and writes the wall clock of that zone; `value` and `onValueChange` stay the true instant ([below](#time-zones-and-typed-time)) |
 | `placeholder`, `label`, `helperText`, `error`, `required` | | — | `label` and `helperText` sit beside the field; `error` and `required` its state. `placeholder` names a field with no label |
 | `disabled` | `boolean` | — | disables the field: no segment takes a key and the calendar cannot be opened |
 | `disabledDays` | react-day-picker's `Matcher \| Matcher[]` | — | days that cannot be picked (the calendar's `disabled`), e.g. `{ dayOfWeek: [0] }` |
@@ -257,6 +259,77 @@ resized, a phone turned) keeps the field as it is: a partial entry stays,
 and so do the "Open calendar" button and its focus; an open picker keeps
 the focus when it moves between the popover and the sheet.
 
+### Time zones and typed time
+
+With `showTimePicker` the trigger reads `mm / dd / yyyy  09 : 30 AM` (the
+locale's order and clock; `hourCycle` forces one). The time is typed like the
+date: digits move on once a segment is full, a separator or an arrow moves
+between segments, ArrowUp and ArrowDown step the focused one (wrapping), "a"
+or "p" sets AM / PM, and a pasted "07/01/2026 9:30 PM" fills all of them. The
+segments are in one `group` named by the label; "Hours", "Minutes" and
+"AM / PM" are `spinbutton`s like the date's. On a phone, where the segments
+are 44px wide, the time wraps whole under the date when the two do not fit.
+
+A value needs the date and the time both complete: while one segment is empty
+the field emits `undefined` (a partial entry stays on screen), so a form's
+`required` rule refuses it, says so in the helper text and marks every segment
+`aria-invalid`, exactly as for a half-typed date. The calendar, the tiles and
+the segments edit the same value: a day picked in the calendar keeps the time
+of day, and a time typed shows in the tiles when the picker opens. (Before,
+with `showTimePicker`, a day picked in the calendar put the time back to
+midnight.) On the phone's sheet the pencil's large field takes the time too
+and is named `material.dates.type-date-time`.
+
+`timeZone` (an IANA name such as `Europe/Paris`) makes the field a form for the
+wall clock of that zone, whatever zone the browser runs in:
+
+| | |
+| --- | --- |
+| `value`, `onValueChange` | the true instant, a `Date`, as without `timeZone` |
+| Shown | the instant's wall clock in the zone: `2026-07-01T07:30:00Z` is `09:30` for `Europe/Paris` and `03:30` for `America/Toronto` |
+| Typed or picked | read as the zone's wall clock: `09:30` typed with `Europe/Paris` emits `07:30Z` in summer and `08:30Z` in winter |
+| `minDate`, `maxDate` | instants, compared as the days they fall on in the zone |
+| `disablePast`, `disableFuture`, today's mark | today in the zone, not the machine's |
+| `disabledDays` | `Date`s in a matcher are the days they fall on in the zone; a function sees the zone's days |
+| Unknown name | read as `UTC` (as `ZonedTime` does) |
+| No `timeZone` | the machine's zone, as before |
+
+Daylight-saving changes have one rule each, the one of Temporal's
+`compatible` mode:
+
+- **A time that does not exist** (the clocks go forward: 02:30 on 29 March
+  2026 in `Europe/Paris`) is read with the offset in force before the gap, so
+  it lands the length of the gap later: 03:30. The field shows 03:30 right
+  away.
+- **A time that happens twice** (the clocks go back: 02:30 on 25 October 2026
+  in `Europe/Paris`) is the first occurrence, `00:30Z`. If the value being
+  edited already is the second occurrence (`01:30Z`), editing its minutes
+  keeps the second one, so the time never jumps an hour back under the typing.
+
+The server renders the wall clock from `Intl` with the explicit zone, never
+from the machine, so the HTML hydrates identically whatever zone the server
+and the browser run in. Inside, the wall clock is a floating date (read
+through UTC), so a time the browser's own clocks skip (02:30 Paris on the
+day Toronto springs forward) is shown, typed and picked as it is. A
+`disabledDays` matcher that holds a `Date` (`Date`, `{ before }`,
+`{ after }`, `{ from, to }`, and lists of them) names the days those instants
+fall on in the zone; a function matcher is given the zone's days. With no
+value, a time picked first is dated today in the zone and must pass the
+bounds (`disablePast`...).
+
+```tsx
+<DateField
+	label="Starts"
+	timeZone="Europe/Paris"
+	showTimePicker
+	value={startsAt}
+	onValueChange={setStartsAt}
+	disablePast
+/>
+```
+
+`DateFormField` takes the same props. `DateRangeField` has no `timeZone` (react-day-picker's own `timeZone` prop is no longer accepted by `DateField` or `DateRangeField`: use `DateField`'s `timeZone`, or drop it from a range).
+
 ### Pickers' surfaces
 
 The popover has 28px corners, a soft lift and 12px of
@@ -277,7 +350,7 @@ Storybook: `Date & time/Pickers surfaces/Phone sheet`, `/Popover` and `/Cancel`.
 **Emits:** `Date | undefined`.
 **Form wrapper:** `DateFormField` — `control` and `name`, see
 [forms](../guides/forms.md#the-pair) and [what each field emits](../guides/forms.md#what-each-field-emits).
-**Storybook:** `Date & time/DateField`, `Date & time/DateField/Typed entry`, `Date & time/DateField/Phone sheet` · **Vue:** `DateField`, `DateFormField` (`disabled-days`, same rules; the 2.x trigger only, no typed entry)
+**Storybook:** `Date & time/DateField`, `Date & time/DateField/Typed entry`, `Date & time/DateField/Time zone`, `Date & time/DateField/Phone sheet` · **Vue:** `DateField`, `DateFormField` (`disabled-days`, same rules; the 2.x trigger only, no typed entry)
 
 ---
 
@@ -587,6 +660,7 @@ export function OpensAt() {
 | `value` | `Date` | — | only the hours and minutes are shown |
 | `onValueChange` | `(value?: Date) => void` | — | on every hour, minute or AM / PM change |
 | `size` | `'default' \| 'sm'` | `'default'` | `'sm'` is the compact 36px box (the field radius is unchanged) |
+| `timeZone` | IANA name (`'Europe/Paris'`) | the machine's zone | the segments and the picker show the value's wall clock in that zone and what is typed or picked is read in it; `value` and `onValueChange` stay the true instant. The time lands on the value's day in the zone (today in the zone with no value). The same rules as `DateField`'s ([Time zones and typed time](#time-zones-and-typed-time)): a time skipped by the clocks moves to the end of the gap, a repeated one is the first, unless the value holds the second. `TimeFormField` takes it too; with `asString` the `'HH:mm'` string is the wall clock itself and `timeZone` has no effect, and `TimeStringField` has none |
 | `variant`, `hourCycle`, `minuteStep` | | `'tiles'`, the language's, `5` | passed to the `TimePicker` ([below](#timepicker)); `hourCycle` sets the segments' clock too |
 | `entry` | `'typed'` | — | deprecated, no effect: the time is always typed in segments, with a button that opens the picker (`'button'`, the 2.x trigger, was removed in 3.0) |
 | `clearable` | `boolean` | `!required` | a ✕ (named "Clear") that empties the typed field; shown only while it holds a time and is not `disabled` |
@@ -647,7 +721,7 @@ unchanged.
 state.
 **Form wrapper:** `TimeFormField` — `control` and `name` (plus `asString`), see
 [forms](../guides/forms.md#the-pair) and [what each field emits](../guides/forms.md#what-each-field-emits).
-**Storybook:** `Date & time/TimeField`, `Date & time/TimeField/Typed entry`, `Date & time/TimeField/Phone sheet` · **Vue:** `TimeField`, `TimeFormField` (the 2.x trigger only, no typed entry)
+**Storybook:** `Date & time/TimeField`, `Date & time/TimeField/Typed entry`, `Date & time/TimeField/Time zone`, `Date & time/TimeField/Phone sheet` · **Vue:** `TimeField`, `TimeFormField` (the 2.x trigger only, no typed entry)
 
 ---
 

package/docs/components/rich-widgets.md

@@ -278,6 +278,12 @@ import { LineChart } from '@nxgt/material/charts';
 />;
 ```
 
+A line chart can be read against a reference: `bands` shade a range of the
+value axis (a normal range), `thresholds` draw labelled lines and `pointTone`
+rings the values that need a word, which the tooltip, the summary and the
+"View data" table repeat
+([guide](../guides/charts.md#reading-values-against-a-reference)).
+
 Parts: `LineChart`, `AreaChart`, `BarChart`, `PieChart`, `DonutChart`, `Gauge`,
 `RadialBarChart`, `FunnelChart`, `HeatmapChart`, `RadarChart`, `ScatterChart`,
 `ComboChart`.