wunderbaum 0.8.4 → 0.10.0

package/dist/wunderbaum.css

@@ -1,7 +1,7 @@
 @charset "UTF-8";
 /*!
  * Wunderbaum style sheet (generated from wunderbaum.scss)
- * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
+ * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
  * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
  */
 :root,
@@ -94,6 +94,8 @@ div.wunderbaum div.wb-header {
   position: sticky;
   top: 0;
   z-index: 2;
+  user-select: none;
+  -webkit-user-select: none; /* Safari */
 }
 div.wunderbaum div.wb-header,
 div.wunderbaum div.wb-list-container {
@@ -202,6 +204,10 @@ div.wunderbaum div.wb-header span.wb-col-resizer {
   border: none;
   border-right: 2px solid var(--wb-border-color);
   height: 100%;
+  user-select: none;
+  -webkit-user-select: none;
+}
+div.wunderbaum div.wb-header span.wb-col-resizer.wb-col-resizer-active {
   cursor: col-resize;
 }
 div.wunderbaum span.wb-col {
@@ -219,6 +225,7 @@ div.wunderbaum span.wb-col:last-of-type {
 }
 div.wunderbaum span.wb-node {
   user-select: none;
+  -webkit-user-select: none;
   /* Fix Bootstrap Icon alignment */
 }
 div.wunderbaum span.wb-node i.wb-checkbox,
@@ -333,6 +340,9 @@ div.wunderbaum.wb-ext-filter-dim div.wb-node-list div.wb-row.wb-submatch, div.wu
 div.wunderbaum.wb-ext-filter-dim div.wb-node-list div.wb-row.wb-match, div.wunderbaum.wb-ext-filter-hide div.wb-node-list div.wb-row.wb-match {
   color: var(--wb-node-text-color);
 }
+div.wunderbaum.wb-ext-filter-hide.wb-ext-filter-hide-expanders div.wb-node-list div.wb-row:not(.wb-submatch) i.wb-expander {
+  visibility: hidden;
+}
 div.wunderbaum div.wb-row.wb-drag-source {
   opacity: 0.5;
 }

package/dist/wunderbaum.css.map

@@ -1 +1 @@
-{"version":3,"sourceRoot":"","sources":["../src/wunderbaum.scss"],"names":[],"mappings":";AAAA;AAAA;AAAA;AAAA;AAAA;AA2EA;AAAA;EAME;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EAEA;;;AAMF;EACE;;;AAGF;EACE;EACA;EACA;EACA;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;EACA;EAGA;AAsBA;AAuBA;AAwQA;AAoHA;AAwBA;AAgEA;AAEA;AAUA;AAoBA;AAYA;;AAziBA;EAEE;;AAIF;EACE;EACA;;AAGF;EACE;EAEA;;AAMF;EACE;EACA;EACA;;AAGF;AAAA;EAEE;;AAKF;EACE;EACA;EACA;EACA;EACA;;AAMA;EACE;EACA;EACA;EACA;;AAIA;EACE;;AAKF;EAEE;;AAGF;EAEE;;AAGF;EACE;;AAOA;EAEE;EACA;;AAEA;EACE;;AAaN;EAEE;EACA;;AAEA;EACE;;AAON;EACE;;AAEA;EACE;;AAOF;EACE;;AAGF;EAEE;;AAGA;EACE;;AAKJ;EACE;EACA;;AAGF;EAEE;EACA;;AAEA;EAEE;;AAIJ;EACE;;AAGF;AAAA;AAAA;EAGE;EAcA;EASA;;AAGF;EAEE;;AAON;EACE;EACA;EACA;EACA;EACA;;AAEA;EACE;EAIA;;AAIF;EACE;EACA;EACA;EACA;;AAGF;EACE;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;;AAIJ;EACE;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;;AAEA;EACE;;AAIJ;EACE;AAqBA;;AAhBA;AAAA;AAAA;AAAA;EAIE;EACA;EACA;EACA;;AAGF;AAAA;EAEE;EACA;;AAIF;EACE;;AAGF;EACE;EACA;EACA;;AAMA;EACE;;AAIJ;AAAA;EAEE;EACA;EACA;EACA;;AAGF;EACE;EAEA;EACA;EACA;EACA;EACA;;AAUI;EACE;;AAON;EACE;;AAIJ;EACE;;AAEA;EACE;;AAIF;EACE;;AAGF;EACE;;AAEA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;EAgBE;EACA;EACA;;AAGF;AAAA;EAEE;;AAcA;EACE;;AAWJ;EACE;;AAGF;EACE;;AAEA;EACE;;AAON;EACE;;AAEA;EACE;;AAQJ;EACE;;AASJ;EACE;;AAEA;EACE;;AAGF;EACE;;AAcN;EACE;;AAEA;EACE;;AAIJ;EACE;;AAEA;EACE;EACA;;AAGA;EACE;EACA;;AAEA;EAGE;EACA;EAGA;EACA;EACA;;AAgBR;AAAA;EAIE;EACA;EACA;;AAKF;EACE;;AAUE;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAOJ;EAIE;EACA;;AAGF;AAAA;EAKE;EACA;;AAMF;AAAA;EAEE;EACA;EACA;EACA;;AAOF;EACE;;AAGF;AAAA;EAEE;;AAKA;EACE;;;AAMR;AAEA;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;EACA;;AAEA;EACE;EACA;;;AAQJ;AACA;AAAA;EAEE;;;AAGF;AAAA;EAEE;;;AAIA;AAAA;EAEE;;AAGF;AAAA;EAEE;;;AAIJ;EACE;;AAEA;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;;;AAIJ;AAAA;AAAA;AAMA;EACE;EACA;;;AAGF;EAGE;;;AAGF;EACE;;;AAKF;EACE;IACE;;EAGF;IACE;;;AAIJ;EACE;IACE;;EAGF;IACE;;;AAIJ;EACE;IACE;;EAGF;IACE","file":"wunderbaum.css"}
+{"version":3,"sourceRoot":"","sources":["../src/wunderbaum.scss"],"names":[],"mappings":";AAAA;AAAA;AAAA;AAAA;AAAA;AA2EA;AAAA;EAME;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EAEA;;;AAMF;EACE;;;AAGF;EACE;EACA;EACA;EACA;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;EACA;EAGA;AAsBA;AAyBA;AA8QA;AAoHA;AA8BA;AAgEA;AAEA;AAUA;AAoBA;AAYA;;AAvjBA;EAEE;;AAIF;EACE;EACA;;AAGF;EACE;EAEA;;AAMF;EACE;EACA;EACA;EACA;EACA;;AAGF;AAAA;EAEE;;AAKF;EACE;EACA;EACA;EACA;EACA;;AAMA;EACE;EACA;EACA;EACA;;AAIA;EACE;;AAKF;EAEE;;AAGF;EAEE;;AAGF;EACE;;AAOA;EAEE;EACA;;AAEA;EACE;;AAaN;EAEE;EACA;;AAEA;EACE;;AAON;EACE;;AAEA;EACE;;AAOF;EACE;;AAGF;EAEE;;AAGA;EACE;;AAKJ;EACE;EACA;;AAGF;EAEE;EACA;;AAEA;EAEE;;AAIJ;EACE;;AAGF;AAAA;AAAA;EAGE;EAcA;EASA;;AAGF;EAEE;;AAON;EACE;EACA;EACA;EACA;EACA;;AAEA;EACE;EAIA;;AAIF;EACE;EACA;EACA;EACA;;AAGF;EACE;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;EACA;;AACA;EACE;;AAMN;EACE;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;;AAEA;EACE;;AAIJ;EACE;EACA;AAqBA;;AAhBA;AAAA;AAAA;AAAA;EAIE;EACA;EACA;EACA;;AAGF;AAAA;EAEE;EACA;;AAIF;EACE;;AAGF;EACE;EACA;EACA;;AAMA;EACE;;AAIJ;AAAA;EAEE;EACA;EACA;EACA;;AAGF;EACE;EAEA;EACA;EACA;EACA;EACA;;AAUI;EACE;;AAON;EACE;;AAIJ;EACE;;AAEA;EACE;;AAIF;EACE;;AAGF;EACE;;AAEA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;EAgBE;EACA;EACA;;AAGF;AAAA;EAEE;;AAcA;EACE;;AAWJ;EACE;;AAGF;EACE;;AAEA;EACE;;AAON;EACE;;AAEA;EACE;;AAQJ;EACE;;AASJ;EACE;;AAEA;EACE;;AAGF;EACE;;AAMJ;EACE;;AAaJ;EACE;;AAEA;EACE;;AAIJ;EACE;;AAEA;EACE;EACA;;AAGA;EACE;EACA;;AAEA;EAGE;EACA;EAGA;EACA;EACA;;AAgBR;AAAA;EAIE;EACA;EACA;;AAKF;EACE;;AAUE;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAOJ;EAIE;EACA;;AAGF;AAAA;EAKE;EACA;;AAMF;AAAA;EAEE;EACA;EACA;EACA;;AAOF;EACE;;AAGF;AAAA;EAEE;;AAKA;EACE;;;AAMR;AAEA;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;EACA;;AAEA;EACE;EACA;;;AAQJ;AACA;AAAA;EAEE;;;AAGF;AAAA;EAEE;;;AAIA;AAAA;EAEE;;AAGF;AAAA;EAEE;;;AAIJ;EACE;;AAEA;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;;;AAIJ;AAAA;AAAA;AAMA;EACE;EACA;;;AAGF;EAGE;;;AAGF;EACE;;;AAKF;EACE;IACE;;EAGF;IACE;;;AAIJ;EACE;IACE;;EAGF;IACE;;;AAIJ;EACE;IACE;;EAGF;IACE","file":"wunderbaum.css"}

package/dist/wunderbaum.d.ts

@@ -6,12 +6,17 @@ declare module "debounce" {
      */
     type Procedure = (...args: any[]) => any;
     type DebounceOptions = {
+        /** Specify invoking on the leading edge of the timeout. @default false */
         leading?: boolean;
+        /** The maximum time `func` is allowed to be delayed before it's invoked.*/
         maxWait?: number;
+        /**  Specify invoking on the trailing edge of the timeout. @default true */
         trailing?: boolean;
     };
     type ThrottleOptions = {
+        /** Specify invoking on the leading edge of the timeout. @default true */
         leading?: boolean;
+        /**  Specify invoking on the trailing edge of the timeout. @default true */
         trailing?: boolean;
     };
     export interface DebouncedFunction<F extends Procedure> {
@@ -51,13 +56,7 @@ declare module "debounce" {
      * @param {number} [wait=0]
      *  The number of milliseconds to delay; if omitted, `requestAnimationFrame` is
      *  used (if available).
-     * @param {Object} [options={}] The options object.
-     * @param {boolean} [options.leading=false]
-     *  Specify invoking on the leading edge of the timeout.
-     * @param {number} [options.maxWait]
-     *  The maximum time `func` is allowed to be delayed before it's invoked.
-     * @param {boolean} [options.trailing=true]
-     *  Specify invoking on the trailing edge of the timeout.
+     * @param [options={}] The options object.
      * @returns {Function} Returns the new debounced function.
      * @example
      *
@@ -112,11 +111,7 @@ declare module "debounce" {
      * @param {number} [wait=0]
      *  The number of milliseconds to throttle invocations to; if omitted,
      *  `requestAnimationFrame` is used (if available).
-     * @param {Object} [options={}] The options object.
-     * @param {boolean} [options.leading=true]
-     *  Specify invoking on the leading edge of the timeout.
-     * @param {boolean} [options.trailing=true]
-     *  Specify invoking on the trailing edge of the timeout.
+     * @param [options={}] The options object.
      * @returns {Function} Returns the new throttled function.
      * @example
      *
@@ -135,7 +130,7 @@ declare module "debounce" {
 declare module "util" {
     /*!
      * Wunderbaum - util
-     * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
+     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
     /** @module util */
@@ -189,7 +184,7 @@ declare module "util" {
      * Iterate over Object properties or array elements.
      *
      * @param obj `Object`, `Array` or null
-     * @param callback(index, item) called for every item.
+     * @param callback called for every item.
      *  `this` also contains the item.
      *  Return `false` to stop the iteration.
      */
@@ -310,7 +305,7 @@ declare module "util" {
     /**
      * Bind one or more event handlers directly to an [EventTarget](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget).
      *
-     * @param element EventTarget or selector
+     * @param rootTarget EventTarget or selector
      * @param eventNames
      * @param handler
      */
@@ -326,7 +321,7 @@ declare module "util" {
      * });
      * ```
      *
-     * @param element EventTarget or selector
+     * @param rootTarget EventTarget or selector
      * @param eventNames
      * @param selector
      * @param handler
@@ -379,6 +374,24 @@ declare module "util" {
     export function getOption(opts: any, name: string, defaultValue?: any): any;
     /** Convert an Array or space-separated string to a Set. */
     export function toSet(val: any): Set<string>;
+    /** Convert a pixel string to number.
+     * We accept a number or a string like '123px'. If undefined, the first default
+     * value that is a number or a string ending with 'px' is returned.
+     *
+     * Example:
+     * ```js
+     * const width = util.toPixel("123px", 100);
+     * ```
+     */
+    export function toPixel(...defaults: (string | number | undefined | null)[]): number;
+    /** Evaluate a boolean value using default if undefined.
+     * Example:
+     * ```js
+     * const opts = { flag: true };
+     * const value = util.toBool(opts.flag, otherVar, false);
+     * ```
+     */
+    export function toBool(...boolDefaults: (boolean | undefined | null)[]): boolean;
     /** Return a canonical string representation for an object's type (e.g. 'array', 'number', ...). */
     export function type(obj: any): string;
     /**
@@ -398,7 +411,7 @@ declare module "util" {
 declare module "common" {
     /*!
      * Wunderbaum - common
-     * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
+     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
     import { MatcherCallback, SourceObjectType } from "types";
@@ -421,6 +434,8 @@ declare module "common" {
     export const RENDER_MAX_PREFETCH = 5;
     /** Skip rendering new rows when we have at least N nodes rendeed above and below the viewport. */
     export const RENDER_MIN_PREFETCH = 5;
+    /** Minimum column width if not set otherwise. */
+    export const DEFAULT_MIN_COL_WIDTH = 4;
     /** Regular expression to detect if a string describes an image URL (in contrast
      * to a class name). Strings are considered image urls if they contain '.' or '/'.
      */
@@ -470,7 +485,7 @@ declare module "common" {
 declare module "deferred" {
     /*!
      * Wunderbaum - deferred
-     * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
+     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
     type PromiseCallbackType = (val: any) => void;
@@ -728,7 +743,7 @@ declare module "wb_node" {
         getParentList(includeRoot?: boolean, includeSelf?: boolean): any[];
         /** Return a string representing the hierachical node path, e.g. "a/b/c".
          * @param includeSelf
-         * @param node property name or callback
+         * @param part property name or callback
          * @param separator
          */
         getPath(includeSelf?: boolean, part?: keyof WunderbaumNode | NodeAnyCallback, separator?: string): string;
@@ -740,6 +755,8 @@ declare module "wb_node" {
         hasChildren(): boolean;
         /** Return true if node has className set. */
         hasClass(className: string): boolean;
+        /** Return true if node ist the currently focused node. */
+        hasFocus(): boolean;
         /** Return true if this node is the currently active tree node. */
         isActive(): boolean;
         /** Return true if this node is a direct or indirect parent of `other`.
@@ -768,7 +785,7 @@ declare module "wb_node" {
         isExpandable(andCollapsed?: boolean): boolean;
         /** Return true if _this_ node is currently in edit-title mode.
          *
-         * See {@link Wunderbaum.startEditTitle} to check if any node is currently edited.
+         * See {@link WunderbaumNode.startEditTitle}.
          */
         isEditingTitle(): boolean;
         /** Return true if this node is currently expanded. */
@@ -899,8 +916,8 @@ declare module "wb_node" {
          *
          * The result is compatible with node.addChildren().
          *
-         * @param include child nodes
-         * @param callback(dict, node) is called for every node, in order to allow
+         * @param recursive include child nodes
+         * @param callback is called for every node, in order to allow
          *     modifications.
          *     Return `false` to ignore this node or `"skip"` to include this node
          *     without its children.
@@ -1031,8 +1048,9 @@ declare module "wb_node" {
          * Stop iteration, if fn() returns false.<br>
          * Return false if iteration was stopped.
          *
-         * @param {function} fn the callback function.
+         * @param callback the callback function.
          *     Return false to stop iteration.
+         * @param includeSelf include this node in the iteration.
          */
         visitSiblings(callback: (node: WunderbaumNode) => boolean | void, includeSelf?: boolean): boolean;
         /**
@@ -1044,7 +1062,7 @@ declare module "wb_node" {
 declare module "wb_options" {
     /*!
      * Wunderbaum - utils
-     * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
+     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
     import { ColumnDefinitionList, DndOptionsType, DynamicBoolOption, DynamicBoolOrStringOption, DynamicCheckboxOption, DynamicIconOption, EditOptionsType, FilterOptionsType, NavModeEnum, NodeTypeDefinitionMap, SelectModeType, WbActivateEventType, WbCancelableEventResultType, WbChangeEventType, WbClickEventType, WbDeactivateEventType, WbErrorEventType, WbExpandEventType, WbIconBadgeCallback, WbIconBadgeEventResultType, WbInitEventType, WbKeydownEventType, WbNodeData, WbNodeEventType, WbReceiveEventType, WbRenderEventType, WbSelectEventType, WbTreeEventType } from "types";
@@ -1219,6 +1237,11 @@ declare module "wb_options" {
          * Default: false
          */
         fixedCol?: boolean;
+        /**
+         * Default value for ColumnDefinition.resizable option.
+         * Default: false
+         */
+        resizableColumns?: boolean;
         /**
          * Default: "multi"
          */
@@ -1379,7 +1402,7 @@ declare module "wb_options" {
 declare module "types" {
     /*!
      * Wunderbaum - types
-     * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
+     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
     import { WunderbaumNode } from "wb_node";
@@ -1388,6 +1411,8 @@ declare module "types" {
     export type TristateType = boolean | undefined;
     /** Show/hide checkbox or display a radiobutton icon instead. */
     export type CheckboxOption = boolean | "radio";
+    /** A value that can either be true, false, or undefined. */
+    export type SortOrderType = "asc" | "desc" | undefined;
     /** An icon may either be
      * a string-tag that references an entry in the `iconMap` (e.g. `"folderOpen"`)),
      * an HTML string that contains a `<` and is used as-is,
@@ -1669,6 +1694,22 @@ declare module "types" {
          * Default: `4px`.
          */
         minWidth?: string | number;
+        /** Allow user to resize the column.
+         * Default: false.
+         */
+        resizable?: boolean;
+        /** Optional custom column width when user resized by mouse drag.
+         * Default: unset.
+         */
+        customWidthPx?: number;
+        /** Allow user to sort the column.
+         * Default: false.
+         */
+        sortable?: boolean;
+        /** Optional custom column sort orde when user clicked the sort icon.
+         * Default: unset.
+         */
+        sortOrder?: SortOrderType;
         /** Optional class names that are added to all `span.wb-col` header AND data
          * elements of that column.
          */
@@ -1782,9 +1823,9 @@ declare module "types" {
     }
     /** Initial navigation mode and possible transition. */
     export enum NavModeEnum {
-        startRow = "startRow",
-        cell = "cell",
-        startCell = "startCell",
+        startRow = "startRow",// Start with row mode, but allow cell-nav mode
+        cell = "cell",// Cell-nav mode only
+        startCell = "startCell",// Start in cell-nav mode, but allow row mode
         row = "row"
     }
     /** Possible values for {@link WunderbaumNode.addChildren()}. */
@@ -1817,15 +1858,31 @@ declare module "types" {
         /** Keep active node visible @default true */
         keepActiveNodeVisible?: boolean;
     }
-    /** Possible values for {@link Wunderbaum.filterNodes()} and {@link Wunderbaum.filterBranches()}. */
+    /**
+     * Possible option values for {@link Wunderbaum.filterNodes()}.
+     * The defaults are inherited from the tree instances ´tree.options.filter`
+     * settings (see also {@link FilterOptionsType}).
+     */
     export interface FilterNodesOptions {
-        mode?: string;
-        leavesOnly?: boolean;
+        /** Expand all branches that contain matches while filtered @default false */
+        autoExpand?: boolean;
+        /** Whether to implicitly match all children of matched nodes @default false */
+        matchBranch?: boolean;
+        /** Match single characters in order, e.g. 'fb' will match 'FooBar' @default false */
         fuzzy?: boolean;
-        highlight?: boolean;
+        /**Hide expanders if all child nodes are hidden by filter @default false */
         hideExpanders?: boolean;
-        autoExpand?: boolean;
-        noData?: boolean;
+        /** Highlight matches by wrapping inside `<mark>` tags.
+         * Does not work for filter callbacks.
+         *  @default true
+         */
+        highlight?: boolean;
+        /** Match end nodes only @default false */
+        leavesOnly?: boolean;
+        /** Grayout unmatched nodes (pass 'hide' to remove instead) @default 'dim' */
+        mode?: FilterModeType;
+        /** Display a 'no data' status node if result is empty @default true */
+        noData?: boolean | string;
     }
     /** Possible values for {@link WunderbaumNode.makeVisible()}. */
     export interface MakeVisibleOptions {
@@ -1895,7 +1952,7 @@ declare module "types" {
          */
         edit?: boolean;
     }
-    /** Possible values for {@link WunderbaumNode.setColumn()} `options` argument. */
+    /** Possible values for {@link Wunderbaum.setColumn()} `options` argument. */
     export interface SetColumnOptions {
         /**
          * Focus embedded input control of the grid cell if any .
@@ -1956,6 +2013,12 @@ declare module "types" {
          * until the start node is reached again @default false */
         wrap?: boolean;
     }
+    /**
+     * Passed as tree options to configure default filtering behavior.
+     *
+     * @see {@link Wunderbaum.filterNodes}
+     * @see {@link FilterNodesOptions}
+     */
     export type FilterOptionsType = {
         /**
          * Element or selector of an input control for filter query strings
@@ -1967,53 +2030,7 @@ declare module "types" {
          * @default true
          */
         autoApply?: boolean;
-        /**
-         * Expand all branches that contain matches while filtered
-         * @default false
-         */
-        autoExpand?: boolean;
-        /**
-         * Show a badge with number of matching child nodes near parent icons
-         * @default true
-         */
-        counter?: boolean;
-        /**
-         * Match single characters in order, e.g. 'fb' will match 'FooBar'
-         * @default false
-         */
-        fuzzy?: boolean;
-        /**
-         * Hide counter badge if parent is expanded
-         * @default true
-         */
-        hideExpandedCounter?: boolean;
-        /**
-         * Hide expanders if all child nodes are hidden by filter
-         * @default false;
-         */
-        hideExpanders?: boolean;
-        /**
-         * Highlight matches by wrapping inside <mark> tags
-         * @default true
-         */
-        highlight?: boolean;
-        /**
-         * Match end nodes only
-         * @default false
-         */
-        leavesOnly?: boolean;
-        /**
-         * Grayout unmatched nodes (pass "hide" to remove unmatched node instead)
-         * @default 'dim'
-         */
-        mode?: FilterModeType;
-        /**
-         * Display a 'no data' status node if result is empty (hide-mode only).
-         * Pass false to simply show an empy pane, or pass a string to customize the message.
-         * @default true
-         */
-        noData?: boolean | string;
-    };
+    } & FilterNodesOptions;
     /**
      * Note: <br>
      * This options are used for renaming node titles. <br>
@@ -2284,16 +2301,21 @@ declare module "wb_ext_filter" {
         constructor(tree: Wunderbaum);
         init(): void;
         setPluginOption(name: string, value: any): void;
-        _applyFilterNoUpdate(filter: string | NodeFilterCallback, branchMode: boolean, _opts: any): void;
-        _applyFilterImpl(filter: string | NodeFilterCallback, branchMode: boolean, _opts: any): number;
+        _applyFilterNoUpdate(filter: string | RegExp | NodeFilterCallback, _opts: FilterNodesOptions): number;
+        _applyFilterImpl(filter: string | RegExp | NodeFilterCallback, _opts: FilterNodesOptions): number;
         /**
          * [ext-filter] Dim or hide nodes.
          */
-        filterNodes(filter: string | NodeFilterCallback, options: FilterNodesOptions): void;
+        filterNodes(filter: string | RegExp | NodeFilterCallback, options: FilterNodesOptions): number;
         /**
          * [ext-filter] Dim or hide whole branches.
+         * @deprecated Use {@link filterNodes} instead and set `options.matchBranch: true`.
+         */
+        filterBranches(filter: string | NodeFilterCallback, options: FilterNodesOptions): number;
+        /**
+         * [ext-filter] Return the number of matched nodes.
          */
-        filterBranches(filter: string | NodeFilterCallback, options: FilterNodesOptions): void;
+        countMatches(): number;
         /**
          * [ext-filter] Re-apply current filter.
          */
@@ -2307,7 +2329,7 @@ declare module "wb_ext_filter" {
 declare module "wb_ext_keynav" {
     /*!
      * Wunderbaum - ext-keynav
-     * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
+     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
     import { KeynavOptionsType } from "types";
@@ -2323,7 +2345,7 @@ declare module "wb_ext_keynav" {
 declare module "wb_ext_logger" {
     /*!
      * Wunderbaum - ext-logger
-     * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
+     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
     import { LoggerOptionsType } from "types";
@@ -2387,14 +2409,21 @@ declare module "wb_ext_dnd" {
 declare module "drag_observer" {
     /*!
      * Wunderbaum - drag_observer
-     * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
+     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
     export type DragCallbackArgType = {
         /** "dragstart", "drag", or "dragstop". */
         type: string;
-        /** Original mouse or touch event that triggered the drag event. */
+        /** Original mousedown or touch event that triggered the dragstart event. */
+        startEvent: MouseEvent | TouchEvent;
+        /** Original mouse or touch event that triggered the current drag event.
+         * Note that this is not the same as `startEvent`, but a mousemove in case of
+         * a dragstart threshold.
+         */
         event: MouseEvent | TouchEvent;
+        /** Custom data that was passed to the DragObserver, typically on dragstart. */
+        customData: any;
         /** Element which is currently dragged. */
         dragElem: HTMLElement | null;
         /** Relative horizontal drag distance since start. */
@@ -2424,6 +2453,7 @@ declare module "drag_observer" {
         protected _handler: any;
         protected root: EventTarget;
         protected start: {
+            event: MouseEvent | TouchEvent | null;
             x: number;
             y: number;
             altKey: boolean;
@@ -2433,6 +2463,7 @@ declare module "drag_observer" {
         };
         protected dragElem: HTMLElement | null;
         protected dragging: boolean;
+        protected customData: object;
         protected events: string[];
         protected opts: DragObserverOptionsType;
         constructor(opts: DragObserverOptionsType);
@@ -2447,7 +2478,7 @@ declare module "drag_observer" {
 declare module "wb_ext_grid" {
     /*!
      * Wunderbaum - ext-grid
-     * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
+     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
     import { Wunderbaum } from "wunderbaum";
@@ -2458,13 +2489,16 @@ declare module "wb_ext_grid" {
         protected observer: DragObserver;
         constructor(tree: Wunderbaum);
         init(): void;
+        /**
+         * Hanldes drag and sragstop events for column resizing.
+         */
         protected handleDrag(e: DragCallbackArgType): void;
     }
 }
 declare module "wb_ext_edit" {
     /*!
      * Wunderbaum - ext-edit
-     * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
+     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
     import { Wunderbaum } from "wunderbaum";
@@ -2503,7 +2537,7 @@ declare module "wunderbaum" {
      *
      * A treegrid control.
      *
-     * Copyright (c) 2021-2023, Martin Wendt (https://wwWendt.de).
+     * Copyright (c) 2021-2024, Martin Wendt (https://wwWendt.de).
      * https://github.com/mar10/wunderbaum
      *
      * Released under the MIT license.
@@ -2587,6 +2621,7 @@ declare module "wunderbaum" {
         static util: typeof util;
         /** Expose some useful methods of the util.ts module as `tree._util`. */
         _util: typeof util;
+        /** Filter options (used as defaults for calls to {@link Wunderbaum.filterNodes} ) */
         filterMode: FilterModeType;
         /** @internal Use `setColumn()`/`getActiveColElem()` to access. */
         activeColIdx: number;
@@ -2726,7 +2761,7 @@ declare module "wunderbaum" {
          * });
          * ```
          */
-        runWithDeferredUpdate(func: () => any, hint?: any): void;
+        runWithDeferredUpdate(func: () => any, hint?: any): any;
         /** Recursively expand all expandable nodes (triggers lazy load if needed). */
         expandAll(flag?: boolean, options?: ExpandAllOptions): Promise<void>;
         /** Recursively select all nodes. */
@@ -2891,6 +2926,8 @@ declare module "wunderbaum" {
         logTimeEnd(label: string): void;
         /** Write to `console.warn` with tree name as prefix with if opts.debugLevel >= 2. */
         logWarn(...args: any[]): void;
+        /** Reset column widths to default. */
+        resetColumns(): void;
         /**
          * Make sure that this node is vertically scrolled into the viewport.
          *
@@ -2962,7 +2999,7 @@ declare module "wunderbaum" {
         sortChildren(cmp?: SortCallback | null, deep?: boolean): void;
         /** Convert tree to an array of plain objects.
          *
-         * @param callback(dict, node) is called for every node, in order to allow
+         * @param callback is called for every node, in order to allow
          *     modifications.
          *     Return `false` to ignore this node or `"skip"` to include this node
          *     without its children.
@@ -3051,13 +3088,28 @@ declare module "wunderbaum" {
          */
         enableUpdate(flag: boolean): void;
         /**
-         * Dim or hide nodes.
+         * Dim or hide unmatched nodes.
+         * @param filter a string to match against node titles, or a callback function.
+         * @param options filter options. Defaults to the `tree.options.filter` settings.
+         * @returns the number of nodes that match the filter.
+         * @example
+         * ```ts
+         * tree.filterNodes("foo", {mode: 'dim', fuzzy: true});
+         * // or pass a callback
+         * tree.filterNodes((node) => { return node.data.foo === true }, {mode: 'hide'});
+         * ```
+         */
+        filterNodes(filter: string | RegExp | NodeFilterCallback, options: FilterNodesOptions): number;
+        /**
+         * Return the number of nodes that match the current filter.
+         * @see {@link Wunderbaum.filterNodes}
          */
-        filterNodes(filter: string | NodeFilterCallback, options: FilterNodesOptions): void;
+        countMatches(): number;
         /**
          * Dim or hide whole branches.
+         * @deprecated Use {@link filterNodes} instead and set `options.matchBranch: true`.
          */
-        filterBranches(filter: string | NodeFilterCallback, options: FilterNodesOptions): void;
+        filterBranches(filter: string | NodeFilterCallback, options: FilterNodesOptions): number;
         /**
          * Reset the filter.
          */