@nxgt/material 3.27.0 → 3.29.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @nxgt/material
 
+## 3.29.0
+
+### Minor Changes
+
+- [#1690](https://github.com/softistx/nxgt-material/pull/1690) [`29ea903`](https://github.com/softistx/nxgt-material/commit/29ea903724a10b5230a020305895f3e4dbc1ee12) Thanks [@SteveGT96](https://github.com/SteveGT96)! - The filter bar shows a refusal that `errors` (by field id) cannot reach ([#1688](https://github.com/softistx/nxgt-material/issues/1688)). `searchError` (on `Filter`, `FilterBar` and `ServerTable`'s `filter`) shows on the search box like a field's refusal, with an icon and "Invalid.", `aria-invalid` and `aria-describedby` on the input; `formError` shows one error `Alert` under the bar for a refusal that belongs to no field. Both are told once by the bar's one live region, the same refusal path as `errors`, and the page drops them when the search changes. `@nxgt/material-core/filter` adds `splitFilterErrors(refusal, model)`, which splits one flat refusal record into `{ errors, searchError, formError }` (the model's search param and the new `FILTER_FORM_ERROR_KEY`, `'$form'`). Nothing existing changes meaning.
+
+### Patch Changes
+
+- Updated dependencies [[`29ea903`](https://github.com/softistx/nxgt-material/commit/29ea903724a10b5230a020305895f3e4dbc1ee12)]:
+  - @nxgt/material-core@0.37.0
+
+## 3.28.0
+
+### Minor Changes
+
+- [#1588](https://github.com/softistx/nxgt-material/pull/1588) [`2c6e7d0`](https://github.com/softistx/nxgt-material/commit/2c6e7d07faec1ae2f77f22ffbdd3710d6676d632) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `FilterBar`, the filter bar bound to the URL, for a feed or a list that is no table ([#1559](https://github.com/softistx/nxgt-material/issues/1559)): `<FilterBar model params onParamsChange resultCount />` reads its query from the search params and writes it back (the `reset` params dropped, the page's other params kept, the `locked` conditions never written), with the search, the chips, "Clear all", the announced count and the phone sheet of `ServerTable`'s band, and a `widens` field as a toggle. It takes `codec` (`keepKnownValues`, `encoding`), `defaults`, and every prop of `Filter variant="bar"` (`searchApply`, `searchMinLength`...) except the query. `useFilterUrlQuery` is the binding as a hook; `ServerTable` now uses it, so the two share one URL path (no change in behaviour).
+
+- [#1607](https://github.com/softistx/nxgt-material/pull/1607) [`e405fbe`](https://github.com/softistx/nxgt-material/commit/e405fbefc20d972b1cacdc6910d6f8063474f2de) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A field's `default` is shown ([#1556](https://github.com/softistx/nxgt-material/issues/1556), [#1557](https://github.com/softistx/nxgt-material/issues/1557)): `Filter`, `FilterBar` and `ServerTable`'s `filter` take `defaults` (the values of the `default: 'page'` fields, the loader's own). A defaulted value is uncounted and has no ✕: a select or multi-select reads as a dashed hint chip, "Status: Active, Upcoming · Default", a button named "Status: Active, Upcoming, default value. Change" that opens the editor on the default; a quick pill reads it too; a switch or checkbox quick toggle is pressed and marked "Default", and pressing it writes an explicit "No" (`mine=0`); the facets panel and the phone sheet show the default values checked with "Default" beside the title (new `hint` prop on `FacetGroup`). The URL, `query`, the count, the announcement and "Clear all" are unchanged: choosing a value replaces the default, "Clear all" returns to it. Choosing or changing a value writes an explicit choice. New keys `material.filter.default.*` (en, fr). Core: `isQuickOn` and `quickToggleEvent` take `defaults`, new `defaultHints` and `fieldDefault`.
+
+- [#1573](https://github.com/softistx/nxgt-material/pull/1573) [`6d482ae`](https://github.com/softistx/nxgt-material/commit/6d482ae6aa1767e5c3df492858c19db243c93e6c) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A switch or checkbox filter field takes `off?: 'remove' | 'no'` ([#1558](https://github.com/softistx/nxgt-material/issues/1558)). `off: 'remove'` makes a narrowing switch such as "Only unassigned" mean nothing when off: its editor is one switch with no Yes/No, on is counted and has a chip, off writes nothing to the URL, and an old `f=x:is:0` link on it is silently dropped. `'no'` is the default and changes nothing; `widens: true` implies `'remove'`, and `widens` with `off: 'no'` throws in `defineFilterModel`. `booleanOff(field)` answers `'remove'` for it.
+
+- [#1616](https://github.com/softistx/nxgt-material/pull/1616) [`08b438f`](https://github.com/softistx/nxgt-material/commit/08b438f72d532f73368c7288022b28bdab8f2d7e) Thanks [@SteveGT96](https://github.com/SteveGT96)! - A scope field, a refused condition's error state and a list without a search box ([#1555](https://github.com/softistx/nxgt-material/issues/1555), [#1562](https://github.com/softistx/nxgt-material/issues/1562), [#1563](https://github.com/softistx/nxgt-material/issues/1563)). `scope: true` (with a `default` and a single-value type; excludes `widens`) marks a value the user changes but never clears, such as the period: a leading pill that always shows its value (in the bar, on a phone too, where a tap opens the sheet on its section; `ServerTable`'s band, and as the facets panel's and the phone sheet's first section), with no ✕, chip, "Add filter" entry or count; "Clear all" and `withoutFilters` keep it, and `isFiltered` ignores it. `Filter`, `FilterBar` and `ServerTable`'s `filter` take `errors` (a server's message per field id): every control (chip, pill, switch or checkbox toggle, default chip) reads "Invalid" in the error tone, described by the message, the editor and the facets section show it, and the live region tells it. `defineFilterModel({ search: false })` renders no search box in the bar, the facets panel or the sheet, sends `/` to the first quick filter, and leaves the search param to the page. New keys `material.filter.error.*` (en, fr).
+  
+  `addable: false` ([#1640](https://github.com/softistx/nxgt-material/issues/1640)) marks a field only a link sets: parsed, chipped with its ✕ and cleared by "Clear all" like any filter, but never in "Add filter", the quick filters, or the phone sheet and facets unless it has a value.
+  
+  Core: `isKeptField` (a widening or a scope field), `isScope`, `isAddable`, `isAddableField`, `isScopeField`, `fieldErrors`, `model.search.enabled`; `sheetTriggerCount` leaves a scope out, `quickFields` and `bandQuickFields` lead with it, `addMenuFields` never lists it.
+
+### Patch Changes
+
+- [#1586](https://github.com/softistx/nxgt-material/pull/1586) [`a69bbcd`](https://github.com/softistx/nxgt-material/commit/a69bbcdc3850c3ef022053c77eebe1e4fb3a4911) Thanks [@SteveGT96](https://github.com/SteveGT96)! - Docs: the server lists guide explains field defaults (`default`, `defaults`) resolved in the loader.
+- Updated dependencies [[`e405fbe`](https://github.com/softistx/nxgt-material/commit/e405fbefc20d972b1cacdc6910d6f8063474f2de), [`03dc4a9`](https://github.com/softistx/nxgt-material/commit/03dc4a91bb427616df727a2c63e33c5f0e1db5a2), [`6d482ae`](https://github.com/softistx/nxgt-material/commit/6d482ae6aa1767e5c3df492858c19db243c93e6c), [`08b438f`](https://github.com/softistx/nxgt-material/commit/08b438f72d532f73368c7288022b28bdab8f2d7e)]:
+  - @nxgt/material-core@0.36.0
+
 ## 3.27.0
 
 ### Minor Changes

package/README.md

@@ -633,7 +633,7 @@ Not components: what the stylesheet gives any element.
 | <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 (a title, or a scene, a line and an action), 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) |
-| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-filter.webp" width="120" alt="Filter"> | [`Filter`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#filter), `FilterProvider`, `FilterContent`, `FilterChips`, `FilterPresets`, `FilterSheetTrigger` · `FilterFormField` | Schema-driven filters with chips, presets, validation, and URL or storage persistence, and a query-driven `variant="bar"` / `"facets"` (quick filters, locked conditions, a phone sheet, a URL codec for a loader; `bandDensity="compact"` as on `ServerTable`); the filter bar's "Filters (N)" (`FilterSheetTrigger`) can be placed inside a `ServerTable` (its actions). | `Filter`, `FilterProvider`, `FilterContent`, `FilterChips`, `FilterPresets`, `FilterSheetTrigger`, `FilterFormField` |
+| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-filter.webp" width="120" alt="Filter"> | [`Filter`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#filter), `FilterProvider`, `FilterContent`, `FilterChips`, `FilterPresets`, `FilterSheetTrigger`, `FilterBar`, `useFilterUrlQuery` · `FilterFormField` | Schema-driven filters with chips, presets, validation, and URL or storage persistence, and a query-driven `variant="bar"` / `"facets"` (quick filters, locked conditions, a phone sheet, a URL codec for a loader; `bandDensity="compact"` as on `ServerTable`), and `FilterBar`, the same bar bound to the URL for a feed or list without a table (`useFilterUrlQuery` is its hook, also `ServerTable`'s), a field `default` shown as an uncounted hint chip (a button that opens the editor on the default), a pressed toggle or checked values with a "Default" word (`defaults` prop), a `scope` field as a leading pill kept by "Clear all", a server refusal shown on the chip (`errors`), on the search box (`searchError`) or as an Alert under the bar (`formError`) and a model with `search: false`; the filter bar's "Filters (N)" (`FilterSheetTrigger`) can be placed inside a `ServerTable` (its actions). | `Filter`, `FilterProvider`, `FilterContent`, `FilterChips`, `FilterPresets`, `FilterSheetTrigger`, `FilterFormField`; `FilterBar`, `useFilterUrlQuery`: — (later, #1569) |
 | — | [`FilterInline`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#filterinline-filterpopover-filterdialog-filtersheet-filterdrawer), `FilterPopover`, `FilterDialog`, `FilterSheet`, `FilterDrawer` | The filter panel shown inline, or in a popover, dialog, sheet or drawer. | `FilterInline`, `FilterPopover`, `FilterDialog`, `FilterSheet`, `FilterDrawer` |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-facetgroup.webp" width="120" alt="FacetGroup"> | [`FacetGroup`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#facetgroup) | A collapsible facet: a header button with the title, a count Badge of the active values, Clear and a chevron, over the values (typically a `CheckboxGroup` with counts). | `FacetGroup` |
 | <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-pagination.webp" width="120" alt="Pagination"> | [`Pagination`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#pagination), `PaginationContent`, `PaginationItem`, `PaginationFirst`, `PaginationLast`, `PaginationLink`, `PaginationBar`, `paginationItems`… | Pagination primitives, with first / last links. `PaginationBar` adds a sibling window with ellipses. | `Pagination` (parts), `PaginationFirst`, `PaginationLast`, `PaginationLink`, `PaginationBar`, `paginationItems` |

package/dist/{async-slice-gAbGnQT8.js → async-slice-DmhasXmq.js}

@@ -1,5 +1,5 @@
-import { i as e, r as t, t as n } from "./stored-language-ClkfkueV.js";
-import { r } from "./translator-C0uxN1Nh.js";
+import { i as e, r as t, t as n } from "./stored-language-DoWMr969.js";
+import { r } from "./translator-D88BbpXZ.js";
 import { t as i } from "./_baseIsEqual-C6ksIHya.js";
 import { useMemo as a } from "react";
 import { asyncThunkCreator as o, buildCreateSlice as s } from "@reduxjs/toolkit";

package/dist/{button-Cr9GIIj4.js → button-BjIg_Lz6.js}

@@ -2,7 +2,7 @@ import { t as e } from "./utils-BLfntITJ.js";
 import { n as t, t as n } from "./dist-DVRQkaTK.js";
 import { o as r, t as i } from "./tooltip-CkttDIab.js";
 import { t as a } from "./is-production-GLw59WU8.js";
-import { t as o } from "./spinner-CJtTRNAX.js";
+import { t as o } from "./spinner-1Ia6Akhy.js";
 import { a as s, i as c, r as l, t as u } from "./button-tones-BwuVvAmd.js";
 import { t as d } from "./button-group-context-CaP0X5p_.js";
 import { t as f } from "./has-text-content-Ds2dkHX_.js";

package/dist/charts.js

@@ -1,12 +1,12 @@
 import { t as e } from "./ui.utils-CAnKTCw5.js";
 import { t } from "./utils-BLfntITJ.js";
-import { t as n } from "./use-material-translation-B4Frk3vC.js";
-import { t as r } from "./button-Cr9GIIj4.js";
+import { t as n } from "./use-material-translation-Cqcwkuur.js";
+import { t as r } from "./button-BjIg_Lz6.js";
 import { t as i } from "./use-ssr-media-query-C6M5m8sf.js";
 import { i as a, n as o, r as s, t as c } from "./util-4heV2LPI.js";
 import { t as l } from "./useIsomorphicLayoutEffect-DfgAhWcH.js";
 import { t as u } from "./warn-once-C_e47JM8.js";
-import { t as d } from "./chip-s11lOfxB.js";
+import { t as d } from "./chip-DIBIDUZH.js";
 import { c as f, d as p, f as m, i as h, o as g, p as _, s as v, t as y } from "./line-path-C5pZGC49.js";
 import { t as b } from "./live-status-BGPaN8r8.js";
 import { t as x } from "./linear-G97mfnKF.js";

package/dist/{chip-s11lOfxB.js → chip-DIBIDUZH.js}

@@ -1,6 +1,6 @@
 import { t as e } from "./utils-BLfntITJ.js";
 import { t } from "./tooltip-CkttDIab.js";
-import { t as n } from "./use-material-translation-B4Frk3vC.js";
+import { t as n } from "./use-material-translation-Cqcwkuur.js";
 import { a as r } from "./button-tones-BwuVvAmd.js";
 import { t as i } from "./react-node-text-Crkpfpco.js";
 import { Check as a, X as o } from "lucide-react";

package/dist/{code-editor-DGIjL8Hr.js → code-editor-2EU-q9FV.js}

@@ -1,12 +1,12 @@
 import { r as e } from "./rolldown-runtime-BFFgcFxR.js";
 import { t } from "./utils-BLfntITJ.js";
 import { a as n } from "./dist-lmHmz_bu.js";
-import { c as r, d as i, f as a, n as o, t as s } from "./dropdown-menu-B71aggp0.js";
+import { c as r, d as i, f as a, n as o, t as s } from "./dropdown-menu-ppMPD12c.js";
 import { a as c, i as l, n as u } from "./field-blur-context-Cft9s7Hg.js";
-import { a as d, d as f, r as p, t as m, u as h } from "./toolbar-items-DlioFgpM.js";
+import { a as d, d as f, r as p, t as m, u as h } from "./toolbar-items-C1GdN9P9.js";
 import { t as g } from "./is-production-GLw59WU8.js";
-import { t as _ } from "./use-material-translation-B4Frk3vC.js";
-import { i as v, n as y, o as b, t as x } from "./code-language-items-DCOQnaCo.js";
+import { t as _ } from "./use-material-translation-Cqcwkuur.js";
+import { i as v, n as y, o as b, t as x } from "./code-language-items-C_UeMQMm.js";
 import { t as S } from "./useIsomorphicLayoutEffect-DfgAhWcH.js";
 import { n as C, t as w } from "./escape-owner-C4W_sOAU.js";
 import { t as T } from "./skeleton-DSdtr2qc.js";

package/dist/code-editor.js

@@ -1,14 +1,14 @@
 import { t as e } from "./utils-BLfntITJ.js";
 import { a as t } from "./dist-lmHmz_bu.js";
-import { d as n, r, t as i, u as a } from "./toolbar-items-DlioFgpM.js";
-import { t as o } from "./use-material-translation-B4Frk3vC.js";
-import { i as s, n as c, o as l } from "./code-language-items-DCOQnaCo.js";
+import { d as n, r, t as i, u as a } from "./toolbar-items-C1GdN9P9.js";
+import { t as o } from "./use-material-translation-Cqcwkuur.js";
+import { i as s, n as c, o as l } from "./code-language-items-C_UeMQMm.js";
 import { r as u, t as d } from "./field-blur-CJHzVSh9.js";
 import { t as f } from "./skeleton-DSdtr2qc.js";
 import { t as p } from "./live-status-BGPaN8r8.js";
 import { t as m } from "./use-mobile-BDro060N.js";
 import { t as h } from "./react-node-text-Crkpfpco.js";
-import { a as g, c as _, d as v, f as y, i as b, l as x, m as S, o as C, p as w, r as T, s as E, t as D, u as O } from "./code-editor-DGIjL8Hr.js";
+import { a as g, c as _, d as v, f as y, i as b, l as x, m as S, o as C, p as w, r as T, s as E, t as D, u as O } from "./code-editor-2EU-q9FV.js";
 import { ChevronDown as k, ChevronUp as A, Columns2 as j } from "lucide-react";
 import { useEffect as M, useRef as N, useState as P } from "react";
 import { Fragment as F, jsx as I, jsxs as L } from "react/jsx-runtime";

package/dist/{code-language-items-DCOQnaCo.js → code-language-items-C_UeMQMm.js}

@@ -1,5 +1,5 @@
-import { d as e, f as t } from "./dropdown-menu-B71aggp0.js";
-import { t as n } from "./use-material-translation-B4Frk3vC.js";
+import { d as e, f as t } from "./dropdown-menu-ppMPD12c.js";
+import { t as n } from "./use-material-translation-Cqcwkuur.js";
 import { t as r } from "./live-status-BGPaN8r8.js";
 import { useEffect as i, useRef as a, useState as o } from "react";
 import { jsx as s } from "react/jsx-runtime";

package/dist/components/ui/display/chip/chip-parts.css

@@ -82,6 +82,25 @@
 		background: color-mix(in oklab, var(--foreground) 4%, transparent);
 	}
 
+	/* A dashed chip in the error tone (a refused filter): the line and the
+	 * text take the tone, dashed or selected, hover and focus included. */
+	.nxgt-chip[data-dashed][data-tone="error"] {
+		--chip-tone: var(--error-text);
+		border-color: color-mix(in oklab, var(--error-text) 60%, var(--background));
+		color: var(--error-text);
+	}
+	.nxgt-chip[data-dashed][data-tone="error"]:not([data-selected]):is(
+		:hover,
+		:focus-visible
+	) {
+		color: var(--error-text);
+		border-color: var(--error-text);
+		background: color-mix(in oklab, var(--error-text) 6%, transparent);
+	}
+	.nxgt-chip[data-dashed][data-tone="error"][data-selected] {
+		background: color-mix(in oklab, var(--error-text) 8%, var(--background));
+	}
+
 	.nxgt-chip[data-tone="neutral"] {
 		--chip-tone: var(--muted-foreground);
 	}