@tuidom/headless-backend 0.16.1 → 0.17.0

package/dist/headlessCaptureBackend.d.ts

@@ -1,4 +1,4 @@
-import { type HostTerminalColors, type ITerminalBackend } from "@tuidom/core/backend/iTerminalBackend";
+import { type HostColorScheme, type HostTerminalColors, type 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";
@@ -54,6 +54,17 @@ export declare class HeadlessCaptureBackend implements ITerminalBackend {
     hostColors: HostTerminalColors;
     /** Answers right away with {@link hostColors} — there is no terminal round-trip. */
     probeHostColors(onResult: (colors: HostTerminalColors) => void): void;
+    private readonly colorSchemeCallbacks;
+    /**
+     * The scheme {@link onColorSchemeChange} reports on subscription, as a terminal answers
+     * `CSI ? 996 n`. `undefined` (default) = a terminal without the protocol, nothing fires.
+     * Set it before the app subscribes; a later flip goes through {@link sendColorScheme}.
+     */
+    colorScheme: HostColorScheme | undefined;
+    /** Answers synchronously with {@link colorScheme}, if set — no terminal round-trip to wait for. */
+    onColorSchemeChange(callback: (scheme: HostColorScheme) => void): void;
+    /** Simulate the terminal's unasked report that its scheme flipped (the OS switched appearance). */
+    sendColorScheme(scheme: HostColorScheme): void;
     renderFrame(grid: Grid, cursorPosition: Point | null): void;
     getSize(): Size;
     setup(): void;

package/dist/headlessCaptureBackend.js

@@ -1,4 +1,4 @@
-import { NO_HOST_COLORS } from "@tuidom/core/backend/iTerminalBackend";
+import { NO_HOST_COLORS, } from "@tuidom/core/backend/iTerminalBackend";
 import { Point, Size } from "@tuidom/core/common/geometryPromitives";
 import { KeyInputParser } from "@tuidom/core/input/keyInputParser";
 import { serializeKey } from "@tuidom/core/input/serializeKey";
@@ -73,6 +73,25 @@ export class HeadlessCaptureBackend {
     probeHostColors(onResult) {
         onResult(this.hostColors);
     }
+    colorSchemeCallbacks = [];
+    /**
+     * The scheme {@link onColorSchemeChange} reports on subscription, as a terminal answers
+     * `CSI ? 996 n`. `undefined` (default) = a terminal without the protocol, nothing fires.
+     * Set it before the app subscribes; a later flip goes through {@link sendColorScheme}.
+     */
+    colorScheme = undefined;
+    /** Answers synchronously with {@link colorScheme}, if set — no terminal round-trip to wait for. */
+    onColorSchemeChange(callback) {
+        this.colorSchemeCallbacks.push(callback);
+        if (this.colorScheme !== undefined)
+            callback(this.colorScheme);
+    }
+    /** Simulate the terminal's unasked report that its scheme flipped (the OS switched appearance). */
+    sendColorScheme(scheme) {
+        this.colorScheme = scheme;
+        for (const cb of this.colorSchemeCallbacks)
+            cb(scheme);
+    }
     renderFrame(grid, cursorPosition) {
         this.lastFrame = snapshotGrid(grid, cursorPosition);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tuidom/headless-backend",
-    "version": "0.16.1",
+    "version": "0.17.0",
     "type": "module",
     "description": "Experimental terminal UI DOM — headless capture backend (in-memory frames for screenshots/e2e). API is unstable.",
     "license": "MIT",
@@ -28,6 +28,6 @@
         "./*": "./dist/*.js"
     },
     "dependencies": {
-        "@tuidom/core": "0.16.1"
+        "@tuidom/core": "0.17.0"
     }
 }