@enonic/ui 1.5.0 → 1.7.0

package/dist/types/components/tree-list/tree-list.d.ts

@@ -6,7 +6,6 @@ export declare const treeListRowVariants: (props?: ({
     active?: boolean | null | undefined;
     selected?: boolean | null | undefined;
     disabled?: boolean | null | undefined;
-    selectable?: boolean | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 export type TreeListRootProps = {
     selection?: ReadonlySet<string>;
@@ -99,23 +98,26 @@ export type TreeListRowLeftProps = {
     children?: ReactNode;
     className?: string;
 } & ComponentPropsWithoutRef<'div'>;
-export declare const TreeListRowLeft: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowLeftProps> & {
-    ref?: import('preact').Ref<HTMLDivElement> | undefined;
-}>;
+export declare const TreeListRowLeft: import('react').ForwardRefExoticComponent<{
+    children?: ReactNode;
+    className?: string;
+} & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
 export type TreeListRowRightProps = {
     children?: ReactNode;
     className?: string;
 } & ComponentPropsWithoutRef<'div'>;
-export declare const TreeListRowRight: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowRightProps> & {
-    ref?: import('preact').Ref<HTMLDivElement> | undefined;
-}>;
+export declare const TreeListRowRight: import('react').ForwardRefExoticComponent<{
+    children?: ReactNode;
+    className?: string;
+} & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
 export type TreeListRowContentProps = {
     children?: ReactNode;
     className?: string;
 } & ComponentPropsWithoutRef<'div'>;
-export declare const TreeListRowContent: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowContentProps> & {
-    ref?: import('preact').Ref<HTMLDivElement> | undefined;
-}>;
+export declare const TreeListRowContent: import('react').ForwardRefExoticComponent<{
+    children?: ReactNode;
+    className?: string;
+} & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
 export type TreeListActionProps = {
     /** Interactive element to exclude from normal tab order (use F2 action mode) */
     children: ReactElement;
@@ -135,9 +137,12 @@ export type TreeListRowLevelSpacerProps = {
     levelIndent?: number;
     className?: string;
 } & ComponentPropsWithoutRef<'div'>;
-export declare const TreeListRowLevelSpacer: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowLevelSpacerProps> & {
-    ref?: import('preact').Ref<HTMLDivElement> | undefined;
-}>;
+export declare const TreeListRowLevelSpacer: import('react').ForwardRefExoticComponent<{
+    level?: number;
+    /** Indent per level in pixels. Default: 20 */
+    levelIndent?: number;
+    className?: string;
+} & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
 export type TreeListRowExpandControlProps = {
     /** Row ID - if provided, clicking will also set this row as active */
     rowId?: string;
@@ -146,11 +151,20 @@ export type TreeListRowExpandControlProps = {
     onToggle?: () => void;
     icon?: LucideIcon;
     selected?: boolean;
+    'aria-label'?: string;
+    className?: string;
+} & Omit<IconButtonProps, 'icon' | 'onClick' | 'aria-label'>;
+export declare const TreeListRowExpandControl: import('react').ForwardRefExoticComponent<{
+    /** Row ID - if provided, clicking will also set this row as active */
+    rowId?: string;
+    expanded?: boolean;
+    hasChildren?: boolean;
+    onToggle?: () => void;
+    icon?: LucideIcon;
+    selected?: boolean;
+    'aria-label'?: string;
     className?: string;
-} & Omit<IconButtonProps, 'icon' | 'onClick'>;
-export declare const TreeListRowExpandControl: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowExpandControlProps> & {
-    ref?: import('preact').Ref<HTMLButtonElement> | undefined;
-}>;
+} & Omit<IconButtonProps, "aria-label" | "onClick" | "icon"> & import('react').RefAttributes<HTMLButtonElement>>;
 export type TreeListRowSelectionControlProps = {
     /** Row ID - required for toggle selection to work */
     rowId: string;
@@ -161,9 +175,16 @@ export type TreeListRowSelectionControlProps = {
     variant?: 'checkbox' | 'radio';
     className?: string;
 } & Omit<ComponentPropsWithoutRef<'div'>, 'onClick'>;
-export declare const TreeListRowSelectionControl: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowSelectionControlProps> & {
-    ref?: import('preact').Ref<HTMLDivElement> | undefined;
-}>;
+export declare const TreeListRowSelectionControl: import('react').ForwardRefExoticComponent<{
+    /** Row ID - required for toggle selection to work */
+    rowId: string;
+    /** Override selection state. If not provided, reads from TreeList selection context. */
+    selected?: boolean;
+    selectable?: boolean;
+    /** Override indicator style. Default: checkbox for multiple, none for single */
+    variant?: "checkbox" | "radio";
+    className?: string;
+} & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "onClick"> & import('react').RefAttributes<HTMLDivElement>>;
 export type TreeListRowLoadingProps = {
     level?: number;
     /** Indent per level in pixels. Default: 20 */
@@ -171,9 +192,13 @@ export type TreeListRowLoadingProps = {
     className?: string;
     children?: ReactNode;
 } & ComponentPropsWithoutRef<'div'>;
-export declare const TreeListRowLoading: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowLoadingProps> & {
-    ref?: import('preact').Ref<HTMLDivElement> | undefined;
-}>;
+export declare const TreeListRowLoading: import('react').ForwardRefExoticComponent<{
+    level?: number;
+    /** Indent per level in pixels. Default: 20 */
+    levelIndent?: number;
+    className?: string;
+    children?: ReactNode;
+} & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
 export type TreeListRowPlaceholderProps = {
     level?: number;
     /** Indent per level in pixels. Default: 20 */
@@ -181,45 +206,213 @@ export type TreeListRowPlaceholderProps = {
     className?: string;
     children?: ReactNode;
 } & ComponentPropsWithoutRef<'div'>;
-export declare const TreeListRowPlaceholder: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowPlaceholderProps> & {
-    ref?: import('preact').Ref<HTMLDivElement> | undefined;
-}>;
-export declare const TreeList: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRootProps> & {
-    ref?: import('preact').Ref<HTMLDivElement> | undefined;
-}> & {
-    Root: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRootProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    Container: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListContainerProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    Row: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowLeft: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowLeftProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowRight: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowRightProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowContent: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowContentProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowLevelSpacer: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowLevelSpacerProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowExpandControl: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowExpandControlProps> & {
-        ref?: import('preact').Ref<HTMLButtonElement> | undefined;
-    }>;
-    RowSelectionControl: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowSelectionControlProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowLoading: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowLoadingProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowPlaceholder: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowPlaceholderProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
+export declare const TreeListRowPlaceholder: import('react').ForwardRefExoticComponent<{
+    level?: number;
+    /** Indent per level in pixels. Default: 20 */
+    levelIndent?: number;
+    className?: string;
+    children?: ReactNode;
+} & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+export declare const TreeList: import('react').ForwardRefExoticComponent<{
+    selection?: ReadonlySet<string>;
+    defaultSelection?: ReadonlySet<string>;
+    onSelectionChange?: (selection: ReadonlySet<string>) => void;
+    selectionMode?: SelectionMode;
+    active?: string;
+    defaultActive?: string;
+    onActiveChange?: (active: string | undefined) => void;
+    loop?: boolean;
+    className?: string;
+    children?: ReactNode;
+    onActivate?: (id: string) => void;
+    getParentId?: (id: string) => string | undefined;
+    getFirstChildId?: (id: string) => string | undefined;
+    expanded?: ReadonlySet<string>;
+    onExpandedChange?: (expanded: ReadonlySet<string>) => void;
+    /**
+     * Controls how users can interact with each item.
+     *
+     * Returns:
+     * - `'full'`: Item can be navigated to and selected (default)
+     * - `'navigate-only'`: Item can receive focus but cannot be selected
+     * - `'none'`: Item is completely non-interactive (skipped in navigation, cannot be selected)
+     *
+     * Default behavior when not provided:
+     * - Uses the `disabled` prop from TreeListRow (disabled = 'none', enabled = 'full')
+     */
+    getItemInteraction?: (id: string) => ItemInteraction;
+    /**
+     * When true, single-clicking the active item while selection is empty
+     * will clear the active state. Double-clicks are not affected.
+     * Default: false.
+     *
+     * This enables "toggle active" behavior where users can deactivate
+     * an item by clicking it again when nothing is selected.
+     */
+    clearActiveOnReclick?: boolean;
+    /**
+     * Controls how selection behaves on a plain row click (no modifier keys).
+     * Shift+Click (range) and Ctrl/Cmd+Click (toggle) are unaffected.
+     *
+     * - `'select'` (default): Selects only the clicked item, clearing others.
+     *   In single mode, clicking the already-selected item deselects it.
+     * - `'toggle'`: Toggles the clicked item without affecting other selections.
+     *   Suitable for combobox dropdowns where row click = checkbox click.
+     * - `'clear'`: Clears all selection on click. Row click only manages
+     *   the active item. Modifier clicks still work for selection.
+     *
+     * @default 'select'
+     */
+    rowClickSelection?: RowClickSelection;
+    /**
+     * When true (default), pressing Escape clears the selection.
+     * Set to false when using inside a Combobox where Escape should
+     * only close the dropdown without clearing selection.
+     *
+     * @default true
+     */
+    clearSelectionOnEscape?: boolean;
+} & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>> & {
+    Root: import('react').ForwardRefExoticComponent<{
+        selection?: ReadonlySet<string>;
+        defaultSelection?: ReadonlySet<string>;
+        onSelectionChange?: (selection: ReadonlySet<string>) => void;
+        selectionMode?: SelectionMode;
+        active?: string;
+        defaultActive?: string;
+        onActiveChange?: (active: string | undefined) => void;
+        loop?: boolean;
+        className?: string;
+        children?: ReactNode;
+        onActivate?: (id: string) => void;
+        getParentId?: (id: string) => string | undefined;
+        getFirstChildId?: (id: string) => string | undefined;
+        expanded?: ReadonlySet<string>;
+        onExpandedChange?: (expanded: ReadonlySet<string>) => void;
+        /**
+         * Controls how users can interact with each item.
+         *
+         * Returns:
+         * - `'full'`: Item can be navigated to and selected (default)
+         * - `'navigate-only'`: Item can receive focus but cannot be selected
+         * - `'none'`: Item is completely non-interactive (skipped in navigation, cannot be selected)
+         *
+         * Default behavior when not provided:
+         * - Uses the `disabled` prop from TreeListRow (disabled = 'none', enabled = 'full')
+         */
+        getItemInteraction?: (id: string) => ItemInteraction;
+        /**
+         * When true, single-clicking the active item while selection is empty
+         * will clear the active state. Double-clicks are not affected.
+         * Default: false.
+         *
+         * This enables "toggle active" behavior where users can deactivate
+         * an item by clicking it again when nothing is selected.
+         */
+        clearActiveOnReclick?: boolean;
+        /**
+         * Controls how selection behaves on a plain row click (no modifier keys).
+         * Shift+Click (range) and Ctrl/Cmd+Click (toggle) are unaffected.
+         *
+         * - `'select'` (default): Selects only the clicked item, clearing others.
+         *   In single mode, clicking the already-selected item deselects it.
+         * - `'toggle'`: Toggles the clicked item without affecting other selections.
+         *   Suitable for combobox dropdowns where row click = checkbox click.
+         * - `'clear'`: Clears all selection on click. Row click only manages
+         *   the active item. Modifier clicks still work for selection.
+         *
+         * @default 'select'
+         */
+        rowClickSelection?: RowClickSelection;
+        /**
+         * When true (default), pressing Escape clears the selection.
+         * Set to false when using inside a Combobox where Escape should
+         * only close the dropdown without clearing selection.
+         *
+         * @default true
+         */
+        clearSelectionOnEscape?: boolean;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    Container: import('react').ForwardRefExoticComponent<{
+        children?: ReactNode;
+        className?: string;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    Row: import('react').ForwardRefExoticComponent<{
+        id: string;
+        disabled?: boolean;
+        selectable?: boolean;
+        /** ARIA level for tree hierarchy (1-based, optional for accessibility) */
+        level?: number;
+        /** Whether this node has children (affects aria-expanded) */
+        hasChildren?: boolean;
+        /** Whether this node is expanded (required if hasChildren=true) */
+        expanded?: boolean;
+        /**
+         * Position of this item within its siblings (1-indexed).
+         * Used for `aria-posinset`. Optional - only set if you have this data.
+         */
+        posinset?: number;
+        /**
+         * Total number of siblings at this level.
+         * Used for `aria-setsize`. Optional - only set if you have this data.
+         */
+        setsize?: number;
+        className?: string;
+        children?: ReactNode;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowLeft: import('react').ForwardRefExoticComponent<{
+        children?: ReactNode;
+        className?: string;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowRight: import('react').ForwardRefExoticComponent<{
+        children?: ReactNode;
+        className?: string;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowContent: import('react').ForwardRefExoticComponent<{
+        children?: ReactNode;
+        className?: string;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowLevelSpacer: import('react').ForwardRefExoticComponent<{
+        level?: number;
+        /** Indent per level in pixels. Default: 20 */
+        levelIndent?: number;
+        className?: string;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowExpandControl: import('react').ForwardRefExoticComponent<{
+        /** Row ID - if provided, clicking will also set this row as active */
+        rowId?: string;
+        expanded?: boolean;
+        hasChildren?: boolean;
+        onToggle?: () => void;
+        icon?: LucideIcon;
+        selected?: boolean;
+        'aria-label'?: string;
+        className?: string;
+    } & Omit<IconButtonProps, "aria-label" | "onClick" | "icon"> & import('react').RefAttributes<HTMLButtonElement>>;
+    RowSelectionControl: import('react').ForwardRefExoticComponent<{
+        /** Row ID - required for toggle selection to work */
+        rowId: string;
+        /** Override selection state. If not provided, reads from TreeList selection context. */
+        selected?: boolean;
+        selectable?: boolean;
+        /** Override indicator style. Default: checkbox for multiple, none for single */
+        variant?: "checkbox" | "radio";
+        className?: string;
+    } & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "onClick"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowLoading: import('react').ForwardRefExoticComponent<{
+        level?: number;
+        /** Indent per level in pixels. Default: 20 */
+        levelIndent?: number;
+        className?: string;
+        children?: ReactNode;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowPlaceholder: import('react').ForwardRefExoticComponent<{
+        level?: number;
+        /** Indent per level in pixels. Default: 20 */
+        levelIndent?: number;
+        className?: string;
+        children?: ReactNode;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
     Action: {
         ({ children }: TreeListActionProps): ReactElement;
         displayName: string;

package/dist/types/components/virtualized-tree-list/virtualized-tree-list.d.ts

@@ -34,12 +34,6 @@ export type VirtualizedTreeListItemProps = {
     'aria-expanded': boolean | undefined;
     'aria-level': number;
     onClick: (e: React.MouseEvent<HTMLElement>) => void;
-    /**
-     * Double-click handler (Preact). Preact uses `onDblClick`, React uses `onDoubleClick`.
-     * Both are provided for cross-framework compatibility. See architecture.md.
-     */
-    onDblClick: () => void;
-    /** Double-click handler (React). See `onDblClick` comment above. */
     onDoubleClick: () => void;
     active: boolean;
     selected: boolean;
@@ -65,8 +59,8 @@ export type VirtualizedTreeListRenderProps<TData> = {
         tabIndex: 0;
         className: string;
         onKeyDown: (e: React.KeyboardEvent<HTMLElement>) => void;
-        onFocus: () => void;
-        onBlur: () => void;
+        onFocus: (e?: React.FocusEvent<HTMLElement>) => void;
+        onBlur: (e?: React.FocusEvent<HTMLElement>) => void;
     };
 };
 /**
@@ -206,7 +200,7 @@ export type VirtualizedTreeListRowProps = {
     selected?: boolean;
     /** Whether this row is disabled */
     disabled?: boolean;
-    /** Whether this row is selectable */
+    /** @deprecated Has no effect. Selection is governed by `getItemInteraction` and `RowSelectionControl`'s `selectable`. */
     selectable?: boolean;
     /** Additional class names */
     className?: string;
@@ -234,11 +228,20 @@ export type VirtualizedTreeListRowExpandControlProps = {
     onToggle?: () => void;
     icon?: LucideIcon;
     selected?: boolean;
+    'aria-label'?: string;
+    className?: string;
+} & Omit<IconButtonProps, 'icon' | 'onClick' | 'aria-label'>;
+export declare const VirtualizedTreeListRowExpandControl: import('react').ForwardRefExoticComponent<{
+    /** Row ID - if provided, clicking will also set this row as active */
+    rowId?: string;
+    expanded?: boolean;
+    hasChildren?: boolean;
+    onToggle?: () => void;
+    icon?: LucideIcon;
+    selected?: boolean;
+    'aria-label'?: string;
     className?: string;
-} & Omit<IconButtonProps, 'icon' | 'onClick'>;
-export declare const VirtualizedTreeListRowExpandControl: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<VirtualizedTreeListRowExpandControlProps> & {
-    ref?: import('preact').Ref<HTMLButtonElement> | undefined;
-}>;
+} & Omit<IconButtonProps, "aria-label" | "onClick" | "icon"> & import('react').RefAttributes<HTMLButtonElement>>;
 export type VirtualizedTreeListRowSelectionControlProps = {
     /** Row ID - required for toggle selection to work */
     rowId: string;
@@ -249,39 +252,83 @@ export type VirtualizedTreeListRowSelectionControlProps = {
     variant?: 'checkbox' | 'radio';
     className?: string;
 } & Omit<ComponentPropsWithoutRef<'div'>, 'onClick'>;
-export declare const VirtualizedTreeListRowSelectionControl: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<VirtualizedTreeListRowSelectionControlProps> & {
-    ref?: import('preact').Ref<HTMLDivElement> | undefined;
-}>;
+export declare const VirtualizedTreeListRowSelectionControl: import('react').ForwardRefExoticComponent<{
+    /** Row ID - required for toggle selection to work */
+    rowId: string;
+    /** Override selection state. If not provided, reads from VirtualizedTreeList selection context. */
+    selected?: boolean;
+    selectable?: boolean;
+    /** Override indicator style. Default: checkbox for multiple, none for single */
+    variant?: "checkbox" | "radio";
+    className?: string;
+} & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "onClick"> & import('react').RefAttributes<HTMLDivElement>>;
 export declare const VirtualizedTreeList: (<TData = unknown>(props: VirtualizedTreeListRootProps<TData> & {
     ref?: React.ForwardedRef<HTMLDivElement>;
 }) => ReactElement) & {
-    Row: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<VirtualizedTreeListRowProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowLeft: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowLeftProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowRight: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowRightProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowContent: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowContentProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowLevelSpacer: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowLevelSpacerProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowExpandControl: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<VirtualizedTreeListRowExpandControlProps> & {
-        ref?: import('preact').Ref<HTMLButtonElement> | undefined;
-    }>;
-    RowSelectionControl: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<VirtualizedTreeListRowSelectionControlProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowLoading: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowLoadingProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
-    RowPlaceholder: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowPlaceholderProps> & {
-        ref?: import('preact').Ref<HTMLDivElement> | undefined;
-    }>;
+    Row: import('react').ForwardRefExoticComponent<{
+        /** Whether this row is the active (focused) row */
+        active?: boolean;
+        /** Whether this row is selected */
+        selected?: boolean;
+        /** Whether this row is disabled */
+        disabled?: boolean;
+        /** @deprecated Has no effect. Selection is governed by `getItemInteraction` and `RowSelectionControl`'s `selectable`. */
+        selectable?: boolean;
+        /** Additional class names */
+        className?: string;
+        /** Row content */
+        children?: ReactNode;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowLeft: import('react').ForwardRefExoticComponent<{
+        children?: ReactNode;
+        className?: string;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowRight: import('react').ForwardRefExoticComponent<{
+        children?: ReactNode;
+        className?: string;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowContent: import('react').ForwardRefExoticComponent<{
+        children?: ReactNode;
+        className?: string;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowLevelSpacer: import('react').ForwardRefExoticComponent<{
+        level?: number;
+        levelIndent?: number;
+        className?: string;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowExpandControl: import('react').ForwardRefExoticComponent<{
+        /** Row ID - if provided, clicking will also set this row as active */
+        rowId?: string;
+        expanded?: boolean;
+        hasChildren?: boolean;
+        onToggle?: () => void;
+        icon?: LucideIcon;
+        selected?: boolean;
+        'aria-label'?: string;
+        className?: string;
+    } & Omit<IconButtonProps, "aria-label" | "onClick" | "icon"> & import('react').RefAttributes<HTMLButtonElement>>;
+    RowSelectionControl: import('react').ForwardRefExoticComponent<{
+        /** Row ID - required for toggle selection to work */
+        rowId: string;
+        /** Override selection state. If not provided, reads from VirtualizedTreeList selection context. */
+        selected?: boolean;
+        selectable?: boolean;
+        /** Override indicator style. Default: checkbox for multiple, none for single */
+        variant?: "checkbox" | "radio";
+        className?: string;
+    } & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "onClick"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowLoading: import('react').ForwardRefExoticComponent<{
+        level?: number;
+        levelIndent?: number;
+        className?: string;
+        children?: ReactNode;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+    RowPlaceholder: import('react').ForwardRefExoticComponent<{
+        level?: number;
+        levelIndent?: number;
+        className?: string;
+        children?: ReactNode;
+    } & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
     Action: {
         ({ children }: VirtualizedTreeListActionProps): ReactElement;
         displayName: string;

package/dist/types/hooks/use-active-item-focus.d.ts

@@ -1,7 +1,7 @@
 import { RefObject } from 'react';
 export type UseActiveItemFocusConfig = {
     /** Reference to the item element to focus */
-    ref: RefObject<HTMLElement> | null;
+    ref: RefObject<HTMLElement | null> | null;
     /** Whether this item is currently active */
     isActive: boolean;
     /** Whether this item is disabled */

package/dist/types/hooks/use-active-on-open.d.ts

@@ -23,7 +23,7 @@ export type UseActiveOnOpenConfig = {
      * updated (useful for tests or virtualized consumers handling scroll
      * through their own adapter).
      */
-    containerRef?: RefObject<HTMLElement> | null;
+    containerRef?: RefObject<HTMLElement | null> | null;
     /**
      * Build the option element's DOM id from a registry id. Defaults to
      * identity. Match the consumer's `buildElementId` used elsewhere.

package/dist/types/hooks/use-click-outside.d.ts

@@ -3,12 +3,12 @@ export type UseClickOutsideConfig = {
     /** Whether the click outside listener is active */
     enabled: boolean;
     /** Reference to the content element (clicks inside are ignored) */
-    contentRef: RefObject<HTMLElement>;
+    contentRef: RefObject<HTMLElement | null>;
     /**
      * Optional references to elements that should be excluded from "outside" detection.
      * Typically used for trigger buttons that toggle the content visibility.
      */
-    excludeRefs?: (RefObject<HTMLElement> | undefined)[];
+    excludeRefs?: (RefObject<HTMLElement | null> | undefined)[];
     /** Callback when pointer down occurs outside */
     onPointerDownOutside?: (event: PointerEvent) => void;
     /** Callback when any interaction occurs outside */

package/dist/types/hooks/use-floating-position.d.ts

@@ -30,9 +30,9 @@ export type UseFloatingPositionConfig = {
     /** Whether the floating element is open/visible */
     enabled: boolean;
     /** Reference to the anchor element to position relative to */
-    anchorRef: RefObject<HTMLElement> | null;
+    anchorRef: RefObject<HTMLElement | null> | null;
     /** Reference to the floating content element */
-    contentRef: RefObject<HTMLElement> | null;
+    contentRef: RefObject<HTMLElement | null> | null;
     /**
      * Preferred side relative to the anchor.
      * @default 'bottom'

package/dist/types/hooks/use-focus-outside.d.ts

@@ -0,0 +1,9 @@
+import { RefObject } from 'react';
+type UseFocusOutsideConfig = {
+    enabled: boolean;
+    contentRef: RefObject<HTMLElement | null>;
+    onInteractOutside?: (event: Event) => void;
+    onClose?: () => void;
+};
+export declare const useFocusOutside: ({ enabled, contentRef, onInteractOutside, onClose, }: UseFocusOutsideConfig) => ((branch: HTMLElement) => () => void);
+export {};

package/dist/types/hooks/use-pointer-position.d.ts

@@ -12,7 +12,7 @@ export type UsePointerPositionConfig = {
         y: number;
     } | null;
     /** Reference to the floating content element */
-    contentRef: RefObject<HTMLElement> | null;
+    contentRef: RefObject<HTMLElement | null> | null;
 };
 /**
  * Calculates optimal position for floating content relative to pointer coordinates,