@underverse-ui/underverse 1.0.107 → 1.0.110

package/dist/index.d.cts

@@ -1584,10 +1584,30 @@ interface ComboboxProps {
     groupBy?: (option: ComboboxOption) => string;
     renderOption?: (option: ComboboxOption, isSelected: boolean) => React$1.ReactNode;
     renderValue?: (option: ComboboxOption) => React$1.ReactNode;
+    /** Selected option fallback for manual/server search when options does not contain the current value. */
+    selectedOption?: ComboboxOption;
     error?: string;
     helperText?: string;
-    /** Enable OverlayScrollbars on dropdown options list. Default: false */
+    /** Enable OverlayScrollbars on dropdown options list. Default: true when not virtualized */
     useOverlayScrollbar?: boolean;
+    /** Virtualize large flat option lists. Grouped lists fall back to normal rendering. Default: false */
+    virtualized?: boolean;
+    /** Estimated option row height used by virtualized rendering. Default: 44 */
+    estimatedItemHeight?: number;
+    /** Number of extra rows rendered above and below the visible range. Default: 8 */
+    overscan?: number;
+    /** Use "manual" to let callers provide server-filtered options via onSearchChange. Default: "auto" */
+    searchMode?: "auto" | "manual";
+    /** Called whenever the search query changes. Required for manual/server search. */
+    onSearchChange?: (query: string) => void;
+    /** Debounce delay for onSearchChange. Default: 0 */
+    searchDebounceMs?: number;
+    /** Minimum query length before showing options in manual/search-prompt mode. Default: 0 */
+    minSearchLength?: number;
+    /** Limit the number of rendered options before the user types a query. */
+    maxInitialOptions?: number;
+    /** Show a prompt instead of options while the query is shorter than minSearchLength. Default: false */
+    showSearchPromptWhenEmptyQuery?: boolean;
 }
 declare const Combobox: React$1.FC<ComboboxProps>;
 
@@ -1629,11 +1649,31 @@ interface MultiComboboxProps {
     groupBy?: (option: MultiComboboxOption) => string;
     renderOption?: (option: MultiComboboxOption, isSelected: boolean) => React$1.ReactNode;
     renderTag?: (option: MultiComboboxOption, onRemove: () => void) => React$1.ReactNode;
+    /** Selected option fallbacks for manual/server search when options does not contain current values. */
+    selectedOptions?: MultiComboboxOption[];
     error?: string;
     helperText?: string;
     maxTagsVisible?: number;
-    /** Enable OverlayScrollbars on dropdown options list. Default: false */
+    /** Enable OverlayScrollbars on dropdown options list. Default: true when not virtualized */
     useOverlayScrollbar?: boolean;
+    /** Virtualize large flat option lists. Grouped lists fall back to normal rendering. Default: false */
+    virtualized?: boolean;
+    /** Estimated option row height used by virtualized rendering. Default: 44 */
+    estimatedItemHeight?: number;
+    /** Number of extra rows rendered above and below the visible range. Default: 8 */
+    overscan?: number;
+    /** Use "manual" to let callers provide server-filtered options via onSearchChange. Default: "auto" */
+    searchMode?: "auto" | "manual";
+    /** Called whenever the search query changes. Required for manual/server search. */
+    onSearchChange?: (query: string) => void;
+    /** Debounce delay for onSearchChange. Default: 0 */
+    searchDebounceMs?: number;
+    /** Minimum query length before showing options in manual/search-prompt mode. Default: 0 */
+    minSearchLength?: number;
+    /** Limit the number of rendered options before the user types a query. */
+    maxInitialOptions?: number;
+    /** Show a prompt instead of options while the query is shorter than minSearchLength. Default: false */
+    showSearchPromptWhenEmptyQuery?: boolean;
 }
 declare const MultiCombobox: React$1.FC<MultiComboboxProps>;
 

package/dist/index.d.ts

@@ -1584,10 +1584,30 @@ interface ComboboxProps {
     groupBy?: (option: ComboboxOption) => string;
     renderOption?: (option: ComboboxOption, isSelected: boolean) => React$1.ReactNode;
     renderValue?: (option: ComboboxOption) => React$1.ReactNode;
+    /** Selected option fallback for manual/server search when options does not contain the current value. */
+    selectedOption?: ComboboxOption;
     error?: string;
     helperText?: string;
-    /** Enable OverlayScrollbars on dropdown options list. Default: false */
+    /** Enable OverlayScrollbars on dropdown options list. Default: true when not virtualized */
     useOverlayScrollbar?: boolean;
+    /** Virtualize large flat option lists. Grouped lists fall back to normal rendering. Default: false */
+    virtualized?: boolean;
+    /** Estimated option row height used by virtualized rendering. Default: 44 */
+    estimatedItemHeight?: number;
+    /** Number of extra rows rendered above and below the visible range. Default: 8 */
+    overscan?: number;
+    /** Use "manual" to let callers provide server-filtered options via onSearchChange. Default: "auto" */
+    searchMode?: "auto" | "manual";
+    /** Called whenever the search query changes. Required for manual/server search. */
+    onSearchChange?: (query: string) => void;
+    /** Debounce delay for onSearchChange. Default: 0 */
+    searchDebounceMs?: number;
+    /** Minimum query length before showing options in manual/search-prompt mode. Default: 0 */
+    minSearchLength?: number;
+    /** Limit the number of rendered options before the user types a query. */
+    maxInitialOptions?: number;
+    /** Show a prompt instead of options while the query is shorter than minSearchLength. Default: false */
+    showSearchPromptWhenEmptyQuery?: boolean;
 }
 declare const Combobox: React$1.FC<ComboboxProps>;
 
@@ -1629,11 +1649,31 @@ interface MultiComboboxProps {
     groupBy?: (option: MultiComboboxOption) => string;
     renderOption?: (option: MultiComboboxOption, isSelected: boolean) => React$1.ReactNode;
     renderTag?: (option: MultiComboboxOption, onRemove: () => void) => React$1.ReactNode;
+    /** Selected option fallbacks for manual/server search when options does not contain current values. */
+    selectedOptions?: MultiComboboxOption[];
     error?: string;
     helperText?: string;
     maxTagsVisible?: number;
-    /** Enable OverlayScrollbars on dropdown options list. Default: false */
+    /** Enable OverlayScrollbars on dropdown options list. Default: true when not virtualized */
     useOverlayScrollbar?: boolean;
+    /** Virtualize large flat option lists. Grouped lists fall back to normal rendering. Default: false */
+    virtualized?: boolean;
+    /** Estimated option row height used by virtualized rendering. Default: 44 */
+    estimatedItemHeight?: number;
+    /** Number of extra rows rendered above and below the visible range. Default: 8 */
+    overscan?: number;
+    /** Use "manual" to let callers provide server-filtered options via onSearchChange. Default: "auto" */
+    searchMode?: "auto" | "manual";
+    /** Called whenever the search query changes. Required for manual/server search. */
+    onSearchChange?: (query: string) => void;
+    /** Debounce delay for onSearchChange. Default: 0 */
+    searchDebounceMs?: number;
+    /** Minimum query length before showing options in manual/search-prompt mode. Default: 0 */
+    minSearchLength?: number;
+    /** Limit the number of rendered options before the user types a query. */
+    maxInitialOptions?: number;
+    /** Show a prompt instead of options while the query is shorter than minSearchLength. Default: false */
+    showSearchPromptWhenEmptyQuery?: boolean;
 }
 declare const MultiCombobox: React$1.FC<MultiComboboxProps>;