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

package/README.md

@@ -1,3 +1,21 @@
-# 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.
+Restore mouse-wheel reporting for Pi running under Windows ConPTY/Zellij when terminal initialization causes wheel events to be translated into prompt-history navigation.
+
+## Install
+
+```sh
+pi install npm:@rol1n/windows-wheel-fix
+```
+
+Also included in `@rol1n/pi-kit`. The entrypoint returns immediately outside native Windows, so an aggregate installation does not apply this terminal patch on Linux, WSL, or macOS.
+
+## Behavior
+
+The extension re-emits mouse-reporting control sequences after session startup and whenever stdin returns to raw mode. It has no slash command, settings section, credentials, or external binary requirement.
+
+The targeted upstream issue is [earendil-works/pi#9656](https://github.com/earendil-works/pi/issues/9656). If your installed Pi/terminal versions already resolve that issue, disable the extension through Pi's package resource configuration.
+
+## Source layout
+
+The small, platform-specific patch stays in one `index.ts` beside this README.

package/extensions/windows-wheel-fix/README.md

@@ -0,0 +1,21 @@
+# windows-wheel-fix
+
+Restore mouse-wheel reporting for Pi running under Windows ConPTY/Zellij when terminal initialization causes wheel events to be translated into prompt-history navigation.
+
+## Install
+
+```sh
+pi install npm:@rol1n/windows-wheel-fix
+```
+
+Also included in `@rol1n/pi-kit`. The entrypoint returns immediately outside native Windows, so an aggregate installation does not apply this terminal patch on Linux, WSL, or macOS.
+
+## Behavior
+
+The extension re-emits mouse-reporting control sequences after session startup and whenever stdin returns to raw mode. It has no slash command, settings section, credentials, or external binary requirement.
+
+The targeted upstream issue is [earendil-works/pi#9656](https://github.com/earendil-works/pi/issues/9656). If your installed Pi/terminal versions already resolve that issue, disable the extension through Pi's package resource configuration.
+
+## Source layout
+
+The small, platform-specific patch stays in one `index.ts` beside this README.

package/extensions/windows-wheel-fix/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,43 @@
 {
   "name": "@rol1n/windows-wheel-fix",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "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": "extensions/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"
+  },
+  "files": [
+    "extensions/windows-wheel-fix",
+    "extensions/windows-wheel-fix/README.md"
+  ],
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions/windows-wheel-fix/index.ts"
+    ],
+    "skills": [],
+    "prompts": [],
+    "themes": []
+  }
+}