@tuidom/core 0.2.0 → 0.2.3

package/dist/dom/styles/styleTokens.d.ts

@@ -8,7 +8,7 @@ import type { StyleVarScope } from "./tuiStyle.js";
  * Имена — в конвенции color id VS Code ("list.activeSelectionBackground"),
  * чтобы хост перекрывал дефолты ключами своей темы без функций-мостов;
  * tuidom-специфика без темного эквивалента — под собственным именем
- * ("menu.shortcutForeground", "quickPick.*", "titledPanel.*", "menuBar.*").
+ * ("menu.shortcutForeground", "titledPanel.*", "menuBar.*").
  * Значения — только конкретные числа (packed RGB | DEFAULT_COLOR); сентинелы
  * INHERITED_* в таблицах запрещены (проверяется в setStyleVars).
  *
@@ -64,14 +64,6 @@ export declare const STYLE_TOKEN_DEFAULTS: {
     "input.selectionBackground": number;
     focusBorder: number;
     "sash.hoverBorder": number;
-    "quickInput.foreground": number;
-    "quickInput.background": number;
-    "quickPick.border": number;
-    "quickPick.badgeForeground": number;
-    "quickPick.shortcutForeground": number;
-    "quickPick.hintForeground": number;
-    "quickPick.titleForeground": number;
-    "quickPick.promptForeground": number;
     descriptionForeground: number;
     "editorSuggestWidget.border": number;
     "editorSuggestWidget.background": number;

package/dist/dom/styles/styleTokens.js

@@ -8,7 +8,7 @@ import { DEFAULT_COLOR, packRgb } from "../../common/colorUtils.js";
  * Имена — в конвенции color id VS Code ("list.activeSelectionBackground"),
  * чтобы хост перекрывал дефолты ключами своей темы без функций-мостов;
  * tuidom-специфика без темного эквивалента — под собственным именем
- * ("menu.shortcutForeground", "quickPick.*", "titledPanel.*", "menuBar.*").
+ * ("menu.shortcutForeground", "titledPanel.*", "menuBar.*").
  * Значения — только конкретные числа (packed RGB | DEFAULT_COLOR); сентинелы
  * INHERITED_* в таблицах запрещены (проверяется в setStyleVars).
  *
@@ -76,14 +76,6 @@ export const STYLE_TOKEN_DEFAULTS = {
     // ── Sash ──
     "sash.hoverBorder": packRgb(0, 120, 215),
     // ── Квик-пик ──
-    "quickInput.foreground": packRgb(204, 204, 204),
-    "quickInput.background": packRgb(37, 37, 38),
-    "quickPick.border": packRgb(83, 83, 83),
-    "quickPick.badgeForeground": packRgb(150, 190, 100),
-    "quickPick.shortcutForeground": packRgb(128, 128, 128),
-    "quickPick.hintForeground": packRgb(100, 150, 200),
-    "quickPick.titleForeground": packRgb(230, 230, 230),
-    "quickPick.promptForeground": packRgb(140, 140, 140),
     descriptionForeground: packRgb(125, 125, 125),
     // ── Автодополнение ──
     "editorSuggestWidget.border": packRgb(83, 83, 83),

package/dist/dom/tuiApplication.js

@@ -158,8 +158,14 @@ export class TuiApplication {
                     target.dispatchEvent(contextMenuEvent);
                 }
             }
-            // Tab focus cycling (default behavior if not prevented, only on keydown)
-            if (notPrevented && event.key === "Tab" && event.type === "keydown" && this.focusManager) {
+            // Tab focus cycling (default behavior if not prevented, only on keydown).
+            // Обход фокуса — только у голого Tab и Shift+Tab: Ctrl+Tab, Alt+Tab и Meta+Tab
+            // это отдельные аккорды, и приложение вправе повесить на них своё. Если бы
+            // мы крутили кольцо и на них, то нерезолвнувшийся аккорд приложения (его
+            // `when` не прошёл — значит preventDefault никто не позвал) уводил бы фокус
+            // на случайный элемент. Shift здесь не модификатор аккорда, а направление.
+            const plainTab = !event.ctrlKey && !event.altKey && !event.metaKey;
+            if (notPrevented && event.key === "Tab" && event.type === "keydown" && plainTab && this.focusManager) {
                 const direction = event.shiftKey ? "backward" : "forward";
                 this.focusManager.cycleFocus(direction);
             }

package/dist/dom/tuiElement.d.ts

@@ -20,6 +20,16 @@ export declare class RenderContext {
     constructor(canvas: TerminalScreen, offset?: Offset, clipRect?: Rect);
     withOffset(extra: Offset): RenderContext;
     withClip(rect: Rect): RenderContext;
+    /**
+     * Патчит ячейку: заданные поля перезаписываются, опущенные остаются
+     * прежними (так проходы-подсветки кладут один `bg`, не трогая глиф).
+     *
+     * Непрозрачная запись ячейки — та, что кладёт свой `char`, — обязана
+     * задавать и `style`: иначе ячейка донашивает атрибуты того, кто рисовал
+     * здесь раньше в этом же кадре, и оверлей поверх подчёркнутого текста
+     * получает чужую волну (`drawText`/`drawBox`/{@link TUIElement.paintOwnBackground}
+     * так и делают).
+     */
     setCell(x: number, y: number, cell: CellPatch): void;
     /**
      * Читает уже отрисованную ячейку в локальных координатах (тот же оффсет и
@@ -33,6 +43,9 @@ export declare class RenderContext {
      * Render a text string at (x, y), handling wide chars, tabs, combining marks and emoji.
      * Each column within [startCol, startCol + maxWidth) is rendered.
      *
+     * Каждая записанная ячейка получает ПОЛНЫЙ стиль: не переданные флаги —
+     * {@link StyleFlags.None}, а не то, что лежало в ячейке до текста.
+     *
      * @param x       Left screen column (local coordinates)
      * @param y       Screen row (local coordinates)
      * @param text    Raw text to render
@@ -73,6 +86,10 @@ export declare class RenderContext {
      * @param options fg/bg, пресет `style` (по умолчанию {@link BORDER_ROUNDED} —
      *                канонический стиль оверлеев Vexx), `fill` (залить фон внутри
      *                рамки), `separators` (ряды-разделители)
+     *
+     * Как и {@link drawText}, кладёт ячейки целиком: флаги стиля сбрасываются в
+     * {@link StyleFlags.None}. Рамка — непрозрачная поверхность (обычно оверлей),
+     * и подчёркивание текста под ней сквозь неё проступать не должно.
      */
     drawBox(x: number, y: number, width: number, height: number, options?: {
         fg?: number;
@@ -481,6 +498,11 @@ export declare class TUIElement {
      * считаются «задан»: это намеренная перезаливка цветом родителя (INHERITED_BG)
      * или инверсия (INHERITED_FG). Выход за границы невозможен — контекст
      * элемента уже клипован родителем.
+     *
+     * Заливка непрозрачна, поэтому кладёт ячейку целиком, вместе со сбросом
+     * флагов стиля: собственный фон — это новая поверхность, и атрибуты того,
+     * что нарисовано под ней раньше в этом кадре (подчёркивание диагностики под
+     * попапом, жирный токен под диалогом), на ней проступать не должны.
      */
     protected paintOwnBackground(context: RenderContext): void;
     /** true, если фон задан собственным стилем (см. {@link paintOwnBackground}). */

package/dist/dom/tuiElement.js

@@ -1,6 +1,7 @@
 import { DEFAULT_COLOR } from "../common/colorUtils.js";
 import { DisplayLine } from "../common/displayLine.js";
 import { BoxConstraints, Offset, Point, Rect, Size } from "../common/geometryPromitives.js";
+import { StyleFlags } from "../common/styleFlags.js";
 import { TerminalScreen } from "../rendering/terminalScreen.js";
 import { BORDER_ROUNDED } from "./borderStyle.js";
 import { EventPhase, TUIEventBase } from "./events/tuiEventBase.js";
@@ -25,6 +26,16 @@ export class RenderContext {
     withClip(rect) {
         return new RenderContext(this.canvas, this.offset, this.clipRect.intersect(rect));
     }
+    /**
+     * Патчит ячейку: заданные поля перезаписываются, опущенные остаются
+     * прежними (так проходы-подсветки кладут один `bg`, не трогая глиф).
+     *
+     * Непрозрачная запись ячейки — та, что кладёт свой `char`, — обязана
+     * задавать и `style`: иначе ячейка донашивает атрибуты того, кто рисовал
+     * здесь раньше в этом же кадре, и оверлей поверх подчёркнутого текста
+     * получает чужую волну (`drawText`/`drawBox`/{@link TUIElement.paintOwnBackground}
+     * так и делают).
+     */
     setCell(x, y, cell) {
         const screenX = x + this.offset.dx;
         const screenY = y + this.offset.dy;
@@ -58,6 +69,9 @@ export class RenderContext {
      * Render a text string at (x, y), handling wide chars, tabs, combining marks and emoji.
      * Each column within [startCol, startCol + maxWidth) is rendered.
      *
+     * Каждая записанная ячейка получает ПОЛНЫЙ стиль: не переданные флаги —
+     * {@link StyleFlags.None}, а не то, что лежало в ячейке до текста.
+     *
      * @param x       Left screen column (local coordinates)
      * @param y       Screen row (local coordinates)
      * @param text    Raw text to render
@@ -84,12 +98,13 @@ export class RenderContext {
             const w = slot ? slot.displayWidth : 1;
             const slotStyle = slot && options?.getStyle ? options.getStyle(slot.offset) : undefined;
             const resolvedStyle = slotStyle !== undefined ? { ...style, ...slotStyle } : style;
+            const cellStyle = resolvedStyle?.style ?? StyleFlags.None;
             if (w === 2 && col + 1 >= maxWidth) {
-                this.setCell(x + col, y, { char: " ", width: 1, ...resolvedStyle });
+                this.setCell(x + col, y, { char: " ", width: 1, ...resolvedStyle, style: cellStyle });
                 col++;
             }
             else {
-                this.setCell(x + col, y, { char, width: w, ...resolvedStyle });
+                this.setCell(x + col, y, { char, width: w, ...resolvedStyle, style: cellStyle });
                 col += w;
             }
         }
@@ -111,44 +126,49 @@ export class RenderContext {
      * @param options fg/bg, пресет `style` (по умолчанию {@link BORDER_ROUNDED} —
      *                канонический стиль оверлеев Vexx), `fill` (залить фон внутри
      *                рамки), `separators` (ряды-разделители)
+     *
+     * Как и {@link drawText}, кладёт ячейки целиком: флаги стиля сбрасываются в
+     * {@link StyleFlags.None}. Рамка — непрозрачная поверхность (обычно оверлей),
+     * и подчёркивание текста под ней сквозь неё проступать не должно.
      */
     drawBox(x, y, width, height, options = {}) {
-        const style = options.style ?? BORDER_ROUNDED;
+        const border = options.style ?? BORDER_ROUNDED;
         const fg = options.fg;
         const bg = options.bg;
+        const style = StyleFlags.None;
         const right = x + width - 1;
         const bottom = y + height - 1;
         if (options.fill === true) {
             for (let yy = y; yy <= bottom; yy++) {
                 for (let xx = x; xx <= right; xx++) {
-                    this.setCell(xx, yy, { char: " ", fg, bg });
+                    this.setCell(xx, yy, { char: " ", fg, bg, style });
                 }
             }
         }
         const separators = new Set(options.separators);
         // Top border.
-        this.setCell(x, y, { char: style.topLeft, fg, bg });
-        this.setCell(right, y, { char: style.topRight, fg, bg });
+        this.setCell(x, y, { char: border.topLeft, fg, bg, style });
+        this.setCell(right, y, { char: border.topRight, fg, bg, style });
         for (let xx = x + 1; xx < right; xx++)
-            this.setCell(xx, y, { char: style.horizontal, fg, bg });
+            this.setCell(xx, y, { char: border.horizontal, fg, bg, style });
         // Side borders (+ separator T-connectors).
         for (let yy = y + 1; yy < bottom; yy++) {
             if (separators.has(yy - y)) {
-                this.setCell(x, yy, { char: style.leftJoint, fg, bg });
-                this.setCell(right, yy, { char: style.rightJoint, fg, bg });
+                this.setCell(x, yy, { char: border.leftJoint, fg, bg, style });
+                this.setCell(right, yy, { char: border.rightJoint, fg, bg, style });
                 for (let xx = x + 1; xx < right; xx++)
-                    this.setCell(xx, yy, { char: style.horizontal, fg, bg });
+                    this.setCell(xx, yy, { char: border.horizontal, fg, bg, style });
             }
             else {
-                this.setCell(x, yy, { char: style.vertical, fg, bg });
-                this.setCell(right, yy, { char: style.vertical, fg, bg });
+                this.setCell(x, yy, { char: border.vertical, fg, bg, style });
+                this.setCell(right, yy, { char: border.vertical, fg, bg, style });
             }
         }
         // Bottom border.
-        this.setCell(x, bottom, { char: style.bottomLeft, fg, bg });
-        this.setCell(right, bottom, { char: style.bottomRight, fg, bg });
+        this.setCell(x, bottom, { char: border.bottomLeft, fg, bg, style });
+        this.setCell(right, bottom, { char: border.bottomRight, fg, bg, style });
         for (let xx = x + 1; xx < right; xx++)
-            this.setCell(xx, bottom, { char: style.horizontal, fg, bg });
+            this.setCell(xx, bottom, { char: border.horizontal, fg, bg, style });
     }
 }
 export class TUIElement {
@@ -1065,6 +1085,11 @@ export class TUIElement {
      * считаются «задан»: это намеренная перезаливка цветом родителя (INHERITED_BG)
      * или инверсия (INHERITED_FG). Выход за границы невозможен — контекст
      * элемента уже клипован родителем.
+     *
+     * Заливка непрозрачна, поэтому кладёт ячейку целиком, вместе со сбросом
+     * флагов стиля: собственный фон — это новая поверхность, и атрибуты того,
+     * что нарисовано под ней раньше в этом кадре (подчёркивание диагностики под
+     * попапом, жирный токен под диалогом), на ней проступать не должны.
      */
     paintOwnBackground(context) {
         if (this.appliedBgValue === undefined)
@@ -1073,7 +1098,7 @@ export class TUIElement {
         const { width, height } = this.layoutSize;
         for (let y = 0; y < height; y++) {
             for (let x = 0; x < width; x++) {
-                context.setCell(x, y, { char: " ", fg, bg });
+                context.setCell(x, y, { char: " ", fg, bg, style: StyleFlags.None });
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tuidom/core",
-    "version": "0.2.0",
+    "version": "0.2.3",
     "type": "module",
     "description": "Experimental terminal UI DOM — core: element tree, flex layout, grid rendering, input parsing. API is unstable.",
     "license": "MIT",