@warkypublic/svelix 0.1.46 → 0.2.1

package/dist/components/VTree/VTree.svelte

@@ -1,434 +1,441 @@
-<script lang="ts">
-  import { onMount } from 'svelte';
-  import VTreeSearch from './VTreeSearch.svelte';
-  import VTreeVirtualViewport from './VTreeVirtualViewport.svelte';
-  import VTreeContextMenu from './VTreeContextMenu.svelte';
-  import type { VTreeFlatRow } from './VTree.models.js';
-  import type { VTreeContextMenuItem, VTreeProps, VTreeRecord } from './types.js';
-
-  export type Props<T extends VTreeRecord = VTreeRecord> = VTreeProps<T>;
-
-  const {
-    data = [],
-    adapter,
-    idField = 'id',
-    labelField = 'label',
-    descriptionField = 'description',
-    childrenField = 'children',
-    hasChildrenField = 'hasChildren',
-    height = 420,
-    rowHeight = 36,
-    indent = 18,
-    overscan = 8,
-    searchable = true,
-    searchPlaceholder = 'Search tree...',
-    searchValue = '',
-    serverSideSearch = false,
-    autoExpandSearchResults = true,
-    loadOnMount = true,
-    emptyMessage = 'Nothing here...',
-    loadingMessage = 'Loading...',
-    leftSection,
-    rightSection,
-    contextMenuItems,
-    onselect,
-    onclick,
-    ondoubleclick,
-    oncontext,
-    ontoggle,
-    onsearch,
-    onloaderror
-  }: Props = $props();
-
-  let viewportRef = $state<{ scrollToIndex: (index: number) => void } | undefined>(undefined);
-  let focusedIndex = $state(0);
-  let selectedId = $state<string | null>(null);
-  let searchQuery = $state('');
-  let loadingRoot = $state(false);
-
-  let rootNodes = $state<VTreeRecord[]>([]);
-  let searchNodes = $state<VTreeRecord[]>([]);
-  let childrenByParent = $state<Record<string, VTreeRecord[]>>({});
-  let expandedById = $state<Record<string, boolean>>({});
-  let loadingById = $state<Record<string, boolean>>({});
-  let loadedById = $state<Record<string, boolean>>({});
-  let errorsById = $state<Record<string, string>>({});
-
-  let lastSearchHandle: ReturnType<typeof setTimeout> | undefined;
-  let searchRunId = 0;
-  let contextOpen = $state(false);
-  let contextX = $state(0);
-  let contextY = $state(0);
-  let contextRow = $state<VTreeRecord | null>(null);
-  let contextItems = $state<VTreeContextMenuItem[]>([]);
-
-  function getNodeId(node: VTreeRecord): string {
-    const value = node?.[idField];
-    return String(value ?? '');
-  }
-
-  function getNodeLabel(node: VTreeRecord): string {
-    return String(node?.[labelField] ?? '');
-  }
-
-  function getNodeDescription(node: VTreeRecord): string {
-    const value = node?.[descriptionField];
-    return value === undefined || value === null ? '' : String(value);
-  }
-
-  function getNodeChildren(node: VTreeRecord): VTreeRecord[] {
-    const nodeId = getNodeId(node);
-    const remoteChildren = childrenByParent[nodeId];
-    if (remoteChildren) return remoteChildren;
-
-    const localChildren = node?.[childrenField];
-    return Array.isArray(localChildren) ? (localChildren as VTreeRecord[]) : [];
-  }
-
-  function nodeHasChildren(node: VTreeRecord): boolean {
-    const children = getNodeChildren(node);
-    if (children.length > 0) return true;
-    return typeof node?.[hasChildrenField] === 'boolean'
-      ? Boolean(node[hasChildrenField])
-      : false;
-  }
-
-  function normalizeRows(rows: VTreeRecord[]): VTreeRecord[] {
-    return Array.isArray(rows) ? rows : [];
-  }
-
-  async function loadRoot() {
-    if (!adapter) {
-      rootNodes = normalizeRows(data ?? []);
-      return;
-    }
-
-    loadingRoot = true;
-    try {
-      const rows = await adapter.readRoot();
-      rootNodes = normalizeRows(rows);
-      searchNodes = [];
-      errorsById = {};
-    } catch (error) {
-      onloaderror?.(error);
-    } finally {
-      loadingRoot = false;
-    }
-  }
-
-  async function loadChildren(node: VTreeRecord) {
-    if (!adapter) return;
-
-    const nodeId = getNodeId(node);
-    if (!nodeId || loadingById[nodeId] || loadedById[nodeId]) return;
-
-    loadingById = { ...loadingById, [nodeId]: true };
-    errorsById = { ...errorsById, [nodeId]: '' };
-
-    try {
-      const rows = await adapter.readChildren(node);
-      childrenByParent = { ...childrenByParent, [nodeId]: normalizeRows(rows) };
-      loadedById = { ...loadedById, [nodeId]: true };
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unable to load node';
-      errorsById = { ...errorsById, [nodeId]: message };
-      onloaderror?.(error, node);
-    } finally {
-      loadingById = { ...loadingById, [nodeId]: false };
-    }
-  }
-
-  function matchesLocalSearch(node: VTreeRecord, query: string): boolean {
-    const q = query.toLowerCase();
-    return (
-      getNodeLabel(node).toLowerCase().includes(q) ||
-      getNodeDescription(node).toLowerCase().includes(q)
-    );
-  }
-
-  function toggleNode(node: VTreeRecord) {
-    const nodeId = getNodeId(node);
-    if (!nodeId) return;
-
-    const currentlyExpanded = Boolean(expandedById[nodeId]);
-    expandedById = { ...expandedById, [nodeId]: !currentlyExpanded };
-    ontoggle?.(node, !currentlyExpanded);
-
-    if (!currentlyExpanded && adapter && nodeHasChildren(node)) {
-      void loadChildren(node);
-    }
-  }
-
-  const displayRoots = $derived.by(() => {
-    if (adapter && serverSideSearch && searchQuery.trim().length > 0) return searchNodes;
-    return rootNodes;
-  });
-
-  const flattenedRows = $derived.by(() => {
-    const rows: VTreeFlatRow[] = [];
-    const activeSearch = searchQuery.trim().toLowerCase();
-    const useLocalSearch = activeSearch.length > 0 && !(adapter && serverSideSearch);
-
-    const walk = (
-      nodes: VTreeRecord[],
-      level: number,
-      parentId: string | null
-    ): { rows: VTreeFlatRow[]; matches: boolean } => {
-      const walkRows: VTreeFlatRow[] = [];
-      let hasAnyMatch = false;
-
-      for (const node of nodes) {
-        const id = getNodeId(node);
-        const children = getNodeChildren(node);
-        const childResult = walk(children, level + 1, id);
-        const selfMatch = useLocalSearch ? matchesLocalSearch(node, activeSearch) : false;
-        const childHasMatch = childResult.matches;
-        const includeNode = !useLocalSearch || selfMatch || childHasMatch;
-
-        if (!includeNode) continue;
-
-        hasAnyMatch = true;
-        const expanded = Boolean(expandedById[id]);
-        const forceExpanded = useLocalSearch && autoExpandSearchResults && childHasMatch;
-        walkRows.push({
-          id,
-          node,
-          level,
-          parentId,
-          expanded,
-          hasChildren: nodeHasChildren(node),
-          loading: Boolean(loadingById[id]),
-          error: errorsById[id] || undefined,
-          matched: selfMatch
-        });
-
-        if ((expanded || forceExpanded) && childResult.rows.length > 0) {
-          walkRows.push(...childResult.rows);
-        }
-      }
-
-      return { rows: walkRows, matches: hasAnyMatch };
-    };
-
-    for (const root of displayRoots) {
-      rows.push(...walk([root], 1, null).rows);
-    }
-    return rows;
-  });
-
-  const treeDataSnapshot = $derived.by(() => {
-    const buildTree = (nodes: VTreeRecord[]): VTreeRecord[] =>
-      nodes.map((node) => {
-        const children = getNodeChildren(node);
-        if (children.length === 0) {
-          return node;
-        }
-        return {
-          ...node,
-          [childrenField]: buildTree(children)
-        };
-      });
-
-    return buildTree(displayRoots);
-  });
-
-  function selectRow(index: number) {
-    const row = flattenedRows[index];
-    if (!row) return;
-
-    focusedIndex = index;
-    selectedId = row.id;
-    onselect?.(row.node);
-    viewportRef?.scrollToIndex(index);
-  }
-
-  function moveFocus(delta: number) {
-    if (flattenedRows.length === 0) return;
-    const next = Math.min(flattenedRows.length - 1, Math.max(0, focusedIndex + delta));
-    selectRow(next);
-  }
-
-  function handleTreeKeydown(event: KeyboardEvent) {
-    if (flattenedRows.length === 0) return;
-
-    const current = flattenedRows[focusedIndex];
-    if (!current) {
-      selectRow(0);
-      return;
-    }
-
-    if (event.key === 'ArrowDown') {
-      event.preventDefault();
-      moveFocus(1);
-      return;
-    }
-    if (event.key === 'ArrowUp') {
-      event.preventDefault();
-      moveFocus(-1);
-      return;
-    }
-    if (event.key === 'PageDown') {
-      event.preventDefault();
-      moveFocus(10);
-      return;
-    }
-    if (event.key === 'PageUp') {
-      event.preventDefault();
-      moveFocus(-10);
-      return;
-    }
-    if (event.key === 'Home') {
-      event.preventDefault();
-      selectRow(0);
-      return;
-    }
-    if (event.key === 'End') {
-      event.preventDefault();
-      selectRow(flattenedRows.length - 1);
-      return;
-    }
-    if (event.key === 'ArrowRight') {
-      event.preventDefault();
-      if (current.hasChildren && !current.expanded) {
-        toggleNode(current.node);
-      } else {
-        moveFocus(1);
-      }
-      return;
-    }
-    if (event.key === 'ArrowLeft') {
-      event.preventDefault();
-      if (current.expanded) {
-        toggleNode(current.node);
-      } else if (current.parentId) {
-        const parentIndex = flattenedRows.findIndex((row) => row.id === current.parentId);
-        if (parentIndex >= 0) selectRow(parentIndex);
-      }
-      return;
-    }
-    if (event.key === ' ' || event.key === 'Enter') {
-      event.preventDefault();
-      selectRow(focusedIndex);
-      if (current.hasChildren) {
-        toggleNode(current.node);
-      }
-    }
-  }
-
-  async function runServerSearch(query: string) {
-    if (!adapter || !serverSideSearch) return;
-    const runId = ++searchRunId;
-
-    if (!query.trim()) {
-      searchNodes = [];
-      return;
-    }
-
-    try {
-      const rows = await adapter.search(query.trim());
-      if (runId !== searchRunId) return;
-      searchNodes = normalizeRows(rows);
-      focusedIndex = 0;
-    } catch (error) {
-      if (runId !== searchRunId) return;
-      onloaderror?.(error);
-    }
-  }
-
-  function handleSearchInput(value: string) {
-    searchQuery = value;
-    onsearch?.(value);
-  }
-
-  function handleRowClick(index: number, event: MouseEvent) {
-    const row = flattenedRows[index];
-    if (!row) return;
-    selectRow(index);
-    onclick?.(row.node, treeDataSnapshot, event);
-  }
-
-  function handleRowDoubleClick(index: number, event: MouseEvent) {
-    const row = flattenedRows[index];
-    if (!row) return;
-    selectRow(index);
-    ondoubleclick?.(row.node, treeDataSnapshot, event);
-  }
-
-  function handleRowContext(index: number, event: MouseEvent) {
-    const row = flattenedRows[index];
-    if (!row) return;
-    event.preventDefault();
-    selectRow(index);
-    oncontext?.(row.node, treeDataSnapshot, event);
-
-    if (!contextMenuItems) return;
-    const items =
-      typeof contextMenuItems === 'function'
-        ? contextMenuItems(row.node, treeDataSnapshot)
-        : contextMenuItems;
-    contextItems = items ?? [];
-    contextRow = row.node;
-    contextX = event.clientX;
-    contextY = event.clientY;
-    contextOpen = contextItems.length > 0;
-  }
-
-  function handleViewportContext(event: MouseEvent) {
-    event.preventDefault();
-    oncontext?.(null, treeDataSnapshot, event);
-
-    if (!contextMenuItems) return;
-    const items =
-      typeof contextMenuItems === 'function'
-        ? contextMenuItems(null, treeDataSnapshot)
-        : contextMenuItems;
-    contextItems = items ?? [];
-    contextRow = null;
-    contextX = event.clientX;
-    contextY = event.clientY;
-    contextOpen = contextItems.length > 0;
-  }
-
-  function handleContextMenuItem(item: VTreeContextMenuItem) {
-    if (item.id !== '__close__' && contextRow) {
-      item.onselect?.(contextRow, treeDataSnapshot);
-    }
-    contextOpen = false;
-  }
-
-  $effect(() => {
-    if (!adapter) rootNodes = normalizeRows(data ?? []);
-  });
-
-  $effect(() => {
-    if (!adapter || !serverSideSearch) return;
-    clearTimeout(lastSearchHandle);
-    lastSearchHandle = setTimeout(() => {
-      void runServerSearch(searchQuery);
-    }, 250);
-    return () => clearTimeout(lastSearchHandle);
-  });
-
-  $effect(() => {
-    if (focusedIndex > flattenedRows.length - 1) {
-      focusedIndex = Math.max(flattenedRows.length - 1, 0);
-    }
-    if (!selectedId && flattenedRows.length > 0) {
-      selectedId = flattenedRows[0].id;
-    }
-  });
-
-  onMount(() => {
-    searchQuery = searchValue ?? '';
-
-    if (adapter && loadOnMount) {
-      void loadRoot();
-    } else {
-      rootNodes = normalizeRows(data ?? []);
-    }
-
-    return () => clearTimeout(lastSearchHandle);
-  });
+<script lang="ts">import { onMount } from "svelte";
+import VTreeSearch from "./VTreeSearch.svelte";
+import VTreeVirtualViewport from "./VTreeVirtualViewport.svelte";
+import VTreeContextMenu from "./VTreeContextMenu.svelte";
+import { buildNodeIndex, computeMultiSelectClick, findAncestorIds } from "./VTree.utils.js";
+const { data = [], adapter, idField = "id", labelField = "label", descriptionField = "description", childrenField = "children", hasChildrenField = "hasChildren", height = 420, rowHeight = 36, indent = 18, overscan = 8, searchable = true, searchPlaceholder = "Search tree...", searchValue = "", serverSideSearch = false, autoExpandSearchResults = true, loadOnMount = true, emptyMessage = "Nothing here...", loadingMessage = "Loading...", leftSection, rightSection, contextMenuItems, onselect, onclick, ondoubleclick, oncontext, ontoggle, onsearch, onloaderror, selected, onSelectedChange, multiple = false, selectedItems, onSelectedItemsChange, selectionMode = "modifier", autoMeasure = false, iconField, icon, classes, showRowSeparator = true, hoverEffect = true, onsingleclick, singleClickDelay = 250, onlongpress, longPressDelay = 500, longPressMoveTolerance = 10, onrowhover, onrowhoverend } = $props();
+let viewportRef = $state(undefined);
+let focusedIndex = $state(0);
+let selectedId = $state(null);
+let searchQuery = $state("");
+let loadingRoot = $state(false);
+let rootNodes = $state([]);
+let searchNodes = $state([]);
+let childrenByParent = $state({});
+let expandedById = $state({});
+let loadingById = $state({});
+let loadedById = $state({});
+let errorsById = $state({});
+let lastSearchHandle;
+let searchRunId = 0;
+let contextOpen = $state(false);
+let contextX = $state(0);
+let contextY = $state(0);
+let contextRow = $state(null);
+let contextItems = $state([]);
+// Long-press is handled per row and committed here when fired.
+function handleRowLongpress(index, event) {
+	const row = flattenedRows[index];
+	if (!row) return;
+	selectRow(index);
+	commitSelection(index);
+	onlongpress?.(row.node, treeDataSnapshot, event);
+}
+// Selection model state.
+let internalSelected = $state(null);
+let internalSelectedItems = $state([]);
+let rangeAnchorIndex = $state(null);
+let lastRevealedId = $state(null);
+let lastScrolledId = $state(null);
+let singleClickTimer;
+let clickCount = 0;
+function commitSelection(index, event, forceToggle = false) {
+	const row = flattenedRows[index];
+	if (!row) return;
+	if (multiple) {
+		applyMultiSelect(row.node, index, event, forceToggle);
+	} else {
+		onSelectedChange?.(row.node);
+		if (selected === undefined) internalSelected = row.node;
+	}
+}
+function applyMultiSelect(node, index, event, forceToggle = false) {
+	const currentItems = selectedItems ?? internalSelectedItems;
+	const orderedRowIds = flattenedRows.map((row) => row.id);
+	const clickedId = getNodeId(node);
+	const result = computeMultiSelectClick({
+		currentIds: currentItems.map((item) => getNodeId(item)),
+		clickedId,
+		clickedIndex: index,
+		anchorIndex: rangeAnchorIndex,
+		orderedRowIds,
+		ctrlOrMeta: forceToggle || Boolean(event?.ctrlKey || event?.metaKey),
+		shift: Boolean(event?.shiftKey)
+	});
+	rangeAnchorIndex = result.nextAnchorIndex;
+	const items = result.ids.map((id) => nodeIndex.byId.get(id)).filter((item) => Boolean(item));
+	if (selectedItems === undefined) internalSelectedItems = items;
+	onSelectedItemsChange?.(items);
+}
+function getNodeId(node) {
+	const value = node?.[idField];
+	return String(value ?? "");
+}
+function getNodeLabel(node) {
+	return String(node?.[labelField] ?? "");
+}
+function getNodeDescription(node) {
+	const value = node?.[descriptionField];
+	return value === undefined || value === null ? "" : String(value);
+}
+function getNodeChildren(node) {
+	const nodeId = getNodeId(node);
+	const remoteChildren = childrenByParent[nodeId];
+	if (remoteChildren) return remoteChildren;
+	const localChildren = node?.[childrenField];
+	return Array.isArray(localChildren) ? localChildren : [];
+}
+function nodeHasChildren(node) {
+	const children = getNodeChildren(node);
+	if (children.length > 0) return true;
+	return typeof node?.[hasChildrenField] === "boolean" ? Boolean(node[hasChildrenField]) : false;
+}
+function normalizeRows(rows) {
+	return Array.isArray(rows) ? rows : [];
+}
+async function loadRoot() {
+	if (!adapter) {
+		rootNodes = normalizeRows(data ?? []);
+		return;
+	}
+	loadingRoot = true;
+	try {
+		const rows = await adapter.readRoot();
+		rootNodes = normalizeRows(rows);
+		searchNodes = [];
+		errorsById = {};
+	} catch (error) {
+		onloaderror?.(error);
+	} finally {
+		loadingRoot = false;
+	}
+}
+async function loadChildren(node) {
+	if (!adapter) return;
+	const nodeId = getNodeId(node);
+	if (!nodeId || loadingById[nodeId] || loadedById[nodeId]) return;
+	loadingById = {
+		...loadingById,
+		[nodeId]: true
+	};
+	errorsById = {
+		...errorsById,
+		[nodeId]: ""
+	};
+	try {
+		const rows = await adapter.readChildren(node);
+		childrenByParent = {
+			...childrenByParent,
+			[nodeId]: normalizeRows(rows)
+		};
+		loadedById = {
+			...loadedById,
+			[nodeId]: true
+		};
+	} catch (error) {
+		const message = error instanceof Error ? error.message : "Unable to load node";
+		errorsById = {
+			...errorsById,
+			[nodeId]: message
+		};
+		onloaderror?.(error, node);
+	} finally {
+		loadingById = {
+			...loadingById,
+			[nodeId]: false
+		};
+	}
+}
+function matchesLocalSearch(node, query) {
+	const q = query.toLowerCase();
+	return getNodeLabel(node).toLowerCase().includes(q) || getNodeDescription(node).toLowerCase().includes(q);
+}
+function toggleNode(node) {
+	const nodeId = getNodeId(node);
+	if (!nodeId) return;
+	const currentlyExpanded = Boolean(expandedById[nodeId]);
+	expandedById = {
+		...expandedById,
+		[nodeId]: !currentlyExpanded
+	};
+	ontoggle?.(node, !currentlyExpanded);
+	if (!currentlyExpanded && adapter && nodeHasChildren(node)) {
+		void loadChildren(node);
+	}
+}
+const displayRoots = $derived.by(() => {
+	if (adapter && serverSideSearch && searchQuery.trim().length > 0) return searchNodes;
+	return rootNodes;
+});
+const nodeIndex = $derived.by(() => buildNodeIndex(displayRoots, getNodeId, getNodeChildren));
+const flattenedRows = $derived.by(() => {
+	const rows = [];
+	const activeSearch = searchQuery.trim().toLowerCase();
+	const useLocalSearch = activeSearch.length > 0 && !(adapter && serverSideSearch);
+	const walk = (nodes, level, parentId) => {
+		const walkRows = [];
+		let hasAnyMatch = false;
+		for (const node of nodes) {
+			const id = getNodeId(node);
+			const children = getNodeChildren(node);
+			const childResult = walk(children, level + 1, id);
+			const selfMatch = useLocalSearch ? matchesLocalSearch(node, activeSearch) : false;
+			const childHasMatch = childResult.matches;
+			const includeNode = !useLocalSearch || selfMatch || childHasMatch;
+			if (!includeNode) continue;
+			hasAnyMatch = true;
+			const expanded = Boolean(expandedById[id]);
+			const forceExpanded = useLocalSearch && autoExpandSearchResults && childHasMatch;
+			walkRows.push({
+				id,
+				node,
+				level,
+				parentId,
+				expanded,
+				hasChildren: nodeHasChildren(node),
+				loading: Boolean(loadingById[id]),
+				error: errorsById[id] || undefined,
+				matched: selfMatch
+			});
+			if ((expanded || forceExpanded) && childResult.rows.length > 0) {
+				walkRows.push(...childResult.rows);
+			}
+		}
+		return {
+			rows: walkRows,
+			matches: hasAnyMatch
+		};
+	};
+	for (const root of displayRoots) {
+		rows.push(...walk([root], 1, null).rows);
+	}
+	return rows;
+});
+const treeDataSnapshot = $derived.by(() => {
+	const buildTree = (nodes) => nodes.map((node) => {
+		const children = getNodeChildren(node);
+		if (children.length === 0) {
+			return node;
+		}
+		return {
+			...node,
+			[childrenField]: buildTree(children)
+		};
+	});
+	return buildTree(displayRoots);
+});
+const selectedNodeId = $derived(selected ? getNodeId(selected) : selected === null ? "" : internalSelected ? getNodeId(internalSelected) : "");
+$effect(() => {
+	if (!selectedNodeId || lastRevealedId === selectedNodeId) return;
+	const ancestors = findAncestorIds(nodeIndex.parentById, selectedNodeId);
+	const next = { ...expandedById };
+	let changed = false;
+	for (const id of ancestors) {
+		if (!next[id]) {
+			next[id] = true;
+			changed = true;
+		}
+	}
+	if (changed) expandedById = next;
+	lastRevealedId = selectedNodeId;
+	lastScrolledId = null;
+});
+$effect(() => {
+	if (!selectedNodeId || lastScrolledId === selectedNodeId) return;
+	const index = flattenedRows.findIndex((row) => row.id === selectedNodeId);
+	if (index < 0) return;
+	focusedIndex = index;
+	selectedId = selectedNodeId;
+	viewportRef?.scrollToIndex(index);
+	lastScrolledId = selectedNodeId;
+});
+function selectRow(index) {
+	const row = flattenedRows[index];
+	if (!row) return;
+	focusedIndex = index;
+	// Keep existing uncontrolled fallback behavior.
+	selectedId = row.id;
+	onselect?.(row.node);
+	viewportRef?.scrollToIndex(index);
+}
+function moveFocus(delta) {
+	if (flattenedRows.length === 0) return;
+	const next = Math.min(flattenedRows.length - 1, Math.max(0, focusedIndex + delta));
+	selectRow(next);
+}
+function handleTreeKeydown(event) {
+	if (flattenedRows.length === 0) return;
+	const current = flattenedRows[focusedIndex];
+	if (!current) {
+		selectRow(0);
+		return;
+	}
+	if (event.key === "ArrowDown") {
+		event.preventDefault();
+		moveFocus(1);
+		return;
+	}
+	if (event.key === "ArrowUp") {
+		event.preventDefault();
+		moveFocus(-1);
+		return;
+	}
+	if (event.key === "PageDown") {
+		event.preventDefault();
+		moveFocus(10);
+		return;
+	}
+	if (event.key === "PageUp") {
+		event.preventDefault();
+		moveFocus(-10);
+		return;
+	}
+	if (event.key === "Home") {
+		event.preventDefault();
+		selectRow(0);
+		return;
+	}
+	if (event.key === "End") {
+		event.preventDefault();
+		selectRow(flattenedRows.length - 1);
+		return;
+	}
+	if (event.key === "ArrowRight") {
+		event.preventDefault();
+		if (current.hasChildren && !current.expanded) {
+			toggleNode(current.node);
+		} else {
+			moveFocus(1);
+		}
+		return;
+	}
+	if (event.key === "ArrowLeft") {
+		event.preventDefault();
+		if (current.expanded) {
+			toggleNode(current.node);
+		} else if (current.parentId) {
+			const parentIndex = flattenedRows.findIndex((row) => row.id === current.parentId);
+			if (parentIndex >= 0) selectRow(parentIndex);
+		}
+		return;
+	}
+	if (event.key === "Enter") {
+		event.preventDefault();
+		selectRow(focusedIndex);
+		// Single-click selection via Enter.
+		commitSelection(focusedIndex);
+		if (current.hasChildren) {
+			toggleNode(current.node);
+		}
+	}
+	// Single-click selection via Space.
+	if (event.key === " ") {
+		event.preventDefault();
+		commitSelection(focusedIndex);
+	}
+}
+async function runServerSearch(query) {
+	if (!adapter || !serverSideSearch) return;
+	const runId = ++searchRunId;
+	if (!query.trim()) {
+		searchNodes = [];
+		return;
+	}
+	try {
+		const rows = await adapter.search(query.trim());
+		if (runId !== searchRunId) return;
+		searchNodes = normalizeRows(rows);
+		focusedIndex = 0;
+	} catch (error) {
+		if (runId !== searchRunId) return;
+		onloaderror?.(error);
+	}
+}
+function handleSearchInput(value) {
+	searchQuery = value;
+	onsearch?.(value);
+}
+function handleRowClick(index, event) {
+	const row = flattenedRows[index];
+	if (!row) return;
+	selectRow(index);
+	onclick?.(row.node, treeDataSnapshot, event);
+	// Checkbox mode intentionally leaves row-body clicks out of multi-selection.
+	if (!multiple || selectionMode === "modifier") commitSelection(index, event);
+	clearTimeout(singleClickTimer);
+	clickCount += 1;
+	singleClickTimer = setTimeout(() => {
+		if (clickCount === 1) onsingleclick?.(row.node, treeDataSnapshot, event);
+		clickCount = 0;
+	}, singleClickDelay);
+}
+function handleRowDoubleClick(index, event) {
+	const row = flattenedRows[index];
+	if (!row) return;
+	clearTimeout(singleClickTimer);
+	clickCount = 0;
+	selectRow(index);
+	ondoubleclick?.(row.node, treeDataSnapshot, event);
+}
+function handleRowContext(index, event) {
+	const row = flattenedRows[index];
+	if (!row) return;
+	event.preventDefault();
+	selectRow(index);
+	oncontext?.(row.node, treeDataSnapshot, event);
+	if (!contextMenuItems) return;
+	const items = typeof contextMenuItems === "function" ? contextMenuItems(row.node, treeDataSnapshot) : contextMenuItems;
+	contextItems = items ?? [];
+	contextRow = row.node;
+	contextX = event.clientX;
+	contextY = event.clientY;
+	contextOpen = contextItems.length > 0;
+}
+function handleViewportContext(event) {
+	event.preventDefault();
+	oncontext?.(null, treeDataSnapshot, event);
+	if (!contextMenuItems) return;
+	const items = typeof contextMenuItems === "function" ? contextMenuItems(null, treeDataSnapshot) : contextMenuItems;
+	contextItems = items ?? [];
+	contextRow = null;
+	contextX = event.clientX;
+	contextY = event.clientY;
+	contextOpen = contextItems.length > 0;
+}
+function handleContextMenuItem(item) {
+	if (item.id !== "__close__" && contextRow) {
+		item.onselect?.(contextRow, treeDataSnapshot);
+	}
+	contextOpen = false;
+}
+$effect(() => {
+	if (!adapter) rootNodes = normalizeRows(data ?? []);
+});
+$effect(() => {
+	if (!adapter || !serverSideSearch) return;
+	clearTimeout(lastSearchHandle);
+	lastSearchHandle = setTimeout(() => {
+		void runServerSearch(searchQuery);
+	}, 250);
+	return () => clearTimeout(lastSearchHandle);
+});
+$effect(() => {
+	if (focusedIndex > flattenedRows.length - 1) {
+		focusedIndex = Math.max(flattenedRows.length - 1, 0);
+	}
+	if (!selectedId && flattenedRows.length > 0) {
+		selectedId = flattenedRows[0].id;
+	}
+});
+onMount(() => {
+	searchQuery = searchValue ?? "";
+	if (adapter && loadOnMount) {
+		void loadRoot();
+	} else {
+		rootNodes = normalizeRows(data ?? []);
+	}
+	return () => clearTimeout(lastSearchHandle);
+});
 </script>
 
 <div class="card space-y-2 border border-surface-300-700 bg-surface-100-900 p-2">
@@ -440,6 +447,7 @@
     bind:this={viewportRef}
     rows={flattenedRows}
     {rowHeight}
+    {autoMeasure}
     {height}
     {indent}
     {overscan}
@@ -453,12 +461,27 @@
     {treeDataSnapshot}
     {leftSection}
     {rightSection}
+    {iconField}
+    {icon}
+    {classes}
+    {showRowSeparator}
+    {hoverEffect}
+    {multiple}
+    {selectionMode}
+    selectedItemIds={(selectedItems ?? internalSelectedItems).map((item) => getNodeId(item))}
+    selectedNodeId={selectedNodeId}
     onselectrow={handleRowClick}
     onrowdoubleclick={handleRowDoubleClick}
     onrowcontext={handleRowContext}
     onviewportcontext={handleViewportContext}
     ontogglerow={toggleNode}
     ontreekeydown={handleTreeKeydown}
+    onrowlongpress={handleRowLongpress}
+    oncheckboxselect={(index, event) => commitSelection(index, event, true)}
+    onrowhover={(index, event) => { const row = flattenedRows[index]; if (row) onrowhover?.(row.node, treeDataSnapshot, index, event); }}
+    onrowhoverend={(index, event) => { const row = flattenedRows[index]; if (row) onrowhoverend?.(row.node, treeDataSnapshot, index, event); }}
+    {longPressDelay}
+    {longPressMoveTolerance}
   />
 
   <VTreeContextMenu