@tuidom/terminal-backend 0.20.0 → 0.22.0

package/dist/nodeTerminalBackend.d.ts

@@ -36,6 +36,8 @@ export declare class NodeTerminalBackend implements ITerminalBackend {
     private cleanupHandlers;
     /** The title stack got a push from {@link setWindowTitle}; teardown owes it a pop. */
     private titlePushed;
+    /** The pointer shape the terminal shows; teardown owes it a reset when not `"default"`. */
+    private pointerShape;
     private readonly isTmux;
     private readonly isGnuScreen;
     private readonly inputParser;
@@ -82,6 +84,12 @@ export declare class NodeTerminalBackend implements ITerminalBackend {
      * on the terminal's title stack; {@link teardown} restores it.
      */
     setWindowTitle(title: string): void;
+    /**
+     * Set the mouse pointer shape (OSC 22). Writes only when the shape changes, so a run
+     * that never leaves `"default"` writes nothing. Not under GNU Screen: it has no
+     * passthrough the way tmux does.
+     */
+    setPointerShape(shape: string): void;
     onInput(callback: (event: KeyPressEvent) => void): void;
     onMouse(callback: (event: MouseToken) => void): void;
     onPaste(callback: (text: string) => void): void;

package/dist/nodeTerminalBackend.js

@@ -46,6 +46,14 @@ const BRACKETED_PASTE_DISABLE = "\x1b[?2004l";
  */
 const TITLE_PUSH = "\x1b[22;0t";
 const TITLE_POP = "\x1b[23;0t";
+/**
+ * OSC 22 — set the mouse pointer shape to a CSS cursor name (kitty's pointer-shapes
+ * protocol: kitty, Ghostty, foot, iTerm2, xterm). Terminals without it drop the
+ * sequence. tmux doesn't know it, so it goes through passthrough.
+ */
+function pointerShapeSequence(shape) {
+    return `\x1b]22;${shape}\x1b\\`;
+}
 /**
  * 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
@@ -173,6 +181,8 @@ export class NodeTerminalBackend {
     cleanupHandlers = [];
     /** The title stack got a push from {@link setWindowTitle}; teardown owes it a pop. */
     titlePushed = false;
+    /** The pointer shape the terminal shows; teardown owes it a reset when not `"default"`. */
+    pointerShape = "default";
     isTmux;
     isGnuScreen;
     inputParser = new KeyInputParser();
@@ -236,6 +246,17 @@ export class NodeTerminalBackend {
         }
         this.writeDirect(windowTitleSequence(title));
     }
+    /**
+     * Set the mouse pointer shape (OSC 22). Writes only when the shape changes, so a run
+     * that never leaves `"default"` writes nothing. Not under GNU Screen: it has no
+     * passthrough the way tmux does.
+     */
+    setPointerShape(shape) {
+        if (shape === this.pointerShape || this.isGnuScreen)
+            return;
+        this.writePassthrough(pointerShapeSequence(shape));
+        this.pointerShape = shape;
+    }
     onInput(callback) {
         this.inputCallbacks.push(callback);
     }
@@ -530,6 +551,8 @@ export class NodeTerminalBackend {
             this.writeDirect(COLOR_SCHEME_REPORTS_DISABLE);
             this.colorSchemeReportsOn = false;
         }
+        // Bring back the default pointer, or the shell keeps the last one (a resize arrow).
+        this.setPointerShape("default");
         // Restore cursor
         this.stdout.write("\x1b[?25h");
         // Restore normal screen buffer

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tuidom/terminal-backend",
-    "version": "0.20.0",
+    "version": "0.22.0",
     "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.20.0"
+        "@tuidom/core": "0.22.0"
     }
 }