tsgrid-ui 2.2.0 → 2.4.0

package/CHANGELOG.md

@@ -2,6 +2,92 @@
 
 All notable changes to **TsGrid UI** will be documented in this file.
 
+## v2.4.0 — 2026-05-13
+
+### Added
+
+- **Minified bundles** — new `dist/tsgrid-ui.min.js` (CJS, IIFE-wrapped) and `dist/tsgrid-ui.es6.min.js` (ESM). ~46% smaller than non-min counterparts (~508 KB vs ~947 KB). Non-min bundles remain the default for debugging; minified are opt-in by direct path.
+- **ESM sourcemap** — `dist/tsgrid-ui.es6.js.map` shipped alongside the ESM bundle for consumer debugging. CJS sourcemap intentionally omitted (incompatible with the legacy IIFE wrapper rewrite).
+- **ESLint enforcement of INV-8** — new `no-restricted-syntax` rule scoped to `src/tsutils-*.ts` blocks `arguments.length` (codifies the delegator-trap discovered in v2.1 / fixed in v2.3 into the lint gate).
+
+### Refactor
+
+Decomposed the **DOM cluster** (8 methods, ~397 LOC) out of `TsUtils` into a new leaf module `src/tsutils-dom.ts` — **no breaking changes**, public API preserved. Class methods remain; bodies are now one-line delegators routing to pure functions in the sibling module.
+
+- `src/tsutils-dom.ts` — `transition`, `lock`, `unlock`, `getSize`, `getStrDimentions`, `getStrWidth`, `getStrHeight`, `bindEvents` extracted as stateless functions (~234 LOC). Zero `this.X` references in function bodies (INV-9); no import from `tsbase.ts` (INV-4 leaf rule).
+- `TsLockOptions` interface moved to `tsutils-dom.ts` and re-exported via `tsutils.ts` barrel (TsCloneOptions / TsMessageOptions pattern). Public API unchanged.
+- `lock()` internal `this.unlock(...)` call → direct module-level `unlock()` call (R-DOM-1 mitigation).
+- `getStrDimentions()` internal `this.encodeTags(...)` → import `_encodeTags` from `tsutils-string.js` (R-DOM-2 mitigation).
+- `src/tsutils.ts` shrinks from ~1,602 → ~1,470 LOC. **NET REPO DELTA: −18 LOC** (397 removed inline, 234 + 25 added in dom + delegators).
+
+`TsUtils` singleton shape and all ~49+ call sites: **UNCHANGED**. SEMVER MINOR. BC verdict: NONE.
+
+### Improved (type)
+
+- `TsUtils.getStrDimentions(str, styles): { width: number; height: number }`, `TsUtils.getStrWidth(str, styles): number`, `TsUtils.getStrHeight(str, styles): number` — return types narrowed from accidental `any` to explicit `number`. **Type improvement, runtime-equivalent**; no behavior change. Consumers using strict tsconfig settings will see the tighter types (all previously valid call sites remain valid — `any → number` is a strict refinement).
+
+### Internal
+
+- `@internal` JSDoc + tsup `stripInternal: true` for private surface (`_msgDeps`/`_confirmDeps`/`_promptDeps`, plus `TsFormatterExtra`/`TsFormatter`/`TsTimeResult`). `dist/tsgrid-ui.d.ts` reduced ~1.07% (93,567 → 92,564 B). Larger reductions deferred to v2.5+ (root cause: `TsFormatter`/`TsTimeResult` referenced inline in public method signatures, so tsc re-emits them).
+- `scripts/wrap-legacy.mjs` regex generalized to match esbuild's minified `module.exports=ui(_i);` form (anchors removed) — handles both `tsgrid-ui.js` and `tsgrid-ui.min.js` (R-WRAP-1 mitigation).
+
+### Tests
+
+- Added 27 unit tests (197 → 224) covering DOM cluster (lock/unlock/getSize/getStrDimentions/getStrWidth/getStrHeight/bindEvents). `transition` covered by Playwright smoke only (jsdom cannot observe CSS animations).
+
+### Bundle
+
+Non-min delta vs v2.3.0 baseline:
+- `dist/tsgrid-ui.js`: 946,684 → 946,553 B (−0.014%)
+- `dist/tsgrid-ui.es6.js`: 944,836 → 944,746 B (−0.010%)
+
+New minified artifacts:
+- `dist/tsgrid-ui.min.js`: ~509 KB (−46.3% vs non-min)
+- `dist/tsgrid-ui.es6.min.js`: ~508 KB (−46.3%)
+
+All within ±2% gate. PASSED.
+
+### BC
+
+Net-additive (new artifacts + type narrowing). Public method signatures: byte-identical for transition/lock/unlock/getSize/bindEvents. `getStrWidth/Height/getStrDimentions` types narrowed `any → number` (strict superset; no runtime change). SEMVER MINOR. BC verdict: NONE.
+
+---
+
+## v2.3.0 — 2026-05-13
+
+### Refactor
+
+Decomposed the **message cluster** (652 LOC) out of `TsUtils` into two new sibling modules — **no breaking changes**, public API byte-identical to v2.2.0. Class methods remain; bodies are now one-line delegators routing to plain functions in sibling modules.
+
+- `src/tsutils-registry.ts` — `TsUi` widget registry + `checkName()` validation helper. Phase 0 Cycle-Break: severs the `tsbase ↔ tsutils` circular import that existed since v1.x. `tsbase.ts` now imports from `tsutils-registry.ts`, `tsutils-data.ts`, `tsutils-type-guards.ts`, and `query.js` directly — zero edges back into `tsutils.ts`.
+- `src/tsutils-notify.ts` — `notify()` pure function + `NotifyDeps` DI interface. Imports only `query.js`; `this.tmp` state passed by reference via `deps.tmpSlot`.
+- `src/tsutils-message.ts` — `normButtons()`, `_message()`, `_alert()`, `_confirm()`, `_prompt()` pure functions + `MessageDeps`, `NotifyDeps`, `ConfirmDeps`, `PromptDeps` DI interfaces + `TsMessageProm`, `TsMessageWhere`, `TsMessageOptions` type definitions. The only sub-module permitted to import `TsBase` from `tsbase.ts` (required for event-mixin instantiation; documented carve-out to INV-4).
+
+`TsUtils` singleton shape and all ~788+ call sites: **UNCHANGED**. SEMVER MINOR. BC verdict: NONE.
+
+### Added
+
+- New internal DI interfaces exported from `tsutils-message.ts`: `MessageDeps`, `ConfirmDeps`, `PromptDeps`.
+- `TsMessageProm`, `TsMessageWhere`, `TsMessageOptions` types relocated from inline declarations in `tsutils.ts` to `tsutils-message.ts`; re-exported via `tsutils.ts` barrel — all existing import paths remain valid.
+
+### Fixed
+
+- **`arguments.length == 1` overload trap** in `message()`, `confirm()`, and `prompt()`: the class delegator always passes 2 arguments to the extracted function, making `arguments.length` always `2` and silently breaking the single-arg `where-as-options` call form. Replaced with `options == null` (loose-equality covers both `undefined` and `null`). Behavior is a strict superset: additionally fixes `confirm(where, null)` and `prompt(where, null)` which previously assigned `null` to `msgOpts` and would crash on subsequent property access. Locked by parity tests (1-arg vs 2-arg-undefined produce identical DOM output for each method).
+
+### Tests
+
+- Added 82 unit tests (115 → 197): 6 registry (Phase 0), 17 notify (Phase 1), 15 normButtons (Phase 2), 15 message scaffold (Phase 3a), 14 message body/animation/parity (Phase 3b), 15 alert/confirm/prompt/parity (Phase 4).
+
+### Bundle
+
+Delta vs v2.2.0 baseline: `dist/tsgrid-ui.js` 946,684 B (+1,648 B, +0.17%), `dist/tsgrid-ui.es6.js` 944,836 B (+1,657 B, +0.18%). Within ±2% gate. PASSED.
+
+### BC
+
+Net-additive. All `TsUtils` method signatures, arities, return types, and runtime behavior unchanged. Three type definitions relocated (re-exported at original paths). SEMVER MINOR. BC verdict: NONE.
+
+---
+
 ## v2.2.0 — 2026-05-13
 
 ### Added

package/dist/tsgrid-ui.css

@@ -1,4 +1,4 @@
-/* tsgrid-ui 1.0.x (nightly) (5/13/2026, 4:05:55 PM) (c) 2014 vitmalina@gmail.com, (c) 2026 DaverSoGT — MIT */
+/* tsgrid-ui 1.0.x (nightly) (5/13/2026, 7:24:54 PM) (c) 2014 vitmalina@gmail.com, (c) 2026 DaverSoGT — MIT */
 /**
 * TODO:
 *  - remove default styling, only keep tsg-* styles
@@ -9,7 +9,7 @@
 */
 @font-face {
   font-family: "tsgrid-font";
-  src: url("data:application/x-font-woff;charset=utf-8;base64,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") format("woff");
+  src: url("data:application/x-font-woff;charset=utf-8;base64,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") format("woff");
   font-weight: normal;
   font-style: normal;
 }

package/dist/tsgrid-ui.d.ts

@@ -1,3 +1,152 @@
+type QuerySelector = string | Node | Window | Query | Array<Node | Element> | Iterable<Node | Element> | null | undefined;
+type QueryContext = Document | Element | ShadowRoot | DocumentFragment;
+interface EventRecord {
+    event: string;
+    scope: string | undefined;
+    callback: EventListener;
+    options: AddEventListenerOptions | boolean | undefined;
+}
+interface MQueryData {
+    events?: EventRecord[];
+    prevDisplay?: string;
+    [key: string]: unknown;
+}
+declare global {
+    interface Node {
+        _mQuery?: MQueryData;
+    }
+}
+declare class Query {
+    static version: number;
+    context: QueryContext;
+    nodes: Node[];
+    length: number;
+    [index: number]: Node;
+    constructor(selector: QuerySelector, context?: QueryContext);
+    static _fragment(html: string): DocumentFragment;
+    static _scriptConvert(node: Node): Node;
+    static _fixProp(name: string): string;
+    _insert(method: string, html: string | Query | Node): Query;
+    _save(node: Node, name: string, value: unknown): void;
+    get(index?: number): Node | Node[] | null;
+    eq(index: number): Query;
+    then(fun: (q: Query) => Query | null | undefined): Query;
+    find(selector: string): Query;
+    filter(selector: string | Node | ((node: Node) => boolean)): Query;
+    next(): Query;
+    prev(): Query;
+    shadow(selector?: string): Query;
+    closest(selector: string): Query;
+    host(all?: boolean): Query;
+    parent(selector?: string): Query;
+    parents(selector?: string, firstOnly?: boolean): Query;
+    add(more: Query | Node | Node[]): Query;
+    each(func: (node: Node, ind: number, col: Query) => void): Query;
+    append(html: string | Query | Node): Query;
+    prepend(html: string | Query | Node): Query;
+    after(html: string | Query | Node): Query;
+    before(html: string | Query | Node): Query;
+    replace(html: string | Query | Node): Query;
+    remove(): Query;
+    css(key?: string | Record<string, string | number>, value?: string | number): string | Record<string, string> | undefined | Query;
+    addClass(classes: string): Query;
+    removeClass(classes: string | string[] | null): Query;
+    toggleClass(classes: string | string[] | null, force?: boolean): Query;
+    hasClass(classes: string | string[] | null): boolean | string[];
+    on(events: string, options: AddEventListenerOptions | EventListener | {
+        delegate?: string;
+    } | undefined, callback?: EventListener): Query;
+    on(events: string, callback: EventListener): Query;
+    off(events?: string, options?: AddEventListenerOptions | EventListener, callback?: EventListener): Query;
+    trigger(name: string | Event | CustomEvent, options?: EventInit): Query;
+    attr(name: string): string | undefined;
+    attr(name: string | Record<string, string>, value?: string): Query;
+    removeAttr(...attrs: string[]): Query;
+    prop(name: string): unknown;
+    prop(name: string | Record<string, unknown>, value?: unknown): Query;
+    removeProp(...props: string[]): Query;
+    data(key?: string | Record<string, unknown>, value?: unknown): unknown | Query;
+    removeData(key: string | string[]): Query;
+    show(): Query;
+    hide(): Query;
+    toggle(force?: boolean): Query;
+    empty(): Query;
+    html(html?: string | HTMLElement): string | Query | undefined;
+    text(text?: string): unknown | Query;
+    val(value?: string): unknown | Query;
+    change(): Query;
+    click(): Query;
+}
+
+/**
+ * Part of TsUi 2.0 library — color cluster sub-module
+ *  - Extracted from src/tsutils.ts by v2.1 SDD refactor (Phase 2)
+ *  - No dependencies on TsBase, TsUtils, or any other sub-module (L1 DAG leaf)
+ *  - All exports are plain functions — no default export
+ *
+ * 4-space indent (project convention for sub-modules).
+ */
+/** RGB(A) color as returned by parseColor() */
+interface TsColorRgb {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+
+/**
+ * TsUtils v2.1 — Data / Object helpers sub-module (Phase 3+4 of v2.1 SDD)
+ *
+ * Contains: TsCloneOptions, clone, extend,
+ *           naturalCompare, normMenu, getNested, encodeParams,
+ *           prepareParams, parseRoute, debounce, wait
+ *
+ * Rules:
+ *  - No default export
+ *  - No import from tsbase.ts (INV-4)
+ *  - No this.-dispatch inside function bodies (INV-8)
+ *  - 4-space indent
+ */
+/** Options for TsUtils.clone() */
+interface TsCloneOptions {
+    functions?: boolean;
+    elements?: boolean;
+    events?: boolean;
+    exclude?: string[] | ((key: string, ctx: {
+        obj: unknown;
+        parent: string;
+    }) => boolean);
+    parent?: string;
+}
+/** Options for TsUtils.normMenu() */
+interface TsNormMenuOptions {
+    itemMap?: {
+        id: string;
+        text: string;
+    };
+    [key: string]: unknown;
+}
+
+/**
+ * TsUi registry + checkName — Phase 0 of v2.3 SDD.
+ * DEPENDENCY-FREE: zero imports from tsutils/tsbase family.
+ *
+ * Hosts the mutable widget registry object (TsUi) and the name-validation
+ * helper (checkName) that were previously coupled to tsbase.ts via tsutils.ts,
+ * creating a tsbase ↔ tsutils import cycle. Moving them here breaks that cycle:
+ *
+ *   tsbase.ts → tsutils-registry.ts → tsutils-type-guards.ts → (leaf)
+ *
+ * tsutils.ts re-exports TsUi from this module (does NOT re-declare it) to
+ * preserve the single-object identity required by INV-12 (referential equality
+ * across all import paths).
+ *
+ * Imports: only isAlphaNumeric from ./tsutils-type-guards.js
+ * Exports: TsUi, checkName
+ */
+/** Widget registry — widgets register here when constructed with a `name`. */
+declare const TsUi: Record<string, unknown>;
+
 /**
  * Part of TsUi 2.0 library
  *  - Dependencies: TsUtils
@@ -33,8 +182,6 @@ interface TsEventPayload<TDetail = unknown> {
     isCancelled: boolean;
     /** Reference to the widget that triggered this event. CIRCULAR — do not serialize. */
     owner: unknown;
-    /** @internal — Promise resolved when listeners settle; do not depend on shape. */
-    complete?: Promise<unknown>;
 }
 interface TsEventData {
     type?: string | null;
@@ -147,133 +294,103 @@ declare class TsBase {
     unmount(): void;
 }
 
-type QuerySelector = string | Node | Window | Query | Array<Node | Element> | Iterable<Node | Element> | null | undefined;
-type QueryContext = Document | Element | ShadowRoot | DocumentFragment;
-interface EventRecord {
-    event: string;
-    scope: string | undefined;
-    callback: EventListener;
-    options: AddEventListenerOptions | boolean | undefined;
-}
-interface MQueryData {
-    events?: EventRecord[];
-    prevDisplay?: string;
-    [key: string]: unknown;
-}
-declare global {
-    interface Node {
-        _mQuery?: MQueryData;
-    }
-}
-declare class Query {
-    static version: number;
-    context: QueryContext;
-    nodes: Node[];
-    length: number;
-    [index: number]: Node;
-    constructor(selector: QuerySelector, context?: QueryContext);
-    static _fragment(html: string): DocumentFragment;
-    static _scriptConvert(node: Node): Node;
-    static _fixProp(name: string): string;
-    _insert(method: string, html: string | Query | Node): Query;
-    _save(node: Node, name: string, value: unknown): void;
-    get(index?: number): Node | Node[] | null;
-    eq(index: number): Query;
-    then(fun: (q: Query) => Query | null | undefined): Query;
-    find(selector: string): Query;
-    filter(selector: string | Node | ((node: Node) => boolean)): Query;
-    next(): Query;
-    prev(): Query;
-    shadow(selector?: string): Query;
-    closest(selector: string): Query;
-    host(all?: boolean): Query;
-    parent(selector?: string): Query;
-    parents(selector?: string, firstOnly?: boolean): Query;
-    add(more: Query | Node | Node[]): Query;
-    each(func: (node: Node, ind: number, col: Query) => void): Query;
-    append(html: string | Query | Node): Query;
-    prepend(html: string | Query | Node): Query;
-    after(html: string | Query | Node): Query;
-    before(html: string | Query | Node): Query;
-    replace(html: string | Query | Node): Query;
-    remove(): Query;
-    css(key?: string | Record<string, string | number>, value?: string | number): string | Record<string, string> | undefined | Query;
-    addClass(classes: string): Query;
-    removeClass(classes: string | string[] | null): Query;
-    toggleClass(classes: string | string[] | null, force?: boolean): Query;
-    hasClass(classes: string | string[] | null): boolean | string[];
-    on(events: string, options: AddEventListenerOptions | EventListener | {
-        delegate?: string;
-    } | undefined, callback?: EventListener): Query;
-    on(events: string, callback: EventListener): Query;
-    off(events?: string, options?: AddEventListenerOptions | EventListener, callback?: EventListener): Query;
-    trigger(name: string | Event | CustomEvent, options?: EventInit): Query;
-    attr(name: string): string | undefined;
-    attr(name: string | Record<string, string>, value?: string): Query;
-    removeAttr(...attrs: string[]): Query;
-    prop(name: string): unknown;
-    prop(name: string | Record<string, unknown>, value?: unknown): Query;
-    removeProp(...props: string[]): Query;
-    data(key?: string | Record<string, unknown>, value?: unknown): unknown | Query;
-    removeData(key: string | string[]): Query;
-    show(): Query;
-    hide(): Query;
-    toggle(force?: boolean): Query;
-    empty(): Query;
-    html(html?: string | HTMLElement): string | Query | undefined;
-    text(text?: string): unknown | Query;
-    val(value?: string): unknown | Query;
-    change(): Query;
-    click(): Query;
-}
-
 /**
- * Part of TsUi 2.0 library — color cluster sub-module
- *  - Extracted from src/tsutils.ts by v2.1 SDD refactor (Phase 2)
- *  - No dependencies on TsBase, TsUtils, or any other sub-module (L1 DAG leaf)
- *  - All exports are plain functions — no default export
+ * TsUtils message cluster (message/alert/confirm/prompt/normButtons + types)
+ * — Phase 2-4 of v2.3 SDD (message-cluster-extraction).
  *
- * 4-space indent (project convention for sub-modules).
+ * IMPORTANT: This module imports TsBase from tsbase.ts — the only carve-out
+ * to INV-4. Rationale: message() does `new TsBase()` to mix events into msgBase.
+ * This exception is documented here and whitelisted in the INV-4 grep policy.
+ *
+ * Exports (Phase 2):
+ *   normButtons — standalone pure helper; no DOM, no timers
+ *
+ * Exports (Phase 3a):
+ *   TsMessageProm, TsMessageWhere, TsMessageOptions (types)
+ *   MessageDeps (deps interface for _message — scaffold for Phase 3b)
+ *   _message (stub — body lands in Phase 3b)
+ *
+ * Exports (Phase 3b+):
+ *   _message (full body), _alert, _confirm, _prompt (Phase 4)
+ *
+ * Imports: TsBase from tsbase.ts (INV-4 carve-out, see above)
+ *          TsUISettings type from tsutils.ts (type-only, no runtime dep)
+ *          query from query.js (DOM helper)
  */
-/** RGB(A) color as returned by parseColor() */
-interface TsColorRgb {
-    r: number;
-    g: number;
-    b: number;
-    a: number;
+
+/** Promise-chain handle returned by message() / confirm() / prompt() */
+interface TsMessageProm {
+    self: TsBase;
+    action(callBack: (event: unknown) => void): TsMessageProm;
+    close(callBack: (event: unknown) => void): TsMessageProm;
+    open(callBack: (event: unknown) => void): TsMessageProm;
+    then(callBack: (event: unknown) => void): TsMessageProm;
+    change?: (callBack: (event: unknown) => void) => TsMessageProm;
+    [key: string]: unknown;
+}
+/** Where-descriptor for message() */
+interface TsMessageWhere {
+    box: string | Element | null;
+    after?: string | Element | null;
+    owner?: {
+        name?: string;
+        lock?: (...args: unknown[]) => void;
+        unlock?: (...args: unknown[]) => void;
+        focus?: () => void;
+    };
+    param?: unknown;
+}
+/** Options for message() */
+interface TsMessageOptions {
+    width?: number;
+    height?: number;
+    text?: string | null;
+    body?: string;
+    buttons?: string;
+    html?: string;
+    focus?: number | string | null;
+    hideOn?: string[];
+    actions?: Record<string, unknown>;
+    cancelAction?: string;
+    on?: unknown;
+    onOpen?: unknown;
+    onClose?: unknown;
+    onAction?: unknown;
+    originalWidth?: number;
+    originalHeight?: number;
+    msgIndex?: number;
+    tmp?: {
+        zIndex: string;
+        overflow: string;
+    };
+    input?: Element | null;
+    box?: Element | null;
+    trigger?: (event: string, data: Record<string, unknown>) => unknown;
+    close?: () => void;
+    setFocus?: (focus: number | string | null | undefined) => void;
+    action?: (action: string, event: unknown) => void;
+    [key: string]: unknown;
 }
 
 /**
- * TsUtils v2.1 — Data / Object helpers sub-module (Phase 3+4 of v2.1 SDD)
+ * TsUtils DOM sub-module — Phase 5b of v2.4 SDD.
+ * DAG position: leaf module (no tsbase/tsutils imports).
  *
- * Contains: TsCloneOptions, clone, extend,
- *           naturalCompare, normMenu, getNested, encodeParams,
- *           prepareParams, parseRoute, debounce, wait
+ * Imports: ./tsutils-string.js (_encodeTags), ./tsutils-type-guards.js (_isInt),
+ *          ./tsutils-data.js (_extend), ./query.js (query, Query), DOM globals only.
+ * 4-space indent convention.
  *
- * Rules:
- *  - No default export
- *  - No import from tsbase.ts (INV-4)
- *  - No this.-dispatch inside function bodies (INV-8)
- *  - 4-space indent
+ * INV-4: MUST NOT import from tsbase.ts or tsutils.ts.
+ * INV-8: No arguments.length usage.
+ * INV-9: No this.X in exported function bodies.
  */
-/** Options for TsUtils.clone() */
-interface TsCloneOptions {
-    functions?: boolean;
-    elements?: boolean;
-    events?: boolean;
-    exclude?: string[] | ((key: string, ctx: {
-        obj: unknown;
-        parent: string;
-    }) => boolean);
-    parent?: string;
-}
-/** Options for TsUtils.normMenu() */
-interface TsNormMenuOptions {
-    itemMap?: {
-        id: string;
-        text: string;
-    };
-    [key: string]: unknown;
+/** Options for TsUtils.lock() — moved from tsutils.ts (Phase 5a of v2.4 SDD) */
+interface TsLockOptions {
+    msg?: string | number;
+    spinner?: boolean;
+    opacity?: number;
+    bgColor?: string;
+    onClick?: () => void;
 }
 
 /**
@@ -310,7 +427,6 @@ interface TsNormMenuOptions {
  */
 
 declare const query: (selector: unknown, context?: unknown) => Query;
-declare const TsUi: Record<string, unknown>;
 /** Settings object merged from TsLocale + user locale overrides */
 interface TsUISettings {
     dataType: string;
@@ -336,29 +452,6 @@ interface TsUISettings {
     locale?: string;
     [key: string]: unknown;
 }
-/** Extra data passed to grid cell formatters */
-interface TsFormatterExtra {
-    value: unknown;
-    params?: unknown;
-    record?: unknown;
-    [key: string]: unknown;
-}
-/** Signature of a grid-cell formatter function */
-type TsFormatter = (record: TsFormatterExtra, extra?: TsFormatterExtra) => string;
-/** Options for TsUtils.lock() */
-interface TsLockOptions {
-    msg?: string | number;
-    spinner?: boolean;
-    opacity?: number;
-    bgColor?: string;
-    onClick?: () => void;
-}
-/** Return value from TsUtils.isTime() when retTime === true */
-interface TsTimeResult {
-    hours: number;
-    minutes: number;
-    seconds: number;
-}
 
 /** A normalized menu item */
 interface TsMenuItem {
@@ -370,59 +463,6 @@ interface TsMenuItem {
     attrs?: string;
     [key: string]: unknown;
 }
-/** Promise-chain handle returned by TsUtils.message() / .confirm() / .prompt() */
-interface TsMessageProm {
-    self: TsBase;
-    action(callBack: (event: unknown) => void): TsMessageProm;
-    close(callBack: (event: unknown) => void): TsMessageProm;
-    open(callBack: (event: unknown) => void): TsMessageProm;
-    then(callBack: (event: unknown) => void): TsMessageProm;
-    change?: (callBack: (event: unknown) => void) => TsMessageProm;
-    [key: string]: unknown;
-}
-/** Where-descriptor for TsUtils.message() */
-interface TsMessageWhere {
-    box: string | Element | null;
-    after?: string | Element | null;
-    owner?: {
-        name?: string;
-        lock?: (...args: unknown[]) => void;
-        unlock?: (...args: unknown[]) => void;
-        focus?: () => void;
-    };
-    param?: unknown;
-}
-/** Options for TsUtils.message() */
-interface TsMessageOptions {
-    width?: number;
-    height?: number;
-    text?: string | null;
-    body?: string;
-    buttons?: string;
-    html?: string;
-    focus?: number | string | null;
-    hideOn?: string[];
-    actions?: Record<string, unknown>;
-    cancelAction?: string;
-    on?: unknown;
-    onOpen?: unknown;
-    onClose?: unknown;
-    onAction?: unknown;
-    originalWidth?: number;
-    originalHeight?: number;
-    msgIndex?: number;
-    tmp?: {
-        zIndex: string;
-        overflow: string;
-    };
-    input?: Element | null;
-    box?: Element | null;
-    trigger?: (event: string, data: Record<string, unknown>) => unknown;
-    close?: () => void;
-    setFocus?: (focus: number | string | null | undefined) => void;
-    action?: (action: string, event: unknown) => void;
-    [key: string]: unknown;
-}
 declare class Utils {
     version: string;
     tmp: Record<string, unknown>;
@@ -554,11 +594,11 @@ declare class Utils {
     notify(text: string | Record<string, unknown>, options?: Record<string, unknown>): Promise<void>;
     getSize(el: unknown, type: string): number;
     getStrDimentions(str: string, styles?: string, raw?: boolean): {
-        width: any;
-        height: any;
+        width: number;
+        height: number;
     };
-    getStrWidth(str: string, styles?: string, raw?: boolean): any;
-    getStrHeight(str: string, styles?: string, raw?: boolean): any;
+    getStrWidth(str: string, styles?: string, raw?: boolean): number;
+    getStrHeight(str: string, styles?: string, raw?: boolean): number;
     execTemplate(str: any, replace_obj: any): any;
     marker(el: any, items: any, options?: any): unknown;
     lang(phrase: string, params?: Record<string, string | number> | boolean): string;
@@ -1446,17 +1486,6 @@ declare class TsLayout extends TsBase {
  *
  * @module types
  */
-/**
- * Creates a branded (nominal) type from a base type K and brand tag T.
- *
- * @example
- *   type UserId = Brand<number, 'UserId'>
- *
- * @internal
- */
-type Brand<K, T> = K & {
-    readonly __brand: T;
-};
 /**
  * A record identifier value — the `recid` field used across TsGrid records.
  * Can be either a string or a number at runtime; branded to prevent mixing