@nxgt/material 3.52.0 → 3.54.0

package/docs/roadmap.md

@@ -6,6 +6,19 @@ version they shipped in, and planned entries may name the major they target.
 
 ## Now
 
+- **Toast texts follow app translations** — the toast presets read the
+  app's `I18nProvider` `resources`, so an override under `material.*`
+  changes their wording ([#1855](https://github.com/softistx/nxgt-material/issues/1855)).
+- **Smaller, easier-to-read components** — the library's own source is kept
+  to files under 200 lines and functions under 80, so a component is quicker to
+  read and to fix ([#1865](https://github.com/softistx/nxgt-material/issues/1865)).
+- **DataGrid: one column, several kinds of row** — `meta.rowEditor(row)` picks
+  the built-in editor from the row, and `meta.options` and
+  `meta.number.decimals` take the row, so a result column can be a bounded
+  number, a pick among the row's own options or a text
+  ([#1892](https://github.com/softistx/nxgt-material/issues/1892),
+  [guide](guides/data-grid.md#one-column-several-kinds-of-row)).
+
 - **Dense pages on large screens** — a record's page shows more on a 1440 or
   1920 px screen instead of stretching the same fields. `DescriptionList` lays
   a record's fields in `auto-fill` columns (`minItem`, `maxColumns`, a `meta`
@@ -137,84 +150,89 @@ version they shipped in, and planned entries may name the major they target.
 
 ## Next
 
+- **FilterBar "Add a filter" stays on its row** — the button no longer wraps
+  alone onto a second row on a desktop screen ([#1752](https://github.com/softistx/nxgt-material/issues/1752)).
+
 - **`ButtonGroup` standard look by default, and the old `Typography` names
   removed (4.0)** — `ButtonGroup`'s Material 3 Expressive look (`look="standard"`)
   becomes the default, with `look="legacy"` to keep the original group. The
   fifteen deprecated `Typography` variants (`huge-*`, `headline-larger`,
   `headline-large`... `caption`) are removed in favour of the type scale's
   names, once the other component families read the scale
-  ([Typography](components/primitives.md#typography)).
+  ([Typography](components/primitives.md#typography)). Tracked in [#1872](https://github.com/softistx/nxgt-material/issues/1872).
 
 - **IconButton: `round` or `square` like Button** — a `shape` of `round` or
   `square` on `IconButton`, with the same press morph, beside the expressive
-  shape names it takes today.
+  shape names it takes today ([#1450](https://github.com/softistx/nxgt-material/issues/1450)).
 
 - **DataGrid: row selection on phones** — the phone list gets the selection
   control the grid has with `enableRowSelection`: a checkbox per item and a
-  select-all, with the same `rowSelection` state.
+  select-all, with the same `rowSelection` state. Tracked in [#1873](https://github.com/softistx/nxgt-material/issues/1873).
 - **Players that take children** — `MediaPlayer` and `AudioPlayer` accept
   children rendered inside the player's provider, so `MediaTranscript` and
   `useMediaPlayer` work next to a player without a `MediaPlayerHost`
   ([#1023](https://github.com/softistx/nxgt-material/issues/1023)).
 - **Connected date and time pickers** — the calendar or time picker of a
-  date or time field opens connected to the field, as a `Select` list does.
+  date or time field opens connected to the field, as a `Select` list does
+  ([#1870](https://github.com/softistx/nxgt-material/issues/1870)).
 - **Your own tiptap and ProseMirror classes in custom features** — a subpath
   re-exporting the editor's own tiptap and ProseMirror classes, so a custom
   feature can use `instanceof` and build nodes with the editor's copy
-  (additive).
+  (additive). Tracked in [#1874](https://github.com/softistx/nxgt-material/issues/1874).
 - **The built-in toolbars on `Toolbar`** — `DataTable`, `PdfReader`,
   `Calendar` and the notifications panel get one tab stop
   and arrow keys (the WAI-ARIA toolbar pattern), the shared look and overflow
-  into a More menu.
-- **DataGrid, wave 2: rows and finding** — add and delete rows, filters inside
-  the grid, and find and replace.
-- **DataGrid, wave 3: more cells and more context** — more cell types, grouped
-  headers, conditional tints and comments on cells.
+  into a More menu. Tracked in [#1875](https://github.com/softistx/nxgt-material/issues/1875).
+- **DataGrid: rows, finding and richer cells** — add and delete rows, filters
+  inside the grid, find and replace, more cell types, grouped headers,
+  conditional tints and comments on cells ([#1877](https://github.com/softistx/nxgt-material/issues/1877)).
 - **Segmented `Progress`** — a steps variant of the bar, for a quiz or a
-  wizard: one segment per step, filled as the user moves through.
+  wizard: one segment per step, filled as the user moves through
+  ([#1868](https://github.com/softistx/nxgt-material/issues/1868)).
 - **Upload components in the Progress style** — `FileList`,
   `NetworkUploadField` and `S3UploadField` redesigned like the Progress upload
-  example: a file tile with the name and percent above a wavy bar.
+  example: a file tile with the name and percent above a wavy bar
+  ([#1869](https://github.com/softistx/nxgt-material/issues/1869)).
 - **PDFs generated without React** — a framework-free engine on pdfkit replaces
   `@react-pdf/renderer`, so a document renders the same in React, Vue, Node, Bun
   and the browser. One data API, `definePdfDocument`, everywhere (the `Print*`
   JSX components leave later, see Later). Output is tagged for
   accessibility (PDF/UA), archival (PDF/A-3) and electronic invoicing (Factur-X,
-  EN 16931). It also brings the items below.
+  EN 16931). It also brings the items below. Tracked in [#1878](https://github.com/softistx/nxgt-material/issues/1878); tagged output also [#1468](https://github.com/softistx/nxgt-material/issues/1468).
 - **Your brand on the page** — a print theme whose defaults follow the screen
   theme, and your own font files registered in one call (the font half ships:
   `registerPdfFont` and `theme.fonts` on the current renderer; the library
-  bundles no fonts).
+  bundles no fonts). Tracked in [#1878](https://github.com/softistx/nxgt-material/issues/1878).
 - **QR codes, barcodes and charts in a PDF** — pass the value or the chart
-  options and get vector output, no data URL to prepare.
+  options and get vector output, no data URL to prepare. Tracked in [#1878](https://github.com/softistx/nxgt-material/issues/1878).
 - **Rich text and Markdown in a PDF** — the rich-text editor's content and
-  Markdown rendered as PDF headings, paragraphs, lists, tables and links.
+  Markdown rendered as PDF headings, paragraphs, lists, tables and links. Tracked in [#1878](https://github.com/softistx/nxgt-material/issues/1878).
 - **A live preview inside `PdfReader`** — `PdfReader` takes a document and
-  renders it itself, refreshing a moment after its data stops changing.
+  renders it itself, refreshing a moment after its data stops changing. Tracked in [#1878](https://github.com/softistx/nxgt-material/issues/1878).
 - **Test helpers for generated PDFs** — read a generated PDF's text, page count
-  and metadata in a unit test, without a browser.
+  and metadata in a unit test, without a browser. Tracked in [#1878](https://github.com/softistx/nxgt-material/issues/1878).
 - **Archive-ready PDFs** — PDF/A-3 output through one option (the PDF/A-1/2/3
   marker ships already through `conformance` on the current renderer), for invoices and
-  records that must be kept.
+  records that must be kept. Tracked in [#1878](https://github.com/softistx/nxgt-material/issues/1878).
 - **Electronic invoices (Factur-X)** — an invoice PDF that carries its
   machine-readable data (EN 16931), built on archive-ready PDFs and the
-  invoice template, for e-invoicing mandates such as France's.
+  invoice template, for e-invoicing mandates such as France's. Tracked in [#1878](https://github.com/softistx/nxgt-material/issues/1878).
 - **A PDF reader that annotates and fills forms** — the redesigned
   `PdfReader` (see Now) gains the rest of its plan: viewers add their own
   annotations (highlight, underline, pen, note, text, eraser), held as JSON in
   `value` / `onChange` and exportable into the PDF; fill AcroForms; hear the
   text read aloud; or switch to a reflowed text mode. Annotation export loads
   `pdf-lib` only when used. The same reader in `@nxgt/material-vue` is not
-  planned until requested.
-- **Dark-mode previews** — each component preview also shown in the dark theme,
-  so you can check contrast without running it.
-- **Previews that cannot go stale** — a CI check that fails when a story changes
-  but its preview image does not, so the picture in the docs is the component
-  you install.
+  planned until requested. Tracked in [#1878](https://github.com/softistx/nxgt-material/issues/1878).
+- **Dark-mode previews** — each component preview in the docs is also shown in
+  the dark theme, so you can check contrast without running it ([#1866](https://github.com/softistx/nxgt-material/issues/1866)).
+- **Previews that match the component** — the picture in the docs is always the
+  component you install, because a changed story cannot ship with its old
+  preview ([#1867](https://github.com/softistx/nxgt-material/issues/1867)).
 - **`ViewTabs`: saved views over the filter bar** — tabs of saved filters
   ("All", "My students") with a count each, using the filter bar's `counts`
   slot; the bar's `views` slot is planned with it. They are meant to replace
-  the legacy `FilterPresets`.
+  the legacy `FilterPresets`. Tracked in [#1876](https://github.com/softistx/nxgt-material/issues/1876).
 
 ## Later
 
@@ -330,6 +348,42 @@ version they shipped in, and planned entries may name the major they target.
 
 ## Shipped
 
+- **Dark cards that separate from the page ground (3.54.0)** — in dark mode, cards,
+  popovers and dialogs lift off the page ground (lighter surfaces and a `--card-edge`
+  hairline), light unchanged ([#1676](https://github.com/softistx/nxgt-material/issues/1676)).
+- **Compact `ServerTable` tiles** — `renderTile` shows a compact `ListTile`
+  record row (`size="sm"` with chips) through `item.Row` ([#1766](https://github.com/softistx/nxgt-material/issues/1766)).
+- **A compact `Switcher` trigger, `size="compact"`** — an icon-only round
+  button sized for the app bar's `titleAfter` slot, where the title already
+  names the current item; the chosen option stays in its accessible name and
+  tooltip ([#1789](https://github.com/softistx/nxgt-material/issues/1789)).
+
+- **Toast and translation overrides, `I18nProvider` `resources`** (3.52.0) —
+  `I18nProvider` takes `resources`, the app's `mergeResources(...)` result,
+  and components read their `material.*` words from it, so an app
+  translation changes the wording, except the toast presets and the close
+  label ([#1855](https://github.com/softistx/nxgt-material/issues/1855)) ([#1840](https://github.com/softistx/nxgt-material/issues/1840)).
+- **Fixes for empty and unstable cases** (3.52.0) — `Description` with only
+  `children` renders them ([#1641](https://github.com/softistx/nxgt-material/issues/1641)); `ChangeHistory` draws no empty
+  list for an entry without `changes` ([#1648](https://github.com/softistx/nxgt-material/issues/1648)); `useColumnHelpers`
+  keeps `columnHelper` stable across renders ([#1644](https://github.com/softistx/nxgt-material/issues/1644)); after a
+  throttled "Resend" the code field of `StepUpDialog` and `VerificationCode`
+  takes the focus.
+- **A scroll cue that stays inside its tabs** (3.52.0) — the scroll cue of an
+  overflowing `TabsList` is clipped to the list and no longer takes taps aimed
+  at the content under it on a phone ([#1824](https://github.com/softistx/nxgt-material/issues/1824)).
+- **A selection band on `ServerTable`** (3.51.0) — with `bulkActions` and
+  `filter`, the first selected row turns the filter band into a selection bar
+  in place: "N selected", the bulk actions and a tonal "Cancel"
+  ([#1718](https://github.com/softistx/nxgt-material/issues/1718)). A backdrop shape no longer flashes behind body text on a
+  reload ([#1720](https://github.com/softistx/nxgt-material/issues/1720)).
+- **`StepUpDialog` `onRetry`** (3.50.0) — the dialog tells the app when the
+  user retries ([#1831](https://github.com/softistx/nxgt-material/issues/1831)). `PageFooter` takes `hideOnSinglePage`;
+  `IconButton` and `RowMenuTrigger` take a `label`; `effectiveConditions` and
+  `splitFilterErrors` are re-exported for a server loader; the touch hit areas
+  of `static` close buttons, a quick `switch` filter and the no-match state of
+  a filtered `ServerTable` are fixed.
+
 - **A status board of tiles** (3.49.0) — `ActionCard` gains `status` (a soft badge line),
   `meta` (one line, its tooltip only while clipped), a trailing `action` (a
   `RowMenu`, an `IconButton`) outside the press surface, and `variant="tile"`
@@ -351,7 +405,7 @@ version they shipped in, and planned entries may name the major they target.
   [Filter errors](components/data-table-filter-and-lists.md#filter-bar) ·
   [Troubleshooting](troubleshooting.md)
 
-- **Stepper and Timeline, expressive** — both have a new look by default, with
+- **Stepper and Timeline, expressive** (3.47.0) — both have a new look by default, with
   the same props. `Stepper` shows the current step as a cookie, a completed one
   as a circle with a check and a failed one in the error container, joined by
   thick tracks that fill with a spring; below `sm` a header card ("Step 3 of
@@ -365,7 +419,7 @@ version they shipped in, and planned entries may name the major they target.
   twin is a `vue` issue.
   [Stepper](components/navigation-and-layout.md#stepper) ·
   [Timeline](components/data-display.md#timeline)
-- **Two-step verification** — the pieces every app rebuilt for a one-time
+- **Two-step verification** (3.46.0) — the pieces every app rebuilt for a one-time
   code. `VerificationCode` is the form (app or e-mailed code, "Use a recovery
   code", resend, wrong with the tries left, expired, busy, locked, throttled
   with `retryAfter`: Resend waits, and waits again if it is answered throttled
@@ -381,7 +435,7 @@ version they shipped in, and planned entries may name the major they target.
   [VerificationCode](components/form-fields.md#verificationcode) ·
   [StepUpDialog](components/feedback-and-status.md#stepupdialog) ·
   [EnrolmentCard](components/data-display.md#enrolmentcard)
-- **One filter model: defaults, a scope, a refusal, `FilterBar`** — a filter
+- **One filter model: defaults, a scope, a refusal, `FilterBar`** (3.28.0) — a filter
   field says what an absent value means and what role it plays, so a list can
   start narrowed and a page can keep a value the user never clears.
   `default` (values, or `'page'` with `defaults` from the loader) is shown but
@@ -397,658 +451,5 @@ version they shipped in, and planned entries may name the major they target.
   [A field's default](components/data-table-filter-and-lists.md#a-fields-default) ·
   [A scope field](components/data-table-filter-and-lists.md#a-scope-field) ·
   [Server lists in the URL](guides/server-lists-url.md)
-- **Display polish** — `Badge` is a status badge: a 20 px pill with the
-  `label-sm` text and no hover, a `soft` variant (the tone's container under
-  the tone's text, 4.5:1) and a `tone` prop for `soft` and `outlined`, taking
-  your own tones too; `CountBadge` keeps its own size. `ListTile` with an
-  `href` ends with a discreet chevron (`chevron={false}` opts out). `StatCard`
-  gets a compact `size="sm"` tile and `EntityHeader` a `stats` prop that shows
-  figures as these tiles. `Banner` takes `Alert`'s look. A footer `MenuItem`
-  can be `display: 'icon'`, a round icon-only button with a tooltip, 44 px on
-  a touch screen; the rail's active label is drawn in a darker primary so it
-  reads 4.5:1 on every theme preset. `breadcrumb={false}` hides the trail, and
-  so does a trail whose crumbs all render `null` (#1475). `Combobox` rows are
-  touch-sized on a touch screen (#1474). The backdrop's shapes are hidden while
-  they lie over the page's text or controls, never moved (#1478). Nothing
-  changes in core. React only; the
-  Vue port is a `vue` issue. Ships in 3.12.0.
-  ([Data display](components/data-display.md),
-  [App shell](guides/app-shell.md))
-
-- **Buttons and the type scale in Material 3 Expressive** — `Typography` takes
-  the Material 3 scale (`display`, `headline`, `title`, `body`, `label`, each
-  `lg`, `md` and `sm`, plus `emphasized`) as Tailwind tokens: `text-title-md`
-  and `text-title-md-em` are utilities, and an app or a zone retunes a step
-  with CSS variables. The former variants are deprecated aliases (their sizes
-  changed) and the bare `h1` to `h6` read the scale. `Button` gains the `xl`
-  (56 px) and `2xl` (96 px) sizes, `shape` `round` or `square` with a spring
-  press morph, and `selected` (a toggle with an inverted shape and a solid
-  fill); every button has a 2 px focus outline, a neutral disabled look and a
-  44 px hit area on a coarse pointer. `IconButton` gets `size` `xs` to `xl`
-  and `width` `narrow`, `default` or `wide`, on Button's look and the shared
-  toggle fill. `ButtonGroup` gets `look="standard"` (the pressed button widens,
-  its neighbours give the width back) and a `size` its buttons share. Nothing
-  changes in core. React only; the Vue port is a `vue` issue. 3.11.0.
-  ([Buttons & actions](components/buttons-and-actions.md),
-  [Typography](components/primitives.md#typography),
-  [Type scale](guides/theming.md#type-scale))
-
-- **Icon backgrounds, celestial presets and illustrations** — `Background
-  preset="icons"` draws a pattern of icons from the packs, `iconStyle` taking
-  one style or a list and `iconMotif` choosing the layout.
-  `IconSpritesProvider` serves the Font Awesome sprites from your own base (the
-  package ships none). Four celestial presets (`eclipse`, `meteor-shower`,
-  `ringed-planet`, `northern-lights`) and a `sky` overlay join the
-  backgrounds. `Illustration` draws 12 base scenes, and the health and
-  education sets (10 scenes each) come from their own subpaths,
-  `@nxgt/material/illustrations/health` and
-  `@nxgt/material/illustrations/education`; `IllustrationDefaults` sets the
-  look once for a subtree. A theme can name an icon motif, and the theme
-  picker's tile shows it. The teal preset's success hue is fixed (#1411).
-  React only. 3.9.0. ([Icon motifs](guides/icon-motifs.md))
-
-- **Themes** (in the next prerelease) — 14 ready-made themes (Lavande, the
-  default, then Océan, Forêt, Ambre, Ardoise, Corail, Menthe, Prune, Sable,
-  Slate, Pink, Bleu mono, Blue moon and Teal) as stylesheets,
-  `@import "@nxgt/material/themes/<name>.css"` after `styles.css`, each with
-  light and dark and each also usable on a single element: `[data-nxgt-theme]`
-  makes a zone that paints its own text. `NxgtThemeProvider`, `NxgtTheme` and
-  `useThemeContext` in `@nxgt/material/themes` hold the registry and the
-  persisted choice; `useTheme()` gains `themeName` and `setThemeName`, shared
-  across components and tabs and hydration-safe. `Background` and
-  `ActivityLayout` take the theme's background, and `ThemePicker`
-  (`@nxgt/material/theme-picker`, with its opt-in `theme-picker.css`) is a
-  radiogroup of theme tiles beside the light / dark / system control. Define
-  your own with `defineTheme()` from one to three seed colours: the Vite
-  plugin's `themes` option (or the `nxgt-theme` command) writes the CSS and
-  typings and adds the boot script. The page is white in light and a shared
-  night in dark for every theme (`neutrals: 'tinted'` brings back a tinted
-  page). `Background` also draws a `moon` preset.
-  Four behaviour changes: a wrapper that overrides `--color-*` no longer
-  recolours utilities (set `--primary`, or use a theme), `ActivityLayout`
-  `backdrop={false}` now draws a plain page, `class="dark"`, `data-theme="dark"`
-  or a token such as `--primary:` on a sub-element now recolours the utilities
-  below it, and the default page is white in light and a shared night in dark
-  (see above). React only; the Vue port is on the Vue roadmap.
-  ([Theming](guides/theming.md#themes), [Themes for your app](guides/themes.md))
-
-- **44 `Background` presets, and 22 motif shapes** — `Background` from
-  `@nxgt/material/backgrounds` draws six light presets (`rays`, `halo`,
-  `plasma`, `glass`, `ripples`, `blobs`), six geometry presets (`hexagons`,
-  `circuit`, `graph-paper`, `checker`, `diagonal-checker`, `chevrons`), four
-  textures discreet enough under body text (`paper`, `linen`, `concrete`,
-  `marble`) and eight illustrated line-art scenes (`school`, `night-sky`,
-  `bubbles`, `leaves`, `science`, `music`, `travel`, `sport`), beside the
-  existing ones. The motif shapes grow from seven to 22 (`MOTIF_SHAPES_ALL`:
-  `star`, `heart`, `hexagon`, `diamond`, `wave`, `zigzag`, `spiral` and eight
-  Material 3 Expressive shapes such as `m3-flower`); the default stays the
-  first seven, so existing backgrounds draw as before. The textures and the
-  scenes cap `vivid` at the default intensity so body text stays readable.
-  Every preset follows `tone`, `intensity` and the theme, is seeded where
-  random, and moves only with `animated`. React only. 3.4.0.
-  ([Backgrounds guide](guides/backgrounds.md))
-
-- **Tailwind 4 animation API** — `animate-*` classes in `styles.css`, pure CSS
-  and completed by Tailwind IntelliSense, with the Material 3 Expressive
-  springs and durations by default: entrances and exits (fade, slide, scale,
-  pop, blur, flip, rotate, expand and collapse), attention seekers, loops and
-  ambient motion (a skeleton `shimmer`, `marquee`, `float`…), stagger on a
-  parent (`animate-stagger-100`, from `sibling-index()` or your own `--nx-anim-index`), text
-  reveals, scroll-driven animation in native CSS (`animate-on-view`,
-  `animate-scroll-progress`) and appear/disappear for popovers, dialogs and the
-  `hidden` class. One set of modifiers tunes them all: duration, delay, ease,
-  repeat, direction, fill and distance. Under reduced motion an entrance is a
-  150ms fade and attention, loops and scroll do not run. It sits next to
-  `tw-animate-css` and Tailwind's own `animate-spin`, `animate-pulse`,
-  `animate-bounce` and `animate-ping`, which it leaves alone. React only. The
-  Storybook catalogue has a searchable Overview.
-  ([Animations](guides/animations.md))
-
-- **3.0: React 19.3, a route transition, and the 2.x deprecations removed** —
-  React 19.3 and React Router 8.5 are required peers. `ActivityLayout` animates
-  route changes with React's `<ViewTransition>`, on by default
-  (`routeTransition`, `false` to opt out); the browser-only parts, `clientOnly()`
-  and a few hidden inputs, bail out with `use(browser())`, so the server HTML
-  carries a client-render marker; and the Gallery's tile-to-lightbox morph
-  runs on React's `<ViewTransition>` too. Removed, each with its replacement in
-  [Migrating to 3.0](guides/migrating-to-3.md): the Nivo charts (use
-  `@nxgt/material/charts`); `CodeEditor`, `CodeDiff` and the Moonlight helpers
-  from the barrels (use `@nxgt/material/code-editor`); `StxPlayer` and
-  `VideoPlayer` (use `MediaPlayer` and `AudioPlayer`); the classic `PdfReader`
-  and its parts; `SelectChipField` and `SelectCardField` and their
-  `*FormField`s (use `ChipGroupField` and `ChoiceCardGroup`); `EmptyState`'s
-  `variant` (`kind` defaults to `empty`; use `ErrorState` for errors);
-  `SplitButton`'s legacy props; `ContactItem`, `OpeningHoursItem` and
-  `OpeningHoursSchema`; `CountryField`'s `singleDisplay="chip"`; `Switch`'s
-  `data-filed`; `entry="button"` of the date and time fields and
-  `TimePicker`'s `variant="inputs"`; and `ComboboxEmpty` without `items`.
-- **Native charts** — `@nxgt/material/charts` draws line, area, bar, pie,
-  donut, gauge, radial bar, funnel, heat map, radar, scatter and a combo chart
-  (bars, areas and lines on one or two axes) in SVG, with no chart library.
-  Each is one tab stop with arrow-key point navigation and a live status, has
-  a screen-reader summary, a "View data" table, a hide/isolate legend,
-  `patterns` so colour is never the only cue, `onPointClick`, and series
-  colours held to 3:1 marks and 4.5:1 labels in both themes. The line, area,
-  bar and combo charts add `zoom` (a mini overview with a window and two
-  slider handles) and a phone scroll that opens on the latest point. The
-  light `--chart-4` is now a purple. Client-only, like `/editor`.
-  ([Charts](guides/charts.md))
-- **Reference bands, thresholds and point tones on the line chart** — `bands`
-  shade a range of the value axis, `thresholds` draw labelled lines, and
-  `pointTone` rings the values that need a word (`toneLabels` gives the words).
-  The words reach the tooltip, the live status, the summary (values outside a
-  band, tone counts) and a tone column of "View data"; the axis grows to hold
-  them and a zoom window keeps them right.
-  ([Reading values against a reference](guides/charts.md#reading-values-against-a-reference))
-
-- **The page's title in the app bar, a text breadcrumb root and the tenant in the menu** —
-  a route's `handle.title` (a node, or a function of the match like
-  `handle.breadcrumb`; the deepest match wins) puts the page's title in the app
-  bar: it is in the server HTML, it is the page's one `<h1>`, it is truncated
-  with its full text as the `title` tooltip when cut off, and `ActivityContent`
-  drops its own title while the bar has one (see [the page's title in the app
-  bar](guides/app-shell.md#the-pages-title-in-the-app-bar)). The title has a
-  stable `id` and `tabIndex={-1}`, `<main>` is labelled by it, and
-  `usePageTitleFocus()` focuses it after a navigation. `handle.titleAfter` (or the
-  `titleAfter` prop) puts a node, such as a record's `Switcher`, right after the
-  title outside its `h1`, and `headerContext` a small tenant line after it from
-  `md` up (see [a slot after the
-  title](guides/app-shell.md#a-slot-after-the-title)).
-  `breadcrumbRoot` on `ActivityLayout` (`root` on `AppBreadcrumb`) puts a text
-  root crumb, resolved through the router's basename, in place of the home
-  icon; and `context` on `ActivityLayout`, `AppHeader` and `AppSidebar` shows
-  the tenant's name at the top of the phone's menu sheet, above the brand.
-
-- **PeriodCards** — consecutive date ranges, such as a
-  school year's terms or sprints, as cards: the period that holds today is
-  marked ("Current" and `aria-current="date"`), each card can be a link over
-  its whole area, a footer keeps its own buttons, and the cards fill as many
-  14rem columns as fit (one on a phone). Its state and range text are in
-  `@nxgt/material-core/periods`.
-  Shipped in 2.41.0.
-
-- **Choice fields** — `ChipGroupField` and
-  `ChoiceCardGroup`: one choice or several as chips or cards, a real radio
-  group or group of checkboxes with one Tab stop, arrow keys, `max` with a
-  reason, and 44px boxes on a touch screen. `OptionTile` takes the refined
-  look (a tint, a start bar and a bold title when chosen), and
-  `CheckboxGroup` and `RadioGroup` take a working `orientation`. The shared
-  rules are in `@nxgt/material-core/choice-group`.
-  Shipped in 2.41.0.
-
-- **Material 3 Expressive editors and toolbars** — `Toolbar` gains
-  `selectedLook="morph"`: a pressed tool fills with the primary colour and
-  widens into a pill, groups are connected, and overflow keeps room for the
-  widening so pressing never folds a tool into More. `shape="round" | "pill"`
-  picks the form per item, and an `IconButton` toggle morphs the same way. The
-  quiet look is now a tonal pill. The editor presets take
-  `look="expressive"` by default (`look="classic"` opts out): a floating pill
-  and an Insert FAB offering the `/` menu's blocks on `DocumentEditor`, a
-  vertical pill on the page layout's rail, a tonal head on `CompactEditor` and
-  its form fields, connected tools and a squircle Send on `RichChatComposer`,
-  and sans headings and a tonal sheet. `PdfReader` defaults to the expressive
-  look as well, and `RichTextViewer` takes an opt-in `look="expressive"` to
-  match the sheet. A dark code block stays readable under a nested `.dark`.
-  Shipped in 2.40.0; a visual change for apps that keep the defaults.
-  React only for now. [Rich widgets](components/rich-widgets.md),
-  [Toolbar](components/buttons-and-actions.md#toolbar)
-
-- **Refined selection controls** — `Checkbox` and `Radio` draw their check and
-  dot in with a round state layer (the radio is 20px, like the box); `Switch`
-  is a 52x32 track with a thumb that grows and carries a check, with an opt-in
-  `thumbIcons`; `Slider` has a thin masked track, a bar handle, stop dots and a
-  value bubble (`formatValue`, `valueBubble`, `inverted`), and `size="large"`
-  with an `icon` for a volume or a brightness. Menus, `Select`, `Combobox`,
-  `Command`, the phone country menu, `Switcher` and the filter presets draw the
-  same animated check and dot. Checkbox helper text is announced through
-  `aria-describedby`, and the items of an invalid group show the error border.
-  Shipped in 2.38.0. React only for now. [Form fields](components/form-fields.md#slider),
-  [selection](components/selection-and-choice.md#checkbox)
-
-- **Tone tokens** — every tone now has a readable
-  text colour (`--secondary-text`, `--success-text`, …), an opaque container
-  (`--success-container`, …) and an on-colour, and `data-tone` hands a
-  component the four values it needs (`--nxgt-tone`, `-on`, `-container`,
-  `-text`). Your own tone needs only `--nxgt-tone`; the others are derived.
-  `Shape`, `Fab`, `Avatar`, `StatCard` and the metric cards follow, with app
-  tones. A calm zone (`data-density="calm"` on any container) fades the decorative
-  tints inside it (shapes, avatar fallbacks, StatCards, the metric rank
-  badge), with `data-density="expressive"` to opt back in; status chips and
-  selection keep their colour. A coloured tonal `Chip` reads as a status (a
-  stronger container, the label in the tone's text colour), and the active
-  entry of the sidebar and the rail is drawn with tokens a theme can set
-  (`--sidebar-active`, `-hover`, `-foreground`).
-  [Guide](guides/theming.md#tones)
-  Shipped in 2.38.0.
-- **A redesigned `PdfReader`** — `PdfReader` from the new
-  `@nxgt/material/pdf-reader` draws pages with pdf.js directly (no `react-pdf`),
-  a window of pages at a time: a docked header, a floating page pill, a rail
-  and a panel with thumbnails, outline and search, `embedded`, `dialog`,
-  `page` and `fullscreen` modes, single and two-page layouts (with a cover,
-  and right to left), and `configurePdfReader` for pdf.js's worker and assets.
-  Since 3.0 `/components` exports it as `PdfReader` and the classic react-pdf
-  reader is removed.
-  [Guide](guides/pdf-reader.md)
-  Shipped in 2.38.0.
-- **DataGrid row selection and keyboard and touch resize** — `enableRowSelection` adds a leading column with a checkbox per
-  row and a select-all, with the selection controlled or kept by the grid and
-  the count announced. Alt+Left and Alt+Right resize a header's column from
-  the keyboard, a touch screen gets a grip on the active header, and the
-  frozen edge is a stronger line. [Guide](guides/data-grid.md#row-selection)
-  Shipped in 2.38.0.
-- **One media player, video and audio** — `MediaPlayer` plays video or audio
-  with captions, chapters, a transcript that follows the playback, thumbnails on
-  hover, a playlist with shuffle and repeat, and resume where the viewer left
-  off; `AudioPlayer` is an audio card or list row with a waveform.
-  `MediaPlayerHost` keeps sound and video going across routes, docked in a bar
-  or floating as `MediaPlayerMini`; `MediaPlayerLightbox` opens a video over
-  the page; `MediaTranscript` lays the transcript out where you want it.
-  Streams play through `@nxgt/material/media-hls` (an optional `hls.js` peer,
-  loaded only when a stream needs it), with a quality menu. It runs under a
-  strict CSP and is built for WCAG 2.2 AA, with a full keyboard.
-  `StxPlayer` and `VideoPlayer` were removed in 3.0
-  ([migrating](guides/migrating-to-3.md#stxplayer-and-videoplayer)). 2.38.0.
-  ([Media players](guides/media.md))
-- **The filter bar: `Filter variant="bar"` and `"facets"`** — a query-driven
-  list filter: the search, the active filters as chips, dashed quick-filter
-  pills and toggles, "Add filter" (field, operator, value), locked conditions
-  with a lock and no remove button, a facets panel beside the list
-  (`variant="facets"`: collapsible FacetGroups sharing the bar's state), and a
-  bottom sheet with staged apply and a "Show 24 results" count on a phone. All
-  18 field types (numbers, sliders, dates and times with relative presets,
-  server-searched autocompletes, custom fields) edit in every surface. The
-  query is plain data (`query`, `defaultQuery`, `onQueryChange`) that a route's
-  loader parses and the page writes back with the URL codec in
-  `@nxgt/material-core/filter`; `/` and `F` shortcuts you can turn off;
-  one live region tells the settled count. The older `Filter` variants and
-  `FilterChips` still work, now deprecated. Shipped in 2.37.0.
-  [Filter bar](components/data-table-filter-and-lists.md#filter-bar) ·
-  [Server lists in the URL](guides/server-lists-url.md)
-- **A server list driven by the URL: `ServerTable`** — a server-mode `DataTable` with the filter bar in its top band beside the page's optional title, its description line and its actions, the query, sort and cursor in the URL for any router, the empty page listing the filters as removable chips (and, for "nothing yet", a scene and an action), and one count announced. Shipped in 2.37.0.
-- **LocalizedTextFields** — one text in several
-  languages: a fieldset with an input per language, the default as a
-  placeholder with a reset button, `lang` and `dir` on each input, an error
-  per language and for the group, and a record value with no key for an empty
-  language. `primaryLanguages` keeps the main languages in view and folds the
-  rest under "Other languages", which opens itself on an error. With
-  `LocalizedTextFormField` for React Hook Form.
-  Not in material-vue yet (#969).
-  [Guide](components/form-fields.md#localizedtextfields)
-  Shipped in 2.37.0.
-- **Your own tiptap and ProseMirror classes in custom features** — `@nxgt/material/editor/pm` re-exports the editor's own
-  tiptap and ProseMirror (`Extension`, `Node`, `Plugin`, `PluginKey`,
-  `TextSelection`, `Fragment`, `DecorationSet`...), so a custom feature's
-  `instanceof` checks and the nodes it builds agree with the editor. It shares
-  the editor's code instead of shipping a second copy (additive).
-  [Guide](components/rich-widgets.md#a-custom-feature)
-  Shipped in 2.36.0.
-- **A modern rich text editor** — `DocumentEditor` from
-  `@nxgt/material/editor`, a client-only entry built on composable parts, a
-  `useEditor` hook and feature kits you pick from, with a toolbar on `Toolbar`
-  that folds what does not fit into "More". `layout="page"` is a sheet on a
-  tinted surface with a tool rail, comments in the margin and a Write / Preview
-  / Markdown switch. It reads and writes HTML, JSON and Markdown;
-  `RichTextViewer` shows a saved document on the server;
-  `CompactEditor` and `RichChatComposer` serve a comment or a chat message.
-  Blocks move by a drag handle, with an outline, focus mode and find and
-  replace; images and files upload through your `onUpload`; an `onAssist`
-  function adds an AI assistant; comments are stored by your adapter; and
-  several people edit one document through a Yjs provider you supply.
-  `RichTextEditor` is rebuilt on the same engine and is deprecated
-  ([migration](components/rich-widgets.md#migrating-from-richtexteditor)). 2.35.0.
-  ([DocumentEditor](components/rich-widgets.md#documenteditor), [Formats](components/rich-widgets.md#formats), [RichTextViewer](components/rich-widgets.md#richtextviewer), [CompactEditor](components/rich-widgets.md#compacteditor), [Navigation](components/rich-widgets.md#navigating-a-long-document), [Upload](components/rich-widgets.md#uploading-media), [Assistant](components/rich-widgets.md#assistant-ai-hooks), [Comments](components/rich-widgets.md#comments), [Collaboration](components/rich-widgets.md#collaboration))
-- **Gallery and Carousel, Material 3 Expressive** — every `Gallery` preset
-  gets the Material 3 look with no API change (softer corners that round on
-  hover, a spring press, a picked or current tile marked by a tint, a start bar
-  and a check badge, a visible focus ring, motion that stops under reduced
-  motion); then carousel formats (multi-browse, hero, uncontained,
-  full screen) with indicators and an accessible autoplay, in `Carousel` and in
-  `Gallery`; `quilted` and `woven` layouts; tiles in Material shapes (opt-in `galleries.css`;
-  without it the `xl` corner); and a
-  lightbox with swipe-to-close, pinch zoom and a filmstrip. Motion and corner
-  tokens come with it. 2.34.0.
-  ([Theming](guides/theming.md#motion-and-shape-tokens), [Gallery](components/media-and-files.md#gallery-lightboxgallery-minigallery), [Carousel](components/media-and-files.md#carousel))
-- **Progress in Material 3 Expressive style** — `Progress` and `CircularProgress`
-  redesigned: a rounded stroke, a gap, the track and a stop dot; opt-in `wavy`;
-  `thickness`, eight `tone`s and a `buffer`; values that move on a spring and
-  Material 3's indeterminate motion; server markup with no `style` attribute.
-  `Progress`'s `pulse` and `asChild`, and `CircularProgress`'s `variant`
-  (now `tone`), `strokeWidth`, `circleStrokeWidth`, `progressStrokeWidth` and
-  `shape` are deprecated, still accepted
-  ([Progress](components/feedback-and-status.md#progress)).
-  Shipped in 2.33.0.
-- **DataGrid, wave 1: fill handle and column layout** — drag a cell's corner to copy or to continue a series, as
-  Excel does (1, 2 gives 3, 4; "Devoir 1" gives "Devoir 2"; dates by the day,
-  month or year), double-click it to fill down, or press Ctrl/Cmd+D and
-  Ctrl/Cmd+R. Columns resize, hide and reorder from the header, with menu
-  items for the keyboard and touch, a `DataGridColumnsMenu` for your toolbar,
-  and a layout that is plain JSON your app persists. Column 0 and columns with
-  `lockPosition` keep their place. [Guide](guides/data-grid.md)
-  Shipped in 2.33.0.
-- **Expressive shapes** — `Shape` draws any of Material 3 Expressive's 35
-  shapes (and a squircle) as a backdrop, an icon container or a mask for a
-  photo, in eight tones and three variants, with an optical fit and a morph on
-  a spring. `LoadingIndicator` is Material 3 Expressive's loading indicator, a
-  shape morphing while it turns with no script. `Avatar` and `IconButton` take
-  a `shape`; an `IconButton` that changes shape morphs, for a selected state.
-  All of it is SVG, drawn on the server as in the browser, with no `style`
-  attribute. Built on `@nxgt/material-core/shapes`.
-- **DataGrid** — an editable grid for data that is typed, pasted and saved:
-  spreadsheet keys and a selected range, editors for text, numbers (with codes
-  such as "abs"), options, dates and checkboxes, or your own, paste from Excel
-  and Google Sheets, a fill, undo and redo, totals that follow unsaved edits,
-  and saving per cell, per row or in a batch, with the version each value was
-  read at so that two people editing one cell are told. Long grids render only
-  what is in view, a phone gets a list of rows that open a panel, and a strict
-  Content Security Policy works. 2.29.0.
-  ([DataGrid guide](guides/data-grid.md))
-- **Background presets** — `Background` from `@nxgt/material/backgrounds` draws
-  twenty presets: the gradient and the grain, the light family (`mesh`,
-  `aurora`, `spotlight`, `bokeh`), the geometry family (`isometric`,
-  `blueprint`, `dots`, `stripes`, `low-poly`, `topography`, `waves`) and the
-  motif presets (`shapes`, `confetti-grid`, `constellation`, `halftone`,
-  `truchet`, `floating`, `scatter-icons`), driven by the `motif` prop (`shapes`,
-  `density`, `size`, `rotate`, `shapeFill`, `opacitySpread`). All of it is plain CSS and
-  seeded SVG, so a strict CSP and SSR accept it; `animated` is opt-in and
-  pauses when hidden or under reduced motion. 2.28.0.
-  ([Backgrounds guide](guides/backgrounds.md))
-- **Empty and error states that look designed** — `EmptyState` with its
-  `kind` (`empty`, `search`, `not-found`, `unauthorized`) and a new
-  `ErrorState` (`generic`, `offline`, `maintenance`), each in two sizes
-  (`default`, `compact`), with in-house inline SVG illustrations or your own in
-  `illustration`. `ErrorState` is a `role="alert"` with a Retry action and
-  collapsible technical details. The `DataTable` default (your `empty` prop
-  still replaces it, and `emptyFiltered` covers a filter that hides every row),
-  `CommandEmpty`, the gallery, the kanban board, chat and the other built-in
-  empty states use them, and `PdfReader` shows an `EmptyState` or an
-  `ErrorState` with Retry when there is no document or it fails to load.
-  `variant` still works and is deprecated. 2.24.0.
-  ([EmptyState](components/feedback-and-status.md#emptystate),
-  [ErrorState](components/feedback-and-status.md#errorstate))
-- **Background presets, the base** — `Background` from `@nxgt/material/backgrounds`,
-  a superset of the one in `/components`: `preset` (`gradient` or `grain`),
-  `tone`, `intensity`, `animated` (drifts, and pauses while the page is hidden,
-  the background is off screen or the user prefers reduced motion), `grain`,
-  `seed` and `fill`. The SVG is built from plain data, so the server and the
-  client render the same markup and a strict CSP accepts it. The stylesheets
-  (`backgrounds.css`, `backgrounds/<preset>.css`) are opt-in.
-
-- **One Vite plugin for the whole setup** — `nxgtMaterial()` from
-  `@nxgt/material/vite` and `@nxgt/material-vue/vite` (one implementation in
-  `@nxgt/material-core/vite`) wires the library into a Vite app, each part on
-  by default and each switchable off; the helpers that existed before stay
-  exported ([Vite plugin guide](guides/vite-plugin.md), and the migration guide moves a hand-written setup over). You get:
-  - `csp`: `mode: 'hash'` (default) writes the sha256 of every inline script
-    and style to `dist/.vite/nxgt-csp.json` with the header, or `mode: 'nonce'`
-    leaves a placeholder for `applyCspNonce`; zod's jitless script; a
-    Report-Only header on the dev server. `createCspNonce()`, `cspPolicy()`
-    and `cspHash()` ship in `@nxgt/material-core/csp`.
-  - `fonts`: `katex` (fonts stay files) and `sans: 'inter'` (self-hosted Inter).
-  - `styles`: a build that fails with the exact fix when the stylesheet import
-    or React's `@source` line is missing.
-  - `pdf`: pdfkit's standard fonts handled by the same plugin, with
-    `bundle: true` for an SSR server with no `node_modules`. The Nuxt module
-    calls `nxgtMaterial()` with the same `fonts`, `styles` and `pdf` options
-    (`pdf.bundleStandardFonts` is deprecated for `pdf.bundle`) and adds zod's
-    jitless script to the head on request; its CSP stays `nuxt-security`'s.
-  - `NonceProvider`'s `nonce` is optional on the client (a client-only app gets the
-    page's nonce from its first render; a hydrated app passes it on both sides).
-  Shipped in 2.24.0.
-
-- **The app's brand, a header title and an account menu** — the app shell
-  takes the app's `logo` and `name`: the logo alone in the collapsed rail,
-  named by the app's name and shown as its tooltip, the logo and the name side
-  by side expanded and in the phone's menu sheet, which now shows `brand` too;
-  `headerTitle`, the context the app is in, right after the phone's menu
-  button and truncated when long; and `AccountMenu`, the avatar button named
-  "Account menu, <name>" that opens the account's name and e-mail, the app's
-  links and a busy-aware Sign out (`onSignOut`).
-
-- **Rows a user adds, removes and reorders** — `RepeatableGroup` and
-  `RepeatableGroupFormField` over the form library's field array: rows from
-  `renderRow`, a list for assistive tech, Remove and move buttons named after
-  the row ("Remove period 2"), `max` and `min`, an empty state, focus that
-  follows each change, polite announcements, and the array's own error under
-  the rows. One column on a phone. 2.19.0. `removable` and
-  `removeDisabledReason` keep a row that cannot be removed, its Remove button
-  `aria-disabled` and described by the reason.
-
-- **Signed-out pages and two-step verification** — `AuthCard`, the frame of a
-  sign-in page (one `main`, the card's title its `h1`, a status or alert
-  notice, safe-area padding); `EnrolmentSecret`, a TOTP enrolment's QR code,
-  app link and key grouped by four; `RecoveryCodes`, one-time codes to copy,
-  download or print alone, with an "I have saved these codes" confirmation
-  (`saved` / `onSavedChange`) an app's router guard can follow. 2.17.0.
-- **Focus after a change, one submit at a time, errors worded by code** —
-  `useFocusOnMount` focuses the heading of what replaced the content the user
-  acted on; `useSubmitOnce` drops a double click or a second Enter until the
-  request ends; `useCodeResolver` words a zod schema's errors in the page's
-  language, a refinement's `params.code` in the app's own words. 2.17.0.
-- **Long forms in titled sections** — `FormSection`: a heading (an `h2`, or
-  the level `titleAs` names), a description and actions, its fields in the form
-  grid's columns and one column on a phone, a rule between sections, and a
-  group a screen reader announces by its title. 2.17.0.
-- **A strict Content Security Policy** — a page that sends `script-src` with a
-  nonce and no `'unsafe-eval'`, and `style-src-elem` with a nonce and no
-  `'unsafe-inline'`, runs every component with no violation report:
-  `NonceProvider` forwards the nonce to each component, the CSS the
-  dependencies inject is in the stylesheet, zod is external and its schemas are
-  built on first use, and the KaTeX fonts are files. The
-  [Content Security Policy guide](guides/csp.md) has the policy. 2.14.0.
-- **An `Autocomplete` that searches a server** — `onSearch`, `debounceMs`, `minQueryLength`, `filter`, `loading`, `searchError`: a
-  debounced search with an `AbortSignal` whose stale responses are dropped,
-  a polite "Loading…" / "N results" announcement, and local matching that
-  ignores accents ("e" finds "École"). 2.12.0.
-- **Toast actions that work everywhere** — `toasts.success(message, { action })`
-  and every other preset take sonner's own call shape and keep their action,
-  and a dialog a toast's action opens keeps the focus, then gives it back to
-  where it was before the toast. 2.10.0.
-
-- **Tabs in two looks** — `underline`, the new default, whose bar slides to
-  the active tab, and a neutral `segmented` pill; a list that scrolls
-  sideways on a phone instead of widening the page, right-to-left, a visible
-  focus ring, labels that read 4.5:1 in both themes, and an indicator that
-  stops sliding under `prefers-reduced-motion`. `bar` and `line` still work,
-  as deprecated aliases of `underline` and `segmented`. 2.9.0.
-
-- **Accessible by default** — error text in its own `--error-text` colour that
-  reads 4.5:1 in both themes, the empty part of sliders and meters in a
-  `--track` colour that reads 3:1, buttons, badges and status colours that
-  reach WCAG contrast, animations that honour `prefers-reduced-motion`, the
-  page behind a modal layer made `inert`, focus on the first invalid field
-  after a failed submit, Escape that reaches the layer below while one
-  closes, and a `Toaster` at the top of a phone whose toasts a tap does not
-  pause and whose actions work over a dialog. 2.8.0.
-- **Fits a phone** — `DataTable` with no height cap by default (`maxHeight`
-  when it should scroll in a box), a header row at every width, and wide
-  columns that scroll sideways in one region a keyboard can reach; a `Button`
-  never wider than its container (a long label ends in "…", or wraps with
-  `wrap`); `OtpField` slots that shrink to fit a narrow card. 2.8.0.
-- **App shell links, landmarks and scrolling** — menu entries that are real
-  links (middle-click, before hydration, `aria-current="page"`, your router's
-  link through `linkComponent`), one `<main>` landmark, and a shell
-  that lets the document scroll, with `scroll="container"` for a full-height
-  screen. 2.8.0.
-- **DataTable server-side data** — hand the table one page from your loader
-  (`manual`): no client paging or sorting, controlled sorting and selection by
-  row id (`sorting`, `rowSelection`, `getRowId`), a footer with "41–60 of 133"
-  and Previous / Next as links that work with no JavaScript (`pagination`,
-  `DataTableServerFooter`, `footer`), and rows that link to their page
-  (`getRowHref`, `onRowClick`, `linkComponent`). 2.7.0.
-- **TreeSelectField** — pick one or several items from a tree inside a form
-  field, as chips when several, with an optional filter that keeps each match
-  under its ancestors (`TreeSelectField`, `TreeSelectFormField`). 2.6.0.
-- **DateRangeField presets and time** — one-click ranges such as Today, Last 7
-  days and This month, or your own, beside the calendar (`presets`), and a time
-  of day on each end of the range (`withTime`). 2.6.0.
-- **FilePreview** — preview a file picked by its type, in one component: an
-  image, a PDF in `PdfReader`, a video or audio file, the text of a text, JSON,
-  CSV or Markdown file, or a card with a download link for anything else
-  (`FilePreview`, `onError`). Safe on a server. 2.6.0.
-- **Spinner `light` colour renders** — a `Spinner` with `color="light"` shows
-  its light ring, for loading states on dark or coloured surfaces. 2.5.0.
-- **Range filters announce their field name** — the slider thumbs and the
-  `Min`/`Max` inputs of a `slider-range` or `number-range` filter are named
-  after the field, so a screen reader says which range is changing. 2.5.0.
-- **Alert keeps long content inside** — a long title, description or unbroken
-  string wraps inside the `Alert` instead of running past its edge. 2.5.0.
-- **Stepper: unique ids, announced steps and truncated titles** — two steppers
-  on one page no longer share ids, a screen reader hears which step is current
-  and whether each is done or in error, and a long step title truncates. 2.5.0.
-- **Layouts that hold long content** — `ListTile`, `StatCard` and `Banner`
-  keep long titles, values and actions inside their box instead of overflowing.
-  2.5.0.
-- **The same exports as `@nxgt/material-vue`** — `Camera`, `NativeSelect`, the
-  `InputOTP` parts, `PaginationFirst` and `PaginationLast`, `TableEmpty`,
-  `DialogScrollContent` and `ToastAction`, `Button`'s sizes, and the
-  `RadioGroupField`, `SliderField` and `SwitchField` names, so code moves
-  between the two libraries without renaming. 2.5.0.
-- **DataTable loading and empty states** — skeleton rows while the data loads
-  (the rows already shown stay in place, dimmed, during a refresh), the table
-  announced as busy, and your own content when there are no rows, told
-  whether a filter emptied it. 2.5.0.
-- **PDFs from a Next.js route handler in one line of config** —
-  `withNxgtPrint(nextConfig)` from `@nxgt/material/next` adds what `/print`
-  needs to `next.config.ts` — the library in `serverExternalPackages`, and
-  pdfkit's fonts in the `output: 'standalone'` trace wherever your package
-  manager installed them — merged with your own config. 2.4.0.
-  ([printing](guides/printing.md#nextjs-serverexternalpackages-and-output-standalone))
-- **One copy of the framework-free code, shared with `@nxgt/material-vue`** —
-  the PDF document model and renderer, the print formatters, the PDF file
-  helpers, `PdfReader`'s page geometry, scroll spy and search, the
-  `CurrencyField` decimals, the fields' blur rule and `pdfkitStandardFonts()`
-  now come from `@nxgt/material-core`, which your install adds on its own.
-  Every entry exports the same names with the same types, so nothing changes
-  in your imports; a server bundled without `node_modules` bundles
-  `@nxgt/material-core` too. 2.3.0.
-  ([troubleshooting](troubleshooting.md#cannot-find-package-nxgtmaterial-core))
-- **Forms that validate on blur, and a lighter map entry** — every
-  `*FormField` marks its field touched when focus leaves it, so
-  `mode: 'onBlur'` and `'onTouched'` work; `@nxgt/material/map` no longer loads
-  the rest of the library (about 0.4 MiB of static imports instead of 5.5 MiB).
-  2.2.0. ([forms](guides/forms.md#touched-on-blur))
-- **Accessible names, ids and focus across the catalogue** — every field is
-  named by its label and says it is required on the element a screen reader
-  lands on (the input, the picker's `combobox`, the slider thumbs, the group),
-  with the asterisk drawn by CSS, so in no name or label text; groups are named
-  by their question and describe their error instead of carrying `aria-invalid`
-  where ARIA does not allow it; ids are generated rather than taken from a
-  field's `name` or an option's `value`, so two forms on one page no longer
-  collide; icon buttons, crumbs, carousel arrows, codes and the camera have
-  names; and a dialog, sheet or drawer takes focus when it opens and gives it
-  back when it closes. 2.2.0.
-  ([upgrading](getting-started.md#220-ids-names-and-aria-invalid-moved))
-- **PdfReader, turned pages and a steady zoom** — a page the PDF turns
-  (`/Rotate`) shows the right way up, the fit zoom settles once when the
-  document opens instead of moving while you read, `onPageChange` also reports
-  the page the reader moves to itself, links to websites open in a new tab
-  (`externalLinkTarget`), the toolbar's tooltips show in fullscreen, the
-  password field has a name, and a layout of your own opens bytes without
-  detaching them. 2.2.0. ([PdfReader](components/media-and-files.md#pdfreader))
-- **One document model for React and Vue** — `@nxgt/material/print` renders
-  documents written as plain data (`pdfDocument` and its builders,
-  `definePdfDocument` templates, `dataTable` from column definitions) alongside
-  the JSX components, and `@nxgt/material-vue/pdf` (0.22.0) renders the same
-  model, so a template renders the same pages in both libraries (experimental:
-  the model may still change in a minor release). 2.2.0.
-  ([printing](guides/printing.md#documents-as-data))
-- **One call to a PDF file** — `downloadPdf` and `openPdf` in the browser (a
-  blocked tab falls back to a download), `usePdfFile` for a preview that keeps
-  up with its data, `pdfResponse` for a server route on Node or Bun, and
-  `renderPdfBlob`, `renderPdfBuffer` and `renderPdfStream` for the file
-  itself, so you never touch `@react-pdf/renderer`'s output API or leak an
-  object URL. They also render documents written as plain data with
-  `pdfDocument` and its builders (experimental). 2.2.0.
-  ([printing](guides/printing.md#rendering-the-document))
-- **Tables from columns and rows** — `PrintDataTable` takes `columns` (label,
-  width, alignment, formatter, total) and `rows`, stripes them, keeps each row
-  whole, repeats the header on each page it crosses and closes with a totals
-  row; `PrintKeyValue` prints one record as label and value pairs and
-  `PrintMetric` a figure with its change. The `PrintTable` blocks you already
-  use keep working as they are. 2.2.0.
-  ([printing](guides/printing.md#tables-from-columns-and-rows))
-- **A page shell with page numbers** — `PrintDocument` sets page size,
-  orientation, margins and metadata, repeats your header and footer on every
-  page, prints "Page 2 of 5" in the document's language and can add a
-  watermark; `PrintHeader` takes a logo image. 2.2.0.
-  ([printing](guides/printing.md#the-page-shell-printdocument))
-- **`Stepper` without the SSR warning** — `Stepper` answers its screen-width
-  question on the server like the other responsive components, so SSR logs
-  stay clean and a desktop hydrates its server HTML without a mismatch.
-  `TimeField`'s OK button follows the language. 2.2.0.
-  ([SSR](guides/ssr.md#hydration))
-- **A PDF viewer that opens any source** — `PdfReader` opens a `Blob`, a
-  `File`, an `ArrayBuffer` or a `Uint8Array` as well as a URL, or a URL with
-  request headers (`{ url, httpHeaders }`), without reloading on every render;
-  its zoom menu works from the keyboard and in fullscreen. 2.2.0.
-  ([PdfReader](components/media-and-files.md#pdfreader))
-- **Amounts and dates in your locale** — `formatAmount` and `formatDate` take a
-  locale and time zone, use each currency's own decimals (`{ fractionDigits: 2
-  }` keeps two) and keep a date-only value on its day; `useFormatters()` binds
-  them to the `I18nProvider` language and `createFormatters()` to a locale you
-  pass, so a document rendered on a server reads like the screen. 2.2.0.
-  ([printing](guides/printing.md#formatamount-and-formatdate))
-- **More built-in labels follow the language** — calendar navigation,
-  the data table's selection checkboxes, filter presets and
-  `Min`/`Max`, the spinner, scroll-to-top, upload `Retry`/`Remove`, the map's
-  `You are here` and zoom buttons, icon-only close buttons, and the editor's
-  slash menu (searchable in either language), font names and table alignment;
-  then the filter's empty state and chips, breadcrumb and pagination names,
-  `MessageCard`'s "Unread", the upload field's replace button and errors, the
-  editor's placeholder and emoji buttons, `CircularProgress`, `StxPlayer`,
-  `PaneLayoutPane`'s sheet title, `JsonViewer`'s "Empty JSON" and
-  `TimePicker`'s AM/PM. 2.2.0.
-  ([i18n](guides/i18n.md#the-material-namespace))
-- **PdfReader fixes** — downloads finish in every browser and take the file name
-  you give instead of `document.pdf`, a protected PDF asks for its password and
-  says when it is wrong, Escape closes the search bar before the dialog around
-  the reader, `onPageChange` reports a page inside the document, A4 and
-  landscape pages fit the width or the page, search counts matches on pages you
-  have not scrolled to yet, the page number follows scrolling, the reader opens
-  on `initialPage`, and your editor no longer shows `PdfReader` as deprecated.
-  2.2.0.
-- **Form wrappers honour your `disabled` and `helperText`** — every
-  `*FormField` follows one rule: disabled when you pass `disabled` or the form
-  disables it, and your `helperText` shows until there is an error. Composite
-  fields (contacts, opening hours, attributes) show array-level errors. 2.2.0.
-- **Formatted i18n fallbacks** — without an `I18nProvider`, components show
-  `Step 01` or `3 items`, not raw `{step}` placeholders. 2.2.0.
-- **Server-safe `zodLocaleError`** — English Zod messages in the English
-  bundle, no throw on a server or with blocked storage, and your own
-  `storageKey`, language and translator. 2.2.0.
-- **One shared theme** — every `useTheme()` reads one store, so code blocks and
-  editors follow a toggle straight away, and `ThemeToggle` no longer flashes the
-  server's guess while hydrating. 2.2.0.
-- **Declaration files that always resolve** — a packed or linked build types
-  `react` like the npm one, instead of as `any`. 2.2.0.
-- **Component documentation with previews** — every component has an entry with
-  a picture of how it renders, an example that compiles and the options that
-  matter, under the same twelve categories in the README and `docs/`. A forms
-  guide covers React Hook Form, Zod, composite values and server errors. 2.2.0.
-- **`@nxgt/material/map`** — the leaflet map, markers, location field and
-  `useGeolocation` as an entry of this package, with leaflet as optional peers.
-  2.1.0.
-- **`formatAmount` and `formatDate` on the main entry** — no need to import the
-  print entry for two `Intl` helpers. 2.1.0.
-- **Print as its own entry** — `@nxgt/material/print`, PDF dependencies as
-  optional peers, and `pdfkitStandardFonts()` for Vite. 2.0.0.
-- **No phantom self-dependency** — installing the package no longer adds a
-  second copy of it to your lockfile. 1.16.6.
-- **Importable in any node process** — `import '@nxgt/material'` no longer
-  throws at server boot. 1.16.5.
-- **Gallery lightbox fits the viewport** — media is fitted instead of cropped.
-  1.16.4.
-- **Uniform gallery tiles** — media cropped to one aspect, restyled carousel
-  controls. 1.16.3.
-- **Mention list closes on select** — in the chat composer. 1.16.2.
-- **Modern emoji picker** — refreshed picker, with stories for emoji, mentions,
-  chat and markdown. 1.16.1.
-- **`MentionList`** — mention suggestions with local search, for chat and the
-  rich text editor. 1.16.0.
-- **Range filters in generated filter forms** — slider ranges and number ranges
-  rendered by the schema-driven filter fields: a `Filter` schema field with
-  `type: 'slider-range'` or `'number-range'` renders a two-thumb slider or a
-  `Min`/`Max` pair. 1.0.0.
-  ([filters](components/data-table-filter-and-lists.md))
 
-Older releases: the [version list on npm](https://www.npmjs.com/package/@nxgt/material?activeTab=versions).
+Older releases: every earlier entry is in the [CHANGELOG](../CHANGELOG.md).