@nxgt/material-vue 0.25.1 → 0.26.0

package/CHANGELOG.md

@@ -0,0 +1,1650 @@
+# @nxgt/material-vue
+
+## 0.26.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
+
+## 0.25.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
+
+## 0.25.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 0.25.0 shipped (`TreeSelectField`, the same options as `@nxgt/material`, `DateRangeField` presets and time, `FilePreview`) under Shipped. Troubleshooting has a new entry for `TimePicker`'s AM / PM fix — it moves the time into that half once (it could add 12 hours twice) and a click on the pressed half emits nothing — and the `FilePreview` entry quotes the HTTP error `@error` receives, `Could not read …: HTTP 404`.
+- Updated dependencies [[`d4e953f`](https://github.com/softistx/nxgt-material/commit/d4e953fd4fc147b366c5d9d70ebfb1aa3a3c0ba7)]:
+  - @nxgt/material-core@0.3.1
+
+## 0.25.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`, `with-time`,
+  `min-date` and `max-date`, as `@nxgt/material`'s. `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 `min-date`, ends after `max-date`, either end is one of
+  `disabled-days`, or (a preset of your own) its end comes before its start.
+  Picking one closes the popover, except with `with-time`, where OK closes it. `min-date` / `max-date` are
+  the first and last day the calendar lets you pick (Reka's `minValue` /
+  `maxValue`). `with-time` 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 (it no longer closes on the second day),
+  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), and an end set before the start on the same day becomes the
+  start time. Without `with-time`, a picked day still carries the current
+  time of day (`@nxgt/material` gives it 00:00). 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-vue/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, as in `@nxgt/material`: AM / PM follows the `date` it is
+  given, switching it always moves the time into that half of the day, a click
+  on the pressed half changes nothing, and the 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), as in `@nxgt/material`: 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 `max-text-bytes` (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 `@error`. 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 until mounted, 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 it emits `error`. Also exported from
+  `@nxgt/material-vue/components`: `fileKind`, `FilePreviewHttpError`,
+  `FilePreviewUnsafeUrlError`, `TEXT_PREVIEW_MAX_BYTES` and the types `FileKind`, `FilePreviewSource`,
+  `FilePreviewProps` and `FilePreviewStatus` (from
+  `@nxgt/material-core/file-preview`). The Nuxt module registers
+  `FilePreview`.
+  
+  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` (public) now goes through `useBlobUrl` and cleans up with
+  `onScopeDispose`, so it also works inside an effect scope.
+
+- [#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`.
+
+- [#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.
+
+### 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)! - The `DateRangeField` `with-time` 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 0.24.0 shipped under Shipped, and the troubleshooting entry for `Table` attributes names the version it applies from (0.24.0).
+
+- [#419](https://github.com/softistx/nxgt-material/pull/419) [`2a41ae1`](https://github.com/softistx/nxgt-material/commit/2a41ae13664b425c6c7d37b921e95914eabb2552) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `NumberField` takes an `aria-labelledby`, as `@nxgt/material`'s does, for an
+  input that is a part of a larger field. The `material.slider.value` key is
+  added to keep the bundles in step with `@nxgt/material`, whose single-value
+  `Slider` readout input it names.
+- 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
+
+## 0.24.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="{ filtered }"` slot 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. A slot that renders nothing gets the
+  default. New type: `DataTableEmptyState`.
+  
+  `Table` now puts the attributes you pass (`aria-*`, `id`, `style`,
+  listeners) on the `<table>`, as `@nxgt/material` does, instead of on its
+  scrolling container; `class` was already the table's. A `style="max-height:…"`
+  or a `@scroll` on `<Table>` therefore no longer limits or follows the
+  scrolling: put the height limit on a wrapper of your own (see "A `Table`'s
+  `id`, `aria-*` or `style` is no longer on its scrolling container" in
+  troubleshooting).
+  
+  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).
+
+- [#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.
+
+### 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` slot 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`:
+  
+  - `ColorField` without `v-model`: text that is not a hex stayed in the field
+    and painted the swatch; it now puts the last valid color back, as with
+    `v-model`.
+  - `InlineEdit`: Enter emitted `save` (and `update:modelValue`) twice, and
+    Escape emitted it with the old text — removing the focused input fired its
+    blur, which saved again. It no longer does. Closing the editor with Enter,
+    Escape, Save or Cancel now returns focus to the field instead of `<body>`,
+    and reopening it focuses the input every time (it relied on `autofocus`,
+    which a browser honours once per document).
+
+- [#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.
+
+- [#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 `slider-range` field now shows its
+  label and description (it rendered the bare slider, with thumbs named only
+  "Minimum" and "Maximum") through `SliderField`, with its readout text ("20 – 70"), as
+  `@nxgt/material` does, and
+  a labelled range `SliderField` is a group named by its label. The
+  `material.slider.minimum` / `maximum` keys are added to keep the bundles in
+  step with `@nxgt/material`.
+
+- [#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.
+
+- [#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 and options shared with `@nxgt/material`, and the
+  `DateRangeField` presets, `TreeSelectField`, `DataTable` loading and empty
+  states and `FilePreview` to follow. The `Combobox` primitive family is recorded
+  as not planned, with its reason.
+
+- [#413](https://github.com/softistx/nxgt-material/pull/413) [`f4b1edf`](https://github.com/softistx/nxgt-material/commit/f4b1edf209c4c5c21304b599b84eee924777fca0) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Slider` / `SliderField`: the thumb takes the theme's background colour
+  (`bg-background`) instead of `bg-white`, so it no longer shows as a white
+  disc in dark mode, as in `@nxgt/material`.
+
+- [#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 Vue'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`, now on every step
+    as in `@nxgt/material`) — 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.
+
+## 0.23.4
+
+### 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="md"`): without an `#icon` slot, the check indicator
+  now sits at the right edge of the card instead of the left, as it does with
+  an icon and in `variant="sm"`.
+  The `md` indicator also gets the `sm` one's look: a bordered circle when
+  inactive, and the same transition.
+
+## 0.23.3
+
+### 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 the Nuxt module
+  runs for Nitro's trace now come from `@nxgt/material-core`
+  (`/format-file-size`, `/pdfkit-fonts`), shared with `@nxgt/material`, instead
+  of a copy in this package. No API change: `formatFileSize` is still exported
+  by name, and the module adds the same files to `nitro.externals.traceInclude`.
+  When some fonts cannot be resolved, `nuxi build` now prints one
+  `pdf fonts:` warning naming every failure, instead of one per font.
+- 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
+
+## 0.23.2
+
+### 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 ».
+
+- [#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.
+
+## 0.23.1
+
+### Patch Changes
+
+- [#398](https://github.com/softistx/nxgt-material/pull/398) [`dac4ddf`](https://github.com/softistx/nxgt-material/commit/dac4ddf2d15190a904ae55b56ea3e31b9616990d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `ImageCropper` and `ImageCropperDialog` no longer throw
+  `TypeError: Cannot read properties of null (reading 'naturalHeight')` when
+  they are closed or unmounted while the photo is still loading. The error came
+  from the cropper's stencil preview and was uncaught, so it surfaced in
+  whatever ran next.
+
+- [#399](https://github.com/softistx/nxgt-material/pull/399) [`448b036`](https://github.com/softistx/nxgt-material/commit/448b0360ee21de7ec750e134941bcb3e0d519a24) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The Nuxt module now adds pdfkit's standard-font files to what Nitro copies
+  into `.output/server/node_modules`. Before, a production build rendered no
+  PDF on the server: every `pdfResponse` route answered HTTP 500 with
+  `Cannot find module '…/pdfkit/js/standard-fonts/Helvetica.cjs'`, because
+  pdfkit loads those files with a runtime `require` Nitro's tracer never sees.
+  `nuxi dev` and servers built with `pdf.bundleStandardFonts` under
+  `noExternals` were not affected. `@nxgt/material-core` needs nothing more:
+  Nitro traces it like any dependency, or inlines it under `noExternals`.
+
+- [#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 0.23.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
+
+## 0.23.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-vue` 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`, your imports or your Nuxt config.
+
+  `@nxgt/material-core` holds the code `@nxgt/material-vue` and
+  `@nxgt/material` 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 `/pdf`, the PDF file
+  helpers behind `PdfReader` and `usePdf`, 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-vue/pdf`, `/lib`, `/vite`, `/components` 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. `react`
+  and `@react-pdf/renderer` stay optional peers, loaded only when a PDF is
+  rendered.
+
+  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-vue` — 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-vue', '@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-vue@0/docs/troubleshooting.md#cannot-find-package-nxgtmaterial-core)).
+
+### Patch Changes
+
+- [#388](https://github.com/softistx/nxgt-material/pull/388) [`a3dae5c`](https://github.com/softistx/nxgt-material/commit/a3dae5c66b76e6ab31f591fddefdd0723a640152) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The README now links to the upgrade notes in Getting started, which list what to check when moving to each version.
+- Updated dependencies [[`deaf0c4`](https://github.com/softistx/nxgt-material/commit/deaf0c49cbc2268fd20e9e2272104dbd27e4ce7f)]:
+  - @nxgt/material-core@0.1.0
+
+## 0.22.0
+
+### Minor Changes
+
+- [#157](https://github.com/softistx/nxgt-material-vue/pull/157) [`be1264a`](https://github.com/softistx/nxgt-material-vue/commit/be1264a9d9fec18e22a7f3f8a272df6eb53773e3) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `AttributesField` follows its `attributes`, and shows helper text
+
+  - `AttributesField` read `attributes` once, on mount, so a form `resetForm()`
+    or `setFieldValue()` on an `AttributesFormField` did not change the list on
+    screen. It now follows the prop when its value changes, without echoing the
+    change back through `onChange`. A new array with the same content (a list
+    rebuilt on each render) is not a change and does not undo the user's edits.
+    Edits no longer mutate the array you passed in place.
+  - `AttributesField` gains `error` and `helperText`. `AttributesFormField`
+    passes its error through them and gains a `helperText` prop, shown when
+    there is no error.
+
+- [#223](https://github.com/softistx/nxgt-material-vue/pull/223) [`58ee698`](https://github.com/softistx/nxgt-material-vue/commit/58ee698e4bbc4bc10204fb507ae7adeb756d565f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `CurrencyField` / `CurrencyFormField`: new `fraction-digits` option. The
+  amount is shown with the currency's own decimals by default (ISO 4217: `JPY`
+  0, `EUR` 2, `KWD` 3), the rule `formatAmount` already follows; it always
+  showed two before. Pass `:fraction-digits="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.
+
+- [#200](https://github.com/softistx/nxgt-material-vue/pull/200) [`eb82839`](https://github.com/softistx/nxgt-material-vue/commit/eb828391bc6dee29108fbd95dfbee5069ecc3a0c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Every `*FormField` now marks its field touched when focus leaves it **and validates it then**, so a required field's error appears as the user moves past it rather than only on submit — as vee-validate's `<Field>` does by default (`validateOnBlur: true`). Until now no wrapper but `RichTextEditorFormField` and `FilterFormField` called `handleBlur`, so `meta.touched` stayed `false` until submit and "show errors once touched" never showed anything. 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. `RichTextEditorFormField` now counts its toolbar as part of the field, and validates on blur too. `FilterFormField` is unchanged (touched when applied). Validation on value change and on submit is unchanged.
+
+- [#157](https://github.com/softistx/nxgt-material-vue/pull/157) [`351fc37`](https://github.com/softistx/nxgt-material-vue/commit/351fc37dce0639078225fa47bce0451ef531e550) 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 JsonViewer reads `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-vue] Could not format the fallback` warning in development
+    only. Plain fallbacks are not parsed at all, and parsed messages are cached.
+  - `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 }`
+    (`ZodLocaleErrorOptions`) 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.
+
+- [#182](https://github.com/softistx/nxgt-material-vue/pull/182) [`690ec8a`](https://github.com/softistx/nxgt-material-vue/commit/690ec8a12ce42639c27a3ec46388aedf6211b009) 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`:
+
+  - `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 buttons' labels, on
+    `Calendar` and `DateRangeField`, use two;
+    the others (year paging, `Go to Today`, the caption button) are React's,
+    kept so both bundles stay identical.
+  - `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 `aria-label` on
+  `Spinner`, `ScrollToTop`, `CalendarPrevButton` or `CalendarNextButton` still
+  wins.
+  `LocationMarker` now shows `You are here` as its tooltip by default, as the
+  React marker does; fill its `#tooltip` slot to replace it.
+
+- [#207](https://github.com/softistx/nxgt-material-vue/pull/207) [`08a7e81`](https://github.com/softistx/nxgt-material-vue/commit/08a7e816ce285048bcc8fba03807c08503af3506) Thanks [@SteveGT96](https://github.com/SteveGT96)! - New entry `@nxgt/material-vue/pdf`: PDF documents from plain data, with the
+  same document model and renderer as `@nxgt/material/print` (byte for byte, so
+  a document template written for one library renders identically in the
+  other).
+
+  - Builders (`pdfDocument`, `page`, `header`, `text`, `table`, `dataTable`,
+    `keyValueOf`, `metric`, …) produce a plain `PdfDocument`, serialisable and
+    usable on the server.
+  - `renderPdfBlob`, `renderPdfBuffer`, `renderPdfStream`, `pdfResponse` (a
+    `Response` with the right headers, for a Nitro/H3 route), `downloadPdf`,
+    `openPdf`, and `contentDisposition` for a response of your own.
+  - `usePdf(source, { fileName, immediate })` returns `{ blob, url, loading,
+error, refresh, download }` and does nothing on the server; `download()`
+    saves the document `source` holds when it is called, waiting for its render.
+    `PdfDownloadButton` renders one document on click, emits `error`, and
+    rethrows a failure when nothing listens to `@error` (it reaches
+    `app.config.errorHandler`, else the console).
+  - A `definePdfDocument` template annotates its data parameter, and its other
+    parameters may take defaults (`(invoice: Invoice, language = 'en') => …`).
+  - The print table and value helpers are exported here too:
+    `definePrintColumns`, `resolvePrintTable`, `resolvePrintFields`,
+    `toPrintValue`, `formatPrintValue`, `isEmptyPrintValue` and the
+    `PrintColumn` / `PrintValue` types. A `'sum'` total over amounts in more
+    than one currency is left empty, and a `Date` cell prints as a date.
+  - The theme (`defaultPdfTheme`, `resolvePdfTheme`, `resolvePdfColor`) and
+    `PdfPeerMissingError`.
+  - Built-in strings (page numbers, totals, the empty table) follow the
+    library's i18n, in English and French.
+
+  `react` (`^18.2.0 || ^19.0.0`) and `@react-pdf/renderer` (`^4.9.0`) are
+  **optional peers**, loaded on the first render: nothing changes for an app
+  that does not import `/pdf`. An app that does installs them with
+  `bun add react @react-pdf/renderer@^4.9`; without them, rendering throws
+  `PdfPeerMissingError` with that command.
+
+  Also new: `@nxgt/material-vue/vite` exports `pdfkitStandardFonts()`, and the
+  Nuxt module takes `pdf: { bundleStandardFonts: true }` to add it to Nitro, for
+  a server whose runtime image has no `node_modules` (pdfkit loads its fonts
+  from a specifier no bundler resolves).
+
+- [#202](https://github.com/softistx/nxgt-material-vue/pull/202) [`68a1295`](https://github.com/softistx/nxgt-material-vue/commit/68a129571f713ecc60291251bc4de18237b8b0f1) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader` opens any source: `file` takes a `Blob` (a `File`, a fetched PDF),
+  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`.
+
+- [#197](https://github.com/softistx/nxgt-material-vue/pull/197) [`64db655`](https://github.com/softistx/nxgt-material-vue/commit/64db655efd464bd3fdef4a8be94e71bf319d4f5e) 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.
+
+- [#222](https://github.com/softistx/nxgt-material-vue/pull/222) [`9014823`](https://github.com/softistx/nxgt-material-vue/commit/90148230c7fb9b9b3587d6a8e77eb62868de71ed) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader` takes `externalLinkTarget` (`'_blank' | '_self' | '_parent' |
+'_top'`, default `'_blank'`): a link to a website inside the PDF opens in a new
+  tab by default, whatever the PDF asks; `'_self'` opens it in place.
+  `rel` stays `noopener noreferrer nofollow`.
+
+  `toPdfjsSource` and `toPdfjsParams` are exported beside `usePdfReader` (with
+  the `PdfjsSourceParams` / `PdfjsUrlParams` types), so a layout of your own
+  loads bytes with pdf.js without detaching your buffer.
+
+  `TooltipContent` takes `to`, where the tooltip is teleported.
+
+- [#202](https://github.com/softistx/nxgt-material-vue/pull/202) [`6b30301`](https://github.com/softistx/nxgt-material-vue/commit/6b303018afb00568a40030f661e311a837a793f4) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader` makes the links inside the PDF clickable, as `@nxgt/material` does:
+  a link to another page goes to it, and a link to a website opens in a new tab
+  by default, with `rel="noopener noreferrer nofollow"` (`externalLinkTarget`
+  picks another target).
+
+  Its 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`).
+
+  `DropdownMenuContent` takes `to`, the element the menu is teleported into
+  (`body` by default): pass the fullscreen element, read when the menu opens,
+  for a menu opened in fullscreen.
+
+- [#202](https://github.com/softistx/nxgt-material-vue/pull/202) [`c4b7965`](https://github.com/softistx/nxgt-material-vue/commit/c4b7965667131469b0645c3a526885393bf230f5) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `formatAmount` and `formatDate` take a locale and a time zone, move to
+  `@nxgt/material-vue/lib` (as in `@nxgt/material`), 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
+    1.0). `formatDate` also accepts a `Date` or an epoch number.
+  - They are exported from `/lib`, as in `@nxgt/material`; `/components` and
+    the root barrel still export them.
+  - `useFormatters({ locale?, timeZone? })` from `@nxgt/material-vue/composables`
+    (auto-imported by the Nuxt module) 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`). `locale` and `timeZone` may be refs or getters; the language and the
+    options are read on each call, so a template follows them.
+  - `createFormatters({ locale?, timeZone? })` from `/lib` binds them outside a
+    component: a Nuxt server route.
+
+  **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.
+
+- [#207](https://github.com/softistx/nxgt-material-vue/pull/207) [`c67631c`](https://github.com/softistx/nxgt-material-vue/commit/c67631c5e3859a2d0e55218f3efb0aaa6236450f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PrintHeader` takes a logo image; `translateMaterial()` for strings outside a component
+
+  - **`PrintHeader`**: a `logo` image (URL or data URL, or
+    `{ src, width, height }` in points) with its `logoAlt` (empty, so
+    decorative, by default), 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 `logo-text="LOGO"` to keep the old
+    box. Same props and behaviour as `@nxgt/material`'s `PrintHeader`.
+  - **`translateMaterial(language, key, fallback, values)`**
+    (`@nxgt/material-vue/i18n`): the package's own strings for a language given
+    as a value, with no plugin and no composable — for a PDF's page-number
+    callback or a server. `useMaterialTranslation().t` now goes through it.
+  - New i18n keys `material.print.page-of` ("Page {page} of {pages}" / "Page
+    {page} sur {pages}") and `material.print.page`, in English and French, for
+    the new `@nxgt/material-vue/pdf`.
+  - `@nxgt/material-vue/pdf` exports `PrintValue` and `formatPrintValue`, with
+    the same behaviour as in `@nxgt/material`.
+
+- [#207](https://github.com/softistx/nxgt-material-vue/pull/207) [`1e578d4`](https://github.com/softistx/nxgt-material-vue/commit/1e578d4502a80485a9a4e93418c2888d925d2c43) Thanks [@SteveGT96](https://github.com/SteveGT96)! - i18n keys for printed tables
+
+  - New keys `material.print.table.total` ("Total") and
+    `material.print.table.empty` ("No rows" / "Aucune ligne"), in English and
+    French, for the tables of the new `@nxgt/material-vue/pdf`.
+  - `@nxgt/material-vue/pdf` exports `definePrintColumns`, `resolvePrintTable`,
+    `resolvePrintFields` and `toPrintValue`, which resolve columns and rows the
+    way `@nxgt/material`'s `PrintDataTable`, `PrintKeyValue` and `PrintMetric`
+    do.
+
+- [#157](https://github.com/softistx/nxgt-material-vue/pull/157) [`2c378f7`](https://github.com/softistx/nxgt-material-vue/commit/2c378f7dc16f9eb99eb101d292a9f4834f0991cf) Thanks [@SteveGT96](https://github.com/SteveGT96)! - CodeBlock dark body, ButtonGroup active label, AvatarGroup initials, menu
+  `error` items, editor mention items, ThemeToggle
+
+  - `CodeBlock scheme="dark"` showed a dark header over a light code area: the
+    global `pre` / `code` rules (`bg-muted`, padding, radius) painted over its
+    body. CodeBlock now resets them on its own `<pre>` and `<code>`; a plain
+    `<pre>` elsewhere keeps its styling.
+  - `ButtonGroup`: an active tonal button painted `bg-primary` under its
+    `text-primary` label, so the label disappeared. The active button now uses
+    the primary foreground for its text and icons.
+  - `AvatarGroup`: the initials inherited the page's font size and ran under
+    the next avatar. Each size now sets the initials' size, and the overlap is
+    smaller so they fit (`-space-x-0.5` / `-1` / `-1.5`).
+  - `MenubarItem`, `ContextMenuItem` and `DropdownMenuItem` accept
+    `variant="error"`, as in `@nxgt/material`. `'destructive'` is deprecated and
+    kept as an alias; both render `data-variant="error"`, so a selector on
+    `[data-variant=destructive]` stops matching. `MenubarItem` and
+    `ContextMenuItem` used `text-destructive-foreground`, a colour the theme does
+    not define, so their destructive items were not red at all; they are now.
+  - `RichTextEditor` `options.mentions.suggestions` accepts
+    `(string | MentionItem)[]`. Strings become `{ id, label }`; choosing an item
+    inserts its `id` and shows its `label`. `filterMentions` takes
+    `{ match: 'prefix' | 'substring' }` (default `'substring'`, unchanged;
+    `FilterMentionsOptions`), and the editor uses `'prefix'`, as before.
+  - `ThemeToggle` no longer freezes on the choice it mounted with: it
+    destructured `useTheme()`'s getters, so its selected item never followed a
+    click.
+
+### Patch Changes
+
+- [#205](https://github.com/softistx/nxgt-material-vue/pull/205) [`85be906`](https://github.com/softistx/nxgt-material-vue/commit/85be906c78a0518e6bc99d45392913c4b9e94758) 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 `helper-text`, 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`: the home crumb is a link named "Home" rather than a
+  `<button>` inside a link.
+
+  `QRCode`: `aria-label` is a declared prop that names the `<svg role="img">`
+  (and wins over `title`), instead of falling through to the wrapper `div`.
+
+- [#225](https://github.com/softistx/nxgt-material-vue/pull/225) [`e0de943`](https://github.com/softistx/nxgt-material-vue/commit/e0de9432c03922518c3b652b66033fcbeb8df3df) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `AlertDialogContent` honours an `@open-auto-focus` that calls
+  `event.preventDefault()`: focus stays where it was, as it does on
+  `DialogContent`, `SheetContent` and `DrawerContent`. reka focused the
+  `AlertDialogCancel` a tick later regardless, and its focus trap kept focus
+  there. Opening without the opt-out still focuses the Cancel (or the first
+  control when there is none).
+
+- [#223](https://github.com/softistx/nxgt-material-vue/pull/223) [`319fc46`](https://github.com/softistx/nxgt-material-vue/commit/319fc46ae60a20830ed4ef017c963deb2a014bf7) 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 (and validates it) as it is left. It used to count that overlay
+  as the field's own and wait until the list handed focus back to its trigger.
+  A field's own list also stays its overlay when it opened before focus reached
+  the field, as long as a control of the field names it (`aria-controls`), like
+  `@nxgt/material`.
+
+- [#208](https://github.com/softistx/nxgt-material-vue/pull/208) [`1b0d117`](https://github.com/softistx/nxgt-material-vue/commit/1b0d117083e592fbed6188ab3fd1388e4f46cf00) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `AppBreadcrumb`: a crumb on a route record with params links to its path with
+  the current params filled in (`/users/42`), not to the record's pattern
+  (`/users/:id`, which vue-router rendered as a literal `:id`). Home and every
+  crumb keep going through the router's history base.
+
+  `CheckboxGroup` / `RadioGroupField`: the group element carries its `id` (yours,
+  or the generated one its option ids start with), as React's groups do; it
+  had none.
+
+- [#228](https://github.com/softistx/nxgt-material-vue/pull/228) [`e9aafcc`](https://github.com/softistx/nxgt-material-vue/commit/e9aafccc69a1b225060cfcf753ab13663a21c8ff) 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.
+
+- [#216](https://github.com/softistx/nxgt-material-vue/pull/216) [`357360a`](https://github.com/softistx/nxgt-material-vue/commit/357360ad855577d1acedb83ef7be12c5e5d4aeb5) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A dismissible `Chip` given both a `label` and a default slot named its ✕ after
+  the `label` it was not showing. The ✕ is now named after the text the chip
+  shows: the default slot's when one is given (`Remove Lyon`), else `label`; with
+  no text it keeps "Remove". The same rule as `@nxgt/material`'s `Chip`.
+
+- [#184](https://github.com/softistx/nxgt-material-vue/pull/184) [`d70cc8a`](https://github.com/softistx/nxgt-material-vue/commit/d70cc8a21893e64a112d3e34b2877e9317301c2f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The close buttons of dialogs, sheets and `DialogFooter`, and the map's zoom
+  and "My position" buttons, follow `I18nProvider` (`material.buttons.close`,
+  `material.map.zoom-in`, `material.map.zoom-out`, `material.map.my-position`,
+  the same keys as `@nxgt/material`): they were English in every language.
+
+- [#227](https://github.com/softistx/nxgt-material-vue/pull/227) [`7283634`](https://github.com/softistx/nxgt-material-vue/commit/72836342d91ce23af594ed0bb66ff226985f02c8) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A Tailwind app that imports `@nxgt/material-vue/styles.css` now gets the CSS
+  the components need, which reached only the compiled stylesheet before:
+  KaTeX (`Markdown` maths), highlight.js (`RichTextEditor` code blocks),
+  vue-sonner (`Toaster`), vue-advanced-cropper (`ImageCropper`), the `Spinner`
+  animation, the `ImageCropper` handles, and the stylesheets of `ButtonGroup`,
+  `ContactItem`, `OpeningHoursItem`, `AttributeForm` and `AttributeValuesForm`,
+  which were CSS modules and are global `nxgt-*` classes now.
+  The compiled stylesheet gains vue-advanced-cropper's stylesheet, which it
+  was missing.
+
+- [#159](https://github.com/softistx/nxgt-material-vue/pull/159) [`292a111`](https://github.com/softistx/nxgt-material-vue/commit/292a111f476f8d6c24be1326cd37f9105e006e89) 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/`. Its rows and categories are the same as
+    `@nxgt/material`'s.
+  - `docs/` now ships in the package:
+    - one page per category: preview, example, options;
+    - the component gallery;
+    - getting started;
+    - guides for forms (vee-validate and Zod), i18n, the app shell, theming,
+      printing, maps, SSR and Nuxt, and the helpers;
+    - troubleshooting;
+    - the roadmap.
+  - File names, headings and preview names match `@nxgt/material`'s docs, so a
+    link keeps working when you switch framework.
+  - The README's long sections moved to those guides.
+
+- [#190](https://github.com/softistx/nxgt-material-vue/pull/190) [`240b28e`](https://github.com/softistx/nxgt-material-vue/commit/240b28e3fb3758f5b4501b29cedb1d170cb19860) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `DateField`, `DateRangeField` and `TimeField` pass the attributes you give them
+  (`id`, `aria-describedby`, `data-*`, listeners) to the trigger: their root is a
+  popover (or a dialog), which renders no element, so they were dropped. An `id`
+  becomes the popover trigger's id, which also labels the open calendar
+  (`PopoverTrigger` now honours an `id`). `TimeField` renders the desktop trigger
+  on the server (`useMediaQuery` with `ssrWidth`), as a desktop client's first
+  render does, so SSR pages hydrate without a mismatch; a phone switches to the
+  dialog once mounted.
+
+  `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".
+  Without a trailing button, that input is now the field's tab stop.
+  `UploadField`, `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` (give an `error` its `helper-text`).
+
+- [#192](https://github.com/softistx/nxgt-material-vue/pull/192) [`acc86c6`](https://github.com/softistx/nxgt-material-vue/commit/acc86c698a6a7687b5e23cdfe4461c9b60870484) Thanks [@SteveGT96](https://github.com/SteveGT96)! - An `aria-label` passed to `Icon`, `ScrollProgress`, `FileList` or `Tree`, and a
+  `data-slot` passed to `ScrollProgress`, `Pager`, `Toc` or `SeeAlso`, now reach
+  the element. They were declared as props under their kebab-case names, which
+  Vue stores camelized, so the component always fell back to its default (for
+  `Icon`, `Icon <name>`). `DocProgress` had the same bug.
+
+  Inside `Doc`, `DocToc`, `DocPager`, `DocSeeAlso` and `DocProgress` now render
+  their own `data-slot` (`doc-toc`, `doc-pager`, `doc-see-also`,
+  `doc-progress`) instead of the inner component's (`toc`, `pager`, `see-also`,
+  `scroll-progress`).
+
+- [#194](https://github.com/softistx/nxgt-material-vue/pull/194) [`2cc0785`](https://github.com/softistx/nxgt-material-vue/commit/2cc07857497baba6e2b4657374672b28d9f3d704) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Icon badges that looked like an `IconButton` but did nothing are no longer
+  buttons: the `FileListField` row badge, the `NetworkUploadField` file preview,
+  the `EntityHeader`, `ConfirmationDialog` and `AppSidebar` icons, the `Stepper`
+  info icon and the `AccordionCard` chevron (a button nested in the trigger
+  button; it now turns when open). Each was a nameless `<button>` (focusable, except the disabled upload preview); each is now a `<span>`
+  (`as="span"`) with `aria-hidden="true"` and the same look. The row badges of
+  `Contacts`, `OpeningHours`, `PostalAddress` and `AttributesList`, already
+  `<div>`s, are hidden too; a `Contacts` badge is `role="img"`, named by the
+  contact type.
+
+  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.
+
+- [#223](https://github.com/softistx/nxgt-material-vue/pull/223) [`e748a8f`](https://github.com/softistx/nxgt-material-vue/commit/e748a8f9d6675373f9fbd45f869423617deff309) 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.
+
+- [#166](https://github.com/softistx/nxgt-material-vue/pull/166) [`c87b446`](https://github.com/softistx/nxgt-material-vue/commit/c87b4469b2af4113d4a4006f4901bf576983ec70) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `ContactItem` and `OpeningHoursItem` (and their props types) are deprecated, as in `@nxgt/material`, and will be removed in 1.0: use `ContactsFormField` and `OpeningHoursFormField`.
+
+- [#157](https://github.com/softistx/nxgt-material-vue/pull/157) [`82db5a2`](https://github.com/softistx/nxgt-material-vue/commit/82db5a24d1be1c34615670552b33b241e0944c3a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Dialog fixes
+
+  - `CustomDialog` (and `ConfirmationDialog`, through it) no longer wraps its
+    `#trigger` slot in a second `<button>`: the trigger is merged into the
+    slotted element (`as-child`), so a `Button` there is the dialog trigger
+    itself instead of a button nested in a button.
+  - `ConfirmDialog` awaits `@confirm` (now typed `onConfirm: () => void |
+Promise<void>`). It stays open while the handler runs (both buttons
+    disabled, "Processing..."), closes on success, and on a throw or rejection
+    stays open and shows the error's message instead of closing. Before, it
+    closed on click whatever the handler did. The pending label and the message
+    for an error without one are translated
+    (`material.confirm-dialog.processing`, `material.confirm-dialog.failed`, en
+    and fr). A plain `@confirm="open = false"` keeps working.
+
+- [#224](https://github.com/softistx/nxgt-material-vue/pull/224) [`bed9e08`](https://github.com/softistx/nxgt-material-vue/commit/bed9e08d86c8b29dc96f56369fe85e8439507130) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `DrawerContent` hands focus back, on close, to the element that had it when
+  the drawer opened: the button of yours that opened a controlled `Drawer` (no
+  `DrawerTrigger`) gets it back, where focus used to fall to `<body>`. Focus
+  that already went elsewhere stays there, and an `@close-auto-focus` that calls
+  `event.preventDefault()` opts out. `Dialog`, `Sheet` and `AlertDialog`
+  already did this.
+
+- [#191](https://github.com/softistx/nxgt-material-vue/pull/191) [`8104999`](https://github.com/softistx/nxgt-material-vue/commit/8104999a2fadc09aa621fc7718438f53154da6e1) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The package no longer ships type declarations for story helpers and story
+  data. None was reachable from an entry point, so no import changes.
+
+- [#221](https://github.com/softistx/nxgt-material-vue/pull/221) [`3025a37`](https://github.com/softistx/nxgt-material-vue/commit/3025a37a6ccc225de0f6963d003685be05edcb49) 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 `class`; 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 (yours, else a
+  generated id), so a click on it opens the picker, and the open popover (or
+  `TimeField`'s dialog on a phone) is labelled by the trigger. The label and
+  the helper text are still not dimmed with a disabled trigger.
+
+  `Slider`: an `aria-label` or `aria-labelledby` names every thumb (a vertical
+  slider had nameless thumbs), and `aria-invalid` (`SliderField`'s `error`) goes
+  on the thumbs rather than on the root `span`.
+
+  `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 same
+  keys and strings as `@nxgt/material` 2.2.0). 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.
+
+- [#169](https://github.com/softistx/nxgt-material-vue/pull/169) [`e643e39`](https://github.com/softistx/nxgt-material-vue/commit/e643e39dd2617154b7eb4e4183a1c50ecadfa9ea) 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), as in
+  `@nxgt/material`.
+
+- [#165](https://github.com/softistx/nxgt-material-vue/pull/165) [`56c3349`](https://github.com/softistx/nxgt-material-vue/commit/56c334903673a20894c64c036407a9cb9723e79e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `LinkButton`, `IconLinkButton` and `ResponsiveLinkButton` render one link styled as a button instead of a `<button>` inside an `<a>`. `Steps` numbers its `StepsItem`s by position when they have no `index`, as in `@nxgt/material`. A collapsed `ResponsiveButton` keeps its label as screen-reader text, so the `Filter` popover trigger (and any icon-only responsive button) has an accessible name. The doc examples import icons from `@lucide/vue`.
+
+- [#172](https://github.com/softistx/nxgt-material-vue/pull/172) [`c930ab4`](https://github.com/softistx/nxgt-material-vue/commit/c930ab47c66a4c24ce46b7870ae1fbf6472348dd) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `ResponsiveButton` (and `ResponsiveLinkButton`, `LoadMoreButton`) 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`, as in `@nxgt/material`.
+
+  `Switch`: the row's text is now the switch's `<label>`, with a generated `id`
+  when none is given, so a switch with a `label` has an accessible name and
+  clicking the text toggles it. An uncontrolled switch's row (`default-value`)
+  is tinted while it is on and follows each toggle; before, only `v-model`
+  tinted it.
+
+- [#164](https://github.com/softistx/nxgt-material-vue/pull/164) [`45ff37f`](https://github.com/softistx/nxgt-material-vue/commit/45ff37fea19330c1a3cf8562f4c13c4c03295df4) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `HeatmapChart` cells take the theme colours instead of rendering black: chart colours resolve to `rgb()` (the `--chart-*` tokens are `oklch()`, which ECharts' visualMap cannot interpolate), and `colors` accepts any CSS colour. `toast()` hands `Toast` its real id, so the action button dismisses the toast and Vue no longer warns about the `id` prop. `Markdown` typesets `$$` display math and `$` inline math instead of showing escaped KaTeX markup, and leaves `$` inside code alone. `Table` is `table-auto`, as in `@nxgt/material`, so `ParamTable` and the other tables size their columns to their content instead of clipping them.
+
+- [#160](https://github.com/softistx/nxgt-material-vue/pull/160) [`65e3995`](https://github.com/softistx/nxgt-material-vue/commit/65e3995d9df2359484b10cf28148d64fcef245cd) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `CheckboxGroup` shows and toggles its checked options (it bound `checked`, which Reka's `CheckboxRoot` does not read). `ToggleGroup` items follow a `size`, `variant` or `spacing` that changes after mount. `Switch` shows `helperText` without a `placeholder`, under the row or the bare switch.
+
+- [#163](https://github.com/softistx/nxgt-material-vue/pull/163) [`5b5a4a5`](https://github.com/softistx/nxgt-material-vue/commit/5b5a4a5d217c77dfb09da2e989f3da052be4d22f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `useTranslation()` from `createTypedTranslation` follows `changeLanguage`: `t` and `i18n.language` read the provider's language on every call instead of a setup-time copy. `defineStepFormStore` resumes from what `updateStep` stored under its `name` (and `reset()` clears it). The Nuxt module registers every component `/components` exports, including `PdfReader` and its parts, `Camera`, `StxPlayer`, `VideoPlayer`, `PaneLayout` / `ListDetailsLayout` and their parts, the `Filter` parts and `SortableHandle`, and no longer registers rich-text-editor internals the barrel does not export. `ConfirmDialog` and `ConfirmationDialog` translate their default button labels (`material.confirm-dialog.confirm` / `.cancel`, English and French).
+
+- [#162](https://github.com/softistx/nxgt-material-vue/pull/162) [`e7231c2`](https://github.com/softistx/nxgt-material-vue/commit/e7231c220ffe9da2e0f2ab2c1ebca507abe4cf8c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A `Map` without `center` opens on its default position again: `useGeolocation().coords` is `null` until the first fix, so `LocationMarker` and "My position" also wait for a real position. Print `tw()` writes every length with a unit (points for the scale, radii and tracking, 1 px borders, arbitrary values as written), and `border-b` draws the bottom side only, so the `Print*` blocks get their padding and hairlines in the browser without a stylesheet workaround.
+
+- [#161](https://github.com/softistx/nxgt-material-vue/pull/161) [`2d36932`](https://github.com/softistx/nxgt-material-vue/commit/2d369329956eae03662b261e4e29212a08286915) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Optional boolean props no longer turn into `false` when omitted. Vue casts an absent `Boolean` prop to `false`, which overrode the documented defaults: `RichTextEditor` (and `RichTextEditorFormField`) was read-only without `editable`; `Notifications`, `Gallery`, `ImageCropperDialog` and `PaneLayout` could not run uncontrolled (`default-open` and the trigger were ignored); charts never showed their empty state for empty data, and `AreaChart` dropped `#emptyState`; `DataTable` hid its header row; `ResponsiveButton` / `ResponsiveLinkButton` stayed icon-only on desktop; `TextareaField` did not count from `max-length` alone; `DocPage` hid the copy buttons; `Filter` hid the inline actions and the trigger label; and `RatingFormField`, `SliderFormField`, `TextareaFormField`, `SortableListFormField`, `TransferListFormField` and `FilterFormField` switched off their field's `true` defaults (clear, readout, search, drag, select all, transfer all).
+
+- [#210](https://github.com/softistx/nxgt-material-vue/pull/210) [`f38ecc5`](https://github.com/softistx/nxgt-material-vue/commit/f38ecc5f0d68e52adfe7239afb826c3223312b49) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `RadioGroupField`, `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. The `radiogroup` carries `aria-invalid` while `error`;
+  a `CheckboxGroup` 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 `helper-text` (through `CheckboxGroup`'s new
+  `#helper-text` slot, so the hint stays inside the description). A caller's
+  `aria-label` / `aria-labelledby` wins and its `aria-describedby` ids are kept;
+  on `RadioGroupField` attributes other than `class` and `style` now land on the
+  `radiogroup` rather than the layout wrapper, and `CheckboxGroup` drops an
+  `aria-invalid` passed to it.
+
+  Option ids are now `` `${id}-${index}` `` instead of `` `${id}-${value}` ``, as
+  in `@nxgt/material`: a value with a space gave an invalid id and a label that
+  pointed nowhere. A selector such as `#<id>-<value>` must move to the index, or
+  better to role and name — see the troubleshooting entry.
+
+- [#206](https://github.com/softistx/nxgt-material-vue/pull/206) [`3d6a67f`](https://github.com/softistx/nxgt-material-vue/commit/3d6a67fc2b1c33cdeffae1a4a1981a0c948b1318) 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`, and a few existing keys are now used
+  where the text was hard-coded:
+
+  - Pagination: the buttons' names and text, which reka-ui left in English
+    ("First Page", "Page 2"…), the ellipsis's "More pages" and the `nav`'s
+    name (`pagination.first`, `previous`, `next`, `last`, `page`, `more`,
+    `label`). The buttons are now named by their text in English too:
+    "First", "Previous", "Next", "Last", as in `@nxgt/material`.
+  - `CommandDialog`'s default title and description (`command.*`), the
+    carousel's `aria-roledescription` (`carousel.roledescription` / `slide`) and
+    the attribute options' "Add option" (`attributes.buttons.add-option`).
+  - 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.*`);
+    `Breadcrumb`'s name and ellipsis, `DocHeader`'s breadcrumb
+    (`breadcrumb.*`, `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; `CircularProgress`'s label, `StxPlayer`'s
+    "Media player", `PaneLayoutPane`'s sheet title, `JsonViewer`'s "Empty JSON"
+    and `TimePicker`'s AM/PM.
+
+  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`; `getValidationMessage`
+  / `getUploadErrorMessage` take `t` (typed `UploadMessageTranslate`) as an
+  optional last argument. Without them the English is unchanged, except that the
+  count error reads "Maximum of 1 file reached" for a single file.
+  `parseJsonSource` marks a blank source with `empty: true`. Your
+  `placeholder`, `sheetTitle`, `title`, `description` and `aria-label` still win.
+
+- [#188](https://github.com/softistx/nxgt-material-vue/pull/188) [`6a476f3`](https://github.com/softistx/nxgt-material-vue/commit/6a476f3e2bc54a6fdbf8d01ceab3bbac4779c2ce) 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`), 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, and so each `Autocomplete` chip's, is named after the
+  text the chip shows: "Remove {label}" (`material.chip.dismiss-label`)
+  instead of "Remove" for every chip. The `LocationPreview` default trigger is
+  "Preview {name}" / "Preview location" (`material.map.preview-named` /
+  `preview`), translated, instead of the bare place name or an English string.
+  A disabled `Autocomplete` now disables its chips' remove buttons, and the
+  `Sidebar` toggle also shows while focus is inside the sidebar, so the keyboard
+  can reach it (it used to appear on hover only).
+
+- [#187](https://github.com/softistx/nxgt-material-vue/pull/187) [`4cb61a7`](https://github.com/softistx/nxgt-material-vue/commit/4cb61a73c81488631e4a31dccb4df2e4d3f1ede8) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Label`'s required asterisk is hidden from screen readers (`aria-hidden`), as
+  in `@nxgt/material`: 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.
+
+- [#179](https://github.com/softistx/nxgt-material-vue/pull/179) [`52be74e`](https://github.com/softistx/nxgt-material-vue/commit/52be74e00e81a4e6befdc38cfc2726890c0ea02d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Switch`'s `helper-text` (the validation message under `SwitchFormField`) now
+  describes the switch through `aria-describedby`, beside the row text and any
+  `aria-describedby` you pass, as in `@nxgt/material`.
+
+  `SwitchField` used without `v-model` now toggles: it used to hold the switch
+  off.
+
+  `Label` no longer renders `withasterisk="false"` / `"true"` as an HTML
+  attribute on the `<label>`.
+
+- [#185](https://github.com/softistx/nxgt-material-vue/pull/185) [`b0c787a`](https://github.com/softistx/nxgt-material-vue/commit/b0c787a382246e446c69dd849f501df69eaacc7b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `LocationField`'s dialog no longer renders an empty, unnamed button beside its
+  close X. The extra `DialogClose` had no content, since Vue's `DialogClose` only
+  renders its slot.
+
+- [#157](https://github.com/softistx/nxgt-material-vue/pull/157) [`81dc973`](https://github.com/softistx/nxgt-material-vue/commit/81dc9732db253f23a9d52acd023a6d4ca921f674) Thanks [@SteveGT96](https://github.com/SteveGT96)! - LocationField empty state and labels; IconButton `aria-label`
+
+  - `LocationField` (`@nxgt/material-vue/map`) with a `null` value showed
+    `5.44087 - 10.06843` (Yaoundé) and a hover preview there. It now shows an
+    empty input with a translated placeholder and no preview. The dialog's pin
+    still starts at that position, and OK on an empty field commits the position
+    the pin shows: the last one dragged to, or the start. Without `v-model`, OK
+    no longer drops the drag.
+  - Its placeholder, dialog title and OK button are translated, with new
+    `material.location-field.{placeholder,dialog-title,confirm}` keys (en and
+    fr). `dialogTitle`, `closeLabel` and `placeholder` still win.
+  - `IconButton` dropped its `aria-label`. Icon buttons given an `aria-label` (and no `tooltip`) had no
+    accessible name; they now have it.
+
+- [#171](https://github.com/softistx/nxgt-material-vue/pull/171) [`35c0227`](https://github.com/softistx/nxgt-material-vue/commit/35c022782fbb99b174b0f10c8038eae8408c7652) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Icons come from `@lucide/vue` only; the deprecated `lucide-vue-next` is no longer a dependency. `@lucide/vue` was already a dependency and stays one, so there is nothing to install. Lucide 1.x redrew some glyphs the components use (among them `Calendar`, `Clock`, `CircleCheck`, `File`/`FileText`, `Trash`, `Bookmark`), and a Lucide icon without `aria-label` or `title` now renders with `aria-hidden="true"`.
+
+- [#215](https://github.com/softistx/nxgt-material-vue/pull/215) [`d9cb581`](https://github.com/softistx/nxgt-material-vue/commit/d9cb581e71f9182d28344cbe8db85c36092246e8) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Map` (`@nxgt/material-vue/map`): closing a `LocationField` dialog before the
+  map had loaded no longer throws `Map container not found.` as an unhandled
+  rejection. `@vue-leaflet/vue-leaflet` builds the map, its layers and controls in
+  async `onMounted` hooks; once the map is unmounting, errors from them are
+  ignored.
+
+  `DateRangeField`: the trigger button carries `data-slot="date-range-field-trigger"`
+  (instead of `popover-trigger`) and the default `data-pw` (`name`, or
+  `date-range-field`), as `DateField`'s does; `data-pw` was on the box inside it.
+
+  The package no longer ships `docs/previews/form-fields-switchfield.webp`, a
+  preview no page linked to (`SwitchField` is pictured by the Switch preview).
+
+- [#195](https://github.com/softistx/nxgt-material-vue/pull/195) [`c0bcd56`](https://github.com/softistx/nxgt-material-vue/commit/c0bcd560cd7171b827014858968a45ebf8c44e3a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `useIsMobile`, `useTheme`, and every component that reads them
+  (`ResponsiveButton`, `AppHeader`, `AppBreadcrumb`, `DataTable`, `Stepper`,
+  `ThemeToggle`, `CodeBlock`, `CodeDiff`, `JsonViewer`, `CodeEditor`) now give
+  the server an answer for their media query, as `TimeField` already did: the
+  server and the first client render answer for `provideSSRWidth()`'s width, or
+  a 1024 px desktop, and a light color scheme, then the client switches. A phone
+  or a dark-mode browser no longer hits `Hydration completed but contains
+mismatches.` on those components.
+
+- [#222](https://github.com/softistx/nxgt-material-vue/pull/222) [`9014823`](https://github.com/softistx/nxgt-material-vue/commit/90148230c7fb9b9b3587d6a8e77eb62868de71ed) 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%.
+  - `@page-change` 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.
+  - Notes show their icon and open their popup, and shapes are styled, with
+    nothing to add to your imports.
+
+  `TooltipContent` (and so every `tooltip` on a `Button` or `IconButton`) opens
+  inside the element in fullscreen while there is one: `PdfReader`'s toolbar
+  tooltips show in fullscreen.
+
+- [#181](https://github.com/softistx/nxgt-material-vue/pull/181) [`84b59c4`](https://github.com/softistx/nxgt-material-vue/commit/84b59c4f7f5ef04c2e49ccfe4775a923d2a6173f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `PdfReader`: `@page-change`, `@load-success` and `@load-error` run once per
+  event. They ran twice, because the reader called the handler as a declared
+  prop and emitted the event too. The `onPageChange`, `onLoadSuccess` and
+  `onLoadError` props are deprecated in favour of the events and go in 1.0;
+  passing them (`:on-page-change="fn"`) still works and runs once.
+
+- [#197](https://github.com/softistx/nxgt-material-vue/pull/197) [`0f2a280`](https://github.com/softistx/nxgt-material-vue/commit/0f2a2800bdea292c211cab95127324efaf9c2d0f) 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.
+
+- [#197](https://github.com/softistx/nxgt-material-vue/pull/197) [`a734547`](https://github.com/softistx/nxgt-material-vue/commit/a734547379c06a8f9e0f6564a8def74f82204c43) 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. Escape is handled
+  only when the search bar is open, so a `Dialog` around the reader closes on
+  Escape again. `@page-change` reports a page inside the document, and only when
+  it changes.
+
+- [#197](https://github.com/softistx/nxgt-material-vue/pull/197) [`7891491`](https://github.com/softistx/nxgt-material-vue/commit/7891491f1a42411f066cf16aa2576bdb6ddbb4c7) 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 `@page-change`
+  reports the page most on screen; a page you ask for is reported once, not each
+  page passed on the way.
+
+- [#197](https://github.com/softistx/nxgt-material-vue/pull/197) [`e9c10d1`](https://github.com/softistx/nxgt-material-vue/commit/e9c10d1478c22a9b9c695ebd71c704fb42e7d374) 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. A page asked to redraw while it was still drawing (a zoom or the
+  page sizes arriving during the first render) now redraws; it used to keep its
+  first drawing.
+
+- [#211](https://github.com/softistx/nxgt-material-vue/pull/211) [`5d15b44`](https://github.com/softistx/nxgt-material-vue/commit/5d15b4491856ac1d7d2b71642606f798b0d9f14e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The tarball no longer ships `lib/nuxt`'s test files.
+
+- [#187](https://github.com/softistx/nxgt-material-vue/pull/187) [`49ee618`](https://github.com/softistx/nxgt-material-vue/commit/49ee618a47f538026b08489a437307eba903a6ee) 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 `*`, as in
+  `@nxgt/material`:
+
+  - `DateField`, `DateRangeField`, `TimeField`: the trigger is a `combobox`
+    (a `button` may not carry `aria-required`) named by an `aria-label` /
+    `aria-labelledby` you pass, else by the label, else by `placeholder` (a
+    picker with no label needs one of them), with `aria-required` (and
+    `aria-invalid` with `error`).
+  - `DurationField`: `required` on both inputs.
+  - `SliderField`: `aria-required` on every thumb, and each thumb is named by
+    the label ("Price Minimum" / "Price Maximum" for a range). The bare `Slider`
+    takes `label-id` and `required` for the same.
+  - `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`; its
+    `disabled` (Monaco's `readOnly`) now also reaches the editor when it
+    changes after mount.
+  - `TransferList`: `aria-required` on the Selected listbox, and both panes are
+    named by the label, then their title ("Team Selected"); the label no longer
+    points its `for` at nothing. `SortableList`: the
+    listbox is named by the label, with `aria-required`.
+  - `ComboboxField`: `aria-required` on its `combobox` trigger. `Autocomplete`:
+    `aria-required` on its input.
+  - `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."
+  - Tests that found a picker by the `button` role, or a thumb or a pane by its
+    old exact name: see the troubleshooting page.
+
+- [#173](https://github.com/softistx/nxgt-material-vue/pull/173) [`a5984d3`](https://github.com/softistx/nxgt-material-vue/commit/a5984d3f1f93f25c87c34cfdd819bb66825875d3) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The rich text editor's alignment buttons are named "Align left", "Align
+  center", "Align right" and "Justify" without an `I18nProvider`, instead of the
+  raw values `left`, `center`, `right`, `justify`.
+
+- [#224](https://github.com/softistx/nxgt-material-vue/pull/224) [`10a0860`](https://github.com/softistx/nxgt-material-vue/commit/10a0860db3d56c5eb811d3787293030de6792912) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `SliderField` honours an `aria-invalid` you pass, as `@nxgt/material`'s
+  `Slider` does: it goes on every thumb and wins over `error`. It used to land
+  on the field's root `div`, where it is not allowed and nothing reads it.
+
+- [#198](https://github.com/softistx/nxgt-material-vue/pull/198) [`b0e17dc`](https://github.com/softistx/nxgt-material-vue/commit/b0e17dca58b7a1d57ed71441a8d7eb935b5cae44) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `useTheme()` reads the stored preference once the component has mounted
+  (before paint) instead of in the first render, so a stored `dark` no longer
+  makes `ThemeToggle` or the code blocks mismatch the server HTML. Outside a
+  component it still reads the storage straight away.
+
+  `PaneLayout` and `ListDetailsLayout` answer their width query through the
+  same helper as `useIsMobile()` (`Doc` too, for its desktop-only sidebar
+  reset, which renders nothing): on the server they follow
+  `provideSSRWidth()` (a 1024 px desktop when the app provides none) instead of
+  always rendering the desktop layout, and the client switches once mounted.
+
+- [#223](https://github.com/softistx/nxgt-material-vue/pull/223) [`4ca2585`](https://github.com/softistx/nxgt-material-vue/commit/4ca25858c83b223d553fb8c76ad2c213ac4e337d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Docs: the SSR guide shows how to give the client the width the server passed
+  to `provideSSRWidth()` — through your own server and client entries, or
+  `useState` in Nuxt — so a phone layout rendered on the server hydrates
+  without a mismatch.
+
+- [#216](https://github.com/softistx/nxgt-material-vue/pull/216) [`e40d733`](https://github.com/softistx/nxgt-material-vue/commit/e40d733fe0986420cc1cb0d3a6361f154ba6eab5) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A server-rendered wizard built on `defineStepFormStore` hydrates without a
+  mismatch: while hydrating, the store renders step 0, as the server does, and
+  resumes at the stored step once mounted. A plain client mount still shows the
+  stored step from its first render, and `reset()` still clears it.
+
+- [#227](https://github.com/softistx/nxgt-material-vue/pull/227) [`75cc4e8`](https://github.com/softistx/nxgt-material-vue/commit/75cc4e8de709d4265e83c796338bed9f0b8a1dc8) 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` itself,
+  which it did not do at all before, and its bordered row shows it with a red
+  border; an invalid `Autocomplete` says so on its input, and the chips box
+  shows it with a red border. An `aria-invalid` you pass the `Switch` still wins.
+
+- [#174](https://github.com/softistx/nxgt-material-vue/pull/174) [`e632322`](https://github.com/softistx/nxgt-material-vue/commit/e632322811e73725ddcdb9d45e21ae437aacef9d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Switch` with both a `label` and a `placeholder` now names itself from the
+  `label` explicitly (`aria-labelledby`) and takes the row text as its
+  description (`aria-describedby`), as `@nxgt/material` does. An `aria-label` /
+  `aria-labelledby` you pass still wins.
+
+  The row now carries `data-checked="true"` / `"false"`, the same values as
+  `@nxgt/material`. `data-filed` (misspelt) is still present while on and is
+  deprecated; it is removed in 1.0.
+
+- [#175](https://github.com/softistx/nxgt-material-vue/pull/175) [`56de732`](https://github.com/softistx/nxgt-material-vue/commit/56de732117698aa49cd71cc890cb37d81182960d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `Switch` (and `SwitchField`, `SwitchFormField`) now forwards `required` to the
+  switch, as in `@nxgt/material`: it is announced as required (`aria-required`),
+  and with a `name` inside a `<form>` its hidden input is `required`, so an
+  unchecked required switch now blocks the browser's native submit, like a
+  required checkbox. It used to show only the label's asterisk.
+
+- [#224](https://github.com/softistx/nxgt-material-vue/pull/224) [`b65a5fe`](https://github.com/softistx/nxgt-material-vue/commit/b65a5fe501add96a80223f2a220ba50bd69392c6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `TimeField` no longer puts `aria-invalid` on the plain `div` inside its
+  trigger, where it is not allowed: that box shows an error with a red border
+  now, and the trigger `combobox` alone says the field is invalid.
+
+- [#227](https://github.com/softistx/nxgt-material-vue/pull/227) [`383e526`](https://github.com/softistx/nxgt-material-vue/commit/383e5262d870888213727dbc014080aa08ca4735) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Troubleshooting: focus falling to `<body>` when a controlled `Drawer` closes,
+  why it happened up to 0.21.0, and how to hand it back on an older version.
+
+- [#220](https://github.com/softistx/nxgt-material-vue/pull/220) [`a380465`](https://github.com/softistx/nxgt-material-vue/commit/a380465c513cf7ee23c3e5364130848e072f8d2a) 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".
+
+- [#196](https://github.com/softistx/nxgt-material-vue/pull/196) [`7237aac`](https://github.com/softistx/nxgt-material-vue/commit/7237aac58895c05e99359766311af3204d481437) 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 a trailing button, and the
+  `NetworkUploadField` / `S3UploadField` drop zone, in error without
+  `helper-text`, are described by a visually hidden "This value is
+  not valid." (`material.zod.default`, translated) instead of being only a red
+  outline.
+
+## 0.21.0
+
+### Minor Changes
+
+- [#154](https://github.com/softistx/nxgt-material-vue/pull/154) [`f654936`](https://github.com/softistx/nxgt-material-vue/commit/f6549360ad197993787b57708ca1eef31d302112) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `@nxgt/material-vue/map` — the leaflet map, mirroring `@nxgt/material/map`
+
+  `Map`, `Marker`, `LocationMarker`, `LocationPreview`, `MapActions`,
+  `LocationField`, `LocationFormField` and `useGeolocation`, in an entry of its own
+  with `leaflet` and `@vue-leaflet/vue-leaflet` as **optional peers** — an app that
+  renders no map never has leaflet in its tree.
+
+  ```sh
+  bun add leaflet @vue-leaflet/vue-leaflet
+  ```
+
+  ```vue
+  <script setup lang="ts">
+  import "@nxgt/material-vue/map.css";
+  import { LocationFormField } from "@nxgt/material-vue/map";
+  </script>
+  ```
+
+  `useGeolocation` wraps `@vueuse/core`'s — already a peer — rather than adding a
+  second geolocation dependency, and normalises `coords` to
+  `{ latitude, longitude } | null` so `NaN` before the first fix does not read as a
+  position. `LocationFormField` uses `useField` from vee-validate, like every other
+  `*FormField` here.
+
+  **Not auto-registered by the Nuxt module**, deliberately: auto-registration would
+  make leaflet resolvable from an app that never renders a map.
+
+  **SSR.** `@vue-leaflet/vue-leaflet` loads leaflet with `import()` on mount, so
+  this entry can be imported in a server process — the React mirror's cannot, since
+  `react-leaflet` imports leaflet statically. Leaflet still initialises in the
+  browser only, so wrap it in `<ClientOnly>` under Nuxt. `verify:ssr` gained an
+  `ENTRY_ONLY` check: no entry but `map.js` may reach either package.
+
+  `MinimapControl` is not ported — it is built on `@react-leaflet/core` internals
+  with no Vue counterpart. An arbitrary marker is `LIcon`'s slot rather than a
+  component-marker dependency.
+
+## 0.20.0
+
+### Minor Changes
+
+- [#152](https://github.com/softistx/nxgt-material-vue/pull/152) [`5f72f54`](https://github.com/softistx/nxgt-material-vue/commit/5f72f54b0775f3376503c711c5846b340c4ac88f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `bun run build` now verifies what a consumer's server will do with the bundle
+
+  `postbuild` runs `verify:ssr`, which imports all eight built entries in a runtime
+  with **no DOM** — the same thing a Nuxt server does at boot — and then fails if
+  any entry **statically** reaches a dependency that must stay behind `import()`
+  (`pdfjs-dist` today). Until now this repo only bundled; the modules were never
+  executed, and AGENTS.md said so: "the check is the consumer, not this repo".
+
+  Nothing in the package changed: all eight entries pass both halves today. The
+  check is there so the next barrel change cannot quietly take a consumer's server
+  down at boot — and so the failure is named here rather than diagnosed there.
+
+  Also declares `"sideEffects": ["**/*.css"]`. It is true, not a fix: measured in
+  the React sibling, it changes nothing about what a consumer bundles, because
+  tree-shaking keeps a module whose own package does not promise to be
+  side-effect-free. The CSS entry is not decoration — a bare `false` lets a bundler
+  drop `dist/material-vue.css`.
+
+## 0.19.4
+
+### Patch Changes
+
+- [#150](https://github.com/softistx/nxgt-material-vue/pull/150) [`cabe6d7`](https://github.com/softistx/nxgt-material-vue/commit/cabe6d7f74b91505282688d424a4330038e9fd46) 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 whole media with `object-contain`.
+
+## 0.19.3
+
+### Patch Changes
+
+- [#148](https://github.com/softistx/nxgt-material-vue/pull/148) [`220999c`](https://github.com/softistx/nxgt-material-vue/commit/220999c2f30ed98cd108fdf996f2ec4c8df31e17) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Crop gallery media to a uniform aspect and restyle carousel controls.
+
+## 0.19.2
+
+### Patch Changes
+
+- [#146](https://github.com/softistx/nxgt-material-vue/pull/146) [`4f78749`](https://github.com/softistx/nxgt-material-vue/commit/4f7874990468d7cf16dba4654a2c27b4ea265bc3) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Close the chat composer mention list when a suggestion is selected.
+
+## 0.19.1
+
+### Patch Changes
+
+- [#144](https://github.com/softistx/nxgt-material-vue/pull/144) [`c156dc4`](https://github.com/softistx/nxgt-material-vue/commit/c156dc4c671d9410433df5d0942b54c897f6f2c5) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Modernise the emoji picker and add stories for emoji, mentions, chat, markdown and the editor.
+
+## 0.19.0
+
+### Minor Changes
+
+- [#142](https://github.com/softistx/nxgt-material-vue/pull/142) [`8e7187d`](https://github.com/softistx/nxgt-material-vue/commit/8e7187dfa5e9a16a999ac667dd5b12aaaaefd819) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add MentionList (items + local search) for chat and the rich text editor.
+
+## 0.18.0
+
+### Minor Changes
+
+- [#141](https://github.com/softistx/nxgt-material-vue/pull/141) [`7fe0ba2`](https://github.com/softistx/nxgt-material-vue/commit/7fe0ba2ddbff30b69d5936ce9b9632a72b4c0ab0) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Extract EmojiPicker for chat, markdown shortcodes, and the rich text editor.
+
+- [#139](https://github.com/softistx/nxgt-material-vue/pull/139) [`25eca3c`](https://github.com/softistx/nxgt-material-vue/commit/25eca3ceb2459ad84dec9f0bebf51b40d2bbc9fe) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Terminal, a display-only prompt and log with copy.
+
+## 0.17.0
+
+### Minor Changes
+
+- [#138](https://github.com/softistx/nxgt-material-vue/pull/138) [`d196132`](https://github.com/softistx/nxgt-material-vue/commit/d196132c9f50adcda4333b55443e1d1e4e90a70d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Markdown (GFM, KaTeX, mermaid) and route ChatMarkdown through it.
+
+### Patch Changes
+
+- [#135](https://github.com/softistx/nxgt-material-vue/pull/135) [`ed66431`](https://github.com/softistx/nxgt-material-vue/commit/ed66431569df540b574901b60b8893dd2f510ba4) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Make EntityHeader a container: stack on small cards, wrap actions.
+
+- [#136](https://github.com/softistx/nxgt-material-vue/pull/136) [`0f3f6d3`](https://github.com/softistx/nxgt-material-vue/commit/0f3f6d3bab7a1975eaaac41a776d29b00cb329eb) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Kanban columns use bg-background and rounded; add a 390px Phone story.
+
+## 0.16.0
+
+### Minor Changes
+
+- [#133](https://github.com/softistx/nxgt-material-vue/pull/133) [`7a67eab`](https://github.com/softistx/nxgt-material-vue/commit/7a67eab8e5ee3183ecf11bdbef872aa1b888ad5a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Rebuild Quiz and QuestionCard on Card, ActionCard, GaugeCard and ChecklistCard.
+
+## 0.15.3
+
+### Patch Changes
+
+- [#131](https://github.com/softistx/nxgt-material-vue/pull/131) [`3e55bca`](https://github.com/softistx/nxgt-material-vue/commit/3e55bca0adb87295cb771e97a1505964812f9675) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Fix ChatInbox desktop layout: side-by-side from @md via a nested container.
+
+## 0.15.2
+
+### Patch Changes
+
+- [#129](https://github.com/softistx/nxgt-material-vue/pull/129) [`e0634d8`](https://github.com/softistx/nxgt-material-vue/commit/e0634d8d0320a0165fbcf090f06f903561eca4a7) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Drop bg-muted gallery wells and wrap lightbox chrome on small viewports.
+
+## 0.15.1
+
+### Patch Changes
+
+- [#127](https://github.com/softistx/nxgt-material-vue/pull/127) [`06435ae`](https://github.com/softistx/nxgt-material-vue/commit/06435aefc5eb940f06d6ab751ac0dcc9e4af9115) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Let the PDF toolbar wrap on small containers instead of overflowing a 48px bar.
+
+- [#125](https://github.com/softistx/nxgt-material-vue/pull/125) [`5ede4ea`](https://github.com/softistx/nxgt-material-vue/commit/5ede4ea0ecd6600a763578cb9f8c2b79b360c0e5) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Make Quiz container-query responsive and show results on a GaugeCard.
+
+## 0.15.0
+
+### Minor Changes
+
+- [#124](https://github.com/softistx/nxgt-material-vue/pull/124) [`4d7582e`](https://github.com/softistx/nxgt-material-vue/commit/4d7582e9126c7e21a4781d77fd720a1afdb7244a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ChatInbox (list + thread, container queries) and fix assistant bubbles in dark.
+
+## 0.14.0
+
+### Minor Changes
+
+- [#122](https://github.com/softistx/nxgt-material-vue/pull/122) [`7600881`](https://github.com/softistx/nxgt-material-vue/commit/7600881938c68b989077779382c895869e7b39bf) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add EmptyState offline, search and maintenance presets, and drop bg-muted on not-found.
+
+## 0.13.0
+
+### Minor Changes
+
+- [#120](https://github.com/softistx/nxgt-material-vue/pull/120) [`1136c40`](https://github.com/softistx/nxgt-material-vue/commit/1136c40179f69d2570abf872a063828734c264b9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ScoreCard, ShortcutCard, ChecklistCard, PaceCard and HistogramCard presets.
+
+## 0.12.0
+
+### Minor Changes
+
+- [#118](https://github.com/softistx/nxgt-material-vue/pull/118) [`d242ffc`](https://github.com/softistx/nxgt-material-vue/commit/d242ffc81d51810574fd6a9203fbc9fd6bcb750a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add PlaceCard, FileCard, StatusCard, RatioCard and ThresholdCard presets.
+
+## 0.11.0
+
+### Minor Changes
+
+- [#116](https://github.com/softistx/nxgt-material-vue/pull/116) [`0d910a6`](https://github.com/softistx/nxgt-material-vue/commit/0d910a660cddb86d3650fbae743d8d39351477dd) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ReceiptCard, ReviewCard, OfferCard, BandCard and LatencyCard presets.
+
+## 0.10.0
+
+### Minor Changes
+
+- [#115](https://github.com/softistx/nxgt-material-vue/pull/115) [`4f20cce`](https://github.com/softistx/nxgt-material-vue/commit/4f20cce91630f564bfc39beb3bc818854949320b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add AlbumCard, TagCard and DeltaListCard presets.
+
+- [#113](https://github.com/softistx/nxgt-material-vue/pull/113) [`f6eb240`](https://github.com/softistx/nxgt-material-vue/commit/f6eb240c6c1216ee06939fdcae3882838daa034e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add LinkCard and SparkbarCard presets.
+
+## 0.9.0
+
+### Minor Changes
+
+- [#111](https://github.com/softistx/nxgt-material-vue/pull/111) [`35ea2af`](https://github.com/softistx/nxgt-material-vue/commit/35ea2af1af716c7fb4698b7051578ff8d06c0469) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add EventCard and StackCard presets.
+
+## 0.8.0
+
+### Minor Changes
+
+- [#109](https://github.com/softistx/nxgt-material-vue/pull/109) [`cd5402a`](https://github.com/softistx/nxgt-material-vue/commit/cd5402a9bfdea7a583f86e18e811c18acca5bfd5) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add MessageCard and GaugeCard presets.
+
+## 0.7.0
+
+### Minor Changes
+
+- [#108](https://github.com/softistx/nxgt-material-vue/pull/108) [`587463c`](https://github.com/softistx/nxgt-material-vue/commit/587463c35ca13c8620ceaf7a3964b13e0e31dff1) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add TimelineCard and FunnelCard presets.
+
+### Patch Changes
+
+- [#105](https://github.com/softistx/nxgt-material-vue/pull/105) [`5a9212b`](https://github.com/softistx/nxgt-material-vue/commit/5a9212ba0c691c621871b1679ed69db6a3c3cf40) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Tree rows are full-width rounded bars, including indent.
+
+## 0.6.0
+
+### Minor Changes
+
+- [#104](https://github.com/softistx/nxgt-material-vue/pull/104) [`216c354`](https://github.com/softistx/nxgt-material-vue/commit/216c354742f853aacd6a051f90604929ca69773c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add CompareCard and HeatweekCard dashboard tiles.
+
+## 0.5.0
+
+### Minor Changes
+
+- [#101](https://github.com/softistx/nxgt-material-vue/pull/101) [`9c41e63`](https://github.com/softistx/nxgt-material-vue/commit/9c41e63a8b23ff765c7640ab25f773c05959834b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add SplitCard, TicketCard and NoticeCard presets.
+
+### Patch Changes
+
+- [#102](https://github.com/softistx/nxgt-material-vue/pull/102) [`897f72e`](https://github.com/softistx/nxgt-material-vue/commit/897f72e35ba44110d091571101cc80c2d245ba81) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Tree rows are rounded pills that hug the label; indent is empty gutter, not a full-width bar.
+
+## 0.4.0
+
+### Minor Changes
+
+- [#73](https://github.com/softistx/nxgt-material-vue/pull/73) [`4dd1961`](https://github.com/softistx/nxgt-material-vue/commit/4dd1961b4c3368ea557480dde34115a375e05d91) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ApiOperation: method + path, optional ParamTable, optional example CodeGroup.
+
+- [#100](https://github.com/softistx/nxgt-material-vue/pull/100) [`65bb526`](https://github.com/softistx/nxgt-material-vue/commit/65bb5262501acafda2c2c4995a9eaeebadf83413) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add OverlayCard, SpotlightCard and CrewCard presets.
+
+- [#95](https://github.com/softistx/nxgt-material-vue/pull/95) [`63f729c`](https://github.com/softistx/nxgt-material-vue/commit/63f729c0a855ae6ea39185446ce419550fa362bc) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add FeatureCard and MediaCard presets (responsive, compose Card).
+
+- [#96](https://github.com/softistx/nxgt-material-vue/pull/96) [`2c87cc9`](https://github.com/softistx/nxgt-material-vue/commit/2c87cc9186af19f9922961591a51386a75e48d6a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add PricingCard and ProfileCard presets.
+
+- [#97](https://github.com/softistx/nxgt-material-vue/pull/97) [`421335e`](https://github.com/softistx/nxgt-material-vue/commit/421335e0dbc6884fbf565418769f6fa10ba0f7e6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add QuoteCard and a responsive UI/Cards Gallery story.
+
+- [#69](https://github.com/softistx/nxgt-material-vue/pull/69) [`4a45429`](https://github.com/softistx/nxgt-material-vue/commit/4a454294e715552c0ca66169bc95820fdbc3a506) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ParamTable, AnchorHeading, a reading-progress bar, copy-page on DocHeader, and DocChildCards for section landings.
+
+- [#67](https://github.com/softistx/nxgt-material-vue/pull/67) [`66a6d37`](https://github.com/softistx/nxgt-material-vue/commit/66a6d3742c30f7768aee2c8ad11dc47eed8e0a2f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Port the documentation shell (`Doc`) and the generic `CodeGroup`, `ApiEndpoint`, `Steps`, `Hero` and `Figure` widgets from `@nxgt/material`. Repo-sync now covers adding and improving catalog components, not only shared-contract fixes.
+
+- [#70](https://github.com/softistx/nxgt-material-vue/pull/70) [`47f381c`](https://github.com/softistx/nxgt-material-vue/commit/47f381ce3b622c2e82e3486e39a6108486510bf5) 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.
+
+- [#72](https://github.com/softistx/nxgt-material-vue/pull/72) [`13c133e`](https://github.com/softistx/nxgt-material-vue/commit/13c133e78553bac28b3312dfbdf7e1e718e515c8) Thanks [@SteveGT96](https://github.com/SteveGT96)! - DocPage lists sibling pages in a See also block before the pager.
+
+- [#78](https://github.com/softistx/nxgt-material-vue/pull/78) [`24cc0ae`](https://github.com/softistx/nxgt-material-vue/commit/24cc0aeab94ee8cbd9c19bd5c27f0352627f4a1d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - EmptyState uses a tinted icon well and tighter type. DocEmpty is the docs 404/empty slot.
+
+- [#94](https://github.com/softistx/nxgt-material-vue/pull/94) [`5bc03da`](https://github.com/softistx/nxgt-material-vue/commit/5bc03da362b281d5e867c32e2eea4f48db579cf3) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add useHeadingSpy (vueuse useIntersectionObserver). Doc chrome uses it for the on-this-page active heading.
+
+- [#93](https://github.com/softistx/nxgt-material-vue/pull/93) [`1f68eee`](https://github.com/softistx/nxgt-material-vue/commit/1f68eee8fd177d603186854328d3b35dcf6d08d0) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add HighlightText and splitMatch. Doc search hits highlight the query.
+
+- [#99](https://github.com/softistx/nxgt-material-vue/pull/99) [`e277b94`](https://github.com/softistx/nxgt-material-vue/commit/e277b944b5bf6082bf7b9433d09ebc6a8e041a1a) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add BreakdownCard and RankCard, plus a UI/Metrics Dashboard gallery.
+
+- [#98](https://github.com/softistx/nxgt-material-vue/pull/98) [`9fbd6b2`](https://github.com/softistx/nxgt-material-vue/commit/9fbd6b2d01fcb33f49a11c6b196ceff3706fde83) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add TrendCard and GoalCard dashboard tiles (metrics folder).
+
+- [#87](https://github.com/softistx/nxgt-material-vue/pull/87) [`407d0b0`](https://github.com/softistx/nxgt-material-vue/commit/407d0b02f57440c031b0f8dc193da3376e94e727) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Extract Pager from the doc shell. isExternalHref lives on @nxgt/material-vue/lib.
+
+- [#86](https://github.com/softistx/nxgt-material-vue/pull/86) [`d44ebaf`](https://github.com/softistx/nxgt-material-vue/commit/d44ebafb684ea8640a528e55a75274f5bec96fc7) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Extract ScrollProgress and SkipLink from the doc shell. Scroll chrome uses @vueuse/core (useScroll / useWindowScroll).
+
+- [#89](https://github.com/softistx/nxgt-material-vue/pull/89) [`1ad4155`](https://github.com/softistx/nxgt-material-vue/commit/1ad4155ff8bc0cab3c74405c7ef1c5d6de29dc10) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Extract SeeAlso from the doc shell. Rows use a dark-safe hover, not bg-muted.
+
+- [#88](https://github.com/softistx/nxgt-material-vue/pull/88) [`3a23832`](https://github.com/softistx/nxgt-material-vue/commit/3a238324626da8e69f2ce7e7035e9c13ebab91e5) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Extract Toc from the doc shell. DocToc composes it with DocLink and the active heading.
+
+### Patch Changes
+
+- [#90](https://github.com/softistx/nxgt-material-vue/pull/90) [`785a944`](https://github.com/softistx/nxgt-material-vue/commit/785a94492625b74d75e025fb5b9f1b36c126453e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - CopyButton uses @vueuse/core useClipboard. Doc copy actions compose it.
+
+- [#81](https://github.com/softistx/nxgt-material-vue/pull/81) [`998e97b`](https://github.com/softistx/nxgt-material-vue/commit/998e97b1b0067b4ac495b023cab83f6a606cb18c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Document the Storybook UI/Doc/Api recipe: DocPage with AnchorHeading, ApiOperation, ParamTable and CodeGroup.
+
+- [#71](https://github.com/softistx/nxgt-material-vue/pull/71) [`5e0e3df`](https://github.com/softistx/nxgt-material-vue/commit/5e0e3df3e1c595a5b5aa5ff6bc4dac2871e6dd9b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - DocHeader can copy the page as markdown (`markdown` prop, or the article text as a fallback).
+
+- [#85](https://github.com/softistx/nxgt-material-vue/pull/85) [`5b14b64`](https://github.com/softistx/nxgt-material-vue/commit/5b14b64b69f65519052a5e4ead4e06b6ea6aaa69) Thanks [@SteveGT96](https://github.com/SteveGT96)! - DocHeader editHref shows a pencil and an outbound icon on external links.
+
+- [#84](https://github.com/softistx/nxgt-material-vue/pull/84) [`462185f`](https://github.com/softistx/nxgt-material-vue/commit/462185fcfc57f9e6034734fce8dabc53a3ea9890) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Sidebar filter empty uses a compact well, and nav icon wells use bg-background.
+
+- [#80](https://github.com/softistx/nxgt-material-vue/pull/80) [`283dd79`](https://github.com/softistx/nxgt-material-vue/commit/283dd7935297e4cc0082fb3a958d684d68c3949f) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Pager and See also show an outbound icon on external hrefs, same as the sidebar.
+
+- [#82](https://github.com/softistx/nxgt-material-vue/pull/82) [`37d6361`](https://github.com/softistx/nxgt-material-vue/commit/37d636115bc796fcec80d6d38c452fc0167b4141) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Doc search hits are airier: icon well, snippet, outbound icon, compact empty, and a kbd footer.
+
+- [#76](https://github.com/softistx/nxgt-material-vue/pull/76) [`7c19c7e`](https://github.com/softistx/nxgt-material-vue/commit/7c19c7e4b1f9b141423571a4e598e40eb39ecf02) Thanks [@SteveGT96](https://github.com/SteveGT96)! - On this page: per-item primary marker (transparent when idle), active row bg-primary/10 and text-primary.
+
+- [#77](https://github.com/softistx/nxgt-material-vue/pull/77) [`39a886f`](https://github.com/softistx/nxgt-material-vue/commit/39a886fac5b0737e32968392c7a30ea402222a92) Thanks [@SteveGT96](https://github.com/SteveGT96)! - On this page uses `rounded` on the rail panel, items, and marker.
+
+- [#74](https://github.com/softistx/nxgt-material-vue/pull/74) [`622f206`](https://github.com/softistx/nxgt-material-vue/commit/622f206fe665fb826812a89860568f739a6517c8) 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 `[` / `]`.
+
+- [#92](https://github.com/softistx/nxgt-material-vue/pull/92) [`8cc183f`](https://github.com/softistx/nxgt-material-vue/commit/8cc183f584f7aa7d06ab63c8051e08f353e6186c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Doc topbar search chip uses bg-background and rounded, not bg-muted.
+
+- [#79](https://github.com/softistx/nxgt-material-vue/pull/79) [`4daf75f`](https://github.com/softistx/nxgt-material-vue/commit/4daf75f12672c314d9b4995edfb3a8ab8f9341e6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - DocHeader accepts a Date for `updatedAt` and renders it with RelativeTime.
+
+- [#91](https://github.com/softistx/nxgt-material-vue/pull/91) [`17f1f4d`](https://github.com/softistx/nxgt-material-vue/commit/17f1f4d9c2b092c00573ec5215025d6a6eade263) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Doc chrome uses @vueuse/core for keydown (useEventListener) and the md breakpoint (useMediaQuery).
+
+- [#75](https://github.com/softistx/nxgt-material-vue/pull/75) [`99efd7f`](https://github.com/softistx/nxgt-material-vue/commit/99efd7feb204cb25d82725154b7b0ff1fa05bca9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - ThemeToggle and ToggleGroup use bg-background so dark-mode icons stay visible.
+
+## 0.3.2
+
+### Patch Changes
+
+- [#65](https://github.com/softistx/nxgt-material-vue/pull/65) [`8b08c05`](https://github.com/softistx/nxgt-material-vue/commit/8b08c05901808cb759599ae4be183e14b2fbd779) Thanks [@SteveGT96](https://github.com/SteveGT96)! - README: "At a glance" overview, full component catalogue with React equivalents, and a helpers reference for every subpath.
+
+- [#65](https://github.com/softistx/nxgt-material-vue/pull/65) [`8b08c05`](https://github.com/softistx/nxgt-material-vue/commit/8b08c05901808cb759599ae4be183e14b2fbd779) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Ship type declarations at the paths `package.json` points to (`dist/lib/main.d.ts`, `dist/lib/components/index.d.ts`, …), so TypeScript resolves the package's types. The Nuxt module now auto-imports `useNavigationHandler`, `useNavigationHandlers` and `createTypedTranslation` instead of names that do not exist. `AppSidebar`'s default brand is the icon alone. Licensed under MIT.
+
+## 0.3.1
+
+### Patch Changes
+
+- [#63](https://github.com/softistx/nxgt-material-vue/pull/63) [`8c54295`](https://github.com/softistx/nxgt-material-vue/commit/8c54295f941527290503f7930bde8835c376f79e) 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.
+
+## 0.3.0
+
+### Minor Changes
+
+- [#61](https://github.com/softistx/nxgt-material-vue/pull/61) [`3a41f84`](https://github.com/softistx/nxgt-material-vue/commit/3a41f84419741fc159f5499d3feeeb8b1d62fbba) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Remove the Nuxt CSS auto-injection and the `css` module option: import `@nxgt/material-vue/styles.css` explicitly after `@import "tailwindcss"` (one `@theme` graph, and Tailwind IntelliSense can read the tokens). `styles.css` declares `@source "../dist"` so component utilities are generated by the consumer build. Pre-bundle `jsbarcode` in the Nuxt module (CommonJS default export), and stop passing `undefined` options to JsBarcode so barcodes no longer render 0×0.
+
+## 0.2.0
+
+### Minor Changes
+
+- [#57](https://github.com/softistx/nxgt-material-vue/pull/57) [`c00cf7c`](https://github.com/softistx/nxgt-material-vue/commit/c00cf7c1c2d888a3615217fb81cdb906c4cf4f67) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Port the remaining Feedback catalog (Alert, empty state, confirm dialogs, toasts, progress field) and composed skeleton variants from @nxgt/material.
+
+### Patch Changes
+
+- [#58](https://github.com/softistx/nxgt-material-vue/pull/58) [`0ade7fe`](https://github.com/softistx/nxgt-material-vue/commit/0ade7fe0ee04300fc3dd6c5d8b4b8a327404b9a7) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Inject material styles into the app Tailwind CSS entry so @theme tokens apply without a manual @import.
+
+- [#60](https://github.com/softistx/nxgt-material-vue/pull/60) [`858bb9c`](https://github.com/softistx/nxgt-material-vue/commit/858bb9c69913fdea94843d2f3851df7ae95457d6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Keep icon buttons from collapsing (RTE toolbar) and resolve JsBarcode so barcodes paint on canvas.
+
+## 0.1.0
+
+### Minor Changes
+
+- [#18](https://github.com/softistx/nxgt-material-vue/pull/18) [`dd2a076`](https://github.com/softistx/nxgt-material-vue/commit/dd2a076315798015608768f74684090d5d5a9e9e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Sidebar, AppBar, Background, and AppShell (ActivityLayout, vue-router breadcrumbs).
+
+- [#30](https://github.com/softistx/nxgt-material-vue/pull/30) [`8834bb4`](https://github.com/softistx/nxgt-material-vue/commit/8834bb40469015742e8ca517281e42a6cf9e0e21) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add AttributesField, AttributeForm, AttributeValuesForm, and vee-validate wrappers.
+
+- [#11](https://github.com/softistx/nxgt-material-vue/pull/11) [`3074832`](https://github.com/softistx/nxgt-material-vue/commit/3074832e34cc6e79f0f48f76d2c4613331e2b3d2) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Port ButtonGroup, LinkButton, ResponsiveButton, and SplitButton.
+
+- [#44](https://github.com/softistx/nxgt-material-vue/pull/44) [`338be4b`](https://github.com/softistx/nxgt-material-vue/commit/338be4b834bb51f43bcc8813c0fa8e6dee9a1e0d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Camera, StxPlayer, and a deprecated VideoPlayer re-export.
+
+- [#27](https://github.com/softistx/nxgt-material-vue/pull/27) [`769af7b`](https://github.com/softistx/nxgt-material-vue/commit/769af7b7361b7765d88b6e1864cdea158e914675) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Carousel, QRCode, and Barecode.
+
+- [#32](https://github.com/softistx/nxgt-material-vue/pull/32) [`eff1b1d`](https://github.com/softistx/nxgt-material-vue/commit/eff1b1d5f089b08c96618d8a272f7b602dd614fc) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ECharts chart components (Bar, Line, Area, Pie, Radar, Scatter, Heatmap, Funnel).
+
+- [#43](https://github.com/softistx/nxgt-material-vue/pull/43) [`8f923d7`](https://github.com/softistx/nxgt-material-vue/commit/8f923d76468fa4e8d061827fe9f6cb71d8e07c27) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Chat thread, composer, markdown, and message primitives.
+
+- [#19](https://github.com/softistx/nxgt-material-vue/pull/19) [`2af1269`](https://github.com/softistx/nxgt-material-vue/commit/2af12699088bb76101a04a586de90d68298e69b3) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add typography, kbd, list-tile, chrome toggles, banner, cards, avatar-group, switcher, layouts, and related overlays.
+
+- [#45](https://github.com/softistx/nxgt-material-vue/pull/45) [`e3d3168`](https://github.com/softistx/nxgt-material-vue/commit/e3d316871940369e1f8eaf42409b84e104688221) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add CodeEditor (Monaco via dynamic import) and mark the Vue catalog overlays complete on the roadmap.
+
+- [#20](https://github.com/softistx/nxgt-material-vue/pull/20) [`37a3b64`](https://github.com/softistx/nxgt-material-vue/commit/37a3b64b28c48231cb852497e6ec765e6405788c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ComboboxField, TimezoneField, SelectCardField, CheckCardField, SliderField, and vee-validate wrappers.
+
+- [#26](https://github.com/softistx/nxgt-material-vue/pull/26) [`8585bff`](https://github.com/softistx/nxgt-material-vue/commit/8585bff3049461d37b370a3197c330f26e1b50a1) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Contacts, PostalAddress, and OpeningHours display widgets, dialogs, and vee-validate form fields.
+
+- [#36](https://github.com/softistx/nxgt-material-vue/pull/36) [`883f340`](https://github.com/softistx/nxgt-material-vue/commit/883f34026280f800df3318ba07002fe8f1ea37f6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add ImageCropper, ImageCropperDialog, and print document primitives.
+
+- [#24](https://github.com/softistx/nxgt-material-vue/pull/24) [`76a0acd`](https://github.com/softistx/nxgt-material-vue/commit/76a0acd89ad391ebdf9c589cc40245395742617e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add DataTable with sorting, pagination, column visibility, row selection, and expandable rows.
+
+- [#14](https://github.com/softistx/nxgt-material-vue/pull/14) [`bbb7f46`](https://github.com/softistx/nxgt-material-vue/commit/bbb7f4622a937f5204f0b3c2e287f7f84cb52fff) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add DateField, TimeField, TimePicker, SwitchField, RadioGroupField, and vee-validate wrappers.
+
+- [#33](https://github.com/softistx/nxgt-material-vue/pull/33) [`3239025`](https://github.com/softistx/nxgt-material-vue/commit/3239025925519e3c334837123c0c63616154ac42) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add pointer-based DnD primitives and SortableList with a vee-validate form wrapper.
+
+- [#41](https://github.com/softistx/nxgt-material-vue/pull/41) [`64ee793`](https://github.com/softistx/nxgt-material-vue/commit/64ee793f34a0cdcd25abe7778a6b8e721e08ef5e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add QuestionCard and Quiz education components.
+
+- [#38](https://github.com/softistx/nxgt-material-vue/pull/38) [`8f344b6`](https://github.com/softistx/nxgt-material-vue/commit/8f344b64d26fb6b0b95bf34d984587f35423d419) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add EventCalendar with month, week, workweek, day, and agenda views.
+
+- [#46](https://github.com/softistx/nxgt-material-vue/pull/46) [`7c119c7`](https://github.com/softistx/nxgt-material-vue/commit/7c119c776129d930b889b5bf843910e419048f05) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add the Field config dispatcher that renders nxgt field overlays from a typed config.
+
+- [#10](https://github.com/softistx/nxgt-material-vue/pull/10) [`9979e9c`](https://github.com/softistx/nxgt-material-vue/commit/9979e9c8f3413fe8ffb9eac60fcadf1ebc064b9c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add TextField, TextareaField, NumberField and vee-validate form wrappers.
+
+- [#13](https://github.com/softistx/nxgt-material-vue/pull/13) [`39cdb63`](https://github.com/softistx/nxgt-material-vue/commit/39cdb63f682087947a8997f2d60a840c6d9854a1) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add EmailField, UrlField, PasswordField, OtpField, SelectField, CheckboxGroup, CopyButton, and vee-validate wrappers.
+
+- [#28](https://github.com/softistx/nxgt-material-vue/pull/28) [`8d59fd4`](https://github.com/softistx/nxgt-material-vue/commit/8d59fd4f553495f35e3a2e63c54b2c65ef1366a6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add FileList, FileListField, ImageField, Tree, and their vee-validate form wrappers.
+
+- [#37](https://github.com/softistx/nxgt-material-vue/pull/37) [`c8482cd`](https://github.com/softistx/nxgt-material-vue/commit/c8482cdfa3bf01207f7609905bd0c11451abbf71) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Filter composite with Pinia local store, layout variants, and vee-validate wrapper.
+
+- [#4](https://github.com/softistx/nxgt-material-vue/pull/4) [`d6963ce`](https://github.com/softistx/nxgt-material-vue/commit/d6963ce4166480987f86e4777f277e3577178413) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Port utils, i18n, composables, and RTK slice helpers from nxgt-material.
+
+- [#42](https://github.com/softistx/nxgt-material-vue/pull/42) [`7dd8f54`](https://github.com/softistx/nxgt-material-vue/commit/7dd8f5451fed6f82a87961dbf1a22034de0cea56) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Gallery, LightboxGallery, and MiniGallery with layout presets and lightbox chrome.
+
+- [#15](https://github.com/softistx/nxgt-material-vue/pull/15) [`80e2ea9`](https://github.com/softistx/nxgt-material-vue/commit/80e2ea9f0d338371ac81d59585e5e0051c6efe2c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add InputGroup, InputGroupField, PhoneField (E.164 via libphonenumber-js), and vee-validate wrappers.
+
+- [#35](https://github.com/softistx/nxgt-material-vue/pull/35) [`c6fa1bd`](https://github.com/softistx/nxgt-material-vue/commit/c6fa1bd11c0dd9361d4360f484203af268cd943c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Kanban with column and card reorder, groups, WIP limits, and keyboard moves.
+
+- [#29](https://github.com/softistx/nxgt-material-vue/pull/29) [`ce35547`](https://github.com/softistx/nxgt-material-vue/commit/ce35547b79956344ec99e50738d1fb45849271c9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Notifications, CodeBlock, CodeDiff, and JsonViewer.
+
+- [#48](https://github.com/softistx/nxgt-material-vue/pull/48) [`da702eb`](https://github.com/softistx/nxgt-material-vue/commit/da702eb10260741ff011bf39cc2342007e40aad6) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add a Nuxt module (`@nxgt/material-vue/nuxt`) that injects CSS and auto-imports components and composables.
+
+- [#9](https://github.com/softistx/nxgt-material-vue/pull/9) [`8966fe9`](https://github.com/softistx/nxgt-material-vue/commit/8966fe9c7977e0bdd422c3c8a161c5320d6bef31) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Port nxgt Button variants, Icon, Spinner, IconButton, Chip, CountBadge, HelperText.
+
+- [#23](https://github.com/softistx/nxgt-material-vue/pull/23) [`9c3a10c`](https://github.com/softistx/nxgt-material-vue/commit/9c3a10c519c746b589febf19a1fb08d0cae499df) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add PaneLayout and ListDetailsLayout.
+
+- [#40](https://github.com/softistx/nxgt-material-vue/pull/40) [`30577eb`](https://github.com/softistx/nxgt-material-vue/commit/30577eb885a3171d3f603ed50f570d042a1b7e29) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add PdfReader, a client-only PDF viewer with toolbar, thumbnails, outline, search, and zoom.
+
+- [#7](https://github.com/softistx/nxgt-material-vue/pull/7) [`b1b49d8`](https://github.com/softistx/nxgt-material-vue/commit/b1b49d84d14660d2b287159d5992c413e44ecca2) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Replace Redux Toolkit slices with Pinia local stores for component chrome.
+
+- [#22](https://github.com/softistx/nxgt-material-vue/pull/22) [`85c479a`](https://github.com/softistx/nxgt-material-vue/commit/85c479a97ac7529053597c04b605d908a8ad3ce9) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Autocomplete, CountryField, SelectChipField, DateRangeField, EventChip, and vee-validate wrappers.
+
+- [#39](https://github.com/softistx/nxgt-material-vue/pull/39) [`d3c7f4f`](https://github.com/softistx/nxgt-material-vue/commit/d3c7f4f3b93e1744e4464f84c45d5a926d0db975) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add RichTextEditor with TipTap Vue 3, custom nodes, and a vee-validate form field.
+
+- [#1](https://github.com/softistx/nxgt-material-vue/pull/1) [`b4ba98f`](https://github.com/softistx/nxgt-material-vue/commit/b4ba98fe65843ba86424d1e6845e851cd1a23ffd) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Scaffold the Vue library: Vite, shadcn-vue, Storybook, CI, and changesets.
+
+- [#5](https://github.com/softistx/nxgt-material-vue/pull/5) [`9713868`](https://github.com/softistx/nxgt-material-vue/commit/9713868226f86969fbb73cb1a24010f96c9d218c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add shadcn-vue (Reka UI) primitives: button, inputs, overlays, data display.
+
+- [#21](https://github.com/softistx/nxgt-material-vue/pull/21) [`16dd940`](https://github.com/softistx/nxgt-material-vue/commit/16dd940cd1016ce83b570b21aa060c7ec3319c38) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Stepper, Timeline, RelativeTime, and InlineEdit.
+
+- [#34](https://github.com/softistx/nxgt-material-vue/pull/34) [`09c7160`](https://github.com/softistx/nxgt-material-vue/commit/09c7160171d09ecda94651a553b388f8a40f558e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add TransferList dual-pane selector with Pinia chrome, drag-and-drop, and a vee-validate wrapper.
+
+- [#31](https://github.com/softistx/nxgt-material-vue/pull/31) [`fba155e`](https://github.com/softistx/nxgt-material-vue/commit/fba155ebf547e4a6ac62ae45ed54f0dac5d6dffd) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add UploadField, NetworkUploadField, S3UploadField, and their vee-validate form wrappers.
+
+- [#17](https://github.com/softistx/nxgt-material-vue/pull/17) [`5ac1a31`](https://github.com/softistx/nxgt-material-vue/commit/5ac1a31fab52ec8c1132f26eaf343992f80a16ba) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add PercentField, DurationField, CurrencyField, RatingField, SearchField, ColorField, and vee-validate wrappers.
+
+### Patch Changes
+
+- [#12](https://github.com/softistx/nxgt-material-vue/pull/12) [`349678d`](https://github.com/softistx/nxgt-material-vue/commit/349678dd607cc8953c6ece69c444555f7e98b2bf) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Require kebab-case on new nxgt files and make the code-reviewer run tsc/tests, not only reciting AGENTS.md.
+
+- [#2](https://github.com/softistx/nxgt-material-vue/pull/2) [`1c547fb`](https://github.com/softistx/nxgt-material-vue/commit/1c547fbd3412adc565480e5f4fcd3684784ca010) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Vue-patched agent docs, Claude skills, and shadcn-vue MCP config.
+
+- [#51](https://github.com/softistx/nxgt-material-vue/pull/51) [`2dce802`](https://github.com/softistx/nxgt-material-vue/commit/2dce802534c953ca4476586ccbf747bc8a43e271) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Keep DateField and DateRangeField pickers at 280px with 2rem day cells so the popover no longer stretches with the input.
+
+- [#52](https://github.com/softistx/nxgt-material-vue/pull/52) [`817f0a7`](https://github.com/softistx/nxgt-material-vue/commit/817f0a7ee2fbbd03612254913c2b7809106fd7d5) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Give charts a real CSS height (numeric px) and load vue-sonner styles on the Toaster.
+
+- [#8](https://github.com/softistx/nxgt-material-vue/pull/8) [`cf2f154`](https://github.com/softistx/nxgt-material-vue/commit/cf2f154216d939aaf635f99b840da9ce743fe7a4) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add Claude project agents (roadmap, docs, review, catalog porter, SSR audit) and ROADMAP.md.
+
+- [#53](https://github.com/softistx/nxgt-material-vue/pull/53) [`2b52939`](https://github.com/softistx/nxgt-material-vue/commit/2b52939c40835b1ebda30280b330f193719d5afc) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Align CodeBlock lines to the top-left, render barcodes on canvas, match Switch to nxgt-material, and group Storybook stories by role.
+
+- [#47](https://github.com/softistx/nxgt-material-vue/pull/47) [`f6842a1`](https://github.com/softistx/nxgt-material-vue/commit/f6842a1963543e6da7d3c9b3bdfec64bc1881d74) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Rebuild Autocomplete (inline chips + typeahead) and DateRangeField (single trigger + range calendar). Stretch ActionCard content so the indicator sits at the end.
+
+- [#16](https://github.com/softistx/nxgt-material-vue/pull/16) [`78bc6e7`](https://github.com/softistx/nxgt-material-vue/commit/78bc6e7904b05b0cae155d4b818ab06810b18f07) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Forward InputGroupField error and disabled onto the control so the invalid ring and addon opacity apply.
+
+- [#56](https://github.com/softistx/nxgt-material-vue/pull/56) [`5f8db40`](https://github.com/softistx/nxgt-material-vue/commit/5f8db40fd924173e694a03283b5c97d6ca697e86) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Point the package style export at dist/material-vue.css, the file Vite actually emits.
+
+- [#6](https://github.com/softistx/nxgt-material-vue/pull/6) [`53ec953`](https://github.com/softistx/nxgt-material-vue/commit/53ec953c8beb795bd5e0ab098c337b35282276a7) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Pin CI Biome to 2.5.5 and format vite.config.ts so biome ci passes.
+
+- [#11](https://github.com/softistx/nxgt-material-vue/pull/11) [`3074832`](https://github.com/softistx/nxgt-material-vue/commit/3074832e34cc6e79f0f48f76d2c4613331e2b3d2) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Update ROADMAP after chrome, fields batch 1, and the remaining button family.
+
+- [#54](https://github.com/softistx/nxgt-material-vue/pull/54) [`1a145ec`](https://github.com/softistx/nxgt-material-vue/commit/1a145ec8a758c19a676af3ea99a2f597ba02b8f7) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Add fill-available size utilities and stretch the split-button chevron to the control height.
+
+- [#49](https://github.com/softistx/nxgt-material-vue/pull/49) [`b51ab16`](https://github.com/softistx/nxgt-material-vue/commit/b51ab162bd2aff05cca0894d06c4b0c7ca59f3bf) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Switch Storybook Vue docgen from deprecated vue-docgen-api to vue-component-meta so the preview builds.
+
+- [#50](https://github.com/softistx/nxgt-material-vue/pull/50) [`1266198`](https://github.com/softistx/nxgt-material-vue/commit/1266198b4e0a006da85ad5944b30ecef555c473d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Move Vue SFC type aliases and re-exports into .ts modules so Storybook docgen can parse every component.
+
+- [#55](https://github.com/softistx/nxgt-material-vue/pull/55) [`ad0f6ba`](https://github.com/softistx/nxgt-material-vue/commit/ad0f6bafdeceef9fda202fe7367ff8d59eb9d997) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Ship code-moonlight.css next to the published stylesheet so Nuxt can resolve the relative import.