wunderbaum 0.4.0 → 0.5.0

package/dist/wunderbaum.css

@@ -4,7 +4,8 @@
  * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
  * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
  */
-:root {
+:root,
+:host {
   --wb-font-stack: Helvetica, sans-serif;
   --wb-error-color: #b5373b;
   --wb-node-text-color: #56534c;
@@ -347,13 +348,13 @@ div.wunderbaum div.wb-row.wb-drop-target .wb-node .wb-icon {
 div.wunderbaum div.wb-row.wb-drop-target .wb-node .wb-icon::after {
   position: absolute;
   z-index: 1000;
-  content: url(../docs/assets/drop_marker_16x32.png);
+  content: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAQCAMAAABA3o1rAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAACKUExURe/v9/f39+//7+f35+f/79bW5wgIawwYd97e55Tnpc731rjA2d7350LOY1LWa7Xvvf///wAQcyAze97e773vxnuczgA5pQBCpdb33rXvxu//9whjxgBaxlKU1oOz5ABz3gB73tbn99bW1rXe/wCM9xiU997v/97e3gCc/xil/9bv/wic/+/3/wAAALM9X5QAAAAudFJOU////////////////////////////////////////////////////////////wCCj3NVAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAqUlEQVQoU6WQ2w6CMAxA54agsCHq1HlFBREv/f/fs1tHAoaoiedlbXrWtGXwhV8FNqAXuAi4DwkShmE0cgGIcSwCCgkSkrAxpEonot0DhQxJptFsbnOpdNdgsFh6VtYwyqzTmG+oijDY7hr22E4qY7QybeGQe46nsxP0Wwc3Q1GWl+qKec8MlqKubxX+xzV7tkDuD1+3d+heigT2zGx/hCMUeUj4wL8CwAsW1kqCTugMCwAAAABJRU5ErkJggg==);
   left: 0;
   top: calc((22px - --wb-icon-height) / 2);
 }
 div.wunderbaum div.wb-row.wb-drop-target.wb-drop-before .wb-node .wb-icon::after,
 div.wunderbaum div.wb-row.wb-drop-target.wb-drop-after .wb-node .wb-icon::after {
-  content: url(../docs/assets/drop_marker_insert_16x64.png);
+  content: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAAAQCAMAAACROYkbAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAACNUExURe/v9/f39+//7+f35+f/79bW5wgIawwYd97e55Tnpc731rjA2d7350LOY1LWa7Xvvf///wAQcyAze97e773vxgAAAHuczgA5pQBCpdb33rXvxu//9whjxgBaxlKU1oOz5ABz3gB73tbn99bW1rXe/wCM9xiU997v/97e3gCc/xil/9bv/wic/+/3/wAAAParqS4AAAAvdFJOU/////////////////////////////////////////////////////////////8AWqU49wAAAAlwSFlzAAAOwwAADsMBx2+oZAAAALlJREFUOE/FktsSgiAQhglMS8WstKLzQTM77Ps/XguL16I208cFyzB8/LPAYCC/ErARzcCFx23pBgnGfjAxBYhpKDwq3SBB5DeGWCYz0SUDClIkmgeLpV7HMiNDbrbbYbBaWzbaoKTaJiHfQe5oYLA/NBwxTiyVyqTSghYwox4MTmfL5XozgqxjAtODoizv1QPXPXqgKer6WeH9+Iw9XgF5ve15/Q+6/SQSsE+q8yMcocoREgzg3wKAL4vrpBIKREShAAAAAElFTkSuQmCC);
   left: 0;
   top: calc((22px - --wb-icon-height) / 2 - 11px);
 }

package/dist/wunderbaum.css.map

@@ -1 +1 @@
-{"version":3,"sourceRoot":"","sources":["../src/wunderbaum.scss"],"names":[],"mappings":";AAAA;AAAA;AAAA;AAAA;AAAA;AA2EA;EAGE;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EAEA;;;AAMF;EACE;;;AAEF;EACE;EACA;EACA;EACA;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;EACA;EAGA;AAsBA;AAuBA;AA8PA;AAmHA;AAwBA;AA4DA;AAEA;AAUA;AAoBA;AAYA;;AA1hBA;EAEE;;AAIF;EACE;EACA;;AAGF;EACE;EAEA;;AAMF;EACE;EACA;EACA;;AAGF;AAAA;EAEE;;AAKF;EACE;EACA;EACA;EACA;EACA;;AAMA;EACE;EACA;EACA;EACA;;AAIA;EACE;;AAIF;EAEE;;AAEF;EAEE;;AAEF;EACE;;AAOA;EAEE;EACA;;AACA;EACE;;AAaN;EAEE;EACA;;AAEA;EACE;;AAON;EACE;;AAEA;EACE;;AAOF;EACE;;AAGF;EAEE;;AAGA;EACE;;AAKJ;EACE;EACA;;AAGF;EAEE;EACA;;AAEA;EAEE;;AAIJ;EACE;;AAGF;AAAA;AAAA;EAGE;EAcA;EASA;;AAGF;EAEE;;AAON;EACE;EACA;EACA;EACA;EACA;;AAEA;EACE;EAIA;;AAIF;EACE;EACA;EACA;EACA;;AAGF;EACE;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;;AAIJ;EACE;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;;AAEA;EACE;;AAIJ;EACE;AAeA;;AAVA;AAAA;AAAA;AAAA;EAIE;EACA;EACA;EACA;;AAIF;EACE;;AAGF;EACE;EACA;EACA;;AAMA;EACE;;AAIJ;AAAA;EAEE;EACA;EACA;EACA;;AAGF;EACE;EAEA;EACA;EACA;EACA;EACA;;AAUI;EACE;;AAON;EACE;;AAIJ;EACE;;AAEA;EACE;;AAIF;EACE;;AAGF;EACE;;AAEA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;EAgBE;EACA;EACA;;AAGF;AAAA;EAEE;;AAcA;EACE;;AAUJ;EACE;;AAGF;EACE;;AAEA;EACE;;AAON;EACE;;AAEA;EACE;;AAQJ;EACE;;AASJ;EACE;;AAEA;EACE;;AAGF;EACE;;AAcN;EACE;;AAEA;EACE;;AAIJ;EACE;;AAEA;EACE;EACA;;AAGA;EACE;EACA;;AAEA;EAGE;EACA;EACA;EACA;EACA;;AAgBR;AAAA;EAEE;EACA;EACA;;AAKF;EACE;;AAUE;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAOJ;EAIE;EACA;;AAGF;AAAA;EAKE;EACA;;AAMF;AAAA;EAEE;EACA;EACA;EACA;;AAOF;EACE;;AAGF;AAAA;EAEE;;AAKA;EACE;;;AAMR;AAEA;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;EACA;;AAEA;EACE;EACA;;;AAQJ;AACA;AAAA;EAEE;;;AAGF;AAAA;EAEE;;;AAIA;AAAA;EAEE;;AAGF;AAAA;EAEE;;;AAIJ;AAAA;AAAA;AAMA;EACE;EACA;;;AAGF;EAEE;EACA;;;AAGF;EACE;IACE;;EAGF;IACE;;;AAIJ;EACE;IACE;;EAGF;IACE;;;AAIJ;EACE;IACE;;EAGF;IACE","file":"wunderbaum.css"}
+{"version":3,"sourceRoot":"","sources":["../src/wunderbaum.scss"],"names":[],"mappings":";AAAA;AAAA;AAAA;AAAA;AAAA;AA2EA;AAAA;EAME;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EAEA;;;AAMF;EACE;;;AAGF;EACE;EACA;EACA;EACA;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;EACA;EAGA;AAsBA;AAuBA;AAkQA;AAoHA;AAwBA;AAgEA;AAEA;AAUA;AAoBA;AAYA;;AAniBA;EAEE;;AAIF;EACE;EACA;;AAGF;EACE;EAEA;;AAMF;EACE;EACA;EACA;;AAGF;AAAA;EAEE;;AAKF;EACE;EACA;EACA;EACA;EACA;;AAMA;EACE;EACA;EACA;EACA;;AAIA;EACE;;AAKF;EAEE;;AAGF;EAEE;;AAGF;EACE;;AAOA;EAEE;EACA;;AAEA;EACE;;AAaN;EAEE;EACA;;AAEA;EACE;;AAON;EACE;;AAEA;EACE;;AAOF;EACE;;AAGF;EAEE;;AAGA;EACE;;AAKJ;EACE;EACA;;AAGF;EAEE;EACA;;AAEA;EAEE;;AAIJ;EACE;;AAGF;AAAA;AAAA;EAGE;EAcA;EASA;;AAGF;EAEE;;AAON;EACE;EACA;EACA;EACA;EACA;;AAEA;EACE;EAIA;;AAIF;EACE;EACA;EACA;EACA;;AAGF;EACE;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;;AAIJ;EACE;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;;AAEA;EACE;;AAIJ;EACE;AAeA;;AAVA;AAAA;AAAA;AAAA;EAIE;EACA;EACA;EACA;;AAIF;EACE;;AAGF;EACE;EACA;EACA;;AAMA;EACE;;AAIJ;AAAA;EAEE;EACA;EACA;EACA;;AAGF;EACE;EAEA;EACA;EACA;EACA;EACA;;AAUI;EACE;;AAON;EACE;;AAIJ;EACE;;AAEA;EACE;;AAIF;EACE;;AAGF;EACE;;AAEA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;EAgBE;EACA;EACA;;AAGF;AAAA;EAEE;;AAcA;EACE;;AAWJ;EACE;;AAGF;EACE;;AAEA;EACE;;AAON;EACE;;AAEA;EACE;;AAQJ;EACE;;AASJ;EACE;;AAEA;EACE;;AAGF;EACE;;AAcN;EACE;;AAEA;EACE;;AAIJ;EACE;;AAEA;EACE;EACA;;AAGA;EACE;EACA;;AAEA;EAGE;EACA;EAGA;EACA;EACA;;AAgBR;AAAA;EAIE;EACA;EACA;;AAKF;EACE;;AAUE;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAFF;AAAA;EAEE;;AAOJ;EAIE;EACA;;AAGF;AAAA;EAKE;EACA;;AAMF;AAAA;EAEE;EACA;EACA;EACA;;AAOF;EACE;;AAGF;AAAA;EAEE;;AAKA;EACE;;;AAMR;AAEA;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;;;AAGF;EACE;EACA;;AAEA;EACE;EACA;;;AAQJ;AACA;AAAA;EAEE;;;AAGF;AAAA;EAEE;;;AAIA;AAAA;EAEE;;AAGF;AAAA;EAEE;;;AAIJ;AAAA;AAAA;AAMA;EACE;EACA;;;AAGF;EAEE;EACA;;;AAGF;EACE;IACE;;EAGF;IACE;;;AAIJ;EACE;IACE;;EAGF;IACE;;;AAIJ;EACE;IACE;;EAGF;IACE","file":"wunderbaum.css"}

package/dist/wunderbaum.d.ts

@@ -285,23 +285,10 @@ declare module "common" {
      * Default node icons.
      * Requires bootstrap icons https://icons.getbootstrap.com
      */
-    export const 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;
-        folderLazy: string;
-        doc: string;
+    export const iconMaps: {
+        [key: string]: {
+            [key: string]: string;
+        };
     };
     export const KEY_NODATA = "__not_found__";
     /** Define which keys are handled by embedded <input> control, and should
@@ -371,7 +358,7 @@ declare module "deferred" {
 }
 declare module "wb_node" {
     import { Wunderbaum } from "wunderbaum";
-    import { AddChildrenOptions, InsertNodeType, ApplyCommandOptions, ApplyCommandType, ChangeType, ExpandAllOptions, MakeVisibleOptions, MatcherCallback, NavigateOptions, NodeAnyCallback, NodeStatusType, NodeStringCallback, NodeVisitCallback, NodeVisitResponse, RenderOptions, ScrollIntoViewOptions, SetActiveOptions, SetExpandedOptions, SetSelectedOptions, SetStatusOptions, SortCallback, NodeToDictCallback, WbNodeData, TristateType } from "types";
+    import { AddChildrenOptions, InsertNodeType, ApplyCommandOptions, ApplyCommandType, ChangeType, ExpandAllOptions, MakeVisibleOptions, MatcherCallback, NavigateOptions, NodeAnyCallback, NodeStatusType, NodeStringCallback, NodeVisitCallback, NodeVisitResponse, RenderOptions, ScrollIntoViewOptions, SetActiveOptions, SetExpandedOptions, SetSelectedOptions, SetStatusOptions, SortCallback, NodeToDictCallback, WbNodeData, TristateType, CheckboxOption, IconOption, SourceType } from "types";
     /**
      * A single tree node.
      *
@@ -397,27 +384,27 @@ declare module "wb_node" {
          */
         readonly refKey: string | undefined;
         children: WunderbaumNode[] | null;
-        checkbox?: boolean;
+        checkbox?: CheckboxOption;
         radiogroup?: boolean;
         /** If true, (in grid mode) no cells are rendered, except for the node title.*/
         colspan?: boolean;
-        icon?: boolean | string;
-        lazy: boolean;
+        icon?: IconOption;
+        lazy?: boolean;
         /** Expansion state.
          * @see {@link isExpandable}, {@link isExpanded}, {@link setExpanded}. */
-        expanded: boolean;
+        expanded?: boolean;
         /** Selection state.
          * @see {@link isSelected}, {@link setSelected}, {@link toggleSelected}. */
-        selected: boolean;
+        selected?: boolean;
         unselectable?: boolean;
         type?: string;
-        tooltip?: string;
+        tooltip?: string | boolean;
         /** Additional classes added to `div.wb-row`.
          * @see {@link hasClass}, {@link setClass}. */
         classes: Set<string> | null;
         /** Custom data that was passed to the constructor */
         data: any;
-        statusNodeType?: string;
+        statusNodeType?: NodeStatusType;
         _isLoading: boolean;
         _requestId: number;
         _errorInfo: any | null;
@@ -666,7 +653,7 @@ declare module "wb_node" {
         protected _loadSourceObject(source: any, level?: number): void;
         _fetchWithOptions(source: any): Promise<any>;
         /** Download  data from the cloud, then call `.update()`. */
-        load(source: any): Promise<void>;
+        load(source: SourceType): Promise<void>;
         /**Load content of a lazy node. */
         loadLazy(forceReload?: boolean): Promise<void>;
         /** Alias for `logDebug` */
@@ -703,7 +690,7 @@ declare module "wb_node" {
         /** Remove all HTML markup from the DOM. */
         removeMarkup(): void;
         protected _getRenderInfo(): any;
-        protected _createIcon(parentElem: HTMLElement, replaceChild: HTMLElement | null, showLoading: boolean): HTMLElement | null;
+        protected _createIcon(iconMap: any, parentElem: HTMLElement, replaceChild: HTMLElement | null, showLoading: boolean): HTMLElement | null;
         /**
          * Create a whole new `<div class="wb-row">` element.
          * @see {@link WunderbaumNode._render}
@@ -879,7 +866,7 @@ declare module "wb_options" {
      * Copyright (c) 2021-2023, Martin Wendt. Released under the MIT license.
      * @VERSION, @DATE (https://github.com/mar10/wunderbaum)
      */
-    import { BoolOptionResolver, ColumnDefinitionList, DndOptionsType, NavModeEnum, NodeTypeDefinitionMap, SelectModeType, WbActivateEventType, WbChangeEventType, WbClickEventType, WbDeactivateEventType, WbEnhanceTitleEventType, WbErrorEventType, WbInitEventType, WbKeydownEventType, WbNodeData, WbNodeEventType, WbReceiveEventType, WbRenderEventType, WbTreeEventType } from "types";
+    import { ColumnDefinitionList, DndOptionsType, DynamicBoolOption, DynamicBoolOrStringOption, DynamicCheckboxOption, DynamicIconOption, NavModeEnum, NodeTypeDefinitionMap, SelectModeType, WbActivateEventType, WbChangeEventType, WbClickEventType, WbDeactivateEventType, WbEnhanceTitleEventType, WbErrorEventType, WbInitEventType, WbKeydownEventType, WbNodeData, WbNodeEventType, WbReceiveEventType, WbRenderEventType, WbTreeEventType } from "types";
     /**
      * Available options for [[Wunderbaum]].
      *
@@ -978,6 +965,15 @@ declare module "wb_options" {
          * Default: 22
          */
         rowHeightPx?: number;
+        /**
+         * Icon font definition. May be a string (e.g. "fontawesome6" or "bootstrap")
+         * or a map of `iconName: iconClass` pairs.
+         * Note: the icon font must be loaded separately.
+         * Default: "bootstrap"
+         */
+        iconMap?: string | {
+            [key: string]: string;
+        };
         /**
          * Collapse siblings when a node is expanded.
          * Default: false
@@ -1006,10 +1002,20 @@ declare module "wb_options" {
         showSpinner?: boolean;
         /**
          * If true, render a checkbox before the node tile to allow selection with the
-         * mouse.
+         * mouse. Pass `"radio"` to render a radio button instead.
          * Default: false.
          */
-        checkbox?: boolean | "radio" | BoolOptionResolver;
+        checkbox?: DynamicCheckboxOption;
+        /** Optional callback to render icons per node. */
+        icon?: DynamicIconOption;
+        /** Optional callback to render a tooltip for the icon. */
+        iconTooltip?: DynamicBoolOrStringOption;
+        /** Optional callback to render a tooltip for the node title.
+         * Pass `true` to use the node's `title` property as tooltip.
+         */
+        tooltip?: DynamicBoolOrStringOption;
+        /** Optional callback to make a node unselectable. */
+        unselectable?: DynamicBoolOption;
         /**
          * Default: true
          */
@@ -1160,6 +1166,36 @@ declare module "types" {
     import { Wunderbaum } from "wunderbaum";
     /** A value that can either be true, false, or undefined. */
     export type TristateType = boolean | undefined;
+    /** Show/hide checkbox or display a radiobutton icon instead. */
+    export type CheckboxOption = boolean | "radio";
+    /** An icon may either be
+     * a string-tag that references an entry in the `iconMap` (e.g. `"folderOpen"`)),
+     * an HTML string that contains a `<` and is used as-is,
+     * an image URL string that contains a `.` or `/` and is rendered as `<img src='...'>`,
+     * a class string such as `"bi bi-folder"`,
+     * or a boolean value that indicates if the default icon should be used or hidden.
+     */
+    export type IconOption = boolean | string;
+    export interface SourceAjaxType {
+        url: string;
+        params?: any;
+        body?: any;
+        options?: RequestInit;
+    }
+    export type SourceListType = Array<WbNodeData>;
+    export interface SourceObjectType {
+        _format?: "nested" | "flat";
+        types?: NodeTypeDefinitionMap;
+        columns?: ColumnDefinitionList;
+        children: SourceListType;
+        _keyMap?: {
+            [key: string]: string;
+        };
+        _typeList?: Array<string>;
+        _positional?: Array<string>;
+    }
+    /** Possible initilization for tree nodes. */
+    export type SourceType = string | SourceListType | SourceAjaxType | SourceObjectType;
     /** Passed to `find...()` methods. Should return true if node matches. */
     export type MatcherCallback = (node: WunderbaumNode) => boolean;
     /** Passed to `sortChildren()` methods. Should return -1, 0, or 1. */
@@ -1180,17 +1216,39 @@ declare module "types" {
     export type NodeToDictCallback = (dict: WbNodeData, node: WunderbaumNode) => NodeVisitResponse;
     /** A callback that receives a node instance and returns a string value. */
     export type NodeSelectCallback = (node: WunderbaumNode) => boolean | void;
+    /**
+     * See also {@link WunderbaumNode.getOption|WunderbaumNode.getOption()}
+     * to evaluate `node.NAME` setting and `tree.types[node.type].NAME`.
+     */
+    export type DynamicBoolOption = boolean | BoolOptionResolver;
+    export type DynamicStringOption = string | BoolOptionResolver;
+    export type DynamicBoolOrStringOption = boolean | string | BoolOrStringOptionResolver;
+    export type DynamicCheckboxOption = CheckboxOption | BoolOrStringOptionResolver;
+    export type DynamicIconOption = IconOption | BoolOrStringOptionResolver;
     /** A plain object (dictionary) that represents a node instance. */
     export interface WbNodeData {
-        title: string;
+        checkbox?: CheckboxOption;
+        children?: Array<WbNodeData>;
+        classes?: string;
+        colspan?: boolean;
+        expanded?: boolean;
+        icon?: IconOption;
+        iconTooltip?: boolean | string;
         key?: string;
+        lazy?: boolean;
+        /** Make child nodes single-select radio buttons. */
+        radiogroup?: boolean;
         refKey?: string;
-        expanded?: boolean;
         selected?: boolean;
-        checkbox?: boolean | string;
-        colspan?: boolean;
-        children?: Array<WbNodeData>;
-        treeId?: string;
+        statusNodeType?: NodeStatusType;
+        title: string;
+        tooltip?: boolean | string;
+        type?: string;
+        unselectable?: boolean;
+        /** @internal */
+        _treeId?: string;
+        /** Other data is passed to `node.data` and can be accessed via `node.data.NAME` */
+        [key: string]: unknown;
     }
     export interface WbTreeEventType {
         /** Name of the event. */
@@ -1284,21 +1342,21 @@ declare module "types" {
     }
     /**
      * Contains the node's type information, i.e. `tree.types[node.type]` if
-     * defined. @see {@link Wunderbaum.types}
+     * defined.
+     * @see {@link Wunderbaum.types} and {@link WunderbaumNode.getOption|WunderbaumNode.getOption()}
+     * to evaluate `node.NAME` setting and `tree.types[node.type].NAME`.
      */
     export interface NodeTypeDefinition {
         /** En/disable checkbox for matching nodes. */
-        checkbox?: boolean | "radio" | BoolOrStringOptionResolver;
+        checkbox?: CheckboxOption;
         /** Optional class names that are added to all `div.wb-row` elements of matching nodes. */
         classes?: string;
         /** Only show title and hide other columns if any. */
-        colspan?: boolean | BoolOptionResolver;
+        colspan?: boolean;
         /** Default icon for matching nodes. */
-        icon?: boolean | string | BoolOrStringOptionResolver;
-        /**
-         * See also {@link WunderbaumNode.getOption|WunderbaumNode.getOption()}
-         * to evaluate `node.NAME` setting and `tree.types[node.type].NAME`.
-         */
+        icon?: IconOption;
+        /** Default icon for matching nodes. */
+        iconTooltip?: string | boolean;
         [key: string]: unknown;
     }
     export type NodeTypeDefinitionMap = {
@@ -1338,6 +1396,7 @@ declare module "types" {
         _weight?: number;
         _widthPx?: number;
         _ofsPx?: number;
+        [key: string]: unknown;
     }
     export type ColumnDefinitionList = Array<ColumnDefinition>;
     /**
@@ -1419,7 +1478,8 @@ declare module "types" {
         ok = "ok",
         loading = "loading",
         error = "error",
-        noData = "noData"
+        noData = "noData",
+        paging = "paging"
     }
     /** Define the subregion of a node, where an event occurred. */
     export enum NodeRegion {
@@ -2070,7 +2130,7 @@ declare module "wunderbaum" {
      */
     import * as util from "util";
     import { ExtensionsDict, WunderbaumExtension } from "wb_extension_base";
-    import { ApplyCommandType, ChangeType, ColumnDefinitionList, ExpandAllOptions, FilterModeType, MatcherCallback, NavModeEnum, NodeStatusType, NodeStringCallback, NodeTypeDefinitionMap, ScrollToOptions, SetActiveOptions, UpdateOptions, SetStatusOptions, WbEventInfo, ApplyCommandOptions, AddChildrenOptions, VisitRowsOptions, NodeFilterCallback, FilterNodesOptions, RenderFlag, NodeVisitCallback, SortCallback, NodeToDictCallback, WbNodeData } from "types";
+    import { ApplyCommandType, ChangeType, ColumnDefinitionList, ExpandAllOptions, FilterModeType, MatcherCallback, NavModeEnum, NodeStatusType, NodeStringCallback, NodeTypeDefinitionMap, ScrollToOptions, SetActiveOptions, UpdateOptions, SetStatusOptions, WbEventInfo, ApplyCommandOptions, AddChildrenOptions, VisitRowsOptions, NodeFilterCallback, FilterNodesOptions, RenderFlag, NodeVisitCallback, SortCallback, NodeToDictCallback, WbNodeData, DynamicCheckboxOption, SourceType, DynamicIconOption, DynamicStringOption, DynamicBoolOption } from "types";
     import { WunderbaumNode } from "wb_node";
     import { WunderbaumOptions } from "wb_options";
     /**
@@ -2117,6 +2177,11 @@ declare module "wunderbaum" {
         types: NodeTypeDefinitionMap;
         /** List of column definitions. */
         columns: ColumnDefinitionList;
+        checkbox?: DynamicCheckboxOption;
+        icon?: DynamicIconOption;
+        iconTooltip?: DynamicStringOption;
+        tooltip?: DynamicStringOption;
+        unselectable?: DynamicBoolOption;
         protected _columnsById: {
             [key: string]: any;
         };
@@ -2151,6 +2216,12 @@ declare module "wunderbaum" {
          * ```
          */
         static getTree(el?: Element | Event | number | string | WunderbaumNode): Wunderbaum | null;
+        /**
+         * Return the icon-function -> icon-definition mapping.
+         */
+        get iconMap(): {
+            [key: string]: string;
+        };
         /**
          * Return a WunderbaumNode instance from element or event.
          */
@@ -2530,7 +2601,7 @@ declare module "wunderbaum" {
          * Previous data is cleared. Note that also column- and type defintions may
          * be passed with the `source` object.
          */
-        load(source: any): Promise<void>;
+        load(source: SourceType): Promise<void>;
         /**
          * Disable render requests during operations that would trigger many updates.
          *