tsgrid-ui 2.1.0 → 2.3.0

package/CHANGELOG.md

@@ -2,6 +2,62 @@
 
 All notable changes to **TsGrid UI** will be documented in this file.
 
+## 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
+
+- **`TsUtils.colorContrastValue(color1, color2): number`** — numeric companion to `colorContrast()` that returns the raw WCAG ratio as a `number` instead of a `.toFixed(2)` string. Consumers performing threshold checks no longer need to wrap the result in `Number(...)` or `parseFloat(...)`.
+
+### Refactor
+
+- `colorContrast()` now delegates to `colorContrastValue().toFixed(2)`. Output is byte-identical to v2.1.0; no behavior change.
+- `tstoolbar.ts` background-color contrast check upgraded to the numeric API (`TsUtils.colorContrastValue('#fff', color) < 2`), removing the `Number(...)` cast.
+
+### Tests
+
+- Added 4 unit tests for `colorContrastValue` (111 → 115): typeof number, white/black ≥ 21 (max WCAG), identical = 1, parity with `colorContrast` string form via `.toFixed(2)`.
+
+### BC
+
+Net-additive. `colorContrast` return type and value unchanged. SEMVER MINOR. BC verdict: NONE.
+
+---
+
 ## v2.1.0 — 2026-05-13
 
 ### Refactor

package/dist/tsgrid-ui.css

@@ -1,4 +1,4 @@
-/* tsgrid-ui 1.0.x (nightly) (5/13/2026, 3:29:07 PM) (c) 2014 vitmalina@gmail.com, (c) 2026 DaverSoGT — MIT */
+/* tsgrid-ui 1.0.x (nightly) (5/13/2026, 5:32:29 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,d09GRgABAAAAAApcAAsAAAAAD0wAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAABHU1VCAAABCAAAADsAAABUIIslek9TLzIAAAFEAAAAQQAAAFZdKW6ZY21hcAAAAYgAAACiAAACNBnCLmJnbHlmAAACLAAABd8AAAfo+edccWhlYWQAAAgMAAAAMQAAADYzdYSTaGhlYQAACEAAAAAYAAAAJA3eCBJobXR4AAAIWAAAABAAAABAeA8AAGxvY2EAAAhoAAAAIgAAACIO+gzSbWF4cAAACIwAAAAfAAAAIAEgAGBuYW1lAAAIrAAAATAAAAI6ubjYZ3Bvc3QAAAncAAAAgAAAAKn1lm/4eJxjYGRgYOBiMGCwY2BycfMJYeDLSSzJY5BiYGGAAJA8MpsxJzM9kYEDxgPKsYBpDiBmg4gCACY7BUgAeJxjYGRvZJzAwMrAwCrCIsXAwHAJQjNdYPBkbAbSDKzMDFhBQJprCoMDgyODP+sdILedbRWDGZBmBMkBAGnVCIcAAAB4nL3R1w3DMAwE0JMlF1kui2SGAE7v3iNfGTJ7OUfhNkgQAo+AqAKBBFAC8LSiALgXHCyerLpc92hzPWCdz4Rcn5eFecrZ2U3mgmcDX6xQo0HkvYQOPQaM3K7wfbjCh7Kqm9imrh/GH7z43+hyfmtl/5/EerqRgrZis9mJdXkvNreDWGePUtNJGjpLpItwnrhKopvY7+7S00MGmmX8AHS1EV0AAHichVRrbBRVFL5nZmfWCtl2ujuzu2x3tjPbbm27bGd39tHN0pZiQSulkJSWNfJMWgokRIK0Bk1ogkbCw/CwGBuKGKsJaFApjRpbjMYfxUeEEH/wwwLRKAbjI8T46O5cPDO7gK/Eydx7vzmve893zxzCEHz4z7gdpIy4CIFQUFF5UXBJuhJLJoQ4qwgKP3ZfOrcrvWJF2rY7vWJLrsX2Idde15XJTWdWrszY0pncZtujGAbMWPYu7mHCEVLC2EuAH81fMH47y0yx33HZ/Itw8w1jsS1gmnGWbZBrJyXESfxkPkmau/OlwEvuEnDaHeAGZ00EuGSoAeV2FqprcEF1AKRkCpIhcEAEmkEG+GJem7hZ5OcxT9OPzx2VPQ54RLjf0cLMhwZ1TI2CE3rg2GG5tcz4tVSUEZQy95aJxuWyhQvEAA72Jjrv8rZJxg3mdRhscyyUDZ758bmAJ4DeLDQo+UnmWPdDpS45z6P3UozC/iG35iXZ8g8sJKzF47NcByI7mYO56ELwzhi8epXxXbvGVFy9ynXMfsQ1FcZtzvgt3AMkiB+SC0mTXEiCWoPsqZh5PFWCUwskY0gLTnxWEGgGzpaXdwlaOc3SLC5dggDjtFMQuso1AU7CeyizfVWO+tW0T4iiuBxGaL/pExVgBF4uyOhKOCMIhbvgf+JmimcPkgV4FkVU3ObQxSDyXBOqxCux82VuGdxSZaoZUskyUGtMTdz6ilkal2XFPMZW5q/tZxzGzcM//MBWpy/sOUAvHthzIZ3JmBi0A89cTGeM8qEd205r0ah2etsOeheyJ/evHepbyxy94/B35/xv//QoQEyjUM+/cl8TH6nELCKAJVVjdwPvjoouKQOxFLhTNXjiEAQT4Obfrdqwvio/Pj1qdJSzPtfPUikzMTo9nq/yenPxE8xbJ7hXERYthHk3XL7bBhvWz868xLx5gtgIufWJXeXnklLiJTGyFPeNJ3EryQ8uvh7UUAKUBNZBQhF0Vv03jxaLbIHMMktUaanLLFP2eDgQC4StCcJ0W28vhHvPjx09eGVBS8uCKwePwpLhQwV8aHjs6Z0DE1Fdj04M7IR77mKbVowQDhhrzAB0m62juQm96XvDh2aaWlqaZg4NwxKM2tQ82/Mvf/q7hc1ckd9h/jXiJlWYa6NZKfEIqA4Q/945QtUxGVwOUCMQbwbA1MWCrgn0Eki5kfs+mo2t2rgqRrPOigqn7TzOxl5v2OsN6/Vebz2zPPf8VIWLOeLynTO20ks9l2G4h5tJrU3hK4uzF0VZFjlNlDdWRBobfL6GxkjF7BbbJyOSLEsjucvw5Jp34Kk1xZp4hTuMp3fieVNQAyxy7UxBENhqSICdzZ5ilncb45cCyxbtPgWzBuUNtgNmKd/PLO5mOruNMzS8aFkANvWbwvyEgQvlThb/3xFugIQwssvO2/mgIhRvXVDUUBOWgq4IhXoQBQUn/gWen+tRaaOm9gQ1mlY1TYVpLdijanBe1Zj3nU5xjoc2WvLzmroK5dNBTQvStKbe6bN2bohU44dq7mkPloCChdMMMZlxOZigGPtLadkGXz6475E10k1ohwfpT44H0+1Tn5870tl55Fz/M08MvB3T9djbA09wu5a2D+0+TvfC48v2NbabatPqACoHd8LcnYNoSAr/2K0c/wv3JaklzYRU409mT6aSibi1WaG+XVYB67FUMoUNHZt0MxPCdhEyu0XSbBaS2Svw5PwH9Liv0duqVoXrR/s2fbO5d7Q+jLB38/b+dauXgscDkXlti3WHlN/Ul+2OxuPR7uynCLAuu7PXIOLxMB2r1/Vv39RXcMQYFqxSW72NPjpaITn0xW2wVS/63Q1gXV2x9w1hPfuITlJkOelCVhPxEF4h7zfbYKFvYN0qCS6hi/DfKuX/dOxYrf97fy29Dl4LsB25Y5PM4Tr/DX9tfoLtqEVQB156nX47Rev/aZufoNcnOcXtr631u6fc/ro6XPChtACLiruSSY8p8UziQ8ifQVEESwB4nGNgZGBgAGLP9y+PxPPbfGXgZr0DFGF4pjV3MYL+f4qDkW0VkMvBwAQSBQB3lAyfAAAAeJxjYGRgYL3DAAQcjFASTCMBAQAdSAEGeJxjYGBg4GAkHwMAEREAiAAAAAAAJgA8AKQAwAECAWgBaAGiAhgCcgKgAtoDGgOAA/QAAHicY2BkYGAQYAhhYGMAASYg5gJCBob/YD4DABK4AYEAeJx1j81Kw0AUhU/6J7YgouBOmJUI0qStuy5ctjsXXXSftjNpSpoJk2mh4FP4BD6Fj+DKp/ApXHoa7yJIncDw3e+eO5kBcIkPBDiuAL1qP64Gzlj9cpN0Jdwi3wq3yffCHfKjcBcPeBLu4RopTwha5zQ3eBFu4AKvwk36N+EW+V24Tf4U7pC/hLuY41u4h7vg2ZeJS1d9Y3M/08kui13N1HCuXZnaXA3DQc1Oda5d7PVKLQ6q3Ccj740yzm7VhF2dZVYVzm700odr74txFBnx4dJu4VEigeMrV+jDwCKnm0HT7pAhZu905rSdc9Kxk1a1whAhBv9kp8zmVT5mpdlTWODAvcSe+VH1F8PaMGOxJU1kVvNuGVmhqHobmiV9iHU1VWCMiJ/5kw+Z4kk/pntoVnicbcdRDoIwEEXRPmgLigosxEXVMgqxdJpOSWT3avz1/NxcVamfXv03oEINDQOLBi0OOKLDCWdc0GPAqOobv4yfyT+t58BZmk+2NYrxmUX0lDkZWlPZO9rp+t1EWS/xziY5KWQTRb8EncImNlNgN1khl/3cCpWyxIco9QamJyTZ") format("woff");
+  src: url("data:application/x-font-woff;charset=utf-8;base64,d09GRgABAAAAAApYAAsAAAAAD0wAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAABHU1VCAAABCAAAADsAAABUIIslek9TLzIAAAFEAAAAQQAAAFZdKW6ZY21hcAAAAYgAAACiAAACNBnCLmJnbHlmAAACLAAABd8AAAfo+edccWhlYWQAAAgMAAAAMAAAADYzdb5naGhlYQAACDwAAAAYAAAAJA3eCBJobXR4AAAIVAAAABAAAABAeA8AAGxvY2EAAAhkAAAAIgAAACIO+gzSbWF4cAAACIgAAAAfAAAAIAEgAGBuYW1lAAAIqAAAATAAAAI6ubjYZ3Bvc3QAAAnYAAAAgAAAAKn1lm/4eJxjYGRgYOBiMGCwY2BycfMJYeDLSSzJY5BiYGGAAJA8MpsxJzM9kYEDxgPKsYBpDiBmg4gCACY7BUgAeJxjYGRvZJzAwMrAwCrCIsXAwHAJQjNdYPBkbAbSDKzMDFhBQJprCoMDgyODP+sdILedbRWDGZBmBMkBAGnVCIcAAAB4nL3R1w3DMAwE0JMlF1kui2SGAE7v3iNfGTJ7OUfhNkgQAo+AqAKBBFAC8LSiALgXHCyerLpc92hzPWCdz4Rcn5eFecrZ2U3mgmcDX6xQo0HkvYQOPQaM3K7wfbjCh7Kqm9imrh/GH7z43+hyfmtl/5/EerqRgrZis9mJdXkvNreDWGePUtNJGjpLpItwnrhKopvY7+7S00MGmmX8AHS1EV0AAHichVRrbBRVFL5nZmfWCtl2ujuzu2x3tjPbbm27bGd39tHN0pZiQSulkJSWNfJMWgokRIK0Bk1ogkbCw/CwGBuKGKsJaFApjRpbjMYfxUeEEH/wwwLRKAbjI8T46O5cPDO7gK/Eydx7vzmve893zxzCEHz4z7gdpIy4CIFQUFF5UXBJuhJLJoQ4qwgKP3ZfOrcrvWJF2rY7vWJLrsX2Idde15XJTWdWrszY0pncZtujGAbMWPYu7mHCEVLC2EuAH81fMH47y0yx33HZ/Itw8w1jsS1gmnGWbZBrJyXESfxkPkmau/OlwEvuEnDaHeAGZ00EuGSoAeV2FqprcEF1AKRkCpIhcEAEmkEG+GJem7hZ5OcxT9OPzx2VPQ54RLjf0cLMhwZ1TI2CE3rg2GG5tcz4tVSUEZQy95aJxuWyhQvEAA72Jjrv8rZJxg3mdRhscyyUDZ758bmAJ4DeLDQo+UnmWPdDpS45z6P3UozC/iG35iXZ8g8sJKzF47NcByI7mYO56ELwzhi8epXxXbvGVFy9ynXMfsQ1FcZtzvgt3AMkiB+SC0mTXEiCWoPsqZh5PFWCUwskY0gLTnxWEGgGzpaXdwlaOc3SLC5dggDjtFMQuso1AU7CeyizfVWO+tW0T4iiuBxGaL/pExVgBF4uyOhKOCMIhbvgf+JmimcPkgV4FkVU3ObQxSDyXBOqxCux82VuGdxSZaoZUskyUGtMTdz6ilkal2XFPMZW5q/tZxzGzcM//MBWpy/sOUAvHthzIZ3JmBi0A89cTGeM8qEd205r0ah2etsOeheyJ/evHepbyxy94/B35/xv//QoQEyjUM+/cl8TH6nELCKAJVVjdwPvjoouKQOxFLhTNXjiEAQT4Obfrdqwvio/Pj1qdJSzPtfPUikzMTo9nq/yenPxE8xbJ7hXERYthHk3XL7bBhvWz868xLx5gtgIufWJXeXnklLiJTGyFPeNJ3EryQ8uvh7UUAKUBNZBQhF0Vv03jxaLbIHMMktUaanLLFP2eDgQC4StCcJ0W28vhHvPjx09eGVBS8uCKwePwpLhQwV8aHjs6Z0DE1Fdj04M7IR77mKbVowQDhhrzAB0m62juQm96XvDh2aaWlqaZg4NwxKM2tQ82/Mvf/q7hc1ckd9h/jXiJlWYa6NZKfEIqA4Q/945QtUxGVwOUCMQbwbA1MWCrgn0Eki5kfs+mo2t2rgqRrPOigqn7TzOxl5v2OsN6/Vebz2zPPf8VIWLOeLynTO20ks9l2G4h5tJrU3hK4uzF0VZFjlNlDdWRBobfL6GxkjF7BbbJyOSLEsjucvw5Jp34Kk1xZp4hTuMp3fieVNQAyxy7UxBENhqSICdzZ5ilncb45cCyxbtPgWzBuUNtgNmKd/PLO5mOruNMzS8aFkANvWbwvyEgQvlThb/3xFugIQwssvO2/mgIhRvXVDUUBOWgq4IhXoQBQUn/gWen+tRaaOm9gQ1mlY1TYVpLdijanBe1Zj3nU5xjoc2WvLzmroK5dNBTQvStKbe6bN2bohU44dq7mkPloCChdMMMZlxOZigGPtLadkGXz6475E10k1ohwfpT44H0+1Tn5870tl55Fz/M08MvB3T9djbA09wu5a2D+0+TvfC48v2NbabatPqACoHd8LcnYNoSAr/2K0c/wv3JaklzYRU409mT6aSibi1WaG+XVYB67FUMoUNHZt0MxPCdhEyu0XSbBaS2Svw5PwH9Liv0duqVoXrR/s2fbO5d7Q+jLB38/b+dauXgscDkXlti3WHlN/Ul+2OxuPR7uynCLAuu7PXIOLxMB2r1/Vv39RXcMQYFqxSW72NPjpaITn0xW2wVS/63Q1gXV2x9w1hPfuITlJkOelCVhPxEF4h7zfbYKFvYN0qCS6hi/DfKuX/dOxYrf97fy29Dl4LsB25Y5PM4Tr/DX9tfoLtqEVQB156nX47Rev/aZufoNcnOcXtr631u6fc/ro6XPChtACLiruSSY8p8UziQ8ifQVEESwB4nGNgZGBgAGLP92Uy8fw2Xxm4We8ARRieae3qRdD/T3Ewsq0CcjkYmECiAEkUC5J4nGNgZGBgvcMABByMUBJMIwEBAB1IAQZ4nGNgYGDgYCQfAwAREQCIAAAAAAAmADwApADAAQIBaAFoAaICGAJyAqAC2gMaA4AD9AAAeJxjYGRgYBBgCGFgYwABJiDmAkIGhv9gPgMAErgBgQB4nHWPzUrDQBSFT/ontiCi4E6YlQjSpK27Lly2OxdddJ+2M2lKmgmTaaHgU/gEPoWP4Mqn8ClcehrvIkidwPDd7547mQFwiQ8EOK4AvWo/rgbOWP1yk3Ql3CLfCrfJ98Id8qNwFw94Eu7hGilPCFrnNDd4EW7gAq/CTfo34Rb5XbhN/hTukL+Eu5jjW7iHu+DZl4lLV31jcz/TyS6LXc3UcK5dmdpcDcNBzU51rl3s9UotDqrcJyPvjTLObtWEXZ1lVhXObvTSh2vvi3EUGfHh0m7hUSKB4ytX6MPAIqebQdPukCFm73TmtJ1z0rGTVrXCECEG/2SnzOZVPmal2VNY4MC9xJ75UfUXw9owY7ElTWRW824ZWaGoehuaJX2IdTVVYIyIn/mTD5niST+me2hWeJxtx1EOgjAQRdE+aAuKCizERdUyCrF0mk5JZPdq/PX83FxVqZ9e/TegQg0NA4sGLQ44osMJZ1zQY8Co6hu/jJ/JP63nwFmaT7Y1ivGZRfSUORlaU9k72un63URZL/HOJjkpZBNFvwSdwiY2U2A3WSGX/dwKlbLEhyj1BqYnJNk=") 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
@@ -147,132 +296,81 @@ 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).
- */
-/** 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)
+ * 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.
  *
- * Contains: TsCloneOptions, clone, extend,
- *           naturalCompare, normMenu, getNested, encodeParams,
- *           prepareParams, parseRoute, debounce, wait
+ * Exports (Phase 2):
+ *   normButtons — standalone pure helper; no DOM, no timers
  *
- * Rules:
- *  - No default export
- *  - No import from tsbase.ts (INV-4)
- *  - No this.-dispatch inside function bodies (INV-8)
- *  - 4-space indent
+ * 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)
  */
-/** 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 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;
 }
-/** Options for TsUtils.normMenu() */
-interface TsNormMenuOptions {
-    itemMap?: {
-        id: string;
-        text: string;
+/** 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;
 }
 
@@ -310,7 +408,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;
@@ -370,59 +467,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>;
@@ -468,6 +512,25 @@ declare class Utils {
     transition(div_old: HTMLElement, div_new: HTMLElement, type: string, callBack?: () => void): Promise<void>;
     lock(box: unknown, options?: TsLockOptions | string, ...rest: unknown[]): void;
     unlock(box: unknown, speed?: number): void;
+    /**
+     * Constructs the MessageDeps object for the _message() delegator.
+     * Called once per message() invocation — captures `this` at call time.
+     * Per design §C.5 / §C.2.
+     */
+    private _msgDeps;
+    /**
+     * Constructs the ConfirmDeps object for the _confirm() delegator.
+     * Per design §C.3.
+     * normButtons closure: uses inline lambda that binds this.lang and this.settings
+     * at call time — preserving the call-time timing semantics (design §C.3 caveat).
+     */
+    private _confirmDeps;
+    /**
+     * Constructs the PromptDeps object for the _prompt() delegator.
+     * Per design §C.3.
+     * lang is bound at call time so deps.lang('Ok') uses current locale.
+     */
+    private _promptDeps;
     /**
      * Opens a context message, similar in parameters as TsPopup.open()
      *
@@ -587,6 +650,7 @@ declare class Utils {
     setCursorPosition(input: HTMLElement | null, pos: number, posEnd?: number): void;
     parseColor(str: string | null | undefined): TsColorRgb | null;
     colorContrast(color1: string, color2: string): string;
+    colorContrastValue(color1: string, color2: string): number;
     hsv2rgb(h: any, s?: any, v?: any, a?: any): {
         r: number;
         g: number;