tsgrid-ui 2.7.0 → 2.9.0

package/dist/tsgrid-ui.js

@@ -1,4 +1,4 @@
-/* tsgrid-ui 1.0.x (nightly) (5/14/2026, 12:10:16 AM) (c) 2014 vitmalina@gmail.com, (c) 2026 DaverSoGT — MIT */
+/* tsgrid-ui 2.9.0 (c) 2014 vitmalina@gmail.com, (c) 2026 DaverSoGT — MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -3045,15 +3045,13 @@ function _date(dateStr, settings, deps) {
 // src/tsutils-locale.ts
 async function _locale(locale, keepPhrases, noMerge, settings, deps) {
   if (Array.isArray(locale)) {
-    let mergedSettings = deps.extend({}, settings, { phrases: {} });
-    const localeArr = locale;
+    let mergedSettings = deps.extend({}, { ...settings, phrases: {} });
+    const localeArr = locale.map(
+      (f) => f.length === 5 ? "locale/" + f.toLowerCase() + ".json" : f
+    );
     const proms = [];
     const files = {};
-    localeArr.forEach((file, ind) => {
-      if (file.length === 5) {
-        file = "locale/" + file.toLowerCase() + ".json";
-        localeArr[ind] = file;
-      }
+    localeArr.forEach((file) => {
       proms.push(_locale(file, true, false, mergedSettings, deps));
     });
     const res = await Promise.allSettled(proms);
@@ -3084,7 +3082,8 @@ async function _locale(locale, keepPhrases, noMerge, settings, deps) {
         const newSettings = deps.extend({}, settings, data);
         return { kind: "load", file: localeStr, data, settings: newSettings };
       } else {
-        const newSettings = deps.extend({}, settings, TsLocale, { phrases: {} }, data);
+        const phrasesCleared = { ...settings, phrases: {} };
+        const newSettings = deps.extend({}, phrasesCleared, TsLocale, data);
         return { kind: "load", file: localeStr, data, settings: newSettings };
       }
     }
@@ -7675,11 +7674,11 @@ var TsToolbar = class extends TsBase {
       pendingRefresh: {}
       // what should be refreshed with a debounce
     };
-    this._refresh = ({ effected, resize: resize2, refreshTooltip }) => {
+    this._refresh = ({ effected, resize: resize2, refreshTooltip, hideTooltip }) => {
       const options2 = this.last.pendingRefresh;
       options2.ids ??= [];
       options2.ids.push(...effected);
-      Object.assign(options2, { resize: resize2, refreshTooltip });
+      Object.assign(options2, { resize: resize2, refreshTooltip, hideTooltip });
       this._refreshDebounced();
     };
     this._refreshDebounced = TsUtils.debounce(() => {
@@ -7736,10 +7735,6 @@ var TsToolbar = class extends TsBase {
         console.log('ERROR: The parameter "id" is required but not supplied.', item);
         return;
       }
-      if (item.type == null) {
-        console.log('ERROR: The parameter "type" is required but not supplied.', item);
-        return;
-      }
       if (!TsUtils.checkUniqueId(item.id, this.items, "toolbar", this.name)) return;
       const newItem = TsUtils.extend({}, this.item_template, item);
       if (newItem.type == "group" && Array.isArray(newItem.items)) {
@@ -7750,14 +7745,21 @@ var TsToolbar = class extends TsBase {
       if (newItem.type == "menu-check") {
         if (!Array.isArray(newItem.selected)) newItem.selected = [];
         if (Array.isArray(newItem.items)) {
-          newItem.items.forEach((it) => {
+          newItem.items.forEach((it, idx2, arr2) => {
             if (typeof it === "string") {
-              it = arr[idx] = { id: it, text: it };
+              it = arr2[idx2] = { id: it, text: it };
             }
             if (it.checked && !newItem.selected.includes(it.id)) newItem.selected.push(it.id);
             if (!it.checked && newItem.selected.includes(it.id)) it.checked = true;
             if (it.checked == null) it.checked = false;
           });
+        } else if (typeof newItem.items === "function") {
+          const materialized = newItem.items(newItem);
+          if (Array.isArray(materialized)) {
+            materialized.forEach((it) => {
+              if (it && it.checked && !newItem.selected.includes(it.id)) newItem.selected.push(it.id);
+            });
+          }
         }
       } else if (newItem.type == "menu-radio") {
         if (Array.isArray(newItem.items)) {
@@ -7776,7 +7778,12 @@ var TsToolbar = class extends TsBase {
         this.items.push(newItem);
       } else {
         const middle = this.get(id, true);
-        this.items = this.items.slice(0, middle).concat([newItem], this.items.slice(middle));
+        if (middle == null) {
+          console.warn(`TsToolbar: insert anchor id "${id}" not found; appending instead.`);
+          this.items.push(newItem);
+        } else {
+          this.items = this.items.slice(0, middle).concat([newItem], this.items.slice(middle));
+        }
       }
       newItem.line = newItem.line ?? 1;
       if (skipRefresh !== true) this.refresh(newItem.id);
@@ -7793,7 +7800,15 @@ var TsToolbar = class extends TsBase {
       effected++;
       query10(this.box).find("#tb_" + this.name + "_item_" + TsUtils.escapeId(it.id)).remove();
       const ind = this.get(it.id, true);
-      if (ind != null) this.items.splice(ind, 1);
+      if (ind != null) {
+        const top = this.items[ind];
+        if (top.id === it.id) {
+          this.items.splice(ind, 1);
+        } else if (top.type === "group" && Array.isArray(top.items)) {
+          const subIdx = top.items.findIndex((s) => s && s.id === it.id);
+          if (subIdx !== -1) top.items.splice(subIdx, 1);
+        }
+      }
     });
     this.resize();
     return effected;
@@ -7849,7 +7864,10 @@ var TsToolbar = class extends TsBase {
         else return it;
       } else if (it.type == "group") {
         const sub = this.get(id, returnIndex, it.items);
-        if (sub != null) return sub;
+        if (sub != null) {
+          if (returnIndex === true) return i1;
+          return sub;
+        }
       }
     }
     return null;
@@ -7868,6 +7886,8 @@ var TsToolbar = class extends TsBase {
       item.count = count;
     } else {
       this.set(id, { count });
+      const after = query10(this.box).find(`#tb_${this.name}_item_${TsUtils.escapeId(id)} .tsg-tb-count > span`);
+      if (after.length === 0) return;
       this.setCount(id, count, className, style);
     }
   }
@@ -7974,6 +7994,55 @@ var TsToolbar = class extends TsBase {
     this._refresh({ effected });
     return effected;
   }
+  /**
+   * Toggle the `checked` state of one or more items.
+   *
+   * State management only — does NOT fire events (no `onClick`, no `onChange`)
+   * and does NOT open drop / menu / color overlays. For full UI interaction
+   * including opening pickers, call `click(id)` instead.
+   *
+   * Per-item behaviour:
+   *   - button / check / html / spacer / break: flips `it.checked`.
+   *   - drop / menu / menu-radio / menu-check / color / text-color: if currently
+   *     checked, closes the toolbar's `-drop` overlay via `TsTooltip.hide` before
+   *     flipping. Same overlay-close path as `uncheck()`. Never opens overlays.
+   *   - radio: emits `console.warn` and is skipped (would leave the group with
+   *     no checked member). Use `check()` / `uncheck()` for radios.
+   *   - group: recurses into `it.items` and toggles each child individually; the
+   *     group container itself is never in the effected list.
+   *   - sub-id with `:` notation: skipped (same guard as siblings).
+   *   - missing id: silently skipped.
+   *
+   * @param args  ids of items to toggle. Varargs, independent per id.
+   * @returns     array of ids whose checked state actually flipped. Never `undefined`.
+   */
+  // any: array of heterogeneous runtime values; TsToolbar item shape varies by `type` at runtime
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  toggle(...args) {
+    const effected = [];
+    args.flat().forEach((item) => {
+      const it = this.get(item);
+      if (!it || String(item).indexOf(":") != -1) return;
+      if (it.type == "radio") {
+        console.warn(`TsToolbar.toggle: radio items are not supported, use check()/uncheck() instead. Item: ${item}`);
+        return;
+      }
+      if (it.type == "group") {
+        const childIds = it.items.map((itm) => itm.id);
+        const childEffected = this.toggle(...childIds);
+        effected.push(...childEffected);
+        return;
+      }
+      const newChecked = !it.checked;
+      if (["menu", "menu-radio", "menu-check", "drop", "color", "text-color"].includes(it.type) && it.checked) {
+        TsTooltip.hide(this.name + "-drop");
+      }
+      it.checked = newChecked;
+      effected.push(String(item).split(":")[0]);
+    });
+    this._refresh({ effected });
+    return effected;
+  }
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   click(id, event2) {
     const tmp = String(id).split(":");
@@ -8261,7 +8330,7 @@ var TsToolbar = class extends TsBase {
       const next = parseInt(this.get(id, true)) + 1;
       let $next = query10(this.box).find(`#tb_${this.name}_item_${TsUtils.escapeId(this.items[next] ? this.items[next].id : "--")}`);
       if ($next.length == 0) {
-        $next = query10(this.box).find(`.tsg-tb-line:nth-child(${it.line}`).find(".tsg-tb-right").before(html);
+        $next = query10(this.box).find(`.tsg-tb-line:nth-child(${it.line})`).find(".tsg-tb-right").before(html);
       } else {
         $next.after(html);
       }
@@ -8319,6 +8388,8 @@ var TsToolbar = class extends TsBase {
   destroy() {
     const edata = this.trigger("destroy", { target: this.name });
     if (edata.isCancelled === true) return;
+    TsTooltip.hide(this.name + "-tooltip");
+    TsTooltip.hide(this.name + "-drop");
     if (query10(this.box).find(".tsg-scroll-wrapper").length > 0) {
       this.unmount();
     }
@@ -8384,6 +8455,7 @@ var TsToolbar = class extends TsBase {
           }
           text = `<span style="color: ${color}">${item.text ? TsUtils.lang(item.text) : item.backColor ? `<b style="background-color: ${bcolor ?? "transparent"}; padding: 2px 5px; border-radius: 3px;">Ab</b>` : "<b>Ab</b>"}</span>`;
         }
+      // falls through
       case "menu":
       case "menu-check":
       case "menu-radio":
@@ -8468,7 +8540,7 @@ var TsToolbar = class extends TsBase {
       }
       case "group": {
         html = `<div id="tb_${this.name}_item_${item.id}" class="tsg-tb-group"
-                    style="display: flex; ${item.hidden ? "display: none" : ""}; ${item.style ? item.style : ""}">`;
+                    style="display: ${item.hidden ? "none" : "flex"}; ${item.style ? item.style : ""}">`;
         if (Array.isArray(item.items)) {
           item.items.forEach((it) => {
             html += this.getItemHTML(it);
@@ -8533,8 +8605,11 @@ var TsToolbar = class extends TsBase {
     if (it.input?.spinner || it.input?.min != null || it.input?.max != null || it.input?.step != null) {
       value = parseFloat(value);
     }
-    if (it.input?.suffix != null && String(value).substr(-it.input.suffix.length) == it.input.suffix) {
-      value = String(value).substr(0, value.length - it.input.suffix.length);
+    if (it.input?.suffix != null) {
+      const strValue = String(value);
+      if (strValue.substr(-it.input.suffix.length) == it.input.suffix) {
+        value = strValue.substr(0, strValue.length - it.input.suffix.length);
+      }
     }
     if (it.input?.min != null && it.input.min > value) {
       value = it.input.min;
@@ -8681,7 +8756,10 @@ var TsToolbar = class extends TsBase {
   mouseAction(event2, target, action, id) {
     const btn = this.get(id);
     const edata = this.trigger("mouse" + action, { target: id, item: btn, object: btn, originalEvent: event2 });
-    if (edata.isCancelled === true || btn.disabled || btn.hidden) return;
+    if (edata.isCancelled === true || btn.disabled || btn.hidden) {
+      edata.finish();
+      return;
+    }
     switch (action) {
       case "Enter":
         if (!["label", "input"].includes(btn.type)) {