@tuidom/terminal-backend 0.16.1 → 0.17.1

package/dist/nodeTerminalBackend.d.ts

@@ -1,4 +1,4 @@
-import type { HostTerminalColors, ITerminalBackend } from "@tuidom/core/backend/iTerminalBackend";
+import type { HostColorScheme, HostTerminalColors, ITerminalBackend } from "@tuidom/core/backend/iTerminalBackend";
 import { Point, Size } from "@tuidom/core/common/geometryPromitives";
 import type { KeyPressEvent } from "@tuidom/core/input/keyEvent";
 import type { MouseToken } from "@tuidom/core/input/rawTerminalToken";
@@ -18,6 +18,9 @@ export declare class NodeTerminalBackend implements ITerminalBackend {
     private resizeCallbacks;
     private oscResponseCallbacks;
     private deviceReportCallbacks;
+    private colorSchemeCallbacks;
+    /** Mode 2031 is on — teardown owes the terminal its reset. */
+    private colorSchemeReportsOn;
     /** DA1-запросов отправлено / ответов получено — чтобы проба ждала именно свой DA1. */
     private da1Sent;
     private da1Received;
@@ -84,6 +87,8 @@ export declare class NodeTerminalBackend implements ITerminalBackend {
     onPaste(callback: (text: string) => void): void;
     onResize(callback: (size: Size) => void): void;
     onOscResponse(callback: (code: number, data: string) => void): void;
+    onColorSchemeChange(callback: (scheme: HostColorScheme) => void): void;
+    private enableColorSchemeReports;
     probeKeyboardProtocol(onResult: (supported: boolean) => void): void;
     probeTerminalVersion(onResult: (nameAndVersion: string | undefined) => void): void;
     probeHostColors(onResult: (colors: HostTerminalColors) => void): void;

package/dist/nodeTerminalBackend.js

@@ -46,6 +46,23 @@ const BRACKETED_PASTE_DISABLE = "\x1b[?2004l";
  */
 const TITLE_PUSH = "\x1b[22;0t";
 const TITLE_POP = "\x1b[23;0t";
+/**
+ * Color-scheme reports (DEC private mode 2031, the Contour protocol): with the mode on the
+ * terminal sends `CSI ? 997 ; 1|2 n` whenever its scheme flips; `CSI ? 996 n` asks for the
+ * current one right away. Direct, per-pane: tmux ≥ 3.6 tracks the mode itself and reports
+ * the outer terminal's scheme to the panes that asked.
+ */
+const COLOR_SCHEME_REPORTS_ENABLE = "\x1b[?2031h";
+const COLOR_SCHEME_REPORTS_DISABLE = "\x1b[?2031l";
+const COLOR_SCHEME_QUERY = "\x1b[?996n";
+/** `?997;1` → dark, `?997;2` → light; any other value isn't a scheme we know. */
+function parseColorSchemeReport(params) {
+    if (params === "?997;1")
+        return "dark";
+    if (params === "?997;2")
+        return "light";
+    return undefined;
+}
 /** OSC 0 — icon name and window title at once; BEL is the terminator everyone understands. */
 export function windowTitleSequence(title) {
     // A control character inside the title would cut the sequence short.
@@ -138,6 +155,9 @@ export class NodeTerminalBackend {
     resizeCallbacks = [];
     oscResponseCallbacks = [];
     deviceReportCallbacks = [];
+    colorSchemeCallbacks = [];
+    /** Mode 2031 is on — teardown owes the terminal its reset. */
+    colorSchemeReportsOn = false;
     /** DA1-запросов отправлено / ответов получено — чтобы проба ждала именно свой DA1. */
     da1Sent = 0;
     da1Received = 0;
@@ -231,6 +251,18 @@ export class NodeTerminalBackend {
     onOscResponse(callback) {
         this.oscResponseCallbacks.push(callback);
     }
+    onColorSchemeChange(callback) {
+        this.colorSchemeCallbacks.push(callback);
+        // Before setup the tty is still in cooked mode with ECHO: the reply would land on the screen.
+        if (this.onDataHandler !== null)
+            this.enableColorSchemeReports();
+    }
+    enableColorSchemeReports() {
+        if (this.colorSchemeReportsOn)
+            return;
+        this.colorSchemeReportsOn = true;
+        this.writeDirect(COLOR_SCHEME_REPORTS_ENABLE + COLOR_SCHEME_QUERY);
+    }
     probeKeyboardProtocol(onResult) {
         let supported = false;
         // Direct (not passthrough): the reply must reflect tmux's own Kitty support, per-pane.
@@ -342,6 +374,12 @@ export class NodeTerminalBackend {
         for (const report of result.deviceReports) {
             if (report.report === "da1")
                 this.da1Received++;
+            if (report.report === "color-scheme") {
+                const scheme = parseColorSchemeReport(report.params);
+                if (scheme !== undefined)
+                    for (const cb of this.colorSchemeCallbacks)
+                        cb(scheme);
+            }
             for (const cb of this.deviceReportCallbacks)
                 cb(report.report, report.params);
         }
@@ -442,6 +480,9 @@ export class NodeTerminalBackend {
             this.schedulePartialInputFlush();
         };
         this.stdin.on("data", this.onDataHandler);
+        // A subscriber from before setup gets its reports now that the tty is raw.
+        if (this.colorSchemeCallbacks.length > 0)
+            this.enableColorSchemeReports();
         // Listen for terminal resize (throttled + deduplicated)
         this.onResizeHandler = () => {
             if (this.resizeThrottleTimer !== null) {
@@ -485,6 +526,10 @@ export class NodeTerminalBackend {
         this.writeDirect(MOUSE_TRACKING_DISABLE);
         // Disable bracketed paste — direct (matches the per-pane enable in setup)
         this.writeDirect(BRACKETED_PASTE_DISABLE);
+        if (this.colorSchemeReportsOn) {
+            this.writeDirect(COLOR_SCHEME_REPORTS_DISABLE);
+            this.colorSchemeReportsOn = false;
+        }
         // Restore cursor
         this.stdout.write("\x1b[?25h");
         // Restore normal screen buffer

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tuidom/terminal-backend",
-    "version": "0.16.1",
+    "version": "0.17.1",
     "type": "module",
     "description": "Experimental terminal UI DOM — real terminal backend for Node (tty, ANSI diffing, Kitty protocol). API is unstable.",
     "license": "MIT",
@@ -28,6 +28,6 @@
         "./*": "./dist/*.js"
     },
     "dependencies": {
-        "@tuidom/core": "0.16.1"
+        "@tuidom/core": "0.17.1"
     }
 }