@nxgt/material 2.6.1 → 2.7.0

package/CHANGELOG.md

@@ -0,0 +1,1781 @@
+# @nxgt/material
+
+## 2.7.0
+
+### Minor Changes
+
+- [#431](https://github.com/softistx/nxgt-material/pull/431) [`bd58a6f`](https://github.com/softistx/nxgt-material/commit/bd58a6f67bdc25d4b4d0d7d88c52784869ad1529) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `DataTable` renders server-side data: one page from a loader, with the query in the URL. Everything is opt-in; a table that sets none of the new props renders and behaves as before.
+  
+  - `manual`: `data` is one server page, rendered as given — no client paging, sorting or filtering — and the footer becomes `DataTableServerFooter` (exported).
+  - `pagination={{ totalCount, offset, previous, next }}`: the server footer's range ("41–60 of 133", `material.table.pagination.range`) and Previous / Next, each an href (a real link, `rel="prev"` / `rel="next"`, that works with no JavaScript) or a callback (a button); disabled when absent and while `loading`.
+  - Controlled sorting: `sorting` + `onSortingChange(sorting)` in React, `v-model:sorting` in Vue. The headers show the sorting they are given; the callback receives the new `SortingState`, not an updater.
+  - `getRowId(row, index)` and controlled selection by id: `rowSelection` + `onRowSelectionChange(selection)` in React, `v-model:row-selection` in Vue. Ids of other pages are kept, and the server footer counts them all.
+  - `getRowHref(row)`: the first data cell becomes a link to the row's page, and a click anywhere else on the row (but on a control, in a portal, or at the end of a text selection) follows it. `onRowClick(row, event)` (`@row-click` in Vue) makes the row focusable and activatable with Enter.
+  - `linkComponent`: the link rendered for row and page links, given `href` (wrap React Router's `Link` or vue-router's `RouterLink`, which take `to`). Default: a plain `<a>`.
+  - `footer`: a render function (React, Vue) or the `#footer` slot (Vue) replaces the footer; `footer={false}` removes it.
+  - New `material.table.pagination.*` strings, in English and French: `label`, `range`, `range-open`, `total`, `selected`.
+  
+  `@nxgt/material-core` gains `/row-activation` (`isRowActivation`, `followRowLink`, `ROW_CONTROL_SELECTOR`, `ROW_LINK_SELECTOR`, `RowClick`): the clickable-row rule both libraries' `DataTable` use.
+
+### Patch Changes
+
+- Updated dependencies [[`bd58a6f`](https://github.com/softistx/nxgt-material/commit/bd58a6f67bdc25d4b4d0d7d88c52784869ad1529)]:
+  - @nxgt/material-core@0.4.0
+
+## 2.6.2
+
+### Patch Changes
+
+- [#429](https://github.com/softistx/nxgt-material/pull/429) [`89c1e07`](https://github.com/softistx/nxgt-material/commit/89c1e078eec9ab7368882b6a90f53ebe9ed7951b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Docs: the README has a "Using with Claude Code" section. The
+  `softistx/nxgt-material` repository is now a Claude Code plugin marketplace
+  for apps that use the libraries — `nxgt-material` for React apps,
+  `nxgt-material-vue` for Vue and Nuxt apps — each with a skill that reads the
+  installed package's docs, a screen-builder agent, an upgrade-assistant agent
+  and an advisory hook that names the component a file hand-rolls. Install
+  with `/plugin marketplace add softistx/nxgt-material`, then
+  `/plugin install nxgt-material@nxgt-material` (or
+  `nxgt-material-vue@nxgt-material`); the repository is private, so this needs
+  GitHub access. Nothing in the package itself changed.
+
+- [#429](https://github.com/softistx/nxgt-material/pull/429) [`13c3eda`](https://github.com/softistx/nxgt-material/commit/13c3edad01f08656ca196aca7c37a21e8c003466) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The package ships its `CHANGELOG.md` (now in `files`), so the notes of every
+  version are in `node_modules/<package>/CHANGELOG.md` next to the docs, for
+  reading offline and for the upgrade agents of the Claude Code plugins.
+  The getting-started pages of `@nxgt/material` and `@nxgt/material-vue`
+  list it among the tarball's contents.
+- Updated dependencies [[`13c3eda`](https://github.com/softistx/nxgt-material/commit/13c3edad01f08656ca196aca7c37a21e8c003466)]:
+  - @nxgt/material-core@0.3.2
+
+## 2.6.1
+
+### Patch Changes
+
+- [#427](https://github.com/softistx/nxgt-material/pull/427) [`d4e953f`](https://github.com/softistx/nxgt-material/commit/d4e953fd4fc147b366c5d9d70ebfb1aa3a3c0ba7) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Docs: the roadmap lists what 2.6.0 shipped (`TreeSelectField`, `DateRangeField` presets and time, `FilePreview`) under Shipped. Troubleshooting has two new entries, for what a test may now see: `TimePicker`'s AM / PM moves the time into that half once (it could add 12 hours twice) and a click on the pressed half changes nothing; a `Tree` no longer moves focus into itself when it renders. The `FilePreview` entry quotes the HTTP error `onError` receives, `Could not read …: HTTP 404`.
+- Updated dependencies [[`d4e953f`](https://github.com/softistx/nxgt-material/commit/d4e953fd4fc147b366c5d9d70ebfb1aa3a3c0ba7)]:
+  - @nxgt/material-core@0.3.1
+
+## 2.6.0
+
+### Minor Changes
+
+- [#424](https://github.com/softistx/nxgt-material/pull/424) [`d90a68b`](https://github.com/softistx/nxgt-material/commit/d90a68b8f16759b44929effc426b6c3964e92a4c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `DateRangeField` (and `DateRangeFormField`) take `presets` and `withTime`.
+  `presets` lists one-click ranges beside the calendar: built-in ids
+  (`DATE_RANGE_PRESET_IDS`: `today`, `yesterday`, `last-7-days`,
+  `last-30-days`, `this-month`, `last-month`, `this-year`) and
+  `{ label, range }` of your own, where `range` may be `(now) => range`. A
+  preset is a toggle button in a group named "Presets", pressed when its days
+  are the value's, and disabled when its range starts before `minDate`, ends
+  after `maxDate`, either end is one of `disabledDays`, or (a preset of your
+  own) its end comes before its start. Picking one closes the popover, except
+  with `withTime`, where OK closes it. `withTime` adds a start and an end `TimePicker` under the
+  calendar, each disabled until its end has a day, and an OK button; the
+  popover then stays open until OK, the trigger shows each end's time, a day picked on the calendar keeps the
+  time its end had (a new start 00:00, a new end 23:59, as the built-in
+  presets end, so the range covers its last day), and an end set before the
+  start on the same day becomes the start time. The built-in presets use the
+  current date (there is no `now` prop).
+  `DATE_RANGE_PRESET_IDS` and the types `DateRangePreset`, `DateRangePresetId`,
+  `DateRangePresetOption` and `DayRange` are exported from
+  `@nxgt/material/components` (from `@nxgt/material-core/date-range`).
+  
+  New `material.*` keys: `material.date-range-field.presets`,
+  `material.date-range-field.preset.today`, `.yesterday`, `.last-7-days`,
+  `.last-30-days`, `.this-month`, `.last-month`, `.this-year`,
+  `material.date-range-field.start-time`, `material.date-range-field.end-time`,
+  `material.time-picker.hours` and `material.time-picker.minutes`.
+  
+  `TimePicker` fix: AM / PM now follows the `date` it is given, so a date
+  changed from outside shows its own half of the day; switching AM / PM always
+  moves the time into that half (it could add 12 hours twice before), and a
+  click on the pressed half changes nothing. Its hours and minutes inputs are
+  named "Hours" and "Minutes".
+
+- [#426](https://github.com/softistx/nxgt-material/pull/426) [`812c101`](https://github.com/softistx/nxgt-material/commit/812c10115278480852852084ddf06b016239e6d4) Thanks [@SteveGT96](https://github.com/SteveGT96)! - New `FilePreview` (Media & files): one file previewed by its MIME type, else
+  its extension. `file` is a `File`, a `Blob` or a URL, with optional `type`
+  and `name` overriding what the file says. An image is an `<img>` whose alt
+  text is the file name; a PDF opens in `PdfReader`, imported the first time a
+  PDF is previewed, and falls back to the file card when the viewer cannot be
+  loaded; a video or audio file gets the browser's `<video controls>` /
+  `<audio controls>`; a text, JSON, CSV or Markdown file is read up to
+  `maxTextBytes` (256 KB by default) and shown in a scrolling `<pre>`, JSON in
+  `JsonViewer` and Markdown rendered, with "Showing the first … of this file."
+  when it was cut; anything else is a `FileCard` with its size and type and a
+  Download link. A text is decoded with the `charset` of the response's
+  `Content-Type` when the browser supports it, else as UTF-8. A URL must be
+  `http(s):`, relative, `blob:`, or a `data:` URL of an image, video, audio, plain text, CSV, Markdown, JSON or PDF: any
+  other (`javascript:`, `data:text/html`, and also a `data:` URL of XML, TSV or
+  YAML) is never linked, loaded or fetched, and shows the error state with no
+  Download link and a `FilePreviewUnsafeUrlError` ("Refused to preview a URL with an unsafe scheme") for `onError`. A PDF the reader fails to open stays `ready`: `PdfReader` shows
+  its own error. The scrolling text and Markdown are regions named "Contents
+  of {name}", and "Loading preview…" is announced from a live region that
+  stays mounted. A `File` or `Blob` is shown through an object URL, revoked on
+  change and on unmount. On the server, and in the first client render, it
+  renders an empty placeholder (`data-state="pending"`): no object URL, no
+  fetch, nothing to mismatch on hydration. Then `loading`, `ready` or `error`
+  ("This file could not be previewed.", with a Download link), and `onError`
+  receives the error. Also exported from `@nxgt/material/components`:
+  `fileKind`, `FilePreviewHttpError`, `FilePreviewUnsafeUrlError`,
+  `TEXT_PREVIEW_MAX_BYTES` and the types
+  `FileKind`, `FilePreviewSource`, `FilePreviewProps` and `FilePreviewStatus`
+  (from `@nxgt/material-core/file-preview`).
+  
+  New `material.*` keys: `material.file-preview.label`,
+  `material.file-preview.untitled`, `material.file-preview.loading`,
+  `material.file-preview.error`, `material.file-preview.download`,
+  `material.file-preview.truncated` and `material.file-preview.content`.
+  
+  `useImagePreview` (the upload field's, image field's, file list's and chat
+  chip's image thumbnail) no longer hands out a revoked URL for the render
+  between a file change and its effect: neither the previous file's, nor, when
+  a file is cleared and the same one picked again, that file's old one.
+
+- [#418](https://github.com/softistx/nxgt-material/pull/418) [`01d96ca`](https://github.com/softistx/nxgt-material/commit/01d96ca739bb9565c841c7944294df24eb378e07) Thanks [@SteveGT96](https://github.com/SteveGT96)! - **`TreeSelectField`** and **`TreeSelectFormField`**, in both libraries under the same names: a form field that opens the `Tree` in a popover.
+  
+  - `items` takes `Tree`'s nodes. The value is the picked node's id (`string | null`), or the ids with `multiple` (`string[]`): `value` / `onValueChange` in `@nxgt/material`, `v-model` in `@nxgt/material-vue`. The field is controlled only: it holds no value of its own.
+  - Single: a pick closes the popover and the trigger shows the node's label. `multiple`: checkboxes in the tree, and each pick is a dismissible `Chip` beside the trigger, its remove button named "Remove {label}".
+  - `searchable` adds a filter above the tree; each match stays under its ancestors, which open.
+  - Removing a chip hands focus to the next chip, else the previous one, else the trigger, so a keyboard user is not dropped to the page (nor the form field touched).
+  - The trigger is a `combobox` named by the label, with `aria-expanded` and `aria-controls`, and the popover is named by the label too; the tree keeps its own keys, and Escape closes the popover and returns focus to the trigger. `id`, `aria-describedby` and `data-*` attributes go on the trigger. It renders on the server.
+  - `TreeSelectFormField` binds it to react-hook-form (`control`, `name`, `multiple`) or vee-validate (`name`, `multiple`), touched when focus leaves the trigger and its popover.
+  - New copy under `material.tree-select-field.*` (`placeholder`, `search`, `empty`, `selected`), in English and French.
+  
+  **`Tree`**: when its nodes change (a filter) or a branch folds and the row that had the keyboard is no longer shown, the first visible row takes `tabindex="0"`, so Tab still reaches the tree. `useTree` returns that row as `tabbableId`, in both libraries. In `@nxgt/material`, mounting a `Tree` no longer moves focus into it: focus follows the keyboard only, as in `@nxgt/material-vue`.
+
+### Patch Changes
+
+- [#425](https://github.com/softistx/nxgt-material/pull/425) [`8092210`](https://github.com/softistx/nxgt-material/commit/80922105439dcac15b9564864c8945e5edd64aa8) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `DateRangeField` docs: `onValueChange` after the first click, and the emitted
+  range, now say what react-day-picker 10 does — the first day picked is both
+  `from` and `to` until the second. The `WithTime` story picks two days and
+  checks they start at 12:00 AM and end at 11:59 PM.
+
+- [#419](https://github.com/softistx/nxgt-material/pull/419) [`02efc3e`](https://github.com/softistx/nxgt-material/commit/02efc3e57a60b533596fd644ebbfc856186664f8) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Docs: the i18n guide names the pagination keys `material.pagination.previous`,
+  `next`, `page` and `more` (`@nxgt/material`); `InlineEdit` says where focus
+  goes when the editor closes, and its Vue props table lists `label` and
+  `name`; the Vue `DocLink` paragraph says that without `@navigate` it and the
+  sidebar are plain anchors that load the page.
+  The Vue i18n guide also names `material.slider.value`, `minimum` and
+  `maximum`, which label the slider readout.
+
+- [#419](https://github.com/softistx/nxgt-material/pull/419) [`99878c9`](https://github.com/softistx/nxgt-material/commit/99878c9bdb0d4c33fd6a777970c4f3735bd5ef3b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader`: opening on an `initialPage` no longer reports another page on a
+  slow device. The placement scroll could land after the scroll spy's hold had
+  run out, and near the end of the document it read as the last page. While
+  the view stays where the opening page's pin put it (that page at the top,
+  or the page area at its end with that page not above the top), a scroll is the reader's own and is not
+  reported; a scroll that moves the view elsewhere — the user's, find in page,
+  a screen reader's cursor — lets go of the pin and is reported. A wheel,
+  touch, pointer or key in the page area also ends the hold on the reader's
+  own scroll, so the scrolling after it is reported at once. In
+  `@nxgt/material-core/pdf-viewer`, `pinToPage` takes an optional `onRelease`,
+  called once when the pin lets go, and `pinHolds(node)` tells whether the view
+  is still where the pin puts it.
+
+- [#421](https://github.com/softistx/nxgt-material/pull/421) [`0cf0b4f`](https://github.com/softistx/nxgt-material/commit/0cf0b4f3d5fd5e7f9ff33b5c8ba80174d22f563b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The roadmap lists what 2.5.0 shipped under Shipped.
+
+- [#419](https://github.com/softistx/nxgt-material/pull/419) [`2a41ae1`](https://github.com/softistx/nxgt-material/commit/2a41ae13664b425c6c7d37b921e95914eabb2552) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Slider`: a single value's readout input, which had no name, is named as its
+  thumb is — your `aria-labelledby`, else your `aria-label`, else the label —
+  and "Value" (`material.slider.value`, en and fr) when nothing names the
+  slider. `NumberField` takes an `aria-labelledby`, for an input that is a
+  part of a larger field. If you override the bundles or ship another
+  language, translate the new key.
+
+- [#420](https://github.com/softistx/nxgt-material/pull/420) [`f4ca69b`](https://github.com/softistx/nxgt-material/commit/f4ca69ba5dd7b80f92cdd5374cf6fd01f155784d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `@nxgt/material-vue` takes the remaining options of `@nxgt/material`, under the same names. Nothing renders differently for code that does not use them; the one change in behaviour, `toAttributeFormSchema`'s error paths, is described after this list:
+  
+  - `Autocomplete` and `AutocompleteFormField` are generic: `options` takes your own option type, read by `get-option-value` / `get-option-label`, and the `#option`, `#selected-leading` and `#actions` slots (React's `renderOption`, `renderSelectedLeading`, `actions`) receive it. `free-solo-label` names the free-solo button.
+  - `FilesFormField`: a free-solo autocomplete of file URLs bound to vee-validate, with image thumbnails (`image`, `image-link-builder`).
+  - `ConfirmationDialog` `form-options`: a Zod 4 schema (or any Standard Schema, or a vee-validate typed schema) and its `defaultValues`; the `#form` slot renders the fields, confirm waits for a valid form, and `@confirm` receives the parsed values. The form's code (and vee-validate) loads only for a dialog with `form-options`; if it cannot load, after one retry, the dialog says so (`material.confirm-dialog.form-failed`, also added to `@nxgt/material`'s bundles so the keys stay the same).
+  - `DateField` and `DateRangeField` `disabled-days`: React's day rules (a day, a list, a range, before / after, days of the week, a function, or a list of those). `DayMatcher` and `DisabledDays` are exported.
+  - `SliderField` `ticks`, `leading` and `trailing` (props, or `#leading` / `#trailing` slots).
+  - `Avatar` `status` and `status-pulse`: a presence dot named Online, Away, Busy, Offline or Active.
+  - `QRCode` `#logo` slot (the default slot still works).
+  - `AccordionCard` `#header`, `#title` and `#content` slots.
+  - `SelectField` `#option` slot.
+  - `CodeEditor` `options`: Monaco's own construction options, passed through (`CodeEditorOptions` is exported). Monaco stays client-only.
+  - `Tabs` `variant="line"` (`TabsVariant` is exported).
+  
+  `Autocomplete`, `AutocompleteFormField`, `ConfirmationDialog` and `FilesFormField` are generic components now (`<script setup generic>`): templates infer the option and schema types, but `InstanceType<typeof Autocomplete>` no longer type-checks; use `ComponentExposed` from `vue-component-type-helpers` instead if you need the instance type.
+  
+  `toAttributeFormSchema` (exported from `@nxgt/material-vue`) now goes through the same Standard Schema adapter as `ConfirmationDialog`: an option's error is reported at `options[0]` rather than `options.0`, and each field has one entry holding all its messages.
+  
+  `@nxgt/material`'s README and component pages name these Vue counterparts, and its `SliderField` reads its tick positions from `@nxgt/material-core/slider-ticks`, the same code as before.
+- Updated dependencies [[`d90a68b`](https://github.com/softistx/nxgt-material/commit/d90a68b8f16759b44929effc426b6c3964e92a4c), [`812c101`](https://github.com/softistx/nxgt-material/commit/812c10115278480852852084ddf06b016239e6d4), [`f4ca69b`](https://github.com/softistx/nxgt-material/commit/f4ca69ba5dd7b80f92cdd5374cf6fd01f155784d), [`99878c9`](https://github.com/softistx/nxgt-material/commit/99878c9bdb0d4c33fd6a777970c4f3735bd5ef3b)]:
+  - @nxgt/material-core@0.3.0
+
+## 2.5.0
+
+### Minor Changes
+
+- [#417](https://github.com/softistx/nxgt-material/pull/417) [`920e6d5`](https://github.com/softistx/nxgt-material/commit/920e6d5f176ba3050ecb8f0ae390ce9d915cf4f7) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `DataTable`: a `loading` prop. With no row to show, the body is skeleton rows
+  (`Skeleton`), one cell per visible column, as many as the page size or
+  `loadingRows`; with rows already shown, they stay in place, dimmed and
+  `inert`, so a refresh does not move the page. The table is `aria-busy` and a
+  visually hidden status says "Loading data…" (`material.table.loading`, en and
+  fr: translate it if you override the bundles or ship another language).
+  Sorting (`DataTableColumnHeader`), the `select` column's "Select all", the
+  toolbar's native controls and pagination (`DataTablePagination`'s new
+  `disabled`) are disabled meanwhile; the toolbar is now a `<fieldset>`.
+  
+  An `empty` prop (a node, or `({ filtered }) => node`) replaces the "No data
+  available" row, inside a `TableEmpty` spanning every visible column;
+  `filtered` is `true` when rows exist but none matches the column filters. The
+  default empty row is a `TableEmpty` too, and spans the visible columns rather
+  than every defined one, as an expanded row now does. An `empty` that renders
+  nothing gets the default. New types: `DataTableEmpty`, `DataTableEmptyState`.
+  
+  The table body's `max-h-[300px] overflow-auto` is gone: a table row group is
+  neither clipped nor scrolled, so it never had an effect (the wrapper's
+  `max-h-[400px]` still scrolls the table).
+
+- [#414](https://github.com/softistx/nxgt-material/pull/414) [`79887f0`](https://github.com/softistx/nxgt-material/commit/79887f0554ff018c71969d623d06adc56ac1ebd2) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `@nxgt/material` gains components and helpers `@nxgt/material-vue` already had, under the same public names unless noted:
+  
+  - **`Camera`** is exported, with `useCamera`, `useCameraContext`, `capturePhotoFromVideo`, `isCameraSupported`, `requestCameraPermissions`, `getCameraDevices` and their types. `createCameraStore` is React's counterpart to Vue's `useCameraStore`. `Camera` renders in the browser only, after mount, so it is safe in an SSR page, and each `Camera` keeps its own state.
+  - **`NativeSelect`**, `NativeSelectOption` and `NativeSelectOptGroup`: the browser's own `<select>`, styled; an invalid one uses the `error` colour.
+  - **`InputOTP`**, `InputOTPGroup`, `InputOTPSlot` and `InputOTPSeparator`, the parts `OtpField` is built from. `InputOTPSeparator` now has `role="separator"` and takes children.
+  - **`PaginationFirst`** and **`PaginationLast`** (double chevrons), **`TableEmpty`**, **`DialogScrollContent`**, and the **`ToastAction`** type.
+  - **`Button` `size`**: `xs`, `sm`, `default`, `lg`, and the square `icon-xs`, `icon-sm`, `icon` and `icon-lg`. A button without `size` renders as before.
+  - **`RadioGroupField`, `SliderField` and `SwitchField`**: aliases of `RadioGroup`, `Slider` and `Switch` (with `*FieldProps`), so code reads the same in both libraries. Nothing is renamed or deprecated; the full naming alignment is planned for 3.0.
+  
+  `@nxgt/material-vue`:
+  
+  - An `icon*` `Button` holding an icon is square again: the base `has-[>svg]:px-3` padding no longer survives the icon sizes.
+  - An invalid `NativeSelect` uses the library's `error` colour instead of `destructive`.
+  - `PaginationFirst` and `PaginationLast` show double chevrons, so they no longer look like Previous and Next when their text is hidden on a narrow screen.
+  - Its README and component pages name the new React counterparts.
+
+### Patch Changes
+
+- [#413](https://github.com/softistx/nxgt-material/pull/413) [`5933ad4`](https://github.com/softistx/nxgt-material/commit/5933ad4d63473935a7a7fcf84113940af763314d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Alert`: a long word or URL in the title or description wraps inside the
+  alert instead of overflowing it, and the icon keeps its size. The text
+  column now shrinks (`min-w-0`) and breaks long words, as `Banner`'s text
+  column does, and the icon sits in a `shrink-0` wrapper.
+
+- [#416](https://github.com/softistx/nxgt-material/pull/416) [`7656bd3`](https://github.com/softistx/nxgt-material/commit/7656bd39810ae873685444177a1265ac3d546022) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Button`: an `Icon` inside a button that has text (or an `aria-label` /
+  `aria-labelledby`) is now `aria-hidden`, so the button is announced "Add"
+  instead of "Icon plus Add". A `Button` holding only an `Icon` still reads it,
+  and so does one whose only other text is `aria-hidden` (a decorative count).
+  If a test of yours found such a button by "Icon {name} …", select it by its
+  text — see "A button named "Icon plus Add" is now named "Add"" in
+  `docs/troubleshooting.md`.
+
+- [#416](https://github.com/softistx/nxgt-material/pull/416) [`5f5cd1a`](https://github.com/softistx/nxgt-material/commit/5f5cd1a9fddd01af0b5d13673d8c2b614ee7609f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Fixes found by new interaction tests for `NumberField`, `ColorField` and
+  `InlineEdit`:
+  
+  - `NumberField`: without an `id`, its `label` named nothing — the input had
+    no accessible name and `getByLabelText` could not find it. The input now
+    gets a generated id (React's `useId`) when you pass none.
+  - `InlineEdit`: closing the editor with Enter, Escape, Save or Cancel put
+    focus on `<body>`; it now returns to the field. Clicking elsewhere still
+    saves and leaves focus where you clicked.
+
+- [#416](https://github.com/softistx/nxgt-material/pull/416) [`1c60b25`](https://github.com/softistx/nxgt-material/commit/1c60b25281900c4a34a9b57d742b3d213031b170) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Long content no longer breaks `ListTile`, `StatCard`, `Banner` or `Stepper`.
+  
+  - `ListTile`: a long title or an unbroken URL wraps inside the tile instead
+    of scrolling sideways, and the `leading` / `trailing` pieces keep their
+    size (a trailing chevron was squeezed to a sliver).
+  - `StatCard`: a long label, value or hint wraps inside the card instead of
+    running out of it; the icon and the delta keep their size.
+  - `Banner`: a long title or description wraps instead of scrolling sideways;
+    the icon keeps its size.
+  - `Stepper`: a long step title or label truncates with an ellipsis instead of
+    scrolling inside its step.
+
+- [#416](https://github.com/softistx/nxgt-material/pull/416) [`c3f5881`](https://github.com/softistx/nxgt-material/commit/c3f58819181579a26bcf00dea37438903f33fc4c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PaginationPrevious` / `PaginationNext`: with a `label` that is not a string
+  (an element), the link's `aria-label` fell back to English "Previous" /
+  "Next" whatever the language. It now uses the translated
+  `material.pagination.previous` / `next`, as `@nxgt/material-vue` does. The
+  new `PaginationFirst` / `PaginationLast` use `material.pagination.first` /
+  `last` the same way.
+
+- [#413](https://github.com/softistx/nxgt-material/pull/413) [`9894685`](https://github.com/softistx/nxgt-material/commit/9894685ef7a805c9af7cf01f2edb4bc36174a9af) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Filter`: a `number-range` field is now a `role="group"` named by its label
+  (and described by its description and error), so two range filters no longer
+  read as "Min", "Max", "Min", "Max"; the inputs keep "Min" and "Max" as their
+  part names, as `DurationField` does. A labelled range `Slider` (the
+  `slider-range` filter included) is a group named by its label too, and its
+  readout inputs, which had no name, are named "Minimum" and "Maximum"
+  (`material.slider.minimum` / `maximum`, en and fr). If you override the
+  bundles or ship another language, translate the two new keys.
+
+- [#411](https://github.com/softistx/nxgt-material/pull/411) [`c346b2b`](https://github.com/softistx/nxgt-material/commit/c346b2be2acae80990ae3b8e937b652db30c240b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The roadmap (`docs/roadmap.md`) lists the upcoming component work: the fixes
+  in progress, the exports shared with `@nxgt/material-vue`, and the
+  `DateRangeField` presets, `TreeSelectField`, `DataTable` loading and empty
+  states and `FilePreview` to follow. Range filters in a `Filter` schema, which
+  already render, are listed as shipped.
+
+- [#413](https://github.com/softistx/nxgt-material/pull/413) [`95576c4`](https://github.com/softistx/nxgt-material/commit/95576c44ae76dac1b21e556b21b39443b1359b0b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Spinner` (`variant="1"`): `color="light"` is white again and `color="default"`
+  follows the foreground colour. The variant listed `default` twice, so
+  `default` rendered white and `light` had no colour, which made a spinner on a
+  dark surface (the player's buffering indicator) look static. A filled
+  `Button` with `spinnerVariant="1"` gets a white loading spinner again too.
+
+- [#416](https://github.com/softistx/nxgt-material/pull/416) [`8265d9a`](https://github.com/softistx/nxgt-material/commit/8265d9af7aaf9715e1a96d56de2bf62324c21f06) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Stepper`: step ids are unique per stepper, and the steps say their state to
+  assistive tech.
+  
+  - Each step's `id` was a static `step-N`, so two steppers on one page
+    produced duplicate ids. It is now prefixed with React's `useId`.
+    **Note:** if a test or stylesheet of yours targets `#step-N`, select the
+    step by `data-pw` instead (`step-N`, or `<name>-step-N`), which did not
+    change — see "A `Stepper` step selected by `#step-N` stops matching" in
+    `docs/troubleshooting.md`.
+  - The steps are an `<ol>` of `<li>`; the current step's button carries
+    `aria-current="step"`; a completed or failed step adds visually hidden text
+    (`material.stepper.completed`, `material.stepper.error`) so a screen reader
+    does not depend on the icon.
+  - A long step title no longer widens its column or pushes the next step: the
+    columns are `minmax(0, 1fr)` and the title truncates with an ellipsis.
+
+- [#415](https://github.com/softistx/nxgt-material/pull/415) [`19c92f3`](https://github.com/softistx/nxgt-material/commit/19c92f348664ed7d49810006748a494fbeed5b60) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `@nxgt/material-vue` gains the exports `@nxgt/material` already had, under the
+  same names:
+  
+  - `Checkbox` takes `label` and `helper-text` (or the `#label` and
+    `#helper-text` slots) and then renders the box in a labelled row. Without
+    them it is the same bare Reka UI box as before. `CheckboxFormField` is its
+    vee-validate wrapper: an unset value shows as indeterminate, and an
+    indeterminate value is written as `null`.
+  - `InlineEditFormField` (the value changes on save) and `CodeEditorFormField`
+    (Monaco still loads in the browser only).
+  - `PaginationBar` (`v-model:page`, `page-count`, `sibling-count`), the
+    `paginationItems` window it renders, and `PaginationLink`.
+  - `CopyValue`, a value in a monospace chip with its copy button.
+  - `MermaidDiagram`, one mermaid chart rendered in the browser only.
+  - The `Doc` parts `DocArticle`, `DocNav`, `DocLink`, `DefaultDocLink` and
+    `DocCopyPage`, with the `DocArticleProps`, `DocNavProps` and `DocLinkProps`
+    types, to build a documentation shell of your own.
+  
+  Fixed in `Doc`: a parent's `@navigate` runs once per click (it ran twice);
+  without a navigate handler the links are plain anchors again, instead of
+  links that went nowhere; and the shell follows later `pathname`, `items`,
+  `toc`, `previous` and `next` changes, so the active entry tracks the route.
+  
+  The Nuxt module registers the new components. In `@nxgt/material`, the README
+  and component pages name these Vue equivalents and list what is still
+  React-only.
+
+## 2.4.2
+
+### Patch Changes
+
+- [#409](https://github.com/softistx/nxgt-material/pull/409) [`a31ce5f`](https://github.com/softistx/nxgt-material/commit/a31ce5f1db0a6feae418c49d14b845321957cbbc) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `ActionCard` (`variant="sm"`): the check indicator now stays at the right
+  edge of the card. It sat right after the title and description, so it moved
+  with their length; the text now fills the row, as in `@nxgt/material-vue`. With
+  `variant="md"` and no `icon`, the indicator is at the right edge too.
+
+## 2.4.1
+
+### Patch Changes
+
+- [#406](https://github.com/softistx/nxgt-material/pull/406) [`b890457`](https://github.com/softistx/nxgt-material/commit/b8904573f18dc6d0cdd16f62146183ff0b7aef18) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Internal: `formatFileSize` and the pdfkit font resolution behind
+  `withNxgtPrint` (`@nxgt/material/next`) now come from `@nxgt/material-core`
+  (`/format-file-size`, `/pdfkit-fonts`), shared with `@nxgt/material-vue`,
+  instead of a copy in this package. No API change: `formatFileSize` is still
+  exported by name, and `withNxgtPrint` adds the same globs, warns at most once
+  with the same `[@nxgt/material/next]` prefix (that one warning now lists
+  every resolution problem, joined by `; `, instead of only the first), and
+  still skips fonts on
+  another Windows drive with a warning. `@nxgt/material/next` now imports that
+  core subpath besides `node:*` built-ins; your install already has
+  `@nxgt/material-core`.
+- Updated dependencies [[`bf43a14`](https://github.com/softistx/nxgt-material/commit/bf43a14abb147e6dcd2bcac5f1e0e359b0aae6a2), [`b890457`](https://github.com/softistx/nxgt-material/commit/b8904573f18dc6d0cdd16f62146183ff0b7aef18)]:
+  - @nxgt/material-core@0.2.0
+
+## 2.4.0
+
+### Minor Changes
+
+- [#404](https://github.com/softistx/nxgt-material/pull/404) [`dcbd54a`](https://github.com/softistx/nxgt-material/commit/dcbd54a34ef86a6a517870b854fec28f6cfffc14) Thanks [@SteveGT96](https://github.com/SteveGT96)! - New subpath `@nxgt/material/next`: `withNxgtPrint(nextConfig)` makes a
+  Next.js config ready for route handlers that import `@nxgt/material/print`.
+  
+  ```ts
+  // next.config.ts
+  import { withNxgtPrint } from '@nxgt/material/next';
+  
+  export default withNxgtPrint({ output: 'standalone' });
+  ```
+  
+  It adds `'@nxgt/material'` to `serverExternalPackages` (route handlers are
+  bundled with React's `react-server` build, which has no `createContext`), and
+  pdfkit's `.cjs` fonts, with the chunk they `require`, to
+  `outputFileTracingIncludes` for every route, so `.next/standalone/server.js`
+  run alone can render PDFs. pdfkit is resolved through `@react-pdf/renderer`
+  and `@react-pdf/font` to its real directory, so the glob follows the
+  installation (checked end to end under npm and pnpm). Both lists are merged, never overwritten.
+  Without `@react-pdf/renderer` no fonts are added; any other resolution failure
+  prints one warning. The function form of `next.config` is accepted too, and
+  `{ dir }` sets the project directory (default `process.cwd()`).
+  
+  It runs in Node at config time, imports only `node:*` built-ins, and adds no
+  dependency: `next` is not a peer, the config is typed structurally and the
+  type you pass in is the type you get back.
+
+### Patch Changes
+
+- [#403](https://github.com/softistx/nxgt-material/pull/403) [`6a4938e`](https://github.com/softistx/nxgt-material/commit/6a4938e8624fbb5802a9835bc510e441d5fee4de) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The French UI now says « Enregistrer » for the save action everywhere:
+  `material.buttons.save` read « Sauvegarder » while every component's own `save`
+  key already read « Enregistrer ». Consumers who assert on the French label in
+  their own tests will now see « Enregistrer ».
+
+- [#401](https://github.com/softistx/nxgt-material/pull/401) [`69d5de5`](https://github.com/softistx/nxgt-material/commit/69d5de5cc8891d7bfc2e22747cba8516085cf952) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The printing guide and troubleshooting page now cover Next.js. A route
+  handler that imports `@nxgt/material/print` needs
+  `serverExternalPackages: ['@nxgt/material']`, or `next build` stops with
+  `TypeError: (0 , t.createContext) is not a function` (route handlers are
+  bundled with React's `react-server` build). With `output: 'standalone'`, add
+  `outputFileTracingIncludes: { '/**': ['./node_modules/pdfkit/js/standard-fonts/**/*.cjs'] }`:
+  the tracer copies only the `.mjs` fonts, and a webpack build's standalone
+  server answered every PDF request with
+  `Cannot find module '…/node_modules/pdfkit/js/standard-fonts/Helvetica.cjs'`.
+  `withNxgtPrint` (above) sets both for you; the manual config stays documented
+  as the fallback.
+
+- [#402](https://github.com/softistx/nxgt-material/pull/402) [`6fe042b`](https://github.com/softistx/nxgt-material/commit/6fe042b212896c58bdfd831cc663fa2806d7d657) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `NetworkUploadField`, its size-limit messages ("File exceeds maximum size of
+  …", the drop zone's "Max 2.0 MB") and the chat composer's attachment chip now
+  format sizes with the exported `formatFileSize`, as `FileList` and `FileCard`
+  already did. A negative, `NaN` or infinite size now shows nothing instead of
+  `NaN undefined` or `Infinity GB`; every other size reads as before.
+
+## 2.3.1
+
+### Patch Changes
+
+- [#398](https://github.com/softistx/nxgt-material/pull/398) [`b4e5770`](https://github.com/softistx/nxgt-material/commit/b4e5770922ad4582a1ad2dcca439f7c8c999a0c7) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Docs: the roadmap's Shipped list now has 2.3.0 — the framework-free code comes from `@nxgt/material-core`, with the same imports as before.
+- Updated dependencies [[`1abb908`](https://github.com/softistx/nxgt-material/commit/1abb90800ec213d8ec98abd7df5dda9f65c14204), [`b4e5770`](https://github.com/softistx/nxgt-material/commit/b4e5770922ad4582a1ad2dcca439f7c8c999a0c7)]:
+  - @nxgt/material-core@0.1.1
+
+## 2.3.0
+
+### Minor Changes
+
+- [#391](https://github.com/softistx/nxgt-material/pull/391) [`deaf0c4`](https://github.com/softistx/nxgt-material/commit/deaf0c49cbc2268fd20e9e2272104dbd27e4ce7f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `@nxgt/material` now depends on a new package, `@nxgt/material-core`, which
+  your install adds on its own: there is nothing to change in your
+  `package.json` or your imports.
+
+  `@nxgt/material-core` holds the code `@nxgt/material` and
+  `@nxgt/material-vue` used to ship as two identical copies: the PDF document
+  model and its renderer, the print formatters (`formatAmount`, `formatDate`,
+  `createFormatters`), the column and value helpers of `/print`, the PDF file
+  helpers behind `PdfReader` and `usePdfFile`, the page geometry, scroll spy
+  and text search inside `PdfReader`, the decimals of `CurrencyField`, the rule
+  that keeps a field from blurring while focus is in its own popover, and
+  `pdfkitStandardFonts()`.
+  `@nxgt/material/print`, `/lib`, `/vite` and the other entries export exactly
+  the same names as before, with the same types, and now import that code from
+  `@nxgt/material-core` instead of bundling it.
+
+  One case to check: a server bundled into a single file and run **without**
+  `node_modules` must bundle `@nxgt/material-core` too, like any other
+  dependency of `@nxgt/material` — a bundler that inlines everything already
+  does. A server that keeps `node_modules` loads it from there. With Vite, list both:
+  `ssr: { noExternal: ['@nxgt/material', '@nxgt/material-core'] }`. Without it
+  the server fails at boot with `Cannot find package '@nxgt/material-core'`
+  ([troubleshooting](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/troubleshooting.md#cannot-find-package-nxgtmaterial-core)).
+
+### Patch Changes
+
+- [#387](https://github.com/softistx/nxgt-material/pull/387) [`673ef71`](https://github.com/softistx/nxgt-material/commit/673ef712137e4b9158bdc857c754922952d6d259) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The rich-text editor now uses tiptap 3.31.3 (from 3.29.2), the version
+  `@nxgt/material-vue` already ships. The tiptap packages are regular
+  `dependencies` of `@nxgt/material`, not peers, so nothing changes in your own
+  `package.json`: their ranges are now `^3.31.3`, and your install picks it up.
+  The editor code is bundled, so the upgrade comes with the package either way.
+
+  What you may notice in `RichTextEditor`:
+
+  - **Security fixes.** ProseMirror's view is now 1.42.3, which fixes an XSS
+    where pasting crafted HTML could run script
+    ([GHSA-c8x8-7fp4-3x9w](https://github.com/advisories/GHSA-c8x8-7fp4-3x9w)).
+    Tiptap also stops untrusted HTML attributes from reaching an object's
+    prototype through `mergeAttributes`, and crafted Markdown attributes can no
+    longer spin the CPU.
+  - **Lists.** Tab at the start of a paragraph right after a list now moves the
+    paragraph into the list's last item.
+  - **Fixes.** The custom node views (callout, gallery, action card, radio
+    group, accordion, checkbox group, select card and select chip) no longer
+    freeze on iOS and Android and render faster in long documents; a YouTube
+    `/live/` link embeds, and a pasted iframe without `src` no longer crashes
+    the editor; unsetting one text style inside a blockquote keeps the others.
+
+  Code highlighting uses `highlight.js` 11.12.0 in `CodeBlock` (and so in
+  Markdown code fences and `ChatMarkdown`) and `highlight.js` 11.11.2 under
+  `lowlight` in the editor's code blocks (both were 11.11.1). Mermaid and nivo charts are
+  unchanged: only the internal `d3-format` and `d3-time-format` imports of the
+  bundled `d3-scale` moved to the versions Mermaid already used, and no rendered label is expected
+  to change.
+
+  If your app installs `@tiptap/*` itself below 3.31.3, a second copy is
+  nested under `@nxgt/material`. It works at runtime (the editor is bundled),
+  but an `onUpdate` or `onCreate` handler typed with your own `Editor` can
+  fail to type-check with "Types have separate declarations of a private
+  property": raise your tiptap packages to `^3.31.3`, or leave the handler's
+  argument unannotated. See [troubleshooting](https://cdn.jsdelivr.net/npm/@nxgt/material@2/docs/troubleshooting.md#types-have-separate-declarations-of-a-private-property-on-a-richtexteditor-onupdate-or-oncreate-handler), which gains that entry,
+  and a line in `RichTextEditor`'s component docs.
+
+- Updated dependencies [[`deaf0c4`](https://github.com/softistx/nxgt-material/commit/deaf0c49cbc2268fd20e9e2272104dbd27e4ce7f)]:
+  - @nxgt/material-core@0.1.0
+
+## 2.2.0
+
+### Minor Changes
+
+- [#374](https://github.com/softistx/nxgt-material/pull/374) [`638b8d1`](https://github.com/softistx/nxgt-material/commit/638b8d152de495f9b66d2d9d53e919ade329b69e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `CurrencyField` / `CurrencyFormField`: new `fractionDigits` option. The amount
+  is shown with the currency's own decimals by default (ISO 4217: `JPY` 0,
+  `EUR` 2, `KWD` 3), the rule `formatAmount` follows in this release too; it
+  always showed two before. Pass `fractionDigits={2}` to keep two decimals whatever the
+  currency; it is clamped to 0–20 (the range every `Intl.NumberFormat`
+  accepts), and `NaN` or `Infinity` counts as not given. The emitted number is
+  unchanged.
+  
+  The helpers guide now says which formatter to use: `useFormatters()`'s
+  `formatAmount` for money, `useNumberFormatter()` for the other
+  `Intl.NumberFormat` styles.
+
+- [#315](https://github.com/softistx/nxgt-material/pull/315) [`994e63b`](https://github.com/softistx/nxgt-material/commit/994e63b1d1c8561aeb1e3cb2cb7be8d229132bd7) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `ScrollArea` and `ScrollBar` are exported from `@nxgt/material/components` (and `@nxgt/material`)
+  
+  The themed scroll container that `Filter`, `SortableList`, `PdfReader`,
+  `StxPlayer`'s queue, the notifications list and `EventCalendar` already use
+  inside is now public, as it is in `@nxgt/material-vue`. Give it a height and it
+  scrolls whatever overflows, with a thin scrollbar that matches the theme
+  (`type` controls when the bar shows; `hover` by default).
+  
+  ```tsx
+  import { ScrollArea } from '@nxgt/material/components';
+  
+  <ScrollArea className="h-72 w-48 rounded-md border">{children}</ScrollArea>;
+  ```
+
+- [#301](https://github.com/softistx/nxgt-material/pull/301) [`91b3d80`](https://github.com/softistx/nxgt-material/commit/91b3d8019dd8a9507fea1ba2507f0f9efca4e788) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Form wrappers honour your `disabled` and `helperText`, and composite fields show their errors.
+  
+  - `TextFormField`, `AutocompleteFormField` (and so `CountryFormField`), `CheckboxFormField`, `CheckboxGroupFormField`, `SwitchFormField`, `CheckCardFormField`, `DateFormField`, `DateRangeFormField`, `UploadFormField`, `NetworkUploadFormField`, `S3UploadFormField`, `FilesFormField`, `CodeEditorFormField`, `RichTextEditorFormField`, `LocationFormField` and `InputGroupFormField` used to overwrite the `disabled` and `helperText` you passed with the form state. Every wrapper now follows one rule: the field is disabled when you pass `disabled` **or** the form disables it, and your `helperText` shows until there is an error. `RichTextEditorFormField` keeps your `editable={false}`. `SwitchFormField` now also passes `error`, so its message is red.
+  - Wrappers that already honoured `disabled` used `props.disabled ?? field.disabled`, so `disabled={false}` re-enabled a field that `useForm({ disabled })` had disabled. The form now wins.
+  - `ContactsFormField`, `OpeningHoursFormField` and `PostalAddressFormField` passed only their own `disabled` and ignored `useForm({ disabled })`; they follow the same rule now.
+  - `ContactsFormField` and `OpeningHoursFormField` showed only `errors.<name>.root`; an array-level rule such as `z.array().min(1)` (on `errors.<name>.message`) was never displayed. Both are shown now, and a nested `name` works.
+  - `AttributesFormField` shows the field's error, and follows `form.reset()` / `form.setValue()` instead of reading its value only on mount. `AttributesField` gains `error` and `helperText` props and follows a change in the value of its `attributes` prop (a new array with the same content, as `attributes={list.map(...)}` gives on each render, is not a change); `AttributesFormField` gains `helperText`.
+  - `FilesFormField`: the image thumbnail's class `ronded` is now `rounded`.
+
+- [#302](https://github.com/softistx/nxgt-material/pull/302) [`6a022fc`](https://github.com/softistx/nxgt-material/commit/6a022fc637a3e0746c1509361748c00611f25ea5) Thanks [@SteveGT96](https://github.com/SteveGT96)! - i18n fallbacks are formatted, and Zod messages are English in English
+  
+  - Components rendered without an `I18nProvider` no longer show raw ICU
+    placeholders: the Stepper reads `Step 01` (not `Step {step}`), the
+    JsonViewer `3 items` (not `{count} items`), the Kanban WIP badge `3/5`, and
+    so on. `useMaterialTranslation().t(key, fallback, values)` now formats the
+    fallback with `values`, with or without a provider, and on a server. A
+    fallback that cannot be formatted (a stray `{`) is shown as written, with a
+    `[@nxgt/material] Could not format the fallback` warning in development
+    only. Plain fallbacks are not parsed at all.
+  - `zodLocaleError()`'s `invalid_type` messages were French in the English
+    bundle. They are English now (`This value must be a number.`), and a type
+    with no message of its own gets `This value has the wrong type.` instead of
+    its raw key.
+  - `zodLocaleError()` no longer throws on a server or when storage is blocked:
+    it writes English. It takes optional `{ storageKey, language, translate }`
+    so it can read the `storageKey` you gave `I18nProvider`, follow a language
+    you pass, and format through your own merged translator so your
+    `material.zod.*` overrides apply. Calling it with no argument behaves as
+    before.
+
+- [#323](https://github.com/softistx/nxgt-material/pull/323) [`2a1c366`](https://github.com/softistx/nxgt-material/commit/2a1c3664d32c47e20a19b05edeae4d140e03cd40) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The rich-text editor, carousel, camera, autocomplete, QR code and barcode follow `I18nProvider`
+  
+  121 keys join the `material` bundles, in English and French, with the same
+  names and the same French as `@nxgt/material-vue`:
+  
+  - `material.rich-text-editor.*` (111): every toolbar tooltip, the table menu,
+    the table, callout, accordion, action-card, gallery, selector, checkbox and
+    radio group dialogs and forms, the colour picker's `Clear`, the slash menu's
+    `No matching commands`, and the `words` / `characters` counter. The
+    dialogs' `Save` and the colour picker's `OK` use the existing
+    `material.buttons.save` / `material.buttons.ok`.
+  - `material.carousel.previous` / `next` (the arrows' screen-reader text),
+    `material.camera.*` (capture button, captured image `alt`, and a new
+    start/stop tooltip on the stream toggle, which had no accessible name),
+    `material.autocomplete.add` (`Add "{query}"`) and `empty`.
+  - `material.qrcode.label` and `material.barecode.label`: `QRCode` and
+    `Barecode` now render with `role="img"` and an accessible name. `Barecode`
+    wraps its drawing in an `inline-flex` `<span data-slot="barecode">` sized to
+    the barcode (`max-w-full`), because react-barcode forwards only `id` and
+    `className`; its `aria-label` goes on that wrapper, and a `className` still
+    reaches the barcode element. `QRCode`'s `title` names the code through
+    `aria-label` only and no longer renders an `<svg><title>`, which announced
+    the text twice.
+  
+  Without a provider the English is what it was. Anything you pass still wins
+  over the translation: `CarouselPrevious`/`CarouselNext` children,
+  `Autocomplete`'s `freeSoloLabel` and `empty`, the editor's
+  `options.labels.save` / `cancel`, `QRCode`'s `title` or `aria-label`, and
+  `Barecode`'s `aria-label`.
+
+- [#331](https://github.com/softistx/nxgt-material/pull/331) [`0dca729`](https://github.com/softistx/nxgt-material/commit/0dca72985506ae1630433fe9896c8f42118c8087) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The calendar, data table, filter, spinner, scroll-to-top, network upload, map marker and the editor's slash menu, fonts and table alignment follow `I18nProvider`
+  
+  82 keys join the `material` bundles, in English and French, with the same
+  names and the same French as `@nxgt/material-vue`:
+  
+  - `material.rich-text-editor.*` (47): the slash menu's group, item titles and
+    descriptions (`slash-menu.*`), the font menu (`font-default`, `font-sans`,
+    `font-serif`, `font-mono`) and the table-caption alignment choices
+    (`table-align-left` / `-center` / `-right`).
+  - `material.filter.*` (19): `min`, `max`, and the presets menu and dialog
+    (`presets.*`).
+  - `material.calendar.*` (9): the previous/next month and year tooltips, the
+    year view's paging, `Go to Today`, and the caption button's label.
+  - `material.table.labels.select-all` / `select-row`,
+    `material.upload.retry` / `remove`, `material.spinner.loading`,
+    `material['scroll-to-top'].label`, `material.map.you-are-here`.
+  
+  The slash menu filters on the translated title and description and on the
+  English ones, accent-insensitively; `RichTextEditor` hands the menu its own
+  translator, so there is nothing to wire.
+  
+  Without a provider the English is unchanged. An explicit label still wins:
+  `Spinner`'s `aria-label` now reaches the `variant="4"` SVG, and
+  `LocationMarker`'s `tooltip` prop is no longer overwritten by `You are here`.
+
+- [#358](https://github.com/softistx/nxgt-material/pull/358) [`6281850`](https://github.com/softistx/nxgt-material/commit/62818500e16295ef5845587b60f062b6f2f605e3) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PrintDataTable`, `PrintKeyValue` and `PrintMetric`: printed tables and figures from column definitions
+  
+  - **`PrintDataTable`** (`@nxgt/material/print`) prints `rows` through
+    `columns` from `definePrintColumns<T>()`: a `key` or an `accessor`, a
+    `label`, a `width` in points or percent or a `flex` share, an `align`
+    (right by default for figures), a `format` (`'amount'`, `'date'`,
+    `'number'`, `'percent'` or your own function), a `currency` per column or
+    per row, and a `total` (`'sum'` or your own). The header repeats on each
+    page the table crosses, rows never split (`keepRowsWhole`), rows stripe
+    (`striped`), a totals row closes the table, and an empty table shows one
+    "No rows" row (`emptyText`, or `hideWhenEmpty`). Amounts and dates follow
+    the `PrintDocument`'s locale.
+  - **`PrintKeyValue`**: label and value pairs in one or two columns, from
+    `items` or from `data` with the same column definitions as `fields`; empty
+    values are skipped unless `keepEmpty`.
+  - **`PrintMetric`** / **`PrintMetrics`**: a figure with its label, hint and
+    change (`+4%`), the printed `StatCard`, lined up in a row.
+  - **`resolvePrintTable`**, **`resolvePrintFields`**, **`toPrintValue`** and
+    the `PrintValue` helpers (`formatPrintValue`) are exported from `/print`
+    too, for your own blocks.
+  - New i18n keys `material.print.table.total` and `material.print.table.empty`,
+    in English and French.
+
+- [#358](https://github.com/softistx/nxgt-material/pull/358) [`4221b82`](https://github.com/softistx/nxgt-material/commit/4221b8213d7743023395f352da1d63090c7b4734) Thanks [@SteveGT96](https://github.com/SteveGT96)! - One call to a PDF file, and the document model, from `@nxgt/material/print`
+  
+  - **`renderPdfBlob(doc)`**, **`renderPdfBuffer(doc)`** (a `Uint8Array`, in
+    the browser or on Node/Bun) and **`renderPdfStream(doc)`** (a Web
+    `ReadableStream`, Node 18+ or Bun).
+  - **`downloadPdf(doc | blob, { fileName })`** saves the file
+    (`document.pdf` by default; `.pdf` is added), and **`openPdf(doc | blob)`**
+    opens it in a new tab — the tab opens before rendering so popup blockers
+    let it through, and a blocked tab falls back to a download.
+  - **`pdfResponse(doc, { fileName, disposition, headers })`**: a Web
+    `Response` with the PDF's type, length and an RFC 6266 file name, for a
+    React Router loader, a Next route handler, Hono or `Bun.serve`;
+    **`contentDisposition(disposition, fileName)`** builds that header for a
+    response of your own (Express, a Node stream).
+  - **`usePdfFile(doc)`**: `{ blob, url, loading, error, refresh }`, the
+    object URL revoked when replaced or unmounted.
+  - `doc` is a react-pdf element (such as a `<PrintDocument>`) **or a document
+    model**: plain data built with the new builders (`pdfDocument`,
+    `definePdfDocument`, `page`, `heading`, `text`, `table`, `keyValue`,
+    `totals`, `metric`, `badge`, `header`, `dataTable` and `keyValueOf` from
+    the same column definitions as `PrintDataTable`, …), which can be built on a server
+    and sent as JSON. A `definePdfDocument` template annotates its data
+    parameter, and its other parameters may take defaults
+    (`(invoice: Invoice, language = 'en') => …`). A model is rendered with the package's translations
+    (`language`) and `@nxgt/material` as its creator. The model is
+    `@experimental`: it may still change in a minor release.
+
+- [#358](https://github.com/softistx/nxgt-material/pull/358) [`90aa776`](https://github.com/softistx/nxgt-material/commit/90aa7768373274a0298e7155a9a7010be33ac72f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PrintDocument`: a PDF page shell with page numbers; `PrintHeader` takes a logo image
+  
+  - **`PrintDocument`** (`@nxgt/material/print`) replaces the `Document` +
+    `Page` you wrote by hand: `size`, `orientation`, `margins`, the PDF
+    metadata (`title`, `author`, `subject`, `keywords`, `creator`, `producer`),
+    a `header` and a `footer` repeated on every page, `pageNumbers` ("Page 2 of
+    5", translated) and a `watermark`. A `footer` may be a function of
+    `{ pageNumber, totalPages }` returning text. Its `language` defaults to the
+    `I18nProvider` around the document, then `'en'`.
+  - **`translateMaterial(language, key, fallback, values)`** (`@nxgt/material/i18n`):
+    the package's own strings for a language given as a value, with no
+    provider and no hook, for a PDF's page-number callback or a server.
+    `useMaterialTranslation().t` now goes through it, so a regional language
+    such as `'fr-CA'` reads the French strings instead of falling back to
+    English.
+  - New i18n keys `material.print.page-of` and `material.print.page`, in
+    English and French.
+  - **`PrintHeader`**: a `logo` image (URL or data URL, or
+    `{ src, width, height }`), a `subtitle` and a `referencePrefix` (`'#'` by
+    default). **Changed:** with no `logo` and no `logoText` it no longer draws
+    a grey "LOGO" placeholder, and with no `qrDataUrl` no empty QR box; the
+    title stays centred. Pass `logoText="LOGO"` to keep the old box.
+  - French amounts print correctly (also inside mixed text such as
+    `{amount} TTC`, and in a `PrintDocument` footer function) in `PrintSection`, `PrintInfoRow`,
+    `PrintTableCell`, `PrintTotalRow`, `PrintCardField` and `PrintBadge`: the
+    narrow no-break space `Intl` puts in `1 234,50 €` used to print as a slash
+    (`1/234,50 €`) in the standard fonts.
+  - **Peer floor raised:** `@react-pdf/renderer` is now `^4.9`, the version
+    the page shell and `pdfkitStandardFonts()` are built and tested against
+    (pdfkit 0.20). Upgrade with
+    `bun add @react-pdf/renderer@^4.9` (or `npm i @react-pdf/renderer@^4.9`).
+
+- [#350](https://github.com/softistx/nxgt-material/pull/350) [`d043779`](https://github.com/softistx/nxgt-material/commit/d0437794584c9f4e49a2bc7f88299da5cedaac32) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader` opens any source: `file` takes a `Blob` (a generated PDF, a
+  `File`), an `ArrayBuffer` or a `Uint8Array`, a `URL`, or
+  `{ url, httpHeaders, withCredentials }` for a URL that needs a token, as well
+  as a URL string. The new `PdfSource` and `PdfUrlSource` types are exported.
+  
+  - Bytes are copied: pdf.js empties the buffer it is given, and yours stays
+    usable after the reader opened it.
+  - The document reloads only when it changes: a URL with the same headers, even
+    in a new object on each render, keeps the view; a Blob or a buffer is
+    compared by identity.
+  - Download and print fetch a URL source with its headers, and save a Blob or
+    bytes as they are. When that fetch fails, a URL with headers is not opened
+    in a new tab, which would load it without them. With no `fileName`, a
+    `File`'s name or a URL segment, it is named "document.pdf", translated
+    (`material.pdf-reader.default-file-name`).
+  - The headers are part of what identifies the document: new headers (a
+    renewed token) load it again, from `initialPage`.
+
+- [#332](https://github.com/softistx/nxgt-material/pull/332) [`bb0ede2`](https://github.com/softistx/nxgt-material/commit/bb0ede263ca373fd94c552c1aa8ba51f57409fd3) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader`: Download now finishes in Firefox and Safari too. The link is
+  attached before its click and the object URL is revoked a minute later, not
+  right away. A new `fileName` prop names the saved file, and a URL document is
+  named after its last path segment instead of always `document.pdf` (`.pdf` is
+  added when missing). A URL document is saved from the bytes already loaded,
+  so a cross-origin one downloads instead of navigating. Print uses a
+  same-origin copy too, and opens a new tab instead of throwing `SecurityError`
+  when the browser refuses.
+
+- [#373](https://github.com/softistx/nxgt-material/pull/373) [`be623e1`](https://github.com/softistx/nxgt-material/commit/be623e1c75d9326b3d93251585322d81cb094b2c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader` takes `externalLinkTarget` (`'_blank' | '_self' | '_parent' |
+  '_top'`, default `'_blank'`): a link to a website inside the PDF now opens in a
+  new tab, whatever the PDF asks; pass `'_self'` for the previous behaviour.
+  `rel` stays `noopener noreferrer nofollow`.
+  
+  `usePdfSource`, `toPdfjsSource` and `toPdfjsParams` are exported beside
+  `usePdfReader` (with the `PdfjsSourceParams` / `PdfjsUrlParams` types), so a
+  layout of your own opens bytes without detaching your buffer.
+  
+  `Tooltip` and `TooltipContent` take `container`, where the tooltip is
+  portalled.
+
+- [#350](https://github.com/softistx/nxgt-material/pull/350) [`e7bc71a`](https://github.com/softistx/nxgt-material/commit/e7bc71a5205fba09333b954c53be86700dbea173) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader`'s zoom menu is a `DropdownMenu`: it opens from the keyboard (Enter
+  or Space, the arrows move, Escape closes and gives focus back), its button is
+  named after the current zoom ("Zoom level 150%",
+  `material.pdf-reader.zoom-menu`), and in fullscreen it opens inside the reader.
+  Keys pressed in the menu no longer turn pages. An outline entry without a title
+  reads "Untitled" in the reader's language (`material.pdf-reader.untitled`).
+  
+  A link inside the PDF to another page goes to it through the reader, so it
+  works for a page not drawn yet and the page number follows; it used to do
+  nothing unless that page was already drawn.
+  
+  `DropdownMenuContent` takes `container`, the element the menu is portalled into
+  (`document.body` by default): pass `document.fullscreenElement` for a menu
+  opened in fullscreen.
+
+- [#350](https://github.com/softistx/nxgt-material/pull/350) [`d717ad4`](https://github.com/softistx/nxgt-material/commit/d717ad4ba7264eb91158bb4279b082a58fc88644) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `formatAmount` and `formatDate` take a locale and a time zone, and
+  `useFormatters()` / `createFormatters()` bind them.
+  
+  - `formatAmount(value, currency?, { locale?, fractionDigits? })` and
+    `formatDate(value, { locale?, timeZone?, dateStyle?, timeStyle? })`. Without a
+    `locale` they still use the runtime's (a deterministic default is planned for
+    3.0). `formatDate` also accepts a `Date` or an epoch number.
+  - `useFormatters({ locale?, timeZone? })` from `@nxgt/material/hooks` binds both
+    to the `I18nProvider` language (`en` without a provider), so a server render
+    and the browser print the same string (for a date with a time, pass
+    `timeZone`).
+  - `createFormatters({ locale?, timeZone? })` from `@nxgt/material/lib` (and
+    `/print`) binds them outside React: a server route, a PDF document.
+  
+  **Changed output.** Amounts use their currency's own decimals (ISO 4217):
+  `formatAmount(1234.5, 'JPY')` is now `¥1,235` (was `¥1,234.50`), KWD, BHD and
+  OMR show three decimals. EUR, USD, GBP and the other two-decimal currencies do
+  not change, nor does an amount without a currency. To keep two decimals, pass
+  `{ fractionDigits: 2 }`. `fractionDigits` is clamped to 0–20, as in
+  `CurrencyField`, and `NaN` or `Infinity` counts as not given.
+  
+  **Fixed.** A date-only string (`'2026-03-01'`) keeps its calendar day in every
+  time zone; west of UTC it used to show the day before.
+
+- [#303](https://github.com/softistx/nxgt-material/pull/303) [`1ccaed6`](https://github.com/softistx/nxgt-material/commit/1ccaed698045037832e261e85ed949c7e1da8fea) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Declaration files always import `react` by name, and `CircularProgressProps` is exported
+  
+  - A locally packed or linked build could ship declaration files importing
+    `'../../../node_modules/react'`. That path does
+    not exist in a consumer's install, so `ReactNode` and `ComponentProps` were
+    typed `any`, and `ConfirmationDialog` demanded `variant` and `color`.
+    Versions installed from npm were not affected; locally packed or linked
+    builds were.
+  - `CircularProgressProps` is exported from `@nxgt/material/components` (and
+    `@nxgt/material`), like the other components' props types.
+
+- [#306](https://github.com/softistx/nxgt-material/pull/306) [`6899daf`](https://github.com/softistx/nxgt-material/commit/6899daf0cc4965f02bd6f496d2108749b026ff2b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Fix a batch of visual and API rough edges:
+  
+  - **Calendar** (and the calendars in `DateField` / `DateRangeField`): weeks with two-digit days no longer push the last column out of the 312px calendar.
+  - **CodeBlock**: `scheme="dark"` now gives a dark code area too — the global `pre` / `code` styles no longer paint a light background over it. Line numbers line up with their lines.
+  - **ScrollToTop**: `variant` and `color` now reach the button.
+  - **ButtonGroup**: a `tonal` button marked `data-state="active"` now shows its label (primary foreground on the primary fill).
+  - **AvatarGroup**: fallback initials are sized to the avatar and no longer run under the next one. To make room, the overlap is shallower: `sm` / `md` / `lg` now overlap by 2 / 4 / 6px (was 8 / 10 / 12px).
+  - **HydrateLoading**: new `loadingIcon` prop; the misspelled `lodadingIcon` still works and is deprecated.
+  - **MenubarItem**: accepts `variant="error"` like `DropdownMenuItem` and `ContextMenuItem`; `"destructive"` still works and is deprecated. Both now use the `error` colour, and both render `data-variant="error"` — CSS or tests selecting `[data-variant=destructive]` on a menubar item no longer match; select `[data-variant=error]`.
+  - **useTheme**: every caller shares one store, so components that read `theme` (CodeBlock, CodeEditor, CodeDiff, JsonViewer) follow a toggle straight away. SSR-safe; the stored format is unchanged; a choice that storage refuses to save is kept for the session. `ThemeToggle` no longer repaints `<html>` with the server's `system` guess while hydrating.
+  - **filterMentions**: new optional `{ match: 'prefix' | 'substring' }` (default `'substring'`, unchanged).
+  - **RichTextEditor**: `options.mentions.suggestions` accepts `MentionItem[]` (the type `MentionList` and `ChatComposer` take) as well as `string[]`.
+  - Print: the `PrintHeader` QR box is centred again (a class typo dropped `justify-center`).
+
+### Patch Changes
+
+- [#355](https://github.com/softistx/nxgt-material/pull/355) [`c79a91e`](https://github.com/softistx/nxgt-material/commit/c79a91e4f9d138c3eed9b1fb0218bd87ce202c61) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `NetworkUploadField` / `S3UploadField`: the field is a `group` named by its
+  label, and once a file hides the drop zone (or it is disabled: `maxFiles`
+  reached, or `disabled`) the group carries the error (the `helperText`, or a
+  hidden "This value is not valid."), which nothing said before. `ImageField`: a
+  failed upload with no message of its own is described as not valid, not only
+  outlined in red.
+  
+  `AppBreadcrumb`: each crumb is `<li><a>…</a></li>` (the `<li>` sat inside the
+  `<a>`), and the home crumb is a link named "Home" rather than a `<button>`
+  inside a link.
+  
+  `SwitchFormField` and `CheckboxFormField` no longer use the field's `name` as
+  the control's `id`, which collided between two forms on one page; without an
+  `id` of yours one is generated.
+  
+  `UploadField` and `TimeField` are tinted only while they hold a value, like an
+  `<input>`: `inputDefaultClassNames`' `not-placeholder-shown:` tint always
+  matched these `div`s. The `Switch` row uses the same untinted base.
+
+- [#324](https://github.com/softistx/nxgt-material/pull/324) [`ce245a1`](https://github.com/softistx/nxgt-material/commit/ce245a110fb5db1f0b8d5317b9d3975054be69b5) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `ResponsiveButton` (and `ResponsiveLinkButton`, `LoadMoreButton`, the
+  `EntityHeader` actions built on it) no longer sets `aria-expanded`: it said
+  whether the label was showing, so screen readers announced a button that
+  controls nothing as "collapsed". Used as a popover, drawer or menu trigger (the
+  `Filter` trigger), it still carries the trigger's own `aria-expanded`.
+  
+  `Switch`: the row's text is now the switch's `<label>`, so a labelled switch
+  has an accessible name (even without an `id`) and clicking the text toggles
+  it. With a `placeholder`, the `label` above the row is the name
+  (`aria-labelledby`) and the row text is the description (`aria-describedby`),
+  as in `@nxgt/material-vue`; an `aria-label` / `aria-labelledby` you pass
+  wins. The row is tinted from the switch's real state (`checked`, or
+  `defaultChecked` and each toggle) instead of `value`, and is no longer tinted
+  while off. `className` applies when there is no field
+  around the switch, on the row or the bare switch.
+  
+  The row carries `data-checked="true"` / `"false"`, from the same state.
+  `data-filed` (misspelt) read `value`, so a form-bound switch always showed
+  `"false"`; it now follows the switch's state too, and is deprecated: it is
+  removed in 3.0.
+
+- [#374](https://github.com/softistx/nxgt-material/pull/374) [`6c62121`](https://github.com/softistx/nxgt-material/commit/6c621219870379e618a570f7be70312d93f7b70c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Form wrappers: leaving a field straight into another field's freshly opened
+  overlay — a `SelectFormField` list opened by pressing the mouse on its
+  trigger, which takes focus without the trigger ever having it — marks the
+  field touched as it is left. It used to count that overlay as the field's own
+  and mark the field touched only when the list handed focus back to its
+  trigger. An overlay is the field's when one of its controls names it
+  (`aria-controls`), or when it opened since focus entered and no other control
+  names it.
+
+- [#379](https://github.com/softistx/nxgt-material/pull/379) [`ffee913`](https://github.com/softistx/nxgt-material/commit/ffee91378bfd6b9483484841f1908ebd80b6ee1e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Bug reports have an address: `bugs.email` in `package.json`, and the
+  "Reporting a bug" section of the troubleshooting page, linked from the README.
+
+- [#368](https://github.com/softistx/nxgt-material/pull/368) [`2930292`](https://github.com/softistx/nxgt-material/commit/293029293c3bca705596a0466517a5878e39909f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A dismissible `Chip` whose `label` is a node (`<b>Paris</b>`) names its ✕
+  "Remove Paris" after the text it shows, as a text label already did; a label
+  with no text keeps "Remove". The same rule as `@nxgt/material-vue`'s `Chip`,
+  which names it after its default slot when one is given.
+
+- [#333](https://github.com/softistx/nxgt-material/pull/333) [`12763f1`](https://github.com/softistx/nxgt-material/commit/12763f1585f16205553ec67e96822d29a720427d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `DialogClose`, `DrawerClose` and `SheetClose` (and `SheetContent`'s built-in
+  close button) are named "Close" when they show only their icon: screen readers
+  announced an unnamed button. The map's zoom buttons are named "Zoom in" /
+  "Zoom out". All follow `I18nProvider` (`material.buttons.close`,
+  `material.map.zoom-in`, `material.map.zoom-out`); text children or an
+  `aria-label` you pass win.
+
+- [#305](https://github.com/softistx/nxgt-material/pull/305) [`2239896`](https://github.com/softistx/nxgt-material/commit/2239896218f73cd8cef24a50db482848c32be582) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `ComboboxField` (and `TimezoneField`, which is built on it) now shows the selected option's label in the input instead of its raw value, filters the options as you type, and shows "No results" only when nothing matches.
+  
+  The config-driven `FormField` now stores the picked `File` for `type: 'upload'` (it stored a `FileList` and then crashed rendering it), writes the value `onUpload` resolved for `type: 'network-upload'` (it never reached the form), keeps a config's `helperText` until there is an error message to show in its place, and is disabled by `useForm({ disabled })` like every other wrapper. `{ type: 'switch' }` type-checks as a `FieldConfig` without a cast. `UploadFormField` no longer crashes after a file is picked in single mode. `location` stays in `FieldType` but has no config: use `LocationFormField` from `@nxgt/material/map`.
+  
+  `LocationField` (`@nxgt/material/map`) shows an empty field and no preview when its value is `null`, instead of the coordinates of a default city; pressing OK on an empty field commits where the pin was last dragged to (or its start), even when the parent does not pass `value` back. Its placeholder, dialog title and button are translated (`material.location-field.*`, `en` and `fr`), and the trailing button has an accessible name.
+
+- [#378](https://github.com/softistx/nxgt-material/pull/378) [`84610c2`](https://github.com/softistx/nxgt-material/commit/84610c2e02ced1fc9051231d355c1d3ea6b0faee) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A Tailwind app that imports `@nxgt/material/styles.css` now gets the CSS the
+  components need, which reached only the compiled stylesheet before: KaTeX
+  (`Markdown` maths), the code theme (`CodeBlock`), highlight.js
+  (`RichTextEditor` code blocks), react-easy-crop (`ImageCropper`), and the
+  stylesheets of `ButtonGroup`, `BottomAppBar`, `ContactItem`,
+  `OpeningHoursItem`, `AttributeForm` and `AttributeValuesForm`, which were CSS
+  modules and are global `nxgt-*` classes now. The compiled stylesheet styles
+  the same components the same way.
+
+- [#299](https://github.com/softistx/nxgt-material/pull/299) [`611e008`](https://github.com/softistx/nxgt-material/commit/611e0082d4417e8e19cd28bb6608b2d649e77720) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Documentation with a preview of every component
+  
+  - The README catalogue has a **Preview** column, and each name links to its
+    entry in `docs/components/`.
+  - `docs/` now ships in the package:
+    - one page per category: preview, example, options;
+    - the component gallery;
+    - getting started;
+    - guides for forms, i18n, the app shell, theming, printing, maps, SSR and
+      the helpers;
+    - troubleshooting;
+    - the roadmap.
+  - The README's long sections moved to those guides.
+
+- [#366](https://github.com/softistx/nxgt-material/pull/366) [`24bc584`](https://github.com/softistx/nxgt-material/commit/24bc58416b64f86f3b80bc4c34eb89378338a830) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `DateRangeField`: the trigger button carries `data-slot="date-range-field-trigger"`
+  (instead of `popover-trigger`), as `DateField`'s carries `date-field-trigger`.
+
+- [#339](https://github.com/softistx/nxgt-material/pull/339) [`b60cffc`](https://github.com/softistx/nxgt-material/commit/b60cffc3b3081c054983e317cbe7764892462de4) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `TimeField` renders the same trigger on the server and in a desktop browser's
+  first render (`useMedia` now has a default), so SSR pages no longer log a
+  hydration attribute mismatch or react-use's "defaultState should be defined"
+  warning; a phone switches to the dialog once mounted.
+  
+  `DateField` and `DateRangeField`: `disabled` disables the field (the trigger
+  can no longer be opened) instead of reaching the calendar as "every day is
+  disabled". Day rules move to the new `disabledDays`; a non-boolean `disabled`
+  is still passed to the calendar. `id`, `aria-describedby` and `data-*` land on
+  the trigger in `DateField`, `DateRangeField` and `TimeField` (both its popover
+  and its phone dialog) instead of on the calendar, the inner box, or nowhere.
+  
+  `UploadField`: its file input is visually hidden instead of `hidden`, so a
+  `required` field with no file stops the submit with the browser's message
+  instead of a console-only "An invalid form control … is not focusable".
+  `ImageField`, `FileListField` and the `NetworkUploadField` / `S3UploadField`
+  drop zone no longer put `aria-invalid` on a `group` or a `button`: the error text
+  describes them, and the outline comes from `data-invalid`.
+
+- [#341](https://github.com/softistx/nxgt-material/pull/341) [`ee9d630`](https://github.com/softistx/nxgt-material/commit/ee9d630423a3ae068dae6f240a2d2c5b5bb9f404) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Icon badges that looked like an `IconButton` but did nothing are no longer
+  buttons: the list-row badges of `Contacts`, `OpeningHours`, `PostalAddress`,
+  `AttributesList` and `FileListField`, the `NetworkUploadField` file preview,
+  the `EntityHeader`, `ConfirmationDialog` and `AppSidebar` icons, the `Stepper`
+  info icon, the `AccordionCard` chevron and the map's default marker pins. Each
+  was a nameless `<button>` (focusable, except the disabled upload preview); each is now a `<span>` with
+  `aria-hidden="true"` and the same look. A `Contacts`
+  badge is `role="img"`, named by the contact type. The `AccordionCard` header
+  is now the `<button>` itself (it was a `<div>`, reachable from the keyboard only
+  through the chevron), and its chevron now turns when open. A `Marker` with a
+  string `tooltip` passes it to leaflet as `title`, which names the focusable
+  marker now that the pin inside is hidden (a `title` you pass wins). `ConfirmationDialog`'s `icon` is the glyph alone (the
+  dialog wraps it in the badge; style it with `iconProps`): an `IconButton`
+  passed there is now a button inside a hidden `<span>`.
+  
+  An `Icon` inside a named `IconButton` (and so `InputGroupButton` and
+  `IconLinkButton`) is `aria-hidden` instead of `role="img"` named
+  "Icon {name}", so a screen reader reads "Delete", not "Delete, Icon trash". An
+  `aria-label` you give the `Icon` still wins; an `Icon` anywhere else keeps its
+  "Icon {name}" default. See troubleshooting for the selectors this changes.
+
+- [#374](https://github.com/softistx/nxgt-material/pull/374) [`917f477`](https://github.com/softistx/nxgt-material/commit/917f47724037c5bd0b9e844a3ca6154abcb37f4b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `definePdfDocument`: an unannotated data parameter is typed `unknown`, not
+  `never`. With `never`, the template compiled and the error appeared only
+  where the template was called (`Argument of type 'Invoice' is not assignable
+  to parameter of type 'never'`); now reading a property of it fails in the
+  template itself. Annotated parameters and defaults (`language = 'en'`) are
+  typed as before.
+
+- [#316](https://github.com/softistx/nxgt-material/pull/316) [`1906412`](https://github.com/softistx/nxgt-material/commit/1906412fee6fde2a485ef87e40fe8fe662e5aa96) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `ContactItem` and `OpeningHoursItem` are deprecated, and removed in 3.0
+  
+  Both are single rows bound to a react-hook-form array (`control` + `name` +
+  `index`), and nothing in the library renders them. Use `ContactsFormField` and
+  `OpeningHoursFormField`, which own the list, the add / edit dialog and the
+  array. 3.0 moves every react-hook-form-bound export to a `@nxgt/material/forms`
+  subpath with react-hook-form as an optional peer (see `docs/roadmap.md`).
+
+- [#374](https://github.com/softistx/nxgt-material/pull/374) [`5401d94`](https://github.com/softistx/nxgt-material/commit/5401d941717d711ec8bb97243f2086f928802494) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `DialogContent` hands focus back, on close, to the element that had it when
+  the dialog opened — a `DialogTrigger` as before, and now also the button of
+  yours that opened a controlled `Dialog`, where focus used to fall to `<body>`.
+  Focus that already went elsewhere (a non-modal dialog closed by a click in
+  another input) stays there. An `onCloseAutoFocus` that calls
+  `event.preventDefault()` opts out.
+
+- [#300](https://github.com/softistx/nxgt-material/pull/300) [`bf5b452`](https://github.com/softistx/nxgt-material/commit/bf5b452454cd0e48241723381865d8f4a6dcdfc9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Dialog fixes
+  
+  - `ConfirmationDialog` can be controlled: `open` and `onOpenChange` from a
+    parent now drive it. Before, `open` only seeded internal state, and passing
+    `onOpenChange` stopped the dialog from opening or closing itself. Without
+    `open` it is uncontrolled (`defaultOpen`), and `onOpenChange` only
+    observes. If you passed `open` only to open it initially, pass
+    `defaultOpen` instead.
+  - `ConfirmationDialog` validates its form before confirming: `onConfirm`
+    receives the schema's parsed output (trims and transforms applied) instead
+    of the raw `getValues()`.
+  - `ConfirmDialog` stays open while an async `onConfirm` runs (buttons
+    disabled, "Processing..."), closes on success, and on a throw or rejection
+    stays open and shows the error's message instead of logging it and closing.
+    The pending label and the message shown for an error without one are
+    translated (`material.confirm-dialog.processing`,
+    `material.confirm-dialog.failed`, en and fr).
+  - `CommandDialog` renders its visually hidden title and description inside the
+    dialog, rather than in the page next to it.
+
+- [#337](https://github.com/softistx/nxgt-material/pull/337) [`f3e8f1b`](https://github.com/softistx/nxgt-material/commit/f3e8f1b4211748d3bcdb39ba58097d78280488b7) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The package no longer ships type declarations for its stories, tests and their
+  data: 351 files under `dist/lib` (`*.stories.d.ts`, `*.test.d.ts`,
+  `*.rows.d.ts`, `__stories__/`, `stories-*.d.ts`, story data) are gone from the
+  tarball. None was reachable from an entry point, so no import changes; a
+  declaration that named `storybook` or `vitest` types can no longer surface in a
+  consumer's type check.
+
+- [#372](https://github.com/softistx/nxgt-material/pull/372) [`69cbb3e`](https://github.com/softistx/nxgt-material/commit/69cbb3e9f8bef8cfb3cc6ff8e28b6a97d084a333) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `DateField`, `DateRangeField` and `TimeField`: the `Label` and the helper text
+  are no longer inside the trigger button (a `<label>` in a `<button>` is
+  invalid, and the helper text was read as part of the value). They sit beside
+  it in the field's root `div`, which takes `className`; the trigger is named by
+  the Label (`aria-labelledby`) and described by the helper text, then your
+  `aria-describedby` ids. The Label is `for` the trigger, so a click on it opens
+  the picker, and the open popover (or `TimeField`'s dialog on a phone) is
+  labelled by the trigger. A disabled field dims its trigger only, no longer its
+  label and helper text. `DateFieldTrigger`, `DateRangeFieldTrigger` and `TimeFieldTrigger`
+  render only what the button shows.
+  
+  `Slider`: an `aria-label` or `aria-labelledby`, and `aria-invalid` (or
+  `error`), go on every thumb rather than on the root `span`, and a vertical
+  `Slider`'s `label` names its thumbs.
+  
+  `DurationField`: a `group` named by its Label and described by its helper
+  text; the inputs are named "Hours" and "Minutes"
+  (`material.duration-field.hours-label` / `minutes-label`, en and fr). The
+  minutes input had no name. `NumberField` takes an `aria-label`.
+  
+  `CodeEditor`: Monaco's textarea is named by the field's label (`ariaLabel`),
+  and follows it when it changes.
+
+- [#319](https://github.com/softistx/nxgt-material/pull/319) [`cadee35`](https://github.com/softistx/nxgt-material/commit/cadee353d2d01f5c1ce051d1ffa2c3f0bf35326e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The filter trigger's accessible name reads "Filters, 2 active" instead of
+  "Filters2": the count badge is hidden from assistive technology and the count
+  is announced through `material.filter.active-count` (en, fr).
+
+- [#351](https://github.com/softistx/nxgt-material/pull/351) [`892eed6`](https://github.com/softistx/nxgt-material/commit/892eed6c7731237141136e07d669e1c3db220fb1) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Every `*FormField` now calls React Hook Form's `field.onBlur` when focus leaves the field, so `touchedFields` flips and `mode: 'onBlur'` / `'onTouched'` validate as they do for a plain input. About twenty wrappers never called it (`SelectFormField`, `ComboboxFormField`, `ColorFormField`, `CountryFormField`, `TimezoneFormField`, `RatingFormField`, `OtpFormField`, `DurationFormField`, `InlineEditFormField`, `CheckboxFormField`, `SortableListFormField`, `TransferListFormField`, the dialog editors, the uploads, and the config-driven `FormField` for most types), and others called it too early, when focus moved to their own button, thumb or popover. Moving between a field's own controls, or into the popover or dialog it opened, is not leaving it: a picker is touched when focus leaves its trigger and its popover, a dialog editor when focus leaves its buttons and the dialog. When the form validates is unchanged: that is still its `mode`. The `PostalAddress`, `Contacts`, `OpeningHours` and attribute dialogs now hand focus back to the button that opened them when they close, and `SliderFormField` no longer crashes once the form holds a number for it (after the first change, or with a numeric default value): it passes that number to the slider as a one-thumb array. A vertical `SliderFormField` is touched when focus leaves all of its thumbs, like a horizontal one.
+
+- [#359](https://github.com/softistx/nxgt-material/pull/359) [`6eb7b52`](https://github.com/softistx/nxgt-material/commit/6eb7b526f65ef11fe54861d6381b0d2982ec4134) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `RadioGroup` / `CheckboxGroup`: an option's `id` is the group's `id` plus its
+  index (`` `${id}-${i}` ``), no longer its `value`, so two groups with the same
+  options (two yes/no questions) no longer share ids and a label no longer
+  checks the other group's option. The group's `id` is yours, or generated with
+  `useId()`. `RadioGroupFormField` / `CheckboxGroupFormField` no longer use the
+  field's `name` as that `id`, which collided between two forms on one page. A
+  `#<name>` or `#<option value>` selector needs an `id` of yours: see the
+  troubleshooting entry.
+  
+  `AppBreadcrumbItem`: React Router's options besides `replace` and `state`
+  (`preventScrollReset`, `relative`, `reloadDocument`, `viewTransition`, …) and
+  the anchor-only attributes (`target`, `rel`, `download`, …) now go to its link.
+  They were spread onto the `<li>`, where React warned about them and the link
+  never saw them.
+
+- [#361](https://github.com/softistx/nxgt-material/pull/361) [`66454a7`](https://github.com/softistx/nxgt-material/commit/66454a7c8d69f0643c1cb330ac1faac9538a6f60) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `RadioGroup`, `CheckboxGroup` and their form wrappers are now named by their
+  `label`: the `radiogroup` (and `CheckboxGroup`'s wrapper, now a
+  `role="group"`) carries `aria-labelledby` to the label and `aria-describedby`
+  to the helper or error text, so a screen reader announces the question, not
+  only the first option. A caller's `aria-label` / `aria-labelledby` still wins.
+  `CheckboxGroup` no longer puts `aria-invalid` on the group, where it is not
+  allowed; an error without text is described by a visually hidden "This value
+  is not valid.", and so is a `CheckboxGroupFormField` in error with no message
+  that shows the caller's `helperText`. `RadioGroup` sets `aria-invalid` on its
+  `radiogroup` from `error` (a caller's own `aria-invalid` wins).
+
+- [#357](https://github.com/softistx/nxgt-material/pull/357) [`5614b57`](https://github.com/softistx/nxgt-material/commit/5614b57d01f379692bc0c03b00811a335d231ed6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - More built-in labels follow `I18nProvider`
+  
+  30 keys join the `material` bundles, in English and French, with the same
+  names and French as `@nxgt/material-vue`: the filter's empty state, `+N more`
+  chip and the Yes/No, From, Until and Up to of its chips (`filter.empty`,
+  `filter.more`, `filter.value.*`); the `aria-label` of `Breadcrumb` and
+  `Pagination`, the breadcrumb ellipsis's "More" and `DocHeader`'s breadcrumb
+  (`breadcrumb.*`, `pagination.label`, `doc.breadcrumb`); `MessageCard`'s
+  "Unread" (`cards.unread`); the network upload field's "Replace {name}",
+  "Upload failed" and its type, size and count errors (`upload.*`); the editor's
+  placeholder and emoji buttons (`rich-text-editor.placeholder`,
+  `insert-emoji`); `CircularProgress`'s label, `StxPlayer`'s "Media player",
+  `PaneLayoutPane`'s sheet title, `JsonViewer`'s "Empty JSON" and
+  `TimePicker`'s AM/PM. `pagination.first` / `last`,
+  `carousel.roledescription` / `slide` and `attributes.buttons.add-option` are
+  used by the Vue library only.
+  
+  The editor's default placeholder now follows a language change without
+  rebuilding the editor, as does a new `placeholder`. `formatFilterValue` takes
+  the chip words as an optional third argument, typed `FilterValueWords`, with
+  the English in the newly exported `FILTER_VALUE_WORDS`; without it the English
+  is unchanged. `parseJsonSource` marks a blank source with `empty: true`. The
+  upload count error now reads "Maximum of 1 file reached" for a single file. Your
+  `placeholder`, `sheetTitle` and `aria-label` still win.
+  
+  `NetworkUploadField`: a successfully uploaded item gets its primary border
+  and tint again.
+
+- [#336](https://github.com/softistx/nxgt-material/pull/336) [`f4cac2e`](https://github.com/softistx/nxgt-material/commit/f4cac2e35398d0dd177aa608ea8fa395300af39b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Icon-only buttons that screen readers announced as a bare "button", or by
+  their icon's name ("Icon chevron-down", "Icon trash"), now have a name,
+  translated under `I18nProvider`: the `Sidebar` toggle ("Toggle sidebar",
+  `material.sidebar.toggle`, with `aria-expanded`), the data table's `expand`
+  column ("Toggle row details", `material.table.labels.toggle-row`, with
+  `aria-expanded`), the `LocationPreview` default trigger ("Preview location" /
+  "Preview {name}", `material.map.preview` / `preview-named`), and the delete
+  button of the deprecated `ContactItem` / `OpeningHoursItem` (the existing
+  `material.contacts.buttons.remove` / `material.opening-hours.buttons.remove`).
+  
+  A chip's remove button is named after the chip: "Remove {label}"
+  (`material.chip.dismiss-label`) on a dismissible `Chip` whose `label` shows text
+  and on a `ComboboxChip` whose children are text; `ComboboxChip` takes a
+  `removeLabel` for other children. `Autocomplete`'s chips are dismissible
+  `Chip`s, so each remove button is a real, focusable `<button>` instead of a
+  nameless `div` nested inside the chip's button, and it is disabled with the
+  field. The `Sidebar` toggle also shows while focus is inside the sidebar, so
+  the keyboard can reach it (it used to appear on hover only).
+
+- [#307](https://github.com/softistx/nxgt-material/pull/307) [`8ad61ed`](https://github.com/softistx/nxgt-material/commit/8ad61ed3cca67ca8df3b8fe50fd5834b40a84315) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `ImageCropper` no longer crashes with "Maximum update depth exceeded" when it
+  mounts in free mode before its image has loaded. The 0×0 crop size reported
+  before the image has a size used to become a `NaN` aspect, which the cropper
+  saw as a change on every update.
+
+- [#334](https://github.com/softistx/nxgt-material/pull/334) [`3cd0a34`](https://github.com/softistx/nxgt-material/commit/3cd0a340226bba46665e602760823b333a130c10) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Label`'s required asterisk is hidden from screen readers (`aria-hidden`): a
+  required field was named "Email*" or read "Email star". The field's own
+  `required` / `aria-required` says it, which every field of the library now
+  sets. A test that found a field by a name ending in `*` finds it by the label
+  alone: see the troubleshooting page.
+
+- [#365](https://github.com/softistx/nxgt-material/pull/365) [`41e7e60`](https://github.com/softistx/nxgt-material/commit/41e7e605f6e145369c50bca221345aa84cf352cc) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `@nxgt/material/map` no longer loads the rest of the library with it: in the
+  built package its static imports drop from about 5.5 MiB to about 0.4 MiB, so a
+  lazily loaded map fetches far less code. No API change.
+
+- [#342](https://github.com/softistx/nxgt-material/pull/342) [`c22223d`](https://github.com/softistx/nxgt-material/commit/c22223db5eeadc1cdae76bbed88db75961c4496d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `useIsMobile`, `useTheme`, and every component that reads them (`AppHeader`,
+  `AppBreadcrumb`, `DataTable`, `ResponsiveButton`, `ThemeToggle`, `CodeBlock`,
+  `CodeDiff`, `JsonViewer`, `CodeEditor`), plus `Doc` and `TimeField`, now give
+  the server an answer for their media query: a desktop, light screen. SSR
+  servers no longer log react-use's "defaultState should be defined" warning,
+  and a phone or a dark-mode browser no longer hits a hydration mismatch that
+  made React throw the server HTML away. The client switches right after
+  hydrating; a page rendered only in the browser reads the real answer from its
+  first render, as before.
+
+- [#376](https://github.com/softistx/nxgt-material/pull/376) [`f6b751e`](https://github.com/softistx/nxgt-material/commit/f6b751eead179285e169487057a7f72d397572ce) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `DialogContent`, `AlertDialogContent`, `SheetContent` and `DrawerContent` move
+  focus into themselves when they open, as a modal must (WCAG 2.4.3): to their
+  first control, or to the content when it has none. `AlertDialogContent`
+  focuses `AlertDialogCancel`, or its first control when there is no Cancel.
+  They used to cancel Radix's open auto-focus, so focus stayed behind the
+  overlay. `Drawer` now turns Vaul's `autoFocus` on by default. An
+  `onOpenAutoFocus` that calls `event.preventDefault()` (or `autoFocus={false}`
+  on a `Drawer`) keeps focus where it was; focus still returns to the opener on
+  close. A test that types right after opening may now type into the overlay:
+  see the troubleshooting entry "Keys typed right after opening a dialog, sheet
+  or drawer land inside it".
+
+- [#375](https://github.com/softistx/nxgt-material/pull/375) [`a49f3f5`](https://github.com/softistx/nxgt-material/commit/a49f3f5d5e45f14161f899a29b00fcd9ce46beec) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `AlertDialogContent`, `SheetContent` and `DrawerContent` hand focus back, on
+  close, to the element that had it when they opened, as `DialogContent` does:
+  the button of yours that opened a controlled one (no trigger) gets it back,
+  where focus used to fall to `<body>`. Focus that already went elsewhere stays
+  there, and an `onCloseAutoFocus` that calls `event.preventDefault()` opts out.
+
+- [#375](https://github.com/softistx/nxgt-material/pull/375) [`e7bce88`](https://github.com/softistx/nxgt-material/commit/e7bce883a159d5f2ac80b1ff68a8ce5c7b40b11b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader`'s text and annotation layer styles (react-pdf's `TextLayer.css`
+  and `AnnotationLayer.css`) now come with `@nxgt/material/styles.css`, so a
+  Tailwind app gets selection, search highlights, links and notes styled. They
+  used to reach only the compiled `dist/material.css`.
+
+- [#373](https://github.com/softistx/nxgt-material/pull/373) [`be623e1`](https://github.com/softistx/nxgt-material/commit/be623e1c75d9326b3d93251585322d81cb094b2c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader`:
+  
+  - A page's own `/Rotate` is honoured: a page the PDF shows landscape is drawn,
+    thumbnailed, placed and fitted landscape (it was drawn at rotation 0).
+    `PdfPageSize` gains an optional `rotate`.
+  - Fit width and fit page use the first 25 pages, read together when the
+    document opens, so the zoom no longer moves as later page sizes arrive
+    (still read 25 pages at a time); the fit stops at 500%.
+  - `onPageChange` also reports the page the reader moves to itself: an
+    `initialPage` clamped to the last page, and `initialPage` again after a new
+    `file`.
+  - The password field is named "Password" (new key
+    `material.pdf-reader.password-label`), not after the "Password protected"
+    heading.
+  - The first search renders the pages once per 25 pages read, not once per
+    page.
+  - A note's icon shows: pdf.js asked the host page for `annotation-note.svg`
+    (a 404); the icons are now inlined, loaded only for a document with notes.
+  
+  `TooltipContent` (and so every `Tooltip`) opens inside the element in
+  fullscreen while there is one: `PdfReader`'s toolbar tooltips show in
+  fullscreen.
+
+- [#330](https://github.com/softistx/nxgt-material/pull/330) [`a10e3de`](https://github.com/softistx/nxgt-material/commit/a10e3de8437ab1334c805afac41e6f2a67ea2674) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader` is no longer shown as deprecated in your editor: the `@deprecated`
+  tag now sits on its old alias `PdfViewer`, where it was meant to be. Code that
+  imports `PdfViewer` now sees the strike-through; switch to `PdfReader`, which
+  takes the same props.
+
+- [#338](https://github.com/softistx/nxgt-material/pull/338) [`a0bc68b`](https://github.com/softistx/nxgt-material/commit/a0bc68b00200c56b97f7dd9d21320120e221f4a8) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader`: fit width and fit page use each page's real size instead of
+  assuming US Letter, fitting the widest and tallest page with one zoom, so A4
+  and landscape pages no longer overflow or leave a gap. Placeholders and
+  thumbnails take their page's shape before it draws. `PdfPageList`,
+  `PdfSidebar` and `PdfThumbnailSidebar` take an optional `pageSizes`, and the
+  `PdfPageSize` type is exported. The fit also follows the reader's real size;
+  it used to fit an 800 × 600 box.
+
+- [#335](https://github.com/softistx/nxgt-material/pull/335) [`e74c53f`](https://github.com/softistx/nxgt-material/commit/e74c53fa980d3d94e57ac2c8911404503585533b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader`: a wrong password says "Incorrect password. Try again." (new key
+  `material.pdf-reader.password-incorrect`, en and fr), marks the field `aria-
+  invalid`, announces it and focuses the field again. The loading spinner, the
+  error message and the password field now show before the document has loaded;
+  they never appeared, so a protected or broken PDF left the reader blank, and
+  kept the pages hidden even after the right password. Escape closes the open
+  search bar before a Radix `Dialog` or `Sheet` around the reader sees it, and
+  every other Escape reaches the dialog. `onPageChange` reports a page inside the
+  document, and only when it changes.
+
+- [#345](https://github.com/softistx/nxgt-material/pull/345) [`9931914`](https://github.com/softistx/nxgt-material/commit/99319140fb2fc170ec714b41204fd43a4042d1c6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader`: opens on `initialPage`, which it showed in the page field but
+  never scrolled to (past the end, it opens the last page; a new `file` opens on
+  `initialPage` again). The page number follows scrolling, and `onPageChange`
+  reports the page most on screen; a page you ask for is reported once, not each
+  page passed on the way.
+
+- [#340](https://github.com/softistx/nxgt-material/pull/340) [`f633f98`](https://github.com/softistx/nxgt-material/commit/f633f980a2bd74805f4c79694416fa3e12b5b17a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader`: search covers the whole document, pages not drawn yet included,
+  and counts as you type. It finds every match, including one split across text
+  runs, and ignores case, accents, ligatures and the width of white space.
+  Moving to a match shows its page and marks it. `PdfPageList` takes an optional
+  `highlight`, which `PdfReader` passes it, and the `PdfSearchHighlight` type is
+  exported.
+
+- [#311](https://github.com/softistx/nxgt-material/pull/311) [`5b7b609`](https://github.com/softistx/nxgt-material/commit/5b7b609b63cc04eea38701649c68c52eb9460f47) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `StxPlayer` no longer leaves an unhandled promise rejection
+  (`Failed to execute 'exitFullscreen' on 'Document': Document not active`) when
+  it unmounts while fullscreen or in picture-in-picture, or when the browser
+  refuses a fullscreen request. A refused change leaves the player as it is.
+
+- [#334](https://github.com/softistx/nxgt-material/pull/334) [`b656f23`](https://github.com/softistx/nxgt-material/commit/b656f237e7a104e719ce88bb292f7a40297804e9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Every field that shows the required asterisk now says "required" on the
+  element a screen reader lands on, not only with the `*`:
+  
+  - `DateField`, `DateRangeField`, `TimeField`: the trigger is a `combobox`
+    (a `button` may not carry `aria-required`) named by the label, with
+    `aria-required` (and `aria-invalid` with `error`). An `aria-label` /
+    `aria-labelledby` you pass now names it (a picker with no label needs one,
+    or a `placeholder`); on `DateField` / `DateRangeField` it used to reach the
+    calendar instead. `DateField`,
+    `DateRangeField` and the phone-width `TimeField` now show the asterisk they
+    were missing, and the phone-width `TimeField` trigger is a focusable button
+    instead of a `div`.
+  - `DurationField`: `required` on both inputs.
+  - `Slider`: `aria-required` on every thumb, and each thumb is named by the
+    label ("Price Minimum" / "Price Maximum" for a range).
+  - `RatingField`: the stars are a `radiogroup`, named by the label, with
+    `aria-required`.
+  - `RichTextEditor`: the editable area is a multi-line `textbox` named by the
+    label, with `aria-required`. `CodeEditor`: Monaco's `ariaRequired`.
+  - `TransferList`: `aria-required` on the Selected listbox, and both panes are
+    named by the label, then their title ("Team Selected"). `SortableList`: the
+    listbox is named by the label, with `aria-required`.
+  - `ComboboxField`, `Autocomplete`: `aria-required` on the input;
+    `Autocomplete`'s label now names its input.
+  - Tests that found a picker by the `button` role, or a thumb or a pane by
+    its old exact name: see the troubleshooting page.
+  - `ImageField`, `FileListField`, `UploadField` (a file picker is a button, and
+    their file input is hidden): the field is a `group` named by the label and
+    described by a visually hidden "This field is required."
+
+- [#304](https://github.com/softistx/nxgt-material/pull/304) [`8136ffa`](https://github.com/softistx/nxgt-material/commit/8136ffa7578b4d16dc51804a30a248bea2c80114) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Fix select, time, OTP and radio fields:
+  
+  - `SelectChipFormField` and `SelectCardFormField` in `mode="single"` no longer crash after the choice is cleared (the form value `null` is now read as "nothing selected"), and only the option equal to the value is shown active: option `pro` no longer lights up for `professional`. The form value keeps its type (`string | null` in single mode, `string[]` in multiple). The same fix applies to the config-driven `chips-single` field.
+  - `SelectField` now shows its `placeholder` (it still falls back to `label`) and the required asterisk when `required` is set.
+  - `SelectTrigger` gets its small radius back (a stray fragment had broken its class list), and the focused `SelectItem` is tinted again.
+  - `TimeField` on desktop and `TimeFormField` show the empty state (`placeholder`) when there is no value, instead of the current time or `00:00`. `TimeFormField asString` with `''` no longer throws `RangeError: Invalid time value`.
+  - `OtpField` generates its id with `useId()`, so server and client render the same markup.
+  - `SelectFormField`, `SelectChipFormField`, `SelectCardFormField`, `RadioGroupFormField`, `TimeFormField` and `OtpFormField` honour your own `disabled` prop, and show your own `helperText` while there is no validation error. Before, they overwrote both with the form state.
+  - `RadioGroup` spaces its label, helper text and options again (`gap-2`).
+
+- [#318](https://github.com/softistx/nxgt-material/pull/318) [`aec0a95`](https://github.com/softistx/nxgt-material/commit/aec0a95fc152f52e1e99e0d28f347ca0018456db) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Switch helper text, a resumable step form, translated confirm labels, one link per LinkButton, named collapsed buttons
+  
+  - `Switch` shows `helperText` without a `placeholder` (under the labelled row
+    or the bare switch), so `SwitchFormField`'s validation message is no longer
+    lost. A switch in a labelled row is no longer announced as invalid when it
+    has no `error`.
+  - `createStepFormSlice` resumes from what `updateStep` stored under its `name`
+    (step and values; nothing is read on a server, and anything that is not a
+    step-form state is ignored), and `reset` clears that entry.
+    `useSliceReducer` computes a slice's initial state once, on mount.
+  - `ConfirmDialog` and `ConfirmationDialog` translate their default button
+    labels: `material.confirm-dialog.confirm` / `.cancel` (English and French).
+  - `LinkButton`, `IconLinkButton` and `ResponsiveLinkButton` render a single
+    `<a>` styled as the button instead of a `<button>` inside a link: one tab
+    stop, role `link`. `Button` with `asChild` keeps its loading spinner inside
+    the child, and neither `Button` nor `IconButton` puts `type` on an `asChild`
+    element.
+  - A collapsed `ResponsiveButton` (the `Filter` trigger on a phone, for one)
+    keeps its label as screen-reader text, so the icon-only button has an
+    accessible name.
+
+- [#368](https://github.com/softistx/nxgt-material/pull/368) [`9b04052`](https://github.com/softistx/nxgt-material/commit/9b04052b7183b4b1d9f6717c48dd2550481ff16e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A server-rendered wizard built on `createStepFormSlice` and rendered with
+  `useSliceReducer` hydrates without a mismatch: `useSliceReducer` renders the
+  server's state (step 0) while hydrating and resumes at the stored step once
+  mounted. A page rendered only in the browser still shows the stored step from
+  its first render, and `reset` still clears it. Wrapping such a wizard in
+  `clientOnly` is no longer needed; a slice kept in a Redux store follows the
+  forms guide's recipe instead.
+
+- [#346](https://github.com/softistx/nxgt-material/pull/346) [`1d9e5d4`](https://github.com/softistx/nxgt-material/commit/1d9e5d483be9479e3046ccb724f06205f96ecf0f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Stepper` gives the server an answer for its screen-width query (the desktop
+  layout), like the other responsive components: SSR servers no longer log
+  react-use's "defaultState should be defined" warning, and a desktop no longer
+  hits a hydration mismatch on a page with a `Stepper`. `PaneLayout` and
+  `ListDetailsLayout` use the same helper; they rendered the wide layout on the
+  server already, and a page rendered only in the browser now reads the real
+  answer from its first render instead of flashing the wide layout on a phone.
+  
+  `TimeField`'s OK button follows the language (`material.buttons.ok`), and
+  both branches place props the same way: on a phone `name`, `title`, `style`
+  and the other `div` props now reach the field (they were dropped), and on a
+  desktop the picker gets `onBlur` only: `name`, `required` and any other
+  `div` prop (`onClick`, `onKeyDown`, `title`, …) now go to the field rather
+  than the picker's `div`, and `disabled` stays on the trigger button instead
+  of also landing on the field's display `div`.
+
+- [#378](https://github.com/softistx/nxgt-material/pull/378) [`bdfb9aa`](https://github.com/softistx/nxgt-material/commit/bdfb9aa71bd50a00784f8cb7caeb46c69f2b3893) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Switch` and `Autocomplete` no longer put `aria-invalid` on a plain `div`,
+  where it is not allowed. An invalid `Switch` says so on the `switch` alone,
+  and its bordered row shows it with a red border; an invalid `Autocomplete`
+  says so on its input alone, and the chips box shows it with a red border.
+
+- [#327](https://github.com/softistx/nxgt-material/pull/327) [`da23d93`](https://github.com/softistx/nxgt-material/commit/da23d93dd204435684d1db59b62a4980d9c42290) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Switch`'s `helperText` (the validation message under `SwitchFormField`) now
+  describes the switch through `aria-describedby`, with or without a row, next
+  to the row text and any `aria-describedby` you pass.
+
+- [#375](https://github.com/softistx/nxgt-material/pull/375) [`186f591`](https://github.com/softistx/nxgt-material/commit/186f59155d344fe38ba06cc981ac2da7f1019781) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `TimeField` no longer puts `aria-invalid` on a plain `div`, where it is not
+  allowed: the box inside the trigger shows an error with a class, and an
+  `aria-invalid` you pass (as `TimeFormField` does) goes on the trigger
+  `combobox`, with the field's `error`.
+
+- [#344](https://github.com/softistx/nxgt-material/pull/344) [`571c2e5`](https://github.com/softistx/nxgt-material/commit/571c2e55695492de09ee3b4de591e1f821bd4a4a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `TimeField` passes `onBlur` to its time picker on a phone too (under 768 px, in
+  the dialog), as it already did in the desktop popover, so a `TimeFormField` on a
+  phone is marked touched and validated on blur (`mode: 'onBlur'` /
+  `'onTouched'`) instead of only at submit.
+
+- [#371](https://github.com/softistx/nxgt-material/pull/371) [`af0dbef`](https://github.com/softistx/nxgt-material/commit/af0dbef82373ce9d32390b1c39c1b2694008fed1) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `NetworkUploadField`: the drop zone's limits line ("Max 2.0 MB · Up to 3
+  files") follows the language like the rest of the field
+  (`material.upload.dropzone.max-size` / `max-files`, with French), and says
+  "Up to 1 file" instead of "Up to 1 files".
+
+- [#343](https://github.com/softistx/nxgt-material/pull/343) [`8c67eee`](https://github.com/softistx/nxgt-material/commit/8c67eeead39fa0a5cfa9a7c24d00f85e5d76bcf3) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `FileListField` says its error once: the field group is described by the error
+  text, and the drop zone no longer is as well (a screen reader read it on
+  entering the group and again on the drop zone). `ImageField`, `FileListField`,
+  `UploadField` with `trailing`, and the `NetworkUploadField` / `S3UploadField`
+  drop zone, in error without `helperText`, are described by a visually hidden
+  "This value is not valid." (`material.zod.default`, translated) instead of
+  being only a red outline.
+
+## 2.1.0
+
+### Minor Changes
+
+- [#296](https://github.com/softistx/nxgt-material/pull/296) [`7a4307b`](https://github.com/softistx/nxgt-material/commit/7a4307ba094c1e6bb243ffc92584bc46620af264) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `formatAmount` and `formatDate` are on the barrel again
+  
+  2.0.0 moved the print components out of the barrels, and took these two with
+  them. That was wrong: they are pure `Intl` helpers with no dependency on
+  `@react-pdf/renderer`, `react-pdf-tailwind` or anything else, and they are used
+  far outside print documents — 66 files in `nxgt-federation` alone. On 2.0.x each
+  of those has to import `@nxgt/material/print`, which drags in `pdfkit` and asks
+  the app to install two optional peers it has no use for.
+  
+  They now live in `lib/lib/print-format.utils.ts`, which means:
+  
+  ```ts
+  import { formatAmount, formatDate } from '@nxgt/material';        // back
+  import { formatAmount, formatDate } from '@nxgt/material/lib';    // new
+  import { formatAmount, formatDate } from '@nxgt/material/print';  // unchanged
+  ```
+  
+  `@nxgt/material/print` re-exports them, so no print document changes. Additive
+  everywhere, so this is a minor — and `verify:ssr` still shows `print.js` as the
+  only entry that reaches the print-only dependencies.
+
+- [#297](https://github.com/softistx/nxgt-material/pull/297) [`25051d4`](https://github.com/softistx/nxgt-material/commit/25051d40f6e8c3a7aab26490d53e5d924f150da9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `@nxgt/material/map` — the leaflet map comes back from `@nxgt/map`
+  
+  `Map`, `Marker`, `LocationMarker`, `LocationPreview`, `MapActions`,
+  `MinimapControl`, `LocationField`, `LocationFormField` and `useGeolocation`, the
+  same eleven exports `@nxgt/map@1.0.2` had, now an entry of this package.
+  
+  ```sh
+  bun add leaflet react-leaflet @react-leaflet/core \
+    @adamscybot/react-leaflet-component-marker react-geolocated
+  ```
+  
+  ```tsx
+  import '@nxgt/material/map.css';
+  import { LocationFormField } from '@nxgt/material/map';
+  ```
+  
+  Those five are **optional peers**, the same pattern `./print` uses for
+  `@react-pdf/renderer`: an app that renders no map never has leaflet in its tree.
+  
+  **The entry cannot be imported without a DOM**, and that is the point rather than
+  a defect: `leaflet` reads `window` while it is evaluated, so an SSR app renders
+  these components client-side only — behind `clientOnly` from `@nxgt/material/lib`.
+  An SPA has nothing to do. `verify:ssr` now enforces three things: no other entry
+  reaches leaflet, `map.js` is skipped by the import sweep with the reason printed,
+  and a stale entry in that skip list fails the build.
+  
+  `@nxgt/map` existed for this exact SSR crash. What it cost was worse than the
+  crash: it declared `@nxgt/material: ^1.0.0`, so an app depending on both could not
+  take the 2.x major at all. The package is deprecated in favour of this entry.
+
+### Patch Changes
+
+- [#295](https://github.com/softistx/nxgt-material/pull/295) [`04b2ac0`](https://github.com/softistx/nxgt-material/commit/04b2ac0d8edf65820dccc33a53508fb5558e7693) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A staged version is in flight, not lost — correcting 2.0.1's release note
+  
+  2.0.1 shipped with the claim that npm's
+  `409 Cannot publish over previously staged version` burns the version number,
+  and that 2.0.0 was therefore unrecoverable. **That is wrong, and both versions
+  prove it**: npm finished staging 2.0.0 and published it at 11:42 UTC on
+  2026-09-22, about forty minutes after its first attempt. 2.0.1 took about six
+  minutes. Both are installable, with identical content.
+  
+  What staging really costs is patience, and the confirmation check added in
+  2.0.1 did not have any: it waited ~35 seconds, then failed 2.0.1's own release
+  *after* the publish had succeeded — so `changesets/action` never received its
+  output, and the tag and the GitHub release had to be made by hand.
+  
+  - `confirmPublished` now waits **fifteen minutes**, backing off to 30s.
+  - The `isPublished` skip path **tags and announces** instead of returning
+    silently, so re-running a release whose publish landed late completes it.
+  - `AGENTS.md` says to wait and re-run, never to release the next patch to get
+    around a 409.
+
+## 2.0.1
+
+### Patch Changes
+
+- [#293](https://github.com/softistx/nxgt-material/pull/293) [`e88d1a0`](https://github.com/softistx/nxgt-material/commit/e88d1a0798ffbe1b0edab43c1f18d68c700bc89d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A publish is only believed when the registry confirms it
+  
+  `bun publish` exited 0 for 2.0.0, `scripts/publish.ts` printed `published`, the
+  action pushed the tag and cut the GitHub release — and npmjs never received the
+  version. Nothing in the log said otherwise, because the script printed bun's
+  output only on the failure path.
+  
+  It now re-reads the registry after publishing (six attempts over ~35s, so
+  propagation is not mistaken for failure), **fails the release** if the version is
+  not there, and tags only after that. bun's output is printed either way.
+  
+  The cause, surfaced by that change on the re-run: npm answered
+  `409 Conflict — Cannot publish over previously staged version "2.0.0"`. The first
+  attempt staged the tarball and never completed it, and bun exited 0 anyway. A
+  staged version cannot be republished, so 2.0.0 is burnt and this patch is what
+  carries its content to the registry.
+
+## 2.0.0
+
+### Major Changes
+
+- [#291](https://github.com/softistx/nxgt-material/pull/291) [`da81b72`](https://github.com/softistx/nxgt-material/commit/da81b720c5b0510a287562b36474187a3247f670) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `@nxgt/material/print` is its own entry, and `@react-pdf/renderer` +
+  `react-pdf-tailwind` are optional peer dependencies
+  
+  **Breaking:** the print components (`PrintHeader`, `PrintSection`, `PrintCard`,
+  `PrintTable`, `PrintTotals`, `PrintBadge`, `tw`, `commonPrintStyles`, the
+  formatters) no longer come from `@nxgt/material` or `@nxgt/material/components`.
+  Import them from `@nxgt/material/print`, and install `@react-pdf/renderer` and
+  `react-pdf-tailwind` in the app that prints — they are optional peers now.
+  
+  Why it is worth a major: `@react-pdf/renderer` reaches `pdfkit`, which registers
+  its fourteen standard fonts through
+  `createRequire(import.meta.url)('#standard-fonts/<name>')` — a specifier private
+  to pdfkit, called at runtime, that no bundler resolves. Any SSR consumer that
+  bundled this package therefore shipped a server which threw on **every request**,
+  `/health` included; three did on 2026-09-22 and each worked around it locally. An
+  app that does not render PDFs now never has pdfkit in its graph at all.
+  
+  Also in this release, for the apps that do print:
+  
+  - `@nxgt/material/vite` exports `pdfkitStandardFonts()`, the Vite `transform` that
+    bundles those fonts — one implementation instead of one per consumer. Needed
+    only when the runtime image ships the bundle without a `node_modules`.
+  - `bun run build` fails if any entry but `print.js` reaches those two packages,
+    transitively.
+  - `"sideEffects": ["**/*.css"]` is declared. It does not fix the above (measured),
+    it is simply true — and the CSS entry matters: a bare `false` lets a bundler drop
+    `dist/material.css`.
+
+## 1.16.6
+
+### Patch Changes
+
+- [#289](https://github.com/softistx/nxgt-material/pull/289) [`71e6c66`](https://github.com/softistx/nxgt-material/commit/71e6c669bbf89cda6b94f4b048ebff467f2e7a7a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Stop depending on itself
+  
+  `package.json` carried `"@nxgt/material": "."` in its own `dependencies`. It
+  arrived incidentally in an i18n commit in May (`c5154f0`) and nothing in this
+  repository ever used it: no file imports `@nxgt/material` by name, and
+  self-referencing a package by its own `name` works through `exports` without a
+  dependency entry anyway.
+  
+  It was not inert in consumers. `bun pm pack` ships the line, so every install of
+  `@nxgt/material` also resolved `@nxgt/material@file:.` — and `.` is the
+  *consumer's* directory, not this package's. In one consumer's monorepo that
+  materialised as a second `@nxgt/material` in `node_modules/.bun` reporting
+  version `1.0.0`, which is the version of that monorepo's own root
+  `package.json`, plus a permanent `"@nxgt/material/@nxgt/material":
+  ["@nxgt/material@file:."]` entry in its `bun.lock` that no manifest declared and
+  that `bun install` kept re-creating.
+  
+  Nothing observably broke, because the bundled output uses relative imports and
+  never resolved that alias. The reason to fix it is that it is a lie in a
+  published manifest pointing at a directory this package does not own.
+  
+  Verified: the packed manifest no longer lists itself, a fresh consumer install
+  produces no `file:.` entry, the SSR-safety check passes on all 8 entries, and the
+  suite is green (773 tests, 115 files).
+
+## 1.16.5
+
+### Patch Changes
+
+- [#287](https://github.com/softistx/nxgt-material/pull/287) [`80a9af9`](https://github.com/softistx/nxgt-material/commit/80a9af9c2dfd418aa890f2555b8016f357576c70) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Fix `import '@nxgt/material'` throwing in any node process
+  
+  Since the markdown and code-block editors arrived, the bundle carried two
+  dependencies that touch the DOM at module scope — `document.createElement("i")`
+  from `decode-named-character-reference` and `new DOMParser()` from
+  `hast-util-from-html-isomorphic`. Both are isomorphic packages that answer the
+  `browser` export condition with a DOM implementation, and Vite's library build
+  resolves that condition by default, so the browser halves were bundled in.
+  
+  The effect on a consumer is total and immediate: any app that bundles this
+  package into its server build — every SSR consumer, which is what
+  `ssr.noExternal: ['@nxgt/material']` means — dies at boot with
+  `ReferenceError: document is not defined`, before rendering anything. It was
+  found by nxgt-ory's `verify:artifacts`, which imports the published tarball in a
+  bare runtime.
+  
+  Both are now pinned to their neutral entries, which are the same decoders built
+  on lookup tables rather than on the DOM and are correct in both environments.
+  `bun run build` checks this from now on: `postbuild` imports all eight entries
+  with no DOM present and fails if one throws.
+
+## 1.16.4
+
+### Patch Changes
+
+- [#285](https://github.com/softistx/nxgt-material/pull/285) [`a4d838f`](https://github.com/softistx/nxgt-material/commit/a4d838feef44798ecdf4572f2244a40829418736) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Fit gallery lightbox media to the viewport instead of cropping it: tiles keep the uniform `object-cover` crop, while the lightbox renders the full media with `object-contain`.
+
+## 1.16.3
+
+### Patch Changes
+
+- [#283](https://github.com/softistx/nxgt-material/pull/283) [`b9933f8`](https://github.com/softistx/nxgt-material/commit/b9933f8b8177521286e566e7ce70f51596ccbf10) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Crop gallery media to a uniform aspect and restyle carousel controls.
+
+## 1.16.2
+
+### Patch Changes
+
+- [#281](https://github.com/softistx/nxgt-material/pull/281) [`4b21097`](https://github.com/softistx/nxgt-material/commit/4b210977d9a5fc5b3626de16d28a414a90c58a86) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Close the chat composer mention list when a suggestion is selected.
+
+## 1.16.1
+
+### Patch Changes
+
+- [#279](https://github.com/softistx/nxgt-material/pull/279) [`053bea5`](https://github.com/softistx/nxgt-material/commit/053bea591e5d8941c20009cd38e06db75530f646) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Modernise the emoji picker and add stories for emoji, mentions, chat, markdown and the editor.
+
+## 1.16.0
+
+### Minor Changes
+
+- [#277](https://github.com/softistx/nxgt-material/pull/277) [`8be1b8d`](https://github.com/softistx/nxgt-material/commit/8be1b8d32636b077bf0bd13e162ff499f285bb92) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add MentionList (items + local search) for chat and the rich text editor.
+
+## 1.15.0
+
+### Minor Changes
+
+- [#276](https://github.com/softistx/nxgt-material/pull/276) [`b28c763`](https://github.com/softistx/nxgt-material/commit/b28c7636a741ae4150be16851252ea5656396cfa) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Extract EmojiPicker for chat, markdown shortcodes, and the rich text editor.
+
+- [#274](https://github.com/softistx/nxgt-material/pull/274) [`47a9a1b`](https://github.com/softistx/nxgt-material/commit/47a9a1b742ef9701209831d897da17adb2b081b2) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Terminal, a display-only prompt and log with copy.
+
+## 1.14.0
+
+### Minor Changes
+
+- [#273](https://github.com/softistx/nxgt-material/pull/273) [`137a4b0`](https://github.com/softistx/nxgt-material/commit/137a4b09dfb98c668b7df40dd699f053012bc066) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Markdown (GFM, KaTeX, mermaid) and route ChatMarkdown through it.
+
+### Patch Changes
+
+- [#270](https://github.com/softistx/nxgt-material/pull/270) [`247b800`](https://github.com/softistx/nxgt-material/commit/247b800e7d93714ea571db387c96f5716676a214) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Make EntityHeader a container: stack on small cards, wrap actions, drop useIsMobile.
+
+- [#271](https://github.com/softistx/nxgt-material/pull/271) [`961ec41`](https://github.com/softistx/nxgt-material/commit/961ec414b2c9c21a0b14f3573e7211a1c7707d15) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Kanban columns use bg-background and rounded; add a 390px Phone story.
+
+## 1.13.0
+
+### Minor Changes
+
+- [#268](https://github.com/softistx/nxgt-material/pull/268) [`c1bebca`](https://github.com/softistx/nxgt-material/commit/c1bebca884282847f4e0c30845a21f73330a6fe9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Rebuild Quiz and QuestionCard on Card, ActionCard, GaugeCard and ChecklistCard.
+
+## 1.12.3
+
+### Patch Changes
+
+- [#266](https://github.com/softistx/nxgt-material/pull/266) [`f676791`](https://github.com/softistx/nxgt-material/commit/f676791f33ffa806cb6b988ca9331fa3c3cf9bc1) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Fix ChatInbox desktop layout: side-by-side from @md via a nested container.
+
+## 1.12.2
+
+### Patch Changes
+
+- [#264](https://github.com/softistx/nxgt-material/pull/264) [`a4e62b1`](https://github.com/softistx/nxgt-material/commit/a4e62b1fa0999af0fdc3b15753118b8a7a39053f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Drop bg-muted gallery wells and wrap lightbox chrome on small viewports.
+
+## 1.12.1
+
+### Patch Changes
+
+- [#262](https://github.com/softistx/nxgt-material/pull/262) [`c11a657`](https://github.com/softistx/nxgt-material/commit/c11a6573a951c4e43506175b03137902e0c010e3) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Let the PDF toolbar wrap on small containers instead of overflowing a 48px bar.
+
+- [#260](https://github.com/softistx/nxgt-material/pull/260) [`0ffc029`](https://github.com/softistx/nxgt-material/commit/0ffc029b7ef0fe3edd94195daa5cdb4b9bbb1606) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Make Quiz container-query responsive and show results on a GaugeCard.
+
+## 1.12.0
+
+### Minor Changes
+
+- [#259](https://github.com/softistx/nxgt-material/pull/259) [`bd39a39`](https://github.com/softistx/nxgt-material/commit/bd39a39657428e329e26af45ebb8f5a87065aca0) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ChatInbox (list + thread, container queries) and fix assistant bubbles in dark.
+
+## 1.11.0
+
+### Minor Changes
+
+- [#257](https://github.com/softistx/nxgt-material/pull/257) [`32d48a0`](https://github.com/softistx/nxgt-material/commit/32d48a0a13c161728fc97042a5cf0d31eb11c603) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add EmptyState offline, search and maintenance presets, and drop bg-muted on not-found.
+
+## 1.10.0
+
+### Minor Changes
+
+- [#255](https://github.com/softistx/nxgt-material/pull/255) [`8c5e0df`](https://github.com/softistx/nxgt-material/commit/8c5e0dfcc9574c3cf14d3cc52634eb5eb00647d1) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ScoreCard, ShortcutCard, ChecklistCard, PaceCard and HistogramCard presets.
+
+## 1.9.0
+
+### Minor Changes
+
+- [#253](https://github.com/softistx/nxgt-material/pull/253) [`ccdb1e8`](https://github.com/softistx/nxgt-material/commit/ccdb1e8d1d2405d32a7a71f81bb84362a4301b1a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add PlaceCard, FileCard, StatusCard, RatioCard and ThresholdCard presets.
+
+## 1.8.0
+
+### Minor Changes
+
+- [#251](https://github.com/softistx/nxgt-material/pull/251) [`bee0cd2`](https://github.com/softistx/nxgt-material/commit/bee0cd2163240ffcc258f42081befeca137a89d5) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ReceiptCard, ReviewCard, OfferCard, BandCard and LatencyCard presets.
+
+## 1.7.0
+
+### Minor Changes
+
+- [#250](https://github.com/softistx/nxgt-material/pull/250) [`eadfcf5`](https://github.com/softistx/nxgt-material/commit/eadfcf5fb8e9f9d1110573638d72fc3674ad3fba) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add AlbumCard, TagCard and DeltaListCard presets.
+
+- [#248](https://github.com/softistx/nxgt-material/pull/248) [`1fb8e29`](https://github.com/softistx/nxgt-material/commit/1fb8e29ff35bbab37d17007212f06f951f8a85eb) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add LinkCard and SparkbarCard presets.
+
+## 1.6.0
+
+### Minor Changes
+
+- [#246](https://github.com/softistx/nxgt-material/pull/246) [`66bb2bd`](https://github.com/softistx/nxgt-material/commit/66bb2bdfea35f91cdf8f29383905f000436a2036) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add EventCard and StackCard presets.
+
+## 1.5.0
+
+### Minor Changes
+
+- [#244](https://github.com/softistx/nxgt-material/pull/244) [`dd75c1e`](https://github.com/softistx/nxgt-material/commit/dd75c1efd537b6c45d94b8bcad57dfdf7820cb90) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add MessageCard and GaugeCard presets.
+
+## 1.4.0
+
+### Minor Changes
+
+- [#243](https://github.com/softistx/nxgt-material/pull/243) [`ee2aefd`](https://github.com/softistx/nxgt-material/commit/ee2aefd9699af8a07a1cfad44b34d19384b07a57) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add TimelineCard and FunnelCard presets.
+
+### Patch Changes
+
+- [#240](https://github.com/softistx/nxgt-material/pull/240) [`23fe4a7`](https://github.com/softistx/nxgt-material/commit/23fe4a7ebe27c20a08001d6bedc4b7e3e3115637) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Tree rows are full-width rounded bars, including indent.
+
+## 1.3.0
+
+### Minor Changes
+
+- [#239](https://github.com/softistx/nxgt-material/pull/239) [`13106c9`](https://github.com/softistx/nxgt-material/commit/13106c9c635964780f8ae6b67d6b2eaee9055f69) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add CompareCard and HeatweekCard dashboard tiles.
+
+## 1.2.0
+
+### Minor Changes
+
+- [#236](https://github.com/softistx/nxgt-material/pull/236) [`b52b78b`](https://github.com/softistx/nxgt-material/commit/b52b78b7fb31dff4b8a4ca5e84101f34b4a4b1ad) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add SplitCard, TicketCard and NoticeCard presets.
+
+### Patch Changes
+
+- [#237](https://github.com/softistx/nxgt-material/pull/237) [`af768bb`](https://github.com/softistx/nxgt-material/commit/af768bbb5fc29d574e9aeb6131d41bc5f29dd7ea) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Tree rows are rounded pills that hug the label; indent is empty gutter, not a full-width bar.
+
+## 1.1.0
+
+### Minor Changes
+
+- [#209](https://github.com/softistx/nxgt-material/pull/209) [`830c7b1`](https://github.com/softistx/nxgt-material/commit/830c7b1e0653132366f05d4a6fb51393839c4847) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ApiOperation: method + path, optional ParamTable, optional example CodeGroup.
+
+- [#235](https://github.com/softistx/nxgt-material/pull/235) [`4c7dbcd`](https://github.com/softistx/nxgt-material/commit/4c7dbcd7abd398621b53068b98c44945ae88f14c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add OverlayCard, SpotlightCard and CrewCard presets.
+
+- [#230](https://github.com/softistx/nxgt-material/pull/230) [`24b870d`](https://github.com/softistx/nxgt-material/commit/24b870daf6f10219aa0d058e479ae780ecf523c6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add FeatureCard and MediaCard presets (responsive, compose Card).
+
+- [#231](https://github.com/softistx/nxgt-material/pull/231) [`caa16e7`](https://github.com/softistx/nxgt-material/commit/caa16e70dd391024bdcba43b653abe067cb2b79c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add PricingCard and ProfileCard presets.
+
+- [#232](https://github.com/softistx/nxgt-material/pull/232) [`e5c5988`](https://github.com/softistx/nxgt-material/commit/e5c598839bc3696e9b219aa495396717e97d8ccb) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add QuoteCard and a responsive UI/Cards Gallery story.
+
+- [#205](https://github.com/softistx/nxgt-material/pull/205) [`ddb6f70`](https://github.com/softistx/nxgt-material/commit/ddb6f70e3fa45459804acb3b2405efdf29a20951) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ParamTable, AnchorHeading, a reading-progress bar, copy-page on DocHeader, and DocChildCards for section landings.
+
+- [#201](https://github.com/softistx/nxgt-material/pull/201) [`d9756c5`](https://github.com/softistx/nxgt-material/commit/d9756c5f716f7ea011e88cd14cb229095c7d95e8) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Documentation site shell (`Doc`) that reuses `ListTile`, `Card`, `Tabs`, `Alert` and `ActionCard`. Adds `Steps`, `Hero`, `Figure`, a `line` Tabs variant and a `sm` ListTile size.
+
+- [#206](https://github.com/softistx/nxgt-material/pull/206) [`8fbf1e2`](https://github.com/softistx/nxgt-material/commit/8fbf1e2c0f647a9e34258f1c44e1eac168efd580) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Doc sidebar can filter pages in place. `[` / `]` move to the previous / next page. Skip-to-content link and hash restore after navigation.
+
+- [#208](https://github.com/softistx/nxgt-material/pull/208) [`a814c77`](https://github.com/softistx/nxgt-material/commit/a814c777fea5908ad2f05d34a5d1e0168587fee2) Thanks [@SteveGT96](https://github.com/SteveGT96)! - DocPage lists sibling pages in a See also block before the pager.
+
+- [#214](https://github.com/softistx/nxgt-material/pull/214) [`7789a73`](https://github.com/softistx/nxgt-material/commit/7789a7355a0754c78461c0b9d74b7dd25c2c6230) Thanks [@SteveGT96](https://github.com/SteveGT96)! - EmptyState uses a tinted icon well and tighter type. DocEmpty is the docs 404/empty slot.
+
+- [#229](https://github.com/softistx/nxgt-material/pull/229) [`8e1bf7d`](https://github.com/softistx/nxgt-material/commit/8e1bf7d1c8c5534a4a932d74207844e77cc49cda) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add useHeadingSpy. Doc chrome uses it for the on-this-page active heading.
+
+- [#228](https://github.com/softistx/nxgt-material/pull/228) [`4b62083`](https://github.com/softistx/nxgt-material/commit/4b620831172430c5ff286518330ab2bed6702109) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add HighlightText and splitMatch. Doc search hits highlight the query.
+
+- [#234](https://github.com/softistx/nxgt-material/pull/234) [`8226c91`](https://github.com/softistx/nxgt-material/commit/8226c9138ceccb3cde8065c47c68e65abe148433) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add BreakdownCard and RankCard, plus a UI/Metrics Dashboard gallery.
+
+- [#233](https://github.com/softistx/nxgt-material/pull/233) [`f2433a8`](https://github.com/softistx/nxgt-material/commit/f2433a8a3df0f841bba9efedfbf6e1166f86418f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add TrendCard and GoalCard dashboard tiles (metrics folder).
+
+- [#222](https://github.com/softistx/nxgt-material/pull/222) [`bae7c1a`](https://github.com/softistx/nxgt-material/commit/bae7c1a4344dc3922c2f0876112cd2e2063c511e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Extract Pager from the doc shell. isExternalHref lives on @nxgt/material/lib.
+
+- [#221](https://github.com/softistx/nxgt-material/pull/221) [`c963673`](https://github.com/softistx/nxgt-material/commit/c9636733d5bee69de876b686c1f80f7cfe0c2bc9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Extract ScrollProgress and SkipLink from the doc shell. Scroll chrome uses react-use (useScroll / useWindowScroll).
+
+- [#224](https://github.com/softistx/nxgt-material/pull/224) [`89e0162`](https://github.com/softistx/nxgt-material/commit/89e01627f142b1e4272414ffdbad41095ddddd3b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Extract SeeAlso from the doc shell. Rows use a dark-safe hover, not bg-muted.
+
+- [#223](https://github.com/softistx/nxgt-material/pull/223) [`58df191`](https://github.com/softistx/nxgt-material/commit/58df191e660e1f56d2628af37b956838d8b6b1d3) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Extract Toc from the doc shell. DocToc composes it with DocLink and the active heading.
+
+### Patch Changes
+
+- [#225](https://github.com/softistx/nxgt-material/pull/225) [`17b0178`](https://github.com/softistx/nxgt-material/commit/17b01785366c4513ae6d5c8035470e5915906f01) Thanks [@SteveGT96](https://github.com/SteveGT96)! - CopyButton uses react-use (useCopyToClipboard, useTimeoutFn). Doc copy actions compose it.
+
+- [#217](https://github.com/softistx/nxgt-material/pull/217) [`1f652e1`](https://github.com/softistx/nxgt-material/commit/1f652e1c64814efb1a248059d43331875dfebfb9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Document the Storybook UI/Doc/Api recipe: DocPage with AnchorHeading, ApiOperation, ParamTable and CodeGroup.
+
+- [#203](https://github.com/softistx/nxgt-material/pull/203) [`16956bb`](https://github.com/softistx/nxgt-material/commit/16956bb6120a13bfeee088835baad3ff43cb7e22) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Lift `CodeGroup` and `ApiEndpoint` out of `doc/` as generic components. The API path stays readable in dark mode. The Doc sidebar sits on the left edge instead of a centred max-width row.
+
+- [#207](https://github.com/softistx/nxgt-material/pull/207) [`6fbd0cc`](https://github.com/softistx/nxgt-material/commit/6fbd0cc8c97a5a0559edcaf232d6a79ed744d3f6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - DocHeader can copy the page as markdown (`markdown` prop, or the article text as a fallback).
+
+- [#220](https://github.com/softistx/nxgt-material/pull/220) [`066430a`](https://github.com/softistx/nxgt-material/commit/066430a72edd0d3b80ea921cb75a58df993aafc9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - DocHeader editHref shows a pencil and an outbound icon on external links.
+
+- [#219](https://github.com/softistx/nxgt-material/pull/219) [`f9ccbbf`](https://github.com/softistx/nxgt-material/commit/f9ccbbfe995b511af2ce9b3de7baba81c248b3bd) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Sidebar filter empty uses a compact well, and nav icon wells use bg-background.
+
+- [#216](https://github.com/softistx/nxgt-material/pull/216) [`f284e1b`](https://github.com/softistx/nxgt-material/commit/f284e1b9323570d7fb7c82f597ae329ba1128351) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Pager and See also show an outbound icon on external hrefs, same as the sidebar.
+
+- [#218](https://github.com/softistx/nxgt-material/pull/218) [`1eeee15`](https://github.com/softistx/nxgt-material/commit/1eeee156eaca92abe3525731ef4f18bc4376c7ee) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Doc search hits are airier: icon well, snippet, outbound icon, compact empty, and a kbd footer.
+
+- [#212](https://github.com/softistx/nxgt-material/pull/212) [`7bf7c83`](https://github.com/softistx/nxgt-material/commit/7bf7c83b3f5db2c4c94bee16d416bfa7f09f90f2) Thanks [@SteveGT96](https://github.com/SteveGT96)! - On this page: per-item primary marker (transparent when idle), active row bg-primary/10 and text-primary.
+
+- [#213](https://github.com/softistx/nxgt-material/pull/213) [`b74623e`](https://github.com/softistx/nxgt-material/commit/b74623e33e1611ace3c7c5be7d5d4a0e87613140) Thanks [@SteveGT96](https://github.com/SteveGT96)! - On this page uses `rounded` on the rail panel, items, and marker.
+
+- [#210](https://github.com/softistx/nxgt-material/pull/210) [`633efc1`](https://github.com/softistx/nxgt-material/commit/633efc1503d37d3aa39fe90619fc89a8e8809150) Thanks [@SteveGT96](https://github.com/SteveGT96)! - On this page items each have a left bar (primary when active) so the indicator stays on the text. Search hits show descriptions; pager cards show `[` / `]`.
+
+- [#227](https://github.com/softistx/nxgt-material/pull/227) [`7184407`](https://github.com/softistx/nxgt-material/commit/7184407d405e9d99c1ac03f1fb554c4d88a533e6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Doc topbar search chip uses bg-background and rounded, not bg-muted.
+
+- [#215](https://github.com/softistx/nxgt-material/pull/215) [`2d33c38`](https://github.com/softistx/nxgt-material/commit/2d33c38cbd469c703cb975eccb5849b74dba7f5c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - DocHeader accepts a Date for `updatedAt` and renders it with RelativeTime.
+
+- [#226](https://github.com/softistx/nxgt-material/pull/226) [`10084b5`](https://github.com/softistx/nxgt-material/commit/10084b51f80e7def1c8e7397b494a9f75b10c4c9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Doc chrome uses react-use for keydown (useEvent) and the md breakpoint (useMedia).
+
+- [#204](https://github.com/softistx/nxgt-material/pull/204) [`768e733`](https://github.com/softistx/nxgt-material/commit/768e733630efed344b03451c1482604fd5b2f5eb) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Repo-sync now covers adding and improving catalog widgets in `@nxgt/material-vue`. README Vue-equivalent column for Doc, CodeGroup, ApiEndpoint, Steps, Hero and Figure.
+
+- [#211](https://github.com/softistx/nxgt-material/pull/211) [`3d8ed8d`](https://github.com/softistx/nxgt-material/commit/3d8ed8dd09f23588792481684463a54f61b8de59) Thanks [@SteveGT96](https://github.com/SteveGT96)! - ThemeToggle and ToggleGroup use bg-background so dark-mode icons stay visible.
+
+## 1.0.5
+
+### Patch Changes
+
+- [#198](https://github.com/softistx/nxgt-material/pull/198) [`babed08`](https://github.com/softistx/nxgt-material/commit/babed08afe185a3cfdec2fb3685c6c9f97674886) Thanks [@SteveGT96](https://github.com/SteveGT96)! - README: "At a glance" overview, table of contents, a grouped component catalogue with the `@nxgt/material-vue` equivalent of each entry, and a helpers reference for `/lib`, `/hooks`, `/i18n`, `/models`, `/types` and `/dnd`.
+
+- [#198](https://github.com/softistx/nxgt-material/pull/198) [`babed08`](https://github.com/softistx/nxgt-material/commit/babed08afe185a3cfdec2fb3685c6c9f97674886) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Export `UploadFormField` from `@nxgt/material/components`. `AppSidebar`'s default brand is the icon alone. Licensed under MIT.
+
+## 1.0.4
+
+### Patch Changes
+
+- [#196](https://github.com/softistx/nxgt-material/pull/196) [`92b06b6`](https://github.com/softistx/nxgt-material/commit/92b06b66bac86f72e37688e93639347ef6107b25) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Keep the `ActionCard` icon box square and cap its height (`max-h-16 aspect-square`) so tall content no longer stretches it.
+
+## 1.0.3
+
+### Patch Changes
+
+- [#195](https://github.com/softistx/nxgt-material/pull/195) [`732f5da`](https://github.com/softistx/nxgt-material/commit/732f5da8dac7258c17f9704a126185618bdc06af) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Document that `styles.css` must be imported explicitly in the Tailwind entry (single `@theme` graph, Tailwind CSS IntelliSense), and that the compiled `style` condition (`dist/material.css`) is for apps without Tailwind.
+
+- [#192](https://github.com/softistx/nxgt-material/pull/192) [`3f459a3`](https://github.com/softistx/nxgt-material/commit/3f459a3e85df5042ba50e471e88040820e103908) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add fill-available size utilities and stretch the split-button chevron to the control height.
+
+- [#194](https://github.com/softistx/nxgt-material/pull/194) [`a7e957d`](https://github.com/softistx/nxgt-material/commit/a7e957d119582cc551641d694eb5c5bfc6f5fd36) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Export styles.css from lib/ and copy any relative CSS imports into dist on postbuild.
+
+## 1.0.2
+
+### Patch Changes
+
+- [#190](https://github.com/softistx/nxgt-material/pull/190) [`17c171d`](https://github.com/softistx/nxgt-material/commit/17c171daaad4f596ab4f9748dbdea5baa1c25348) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Rewrite the npm README for a developer who does not know the private apps.
+  
+  Install once, setup (CSS + sprites) as snippets, then usage by area — each
+  with a copy-paste example. Private application names are gone from this
+  page; they stay in AGENTS.md.
+
+## 1.0.1
+
+### Patch Changes
+
+- [#188](https://github.com/softistx/nxgt-material/pull/188) [`65f7f8d`](https://github.com/softistx/nxgt-material/commit/65f7f8d991f9a3455e0be2f37502d2603ddc90b4) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Complete the npm README.
+  
+  Install, every `exports` subpath, the required peers, i18n wiring, the
+  parameterised app shell, and the SSR traps (`clientOnly`, no `<svg><title>`)
+  now live on the page a consumer reads. The CSS `@source` line and the Font
+  Awesome Pro sprite rule were already there and stay.