tsgrid-ui 1.0.1 → 2.1.0

package/CHANGELOG.md

@@ -2,6 +2,78 @@
 
 All notable changes to **TsGrid UI** will be documented in this file.
 
+## v2.1.0 — 2026-05-13
+
+### Refactor
+
+Decomposed `TsUtils` into 5 stateless sub-modules — **no breaking changes**, no public API surface change. The class still exists with the same shape; method bodies are now one-line delegators that route to plain functions in sibling modules.
+
+- `src/tsutils-type-guards.ts` — 9 type-guard functions (`isInt`, `isFloat`, `isMoney`, `isHex`, `isAlphaNumeric`, `isEmail`, `isIpAddress`, `isPlainObject`, `isBin`). `isFloat`/`isMoney` accept a `Pick<TsUISettings, ...>` slice for locale-aware testing.
+- `src/tsutils-color.ts` — 4 color math functions (`parseColor`, `hsv2rgb`, `rgb2hsv`, `colorContrast`) + `TsColorRgb` type. Dual-form dispatch (object-arg vs positional) preserved using `typeof` detection — more robust than `arguments.length` under the delegator pattern.
+- `src/tsutils-data.ts` — 10 data helpers (`clone`, `extend`, `naturalCompare`, `normMenu`, `getNested`, `encodeParams`, `prepareParams`, `parseRoute`, `debounce`, `wait`) + `TsCloneOptions`, `TsNormMenuOptions` types. `prepareParams` accepts `defaultDataType` parameter.
+- `src/tsutils-string.ts` — 10 string/HTML helpers (`stripSpaces`, `stripTags`, `encodeTags`, `decodeTags`, `escapeId`, `unescapeId`, `base64encode`, `base64decode`, `sha256`, `execTemplate`).
+- `src/tsutils-marker.ts` — `marker` + private DOM regex helpers (`_clearMarkers`, `_replace`).
+
+`TsUtils` singleton shape and all ~788 call sites: **UNCHANGED**. SEMVER MINOR. BC verdict: NONE.
+
+### Tests
+
+Added 27 unit tests (84 → 111): 15 color cluster (`parseColor`, `hsv2rgb`, `rgb2hsv`, `colorContrast`) + 2 `isBin` ratchet + 2 object-form regression locks (`hsv2rgb`/`rgb2hsv`) + 6 data ratchet (`getNested`, `normMenu`) + 2 string ratchet (`decodeTags`, `execTemplate`).
+
+### Bundle
+
+Delta vs v2.0.1 baseline: `dist/tsgrid-ui.js` +0.15% (944,879 → 943,454 bytes), `dist/tsgrid-ui.es6.js` +0.15% (943,022 → 941,597 bytes). Within ±2% gate. PASSED.
+
+---
+
+## v2.0.1 — 2026-05-13
+
+### Fixed
+
+- **`MIGRATION_v2.md` now included in the published npm tarball.** v2.0.0 omitted this file from `package.json` `files`, so `CHANGELOG.md` and `README.md` links pointing to `MIGRATION_v2.md` (codemod, bundle measurement, release checklist) broke on npmjs.com. No source code changes — package metadata only.
+
+## v2.0.0 — 2026-05-09
+
+### Breaking changes
+
+**BC-1 — Event handler signatures changed (`CustomEvent` → `TsEventPayload`)**
+
+All `on*` event handler properties across `TsGrid`, `TsForm`, and `TsField` now declare
+`(event: TsEventPayload) => void` instead of `(event: CustomEvent) => void`.
+
+This is a type-level correction: the runtime has always dispatched `TsEventPayload` objects,
+never DOM `CustomEvent` instances. Consumers who explicitly annotated handlers with
+`CustomEvent` will see a TypeScript compile error. Untyped or `any`-typed handlers are
+unaffected. Mechanical migration via codemod — see [MIGRATION_v2.md § Codemod](MIGRATION_v2.md#codemod).
+
+**BC-2 — Internal restructure; deep imports are unsupported**
+
+`src/tsgrid.ts` has been decomposed from ~10,006 LOC into 8 sibling modules:
+`grid-columns`, `grid-state`, `grid-data`, `grid-selection`, `grid-edit`, `grid-search`,
+`grid-interaction`, `grid-render`. The public class `TsGrid` is now ~2,392 LOC (thin
+orchestrator of one-liner delegators).
+
+The public API surface is **UNCHANGED**: all method signatures, names, and behaviors are
+preserved (verified by 84 Vitest + 38 Playwright tests). Consumers who import from the
+public barrel (`import { TsGrid } from 'tsgrid-ui'`) require **no changes**. Subclasses
+or code that inspects `TsGrid.prototype` directly may observe method bodies as one-line
+delegators — this is expected behavior. Deep imports from internal paths
+(`tsgrid-ui/src/*`) are not supported and may break.
+
+### Bundle size disclosure
+
+v2.0 is a structural refactor with no bundle reduction goal. Bundle size delta vs v1.0.1
+baseline: **-0.19%** (actual: 941,597 bytes vs baseline: 943,401 bytes). No reduction is
+claimed. Bundle improvements are deferred to v2.2 (multi-entry subpath exports +
+tree-shaking). See [MIGRATION_v2.md § Bundle size measurement](MIGRATION_v2.md#bundle-size-measurement).
+
+### Migration
+
+See [MIGRATION_v2.md](MIGRATION_v2.md) for the codemod, full migration guide, and
+release checklist.
+
+---
+
 ## [1.0.1] — Consumer DX fixes
 
 Patch release driven by integrating tsgrid-ui v1.0.0 in a real Angular 21 standalone project. Three changes, no breaking, no API removals.

package/MIGRATION_v2.md

@@ -0,0 +1,178 @@
+# Migration Guide: v1.x to v2.0
+
+<!-- baseline: 943401 bytes -->
+
+## Bundle size measurement
+
+| Metric | Value |
+|--------|-------|
+| Baseline (v1.0.1, pre-v2.0) | 943,401 bytes |
+| Post-v2.0 actual | 941,597 bytes |
+| Delta | -1,804 bytes (-0.19%) |
+| Status | PASS (within ±2% gate) |
+| Build date | 2026-05-09 |
+
+v2.0 is a structural refactor with no bundle reduction goal. The -0.19% delta is
+within the ±2% measurement gate and does not constitute a meaningful change. Bundle
+improvements are explicitly deferred to v2.2 (multi-entry subpath exports + tree-shaking).
+
+---
+
+## Overview
+
+`tsgrid-ui` v2.0 is a **code-organisation and type-system release**. No runtime behavior
+changes between v1.0.1 and v2.0.0. All public API method signatures remain identical.
+
+Two breaking changes are documented below (BC-1 and BC-2). Both were intentional and
+are codemod-friendly.
+
+---
+
+## Breaking Change BC-1: Event handler types
+
+### What changed
+
+All `on*` event handler properties on `TsGrid`, `TsForm`, and `TsField` now declare
+`TsEventPayload` as the handler parameter type instead of `CustomEvent`.
+
+**v1.x (old type):**
+```ts
+onSelect: ((event: CustomEvent) => void) | null
+```
+
+**v2.0 (corrected type):**
+```ts
+onSelect: ((event: TsEventPayload) => void) | null
+```
+
+### Why this is a correction, not a new feature
+
+The runtime event system in `TsGrid`/`TsForm` has always passed a `TsEventPayload`
+object to handlers — never a DOM `CustomEvent`. The v1.x type declarations were
+inaccurate. This change aligns the declared types with what was always happening at
+runtime.
+
+### Who is affected
+
+Only consumers who **explicitly annotated** their handler parameter as `CustomEvent`:
+
+```ts
+// This breaks on v2.0 — parameter type mismatch
+grid.onSelect = (event: CustomEvent) => {
+    console.log(event.detail)
+}
+```
+
+Consumers who used **no annotation** or **inferred types** are unaffected:
+
+```ts
+// These continue to work — TypeScript infers TsEventPayload
+grid.onSelect = (event) => { console.log(event.detail) }
+grid.onSelect = (event: TsEventPayload) => { console.log(event.detail) }
+```
+
+### Codemod
+
+Apply the following regex to your source files to migrate in bulk:
+
+**Find:**
+```
+\(event:\s*CustomEvent\)\s*=>
+```
+
+**Replace:**
+```
+(event: TsEventPayload) =>
+```
+
+**Caveats:**
+1. You must add `import type { TsEventPayload } from 'tsgrid-ui'` to each migrated file.
+2. The regex may produce false positives on unrelated DOM `CustomEvent` handler sites
+   (e.g., handlers attached via `element.addEventListener('custom', ...)`). Review
+   replacements manually before committing.
+3. `event.detail` is now typed as `TsEventData` (with `[key: string]: unknown`). If you
+   accessed properties like `event.detail.someField`, TypeScript strict mode requires
+   bracket notation: `event.detail['someField']`. Cast as needed.
+
+### Before / after example
+
+The updated `test/consumer-smoke.ts` is the canonical reference. Below is a condensed
+example:
+
+**Before (v1.x):**
+```ts
+import { TsGrid } from 'tsgrid-ui'
+
+const grid = new TsGrid({ name: 'my-grid', columns: [], records: [] })
+
+// Explicit CustomEvent annotation — BREAKS on v2.0
+grid.onSelect = (event: CustomEvent) => {
+    console.log(event.detail)
+}
+```
+
+**After (v2.0):**
+```ts
+import { TsGrid } from 'tsgrid-ui'
+import type { TsEventPayload } from 'tsgrid-ui'
+
+const grid = new TsGrid({ name: 'my-grid', columns: [], records: [] })
+
+// Option A: explicit TsEventPayload annotation
+grid.onSelect = (event: TsEventPayload) => {
+    console.log(event.detail)
+}
+
+// Option B: remove the annotation — TypeScript infers correctly
+grid.onSelect = (event) => {
+    console.log(event.detail)
+}
+```
+
+`TsEventPayload` has been importable from `tsgrid-ui` since **v1.0.1**. Consumers may
+pre-migrate before upgrading to v2.0.
+
+---
+
+## Breaking Change BC-2: Deep imports are unsupported
+
+v2.0 decomposes `src/tsgrid.ts` into sibling modules (`src/grid-*.ts`). Any import from
+an internal path is **not supported** and carries no stability guarantee:
+
+```ts
+// UNSUPPORTED — may break in any minor or patch release
+import { someHelper } from 'tsgrid-ui/src/tsgrid'
+import { someHelper } from 'tsgrid-ui/src/grid-columns'
+```
+
+Always import from the public barrel:
+
+```ts
+// SUPPORTED — stable public API
+import { TsGrid, TsEventPayload } from 'tsgrid-ui'
+```
+
+---
+
+## Bundle size disclosure
+
+v2.0 decomposes the codebase for maintainability. **Bundle size is unchanged by design.**
+Bundle improvements are deferred to v2.2 (multi-entry subpath exports + tree-shaking).
+
+Do not expect or claim bundle size reduction from upgrading to v2.0.
+
+---
+
+## Release checklist
+
+> Reference — execute manually after PR review and approval. The SDD apply phase does NOT
+> run any of these.
+
+```bash
+# After PR merged to master:
+git checkout master && git pull
+git tag -a v2.0.0 -m "v2.0.0 — TsGrid decomposition + event signature fix"
+git push origin v2.0.0
+pnpm publish --access public --tag latest
+gh release create v2.0.0 --title "v2.0.0 — TsGrid v2 decomposition" --notes-from-tag
+```

package/dist/tsgrid-ui.css

@@ -1,4 +1,4 @@
-/* tsgrid-ui 1.0.x (nightly) (5/9/2026, 12:21:22 AM) (c) 2014 vitmalina@gmail.com, (c) 2026 DaverSoGT — MIT */
+/* tsgrid-ui 1.0.x (nightly) (5/13/2026, 3:29:07 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

@@ -227,6 +227,55 @@ declare class 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;
+}
+
 /**
  * Part of TsUi 2.0 library
  *  - Dependencies: mQuery, TsUtils, TsBase, TsLocale
@@ -310,13 +359,7 @@ interface TsTimeResult {
     minutes: number;
     seconds: number;
 }
-/** RGB(A) color as returned by TsUtils.parseColor() */
-interface TsColorRgb {
-    r: number;
-    g: number;
-    b: number;
-    a: number;
-}
+
 /** A normalized menu item */
 interface TsMenuItem {
     id: string | number | null;
@@ -327,25 +370,6 @@ interface TsMenuItem {
     attrs?: string;
     [key: string]: unknown;
 }
-/** Options for TsUtils.normMenu() */
-interface TsNormMenuOptions {
-    itemMap?: {
-        id: string;
-        text: string;
-    };
-    [key: string]: unknown;
-}
-/** Options for TsUtils.clone() */
-interface TsCloneOptions {
-    functions?: boolean;
-    elements?: boolean;
-    events?: boolean;
-    exclude?: string[] | ((key: string, ctx: {
-        obj: unknown;
-        parent: string;
-    }) => boolean);
-    parent?: string;
-}
 /** Promise-chain handle returned by TsUtils.message() / .confirm() / .prompt() */
 interface TsMessageProm {
     self: TsBase;
@@ -536,7 +560,7 @@ declare class Utils {
     getStrWidth(str: string, styles?: string, raw?: boolean): any;
     getStrHeight(str: string, styles?: string, raw?: boolean): any;
     execTemplate(str: any, replace_obj: any): any;
-    marker(el: any, items: any, options?: any): any;
+    marker(el: any, items: any, options?: any): unknown;
     lang(phrase: string, params?: Record<string, string | number> | boolean): string;
     locale(locale: string | string[] | Record<string, unknown>, keepPhrases?: boolean, noMerge?: boolean): Promise<{
         file: string;
@@ -1723,57 +1747,57 @@ declare class TsGrid extends TsBase {
     operators: Record<string, any[]>;
     defaultOperator: Record<string, string>;
     operatorsMap: Record<string, string>;
-    onAdd: ((event: CustomEvent) => void) | null;
-    onEdit: ((event: CustomEvent) => void) | null;
-    onRequest: ((event: CustomEvent) => void) | null;
-    onLoad: ((event: CustomEvent) => void) | null;
-    onDelete: ((event: CustomEvent) => void) | null;
-    onSave: ((event: CustomEvent) => void) | null;
-    onSelect: ((event: CustomEvent) => void) | null;
-    onClick: ((event: CustomEvent) => void) | null;
-    onDblClick: ((event: CustomEvent) => void) | null;
-    onContextMenu: ((event: CustomEvent) => void) | null;
-    onContextMenuClick: ((event: CustomEvent) => void) | null;
-    onColumnClick: ((event: CustomEvent) => void) | null;
-    onColumnDblClick: ((event: CustomEvent) => void) | null;
-    onColumnContextMenu: ((event: CustomEvent) => void) | null;
-    onColumnResize: ((event: CustomEvent) => void) | null;
-    onColumnAutoResize: ((event: CustomEvent) => void) | null;
-    onSort: ((event: CustomEvent) => void) | null;
-    onSearch: ((event: CustomEvent) => void) | null;
-    onSearchOpen: ((event: CustomEvent) => void) | null;
-    onSearchClose: ((event: CustomEvent) => void) | null;
-    onChange: ((event: CustomEvent) => void) | null;
-    onRestore: ((event: CustomEvent) => void) | null;
-    onExpand: ((event: CustomEvent) => void) | null;
-    onCollapse: ((event: CustomEvent) => void) | null;
-    onError: ((event: CustomEvent) => void) | null;
-    onKeydown: ((event: CustomEvent) => void) | null;
-    onToolbar: ((event: CustomEvent) => void) | null;
-    onColumnOnOff: ((event: CustomEvent) => void) | null;
-    onCopy: ((event: CustomEvent) => void) | null;
-    onPaste: ((event: CustomEvent) => void) | null;
-    onSelectionExtend: ((event: CustomEvent) => void) | null;
-    onEditField: ((event: CustomEvent) => void) | null;
-    onRender: ((event: CustomEvent) => void) | null;
-    onRefresh: ((event: CustomEvent) => void) | null;
-    onReload: ((event: CustomEvent) => void) | null;
-    onResize: ((event: CustomEvent) => void) | null;
-    onDestroy: ((event: CustomEvent) => void) | null;
-    onStateSave: ((event: CustomEvent) => void) | null;
-    onStateRestore: ((event: CustomEvent) => void) | null;
-    onFocus: ((event: CustomEvent) => void) | null;
-    onBlur: ((event: CustomEvent) => void) | null;
-    onReorderRow: ((event: CustomEvent) => void) | null;
-    onSearchSave: ((event: CustomEvent) => void) | null;
-    onSearchRemove: ((event: CustomEvent) => void) | null;
-    onSearchSelect: ((event: CustomEvent) => void) | null;
-    onColumnSelect: ((event: CustomEvent) => void) | null;
-    onColumnDragStart: ((event: CustomEvent) => void) | null;
-    onColumnDragEnd: ((event: CustomEvent) => void) | null;
-    onResizerDblClick: ((event: CustomEvent) => void) | null;
-    onMouseEnter: ((event: CustomEvent) => void) | null;
-    onMouseLeave: ((event: CustomEvent) => void) | null;
+    onAdd: ((event: TsEventPayload) => void) | null;
+    onEdit: ((event: TsEventPayload) => void) | null;
+    onRequest: ((event: TsEventPayload) => void) | null;
+    onLoad: ((event: TsEventPayload) => void) | null;
+    onDelete: ((event: TsEventPayload) => void) | null;
+    onSave: ((event: TsEventPayload) => void) | null;
+    onSelect: ((event: TsEventPayload) => void) | null;
+    onClick: ((event: TsEventPayload) => void) | null;
+    onDblClick: ((event: TsEventPayload) => void) | null;
+    onContextMenu: ((event: TsEventPayload) => void) | null;
+    onContextMenuClick: ((event: TsEventPayload) => void) | null;
+    onColumnClick: ((event: TsEventPayload) => void) | null;
+    onColumnDblClick: ((event: TsEventPayload) => void) | null;
+    onColumnContextMenu: ((event: TsEventPayload) => void) | null;
+    onColumnResize: ((event: TsEventPayload) => void) | null;
+    onColumnAutoResize: ((event: TsEventPayload) => void) | null;
+    onSort: ((event: TsEventPayload) => void) | null;
+    onSearch: ((event: TsEventPayload) => void) | null;
+    onSearchOpen: ((event: TsEventPayload) => void) | null;
+    onSearchClose: ((event: TsEventPayload) => void) | null;
+    onChange: ((event: TsEventPayload) => void) | null;
+    onRestore: ((event: TsEventPayload) => void) | null;
+    onExpand: ((event: TsEventPayload) => void) | null;
+    onCollapse: ((event: TsEventPayload) => void) | null;
+    onError: ((event: TsEventPayload) => void) | null;
+    onKeydown: ((event: TsEventPayload) => void) | null;
+    onToolbar: ((event: TsEventPayload) => void) | null;
+    onColumnOnOff: ((event: TsEventPayload) => void) | null;
+    onCopy: ((event: TsEventPayload) => void) | null;
+    onPaste: ((event: TsEventPayload) => void) | null;
+    onSelectionExtend: ((event: TsEventPayload) => void) | null;
+    onEditField: ((event: TsEventPayload) => void) | null;
+    onRender: ((event: TsEventPayload) => void) | null;
+    onRefresh: ((event: TsEventPayload) => void) | null;
+    onReload: ((event: TsEventPayload) => void) | null;
+    onResize: ((event: TsEventPayload) => void) | null;
+    onDestroy: ((event: TsEventPayload) => void) | null;
+    onStateSave: ((event: TsEventPayload) => void) | null;
+    onStateRestore: ((event: TsEventPayload) => void) | null;
+    onFocus: ((event: TsEventPayload) => void) | null;
+    onBlur: ((event: TsEventPayload) => void) | null;
+    onReorderRow: ((event: TsEventPayload) => void) | null;
+    onSearchSave: ((event: TsEventPayload) => void) | null;
+    onSearchRemove: ((event: TsEventPayload) => void) | null;
+    onSearchSelect: ((event: TsEventPayload) => void) | null;
+    onColumnSelect: ((event: TsEventPayload) => void) | null;
+    onColumnDragStart: ((event: TsEventPayload) => void) | null;
+    onColumnDragEnd: ((event: TsEventPayload) => void) | null;
+    onResizerDblClick: ((event: TsEventPayload) => void) | null;
+    onMouseEnter: ((event: TsEventPayload) => void) | null;
+    onMouseLeave: ((event: TsEventPayload) => void) | null;
     constructor(options: Record<string, any>);
     add(record: TsGridRecord | TsGridRecord[], first?: boolean): number;
     find(obj?: Record<string, any>, returnIndex?: boolean, displayedOnly?: boolean): (string | number)[];
@@ -1801,13 +1825,13 @@ declare class TsGrid extends TsBase {
     hideColumn(...fields: string[]): number;
     /** Add one or more search fields. If `search` is omitted, `before` is treated as the search(es) to append. */
     addSearch(before: any, search?: any): number;
-    removeSearch(...fields: string[]): number;
+    removeSearch(...fields: string[]): any;
     getSearch(): string[];
     getSearch(field: string, returnIndex: true): number | null;
     getSearch(field: string, returnIndex?: false): TsGridSearch | null;
-    toggleSearch(...fields: string[]): number;
-    showSearch(...fields: string[]): number;
-    hideSearch(...fields: string[]): number;
+    toggleSearch(...fields: string[]): any;
+    showSearch(...fields: string[]): any;
+    hideSearch(...fields: string[]): any;
     getSearchData(field: string): Record<string, any> | null;
     localSort(silent?: boolean, noResetRefresh?: boolean): number | undefined;
     localSearch(silent?: boolean): number | undefined;
@@ -1821,7 +1845,7 @@ declare class TsGrid extends TsBase {
     addRange(rangesInput: TsGridRange | TsGridRange[] | string | Record<string, any>): number;
     removeRange(...names: string[]): number;
     refreshRanges(): number | undefined;
-    select(...selectArgs: any[]): number | undefined;
+    select(...selectArgs: any[]): any;
     unselect(...unselectArgs: any[]): number;
     compareSelection(newSel: any[]): {
         select: any[];
@@ -1852,17 +1876,17 @@ declare class TsGrid extends TsBase {
      * compat with the v2.0 API and for callers that genuinely handle both modes.
      */
     getSelection(returnIndex?: boolean): RecId[] | number[] | TsGridCellSelection[];
-    search(field?: any, value?: any): void;
-    searchOpen(options?: any): void;
+    search(field?: any, value?: any): any;
+    searchOpen(options?: any): any;
     searchClose(): void;
-    searchFieldTooltip(ind: any, sd_ind: any, el: any): void;
-    searchSuggest(imediate?: boolean, forceHide?: boolean, anchor?: HTMLElement | Element): void;
+    searchFieldTooltip(ind: any, sd_ind: any, el: any): any;
+    searchSuggest(imediate?: boolean, forceHide?: boolean, anchor?: HTMLElement | Element): any;
     searchSave(): void;
     cache(type: any): any;
-    cacheSave(type: any, value: any): boolean;
+    cacheSave(type: any, value: any): any;
     searchReset(noReload?: boolean): void;
     searchShowFields(forceHide?: boolean): void;
-    searchInitInput(field: string, _value?: any): void;
+    searchInitInput(field: string, _value?: any): any;
     clear(noRefresh?: boolean): void;
     reset(noRefresh?: boolean): void;
     skip(offset: any, callBack?: any): void;
@@ -1874,14 +1898,14 @@ declare class TsGrid extends TsBase {
     getChanges(recordsBase?: TsGridRecord[]): Record<string, any>[];
     mergeChanges(): void;
     save(callBack?: (data: any) => void): void;
-    editField(recid: string | number, column: number, value: any, event?: any): void;
-    editChange(input?: any, index?: any, column?: any, event?: any): void;
-    editDone(index?: any, column?: any, event?: any): void;
+    editField(recid: string | number, column: number, value: any, event?: any): any;
+    editChange(input?: any, index?: any, column?: any, event?: any): any;
+    editDone(index?: any, column?: any, event?: any): any;
     'delete'(force?: boolean): void;
     click(recid: string | number | {
         recid: string | number;
         column?: number;
-    } | any, event?: MouseEvent | any): void;
+    } | any, event?: MouseEvent | any): any;
     columnClick(field: string, event?: MouseEvent | any): void;
     columnDblClick(field: any, event: any): void;
     columnContextMenu(field: any, event: any): void;
@@ -1895,7 +1919,7 @@ declare class TsGrid extends TsBase {
     dblClick(recid: string | number | {
         recid: string | number;
         column?: number;
-    } | any, event?: MouseEvent | any): void;
+    } | any, event?: MouseEvent | any): any;
     showContextMenu(event: MouseEvent | any, options: {
         recid?: string | number;
         index?: number;
@@ -1942,9 +1966,9 @@ declare class TsGrid extends TsBase {
     resizeBoxes(): void;
     resizeRecords(): void;
     getSearchesHTML(): string;
-    getOperators(type: any, opers: any): string;
-    initOperator(ind: any): void;
-    initSearchLists(changedField?: any): void;
+    getOperators(type: any, opers: any): any;
+    initOperator(ind: any): any;
+    initSearchLists(changedField?: any): any;
     initSearches(): void;
     getColumnsHTML(): string[];
     getColumnCellHTML(i: any): string;
@@ -2071,21 +2095,21 @@ declare class TsForm extends TsBase {
         errorsShown?: boolean;
         observeResize?: ResizeObserver;
     };
-    onRequest: ((event: CustomEvent) => void) | null;
-    onLoad: ((event: CustomEvent) => void) | null;
-    onValidate: ((event: CustomEvent) => void) | null;
-    onSubmit: ((event: CustomEvent) => void) | null;
-    onProgress: ((event: CustomEvent) => void) | null;
-    onSave: ((event: CustomEvent) => void) | null;
-    onChange: ((event: CustomEvent) => void) | null;
-    onInput: ((event: CustomEvent) => void) | null;
-    onRender: ((event: CustomEvent) => void) | null;
-    onRefresh: ((event: CustomEvent) => void) | null;
-    onResize: ((event: CustomEvent) => void) | null;
-    onDestroy: ((event: CustomEvent) => void) | null;
-    onAction: ((event: CustomEvent) => void) | null;
-    onToolbar: ((event: CustomEvent) => void) | null;
-    onError: ((event: CustomEvent) => void) | null;
+    onRequest: ((event: TsEventPayload) => void) | null;
+    onLoad: ((event: TsEventPayload) => void) | null;
+    onValidate: ((event: TsEventPayload) => void) | null;
+    onSubmit: ((event: TsEventPayload) => void) | null;
+    onProgress: ((event: TsEventPayload) => void) | null;
+    onSave: ((event: TsEventPayload) => void) | null;
+    onChange: ((event: TsEventPayload) => void) | null;
+    onInput: ((event: TsEventPayload) => void) | null;
+    onRender: ((event: TsEventPayload) => void) | null;
+    onRefresh: ((event: TsEventPayload) => void) | null;
+    onResize: ((event: TsEventPayload) => void) | null;
+    onDestroy: ((event: TsEventPayload) => void) | null;
+    onAction: ((event: TsEventPayload) => void) | null;
+    onToolbar: ((event: TsEventPayload) => void) | null;
+    onError: ((event: TsEventPayload) => void) | null;
     msgRefresh: string;
     msgSaving: string;
     msgServerError: string;