twico-ui 1.40.0 → 1.41.0

package/dist/index.d.cts

@@ -1665,6 +1665,11 @@ interface ComboboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>
   value?: string | null;
   /** Uncontrolled initial value. */
   defaultValue?: string | null;
+  /** Seed the search *text* with this string each time the menu opens (caret placed at the end), without emitting it as
+   *  an `onInputChange`. It is matched against option labels/descriptions like any typed query — not the option
+   *  `value` — so to open a cell editor pre-filled on the current selection, pass its **label** (e.g. `"Japan"`),
+   *  not its value (`"jp"`). */
+  defaultQuery?: string;
   /** Called with the chosen option's value, or `null` when cleared via `clearable`. */
   onChange?: (value: string | null) => void;
   /** Show a clear (×) affix when a value is selected. */
@@ -1680,6 +1685,9 @@ interface ComboboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>
   minWidth?: number;
   /** Called with the raw query on every keystroke — drive a debounced remote fetch (with `loading` + `filter={false}`). */
   onInputChange?: (query: string) => void;
+  /** Called with `true` when the menu opens and `false` when it closes (including when `close()` silently resets the
+   *  typed query) — a host staging that query (e.g. a cell editor) can withdraw it on close. */
+  onOpenChange?: (open: boolean) => void;
   /** Client-side filtering: `false` shows options as-is (server-ranked); a function replaces the default label/description match. */
   filter?: boolean | ((option: ComboboxOption, query: string) => boolean);
   /** Show a loading row instead of the option list / empty state. @default false */

package/dist/index.d.ts

@@ -1665,6 +1665,11 @@ interface ComboboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>
   value?: string | null;
   /** Uncontrolled initial value. */
   defaultValue?: string | null;
+  /** Seed the search *text* with this string each time the menu opens (caret placed at the end), without emitting it as
+   *  an `onInputChange`. It is matched against option labels/descriptions like any typed query — not the option
+   *  `value` — so to open a cell editor pre-filled on the current selection, pass its **label** (e.g. `"Japan"`),
+   *  not its value (`"jp"`). */
+  defaultQuery?: string;
   /** Called with the chosen option's value, or `null` when cleared via `clearable`. */
   onChange?: (value: string | null) => void;
   /** Show a clear (×) affix when a value is selected. */
@@ -1680,6 +1685,9 @@ interface ComboboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>
   minWidth?: number;
   /** Called with the raw query on every keystroke — drive a debounced remote fetch (with `loading` + `filter={false}`). */
   onInputChange?: (query: string) => void;
+  /** Called with `true` when the menu opens and `false` when it closes (including when `close()` silently resets the
+   *  typed query) — a host staging that query (e.g. a cell editor) can withdraw it on close. */
+  onOpenChange?: (open: boolean) => void;
   /** Client-side filtering: `false` shows options as-is (server-ranked); a function replaces the default label/description match. */
   filter?: boolean | ((option: ComboboxOption, query: string) => boolean);
   /** Show a loading row instead of the option list / empty state. @default false */

package/dist/index.mjs

@@ -6328,6 +6328,7 @@ function Combobox({
   options,
   value,
   defaultValue = null,
+  defaultQuery,
   onChange,
   clearable = false,
   disabled = false,
@@ -6335,6 +6336,7 @@ function Combobox({
   portal = true,
   minWidth = 0,
   onInputChange,
+  onOpenChange,
   filter,
   loading = false,
   emptyText = "No results found",
@@ -6451,9 +6453,18 @@ function Combobox({
   React53__default.useEffect(() => {
     setActive(0);
   }, [query]);
+  const onOpenChangeRef = React53__default.useRef(onOpenChange);
+  onOpenChangeRef.current = onOpenChange;
+  const prevOpenRef = React53__default.useRef(open);
+  React53__default.useEffect(() => {
+    if (prevOpenRef.current !== open) {
+      prevOpenRef.current = open;
+      onOpenChangeRef.current?.(open);
+    }
+  }, [open]);
   React53__default.useEffect(() => {
     if (!open) return;
-    const idx = flat.findIndex((o) => o.value === current);
+    const idx = visible.findIndex((o) => o.value === current);
     setActive(idx >= 0 ? idx : 0);
   }, [open]);
   React53__default.useEffect(() => {
@@ -6480,8 +6491,13 @@ function Combobox({
   }, [active, open, virtualized, rows, listH]);
   function openMenu() {
     if (disabled) return;
-    setQuery("");
+    const seed = defaultQuery || "";
+    setQuery(seed);
     setOpen(true);
+    if (seed) requestAnimationFrame(() => {
+      const el = inputRef.current;
+      if (el) el.setSelectionRange(seed.length, seed.length);
+    });
   }
   function close() {
     setOpen(false);