wunderbaum 0.0.5 → 0.0.6

package/dist/wunderbaum.d.ts

@@ -95,6 +95,8 @@ declare module "util" {
      * @param value a value that matches the target element.
      */
     export function setValueToElem(elem: HTMLElement, value: any): void;
+    /** Show/hide element by setting the `display`style to 'none'. */
+    export function setElemDisplay(elem: string | Element, flag: boolean): void;
     /** 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. */
@@ -214,6 +216,56 @@ declare module "util" {
      */
     export function adaptiveThrottle(this: unknown, callback: (...args: any[]) => void, options: any): (...args: any[]) => void;
 }
+declare module "common" {
+    /*!
+     * Wunderbaum - common
+     * Copyright (c) 2021-2022, Martin Wendt. Released under the MIT license.
+     * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
+     */
+    import { MatcherType } from "types";
+    export const DEFAULT_DEBUGLEVEL = 4;
+    export const ROW_HEIGHT = 22;
+    export const ICON_WIDTH = 20;
+    export const ROW_EXTRA_PAD = 7;
+    export const RENDER_MIN_PREFETCH = 5;
+    export const RENDER_MAX_PREFETCH = 5;
+    export const TEST_IMG: RegExp;
+    export let iconMap: {
+        error: string;
+        loading: string;
+        noData: string;
+        expanderExpanded: string;
+        expanderCollapsed: string;
+        expanderLazy: string;
+        checkChecked: string;
+        checkUnchecked: string;
+        checkUnknown: string;
+        radioChecked: string;
+        radioUnchecked: string;
+        radioUnknown: string;
+        folder: string;
+        folderOpen: string;
+        doc: string;
+    };
+    export const KEY_NODATA = "__not_found__";
+    /** 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: {
+        [key: string]: Array<string>;
+    };
+    /** Dict keys that are evaluated by source loader (others are added to `tree.data` instead). */
+    export const RESERVED_TREE_SOURCE_KEYS: Set<string>;
+    /** Key codes that trigger grid navigation, even when inside an input element. */
+    export const INPUT_BREAKOUT_KEYS: Set<string>;
+    /** Map `KeyEvent.key` to navigation action. */
+    export const KEY_TO_ACTION_DICT: {
+        [key: string]: string;
+    };
+    /** Return a callback that returns true if the node title contains a substring (case-insensitive). */
+    export function makeNodeTitleMatcher(s: string): MatcherType;
+    /** Return a callback that returns true if the node title starts with a string (case-insensitive). */
+    export function makeNodeTitleStartMatcher(s: string): MatcherType;
+}
 declare module "deferred" {
     /*!
      * Wunderbaum - deferred
@@ -256,174 +308,13 @@ 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, WbNodeEventType, WbTreeEventType } from "common";
-    import { DndOptionsType } from "wb_ext_dnd";
+    import { BoolOptionResolver, ColumnDefinitionList, DndOptionsType, NavigationOptions, NodeTypeDefinitions, WbNodeEventType, WbRenderEventType, WbTreeEventType } from "types";
     export interface WbNodeData {
         title: string;
         key?: string;
@@ -433,39 +324,6 @@ declare module "wb_options" {
         checkbox?: boolean | string;
         children?: Array<WbNodeData>;
     }
-    export interface ColumnDefinition {
-        /** Column ID (pass "*" for the main tree nodes column ) */
-        id: string;
-        /** Column header (defaults to id) */
-        title: string;
-        /** Column width or weight.
-         * Either an absolute pixel value (e.g. `"50px"`) or a relative weight (e.g. `1`)
-         * that is used to calculate the width  inside the remaining available space.
-         * Default: `"*"`, which is interpreted as `1`.
-         */
-        width?: string | number;
-        /** Only used for columns with a relative weight.
-         * Default: `4px`.
-         */
-        minWidth?: string | number;
-        /** Optional class names that are added to all `span.wb-col` elements of that column.*/
-        classes?: string;
-        /** Optional HTML content that is rendered into all `span.wb-col` elements of that column.*/
-        html: string;
-    }
-    export interface TypeDefinition {
-        /** En/disable checkbox for matching nodes.*/
-        checkbox?: boolean | BoolOptionResolver;
-        /** Optional class names that are added to all `div.wb-row` elements of matching nodes.*/
-        classes?: string;
-        /**Default icon for matching nodes.*/
-        icon?: boolean | string | BoolOptionResolver;
-        /**
-         * See also {@link WunderbaumNode.getOption|WunderbaumNode.getOption()}
-         * to evaluate `node.NAME` setting and `tree.types[node.type].NAME`.
-         */
-        _any: any;
-    }
     /**
      * Available options for [[Wunderbaum]].
      *
@@ -522,9 +380,7 @@ declare module "wb_options" {
          *
          * Default: `{}`.
          */
-        types?: {
-            [key: string]: TypeDefinition;
-        };
+        types?: NodeTypeDefinitions;
         /**
          * A list of maps that define column headers. If this option is set,
          * Wunderbaum becomes a treegrid control instead of a plain tree.
@@ -532,7 +388,7 @@ declare module "wb_options" {
          * response.
          * Default: `[]` meaning this is a plain tree.
          */
-        columns?: Array<ColumnDefinition>;
+        columns?: ColumnDefinitionList;
         /**
          * 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
@@ -551,14 +407,10 @@ declare module "wb_options" {
         debugLevel: number;
         /**
          * Number of levels that are forced to be expanded, and have no expander icon.
+         * E.g. 1 would keep all toplevel nodes expanded.
          * Default: 0
          */
         minExpandLevel?: number;
-        /**
-         * Height of the header row div.
-         * Default: 22
-         */
-        headerHeightPx: number;
         /**
          * Height of a node row div.
          * Default: 22
@@ -573,13 +425,17 @@ declare module "wb_options" {
          * HTMLElement that receives the top nodes breadcrumb.
          * Default: undefined
          */
-        attachBreadcrumb?: HTMLElement;
+        connectTopBreadcrumb?: HTMLElement;
         /**
-         * Default:  NavigationModeOption.startRow
+         * Default:  NavigationOptions.startRow
          */
-        navigationMode?: NavigationModeOption;
+        navigationModeOption?: NavigationOptions;
         /**
-         * Show/hide header (pass bool or string)
+         * Show/hide header (default: null)
+         * null: assume false for plain tree and true for grids.
+         * string: use text as header (only for plain trees)
+         * true: display a header (use tree's id as text for plain trees)
+         * false: do not display a header
          */
         header?: boolean | string | null;
         /**
@@ -587,7 +443,9 @@ declare module "wb_options" {
          */
         showSpinner?: boolean;
         /**
-         * Default: true
+         * If true, render a checkbox before the node tile to allow selection with the
+         * mouse.
+         * Default: false.
          */
         checkbox?: boolean | "radio" | BoolOptionResolver;
         /**
@@ -628,6 +486,15 @@ declare module "wb_options" {
         click?: (e: WbTreeEventType) => void;
         /**
          *
+         * Return `false` to prevent default handling, e.g. activating the node.
+         * @category Callback
+         */
+        beforeActivate?: (e: WbNodeEventType) => void;
+        /**
+        /**
+         *
+         * Return `false` to prevent default handling, e.g. deactivating the node
+         * and activating the next.
          * @category Callback
          */
         deactivate?: (e: WbNodeEventType) => void;
@@ -698,7 +565,7 @@ declare module "wb_options" {
          * See also `Custom Rendering` for details.
          * @category Callback
          */
-        render?: (e: WbNodeEventType) => void;
+        render?: (e: WbRenderEventType) => void;
         /**
          *
          * @category Callback
@@ -725,7 +592,7 @@ declare module "wb_node" {
      */
     import "./wunderbaum.scss";
     import { Wunderbaum } from "wunderbaum";
-    import { ChangeType, MatcherType, NodeAnyCallback, NodeStatusType, NodeVisitCallback, NodeVisitResponse, ApplyCommandType, AddNodeType, SetActiveOptions, SetExpandedOptions, SetSelectedOptions } from "common";
+    import { AddNodeType, ApplyCommandType, ChangeType, MakeVisibleOptions, MatcherType, NodeAnyCallback, NodeStatusType, NodeVisitCallback, NodeVisitResponse, ScrollIntoViewOptions, SetActiveOptions, SetExpandedOptions, SetSelectedOptions, SetStatusOptions } from "types";
     import { WbNodeData } from "wb_options";
     /**
      * A single tree node.
@@ -753,6 +620,7 @@ declare module "wb_node" {
         readonly refKey: string | undefined;
         children: WunderbaumNode[] | null;
         checkbox?: boolean;
+        /** If true, (in grid mode) no cells are rendered, except for the node title.*/
         colspan?: boolean;
         icon?: boolean | string;
         lazy: boolean;
@@ -831,7 +699,7 @@ declare module "wb_node" {
          *     as space-separated string, array of strings, or set of strings.
          */
         setClass(className: string | string[] | Set<string>, flag?: boolean): void;
-        /** */
+        /** Call `setExpanded()` on al child nodes*/
         expandAll(flag?: boolean): Promise<void>;
         /**Find all nodes that match condition (excluding self).
          *
@@ -895,6 +763,10 @@ declare module "wb_node" {
          * (See also [[isDescendantOf]].)
          */
         isChildOf(other: WunderbaumNode): boolean;
+        /** Return true if this node's title spans all columns, i.e. the node has no
+         * grid cells.
+         */
+        isColspan(): boolean;
         /** Return true if this node is a direct or indirect sub node of `other`.
          * (See also [[isChildOf]].)
          */
@@ -962,7 +834,7 @@ declare module "wb_node" {
          * @param {object} [opts] passed to `setExpanded()`.
          *     Defaults to {noAnimation: false, noEvents: false, scrollIntoView: true}
          */
-        makeVisible(opts: any): Promise<any>;
+        makeVisible(opts?: MakeVisibleOptions): Promise<any>;
         /** Move this node to targetNode. */
         moveTo(targetNode: WunderbaumNode, mode?: AddNodeType, map?: NodeAnyCallback): void;
         /** Set focus relative to this node and optionally activate.
@@ -984,24 +856,22 @@ declare module "wb_node" {
         removeChildren(): void;
         /** Remove all HTML markup from the DOM. */
         removeMarkup(): void;
-        protected _getRenderInfo(): {
-            [key: string]: any;
-        };
+        protected _getRenderInfo(): any;
         protected _createIcon(parentElem: HTMLElement, replaceChild?: HTMLElement): HTMLElement | null;
         /**
          * Create a whole new `<div class="wb-row">` element.
-         * @see {@link Wunderbaumode.render}
+         * @see {@link WunderbaumNode.render}
          */
         protected _render_markup(opts: any): void;
         /**
          * Render `node.title`, `.icon` into an existing row.
          *
-         * @see {@link Wunderbaumode.render}
+         * @see {@link WunderbaumNode.render}
          */
         protected _render_data(opts: any): void;
         /**
          * Update row classes to reflect active, focuses, etc.
-         * @see {@link Wunderbaumode.render}
+         * @see {@link WunderbaumNode.render}
          */
         protected _render_status(opts: any): void;
         /**
@@ -1052,11 +922,11 @@ declare module "wb_node" {
         /** Make sure that this node is visible in the viewport.
          * @see {@link Wunderbaum.scrollTo|Wunderbaum.scrollTo()}
          */
-        scrollIntoView(options?: any): Promise<void>;
+        scrollIntoView(options?: ScrollIntoViewOptions): Promise<void>;
         /**
          * Activate this node, deactivate previous, send events, activate column and scroll int viewport.
          */
-        setActive(flag?: boolean, options?: SetActiveOptions): Promise<void>;
+        setActive(flag?: boolean, options?: SetActiveOptions): Promise<any>;
         /**
          * Expand or collapse this node.
          */
@@ -1065,7 +935,7 @@ declare module "wb_node" {
          * Set keyboard focus here.
          * @see {@link setActive}
          */
-        setFocus(flag?: boolean, options?: any): void;
+        setFocus(flag?: boolean): void;
         /** Set a new icon path or class. */
         setIcon(): void;
         /** Change node's {@link key} and/or {@link refKey}.  */
@@ -1081,7 +951,7 @@ declare module "wb_node" {
         /** 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;
+        setStatus(status: NodeStatusType, options?: SetStatusOptions): WunderbaumNode | null;
         /** Rename this node. */
         setTitle(title: string): void;
         /**
@@ -1129,32 +999,127 @@ declare module "wb_node" {
         isMatched(): boolean;
     }
 }
-declare module "common" {
+declare module "types" {
+    /*!
+     * Wunderbaum - types
+     * Copyright (c) 2021-2022, Martin Wendt. Released under the MIT license.
+     * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
+     */
     import { WunderbaumNode } from "wb_node";
     import { Wunderbaum } from "wunderbaum";
     export type MatcherType = (node: WunderbaumNode) => boolean;
     export type BoolOptionResolver = (node: WunderbaumNode) => boolean;
-    export const DEFAULT_DEBUGLEVEL = 4;
-    export const ROW_HEIGHT = 22;
-    export const ICON_WIDTH = 20;
-    export const ROW_EXTRA_PAD = 7;
-    export const RENDER_MIN_PREFETCH = 5;
-    export const RENDER_MAX_PREFETCH = 5;
-    export const TEST_IMG: RegExp;
     export type NodeAnyCallback = (node: WunderbaumNode) => any;
     export type NodeVisitResponse = "skip" | boolean | void;
     export type NodeVisitCallback = (node: WunderbaumNode) => NodeVisitResponse;
-    export type WbTreeEventType = {
+    export interface WbTreeEventType {
+        /** Name of the event. */
         type: string;
-        event: Event;
+        /** The affected tree. */
         tree: Wunderbaum;
+        /** Originating HTML event, e.g. `click` if any. */
+        event?: Event;
+    }
+    export interface WbNodeEventType extends WbTreeEventType {
+        /** The affected target node. */
+        node: WunderbaumNode;
+        /**
+         * Contains the node's type information, i.e. `tree.types[node.type]` if
+         * defined. Set to `{}` otherwise. @see {@link Wunderbaum.types}
+         */
+        typeInfo: NodeTypeDefinition;
+    }
+    export interface WbRenderEventType extends WbNodeEventType {
+        /**
+         * True if the node's markup was not yet created. In this case the render
+         * event should create embeddeb input controls (in addition to update the
+         * values according to to current node data).
+         */
+        isNew: boolean;
+        /** True if the node only displays the title and is stretched over all remaining columns. */
+        isColspan: boolean;
+        /** The node's `<span class='wb-node'>` element. */
+        nodeElem: HTMLSpanElement;
+        /**
+         * Array of node's `<span class='wb-col'>` elements.
+         * The first element is `<span class='wb-node wb-col'>`, which contains the
+         * node title and icon (`idx: 0`, id: '*'`).
+         */
+        allColInfosById: ColumnEventInfos;
+        /**
+         * Array of node's `<span class='wb-node'>` elements, *that should be rendered*.
+         * In contrast to `allColInfosById`, the node title is not part of this array.
+         * If node.isColspan() is true, this array is empty (`[]`).
+         */
+        renderColInfosById: ColumnEventInfos;
+    }
+    /**
+     * Contains the node's type information, i.e. `tree.types[node.type]` if
+     * defined. @see {@link Wunderbaum.types}
+     */
+    export interface NodeTypeDefinition {
+        /** En/disable checkbox for matching nodes.*/
+        checkbox?: boolean | BoolOptionResolver;
+        /** En/disable checkbox for matching nodes.*/
+        colspan?: boolean | BoolOptionResolver;
+        /** Optional class names that are added to all `div.wb-row` elements of matching nodes.*/
+        classes?: string;
+        /**Default icon for matching nodes.*/
+        icon?: boolean | string | BoolOptionResolver;
+        /**
+         * See also {@link WunderbaumNode.getOption|WunderbaumNode.getOption()}
+         * to evaluate `node.NAME` setting and `tree.types[node.type].NAME`.
+         */
         [key: string]: unknown;
+    }
+    export type NodeTypeDefinitions = {
+        [type: string]: NodeTypeDefinition;
     };
-    export type WbNodeEventType = WbTreeEventType & {
-        node: WunderbaumNode;
+    /**
+     * @see {@link `Wunderbaum.columns`}
+     */
+    export interface ColumnDefinition {
+        /** Column ID as defined in `tree.columns` definition ("*" for title column). */
+        id: string;
+        /** Column header (defaults to id) */
+        title: string;
+        /** Column header tooltip (optional) */
+        tooltip?: string;
+        /** Column width or weight.
+         * Either an absolute pixel value (e.g. `"50px"`) or a relative weight (e.g. `1`)
+         * that is used to calculate the width  inside the remaining available space.
+         * Default: `"*"`, which is interpreted as `1`.
+         */
+        width?: string | number;
+        /** Only used for columns with a relative weight.
+         * Default: `4px`.
+         */
+        minWidth?: string | number;
+        /** Optional class names that are added to all `span.wb-col` elements of that column.*/
+        classes?: string;
+        /** Optional HTML content that is rendered into all `span.wb-col` elements of that column.*/
+        html?: string;
+        _weight?: number;
+        _widthPx?: number;
+        _ofsPx?: number;
+    }
+    export type ColumnDefinitionList = Array<ColumnDefinition>;
+    export interface ColumnEventInfo {
+        /** Column ID as defined in `tree.columns` definition ("*" for title column). */
+        id: string;
+        /** Column index (0: leftmost title column). */
+        idx: number;
+        /** The cell's `<span class='wb-col'>` element (null for plain trees). */
+        elem: HTMLSpanElement | null;
+        /** The value of `tree.columns[]` for the current index. */
+        info: ColumnDefinition;
+    }
+    export type ColumnEventInfos = {
+        [colId: string]: ColumnEventInfo;
     };
     export type WbTreeCallbackType = (e: WbTreeEventType) => any;
     export type WbNodeCallbackType = (e: WbNodeEventType) => any;
+    export type WbRenderCallbackType = (e: WbRenderEventType) => void;
     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";
     export type NodeFilterResponse = "skip" | "branch" | boolean | void;
@@ -1195,87 +1160,222 @@ declare module "common" {
         prefix = "prefix",
         title = "title"
     }
-    export let iconMap: {
-        error: string;
-        loading: string;
-        noData: string;
-        expanderExpanded: string;
-        expanderCollapsed: string;
-        expanderLazy: string;
-        checkChecked: string;
-        checkUnchecked: string;
-        checkUnknown: string;
-        radioChecked: string;
-        radioUnchecked: string;
-        radioUnknown: string;
-        folder: string;
-        folderOpen: string;
-        doc: string;
-    };
-    export const KEY_NODATA = "__not_found__";
     /** Initial navigation mode and possible transition. */
-    export enum NavigationModeOption {
+    export enum NavigationOptions {
         startRow = "startRow",
         cell = "cell",
         startCell = "startCell",
         row = "row"
     }
-    /** Tree's current navigation mode (see `tree.setNavigationMode()`). */
-    export enum NavigationMode {
-        row = "row",
-        cellNav = "cellNav",
-        cellEdit = "cellEdit"
+    /** Possible values for `node.makeVisible()`. */
+    export interface MakeVisibleOptions {
+        /** Do not animate expand (currently not implemented). @default false */
+        noAnimation?: boolean;
+        /** Scroll node into visible viewport area if required. @default true */
+        scrollIntoView?: boolean;
+        /** Do not send events. @default false */
+        noEvents?: boolean;
+    }
+    /** Possible values for `node.scrollIntoView()`. */
+    export interface ScrollIntoViewOptions {
+        /** Do not animate (currently not implemented). @default false */
+        noAnimation?: boolean;
+        /** Do not send events. @default false */
+        noEvents?: boolean;
+        /** Keep this node visible at the top in any case. */
+        topNode?: WunderbaumNode;
+        /** Add N pixel offset at top. */
+        ofsY?: number;
+    }
+    /** Possible values for `tree.scrollTo()`. */
+    export interface ScrollToOptions extends ScrollIntoViewOptions {
+        /** Which node to scroll into the viewport.*/
+        node: WunderbaumNode;
     }
-    /** 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: {
-        text: string[];
-        number: string[];
-        checkbox: any[];
-        link: any[];
-        radiobutton: string[];
-        "select-one": string[];
-        "select-multiple": string[];
-    };
-    /** Key codes that trigger grid navigation, even when inside an input element. */
-    export const NAVIGATE_IN_INPUT_KEYS: Set<string>;
     /** Possible values for `node.setActive()`. */
-    export type SetActiveOptions = {
-        /** Generate (de)activate event, even if node already has this status. */
+    export interface SetActiveOptions {
+        /** Generate (de)activate event, even if node already has this status (default: false). */
         retrigger?: boolean;
-        /** Do not generate (de)activate event. */
+        /** Do not generate (de)activate event  (default: false). */
         noEvents?: boolean;
+        /** Set node as focused node (default: true). */
+        focusNode?: boolean;
+        /** Set node as focused node (default: false). */
+        focusTree?: boolean;
         /** Optional original event that will be passed to the (de)activate handler. */
         event?: Event;
         /** Call {@link setColumn}. */
         colIdx?: number;
-    };
+    }
     /** Possible values for `node.setExpanded()`. */
-    export type SetExpandedOptions = {
+    export interface SetExpandedOptions {
         /** Ignore {@link minExpandLevel}. @default false */
         force?: boolean;
-        /** Avoid smooth scrolling. @default false */
+        /** Immediately update viewport (async otherwise). @default false */
+        immediate?: boolean;
+        /** Do not animate expand (currently not implemented). @default false */
         noAnimation?: boolean;
         /** Do not send events. @default false */
         noEvents?: boolean;
-        /** Scroll to bring expanded nodes into viewport. @default false */
+        /** Scroll up to bring expanded nodes into viewport. @default false */
         scrollIntoView?: boolean;
-    };
+    }
+    /** Possible values for `node.setSetModified()`. */
+    export interface SetModifiedOptions {
+        /** Force immediate redraw instead of throttled/async mode. @default false */
+        immediate?: boolean;
+        /** Remove HTML markup of all rendered nodes before redraw. @default false */
+        removeMarkup?: boolean;
+    }
     /** Possible values for `node.setSelected()`. */
-    export type SetSelectedOptions = {
+    export interface SetSelectedOptions {
         /** Ignore restrictions. @default false */
         force?: boolean;
         /** Do not send events. @default false */
         noEvents?: boolean;
+    }
+    /** Possible values for `node.setSetModified()`. */
+    export interface SetStatusOptions {
+        /** Displayed as status node title. */
+        message?: string;
+        /** Used as tooltip. */
+        details?: string;
+    }
+    export type DropRegionType = "over" | "before" | "after";
+    export 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;
     };
-    /** Map `KeyEvent.key` to navigation action. */
-    export const KEY_TO_ACTION_DICT: {
-        [key: string]: string;
+}
+declare module "wb_extension_base" {
+    import { Wunderbaum } from "wunderbaum";
+    export type ExtensionsDict = {
+        [key: string]: WunderbaumExtension;
     };
-    /** Return a callback that returns true if the node title contains a substring (case-insensitive). */
-    export function makeNodeTitleMatcher(s: string): MatcherType;
-    /** Return a callback that returns true if the node title starts with a string (case-insensitive). */
-    export function makeNodeTitleStartMatcher(s: string): MatcherType;
+    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" {
     /*!
@@ -1412,7 +1512,7 @@ declare module "debounce" {
     export function throttle<F extends Procedure>(func: F, wait?: number, options?: ThrottleOptions): DebouncedFunction<F>;
 }
 declare module "wb_ext_filter" {
-    import { NodeFilterCallback } from "common";
+    import { NodeFilterCallback } from "types";
     import { Wunderbaum } from "wunderbaum";
     import { WunderbaumExtension } from "wb_extension_base";
     export class FilterExtension extends WunderbaumExtension {
@@ -1450,7 +1550,8 @@ declare module "wb_ext_keynav" {
     import { WunderbaumExtension } from "wb_extension_base";
     export class KeynavExtension extends WunderbaumExtension {
         constructor(tree: Wunderbaum);
-        protected _getEmbeddedInputElem(elem: any, setFocus?: boolean): HTMLInputElement | null;
+        protected _getEmbeddedInputElem(elem: any): HTMLInputElement | null;
+        protected _isCurInputFocused(): boolean;
         onKeyEvent(data: any): boolean | undefined;
     }
 }
@@ -1465,6 +1566,31 @@ declare module "wb_ext_logger" {
         onKeyEvent(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 { DropRegionType, DropRegionTypeSet } from "types";
+    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 "drag_observer" {
     export type DragCallbackArgType = {
         /** "dragstart", "drag", or "dragstop". */
@@ -1545,7 +1671,7 @@ declare module "wb_ext_edit" {
     import { Wunderbaum } from "wunderbaum";
     import { WunderbaumExtension } from "wb_extension_base";
     import { WunderbaumNode } from "wb_node";
-    import { AddNodeType } from "common";
+    import { AddNodeType } from "types";
     import { WbNodeData } from "wb_options";
     export class EditExtension extends WunderbaumExtension {
         protected debouncedOnChange: (e: Event) => void;
@@ -1589,7 +1715,7 @@ declare module "wunderbaum" {
     import "./wunderbaum.scss";
     import * as util from "util";
     import { ExtensionsDict, WunderbaumExtension } from "wb_extension_base";
-    import { NavigationMode, ChangeType, FilterModeType, MatcherType, NodeStatusType, TargetType as NodeRegion, ApplyCommandType, SetActiveOptions } from "common";
+    import { ApplyCommandType, ChangeType, ColumnDefinitionList, FilterModeType, MatcherType, NavigationOptions, NodeStatusType, NodeTypeDefinitions, ScrollToOptions, SetActiveOptions, SetStatusOptions, TargetType as NodeRegion } from "types";
     import { WunderbaumNode } from "wb_node";
     import { WunderbaumOptions } from "wb_options";
     /**
@@ -1609,11 +1735,15 @@ declare module "wunderbaum" {
         /** The `div` container element that was passed to the constructor. */
         readonly element: HTMLDivElement;
         /** The `div.wb-header` element if any. */
-        readonly headerElement: HTMLDivElement | null;
+        readonly headerElement: HTMLDivElement;
         /** The `div.wb-scroll-container` element that contains the `nodeListElement`. */
         readonly scrollContainerElement: HTMLDivElement;
         /** The `div.wb-node-list` element that contains all visible div.wb-row child elements. */
         readonly nodeListElement: HTMLDivElement;
+        /** Contains additional data that was sent as response to an Ajax source load request. */
+        readonly data: {
+            [key: string]: any;
+        };
         protected readonly _updateViewportThrottled: (...args: any) => void;
         protected extensionList: WunderbaumExtension[];
         protected extensions: ExtensionsDict;
@@ -1628,16 +1758,15 @@ declare module "wunderbaum" {
         /** Current node hat has keyboard focus if any. */
         focusNode: WunderbaumNode | null;
         /** Shared properties, referenced by `node.type`. */
-        types: {
-            [key: string]: any;
-        };
+        types: NodeTypeDefinitions;
         /** List of column definitions. */
-        columns: any[];
+        columns: ColumnDefinitionList;
         protected _columnsById: {
             [key: string]: any;
         };
         protected resizeObserver: ResizeObserver;
         protected changeRedrawRequestPending: boolean;
+        protected changeScrollRequestPending: 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`. */
@@ -1648,7 +1777,7 @@ declare module "wunderbaum" {
         /** @internal Use `setColumn()`/`getActiveColElem()`*/
         activeColIdx: number;
         /** @internal */
-        navMode: NavigationMode;
+        _cellNavMode: boolean;
         /** @internal */
         lastQuicksearchTime: number;
         /** @internal */
@@ -1745,14 +1874,19 @@ declare module "wunderbaum" {
          */
         getOption(name: string, defaultValue?: any): any;
         /**
-         *
-         * @param name
-         * @param value
+         * Set tree option.
+         * Use dot notation to set plugin option, e.g. "filter.mode".
          */
         setOption(name: string, value: any): void;
-        /**Return true if the tree (or one of its nodes) has the input focus. */
+        /** Return true if the tree (or one of its nodes) has the input focus. */
         hasFocus(): boolean;
-        /** Run code, but defer `updateViewport()` until done. */
+        /**
+         * Return true if the tree displays a header. Grids have a header unless the
+         * `header` option is set to `false`. Plain trees have a header if the `header`
+         * option is a string or `true`.
+         */
+        hasHeader(): boolean;
+        /** Run code, but defer rendering of viewport until done. */
         runWithoutUpdate(func: () => any, hint?: any): void;
         /** Recursively expand all expandable nodes (triggers lazy load id needed). */
         expandAll(flag?: boolean): Promise<void>;
@@ -1864,28 +1998,18 @@ declare module "wunderbaum" {
         logWarn(...args: any[]): void;
         /**
          * Make sure that this node is vertically scrolled into the viewport.
-         *
-         * @param {object} [options=null] {topNode: null, effects: ..., parent: ...}
-         *     this node will remain visible in
-         *     any case, even if `this` is outside the scroll pane.
          */
-        scrollTo(opts: any): void;
+        scrollTo(nodeOrOpts: ScrollToOptions | WunderbaumNode): void;
         /**
          * Make sure that this node is horizontally scrolled into the viewport.
-         *
-         * Used for `fixedCol` mode.
-         *
-         * @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.
+         * Called by {@link setColumn}.
          */
-        scrollToHorz(opts: any): void;
+        protected scrollToHorz(): 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.
+         * Available in cell-nav mode only.
          */
         setColumn(colIdx: number): void;
         /** Set or remove keybaord focus to the tree container. */
@@ -1896,18 +2020,22 @@ declare module "wunderbaum" {
         setModified(change: ChangeType, options?: any): void;
         /** Schedule an update request to reflect a single node modification. */
         setModified(change: ChangeType, node: WunderbaumNode, options?: any): void;
-        /** Get the tree's navigation mode. */
-        getNavigationMode(): NavigationMode;
-        /** Set the tree's navigation mode. */
-        setNavigationMode(mode: NavigationMode): void;
         /** Disable mouse and keyboard interaction (return prev. state). */
         setEnabled(flag?: boolean): boolean;
         /** Return false if tree is disabled. */
         isEnabled(): boolean;
-        /** Return true if tree has one or more data columns in addition to the plain nodes. */
+        /** Return true if tree has more than one column, i.e. has additional data columns. */
         isGrid(): boolean;
+        /** Return true if cell-navigation mode is acive. */
+        isCellNav(): boolean;
+        /** Return true if row-navigation mode is acive. */
+        isRowNav(): boolean;
+        /** Set the tree's navigation mode. */
+        setCellNav(flag?: boolean): void;
+        /** Set the tree's navigation mode option. */
+        setNavigationOption(mode: NavigationOptions, reset?: boolean): void;
         /** Display tree status (ok, loading, error, noData) using styles and a dummy root node. */
-        setStatus(status: NodeStatusType, message?: string, details?: string): WunderbaumNode | null;
+        setStatus(status: NodeStatusType, options?: SetStatusOptions): WunderbaumNode | null;
         /** Add or redefine node type definitions. */
         setTypes(types: any, replace?: boolean): void;
         /** Update column headers and width. */
@@ -1916,16 +2044,27 @@ declare module "wunderbaum" {
          * @internal
          */
         protected _renderHeaderMarkup(): void;
-        /** Render header and all rows that are visible in the viewport (async, throttled). */
-        updateViewport(immediate?: boolean): void;
+        /**
+         * Render pending changes that were scheduled using {@link WunderbaumNode.setModified} if any.
+         *
+         * This is hardly ever neccessary, since we normally either
+         * - call `setModified(ChangeType.TYPE)` (async, throttled), or
+         * - call `setModified(ChangeType.TYPE, {immediate: true})` (synchronous)
+         *
+         * `updatePendingModifications()` will only force immediate execution of
+         * pending async changes if any.
+         */
+        updatePendingModifications(): 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()`.
+         *
+         * This protected method should not be called directly but via
+         * {@link WunderbaumNode.setModified}`, {@link Wunderbaum.setModified},
+         * or {@link Wunderbaum.updatePendingModifications}.
          * @internal
          */
-        protected _updateViewport(): void;
+        protected _updateViewportImmediately(): void;
         protected _updateRows(opts?: any): boolean;
         /**
          * Call callback(node) for all nodes in hierarchical order (depth-first).
@@ -1935,7 +2074,7 @@ declare module "wunderbaum" {
          *     children only.
          * @returns {boolean} false, if the iterator was stopped.
          */
-        visit(callback: (node: WunderbaumNode) => any): import("common").NodeVisitResponse;
+        visit(callback: (node: WunderbaumNode) => any): import("types").NodeVisitResponse;
         /**
          * Call fn(node) for all nodes in vertical order, top down (or bottom up).
          *