@tuidom/core 0.6.0 → 0.7.0

package/dist/backend/iTerminalBackend.d.ts

@@ -2,6 +2,15 @@ import type { Point, Size } from "../common/geometryPromitives.js";
 import type { KeyPressEvent } from "../input/keyEvent.js";
 import type { MouseToken } from "../input/rawTerminalToken.js";
 import type { Grid } from "../rendering/grid.js";
+/** Colors the host terminal reported ({@link ITerminalBackend.probeHostColors}); packed RGB. */
+export interface HostTerminalColors {
+    readonly foreground: number | undefined;
+    readonly background: number | undefined;
+    /** ANSI palette 0..15 (always 16 entries); `undefined` — this entry wasn't reported. */
+    readonly ansi: readonly (number | undefined)[];
+}
+/** The terminal reported none of its colors — the answer of a backend without a terminal. */
+export declare const NO_HOST_COLORS: HostTerminalColors;
 /**
  * Unified abstraction over terminal I/O.
  *
@@ -37,6 +46,16 @@ export interface ITerminalBackend {
      * Fire-and-forget — callers must not block on it.
      */
     probeTerminalVersion(onResult: (nameAndVersion: string | undefined) => void): void;
+    /**
+     * Asynchronously ask the terminal for its own colors: the default foreground and
+     * background (OSC 10/11) and the 16 ANSI palette entries (OSC 4, indices 0..15).
+     * `onResult` fires exactly once; every color the terminal didn't report (no OSC
+     * support, GNU Screen, timeout) is `undefined`, so callers fall back per entry.
+     * Replies are consumed by the backend: they still reach `onOscResponse`, never
+     * `onInput`. Inside tmux the queries go to tmux itself, which answers from the
+     * outer terminal (tmux ≥ 3.4 for fg/bg, ≥ 3.6 for the palette). Fire-and-forget.
+     */
+    probeHostColors(onResult: (colors: HostTerminalColors) => void): void;
     /**
      * Render a frame: receive the current grid and cursor position.
      * The backend decides how to output it (ANSI diffing, simple copy, etc.).

package/dist/backend/iTerminalBackend.js

@@ -1 +1,6 @@
-export {};
+/** The terminal reported none of its colors — the answer of a backend without a terminal. */
+export const NO_HOST_COLORS = Object.freeze({
+    foreground: undefined,
+    background: undefined,
+    ansi: Object.freeze(new Array(16).fill(undefined)),
+});

package/dist/common/colorUtils.d.ts

@@ -60,6 +60,14 @@ export declare function compositeOver(color: number, under: number): number;
  * должен падать на разборе, а не красить в чёрный.
  */
 export declare function parseHexColor(hex: string): number;
+/**
+ * Разбирает цвет в формате X11, которым терминалы отвечают на OSC 4/10/11
+ * (`XParseColor`): `rgb:R/G/B` с 1–4 hex-цифрами на канал (обычно 4 —
+ * `rgb:ffff/8080/0000`) и устаревший `#RGB`/`#RRGGBB`/`#RRRGGGBBB`/`#RRRRGGGGBBBB`.
+ * Канал масштабируется к 8 битам по своей разрядности. Непонятная строка —
+ * `undefined`: ответ терминала — внешние данные, бросать на них нельзя.
+ */
+export declare function parseXColor(spec: string): number | undefined;
 /**
  * Обратное к {@link parseHexColor}: `#rrggbb` для непрозрачного, `#rrggbbaa`
  * с альфой, `#00000000` для {@link TRANSPARENT_COLOR}. `DEFAULT_COLOR` hex не

package/dist/common/colorUtils.js

@@ -115,6 +115,30 @@ export function parseHexColor(hex) {
     const hasAlpha = digits.length === 4 || digits.length === 8;
     return packRgba(channel(0), channel(1), channel(2), hasAlpha ? channel(3) : 0xff);
 }
+/**
+ * Разбирает цвет в формате X11, которым терминалы отвечают на OSC 4/10/11
+ * (`XParseColor`): `rgb:R/G/B` с 1–4 hex-цифрами на канал (обычно 4 —
+ * `rgb:ffff/8080/0000`) и устаревший `#RGB`/`#RRGGBB`/`#RRRGGGBBB`/`#RRRRGGGGBBBB`.
+ * Канал масштабируется к 8 битам по своей разрядности. Непонятная строка —
+ * `undefined`: ответ терминала — внешние данные, бросать на них нельзя.
+ */
+export function parseXColor(spec) {
+    const rgb = /^rgb:([0-9a-f]{1,4})\/([0-9a-f]{1,4})\/([0-9a-f]{1,4})$/i.exec(spec);
+    if (rgb !== null)
+        return packRgb(scaleXChannel(rgb[1]), scaleXChannel(rgb[2]), scaleXChannel(rgb[3]));
+    const hash = /^#((?:[0-9a-f]{3}){1,4})$/i.exec(spec);
+    if (hash === null)
+        return undefined;
+    const digits = hash[1];
+    const width = digits.length / 3;
+    const channel = (i) => scaleXChannel(digits.slice(i * width, (i + 1) * width));
+    return packRgb(channel(0), channel(1), channel(2));
+}
+/** Канал X11-цвета из `digits.length` hex-цифр → 0..255 (`f` → 255, `ffff` → 255, `8080` → 128). */
+function scaleXChannel(digits) {
+    const max = 16 ** digits.length - 1;
+    return Math.round((parseInt(digits, 16) * 255) / max);
+}
 /**
  * Обратное к {@link parseHexColor}: `#rrggbb` для непрозрачного, `#rrggbbaa`
  * с альфой, `#00000000` для {@link TRANSPARENT_COLOR}. `DEFAULT_COLOR` hex не

package/package.json

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