@rol1n/windows-wheel-fix 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,12 @@
-# Temporary Holding Version
+# windows-wheel-fix
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Restores mouse-wheel reporting for Pi under Windows ConPTY / Zellij ([earendil-works/pi#9656](https://github.com/earendil-works/pi/issues/9656)) by re-emitting mouse DECSET sequences once raw mode is active. No-op on non-Windows platforms.
+
+
+## Install
+
+```sh
+pi install npm:@rol1n/windows-wheel-fix
+```
+
+Also included in `@rol1n/pi-kit`.

package/index.ts

@@ -0,0 +1,44 @@
+/**
+ * windows-wheel-fix.ts — Fix mouse wheel alternateScroll in Zellij / Windows ConPTY
+ *
+ * Upstream issue: https://github.com/earendil-works/pi/issues/9656
+ *
+ * Root cause:
+ * TuiAltScreen writes the mouse tracking DECSET burst (?1000h ?1002h ?1004h ?1006h)
+ * during beforeTerminalStart() BEFORE stdin is switched to raw mode and ENABLE_VIRTUAL_TERMINAL_INPUT
+ * is applied. On Windows, ConPTY silently swallows these sequences while in cooked mode,
+ * so Zellij never detects that the inner pane requested mouse reporting.
+ * Zellij then falls back to xterm alternateScroll, translating mouse wheel ticks into
+ * Up/Down arrow keys (which cycles prompt history in Pi's fullscreen editor).
+ *
+ * Fix:
+ * Re-emit the mouse DECSET sequence once raw mode and VT input are established.
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+  if (process.platform !== "win32") return;
+
+  const MOUSE_BURST = "\x1b[?1000h\x1b[?1002h\x1b[?1004h\x1b[?1006h";
+
+  // 1. Session start: raw mode is guaranteed active
+  pi.on("session_start", async () => {
+    process.stdout.write(MOUSE_BURST);
+  });
+
+  // 2. Intercept setRawMode to resend burst whenever raw mode is engaged (e.g. TUI start / mode switch)
+  const rawStream = process.stdin as NodeJS.ReadStream;
+  const originalSetRawMode = rawStream?.setRawMode?.bind(rawStream);
+  if (originalSetRawMode) {
+    rawStream.setRawMode = function (mode: boolean) {
+      const res = originalSetRawMode(mode);
+      if (mode) {
+        setTimeout(() => {
+          process.stdout.write(MOUSE_BURST);
+        }, 30);
+      }
+      return res;
+    };
+  }
+}

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@rol1n/windows-wheel-fix",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "description": "windows-wheel-fix extension from pi-kit",
+  "keywords": [
+    "pi-package"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RolinShmily/pi-kit.git",
+    "directory": "windows-wheel-fix"
+  },
+  "homepage": "https://github.com/RolinShmily/pi-kit#readme",
+  "bugs": {
+    "url": "https://github.com/RolinShmily/pi-kit/issues"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "skills": [],
+    "prompts": [],
+    "themes": []
+  }
+}