@nxgt/material 3.13.0 → 3.14.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @nxgt/material
 
+## 3.14.0
+
+### Minor Changes
+
+- [#1539](https://github.com/softistx/nxgt-material/pull/1539) [`e16466f`](https://github.com/softistx/nxgt-material/commit/e16466f294073c83b299ef55047c08d1bf63d6c7) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Close four gaps of the list filter's URL codec, all additive (defaults unchanged):
+  
+  - `@nxgt/material/components` re-exports `defineFilterModel`, `parseFilterQuery`, `serializeFilterQuery` and the types `FilterModel`, `FilterQuery`, `FilterCondition`, `FilterLockedCondition`, `FilterCodecOptions`, so a loader needs no direct `@nxgt/material-core` dependency.
+  - `serializeFilterQuery` takes `encoding: 'standard'` and `withoutFilters` / `tableFilters` the same option (`TableFilterOptions`): a plain `URLSearchParams` whose `toString()` encodes `:` and `,` (`%3A`, `%2C`). The default stays `'readable'`.
+  - `parseFilterQuery` takes `keepKnownValues: true`: a list condition (`in`, a repeated param) with an unknown value keeps its known values instead of being dropped whole.
+  - `createSorting` takes `direction`, a mapper for `toOrder`'s direction (`(d) => d.toUpperCase() as 'ASC' | 'DESC'` for a GraphQL enum); `SortingOptions` and `TableSorting` gain a `Direction` type parameter.
+
+### Patch Changes
+
+- Updated dependencies [[`e16466f`](https://github.com/softistx/nxgt-material/commit/e16466f294073c83b299ef55047c08d1bf63d6c7)]:
+  - @nxgt/material-core@0.31.0
+
+## 3.13.1
+
+### Patch Changes
+
+- [#1534](https://github.com/softistx/nxgt-material/pull/1534) [`3375ebb`](https://github.com/softistx/nxgt-material/commit/3375ebbd0b4b2d2d32ddd5379be326b8ca136d0b) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Fix the app header page title missing its `title` when a web font widens it after mount (it is re-measured when fonts finish loading), and read a `flag` filter alias at `0` (`?archived=0`) as off instead of an active condition; `f=archived:is:0` still filters on "No". Behaviour change: a link `?archived=0` used to filter on "No" and now shows every row; rewrite it as `f=archived:is:0` (the serializer already writes that form).
+- Updated dependencies [[`3375ebb`](https://github.com/softistx/nxgt-material/commit/3375ebbd0b4b2d2d32ddd5379be326b8ca136d0b)]:
+  - @nxgt/material-core@0.30.1
+
 ## 3.13.0
 
 ### Minor Changes

package/README.md

@@ -627,7 +627,7 @@ Not components: what the stylesheet gives any element.
 | Preview | Component | What it does | @nxgt/material-vue |
 | --- | --- | --- | --- |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-datatable.webp" width="120" alt="DataTable"> | [`DataTable`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#datatable), `DataTableColumnHeader`, `DataTablePagination`, `DataTableServerFooter`, `DataTableViewOptions` | TanStack Table v9 with sorting, filtering, selection, expandable rows, pagination or load-more, column visibility, skeleton rows while loading and your own empty state — or one server page at a time, with controlled sorting and selection, cursor Previous / Next links and row links. On a phone it keeps its header row and scrolls sideways in a keyboard-reachable region; the page does not. Or cards and tiles instead of the table (`layout`, `renderCard`, `renderTile`), and `layout={{ phone: 'tiles', wide: 'table' }}` for tiles on a phone ([cards and tiles guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/cards-and-tiles.md)). Long lists render only the rows in view (`virtual`). | `DataTable`, `DataTableColumnHeader`, `DataTablePagination`, `DataTableServerFooter`, `DataTableViewOptions` |
-| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-servertable.webp" width="120" alt="ServerTable"> | [`ServerTable`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#servertable), `createSorting`, `tableFilters`, `paramsFromQuery`, `serverPagination`… | A server-mode `DataTable` driven by the URL's search params, for any router: the Filter in its top band with the page's title and actions, the sort, forward cursor paging, a selection reset on a new query, the empty page with the filters as removable chips, a page past the last (rows deleted) that says so and links back to the first, an error state with Retry for a failed fetch (`error`, `onRetry`), and one count announced. | `ServerTable`, `createSorting`, `tableFilters`, `serverPagination` |
+| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-servertable.webp" width="120" alt="ServerTable"> | [`ServerTable`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#servertable), `createSorting`, `tableFilters`, `defineFilterModel`, `parseFilterQuery`, `serializeFilterQuery`, `paramsFromQuery`, `serverPagination`… | A server-mode `DataTable` driven by the URL's search params, for any router: the Filter in its top band with the page's title and actions, the sort, forward cursor paging, a selection reset on a new query, the empty page with the filters as removable chips, a page past the last (rows deleted) that says so and links back to the first, an error state with Retry for a failed fetch (`error`, `onRetry`), and one count announced. | `ServerTable`, `createSorting`, `tableFilters`, `serverPagination` |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-listempty.webp" width="120" alt="ListEmpty"> | [`ListEmpty`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#listempty) | A list's empty page: nothing yet, or nothing matches with what narrows it and a way out (a button or a link); its title is an `h2` (`headingLevel`). | `ListEmpty` |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-datagrid.webp" width="120" alt="DataGrid"> | [`DataGrid`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#datagrid) | An editable grid over `DataTable`'s columns: spreadsheet keys, a selected range, editors for text, numbers (with codes such as "abs"), options, dates and checkboxes, or your own; paste from Excel or Sheets, a fill handle that continues series, resizable, hideable and reorderable columns, undo, totals, and saving per cell, per row or in a batch with versions and conflicts ([guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/data-grid.md)). Long grids render only what is in view; on a phone it is a list of rows that open a panel. | — (later) |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-daygroupedlist.webp" width="120" alt="DayGroupedList"> | [`DayGroupedList`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#daygroupedlist), `groupByDay` | A list split by day — Today, Yesterday, This week, Earlier — under headings that stick while their items scroll. | — (later) |