@keenmate/svelte-treeview 5.0.0-rc06 → 5.0.0-rc08

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [5.0.0-rc08] - 2026-05-27
+
+### Added
+- **`{ silent: true }` option on highlight/selection methods**: `highlightNode`, `highlightNodes`, `clearHighlight`, `deselectAll` (and deprecated `selectNode`/`selectNodes`) now accept `{ silent: true }` to update state without firing `onNodeClick` / `onHighlightChange` / `onSelectionChange`. Intended for URL-restore flows (deep links loading form data from query params) where firing the change callback would re-trigger form loaders and clobber the data the URL just supplied. Silent mode also skips focusing the tree container so it doesn't steal focus from whatever the user is interacting with.
+- **Array variants on expand/collapse methods**: `expandNodes`, `collapseNodes`, `expandAll`, and `collapseAll` now accept `string | string[]`. Single emit per call regardless of array length.
+- **`{ exclusive: true }` option on `expandNodes` and `expandAll`**: Opens the target path(s) and collapses anything currently expanded that isn't on the union-of-spines (and, for `expandAll`, not under a target subtree). Equivalent to `collapseAll() + expandNodes(path)` but in a single pass with one emit — downstream listeners (transition animations, URL sync, virtualized renderers) don't see the intermediate fully-collapsed state. Non-collapsible nodes (`isCollapsible === false`) are never touched.
+- **`{ noEmit: true }` option on all four expand/collapse methods**: Skips the change emit, enabling batching multiple operations and emitting once at the end via `tree.refresh()`.
+- **`/examples/silent-highlight` demo page**: URL-restore scenario with loud vs. silent toggle showing how form data is preserved in silent mode.
+- **`/examples/expand-collapse` demo page**: Demonstrates array variants and exclusive focus mode.
+
+## [5.0.0-rc07] - 2026-05-23
+
+### Added
+- **`isSelectedMember` prop**: Data field name that seeds `node.isSelected` at `insertArray` time. The controller walks the tree after insert and pre-populates the bindable `selectedPaths` Set with every path where the field is truthy — independent of `isSelectableMember`, so non-selectable nodes can still ship checked.
+- **`isSelectableMember` prop now publicly wired**: Previously declared on the core types but not exposed through `Tree.svelte`'s prop/update interface. Now end-to-end usable. Controls whether a node renders a checkbox and carries the `ltree-clickable` class.
+
+### Fixed
+- **Filter race with async indexing**: A `bind:searchText` change that landed while the FlexSearch index was still being built (via `requestIdleCallback` batches) saw an empty index, hid the entire tree, and never recovered — no mechanism re-applied the filter once indexing completed. `filterNodes` now remembers the active query and the indexer's `onComplete` callback re-runs it, so the visible filter catches up automatically regardless of `indexerBatchSize`, dataset size, or how fast the user types.
+
 ## [5.0.0-rc06] - 2026-03-31
 
 ### Added

package/README.md

@@ -6,31 +6,18 @@ A high-performance, feature-rich hierarchical tree view component for Svelte 5 w
 
 Browse interactive code examples and the full API reference at **[svelte-treeview.keenmate.dev](https://svelte-treeview.keenmate.dev)**
 
-## What's New in v5.0.0-rc06
-
-- **Three-level selection**: `focusedNode` (click/arrows), `highlightedPaths` (Ctrl/Shift+click), `selectedPaths` (checkbox data state). Highlight and checkbox are independent — build a selection, then check/uncheck all at once.
-- **`clickBehavior` prop**: `'select'` | `'expand'` | `'expand-and-focus'` (default). Replaces `shouldToggleOnNodeClick`.
-- **`showCheckboxes` + `checkboxMode`**: Custom styled checkboxes with `'independent'` or `'cascade'` mode (parent toggles descendants, indeterminate state).
-- **Shift+Arrow/Home/End/PageUp/PageDown**: Extends highlight range via keyboard, like file managers.
-- **Pluggable keyboard navigation**: `TreeNavigation<T>` interface — each renderer provides its own spatial implementation. Override individual methods via `TreeNavigationOverrides<T>`.
-- **Bulk subtree operations**: `insertBranch()`, `replaceBranch()`, `deleteBranch()` on TreeController — add, replace, or remove entire subtrees with a single emission.
-- **Clipboard API**: `copyNodes()`, `cutNodes()`, `pasteNodes()`, `cancelCut()` on TreeController. Cut nodes are visually dimmed. Supports auto-handle and manual (server-driven) paste modes.
-
-### v5.0.0-rc03
-
-- **Multi-select**: Ctrl+click toggles nodes, Shift+click selects ranges, plain click replaces selection. New `selectedPaths` bindable (`Set<string>`), `onSelectionChanged` event, and `rangeSelectionMode` prop (`'visual'` vs `'logical'`).
-- **Public multi-select API**: `selectNode(path, mode)`, `selectNodes(paths)`, `deselectAll()`, `getSelectedNodes()`, `isNodeSelected(path)` on TreeController.
-- **Selection-aware context menus**: `contextMenuCallback` now receives `selectedNodes` as 3rd parameter for bulk actions.
-
-### v5.0.0-rc03
-
-- **Unified Context Menu API**: New shared type system (`ContextMenuItem`, `ContextMenuDivider`, `ContextMenuEntry`) used by both svelte-treeview and canvas-tree. Breaking: `title` → `label`, `callback` → `onclick`, `isDivider` → separate `ContextMenuDivider` type.
-- **Context menu features**: Keyboard shortcuts, nested submenus, named dividers (`──── Section ────`), `isVisible`/`isDisabled` per item, `className="danger"`, async `onclick`.
-- **Svelte context menu components**: `ContextMenuItemC` and `ContextMenuDividerC` for declarative snippet-based menus alongside the callback approach.
-- **Accordion expand**: `accordionExpand={true}` — expanding a node auto-collapses its siblings.
-- **Toggle icon mode**: `toggleIconMode="rotate"` (default) smoothly rotates the expand icon vs `"swap"` which switches between two icons.
-- **Fix**: Expand/collapse icon not updating in flat rendering mode.
-- **Fix**: `vite.config.ts` no longer requires `@types/node`.
+## What's New in v5.0.0-rc08
+
+- **`{ silent: true }` on highlight/selection methods**: Update tree state from URL params or other external sources without firing `onNodeClick` / `onHighlightChange` / `onSelectionChange` — perfect for deep links where you don't want the change callback to re-trigger your form loader. Applies to `highlightNode`, `highlightNodes`, `clearHighlight`, and `deselectAll`.
+- **Array variants for expand/collapse**: `expandNodes`, `collapseNodes`, `expandAll`, and `collapseAll` now take `string | string[]`. Open or close several places in one call.
+- **Exclusive focus mode**: Pass `{ exclusive: true }` to `expandNodes` / `expandAll` to open the target path and collapse everything else in a single pass — no two-step flicker compared to `collapseAll() + expandNodes(path)`.
+- **`noEmit` option for batching**: Suppress the change emit on individual expand/collapse calls when chaining several operations; emit once at the end.
+
+## What's New in v5.0.0-rc07
+
+- **`isSelectedMember` prop**: Seed `selectedPaths` directly from your data — point the prop at a boolean field and every node where it's truthy lands pre-checked after `insertArray`.
+- **`isSelectableMember` fully wired through `Tree`**: The prop was already on the core types but wasn't reachable via the component. Now end-to-end usable to control checkbox rendering and clickability per node.
+- **Fix: filter race during async indexing**: `bind:searchText` no longer hides the entire tree if the FlexSearch index is still being built when the filter is applied. The filter now re-applies itself automatically once indexing completes, regardless of `indexerBatchSize` or dataset size.
 
 ## v5.0: Core/Renderer Split + Virtual Scroll
 

package/dist/components/Tree.svelte

@@ -31,6 +31,7 @@
 		parentPathMember?: string | null | undefined;
 		levelMember?: string | null | undefined;
 		isExpandedMember?: string | null | undefined;
+		isSelectableMember?: string | null | undefined;
 		isSelectedMember?: string | null | undefined;
 		isDraggableMember?: string | null | undefined;
 		getIsDraggableCallback?: (node: LTreeNode<T>) => boolean;
@@ -184,6 +185,7 @@
 		hasChildrenMember,
 
 		isExpandedMember,
+		isSelectableMember,
 		isSelectedMember,
 		isDraggableMember,
 		getIsDraggableCallback,
@@ -304,6 +306,7 @@
 		levelMember,
 		hasChildrenMember,
 		isExpandedMember,
+		isSelectableMember,
 		isSelectedMember,
 		isDraggableMember,
 		getIsDraggableCallback,
@@ -504,20 +507,32 @@
 	);
 
 	// ── Export public methods (thin proxies) ────────────────────────────
-	export async function expandNodes(nodePath: string) {
-		controller.expandNodes(nodePath);
+	export async function expandNodes(
+		nodePath: string | string[],
+		options?: { exclusive?: boolean; noEmit?: boolean }
+	) {
+		controller.expandNodes(nodePath, options);
 	}
 
-	export async function collapseNodes(nodePath: string) {
-		controller.collapseNodes(nodePath);
+	export async function collapseNodes(
+		nodePath: string | string[],
+		options?: { noEmit?: boolean }
+	) {
+		controller.collapseNodes(nodePath, options);
 	}
 
-	export function expandAll(nodePath?: string | null | undefined) {
-		controller.expandAll(nodePath);
+	export function expandAll(
+		nodePath?: string | string[] | null | undefined,
+		options?: { exclusive?: boolean; noEmit?: boolean }
+	) {
+		controller.expandAll(nodePath, options);
 	}
 
-	export function collapseAll(nodePath?: string | null | undefined) {
-		controller.collapseAll(nodePath);
+	export function collapseAll(
+		nodePath?: string | string[] | null | undefined,
+		options?: { noEmit?: boolean }
+	) {
+		controller.collapseAll(nodePath, options);
 	}
 
 	export function filterNodes(searchTextVal: string, searchOptions?: SearchOptions): void {
@@ -610,16 +625,28 @@
 	}
 
 	// Multi-select methods
-	export function selectNode(path: string, mode: 'replace' | 'toggle' | 'range' = 'replace') {
-		controller.selectNode(path, mode);
+	export function selectNode(path: string, mode: 'replace' | 'toggle' | 'range' = 'replace', options?: { silent?: boolean }) {
+		controller.selectNode(path, mode, options);
+	}
+
+	export function selectNodes(paths: string[], options?: { silent?: boolean }) {
+		controller.selectNodes(paths, options);
+	}
+
+	export function highlightNode(path: string, mode: 'replace' | 'toggle' | 'range' = 'replace', options?: { silent?: boolean }) {
+		controller.highlightNode(path, mode, options);
+	}
+
+	export function highlightNodes(paths: string[], options?: { silent?: boolean }) {
+		controller.highlightNodes(paths, options);
 	}
 
-	export function selectNodes(paths: string[]) {
-		controller.selectNodes(paths);
+	export function clearHighlight(options?: { silent?: boolean }) {
+		controller.clearHighlight(options);
 	}
 
-	export function deselectAll() {
-		controller.deselectAll();
+	export function deselectAll(options?: { silent?: boolean }) {
+		controller.deselectAll(options);
 	}
 
 	export function getSelectedNodes(): LTreeNode<T>[] {
@@ -656,6 +683,7 @@
 				| "levelMember"
 				| "hasChildrenMember"
 				| "isExpandedMember"
+				| "isSelectableMember"
 				| "isSelectedMember"
 				| "isDraggableMember"
 				| "getIsDraggableCallback"
@@ -728,6 +756,7 @@
 		if (updates.levelMember !== undefined) levelMember = updates.levelMember;
 		if (updates.hasChildrenMember !== undefined) hasChildrenMember = updates.hasChildrenMember;
 		if (updates.isExpandedMember !== undefined) isExpandedMember = updates.isExpandedMember;
+		if (updates.isSelectableMember !== undefined) isSelectableMember = updates.isSelectableMember;
 		if (updates.isSelectedMember !== undefined) isSelectedMember = updates.isSelectedMember;
 		if (updates.isDraggableMember !== undefined) isDraggableMember = updates.isDraggableMember;
 		if (updates.getIsDraggableCallback !== undefined) getIsDraggableCallback = updates.getIsDraggableCallback;

package/dist/components/Tree.svelte.d.ts

@@ -11,6 +11,7 @@ declare function $$render<T>(): {
         parentPathMember?: string | null | undefined;
         levelMember?: string | null | undefined;
         isExpandedMember?: string | null | undefined;
+        isSelectableMember?: string | null | undefined;
         isSelectedMember?: string | null | undefined;
         isDraggableMember?: string | null | undefined;
         getIsDraggableCallback?: (node: LTreeNode<T>) => boolean;
@@ -133,10 +134,20 @@ declare function $$render<T>(): {
         navigationOverrides?: TreeNavigationOverrides<T>;
     };
     exports: {
-        expandNodes: (nodePath: string) => Promise<void>;
-        collapseNodes: (nodePath: string) => Promise<void>;
-        expandAll: (nodePath?: string | null | undefined) => void;
-        collapseAll: (nodePath?: string | null | undefined) => void;
+        expandNodes: (nodePath: string | string[], options?: {
+            exclusive?: boolean;
+            noEmit?: boolean;
+        }) => Promise<void>;
+        collapseNodes: (nodePath: string | string[], options?: {
+            noEmit?: boolean;
+        }) => Promise<void>;
+        expandAll: (nodePath?: string | string[] | null | undefined, options?: {
+            exclusive?: boolean;
+            noEmit?: boolean;
+        }) => void;
+        collapseAll: (nodePath?: string | string[] | null | undefined, options?: {
+            noEmit?: boolean;
+        }) => void;
         filterNodes: (searchTextVal: string, searchOptions?: SearchOptions) => void;
         searchNodes: (searchTextVal: string | null | undefined, searchOptions?: SearchOptions) => LTreeNode<T>[];
         getChildren: (parentPath: string) => LTreeNode<T>[];
@@ -177,9 +188,24 @@ declare function $$render<T>(): {
         setExpandedPaths: (paths: string[]) => void;
         getAllData: () => T[];
         closeContextMenu: () => void;
-        selectNode: (path: string, mode?: "replace" | "toggle" | "range") => void;
-        selectNodes: (paths: string[]) => void;
-        deselectAll: () => void;
+        selectNode: (path: string, mode?: "replace" | "toggle" | "range", options?: {
+            silent?: boolean;
+        }) => void;
+        selectNodes: (paths: string[], options?: {
+            silent?: boolean;
+        }) => void;
+        highlightNode: (path: string, mode?: "replace" | "toggle" | "range", options?: {
+            silent?: boolean;
+        }) => void;
+        highlightNodes: (paths: string[], options?: {
+            silent?: boolean;
+        }) => void;
+        clearHighlight: (options?: {
+            silent?: boolean;
+        }) => void;
+        deselectAll: (options?: {
+            silent?: boolean;
+        }) => void;
         getSelectedNodes: () => LTreeNode<T>[];
         isNodeSelected: (path: string) => boolean;
         scrollToPath: (path: string, options?: {
@@ -195,6 +221,7 @@ declare function $$render<T>(): {
             parentPathMember?: string | null | undefined;
             levelMember?: string | null | undefined;
             isExpandedMember?: string | null | undefined;
+            isSelectableMember?: string | null | undefined;
             isSelectedMember?: string | null | undefined;
             isDraggableMember?: string | null | undefined;
             getIsDraggableCallback?: (node: LTreeNode<T>) => boolean;
@@ -315,7 +342,7 @@ declare function $$render<T>(): {
             onTreeKeydown?: (event: KeyboardEvent, controller: TreeController<T>) => boolean | void;
             /** Override individual navigation methods (e.g. for custom ArrowDown/Up behavior) */
             navigationOverrides?: TreeNavigationOverrides<T>;
-        }, "treeId" | "treePathSeparator" | "idMember" | "pathMember" | "parentPathMember" | "levelMember" | "hasChildrenMember" | "isExpandedMember" | "isSelectedMember" | "isDraggableMember" | "getIsDraggableCallback" | "isDropAllowedMember" | "displayValueMember" | "getDisplayValueCallback" | "searchValueMember" | "getSearchValueCallback" | "isCollapsibleMember" | "getIsCollapsibleCallback" | "orderMember" | "isSorted" | "sortCallback" | "data" | "focusedNode" | "highlightedPaths" | "selectedPaths" | "expandLevel" | "clickBehavior" | "showCheckboxes" | "checkboxMode" | "beforeCheckboxToggleCallback" | "rangeSelectionMode" | "shouldUseInternalSearchIndex" | "initializeIndexCallback" | "searchText" | "indexerBatchSize" | "indexerTimeout" | "shouldDisplayDebugInformation" | "shouldDisplayContextMenuInDebugMode" | "onNodeClick" | "onHighlightChange" | "onSelectionChange" | "onNodeDragStart" | "onNodeDragOver" | "onNodeDrop" | "beforeDropCallback" | "beforeCopyCallback" | "beforeCutCallback" | "beforePasteCallback" | "getContextMenuItemsCallback" | "virtualScroll" | "virtualRowHeight" | "virtualOverscan" | "virtualContainerHeight" | "dragDropMode" | "dropZoneMode" | "bodyClass" | "expandIconClass" | "collapseIconClass" | "leafIconClass" | "toggleIconMode" | "highlightedNodeClass" | "focusedNodeClass" | "dragOverNodeClass" | "scrollHighlightTimeout" | "scrollHighlightClass" | "contextMenuXOffset" | "contextMenuYOffset" | "accordionExpand">>) => void;
+        }, "treeId" | "treePathSeparator" | "idMember" | "pathMember" | "parentPathMember" | "levelMember" | "hasChildrenMember" | "isExpandedMember" | "isSelectableMember" | "isSelectedMember" | "isDraggableMember" | "getIsDraggableCallback" | "isDropAllowedMember" | "displayValueMember" | "getDisplayValueCallback" | "searchValueMember" | "getSearchValueCallback" | "isCollapsibleMember" | "getIsCollapsibleCallback" | "orderMember" | "isSorted" | "sortCallback" | "data" | "focusedNode" | "highlightedPaths" | "selectedPaths" | "expandLevel" | "clickBehavior" | "showCheckboxes" | "checkboxMode" | "beforeCheckboxToggleCallback" | "rangeSelectionMode" | "shouldUseInternalSearchIndex" | "initializeIndexCallback" | "searchText" | "indexerBatchSize" | "indexerTimeout" | "shouldDisplayDebugInformation" | "shouldDisplayContextMenuInDebugMode" | "onNodeClick" | "onHighlightChange" | "onSelectionChange" | "onNodeDragStart" | "onNodeDragOver" | "onNodeDrop" | "beforeDropCallback" | "beforeCopyCallback" | "beforeCutCallback" | "beforePasteCallback" | "getContextMenuItemsCallback" | "virtualScroll" | "virtualRowHeight" | "virtualOverscan" | "virtualContainerHeight" | "dragDropMode" | "dropZoneMode" | "bodyClass" | "expandIconClass" | "collapseIconClass" | "leafIconClass" | "toggleIconMode" | "highlightedNodeClass" | "focusedNodeClass" | "dragOverNodeClass" | "scrollHighlightTimeout" | "scrollHighlightClass" | "contextMenuXOffset" | "contextMenuYOffset" | "accordionExpand">>) => void;
     };
     bindings: "data" | "focusedNode" | "highlightedPaths" | "selectedPaths" | "searchText" | "insertResult" | "isRendering";
     slots: {};
@@ -327,10 +354,20 @@ declare class __sveltets_Render<T> {
     slots(): ReturnType<typeof $$render<T>>['slots'];
     bindings(): "data" | "focusedNode" | "highlightedPaths" | "selectedPaths" | "searchText" | "insertResult" | "isRendering";
     exports(): {
-        expandNodes: (nodePath: string) => Promise<void>;
-        collapseNodes: (nodePath: string) => Promise<void>;
-        expandAll: (nodePath?: string | null | undefined) => void;
-        collapseAll: (nodePath?: string | null | undefined) => void;
+        expandNodes: (nodePath: string | string[], options?: {
+            exclusive?: boolean;
+            noEmit?: boolean;
+        } | undefined) => Promise<void>;
+        collapseNodes: (nodePath: string | string[], options?: {
+            noEmit?: boolean;
+        } | undefined) => Promise<void>;
+        expandAll: (nodePath?: string | string[] | null | undefined, options?: {
+            exclusive?: boolean;
+            noEmit?: boolean;
+        } | undefined) => void;
+        collapseAll: (nodePath?: string | string[] | null | undefined, options?: {
+            noEmit?: boolean;
+        } | undefined) => void;
         filterNodes: (searchTextVal: string, searchOptions?: SearchOptions) => void;
         searchNodes: (searchTextVal: string | null | undefined, searchOptions?: SearchOptions) => LTreeNode<T>[];
         getChildren: (parentPath: string) => LTreeNode<T>[];
@@ -371,9 +408,24 @@ declare class __sveltets_Render<T> {
         setExpandedPaths: (paths: string[]) => void;
         getAllData: () => T[];
         closeContextMenu: () => void;
-        selectNode: (path: string, mode?: "replace" | "toggle" | "range") => void;
-        selectNodes: (paths: string[]) => void;
-        deselectAll: () => void;
+        selectNode: (path: string, mode?: "replace" | "toggle" | "range", options?: {
+            silent?: boolean;
+        } | undefined) => void;
+        selectNodes: (paths: string[], options?: {
+            silent?: boolean;
+        } | undefined) => void;
+        highlightNode: (path: string, mode?: "replace" | "toggle" | "range", options?: {
+            silent?: boolean;
+        } | undefined) => void;
+        highlightNodes: (paths: string[], options?: {
+            silent?: boolean;
+        } | undefined) => void;
+        clearHighlight: (options?: {
+            silent?: boolean;
+        } | undefined) => void;
+        deselectAll: (options?: {
+            silent?: boolean;
+        } | undefined) => void;
         getSelectedNodes: () => LTreeNode<T>[];
         isNodeSelected: (path: string) => boolean;
         scrollToPath: (path: string, options?: {
@@ -389,6 +441,7 @@ declare class __sveltets_Render<T> {
             parentPathMember?: string | null | undefined;
             levelMember?: string | null | undefined;
             isExpandedMember?: string | null | undefined;
+            isSelectableMember?: string | null | undefined;
             isSelectedMember?: string | null | undefined;
             isDraggableMember?: string | null | undefined;
             getIsDraggableCallback?: ((node: LTreeNode<T>) => boolean) | undefined;
@@ -509,7 +562,7 @@ declare class __sveltets_Render<T> {
             onTreeKeydown?: ((event: KeyboardEvent, controller: TreeController<T>) => boolean | void) | undefined;
             /** Override individual navigation methods (e.g. for custom ArrowDown/Up behavior) */
             navigationOverrides?: Partial<import("../core/navigation.js").TreeNavigation<T>> | undefined;
-        }, "treeId" | "data" | "treePathSeparator" | "idMember" | "pathMember" | "parentPathMember" | "levelMember" | "hasChildrenMember" | "isExpandedMember" | "displayValueMember" | "getDisplayValueCallback" | "searchValueMember" | "getSearchValueCallback" | "orderMember" | "isSorted" | "sortCallback" | "isDraggableMember" | "getIsDraggableCallback" | "isDropAllowedMember" | "isCollapsibleMember" | "getIsCollapsibleCallback" | "shouldDisplayDebugInformation" | "onNodeDrop" | "beforeDropCallback" | "beforeCopyCallback" | "beforeCutCallback" | "beforePasteCallback" | "beforeCheckboxToggleCallback" | "getContextMenuItemsCallback" | "isSelectedMember" | "focusedNode" | "highlightedPaths" | "selectedPaths" | "expandLevel" | "clickBehavior" | "showCheckboxes" | "checkboxMode" | "rangeSelectionMode" | "initializeIndexCallback" | "searchText" | "shouldUseInternalSearchIndex" | "indexerBatchSize" | "indexerTimeout" | "shouldDisplayContextMenuInDebugMode" | "virtualScroll" | "virtualRowHeight" | "virtualOverscan" | "virtualContainerHeight" | "dragDropMode" | "dropZoneMode" | "accordionExpand" | "onNodeClick" | "onNodeDragStart" | "onNodeDragOver" | "onHighlightChange" | "onSelectionChange" | "bodyClass" | "highlightedNodeClass" | "focusedNodeClass" | "dragOverNodeClass" | "expandIconClass" | "collapseIconClass" | "leafIconClass" | "toggleIconMode" | "scrollHighlightTimeout" | "scrollHighlightClass" | "contextMenuXOffset" | "contextMenuYOffset">>) => void;
+        }, "treeId" | "data" | "treePathSeparator" | "idMember" | "pathMember" | "parentPathMember" | "levelMember" | "hasChildrenMember" | "isExpandedMember" | "displayValueMember" | "getDisplayValueCallback" | "searchValueMember" | "getSearchValueCallback" | "orderMember" | "isSorted" | "sortCallback" | "isSelectableMember" | "isSelectedMember" | "isDraggableMember" | "getIsDraggableCallback" | "isDropAllowedMember" | "isCollapsibleMember" | "getIsCollapsibleCallback" | "shouldDisplayDebugInformation" | "onNodeDrop" | "beforeDropCallback" | "beforeCopyCallback" | "beforeCutCallback" | "beforePasteCallback" | "beforeCheckboxToggleCallback" | "getContextMenuItemsCallback" | "focusedNode" | "highlightedPaths" | "selectedPaths" | "expandLevel" | "clickBehavior" | "showCheckboxes" | "checkboxMode" | "rangeSelectionMode" | "initializeIndexCallback" | "searchText" | "shouldUseInternalSearchIndex" | "indexerBatchSize" | "indexerTimeout" | "shouldDisplayContextMenuInDebugMode" | "virtualScroll" | "virtualRowHeight" | "virtualOverscan" | "virtualContainerHeight" | "dragDropMode" | "dropZoneMode" | "accordionExpand" | "onNodeClick" | "onNodeDragStart" | "onNodeDragOver" | "onHighlightChange" | "onSelectionChange" | "bodyClass" | "highlightedNodeClass" | "focusedNodeClass" | "dragOverNodeClass" | "expandIconClass" | "collapseIconClass" | "leafIconClass" | "toggleIconMode" | "scrollHighlightTimeout" | "scrollHighlightClass" | "contextMenuXOffset" | "contextMenuYOffset">>) => void;
     };
 }
 interface $$IsomorphicComponent {

package/dist/constants.generated.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "5.0.0-rc06";
+export declare const VERSION = "5.0.0-rc08";
 export declare const PACKAGE_NAME = "@keenmate/svelte-treeview";
 export declare const AUTHOR = "KeenMate";
 export declare const LICENSE = "MIT";

package/dist/constants.generated.js

@@ -1,6 +1,6 @@
 // Auto-generated file - do not edit manually
 // Generated by scripts/generate-constants.js
-export const VERSION = "5.0.0-rc06";
+export const VERSION = "5.0.0-rc08";
 export const PACKAGE_NAME = "@keenmate/svelte-treeview";
 export const AUTHOR = "KeenMate";
 export const LICENSE = "MIT";

package/dist/core/TreeController.svelte.d.ts

@@ -56,6 +56,7 @@ export interface TreeControllerProps<T> {
     parentPathMember?: string | null | undefined;
     levelMember?: string | null | undefined;
     isExpandedMember?: string | null | undefined;
+    isSelectableMember?: string | null | undefined;
     isSelectedMember?: string | null | undefined;
     isDraggableMember?: string | null | undefined;
     getIsDraggableCallback?: (node: LTreeNode<T>) => boolean;
@@ -297,10 +298,20 @@ export declare class TreeController<T> {
     };
     constructor(props: TreeControllerProps<T>);
     handleVirtualScroll: (event: Event) => void;
-    expandNodes(nodePath: string): Promise<void>;
-    collapseNodes(nodePath: string): Promise<void>;
-    expandAll(nodePath?: string | null | undefined): void;
-    collapseAll(nodePath?: string | null | undefined): void;
+    expandNodes(nodePath: string | string[], options?: {
+        exclusive?: boolean;
+        noEmit?: boolean;
+    }): Promise<void>;
+    collapseNodes(nodePath: string | string[], options?: {
+        noEmit?: boolean;
+    }): Promise<void>;
+    expandAll(nodePath?: string | string[] | null | undefined, options?: {
+        exclusive?: boolean;
+        noEmit?: boolean;
+    }): void;
+    collapseAll(nodePath?: string | string[] | null | undefined, options?: {
+        noEmit?: boolean;
+    }): void;
     filterNodes(searchTextVal: string, searchOptions?: SearchOptions): void;
     searchNodes(searchTextVal: string | null | undefined, searchOptions?: SearchOptions): LTreeNode<T>[];
     getChildren(parentPath: string): LTreeNode<T>[];
@@ -440,12 +451,21 @@ export declare class TreeController<T> {
     /** Get ALL nodes between two paths (inclusive), in depth-first tree order.
      *  Includes collapsed/hidden nodes — "logical" range selection. */
     private _getAllNodesBetween;
-    /** Highlight a node with the given mode */
-    highlightNode(path: string, mode?: 'replace' | 'toggle' | 'range'): void;
-    /** Highlight multiple nodes by paths (replaces current highlights) */
-    highlightNodes(paths: string[]): void;
-    /** Clear all highlights */
-    clearHighlight(): void;
+    /** Highlight a node with the given mode.
+     *  Pass `{ silent: true }` to update state without firing `onNodeClick` / `onHighlightChange`
+     *  (useful when restoring state from URL params or other external sources). */
+    highlightNode(path: string, mode?: 'replace' | 'toggle' | 'range', options?: {
+        silent?: boolean;
+    }): void;
+    /** Highlight multiple nodes by paths (replaces current highlights).
+     *  Pass `{ silent: true }` to skip `onHighlightChange`. */
+    highlightNodes(paths: string[], options?: {
+        silent?: boolean;
+    }): void;
+    /** Clear all highlights. Pass `{ silent: true }` to skip `onHighlightChange`. */
+    clearHighlight(options?: {
+        silent?: boolean;
+    }): void;
     /** Get all highlighted nodes */
     getHighlightedNodes(): LTreeNode<T>[];
     /** Check if a specific node path is highlighted */
@@ -454,12 +474,18 @@ export declare class TreeController<T> {
     getSelectedNodes(): LTreeNode<T>[];
     /** Check if a specific node path is selected (checked) */
     isNodeSelected(path: string): boolean;
-    /** Clear all checkbox selections */
-    deselectAll(): void;
+    /** Clear all checkbox selections. Pass `{ silent: true }` to skip `onSelectionChange`. */
+    deselectAll(options?: {
+        silent?: boolean;
+    }): void;
     /** @deprecated Use highlightNode() instead */
-    selectNode(path: string, mode?: 'replace' | 'toggle' | 'range'): void;
+    selectNode(path: string, mode?: 'replace' | 'toggle' | 'range', options?: {
+        silent?: boolean;
+    }): void;
     /** @deprecated Use highlightNodes() instead */
-    selectNodes(paths: string[]): void;
+    selectNodes(paths: string[], options?: {
+        silent?: boolean;
+    }): void;
     private _onNodeRightClicked;
     private isDropAllowedByMode;
     private calculateDropPosition;

package/dist/core/TreeController.svelte.js

@@ -249,7 +249,7 @@ export class TreeController {
         this.onRenderCompleteHandler = props.onRenderComplete;
         // ── Create LTree ────────────────────────────────────────────────
         // svelte-ignore non_reactive_update
-        this.tree = createLTree(props.idMember, props.pathMember, props.parentPathMember, props.levelMember, props.hasChildrenMember, props.isExpandedMember, props.isSelectedMember, props.isDraggableMember, props.getIsDraggableCallback, props.isDropAllowedMember, props.allowedDropPositionsMember, props.displayValueMember, props.getDisplayValueCallback, props.searchValueMember, props.getSearchValueCallback, props.getAllowedDropPositionsCallback, props.isCollapsibleMember, props.getIsCollapsibleCallback, props.orderMember, this.treeId, this.treePathSeparator, props.expandLevel, props.shouldUseInternalSearchIndex, props.initializeIndexCallback, props.indexerBatchSize, props.indexerTimeout, {
+        this.tree = createLTree(props.idMember, props.pathMember, props.parentPathMember, props.levelMember, props.hasChildrenMember, props.isExpandedMember, props.isSelectableMember, props.isSelectedMember, props.isDraggableMember, props.getIsDraggableCallback, props.isDropAllowedMember, props.allowedDropPositionsMember, props.displayValueMember, props.getDisplayValueCallback, props.searchValueMember, props.getSearchValueCallback, props.getAllowedDropPositionsCallback, props.isCollapsibleMember, props.getIsCollapsibleCallback, props.orderMember, this.treeId, this.treePathSeparator, props.expandLevel, props.shouldUseInternalSearchIndex, props.initializeIndexCallback, props.indexerBatchSize, props.indexerTimeout, {
             shouldDisplayDebugInformation: props.shouldDisplayDebugInformation,
             isSorted: props.isSorted,
             sortCallback: props.sortCallback
@@ -352,6 +352,19 @@ export class TreeController {
                 this.vsMeasuredRowHeight = null;
                 this.vsDetectedHeight = null;
                 this.insertResult = this.tree.insertArray(this.data);
+                // Seed selectedPaths from node.isSelected flags written by insertArray
+                if (this.tree.isSelectedMember) {
+                    const seeded = new Set();
+                    const walk = (node) => {
+                        if (node.isSelected)
+                            seeded.add(node.path);
+                        for (const key in node.children)
+                            walk(node.children[key]);
+                    };
+                    for (const key in this.tree.root.children)
+                        walk(this.tree.root.children[key]);
+                    this.selectedPaths = seeded;
+                }
             }
         });
         // Progressive rendering for flat mode
@@ -497,17 +510,17 @@ export class TreeController {
         });
     };
     // ── Public API methods ──────────────────────────────────────────────
-    async expandNodes(nodePath) {
-        this.tree.expandNodes(nodePath);
+    async expandNodes(nodePath, options) {
+        this.tree.expandNodes(nodePath, options);
     }
-    async collapseNodes(nodePath) {
-        this.tree.collapseNodes(nodePath);
+    async collapseNodes(nodePath, options) {
+        this.tree.collapseNodes(nodePath, options);
     }
-    expandAll(nodePath) {
-        this.tree?.expandAll(nodePath);
+    expandAll(nodePath, options) {
+        this.tree?.expandAll(nodePath, options);
     }
-    collapseAll(nodePath) {
-        this.tree?.collapseAll(nodePath);
+    collapseAll(nodePath, options) {
+        this.tree?.collapseAll(nodePath, options);
     }
     filterNodes(searchTextVal, searchOptions) {
         this.tree?.filterNodes(searchTextVal, searchOptions);
@@ -1314,12 +1327,13 @@ export class TreeController {
             this.onSelectionChangeHandler = updates.onSelectionChange;
     }
     // ── Internal event handlers ─────────────────────────────────────────
-    async _onNodeClicked(node, modifiers) {
+    async _onNodeClicked(node, modifiers, options) {
         if (this.contextMenuVisible) {
             this.closeContextMenu();
         }
         const ctrl = modifiers?.ctrl ?? false;
         const shift = modifiers?.shift ?? false;
+        const silent = options?.silent ?? false;
         uiLogger.debug(`[highlight] Click on ${node.path}`, { ctrl, shift, lastAnchor: this.lastHighlightedPath, prevCount: this.highlightedPaths.size });
         if (ctrl) {
             // Toggle this node in/out of highlight
@@ -1365,11 +1379,17 @@ export class TreeController {
         }
         // Update focus
         this._setFocusedNode(node);
-        this.onNodeClickHandler?.(node);
-        this._notifyHighlightChanged();
+        if (!silent) {
+            this.onNodeClickHandler?.(node);
+            this._notifyHighlightChanged();
+        }
         this.tree.refresh();
-        // Focus the tree container so keyboard navigation works after clicking a node
-        this.containerElement?.focus();
+        // Focus the tree container so keyboard navigation works after clicking a node.
+        // Skip in silent mode — programmatic highlight (e.g. from URL params) shouldn't
+        // steal focus from whatever the user is currently interacting with.
+        if (!silent) {
+            this.containerElement?.focus();
+        }
     }
     /** Get all descendant paths of a node (depth-first) */
     _getDescendantPaths(node) {
@@ -1635,23 +1655,26 @@ export class TreeController {
         return result;
     }
     // ── Public highlight methods (UI selection) ────────────────────────
-    /** Highlight a node with the given mode */
-    highlightNode(path, mode = 'replace') {
+    /** Highlight a node with the given mode.
+     *  Pass `{ silent: true }` to update state without firing `onNodeClick` / `onHighlightChange`
+     *  (useful when restoring state from URL params or other external sources). */
+    highlightNode(path, mode = 'replace', options) {
         const node = this.tree.getNodeByPath(path);
         if (!node)
             return;
         if (mode === 'toggle') {
-            this._onNodeClicked(node, { ctrl: true, shift: false });
+            this._onNodeClicked(node, { ctrl: true, shift: false }, options);
         }
         else if (mode === 'range') {
-            this._onNodeClicked(node, { ctrl: false, shift: true });
+            this._onNodeClicked(node, { ctrl: false, shift: true }, options);
         }
         else {
-            this._onNodeClicked(node);
+            this._onNodeClicked(node, undefined, options);
         }
     }
-    /** Highlight multiple nodes by paths (replaces current highlights) */
-    highlightNodes(paths) {
+    /** Highlight multiple nodes by paths (replaces current highlights).
+     *  Pass `{ silent: true }` to skip `onHighlightChange`. */
+    highlightNodes(paths, options) {
         this._clearAllHighlightFlags();
         const newPaths = new Set();
         let lastNode = null;
@@ -1669,15 +1692,17 @@ export class TreeController {
             this._setFocusedNode(lastNode);
             this.lastHighlightedPath = lastNode.path;
         }
-        this._notifyHighlightChanged();
+        if (!options?.silent)
+            this._notifyHighlightChanged();
         this.tree.refresh();
     }
-    /** Clear all highlights */
-    clearHighlight() {
+    /** Clear all highlights. Pass `{ silent: true }` to skip `onHighlightChange`. */
+    clearHighlight(options) {
         this._clearAllHighlightFlags();
         this.highlightedPaths = new Set();
         this.lastHighlightedPath = null;
-        this._notifyHighlightChanged();
+        if (!options?.silent)
+            this._notifyHighlightChanged();
         this.tree.refresh();
     }
     /** Get all highlighted nodes */
@@ -1709,20 +1734,21 @@ export class TreeController {
     isNodeSelected(path) {
         return this.selectedPaths.has(path);
     }
-    /** Clear all checkbox selections */
-    deselectAll() {
+    /** Clear all checkbox selections. Pass `{ silent: true }` to skip `onSelectionChange`. */
+    deselectAll(options) {
         this._clearAllSelectionFlags();
         this.selectedPaths = new Set();
-        this._notifySelectionChanged();
+        if (!options?.silent)
+            this._notifySelectionChanged();
         this.tree.refresh();
     }
     /** @deprecated Use highlightNode() instead */
-    selectNode(path, mode = 'replace') {
-        this.highlightNode(path, mode);
+    selectNode(path, mode = 'replace', options) {
+        this.highlightNode(path, mode, options);
     }
     /** @deprecated Use highlightNodes() instead */
-    selectNodes(paths) {
-        this.highlightNodes(paths);
+    selectNodes(paths, options) {
+        this.highlightNodes(paths, options);
     }
     _onNodeRightClicked(node, event) {
         if (!this.hasContextMenuSnippet && !this.getContextMenuItemsHandler) {

package/dist/ltree/ltree-node.svelte.d.ts

@@ -15,15 +15,10 @@ export interface LTreeNode<T> {
     children: Record<string, LTreeNode<T>>;
     hasChildren: boolean;
     data: T | null | undefined;
-    useCallback: boolean;
-    priority: number | null | undefined;
     isDraggable: boolean;
     isCollapsible: boolean;
     isDropAllowed: boolean;
     allowedDropPositions: DropPosition[] | null | undefined;
-    isInsertAllowed: boolean;
-    isNestAllowed: boolean;
-    isCheckboxVisible: boolean | null | undefined;
     visualState: VisualState;
     isExpanded: boolean;
     isFocused: boolean;

package/dist/ltree/ltree-node.svelte.js

@@ -15,15 +15,10 @@ export function createLTreeNode(data) {
         children: {},
         hasChildren: false,
         data: undefined,
-        useCallback: false,
-        priority: undefined,
         isDraggable: true,
         isCollapsible: true,
         isDropAllowed: true,
         allowedDropPositions: undefined,
-        isInsertAllowed: true,
-        isNestAllowed: true,
-        isCheckboxVisible: false,
         visualState: VisualState.notSelected,
         isExpanded: false,
         isFocused: false,

package/dist/ltree/ltree.svelte.d.ts

@@ -1,4 +1,4 @@
 import { Index } from 'flexsearch';
 import { type LTreeNode } from './ltree-node.svelte';
 import type { Ltree } from './types.js';
-export declare function createLTree<T>(_idMember: string, _pathMember: string, _parentPathMember?: string | null | undefined, _levelMember?: string | null | undefined, _hasChildrenMember?: string | null | undefined, _isExpandedMember?: string | null | undefined, _isSelectableMember?: string | null | undefined, _isDraggableMember?: string | null | undefined, _getIsDraggableCallback?: (node: LTreeNode<T>) => boolean, _isDropAllowedMember?: string | null | undefined, _allowedDropPositionsMember?: string | null | undefined, _displayValueMember?: string | null | undefined, _getDisplayValueCallback?: (node: LTreeNode<T>) => string, _searchValueMember?: string | null | undefined, _getSearchValueCallback?: (node: LTreeNode<T>) => string, _getAllowedDropPositionsCallback?: (node: LTreeNode<T>) => import('./types.js').DropPosition[] | null | undefined, _isCollapsibleMember?: string | null | undefined, _getIsCollapsibleCallback?: (node: LTreeNode<T>) => boolean, _orderMember?: string | null | undefined, _treeId?: string, _treePathSeparator?: string | null | undefined, _expandLevel?: number | null | undefined, _shouldUseInternalSearchIndex?: boolean | null | undefined, _initializeIndexCallback?: () => Index, _indexerBatchSize?: number | null | undefined, _indexerTimeout?: number | null | undefined, opts?: Partial<Ltree<T>>): Ltree<T>;
+export declare function createLTree<T>(_idMember: string, _pathMember: string, _parentPathMember?: string | null | undefined, _levelMember?: string | null | undefined, _hasChildrenMember?: string | null | undefined, _isExpandedMember?: string | null | undefined, _isSelectableMember?: string | null | undefined, _isSelectedMember?: string | null | undefined, _isDraggableMember?: string | null | undefined, _getIsDraggableCallback?: (node: LTreeNode<T>) => boolean, _isDropAllowedMember?: string | null | undefined, _allowedDropPositionsMember?: string | null | undefined, _displayValueMember?: string | null | undefined, _getDisplayValueCallback?: (node: LTreeNode<T>) => string, _searchValueMember?: string | null | undefined, _getSearchValueCallback?: (node: LTreeNode<T>) => string, _getAllowedDropPositionsCallback?: (node: LTreeNode<T>) => import('./types.js').DropPosition[] | null | undefined, _isCollapsibleMember?: string | null | undefined, _getIsCollapsibleCallback?: (node: LTreeNode<T>) => boolean, _orderMember?: string | null | undefined, _treeId?: string, _treePathSeparator?: string | null | undefined, _expandLevel?: number | null | undefined, _shouldUseInternalSearchIndex?: boolean | null | undefined, _initializeIndexCallback?: () => Index, _indexerBatchSize?: number | null | undefined, _indexerTimeout?: number | null | undefined, opts?: Partial<Ltree<T>>): Ltree<T>;

package/dist/ltree/ltree.svelte.js

@@ -9,12 +9,13 @@ import { perfStart, perfEnd, perfSummary } from '../perf-logger.js';
 function getField(item, member) {
     return item[member];
 }
-export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMember, _hasChildrenMember, _isExpandedMember, _isSelectableMember, _isDraggableMember, _getIsDraggableCallback, _isDropAllowedMember, _allowedDropPositionsMember, _displayValueMember, _getDisplayValueCallback, _searchValueMember, _getSearchValueCallback, _getAllowedDropPositionsCallback, _isCollapsibleMember, _getIsCollapsibleCallback, _orderMember, _treeId, _treePathSeparator, _expandLevel, _shouldUseInternalSearchIndex, _initializeIndexCallback, _indexerBatchSize, _indexerTimeout, opts) {
+export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMember, _hasChildrenMember, _isExpandedMember, _isSelectableMember, _isSelectedMember, _isDraggableMember, _getIsDraggableCallback, _isDropAllowedMember, _allowedDropPositionsMember, _displayValueMember, _getDisplayValueCallback, _searchValueMember, _getSearchValueCallback, _getAllowedDropPositionsCallback, _isCollapsibleMember, _getIsCollapsibleCallback, _orderMember, _treeId, _treePathSeparator, _expandLevel, _shouldUseInternalSearchIndex, _initializeIndexCallback, _indexerBatchSize, _indexerTimeout, opts) {
     let shouldCalculateParentPath = isEmptyString(_parentPathMember);
     let shouldCalculateLevel = isEmptyString(_levelMember);
     let shouldCalculateHasChildren = isEmptyString(_hasChildrenMember);
     let shouldCalculateIsExpanded = isEmptyString(_isExpandedMember);
     let shouldCalculateIsSelectable = isEmptyString(_isSelectableMember);
+    let shouldCalculateIsSelected = isEmptyString(_isSelectedMember);
     let shouldCalculateIsDraggable = isEmptyString(_isDraggableMember);
     let shouldCalculateIsDropAllowed = isEmptyString(_isDropAllowedMember);
     let shouldCalculateAllowedDropPositions = isEmptyString(_allowedDropPositionsMember);
@@ -31,7 +32,6 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
     if (_shouldUseInternalSearchIndex)
         searchIndex = _initializeIndexCallback ? _initializeIndexCallback() : createSearchIndex();
     let changeTracker = $state(Symbol());
-    let size = 0;
     let nodeCount = 0;
     let maxLevel = 0;
     let flatTreeNodes = [];
@@ -42,6 +42,13 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
     let cachedVisibleFlatNodesTracker = null;
     // Async search indexing infrastructure
     let indexer = null;
+    // Last search text passed to filterNodes. The FlexSearch index is built
+    // asynchronously via the Indexer, so a filter applied while the index is
+    // still warming up returns 0 matches and hides the entire tree. We track
+    // the active query here and re-apply it from the indexer's onComplete
+    // callback so the visible filter eventually reflects the final index.
+    let _lastFilterSearchText = null;
+    let _lastFilterSearchOptions = undefined;
     // Initialize indexer when search index is available
     if (_shouldUseInternalSearchIndex && searchIndex) {
         indexer = new Indexer(_treeId || 'unknown', searchIndex, shouldCalculateSearchValue, _searchValueMember, _getSearchValueCallback, _indexerBatchSize || 25, // batch size with fallback
@@ -62,6 +69,7 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
         levelMember: _levelMember,
         isExpandedMember: _isExpandedMember,
         isSelectableMember: _isSelectableMember,
+        isSelectedMember: _isSelectedMember,
         isDraggableMember: _isDraggableMember,
         getIsDraggableCallback: _getIsDraggableCallback,
         isDropAllowedMember: _isDropAllowedMember,
@@ -104,7 +112,6 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
             const _tracker = changeTracker;
             // Return cached result if changeTracker hasn't changed
             if (_tracker === cachedVisibleFlatNodesTracker && cachedVisibleFlatNodes.length > 0) {
-                // console.log(`[visibleFlatNodes] Cache HIT - returning ${cachedVisibleFlatNodes.length} nodes`);
                 return cachedVisibleFlatNodes;
             }
             const computeStart = performance.now();
@@ -192,6 +199,8 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
                     node.isExpanded = (node.level ?? 0) <= _expandLevel;
                 if (!shouldCalculateIsSelectable)
                     node.isSelectable = getField(row, _isSelectableMember);
+                if (!shouldCalculateIsSelected)
+                    node.isSelected = getField(row, _isSelectedMember);
                 if (!shouldCalculateIsDraggable)
                     node.isDraggable = getField(row, _isDraggableMember);
                 if (!shouldCalculateIsCollapsible)
@@ -270,7 +279,14 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
             if (itemsToIndex.length > 0 && indexer) {
                 indexer.setCallbacks(undefined, // no progress callback for now
                 () => {
-                    // Completion callback - refresh tree when indexing is done
+                    // Completion callback. Re-apply any active filter before
+                    // emitting — a filterNodes() call that landed while indexing
+                    // was still in flight saw an incomplete index, so the visible
+                    // tree may be missing matching paths until we refresh.
+                    if (!isEmptyString(_lastFilterSearchText)) {
+                        // isEmptyString guarantees non-empty string here.
+                        this.filterNodes(_lastFilterSearchText, _lastFilterSearchOptions);
+                    }
                     if (!noEmitChanges) {
                         this._emitTreeChanged();
                     }
@@ -318,6 +334,12 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
             return null;
         },
         filterNodes(_searchText, _searchOptions) {
+            // Remember the active query so the indexer's onComplete callback can
+            // re-apply it once the FlexSearch index has finished warming up —
+            // otherwise a filter typed while indexing is still in flight hides
+            // the entire tree and never recovers.
+            _lastFilterSearchText = _searchText;
+            _lastFilterSearchOptions = _searchOptions;
             if (isEmptyString(_searchText)) {
                 // Clear filter when search is empty
                 filteredRoot.children = {};
@@ -349,7 +371,6 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
             perfStart(`[${_treeId}] createFilteredTree`);
             filteredRoot.children = {};
             filteredTree = null;
-            // isFiltered = false;
             // 1. Expand all target paths to include their parents
             const allRequiredPaths = new Set();
             targetPaths.forEach((path) => {
@@ -416,28 +437,89 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
             this.isFiltered = false;
             this._emitTreeChanged();
         },
-        expandAll(nodePath) {
+        expandAll(nodePath, options) {
             perfStart(`[${_treeId}] expandAll`);
+            const self = this;
+            const exclusive = options?.exclusive ?? false;
+            const noEmit = options?.noEmit ?? false;
             function setExpandedRecursive(node, value) {
                 node.isExpanded = value;
                 for (const key in node.children) {
                     setExpandedRecursive(node.children[key], value);
                 }
             }
-            if (isEmptyString(nodePath)) {
+            const paths = Array.isArray(nodePath)
+                ? nodePath.filter((p) => !isEmptyString(p))
+                : isEmptyString(nodePath)
+                    ? []
+                    : [nodePath];
+            if (paths.length === 0) {
+                // Whole-tree expand. exclusive has no meaning (nothing to exclude from).
                 setExpandedRecursive(root, true);
             }
             else {
-                const target = this.getNodeByPath(nodePath);
-                if (target)
-                    setExpandedRecursive(target, true);
+                if (exclusive) {
+                    // Build spine: every ancestor path of every target must stay expanded
+                    // so the target subtree is reachable.
+                    const spineSet = new Set();
+                    for (const p of paths) {
+                        const segs = p.split(this.treePathSeparator);
+                        for (let i = 0; i < segs.length; i++) {
+                            spineSet.add(segs.slice(0, i + 1).join(this.treePathSeparator));
+                        }
+                    }
+                    const isUnderTarget = (path) => {
+                        for (const tp of paths) {
+                            if (path === tp || path.startsWith(tp + this.treePathSeparator))
+                                return true;
+                        }
+                        return false;
+                    };
+                    // Walk currently-expanded subtree; collapse anything not on a spine
+                    // and not under a target. Only descends into expanded branches.
+                    const trim = (node) => {
+                        for (const key in node.children) {
+                            const child = node.children[key];
+                            if (!child.isExpanded)
+                                continue;
+                            if (spineSet.has(child.path) || isUnderTarget(child.path)) {
+                                trim(child);
+                            }
+                            else if (self.getNodeIsCollapsible(child)) {
+                                child.isExpanded = false;
+                                trim(child);
+                            }
+                        }
+                    };
+                    trim(root);
+                }
+                // Expand spine + entire subtree under each target.
+                for (const p of paths) {
+                    let node = root;
+                    const segments = p.split(this.treePathSeparator);
+                    for (let i = 0; i < segments.length; i++) {
+                        const segment = segmentPrefix + segments[i];
+                        if (node && node.children.hasOwnProperty(segment)) {
+                            node = node.children[segment];
+                            node.isExpanded = true;
+                        }
+                        else {
+                            node = undefined;
+                            break;
+                        }
+                    }
+                    if (node)
+                        setExpandedRecursive(node, true);
+                }
             }
-            this._emitTreeChanged();
+            if (!noEmit)
+                this._emitTreeChanged();
             perfEnd(`[${_treeId}] expandAll`);
         },
-        collapseAll(nodePath) {
+        collapseAll(nodePath, options) {
             perfStart(`[${_treeId}] collapseAll`);
             const self = this;
+            const noEmit = options?.noEmit ?? false;
             function collapseRecursive(node) {
                 if (node.isExpanded && self.getNodeIsCollapsible(node)) {
                     node.isExpanded = false;
@@ -446,15 +528,23 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
                     collapseRecursive(node.children[key]);
                 }
             }
-            if (isEmptyString(nodePath)) {
+            const paths = Array.isArray(nodePath)
+                ? nodePath.filter((p) => !isEmptyString(p))
+                : isEmptyString(nodePath)
+                    ? []
+                    : [nodePath];
+            if (paths.length === 0) {
                 collapseRecursive(root);
             }
             else {
-                const target = this.getNodeByPath(nodePath);
-                if (target)
-                    collapseRecursive(target);
+                for (const p of paths) {
+                    const target = this.getNodeByPath(p);
+                    if (target)
+                        collapseRecursive(target);
+                }
             }
-            this._emitTreeChanged();
+            if (!noEmit)
+                this._emitTreeChanged();
             perfEnd(`[${_treeId}] collapseAll`);
         },
         insert: function (path, data, noEmitChanges = false) {
@@ -467,59 +557,97 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
                 }
                 node = node.children[segment];
             }
-            // Mark as end of path and store data
-            if (node.hasChildren) {
-                size++;
-            }
             node.hasChildren = true;
             node.data = data;
             if (!noEmitChanges) {
                 this._emitTreeChanged();
             }
         },
-        expandNodes: function (path, noEmitChanges = false) {
+        expandNodes: function (path, options) {
             perfStart(`[${_treeId}] expandNodes`);
-            let node = this.isFiltered ? filteredRoot : root;
+            const self = this;
+            const exclusive = options?.exclusive ?? false;
+            const noEmit = options?.noEmit ?? false;
+            const rootNode = this.isFiltered ? filteredRoot : root;
+            const paths = Array.isArray(path) ? path : [path];
             let hasChanges = false;
-            const segments = path.split(this.treePathSeparator);
-            for (let i = 0; i < segments.length; i++) {
-                const segment = segmentPrefix + segments[i];
-                if (node.children.hasOwnProperty(segment)) {
-                    node = node.children[segment];
-                    // Only mark as changed if actually changing from collapsed to expanded
-                    if (!node.isExpanded) {
-                        node.isExpanded = true;
-                        hasChanges = true;
+            if (exclusive) {
+                // Build spine set: union of every ancestor path across all inputs.
+                const spineSet = new Set();
+                for (const p of paths) {
+                    const segs = p.split(this.treePathSeparator);
+                    for (let i = 0; i < segs.length; i++) {
+                        spineSet.add(segs.slice(0, i + 1).join(this.treePathSeparator));
+                    }
+                }
+                // Walk currently-expanded subtree, collapse anything off-spine.
+                const trim = (node) => {
+                    for (const key in node.children) {
+                        const child = node.children[key];
+                        if (!child.isExpanded)
+                            continue;
+                        if (spineSet.has(child.path)) {
+                            trim(child);
+                        }
+                        else if (self.getNodeIsCollapsible(child)) {
+                            child.isExpanded = false;
+                            hasChanges = true;
+                            trim(child);
+                        }
+                    }
+                };
+                trim(rootNode);
+            }
+            for (const p of paths) {
+                let node = rootNode;
+                const segments = p.split(this.treePathSeparator);
+                for (let i = 0; i < segments.length; i++) {
+                    const segment = segmentPrefix + segments[i];
+                    if (node && node.children.hasOwnProperty(segment)) {
+                        node = node.children[segment];
+                        if (!node.isExpanded) {
+                            node.isExpanded = true;
+                            hasChanges = true;
+                        }
+                    }
+                    else {
+                        break;
                     }
                 }
             }
-            // Only emit changes if something actually changed
-            if (!noEmitChanges && hasChanges) {
+            if (!noEmit && hasChanges) {
                 this._emitTreeChanged();
             }
             perfEnd(`[${_treeId}] expandNodes`);
-            return this; // Return the API object for chaining
+            return this;
         },
-        collapseNodes: function (path, noEmitChanges = false) {
-            let node = this.isFiltered ? filteredRoot : this.root;
+        collapseNodes: function (path, options) {
+            const noEmit = options?.noEmit ?? false;
+            const rootNode = this.isFiltered ? filteredRoot : this.root;
+            const paths = Array.isArray(path) ? path : [path];
             let hasChanges = false;
-            const segments = path.split(this.treePathSeparator);
-            for (let i = 0; i < segments.length; i++) {
-                const segment = segmentPrefix + segments[i];
-                if (node.children.hasOwnProperty(segment)) {
-                    node = node.children[segment];
+            for (const p of paths) {
+                let node = rootNode;
+                const segments = p.split(this.treePathSeparator);
+                for (let i = 0; i < segments.length; i++) {
+                    const segment = segmentPrefix + segments[i];
+                    if (node && node.children.hasOwnProperty(segment)) {
+                        node = node.children[segment];
+                    }
+                    else {
+                        node = undefined;
+                        break;
+                    }
+                }
+                if (node && node.isExpanded) {
+                    node.isExpanded = false;
+                    hasChanges = true;
                 }
             }
-            // Only collapse the target node, not ancestors
-            if (node.isExpanded) {
-                node.isExpanded = false;
-                hasChanges = true;
-            }
-            // Only emit changes if something actually changed
-            if (!noEmitChanges && hasChanges) {
+            if (!noEmit && hasChanges) {
                 this._emitTreeChanged();
             }
-            return this; // Return the API object for chaining
+            return this;
         },
         // Private helper methods
         getNodeByPath: function (path, _root) {
@@ -1188,6 +1316,8 @@ export function createLTree(_idMember, _pathMember, _parentPathMember, _levelMem
                     node.isExpanded = (node.level ?? 0) <= _expandLevel;
                 if (!shouldCalculateIsSelectable)
                     node.isSelectable = getField(row, _isSelectableMember);
+                if (!shouldCalculateIsSelected)
+                    node.isSelected = getField(row, _isSelectedMember);
                 if (!shouldCalculateIsDraggable)
                     node.isDraggable = getField(row, _isDraggableMember);
                 if (!shouldCalculateIsCollapsible)

package/dist/ltree/types.d.ts

@@ -1,7 +1,6 @@
 import type { SearchOptions } from 'flexsearch';
 import type { LTreeNode, DropPosition } from './ltree-node.svelte.js';
 export type { LTreeNode, DropPosition } from './ltree-node.svelte.js';
-export type Tuple<T, U> = [T, U];
 export type DragDropMode = 'none' | 'self' | 'cross' | 'both';
 export type ToggleIconMode = 'rotate' | 'swap';
 export type ClickBehavior = 'select' | 'expand' | 'expand-and-focus';
@@ -87,10 +86,10 @@ export interface Ltree<T> {
     orderMember?: string | null | undefined;
     isSorted: boolean | null | undefined;
     sortCallback?: (items: LTreeNode<T>[]) => LTreeNode<T>[];
-    indexingCompleteCallback?: () => void;
     filteredTree: LTreeNode<T>[] | null;
     isFiltered: boolean;
     isSelectableMember: string | null | undefined;
+    isSelectedMember: string | null | undefined;
     isDraggableMember: string | null | undefined;
     getIsDraggableCallback?: (node: LTreeNode<T>) => boolean;
     isDropAllowedMember: string | null | undefined;
@@ -118,12 +117,22 @@ export interface Ltree<T> {
     searchNodes(_searchText: string | null | undefined, _searchOptions?: SearchOptions): LTreeNode<T>[];
     createFilteredTree(targetPaths: string[]): void;
     clearFilter(): void;
-    expandAll(nodePath?: string | null | undefined): void;
-    collapseAll(nodePath?: string | null | undefined): void;
+    expandAll(nodePath?: string | string[] | null | undefined, options?: {
+        exclusive?: boolean;
+        noEmit?: boolean;
+    }): void;
+    collapseAll(nodePath?: string | string[] | null | undefined, options?: {
+        noEmit?: boolean;
+    }): void;
     insert(path: string, data: T, noEmitChanges?: boolean): void;
     getNodeByPath(path: string, _root?: LTreeNode<T> | null | undefined): LTreeNode<T> | null;
-    expandNodes(path: string): Ltree<T>;
-    collapseNodes(path: string): Ltree<T>;
+    expandNodes(path: string | string[], options?: {
+        exclusive?: boolean;
+        noEmit?: boolean;
+    }): Ltree<T>;
+    collapseNodes(path: string | string[], options?: {
+        noEmit?: boolean;
+    }): Ltree<T>;
     getNodeDisplayValue(node: LTreeNode<T>): string;
     getNodeSearchValue(node: LTreeNode<T>): string;
     _defaultSort(self: Ltree<T>, items: LTreeNode<T>[]): LTreeNode<T>[];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@keenmate/svelte-treeview",
-	"version": "5.0.0-rc06",
+	"version": "5.0.0-rc08",
 	"scripts": {
 		"dev": "vite dev --port 17777",
 		"build": "vite build && npm run prepack",
@@ -13,6 +13,10 @@
 		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
 		"test": "vitest",
 		"test:run": "vitest run",
+		"test:e2e": "playwright test",
+		"test:e2e:ui": "playwright test --ui",
+		"test:e2e:headed": "playwright test --headed",
+		"test:e2e:install": "playwright install chromium",
 		"format": "prettier --write .",
 		"lint": "prettier --check . && eslint ."
 	},
@@ -45,6 +49,7 @@
 	"devDependencies": {
 		"@eslint/compat": "^1.2.5",
 		"@eslint/js": "^9.18.0",
+		"@playwright/test": "^1.59.1",
 		"@sveltejs/adapter-auto": "^6.0.0",
 		"@sveltejs/adapter-static": "^3.0.0",
 		"@sveltejs/kit": "^2.22.0",