@nxgt/material 3.72.0 → 3.73.0

package/docs/components/form-fields.md

@@ -375,6 +375,15 @@ up / down buttons, `min` and `max` rows (Remove is disabled at `min`, Add is
 announcements. Without a form library, `ChoiceListField` takes `value` and
 `onChange`.
 
+**Focus.** `ChoiceListFormField` gives React Hook Form's `field.ref` a handle
+that focuses the first refused row's text input: the row of the first
+`choices.<i>.text` error (a resolver's), or the first blank row when the
+built-in blank rule refused the list. An error on the list itself (too few
+rows, no row marked) focuses its first control. So `shouldFocusError`,
+`setFocus('choices')` and `setError('choices', …, { shouldFocus: true })` land
+on the refused row when there is an error, and on the first control otherwise;
+the form needs no `[aria-invalid="true"]` lookup.
+
 | Prop | Type | Default | What it does |
 | --- | --- | --- | --- |
 | `control`, `name` | `Control<T>`, `Path<T>` | — | the form and its array (`ChoiceListFormField`) |

package/docs/components/primitives.md

@@ -163,7 +163,8 @@ import {
 Parts: `Card`, `CardHeader`, `CardTitle`, `CardDescription`, `CardAction`,
 `CardContent`, `CardFooter` — each a styled `<div>` taking its element's props,
 except `CardTitle`, a heading: an `h3` by default, another level or a `div`
-with `as` (`<CardTitle as="h2">`), so `getByRole('heading', { name })` finds it.
+with `as` (`<CardTitle as="h2">`), so `getByRole('heading', { name })` finds it. The title takes its text size's
+line height; pass a `leading-*` class to override.
 `CardAction` sits top-right of the header.
 
 **Storybook:** `Primitives/Card` · **Vue:** `Card` (same parts)

package/docs/components/selection-and-choice.md

@@ -436,8 +436,10 @@ disabled with the field; Backspace in the empty input removes the last one.
 Enter in a form: it acts on the list and does not submit the form while it has
 something to do (WAI-ARIA combobox practice). It picks the highlighted option;
 with `freeSolo` and no option highlighted it adds the typed text; with the list
-open it is only default-prevented. On a closed list with nothing typed it
-submits, as a plain input does.
+open it is only default-prevented. In `mode="multiple"` (a tags box, `freeSolo`
+or not) Enter never submits the form, closed list and empty input included, so
+the Enter after a pick does not save the form. In `single` mode, on a closed
+list with nothing typed it submits, as a plain input does.
 
 An avatar in the rows and the chips:
 `getOptionLeading={(person) => <Avatar src={person.photo} alt="" />}`; see

package/docs/troubleshooting.md

@@ -313,6 +313,7 @@ words in your error.
 - [A click on the next field right after an `Autocomplete` pick is lost](#a-click-on-the-next-field-right-after-an-autocomplete-pick-is-lost)
 - [An older search's results replace the newer ones in an `Autocomplete`](#an-older-searchs-results-replace-the-newer-ones-in-an-autocomplete)
 - [An `Autocomplete` option does nothing on click or Enter](#an-autocomplete-option-does-nothing-on-click-or-enter)
+- [Enter in a multiple `Autocomplete` no longer submits the form](#enter-in-a-multiple-autocomplete-no-longer-submits-the-form)
 - ["The search failed. Try again." no longer shows in an `Autocomplete`](#the-search-failed-try-again-no-longer-shows-in-an-autocomplete)
 - [A test no longer finds `aria-invalid` on an `OtpField` slot](#a-test-no-longer-finds-aria-invalid-on-an-otpfield-slot)
 - [A test no longer finds `aria-invalid` on a `CodeEditor`](#a-test-no-longer-finds-aria-invalid-on-a-codeeditor)
@@ -4880,6 +4881,19 @@ on a desktop and on a phone alike: closing the picker with OK hands focus back
 to the trigger, and the next Tab or click elsewhere touches it. See the next
 entry.
 
+### A failed submit focuses a `ChoiceListFormField` but not the refused row
+
+**When:** a form with a `ChoiceListFormField` fails validation (a row's text
+is blank, `choices.2.text` in a resolver) and `document.activeElement` is the
+list's first control, or nothing, instead of the refused row. In versions
+before this fix.
+**Why:** the field gave React Hook Form a handle that focused the first
+control of the list, whichever row was refused.
+**Fix:** upgrade to the release that lists this fix in its changelog:
+`shouldFocusError` and `setFocus(name)` focus the first refused row's text
+input. Remove a workaround that queries `[aria-invalid="true"]` after submit.
+For the other fields, see the next entry.
+
 ### `setError(…, { shouldFocus: true })` or a failed submit does not focus the field
 
 **When:** a form wired with `*FormField`s: `handleSubmit` fails validation, or
@@ -5712,6 +5726,27 @@ may be chosen:
 />
 ```
 
+### Enter in a multiple `Autocomplete` no longer submits the form
+
+**When:** after upgrading, Enter in an `Autocomplete` (or `AutocompleteFormField`,
+a tags field) with `mode="multiple"` no longer submits the surrounding form
+when the list is closed and the input is empty.
+**Why:** the field is a tags box: the Enter that follows a pick used to save the
+whole form by surprise (#2199). Enter in `mode="multiple"` now only picks or
+adds. `single` mode is unchanged.
+**Fix:** submit with the form's button, or with a key handler of your own on the
+form if a keyboard shortcut is wanted (Ctrl/Cmd + Enter); drop any
+`onKeyDown` that prevented Enter on the combobox.
+
+```tsx
+<form
+	onSubmit={save}
+	onKeyDown={(e) => {
+		if (e.key === 'Enter' && (e.ctrlKey || e.metaKey)) e.currentTarget.requestSubmit();
+	}}
+>
+```
+
 ### "The search failed. Try again." no longer shows in an `Autocomplete`
 
 **When:** after upgrading, an `Autocomplete` whose `onSearch` rejects shows

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nxgt/material",
-	"version": "3.72.0",
+	"version": "3.73.0",
 	"license": "MIT",
 	"bugs": {
 		"email": "stevegires@gmail.com"
@@ -372,7 +372,7 @@
 		"docs:previews": "rm -rf node_modules/.cache/nxgt-preview-free/missing && NXGT_PREVIEW_FREE=1 vitest run --project previews && bun .storybook/preview-free-report.ts"
 	},
 	"dependencies": {
-		"@nxgt/material-core": "^0.47.0",
+		"@nxgt/material-core": "^0.47.1",
 		"@base-ui/react": "^1.6.0",
 		"@dnd-kit/core": "^6.3.1",
 		"@dnd-kit/sortable": "^10.0.0",