wunderbaum 0.11.1 → 0.12.1

package/dist/wunderbaum.umd.js

@@ -5,6 +5,11 @@
 })(this, (function (exports) { 'use strict';
 
     /*!
+     * Wunderbaum - debounce.ts
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
+     */
+    /*
      * debounce & throttle, taken from https://github.com/lodash/lodash v4.17.21
      * MIT License: https://raw.githubusercontent.com/lodash/lodash/4.17.21-npm/LICENSE
      * Modified for TypeScript type annotations.
@@ -293,8 +298,8 @@
 
     /*!
      * Wunderbaum - util
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     /** @module util */
     /** Readable names for `MouseEvent.button` */
@@ -1147,8 +1152,8 @@
 
     /*!
      * Wunderbaum - types
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     /**
      * Possible values for {@link WunderbaumNode.update} and {@link Wunderbaum.update}.
@@ -1172,7 +1177,7 @@
         /** Vertical scroll event. Update the 'top' property of all rows. */
         ChangeType["scroll"] = "scroll";
     })(ChangeType || (ChangeType = {}));
-    /* Internal use. */
+    /** @internal */
     var RenderFlag;
     (function (RenderFlag) {
         RenderFlag["clearMarkup"] = "clearMarkup";
@@ -1203,16 +1208,20 @@
     /** Initial navigation mode and possible transition. */
     var NavModeEnum;
     (function (NavModeEnum) {
+        /** Start with row mode, but allow cell-nav mode */
         NavModeEnum["startRow"] = "startRow";
+        /** Cell-nav mode only */
         NavModeEnum["cell"] = "cell";
+        /** Start in cell-nav mode, but allow row mode */
         NavModeEnum["startCell"] = "startCell";
+        /** Row mode only */
         NavModeEnum["row"] = "row";
     })(NavModeEnum || (NavModeEnum = {}));
 
     /*!
      * Wunderbaum - wb_extension_base
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     class WunderbaumExtension {
         constructor(tree, id, defaults) {
@@ -1270,8 +1279,8 @@
 
     /*!
      * Wunderbaum - ext-filter
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     const START_MARKER = "\uFFF7";
     const END_MARKER = "\uFFF8";
@@ -1403,7 +1412,7 @@
                 };
             }
             tree.filterMode = opts.mode;
-            // eslint-disable-next-line prefer-rest-params, prefer-spread
+            // eslint-disable-next-line prefer-rest-params
             this.lastFilterArgs = arguments;
             tree.element.classList.toggle("wb-ext-filter-hide", !!hideMode);
             tree.element.classList.toggle("wb-ext-filter-dim", !hideMode);
@@ -1595,8 +1604,8 @@
 
     /*!
      * Wunderbaum - ext-keynav
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     const QUICKSEARCH_DELAY = 500;
     class KeynavExtension extends WunderbaumExtension {
@@ -1959,8 +1968,8 @@
 
     /*!
      * Wunderbaum - ext-logger
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     class LoggerExtension extends WunderbaumExtension {
         constructor(tree) {
@@ -2001,8 +2010,8 @@
 
     /*!
      * Wunderbaum - ext-dnd
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     const nodeMimeType = "application/x-wunderbaum-node";
     class DndExtension extends WunderbaumExtension {
@@ -2222,7 +2231,7 @@
                 viewportY >= height - sensitivity) {
                 // Mouse in bottom 20px area: scroll down
                 // sp.scrollTop = scrollTop + dndOpts.scrollSpeed;
-                this.currentScrollDir = +1;
+                this.currentScrollDir = 1;
             }
             if (this.currentScrollDir) {
                 this.applyScrollDirThrottled();
@@ -2451,8 +2460,8 @@
 
     /*!
      * Wunderbaum - drag_observer
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     /**
      * Convert mouse- and touch events to 'dragstart', 'drag', and 'dragstop'.
@@ -2600,8 +2609,8 @@
 
     /*!
      * Wunderbaum - common
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     const DEFAULT_DEBUGLEVEL = 3; // Replaced by rollup script
     /**
@@ -2628,8 +2637,11 @@
     // export const RECURSIVE_REQUEST_ERROR = "$recursive_request";
     // export const INVALID_REQUEST_TARGET_ERROR = "$request_target_invalid";
     /**
-     * Default node icons.
-     * Requires bootstrap icons https://icons.getbootstrap.com
+     * Default node icons for icon libraries
+     *
+     *  - 'bootstrap': {@link https://icons.getbootstrap.com}
+     *  - 'fontawesome6' {@link https://fontawesome.com/icons}
+     *
      */
     const iconMaps = {
         bootstrap: {
@@ -2770,10 +2782,12 @@
     /**
      * Convert 'flat' to 'nested' format.
      *
-     *  Flat node entry format:
-     *    [PARENT_ID, [POSITIONAL_ARGS]]
-     *  or
-     *    [PARENT_ID, [POSITIONAL_ARGS], {KEY_VALUE_ARGS}]
+     * Flat node entry format:
+     *    [PARENT_IDX, {KEY_VALUE_ARGS}]
+     * or, if N _positional re defined:
+     *    [PARENT_IDX, POSITIONAL_ARG_1, POSITIONAL_ARG_2, ..., POSITIONAL_ARG_N]
+     * Even if _positional additional are defined, KEY_VALUE_ARGS can be appended:
+     *    [PARENT_IDX, POSITIONAL_ARG_1, ..., {KEY_VALUE_ARGS}]
      *
      * 1. Parent-referencing list is converted to a list of nested dicts with
      *    optional `children` properties.
@@ -2782,10 +2796,11 @@
     function unflattenSource(source) {
         var _a, _b, _c;
         const { _format, _keyMap = {}, _positional = [], children } = source;
+        const _positionalCount = _positional.length;
         if (_format !== "flat") {
             throw new Error(`Expected source._format: "flat", but got ${_format}`);
         }
-        if (_positional && _positional.includes("children")) {
+        if (_positionalCount && _positional.includes("children")) {
             throw new Error(`source._positional must not include "children": ${_positional}`);
         }
         let longToShort = _keyMap;
@@ -2799,7 +2814,7 @@
                 longToShort[value] = key;
             }
         }
-        const positionalShort = _positional.map((e) => longToShort[e]);
+        const positionalShort = _positional.map((e) => { var _a; return (_a = longToShort[e]) !== null && _a !== void 0 ? _a : e; });
         const newChildren = [];
         const keyToNodeMap = {};
         const indexToNodeMap = {};
@@ -2809,19 +2824,32 @@
             // Node entry format:
             //   [PARENT_ID, [POSITIONAL_ARGS]]
             // or
-            //   [PARENT_ID, [POSITIONAL_ARGS], {KEY_VALUE_ARGS}]
-            const [parentId, args, kwargs = {}] = nodeTuple;
+            //   [PARENT_ID, POSITIONAL_ARG_1, POSITIONAL_ARG_2, ..., {KEY_VALUE_ARGS}]
+            let kwargs;
+            const [parentId, ...args] = nodeTuple;
+            if (args.length === _positionalCount) {
+                kwargs = {};
+            }
+            else if (args.length === _positionalCount + 1) {
+                kwargs = args.pop();
+                if (typeof kwargs !== "object") {
+                    throw new Error(`unflattenSource: Expected dict as last tuple element: ${nodeTuple}`);
+                }
+            }
+            else {
+                throw new Error(`unflattenSource: unexpected tuple length: ${nodeTuple}`);
+            }
             // Free up some memory as we go
             nodeTuple[1] = null;
             if (nodeTuple[2] != null) {
                 nodeTuple[2] = null;
             }
-            // console.log("flatten", parentId, args, kwargs)
             // We keep `kwargs` as our new node definition. Then we add all positional
             // values to this object:
             args.forEach((val, positionalIdx) => {
                 kwargs[positionalShort[positionalIdx]] = val;
             });
+            args.length = 0;
             // Find the parent node. `null` means 'toplevel'. PARENT_ID may be the numeric
             // index of the source.children list. If PARENT_ID is a string, we search
             // a parent with node.key of this value.
@@ -2940,8 +2968,8 @@
 
     /*!
      * Wunderbaum - ext-grid
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     class GridExtension extends WunderbaumExtension {
         constructor(tree) {
@@ -3031,8 +3059,8 @@
 
     /*!
      * Wunderbaum - deferred
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     /**
      * Implement a ES6 Promise, that exposes a resolve() and reject() method.
@@ -3084,8 +3112,8 @@
 
     /*!
      * Wunderbaum - wunderbaum_node
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     /** WunderbaumNode properties that can be passed with source data.
      * (Any other source properties will be stored as `node.data.PROP`.)
@@ -3417,54 +3445,65 @@
         startEditTitle() {
             this.tree._callMethod("edit.startEditTitle", this);
         }
-        /** Call `setExpanded()` on all descendant nodes. */
+        /**
+         * Call `setExpanded()` on all descendant nodes.
+         *
+         * @param flag true to expand, false to collapse.
+         * @param options Additional options.
+         * @see {@link Wunderbaum.expandAll}
+         * @see {@link WunderbaumNode.setExpanded}
+         */
         async expandAll(flag = true, options) {
             const tree = this.tree;
-            const minExpandLevel = this.tree.options.minExpandLevel;
-            const { depth = 99, loadLazy, force, keepActiveNodeVisible = true, } = options !== null && options !== void 0 ? options : {};
+            const { collapseOthers, deep, depth, force, keepActiveNodeVisible = true, loadLazy, resetLazy, } = options !== null && options !== void 0 ? options : {};
+            // limit expansion level to `depth` (or tree.minExpandLevel). Default: unlimited
+            const treeLevel = this.tree.options.minExpandLevel || null; // 0 -> null
+            const minLevel = depth !== null && depth !== void 0 ? depth : (force ? null : treeLevel);
             const expandOpts = {
-                scrollIntoView: false, // don't scroll very node on iteration
+                deep: deep,
                 force: force,
                 loadLazy: loadLazy,
+                resetLazy: resetLazy,
+                scrollIntoView: false, // don't scroll every node while iterating
             };
-            // this.logInfo(`expandAll(${flag})`);
+            this.logInfo(`expandAll(${flag}, depth=${depth}, minLevel=${minLevel})`);
+            assert(!(flag && deep != null && !collapseOthers), "Expanding with `deep` option is not supported (implied by the `depth` option).");
             // Expand all direct children in parallel:
             async function _iter(n, level) {
                 var _a;
-                // n.logInfo(`  _iter(${level})`);
-                if (level === 0) {
-                    return;
-                }
-                // if (!flag && minExpandLevel && !force && n.getLevel() <= minExpandLevel) {
-                //   return; // Do not collapse until minExpandLevel
-                // }
-                const level_1 = level == null ? null : level - 1;
+                // n.logInfo(`  _iter(level=${level})`);
                 const promises = [];
                 (_a = n.children) === null || _a === void 0 ? void 0 : _a.forEach((cn) => {
                     if (flag) {
-                        if (!cn.expanded && (cn.children || (loadLazy && cn.lazy))) {
+                        if (!cn.expanded &&
+                            (minLevel == null || level < minLevel) &&
+                            (cn.children || (loadLazy && cn.lazy))) {
                             // Node is collapsed and may be expanded (i.e. has children or is lazy)
                             // Expanding may be async, so we store the promise.
                             // Also the recursion is delayed until expansion finished.
                             const p = cn.setExpanded(true, expandOpts);
                             promises.push(p);
-                            p.then(async () => {
-                                await _iter(cn, level_1);
-                            });
+                            if (depth == null) {
+                                p.then(async () => {
+                                    await _iter(cn, level + 1);
+                                });
+                            }
                         }
                         else {
                             // We don't expand the node, but still visit descendants.
                             // There we may find lazy nodes, so we
-                            promises.push(_iter(cn, level_1));
+                            promises.push(_iter(cn, level + 1));
                         }
                     }
                     else {
                         // Collapsing is always synchronous, so no promises required
-                        if (!minExpandLevel || force || cn.getLevel() > minExpandLevel) {
-                            // Do not collapse until minExpandLevel
+                        // Do not collapse until minExpandLevel
+                        if (minLevel == null || level >= minLevel) {
                             cn.setExpanded(false, expandOpts);
                         }
-                        _iter(cn, level_1); // recursion, even if cn was already collapsed
+                        if ((minLevel != null && level < minLevel) || deep) {
+                            _iter(cn, level + 1); // recursion, even if cn was already collapsed
+                        }
                     }
                 });
                 return new Promise((resolve) => {
@@ -3473,10 +3512,15 @@
                     });
                 });
             }
-            const tag = tree.logTime(`${this}.expandAll(${flag})`);
+            const tag = tree.logTime(`${this}.expandAll(${flag}, depth=${depth})`);
             try {
                 tree.enableUpdate(false);
-                await _iter(this, depth);
+                await _iter(this, 0);
+                if (collapseOthers) {
+                    assert(flag, "Option `collapseOthers` requires flag=true");
+                    assert(minLevel != null, "Option `collapseOthers` requires `depth` or `minExpandLevel`");
+                    this.expandAll(false, { depth: minLevel });
+                }
             }
             finally {
                 tree.enableUpdate(true);
@@ -4965,7 +5009,7 @@
             const orgEvent = options === null || options === void 0 ? void 0 : options.event; // Default: null
             const colIdx = options === null || options === void 0 ? void 0 : options.colIdx; // Default: null
             const edit = options === null || options === void 0 ? void 0 : options.edit; // Default: false
-            assert(!colIdx || tree.isCellNav(), "colIdx requires cellNav");
+            // util.assert(!colIdx || tree.isCellNav(), "colIdx requires cellNav");
             assert(!edit || colIdx != null, "edit requires colIdx");
             if (!noEvents) {
                 if (flag) {
@@ -5019,7 +5063,7 @@
          * Expand or collapse this node.
          */
         async setExpanded(flag = true, options) {
-            const { force, scrollIntoView, immediate } = options !== null && options !== void 0 ? options : {};
+            const { force, scrollIntoView, immediate, resetLazy } = options !== null && options !== void 0 ? options : {};
             const sendEvents = !(options === null || options === void 0 ? void 0 : options.noEvents); // Default: send events
             if (!flag &&
                 this.isExpanded() &&
@@ -5042,6 +5086,9 @@
             if (flag && this.lazy && this.children == null) {
                 await this.loadLazy();
             }
+            else if (!flag && resetLazy && this.lazy && this.children) {
+                this.resetLazy();
+            }
             this.expanded = flag;
             const updateOpts = { immediate: immediate };
             // const updateOpts = { immediate: !!util.getOption(options, "immediate") };
@@ -5150,7 +5197,8 @@
                 case undefined:
                     changed = this.selected || !this._partsel;
                     this.selected = false;
-                    this._partsel = true;
+                    // #110: end nodess cannot have a `_partsel` flag
+                    this._partsel = this.hasChildren() ? true : false;
                     break;
                 default:
                     error(`Invalid state: ${state}`);
@@ -5611,8 +5659,8 @@
 
     /*!
      * Wunderbaum - ext-edit
-     * Copyright (c) 2021-2024, Martin Wendt. Released under the MIT license.
-     * v0.11.1, Fri, 27 Dec 2024 22:58:06 GMT (https://github.com/mar10/wunderbaum)
+     * Copyright (c) 2021-2025, Martin Wendt. Released under the MIT license.
+     * v0.12.1, Sat, 22 Feb 2025 22:59:20 GMT (https://github.com/mar10/wunderbaum)
      */
     // const START_MARKER = "\uFFF7";
     class EditExtension extends WunderbaumExtension {
@@ -5943,12 +5991,12 @@
      *
      * A treegrid control.
      *
-     * Copyright (c) 2021-2024, Martin Wendt (https://wwWendt.de).
+     * Copyright (c) 2021-2025, Martin Wendt (https://wwWendt.de).
      * https://github.com/mar10/wunderbaum
      *
      * Released under the MIT license.
-     * @version v0.11.1
-     * @date Fri, 27 Dec 2024 22:58:06 GMT
+     * @version v0.12.1
+     * @date Sat, 22 Feb 2025 22:59:20 GMT
      */
     // import "./wunderbaum.scss";
     class WbSystemRoot extends WunderbaumNode {
@@ -5969,7 +6017,7 @@
      */
     class Wunderbaum {
         /** Currently active node if any.
-         * Use @link {WunderbaumNode.setActive|setActive} to modify.
+         * Use {@link WunderbaumNode.setActive|setActive} to modify.
          */
         get activeNode() {
             var _a;
@@ -5977,7 +6025,7 @@
             return ((_a = this._activeNode) === null || _a === void 0 ? void 0 : _a.tree) ? this._activeNode : null;
         }
         /** Current node hat has keyboard focus if any.
-         * Use @link {WunderbaumNode.setFocus|setFocus()} to modify.
+         * Use {@link WunderbaumNode.setFocus|setFocus()} to modify.
          */
         get focusNode() {
             var _a;
@@ -6127,7 +6175,7 @@
             const wantHeader = opts.header == null ? this.columns.length > 1 : !!opts.header;
             if (this.headerElement) {
                 // User existing header markup to define `this.columns`
-                assert(!this.columns, "`opts.columns` must not be set if markup already contains a header");
+                assert(!this.columns, "`opts.columns` must not be set if table markup already contains a header");
                 this.columns = [];
                 const rowElement = this.headerElement.querySelector("div.wb-row");
                 for (const colDiv of rowElement.querySelectorAll("div")) {
@@ -6175,8 +6223,7 @@
             // --- Load initial data
             if (opts.source) {
                 if (opts.showSpinner) {
-                    this.nodeListElement.innerHTML =
-                        "<progress class='spinner'>loading...</progress>";
+                    this.nodeListElement.innerHTML = `<progress class='spinner'>${opts.strings.loading}</progress>`;
                 }
                 this.load(opts.source)
                     .then(() => {
@@ -6281,7 +6328,10 @@
                     false) {
                     return false;
                 }
-                if (node && info.colIdx === 0 && node.isExpandable()) {
+                if (node &&
+                    info.colIdx === 0 &&
+                    node.isExpandable() &&
+                    info.region !== NodeRegion.expander) {
                     this._callMethod("edit._stopEditTitle");
                     node.setExpanded(!node.isExpanded());
                 }
@@ -7968,8 +8018,9 @@
             // this.debug("render", opts);
             const obsoleteNodes = new Set();
             this.nodeListElement.childNodes.forEach((elem) => {
-                const tr = elem;
-                obsoleteNodes.add(tr._wb_node);
+                if (elem._wb_node) {
+                    obsoleteNodes.add(elem._wb_node);
+                }
             });
             let idx = 0;
             let top = 0;
@@ -8270,7 +8321,7 @@
     }
     Wunderbaum.sequence = 0;
     /** Wunderbaum release version number "MAJOR.MINOR.PATCH". */
-    Wunderbaum.version = "v0.11.1"; // Set to semver by 'grunt release'
+    Wunderbaum.version = "v0.12.1"; // Set to semver by 'grunt release'
     /** Expose some useful methods of the util.ts module as `Wunderbaum.util`. */
     Wunderbaum.util = util;