twico-ui 1.40.0 → 1.41.1

package/llms.txt

@@ -650,6 +650,7 @@ Props:
 - `options` — `Array<string | ComboboxOption | ComboboxGroup>` · **required** — Defines the selectable items as plain strings, value/label/description objects, or grouped option collections.
 - `value` — `string | null` — Sets the selected option's value in controlled mode, pairing with onChange to keep the field in sync.
 - `defaultValue` — `string | null` · default `null` — Provides the initial selection for uncontrolled usage, defaulting to null so the field starts empty.
+- `defaultQuery` — `string` — Seeds the search text each time the menu opens (caret at the end) without emitting onInputChange; matched against option labels/descriptions, so a cell editor pre-fills with the option's label, not its value.
 - `onChange` — `(value: string | null) => void` — Fires with the newly selected value, or null when the selection is cleared, so you can update state.
 - `clearable` — `boolean` · default `false` — Adds a clear button when a value is selected, letting users reset the field back to an empty selection.
 - `disabled` — `boolean` · default `false` — Blocks typing and selection while dimming the field, indicating the control is currently unavailable.
@@ -657,6 +658,7 @@ Props:
 - `portal` — `boolean` · default `false` — Render the dropdown in a portal (position:fixed on document.body) so it is never clipped by a scrolling/overflow-hidden ancestor; auto-flips up near the viewport bottom.
 - `minWidth` — `number` · default `0` — Minimum popover width in px when portaled (useful when the control is narrow).
 - `onInputChange` — `(query: string) => void` — Called with the raw query on every keystroke — drive a debounced remote fetch (with `loading` + `filter={false}`).
+- `onOpenChange` — `(open: boolean) => void` — Fires with true when the menu opens and false when it closes (including the silent close() that resets the typed query), so a host staging that query can withdraw it.
 - `filter` — `boolean | ((option: ComboboxOption, query: string) => boolean)` — Client-side filtering: `false` shows options as-is (server-ranked); a function replaces the default label/description match.
 - `loading` — `boolean` · default `false` — Show a loading row instead of the option list / empty state.
 - `emptyText` — `string` · default `"No results found"` — Text shown when no options match.
@@ -1635,7 +1637,7 @@ Props:
 - `editMode` — `boolean` · default `false` — Makes all columns editable inline so users can change cell values directly; off by default.
 - `onRowUpdate` — `(updated,original,field)=>void` · default `-` — Fires when an inline cell edit is committed, receiving the updated row, the original row, and the edited field.
 - `onRowsChange` — `(rows)=>void` · default `-` — Fires with the full next array of rows after an edit, letting you persist the new dataset.
-- `onBatchUpdate` — `(rows,patch,keys)=>void` · default `-` — Fires when a batch edit is applied, receiving the affected rows, the patch object, and the selected keys.
+- `onBatchUpdate` — `(rows,patch,keys)=>void` · default `-` — Fires when a batch edit is applied: (changedRows, patch, selectedKeys). changedRows is authoritative (each row carries only the fields it may change); selectedKeys are the keys a keys×patch write can safely apply the whole patch to.
 - `showPageJumper` — `boolean` · default `true` — Shows a go-to-page input in the pagination footer for jumping directly to a page number; enabled by default.
 - `selectionMode` — `none|row|cell` · default `none` — Sets click-to-select granularity (none, row, or cell), controlling what gets highlighted on click, defaulting to none.
 - `onRowClick` — `(row,key)=>void` · default `-` — Fires with the clicked row and its key, useful for navigation or opening a detail view.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twico-ui",
-  "version": "1.40.0",
+  "version": "1.41.1",
   "description": "Twico UI — a free, modern, themeable React + Tailwind-friendly component library. 61 components with dark mode, motion, and accessibility built in.",
   "license": "MIT",
   "author": "Twico UI",