@underverse-ui/underverse 1.0.113 → 1.0.116

package/dist/index.d.cts

@@ -1872,6 +1872,24 @@ interface CategoryTreeSelectBaseProps {
     useOverlayScrollbar?: boolean;
     /** When true, only leaf nodes can be selected; parent nodes only expand/collapse. */
     leafOnlySelect?: boolean;
+    /** Virtualize the dropdown tree by rendering only visible rows. Inline/view-only trees keep recursive rendering. */
+    virtualized?: boolean;
+    /** Estimated tree 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;
+    /** Limit the number of rendered rows before the user types a query. */
+    maxInitialOptions?: number;
+    /** Use `"manual"` to let callers provide server-filtered categories via `onSearchChange`. Default: `"auto"`. */
+    searchMode?: "auto" | "manual";
+    /** Called whenever the search query changes. Useful 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;
+    /** Show a prompt instead of options while the query is shorter than `minSearchLength`. Default: `false`. */
+    showSearchPromptWhenEmptyQuery?: boolean;
 }
 /** Multi-select mode. This is the default when `singleSelect` is omitted. */
 interface CategoryTreeSelectMultiProps extends CategoryTreeSelectBaseProps {
@@ -2547,12 +2565,18 @@ interface DataTableProps<T> {
     overflowHidden?: boolean;
     /** Enable OverlayScrollbars on table viewport. Default: false */
     useOverlayScrollbar?: boolean;
+    /** Virtualize body rows for large page sizes. Default: false */
+    virtualizedRows?: boolean;
+    /** Estimated row height used by virtualized rendering. Defaults to the active density row height. */
+    estimatedRowHeight?: number;
+    /** Number of extra rows rendered above and below the visible range. Default: 8 */
+    overscan?: number;
     /** Double-click leaf headers to auto-fit column width based on visible content. Default: true */
     enableHeaderAutoFit?: boolean;
     labels?: DataTableLabels;
 }
 
-declare function DataTable<T extends Record<string, any>>({ columns, data, rowKey, loading, total, page, pageSize, pageSizeOptions, onQueryChange, caption, toolbar, size, enableColumnVisibilityToggle, enableDensityToggle, enableHeaderAlignToggle, striped, columnDividers, className, storageKey, stickyHeader, maxHeight, horizontalMode, overflowHidden, useOverlayScrollbar, enableHeaderAutoFit, labels, }: DataTableProps<T>): react_jsx_runtime.JSX.Element;
+declare function DataTable<T extends Record<string, any>>({ columns, data, rowKey, loading, total, page, pageSize, pageSizeOptions, onQueryChange, caption, toolbar, size, enableColumnVisibilityToggle, enableDensityToggle, enableHeaderAlignToggle, striped, columnDividers, className, storageKey, stickyHeader, maxHeight, horizontalMode, overflowHidden, useOverlayScrollbar, virtualizedRows, estimatedRowHeight, overscan, enableHeaderAutoFit, labels, }: DataTableProps<T>): react_jsx_runtime.JSX.Element;
 
 /** Public props for the `Table` component. */
 interface TableProps extends React__default.HTMLAttributes<HTMLTableElement> {

package/dist/index.d.ts

@@ -1872,6 +1872,24 @@ interface CategoryTreeSelectBaseProps {
     useOverlayScrollbar?: boolean;
     /** When true, only leaf nodes can be selected; parent nodes only expand/collapse. */
     leafOnlySelect?: boolean;
+    /** Virtualize the dropdown tree by rendering only visible rows. Inline/view-only trees keep recursive rendering. */
+    virtualized?: boolean;
+    /** Estimated tree 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;
+    /** Limit the number of rendered rows before the user types a query. */
+    maxInitialOptions?: number;
+    /** Use `"manual"` to let callers provide server-filtered categories via `onSearchChange`. Default: `"auto"`. */
+    searchMode?: "auto" | "manual";
+    /** Called whenever the search query changes. Useful 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;
+    /** Show a prompt instead of options while the query is shorter than `minSearchLength`. Default: `false`. */
+    showSearchPromptWhenEmptyQuery?: boolean;
 }
 /** Multi-select mode. This is the default when `singleSelect` is omitted. */
 interface CategoryTreeSelectMultiProps extends CategoryTreeSelectBaseProps {
@@ -2547,12 +2565,18 @@ interface DataTableProps<T> {
     overflowHidden?: boolean;
     /** Enable OverlayScrollbars on table viewport. Default: false */
     useOverlayScrollbar?: boolean;
+    /** Virtualize body rows for large page sizes. Default: false */
+    virtualizedRows?: boolean;
+    /** Estimated row height used by virtualized rendering. Defaults to the active density row height. */
+    estimatedRowHeight?: number;
+    /** Number of extra rows rendered above and below the visible range. Default: 8 */
+    overscan?: number;
     /** Double-click leaf headers to auto-fit column width based on visible content. Default: true */
     enableHeaderAutoFit?: boolean;
     labels?: DataTableLabels;
 }
 
-declare function DataTable<T extends Record<string, any>>({ columns, data, rowKey, loading, total, page, pageSize, pageSizeOptions, onQueryChange, caption, toolbar, size, enableColumnVisibilityToggle, enableDensityToggle, enableHeaderAlignToggle, striped, columnDividers, className, storageKey, stickyHeader, maxHeight, horizontalMode, overflowHidden, useOverlayScrollbar, enableHeaderAutoFit, labels, }: DataTableProps<T>): react_jsx_runtime.JSX.Element;
+declare function DataTable<T extends Record<string, any>>({ columns, data, rowKey, loading, total, page, pageSize, pageSizeOptions, onQueryChange, caption, toolbar, size, enableColumnVisibilityToggle, enableDensityToggle, enableHeaderAlignToggle, striped, columnDividers, className, storageKey, stickyHeader, maxHeight, horizontalMode, overflowHidden, useOverlayScrollbar, virtualizedRows, estimatedRowHeight, overscan, enableHeaderAutoFit, labels, }: DataTableProps<T>): react_jsx_runtime.JSX.Element;
 
 /** Public props for the `Table` component. */
 interface TableProps extends React__default.HTMLAttributes<HTMLTableElement> {