@vincemakes/kiso-tui 0.22.0 → 0.23.0

package/dist/editor.d.ts

@@ -74,6 +74,7 @@ export declare class Editor {
      *  keeping it out of the draft; deciding what a report MEANS belongs to
      *  whoever asked the question.
      */
+    onColorScheme(cb: (scheme: "dark" | "light") => void): void;
     onOsc(cb: (body: string) => void): void;
     onLine(cb: (line: string) => void): void;
     onSigint(cb: () => void): void;

package/dist/editor.js

@@ -351,6 +351,11 @@ export class Editor {
     #pending = ""; // an incomplete ESC/CSI/OSC prefix across chunks
     /** DC-7: the terminal's own reports (OSC). Never a keystroke. */
     #oscCb = null;
+    /** The terminal's own account of its colour scheme (`CSI ? 997 ; 1|2 n`).
+     *  Its OWN channel, never `#oscCb`: OSC 11 reports a COLOUR that kiso
+     *  reads a ground out of, this reports the GROUND itself, and a
+     *  listener wanting one must not be handed the other. */
+    #colorSchemeCb = null;
     #decoder = new TextDecoder();
     #entered = false;
     #onData;
@@ -371,6 +376,9 @@ export class Editor {
      *  keeping it out of the draft; deciding what a report MEANS belongs to
      *  whoever asked the question.
      */
+    onColorScheme(cb) {
+        this.#colorSchemeCb = cb;
+    }
     onOsc(cb) {
         this.#oscCb = cb;
     }
@@ -1507,6 +1515,22 @@ export class Editor {
             this.#mouseEvent(params, final === "M");
             return;
         }
+        // The terminal's colour-scheme REPORT — `CSI ? 997 ; 1 n` (dark) or
+        // `; 2 n` (light), answering the `CSI ? 996 n` sent at startup.
+        //
+        // Routed high and narrow, for the mouse branch's reason: a report
+        // is never a key and must never fall through to one. It used to
+        // reach the END of this method instead, which dropped it in
+        // silence — the terminal answered and nothing could hear it. The
+        // pattern is exact (997 only, 1 or 2 only) because `n` is a final
+        // that device-status reports share.
+        if (final === "n") {
+            const scheme = /^\?997;([12])$/.exec(params);
+            if (scheme !== null) {
+                this.#colorSchemeCb?.(scheme[1] === "1" ? "dark" : "light");
+                return;
+            }
+        }
         // R3a — Shift+Tab (CSI Z, the universal back-tab encoding) cycles
         // the approval tier. Composer-idle ONLY: a panel, picker, menu,
         // history browse or question owns its keys first (the W21 gate),

package/dist/transcript.js

@@ -143,7 +143,7 @@ export function viewerRows(entries, state, W, rows) {
  * An open entry's rows take the VERBATIM SURFACE — `wash`, the same
  * background DC-3 gave the human's own words and inline code. It is
  * ground-resolved already, and with no ground it degrades to reverse
- * video, which is correct on any ground (ground.ts rung 4).
+ * video, which is correct on any ground (ground.ts's last rung).
  *
  * Padded to the full width so the block reads as ONE thing rather than
  * a ragged stack. Under NO_COLOR `wash` is empty and the row's bytes

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui",
-	"version": "0.22.0",
+	"version": "0.23.0",
 	"description": "kiso tui — the pure terminal layer (cell renderer, dock, raw editor, diff, palette). Zero runtime dependencies: input is data, output is bytes.",
 	"type": "module",
 	"license": "MIT",
@@ -35,6 +35,6 @@
 	},
 	"homepage": "https://github.com/vincemakes/kiso/tree/main/packages/tui#readme",
 	"dependencies": {
-		"@vincemakes/kiso-tui-cells": "0.22.0"
+		"@vincemakes/kiso-tui-cells": "0.23.0"
 	}
 }