wunderbaum 0.0.1-0 → 0.0.3

package/dist/wunderbaum.d.ts

@@ -4,12 +4,13 @@ declare module "util" {
      * Copyright (c) 2021-2022, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
+    /** @module util */
     /** Readable names for `MouseEvent.button` */
     export const MOUSE_BUTTONS: {
         [key: number]: string;
     };
     export const MAX_INT = 9007199254740991;
-    /**True if the user is using a macOS platform. */
+    /**True if the client is using a macOS platform. */
     export const isMac: boolean;
     export type FunctionType = (...args: any[]) => any;
     export type EventCallbackType = (e: Event) => boolean | void;
@@ -94,32 +95,45 @@ declare module "util" {
      * @param value a value that matches the target element.
      */
     export function setValueToElem(elem: HTMLElement, value: any): void;
-    /** Return an unconnected `HTMLElement` from a HTML string. */
+    /** Create and return an unconnected `HTMLElement` from a HTML string. */
     export function elemFromHtml(html: string): HTMLElement;
     /** Return a HtmlElement from selector or cast an existing element. */
     export function elemFromSelector(obj: string | Element): HTMLElement | null;
+    /** Return a EventTarget from selector or cast an existing element. */
+    export function eventTargetFromSelector(obj: string | EventTarget): EventTarget | null;
     /**
-     * Return a descriptive string for a keyboard or mouse event.
+     * Return a canonical descriptive string for a keyboard or mouse event.
      *
      * The result also contains a prefix for modifiers if any, for example
      * `"x"`, `"F2"`, `"Control+Home"`, or `"Shift+clickright"`.
+     * This is especially useful in `switch` statements, to make sure that modifier
+     * keys are considered and handled correctly.
      */
     export function eventToString(event: Event): string;
+    /**
+     * Copy allproperties from one or more source objects to a target object.
+     *
+     * @returns the modified target object.
+     */
     export function extend(...args: any[]): any;
+    /** Return true if `obj` is of type `array`. */
     export function isArray(obj: any): boolean;
+    /** Return true if `obj` is of type `Object` and has no propertied. */
     export function isEmptyObject(obj: any): boolean;
+    /** Return true if `obj` is of type `function`. */
     export function isFunction(obj: any): boolean;
+    /** Return true if `obj` is of type `Object`. */
     export function isPlainObject(obj: any): boolean;
     /** A dummy function that does nothing ('no operation'). */
     export function noop(...args: any[]): any;
     /**
-     * Bind one or more event handlers directly to an [[HtmlElement]].
+     * Bind one or more event handlers directly to an [[EventTarget]].
      *
-     * @param element HTMLElement or selector
+     * @param element EventTarget or selector
      * @param eventNames
      * @param handler
      */
-    export function onEvent(rootElem: HTMLElement | string, eventNames: string, handler: EventCallbackType): void;
+    export function onEvent(rootTarget: EventTarget | string, eventNames: string, handler: EventCallbackType): void;
     /**
      * Bind one or more event handlers using event delegation.
      *
@@ -131,12 +145,12 @@ declare module "util" {
      * });
      * ```
      *
-     * @param element HTMLElement or selector
+     * @param element EventTarget or selector
      * @param eventNames
      * @param selector
      * @param handler
      */
-    export function onEvent(rootElem: HTMLElement | string, eventNames: string, selector: string, handler: EventCallbackType): void;
+    export function onEvent(rootTarget: EventTarget | string, eventNames: string, selector: string, handler: EventCallbackType): void;
     /** Return a wrapped handler method, that provides `this._super`.
      *
      * ```ts
@@ -165,6 +179,13 @@ declare module "util" {
     export function sleep(ms: number): Promise<unknown>;
     /**
      * Set or rotate checkbox status with support for tri-state.
+     *
+     * An initial 'indeterminate' state becomes 'checked' on the first call.
+     *
+     * If the input element has the class 'wb-tristate' assigned, the sequence is:<br>
+     * 'indeterminate' -> 'checked' -> 'unchecked' -> 'indeterminate' -> ...<br>
+     * Otherwise we toggle like <br>
+     * 'checked' -> 'unchecked' -> 'checked' -> ...
      */
     export function toggleCheckbox(element: HTMLElement | string, value?: boolean | null, tristate?: boolean): void;
     /**
@@ -177,6 +198,7 @@ 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>;
+    /**Return a canonical string representation for an object's type (e.g. 'array', 'number', ...) */
     export function type(obj: any): string;
 }
 declare module "deferred" {
@@ -211,20 +233,181 @@ declare module "deferred" {
         finally(cb: finallyCallbackType): Promise<any>;
     }
 }
+declare module "wb_extension_base" {
+    import { Wunderbaum } from "wunderbaum";
+    export type ExtensionsDict = {
+        [key: string]: WunderbaumExtension;
+    };
+    export abstract class WunderbaumExtension {
+        enabled: boolean;
+        readonly id: string;
+        readonly tree: Wunderbaum;
+        readonly treeOpts: any;
+        readonly extensionOpts: any;
+        constructor(tree: Wunderbaum, id: string, defaults: any);
+        /** Called on tree (re)init after all extensions are added, but before loading.*/
+        init(): void;
+        getPluginOption(name: string, defaultValue?: any): any;
+        setPluginOption(name: string, value: any): void;
+        setEnabled(flag?: boolean): void;
+        onKeyEvent(data: any): boolean | undefined;
+        onRender(data: any): boolean | undefined;
+    }
+}
+declare module "wb_ext_dnd" {
+    import { Wunderbaum } from "wunderbaum";
+    import { WunderbaumExtension } from "wb_extension_base";
+    import { WunderbaumNode } from "wb_node";
+    import { WbNodeEventType } from "common";
+    export type DropRegionType = "over" | "before" | "after";
+    type DropRegionTypeSet = Set<DropRegionType>;
+    export type DndOptionsType = {
+        /**
+         * Expand nodes after n milliseconds of hovering
+         * Default: 1500
+         */
+        autoExpandMS: 1500;
+        /**
+         * true: Drag multiple (i.e. selected) nodes. Also a callback() is allowed
+         * Default: false
+         */
+        multiSource: false;
+        /**
+         * Restrict the possible cursor shapes and modifier operations (can also be set in the dragStart event)
+         * Default: "all"
+         */
+        effectAllowed: "all";
+        /**
+         * Default dropEffect ('copy', 'link', or 'move') when no modifier is pressed (overide in dragDrag, dragOver).
+         * Default: "move"
+         */
+        dropEffectDefault: string;
+        /**
+         * Prevent dropping nodes from different Wunderbaum trees
+         * Default: false
+         */
+        preventForeignNodes: boolean;
+        /**
+         * Prevent dropping items on unloaded lazy Wunderbaum tree nodes
+         * Default: true
+         */
+        preventLazyParents: boolean;
+        /**
+         * Prevent dropping items other than Wunderbaum tree nodes
+         * Default: false
+         */
+        preventNonNodes: boolean;
+        /**
+         * Prevent dropping nodes on own descendants
+         * Default: true
+         */
+        preventRecursion: boolean;
+        /**
+         * Prevent dropping nodes under same direct parent
+         * Default: false
+         */
+        preventSameParent: false;
+        /**
+         * Prevent dropping nodes 'before self', etc. (move only)
+         * Default: true
+         */
+        preventVoidMoves: boolean;
+        /**
+         * Enable auto-scrolling while dragging
+         * Default: true
+         */
+        scroll: boolean;
+        /**
+         * Active top/bottom margin in pixel
+         * Default: 20
+         */
+        scrollSensitivity: 20;
+        /**
+         * Pixel per event
+         * Default: 5
+         */
+        scrollSpeed: 5;
+        /**
+         * Optional callback passed to `toDict` on dragStart @since 2.38
+         * Default: null
+         */
+        sourceCopyHook: null;
+        /**
+         * Callback(sourceNode, data), return true, to enable dnd drag
+         * Default: null
+         */
+        dragStart?: WbNodeEventType;
+        /**
+         * Callback(sourceNode, data)
+         * Default: null
+         */
+        dragDrag: null;
+        /**
+         * Callback(sourceNode, data)
+         * Default: null
+         */
+        dragEnd: null;
+        /**
+         * Callback(targetNode, data), return true, to enable dnd drop
+         * Default: null
+         */
+        dragEnter: null;
+        /**
+         * Callback(targetNode, data)
+         * Default: null
+         */
+        dragOver: null;
+        /**
+         * Callback(targetNode, data), return false to prevent autoExpand
+         * Default: null
+         */
+        dragExpand: null;
+        /**
+         * Callback(targetNode, data)
+         * Default: null
+         */
+        dragDrop: null;
+        /**
+         * Callback(targetNode, data)
+         * Default: null
+         */
+        dragLeave: null;
+    };
+    export class DndExtension extends WunderbaumExtension {
+        protected srcNode: WunderbaumNode | null;
+        protected lastTargetNode: WunderbaumNode | null;
+        protected lastEnterStamp: number;
+        protected lastAllowedDropRegions: DropRegionTypeSet | null;
+        protected lastDropEffect: string | null;
+        protected lastDropRegion: DropRegionType | false;
+        constructor(tree: Wunderbaum);
+        init(): void;
+        /** Cleanup classes after target node is no longer hovered. */
+        protected _leaveNode(): void;
+        /** */
+        protected unifyDragover(res: any): DropRegionTypeSet | false;
+        /** */
+        protected _calcDropRegion(e: DragEvent, allowed: DropRegionTypeSet | null): DropRegionType | false;
+        protected autoScroll(event: DragEvent): number;
+        protected onDragEvent(e: DragEvent): boolean;
+        protected onDropEvent(e: DragEvent): boolean;
+    }
+}
 declare module "wb_options" {
     /*!
      * Wunderbaum - utils
      * Copyright (c) 2021-2022, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
-    import { BoolOptionResolver, NavigationModeOption, WbEventType } from "common";
+    import { BoolOptionResolver, NavigationModeOption, WbNodeEventType, WbTreeEventType } from "common";
+    import { DndOptionsType } from "wb_ext_dnd";
     export interface WbNodeData {
         title: string;
         key?: string;
         refKey?: string;
         expanded?: boolean;
         selected?: boolean;
-        checkbox?: boolean | "radio" | BoolOptionResolver;
+        checkbox?: boolean | string;
         children?: Array<WbNodeData>;
     }
     /**
@@ -268,56 +451,164 @@ declare module "wb_options" {
          *
          * Default: `{}`.
          */
-        types: any;
+        types?: any;
         /**
          * A list of maps that define column headers. If this option is set,
-         * Wunderbaum becomes a tree-grid control instead of a plain tree.
+         * Wunderbaum becomes a treegrid control instead of a plain tree.
          * Column definitions can be passed as tree option, or be part of a `source`
          * response.
          * Default: `[]` meaning this is a plain tree.
          */
         columns?: Array<any>;
         /**
-         *
+         * If true, add a `wb-skeleton` class to all nodes, that will result in a
+         * 'glow' effect. Typically used with initial dummy nodes, while loading the
+         * real data.
          * Default: false.
          */
-        skeleton: false;
+        skeleton?: false;
         /**
-         *
-         * Default: false.
+         * Translation map for some system messages.
          */
-        strings: any;
+        strings?: any;
         /**
+         * 0:quiet, 1:errors, 2:warnings, 3:info, 4:verbose
+         * Default: 3 (4 in local debug environment)
          */
-        debugLevel: 3;
-        minExpandLevel: 0;
-        escapeTitles: true;
-        headerHeightPx: 22;
-        autoCollapse: false;
-        dnd: any;
-        filter: any;
+        debugLevel: number;
         /**
-         * A list of maps that define column headers. If this option is set,
-         * Wunderbaum becomes a tree grid control instead of a plain tree.
-         * Column definitions can be passed as tree option, or be part of a `source`
-         * response.
+         * Number of levels that are forced to be expanded, and have no expander icon.
+         *  Default: 0
+         */
+        minExpandLevel?: number;
+        /**
+         * Height of the header row div.
+         * Default: 22
+         */
+        headerHeightPx: number;
+        /**
+         * Height of a node row div.
+         * Default: 22
+         */
+        rowHeightPx?: number;
+        /**
+         * Collapse siblings when a node is expanded.
+         * Default: false
+         */
+        autoCollapse?: boolean;
+        /**
+         * Default:  NavigationModeOption.startRow
          */
         navigationMode?: NavigationModeOption;
+        /**
+         * Show/hide header (pass bool or string)
+         */
+        header?: boolean | string | null;
+        /**
+         *
+         */
+        showSpinner?: boolean;
+        /**
+         * Default: true
+         */
+        checkbox?: boolean | "radio" | BoolOptionResolver;
+        /**
+         * Default: 200
+         */
+        updateThrottleWait?: number;
+        /**
+         * Default: true
+         */
+        quicksearch?: boolean;
+        dnd?: DndOptionsType;
+        filter: any;
+        grid: any;
         /**
          * Called after initial data was loaded and tree markup was rendered.
+         * Check `e.error` for status.
          * @category Callback
          */
-        init?: (e: WbEventType) => void;
+        init?: (e: WbTreeEventType) => void;
         /**
-         * Called after data was loaded from local storage.
+         *
+         * @category Callback
+         */
+        update?: (e: WbTreeEventType) => void;
+        /**
+         *
+         * @category Callback
+         */
+        activate?: (e: WbNodeEventType) => void;
+        /**
+         *
+         * @category Callback
+         */
+        deactivate?: (e: WbNodeEventType) => void;
+        /**
+         *
+         * @category Callback
+         */
+        change?: (e: WbNodeEventType) => void;
+        /**
+         *
+         * @category Callback
+         */
+        click?: (e: WbTreeEventType) => void;
+        /**
+         *
+         * @category Callback
+         */
+        discard?: (e: WbNodeEventType) => void;
+        /**
+         *
+         * @category Callback
+         */
+        error?: (e: WbTreeEventType) => void;
+        /**
+         *
+         * @category Callback
+         */
+        enhanceTitle?: (e: WbNodeEventType) => void;
+        /**
+         *
+         * Check `e.flag` for status.
+         * @category Callback
+         */
+        focus?: (e: WbTreeEventType) => void;
+        /**
+         *
          * @category Callback
          */
-        update?: (e: WbEventType) => void;
+        keydown?: (e: WbNodeEventType) => void;
         /**
          * Called after data was loaded from local storage.
+         */
+        load?: (e: WbNodeEventType) => void;
+        /**
          * @category Callback
          */
-        modifyChild?: (e: WbEventType) => void;
+        modifyChild?: (e: WbNodeEventType) => void;
+        /**
+         *
+         * @category Callback
+         */
+        receive?: (e: WbNodeEventType) => void;
+        /**
+         *
+         * @category Callback
+         */
+        render?: (e: WbNodeEventType) => void;
+        /**
+         *
+         * @category Callback
+         */
+        renderStatusNode?: (e: WbNodeEventType) => void;
+        /**
+         *
+         * Check `e.flag` for status.
+         * @category Callback
+         */
+        select?: (e: WbNodeEventType) => void;
     }
 }
 declare module "wb_node" {
@@ -328,27 +619,47 @@ declare module "wb_node" {
      */
     import "./wunderbaum.scss";
     import { Wunderbaum } from "wunderbaum";
-    import { ChangeType, MatcherType, NodeAnyCallback, NodeStatusType, NodeVisitCallback, NodeVisitResponse, ApplyCommandType, AddNodeType } from "common";
+    import { ChangeType, MatcherType, NodeAnyCallback, NodeStatusType, NodeVisitCallback, NodeVisitResponse, ApplyCommandType, AddNodeType, SetActiveOptions, SetExpandedOptions, SetSelectedOptions } from "common";
     import { WbNodeData } from "wb_options";
+    /**
+     * A single tree node.
+     *
+     * **NOTE:** <br>
+     * Generally you should not modify properties directly, since this may break
+     * the internal bookkeeping.
+     */
     export class WunderbaumNode {
         static sequence: number;
         /** Reference to owning tree. */
         tree: Wunderbaum;
         /** Parent node (null for the invisible root node `tree.root`). */
         parent: WunderbaumNode;
+        /** Name of the node.
+         * @see Use {@link setTitle} to modify. */
         title: string;
+        /** Unique key. Passed with constructor or defaults to `SEQUENCE`.
+         * @see Use {@link setKey} to modify. */
         readonly key: string;
+        /** Reference key. Unlike {@link key}, a `refKey` may occur multiple
+         * times within a tree (in this case we have 'clone nodes').
+         * @see Use {@link setKey} to modify.
+         */
         readonly refKey: string | undefined;
         children: WunderbaumNode[] | null;
         checkbox?: boolean;
         colspan?: boolean;
         icon?: boolean | string;
         lazy: boolean;
+        /** Expansion state.
+         * @see {@link isExpandable}, {@link isExpanded}, {@link setExpanded}. */
         expanded: boolean;
+        /** Selection state.
+         * @see {@link isSelected}, {@link setSelected}. */
         selected: boolean;
         type?: string;
         tooltip?: string;
-        /** Additional classes added to `div.wb-row`. */
+        /** Additional classes added to `div.wb-row`.
+         * @see {@link addClass}, {@link removeClass}, {@link toggleClass}. */
         extraClasses: Set<string>;
         /** Custom data that was passed to the constructor */
         data: any;
@@ -361,6 +672,7 @@ declare module "wb_node" {
         match?: boolean;
         subMatchCount?: number;
         subMatchBadge?: HTMLElement;
+        /** @internal */
         titleWithHighlight?: string;
         _filterAutoExpanded?: boolean;
         _rowIdx: number | undefined;
@@ -400,7 +712,8 @@ declare module "wb_node" {
         addNode(nodeData: WbNodeData, mode?: string): WunderbaumNode;
         /**
          * Apply a modification (or navigation) operation.
-         * @see Wunderbaum#applyCommand
+         *
+         * @see {@link Wunderbaum.applyCommand}
          */
         applyCommand(cmd: ApplyCommandType, opts: any): any;
         addClass(className: string | string[] | Set<string>): void;
@@ -424,8 +737,7 @@ declare module "wb_node" {
         findFirst(match: string | MatcherType): WunderbaumNode | null;
         /** Find a node relative to self.
          *
-         * @param where The keyCode that would normally trigger this move,
-         *		or a keyword ('down', 'first', 'last', 'left', 'parent', 'right', 'up').
+         * @see {@link Wunderbaum.findRelatedNode|tree.findRelatedNode()}
          */
         findRelatedNode(where: string, includeHidden?: boolean): any;
         /** Return the `<span class='wb-col'>` element with a given index or id.
@@ -586,26 +898,45 @@ declare module "wb_node" {
          *
          * Evaluation sequence:
          *
-         * If `tree.options.<name>` is a callback that returns something, use that.
-         * Else if `node.<name>` is defined, use that.
-         * Else if `tree.types[<node.type>]` is a value, use that.
-         * Else if `tree.options.<name>` is a value, use that.
-         * Else use `defaultValue`.
+         * - If `tree.options.<name>` is a callback that returns something, use that.
+         * - Else if `node.<name>` is defined, use that.
+         * - Else if `tree.types[<node.type>]` is a value, use that.
+         * - Else if `tree.options.<name>` is a value, use that.
+         * - Else use `defaultValue`.
          *
          * @param name name of the option property (on node and tree)
          * @param defaultValue return this if nothing else matched
+         * {@link Wunderbaum.getOption|Wunderbaum.getOption()}
          */
         getOption(name: string, defaultValue?: any): any;
+        /** Make sure that this node is visible in the viewport.
+         * @see {@link Wunderbaum.scrollTo|Wunderbaum.scrollTo()}
+         */
         scrollIntoView(options?: any): Promise<void>;
-        setActive(flag?: boolean, options?: any): Promise<void>;
-        setDirty(type: ChangeType): void;
-        setExpanded(flag?: boolean, options?: any): Promise<void>;
-        setIcon(): void;
-        setFocus(flag?: boolean, options?: any): void;
-        setSelected(flag?: boolean, options?: any): void;
-        /** Show node status (ok, loading, error, noData) using styles and a dummy child node.
+        /**
+         * Activate this node, deactivate previous, send events, activate column and scroll int viewport.
+         */
+        setActive(flag?: boolean, options?: SetActiveOptions): Promise<void>;
+        /**
+         * Expand or collapse this node.
+         */
+        setExpanded(flag?: boolean, options?: SetExpandedOptions): Promise<void>;
+        /**
+         * Set keyboard focus here.
+         * @see {@link setActive}
          */
+        setFocus(flag?: boolean, options?: any): void;
+        /** Set a new icon path or class. */
+        setIcon(): void;
+        /** Change node's {@link key} and/or {@link refKey}.  */
+        setKey(key: string | null, refKey: string | null): void;
+        /** Schedule a render, typically called to update after a status or data change. */
+        setModified(change?: ChangeType): void;
+        /** Modify the check/uncheck state. */
+        setSelected(flag?: boolean, options?: SetSelectedOptions): void;
+        /** Display node status (ok, loading, error, noData) using styles and a dummy child node. */
         setStatus(status: NodeStatusType, message?: string, details?: string): WunderbaumNode | null;
+        /** Rename this node. */
         setTitle(title: string): void;
         /**
          * Trigger `modifyChild` event on a parent to signal that a child was modified.
@@ -617,9 +948,12 @@ declare module "wb_node" {
          * @param {string} operation Type of change: 'add', 'remove', 'rename', 'move', 'data', ...
          * @param {object} [extra]
          */
-        triggerModify(operation: string, extra: any): void;
-        /** Call fn(node) for all child nodes in hierarchical order (depth-first).<br>
-         * Stop iteration, if fn() returns false. Skip current branch, if fn() returns "skip".<br>
+        triggerModify(operation: string, extra?: any): void;
+        /**
+         * Call fn(node) for all child nodes in hierarchical order (depth-first).
+         *
+         * Stop iteration, if fn() returns false. Skip current branch, if fn()
+         * returns "skip".<br>
          * Return false if iteration was stopped.
          *
          * @param {function} callback the callback function.
@@ -634,7 +968,8 @@ declare module "wb_node" {
          * @param callback the callback function. Return false to stop iteration
          */
         visitParents(callback: (node: WunderbaumNode) => boolean | void, includeSelf?: boolean): boolean;
-        /** Call fn(node) for all sibling nodes.<br>
+        /**
+         * Call fn(node) for all sibling nodes.<br>
          * Stop iteration, if fn() returns false.<br>
          * Return false if iteration was stopped.
          *
@@ -663,16 +998,16 @@ declare module "common" {
     export type NodeAnyCallback = (node: WunderbaumNode) => any;
     export type NodeVisitResponse = "skip" | boolean | void;
     export type NodeVisitCallback = (node: WunderbaumNode) => NodeVisitResponse;
-    export type WbEventType = {
+    export type WbTreeEventType = {
         name: string;
         event: Event;
         tree: Wunderbaum;
         [key: string]: unknown;
     };
-    export type WbNodeEventType = WbEventType & {
+    export type WbNodeEventType = WbTreeEventType & {
         node: WunderbaumNode;
     };
-    export type WbCallbackType = (e: WbEventType) => any;
+    export type WbTreeCallbackType = (e: WbTreeEventType) => any;
     export type WbNodeCallbackType = (e: WbNodeEventType) => any;
     export type FilterModeType = null | "dim" | "hide";
     export type ApplyCommandType = "moveUp" | "moveDown" | "indent" | "outdent" | "remove" | "rename" | "addChild" | "addSibling" | "cut" | "copy" | "paste" | "down" | "first" | "last" | "left" | "pageDown" | "pageUp" | "parent" | "right" | "up";
@@ -684,7 +1019,9 @@ declare module "common" {
         any = "any",
         row = "row",
         structure = "structure",
-        status = "status"
+        status = "status",
+        vscroll = "vscroll",
+        header = "header"
     }
     export enum NodeStatusType {
         ok = "ok",
@@ -731,6 +1068,32 @@ declare module "common" {
         cellNav = "cellNav",
         cellEdit = "cellEdit"
     }
+    export type SetActiveOptions = {
+        /** Generate (de)activate event, even if node already has this status. */
+        retrigger?: boolean;
+        /** Don not generate (de)activate event. */
+        noEvents?: boolean;
+        /** Optional original event that will be passed to the (de)activat handler. */
+        event?: Event;
+        /** Call {@link setColumn}. */
+        colIdx?: number;
+    };
+    export type SetExpandedOptions = {
+        /** Ignore {@link minExpandLevel}. @default false */
+        force?: boolean;
+        /** Avoid smooth scrolling. @default false */
+        noAnimation?: boolean;
+        /** Do not send events. @default false */
+        noEvents?: boolean;
+        /** Scroll to bring expanded nodes into viewport. @default false */
+        scrollIntoView?: boolean;
+    };
+    export type SetSelectedOptions = {
+        /** Ignore restrictions. @default false */
+        force?: boolean;
+        /** Do not send events. @default false */
+        noEvents?: boolean;
+    };
     /** Define which keys are handled by embedded <input> control, and should
      * *not* be passed to tree navigation handler in cell-edit mode: */
     export const INPUT_KEYS: {
@@ -753,27 +1116,6 @@ declare module "common" {
     /** */
     export function makeNodeTitleStartMatcher(s: string): MatcherType;
 }
-declare module "wb_extension_base" {
-    import { Wunderbaum } from "wunderbaum";
-    export type ExtensionsDict = {
-        [key: string]: WunderbaumExtension;
-    };
-    export abstract class WunderbaumExtension {
-        enabled: boolean;
-        readonly id: string;
-        readonly tree: Wunderbaum;
-        readonly treeOpts: any;
-        readonly extensionOpts: any;
-        constructor(tree: Wunderbaum, id: string, defaults: any);
-        /** Called on tree (re)init after all extensions are added, but before loading.*/
-        init(): void;
-        getPluginOption(name: string, defaultValue?: any): any;
-        setPluginOption(name: string, value: any): void;
-        setEnabled(flag?: boolean): void;
-        onKeyEvent(data: any): boolean | undefined;
-        onRender(data: any): boolean | undefined;
-    }
-}
 declare module "debounce" {
     /*!
      * debounce & throttle, taken from https://github.com/lodash/lodash v4.17.21
@@ -933,15 +1275,10 @@ declare module "wb_ext_filter" {
         filterBranches(filter: string | NodeFilterCallback, opts: any): void;
         /**
          * [ext-filter] Re-apply current filter.
-         *
-         * @requires jquery.fancytree.filter.js
          */
         updateFilter(): void;
         /**
          * [ext-filter] Reset the filter.
-         *
-         * @alias Fancytree#clearFilter
-         * @requires jquery.fancytree.filter.js
          */
         clearFilter(): void;
     }
@@ -965,30 +1302,75 @@ declare module "wb_ext_logger" {
         onKeyEvent(data: any): boolean | undefined;
     }
 }
-declare module "wb_ext_dnd" {
+declare module "drag_observer" {
+    export type DragCallbackArgType = {
+        /** "dragstart", "drag", or "dragstop". */
+        type: string;
+        /** Original mouse or touch event that triggered the drag event. */
+        event: MouseEvent | TouchEvent;
+        /** Element which is currently dragged. */
+        dragElem: HTMLElement | null;
+        /** Relative horizontal drag distance since start. */
+        dx: number;
+        /** Relative vertical drag distance since start. */
+        dy: number;
+        /** False if drag was canceled. */
+        apply?: boolean;
+    };
+    export type DragCallbackType = (e: DragCallbackArgType) => boolean | void;
+    type DragObserverOptionsType = {
+        /**Event target (typically `window.document`). */
+        root: EventTarget;
+        /**Event delegation selector.*/
+        selector?: string;
+        /**Minimum drag distance in px. */
+        thresh?: number;
+        /**Return `false` to cancel drag. */
+        dragstart: DragCallbackType;
+        drag?: DragCallbackType;
+        dragstop?: DragCallbackType;
+    };
+    /**
+     * Convert mouse- and touch events to 'dragstart', 'drag', and 'dragstop'.
+     */
+    export class DragObserver {
+        protected _handler: any;
+        protected root: EventTarget;
+        protected start: {
+            x: number;
+            y: number;
+            altKey: boolean;
+            ctrlKey: boolean;
+            metaKey: boolean;
+            shiftKey: boolean;
+        };
+        protected dragElem: HTMLElement | null;
+        protected dragging: boolean;
+        protected events: string[];
+        protected opts: DragObserverOptionsType;
+        constructor(opts: DragObserverOptionsType);
+        /** Unregister all event listeners. */
+        disconnect(): void;
+        getDragElem(): HTMLElement | null;
+        isDragging(): boolean;
+        stopDrag(cb_event?: DragCallbackArgType): void;
+        protected handleEvent(e: MouseEvent): boolean | void;
+    }
+}
+declare module "wb_ext_grid" {
+    /*!
+     * Wunderbaum - ext-grid
+     * Copyright (c) 2021-2022, Martin Wendt. Released under the MIT license.
+     * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
+     */
     import { Wunderbaum } from "wunderbaum";
     import { WunderbaumExtension } from "wb_extension_base";
-    import { WunderbaumNode } from "wb_node";
-    export type DropRegionType = "over" | "before" | "after";
-    type DropRegionTypeSet = Set<DropRegionType>;
-    export class DndExtension extends WunderbaumExtension {
-        protected srcNode: WunderbaumNode | null;
-        protected lastTargetNode: WunderbaumNode | null;
-        protected lastEnterStamp: number;
-        protected lastAllowedDropRegions: DropRegionTypeSet | null;
-        protected lastDropEffect: string | null;
-        protected lastDropRegion: DropRegionType | false;
+    import { DragCallbackArgType, DragObserver } from "drag_observer";
+    export class GridExtension extends WunderbaumExtension {
+        protected observer: DragObserver;
         constructor(tree: Wunderbaum);
         init(): void;
-        /** Cleanup classes after target node is no longer hovered. */
-        protected _leaveNode(): void;
-        /** */
-        protected unifyDragover(res: any): DropRegionTypeSet | false;
-        /** */
-        protected _calcDropRegion(e: DragEvent, allowed: DropRegionTypeSet | null): DropRegionType | false;
-        protected autoScroll(event: DragEvent): number;
-        protected onDragEvent(e: DragEvent): boolean;
-        protected onDropEvent(e: DragEvent): boolean;
+        protected handleDrag(e: DragCallbackArgType): void;
     }
 }
 declare module "wb_ext_edit" {
@@ -1053,67 +1435,79 @@ declare module "wunderbaum" {
      * See also [[WunderbaumOptions]].
      */
     export class Wunderbaum {
+        protected static sequence: number;
+        /** Wunderbaum release version number "MAJOR.MINOR.PATCH". */
         static version: string;
-        static sequence: number;
         /** The invisible root node, that holds all visible top level nodes. */
         readonly root: WunderbaumNode;
+        /** Unique tree ID as passed to constructor. Defaults to `"wb_SEQUENCE"`. */
         readonly id: string;
+        /** The `div` container element that was passed to the constructor. */
         readonly element: HTMLDivElement;
+        /** The `div.wb-header` element if any. */
         readonly headerElement: HTMLDivElement | null;
+        /** The `div.wb-scroll-container` element that contains the `nodeListElement`. */
         readonly scrollContainer: HTMLDivElement;
+        /** The `div.wb-node-list` element that contains all visible div.wb-row child elements. */
         readonly nodeListElement: HTMLDivElement;
-        readonly _updateViewportThrottled: DebouncedFunction<(...args: any) => void>;
+        protected readonly _updateViewportThrottled: DebouncedFunction<(...args: any) => void>;
         protected extensionList: WunderbaumExtension[];
         protected extensions: ExtensionsDict;
         /** Merged options from constructor args and tree- and extension defaults. */
         options: WunderbaumOptions;
         protected keyMap: Map<string, WunderbaumNode>;
         protected refKeyMap: Map<string, Set<WunderbaumNode>>;
-        protected viewNodes: Set<WunderbaumNode>;
+        protected treeRowCount: number;
+        protected _disableUpdateCount: number;
+        /** Currently active node if any. */
         activeNode: WunderbaumNode | null;
+        /** Current node hat has keyboard focus if any. */
         focusNode: WunderbaumNode | null;
-        _disableUpdate: number;
-        _disableUpdateCount: number;
         /** Shared properties, referenced by `node.type`. */
         types: {
             [key: string]: any;
         };
         /** List of column definitions. */
         columns: any[];
-        _columnsById: {
+        protected _columnsById: {
             [key: string]: any;
         };
-        protected resizeObserver: any;
-        protected changedSince: number;
-        protected changes: Set<ChangeType>;
-        protected changedNodes: Set<WunderbaumNode>;
+        protected resizeObserver: ResizeObserver;
+        protected changeRedrawRequestPending: boolean;
+        /** A Promise that is resolved when the tree was initialized (similar to `init(e)` event). */
+        readonly ready: Promise<any>;
+        /** Expose some useful methods of the util.ts module as `Wunderbaum.util`. */
+        static util: typeof util;
+        /** Expose some useful methods of the util.ts module as `tree._util`. */
+        _util: typeof util;
         filterMode: FilterModeType;
+        /** @internal Use `setColumn()`/`getActiveColElem()`*/
         activeColIdx: number;
+        /** @internal */
         navMode: NavigationMode;
+        /** @internal */
         lastQuicksearchTime: number;
+        /** @internal */
         lastQuicksearchTerm: string;
         protected lastClickTime: number;
-        readonly ready: Promise<any>;
-        static util: typeof util;
-        _util: typeof util;
         constructor(options: WunderbaumOptions);
-        /** */
-        /** Return a Wunderbaum instance, from element, index, or event.
+        /**
+         * Return a Wunderbaum instance, from element, id, index, or event.
          *
-         * @example
-         * getTree();  // Get first Wunderbaum instance on page
-         * getTree(1);  // Get second Wunderbaum instance on page
-         * getTree(event);  // Get tree for this mouse- or keyboard event
-         * getTree("foo");  // Get tree for this `tree.options.id`
+         * ```js
+         * getTree();         // Get first Wunderbaum instance on page
+         * getTree(1);        // Get second Wunderbaum instance on page
+         * getTree(event);    // Get tree for this mouse- or keyboard event
+         * getTree("foo");    // Get tree for this `tree.options.id`
          * getTree("#tree");  // Get tree for this matching element
+         * ```
          */
         static getTree(el?: Element | Event | number | string | WunderbaumNode): Wunderbaum | null;
-        /** Return a WunderbaumNode instance from element, event.
-         *
-         * @param  el
+        /**
+         * Return a WunderbaumNode instance from element or event.
          */
         static getNode(el: Element | Event): WunderbaumNode | null;
-        /** */
+        /** @internal */
         protected _registerExtension(extension: WunderbaumExtension): void;
         /** Called on tree (re)init after markup is created, before loading. */
         protected _initExtensions(): void;
@@ -1123,37 +1517,47 @@ declare module "wunderbaum" {
         _unregisterNode(node: WunderbaumNode): void;
         /** Call all hook methods of all registered extensions.*/
         protected _callHook(hook: keyof WunderbaumExtension, data?: any): any;
-        /** Call tree method or extension method if defined.
+        /**
+         * Call tree method or extension method if defined.
+         *
          * Example:
          * ```js
          * tree._callMethod("edit.startEdit", "arg1", "arg2")
          * ```
          */
         _callMethod(name: string, ...args: any[]): any;
-        /** Call event handler if defined in tree.options.
+        /**
+         * Call event handler if defined in tree or tree.EXTENSION options.
+         *
          * Example:
          * ```js
          * tree._callEvent("edit.beforeEdit", {foo: 42})
          * ```
          */
         _callEvent(name: string, extra?: any): any;
-        /** Return the topmost visible node in the viewport */
+        /** Return the node for  given row index. */
+        protected _getNodeByRowIdx(idx: number): WunderbaumNode | null;
+        /** Return the topmost visible node in the viewport. */
         protected _firstNodeInView(complete?: boolean): WunderbaumNode;
-        /** Return the lowest visible node in the viewport */
+        /** Return the lowest visible node in the viewport. */
         protected _lastNodeInView(complete?: boolean): WunderbaumNode;
-        /** Return preceeding visible node in the viewport */
+        /** Return preceeding visible node in the viewport. */
         protected _getPrevNodeInView(node?: WunderbaumNode, ofs?: number): WunderbaumNode;
-        /** Return following visible node in the viewport */
+        /** Return following visible node in the viewport. */
         protected _getNextNodeInView(node?: WunderbaumNode, ofs?: number): WunderbaumNode;
+        /**
+         * Append (or insert) a list of toplevel nodes.
+         *
+         * @see {@link WunderbaumNode.addChildren}
+         */
         addChildren(nodeData: any, options?: any): WunderbaumNode;
         /**
-         * Apply a modification (or navigation) operation on the tree or active node.
-         * @returns
+         * Apply a modification (or navigation) operation on the **tree or active node**.
          */
         applyCommand(cmd: ApplyCommandType, opts?: any): any;
         /**
-         * Apply a modification (or navigation) operation on a node.
-         * @returns
+         * Apply a modification (or navigation) operation on a **node**.
+         * @see {@link WunderbaumNode.applyCommand}
          */
         applyCommand(cmd: ApplyCommandType, node: WunderbaumNode, opts?: any): any;
         /** Delete all nodes. */
@@ -1169,10 +1573,11 @@ declare module "wunderbaum" {
         /**
          * Return `tree.option.NAME` (also resolving if this is a callback).
          *
-         * See also [[WunderbaumNode.getOption()]] to consider `node.NAME` setting and
-         * `tree.types[node.type].NAME`.
+         * See also {@link WunderbaumNode.getOption|WunderbaumNode.getOption()}
+         * to consider `node.NAME` setting and `tree.types[node.type].NAME`.
          *
-         * @param name option name (use dot notation to access extension option, e.g. `filter.mode`)
+         * @param name option name (use dot notation to access extension option, e.g.
+         * `filter.mode`)
          */
         getOption(name: string, defaultValue?: any): any;
         /**
@@ -1189,26 +1594,33 @@ declare module "wunderbaum" {
         expandAll(flag?: boolean): Promise<void>;
         /** Return the number of nodes in the data model.*/
         count(visible?: boolean): number;
+        /** @internal sanity check. */
         _check(): void;
-        /**Find all nodes that matches condition.
+        /**
+         * Find all nodes that matches condition.
          *
          * @param match title string to search for, or a
          *     callback function that returns `true` if a node is matched.
-         * @see [[WunderbaumNode.findAll]]
+         *
+         * @see {@link WunderbaumNode.findAll}
          */
         findAll(match: string | MatcherType): WunderbaumNode[];
-        /**Find first node that matches condition.
+        /**
+         * Find first node that matches condition.
          *
          * @param match title string to search for, or a
          *     callback function that returns `true` if a node is matched.
-         * @see [[WunderbaumNode.findFirst]]
+         * @see {@link WunderbaumNode.findFirst}
+         *
          */
         findFirst(match: string | MatcherType): WunderbaumNode;
-        /** Find the next visible node that starts with `match`, starting at `startNode`
+        /**
+         * Find the next visible node that starts with `match`, starting at `startNode`
          * and wrap-around at the end.
          */
         findNextNode(match: string | MatcherType, startNode?: WunderbaumNode | null): WunderbaumNode | null;
-        /** Find a node relative to another node.
+        /**
+         * Find a node relative to another node.
          *
          * @param node
          * @param where 'down', 'first', 'last', 'left', 'parent', 'right', or 'up'.
@@ -1218,34 +1630,35 @@ declare module "wunderbaum" {
          */
         findRelatedNode(node: WunderbaumNode, where: string, includeHidden?: boolean): any;
         /**
-         * Return the active cell of the currently active node or null.
+         * Return the active cell (`span.wb-col`) of the currently active node or null.
          */
         getActiveColElem(): HTMLSpanElement;
         /**
          * Return the currently active node or null.
          */
         getActiveNode(): WunderbaumNode;
-        /** Return the first top level node if any (not the invisible root node).
-         * @returns {FancytreeNode | null}
+        /**
+         * Return the first top level node if any (not the invisible root node).
          */
         getFirstChild(): WunderbaumNode;
         /**
          * Return the currently active node or null.
          */
         getFocusNode(): WunderbaumNode;
-        /** Return a {node: FancytreeNode, region: TYPE} object for a mouse event.
+        /** Return a {node: WunderbaumNode, region: TYPE} object for a mouse event.
          *
          * @param {Event} event Mouse event, e.g. click, ...
-         * @returns {object} Return a {node: FancytreeNode, region: TYPE} object
+         * @returns {object} Return a {node: WunderbaumNode, region: TYPE} object
          *     TYPE: 'title' | 'prefix' | 'expander' | 'checkbox' | 'icon' | undefined
          */
         static getEventInfo(event: Event): {
+            tree: Wunderbaum;
             node: WunderbaumNode;
             region: NodeRegion;
             colDef: any;
             colIdx: number;
             colId: any;
-            colElem: Element;
+            colElem: HTMLSpanElement;
         };
         /**
          * Return readable string representation for this instance.
@@ -1254,15 +1667,19 @@ declare module "wunderbaum" {
         toString(): string;
         /** Return true if any node is currently in edit-title mode. */
         isEditing(): boolean;
-        /** Return true if any node is currently beeing loaded, i.e. a Ajax request is pending.
+        /**
+         * Return true if any node is currently beeing loaded, i.e. a Ajax request is pending.
          */
         isLoading(): boolean;
-        /** Alias for `logDebug` */
+        /** Alias for {@link Wunderbaum.logDebug}.
+         * @alias Wunderbaum.logDebug
+         */
         log: (...args: any[]) => void;
         /** Log to console if opts.debugLevel >= 4 */
         logDebug(...args: any[]): void;
         /** Log error to console. */
         logError(...args: any[]): void;
+        /** Log to console if opts.debugLevel >= 3 */
         logInfo(...args: any[]): void;
         /** @internal */
         logTime(label: string): string;
@@ -1270,41 +1687,69 @@ declare module "wunderbaum" {
         logTimeEnd(label: string): void;
         /** Log to console if opts.debugLevel >= 2 */
         logWarn(...args: any[]): void;
-        /** */
-        protected render(opts?: any): boolean;
-        /**Recalc and apply header columns from `this.columns`. */
-        renderHeader(): void;
         /**
+         * Make sure that this node is scrolled into the viewport.
          *
          * @param {boolean | PlainObject} [effects=false] animation options.
          * @param {object} [options=null] {topNode: null, effects: ..., parent: ...}
          *     this node will remain visible in
          *     any case, even if `this` is outside the scroll pane.
-         * Make sure that a node is scrolled into the viewport.
          */
         scrollTo(opts: any): void;
-        /** */
-        setCellMode(mode: NavigationMode): void;
-        /** */
+        /**
+         * Set column #colIdx to 'active'.
+         *
+         * This higlights the column header and -cells by adding the `wb-active` class.
+         * Available in cell-nav and cell-edit mode, not in row-mode.
+         */
         setColumn(colIdx: number): void;
-        /** */
+        /** Set or remove keybaord focus to the tree container. */
         setFocus(flag?: boolean): void;
-        /** */
+        /** Schedule an update request to reflect a tree change. */
         setModified(change: ChangeType, options?: any): void;
+        /** Schedule an update request to reflect a single node modification. */
+        setModified(change: ChangeType, node: WunderbaumNode, options?: any): void;
+        /** Set the tree's navigation mode. */
+        setNavigationMode(mode: NavigationMode): void;
+        /** Display tree status (ok, loading, error, noData) using styles and a dummy root node. */
         setStatus(status: NodeStatusType, message?: string, details?: string): WunderbaumNode | null;
         /** Update column headers and width. */
-        updateColumns(opts: any): void;
-        /** Render all rows that are visible in the viewport. */
+        updateColumns(opts?: any): void;
+        /** Create/update header markup from `this.columns` definition.
+         * @internal
+         */
+        protected _renderHeaderMarkup(): void;
+        /** Render header and all rows that are visible in the viewport (async, throttled). */
         updateViewport(immediate?: boolean): void;
+        /**
+         * This is the actual update method, which is wrapped inside a throttle method.
+         * This protected method should not be called directly but via
+         * `tree.updateViewport()` or `tree.setModified()`.
+         * It calls `updateColumns()` and `_updateRows()`.
+         * @internal
+         */
         protected _updateViewport(): void;
-        /** Call callback(node) for all nodes in hierarchical order (depth-first).
+        /**
+         * Assert that TR order matches the natural node order
+         * @internal
+         */
+        protected _validateRows(): boolean;
+        protected _updateRows(opts?: any): boolean;
+        /**
+         * Call callback(node) for all nodes in hierarchical order (depth-first).
          *
          * @param {function} callback the callback function.
-         *     Return false to stop iteration, return "skip" to skip this node and children only.
+         *     Return false to stop iteration, return "skip" to skip this node and
+         *     children only.
          * @returns {boolean} false, if the iterator was stopped.
          */
         visit(callback: (node: WunderbaumNode) => any): import("common").NodeVisitResponse;
-        /** Call fn(node) for all nodes in vertical order, top down (or bottom up).<br>
+        /**
+         * Call fn(node) for all nodes in vertical order, top down (or bottom up).
+         *
+         * Note that this considers expansion state, i.e. children of collapsed nodes
+         * are skipped.
+         *
          * Stop iteration, if fn() returns false.<br>
          * Return false if iteration was stopped.
          *
@@ -1316,14 +1761,32 @@ declare module "wunderbaum" {
          * @returns {boolean} false if iteration was canceled
          */
         visitRows(callback: (node: WunderbaumNode) => any, opts?: any): boolean;
-        /** Call fn(node) for all nodes in vertical order, bottom up.
+        /**
+         * Call fn(node) for all nodes in vertical order, bottom up.
          * @internal
          */
         protected _visitRowsUp(callback: (node: WunderbaumNode) => any, opts: any): boolean;
-        /** . */
+        /**
+         * Reload the tree with a new source.
+         *
+         * Previous data is cleared.
+         * Pass `options.columns` to define a header (may also be part of `source.columns`).
+         */
         load(source: any, options?: any): Promise<void>;
         /**
+         * Disable render requests during operations that would trigger many updates.
          *
+         * ```js
+         * try {
+         *   tree.enableUpdate(false);
+         *   // ... (long running operation that would trigger many updates)
+         *   foo();
+         *   // ... NOTE: make sure that async operations have finished
+         *   await foo();
+         * } finally {
+         *   tree.enableUpdate(true);
+         * }
+         * ```
          */
         enableUpdate(flag: boolean): void;
         /**