@gonrocca/zero-pi 0.1.63 → 0.1.64

package/extensions/zero-models-picker.ts

@@ -346,6 +346,49 @@ export function navigate(state: PickerState, dir: -1 | 1): PickerState {
   return state;
 }
 
+// ---------------------------------------------------------------------------
+// decodeKey — keystroke decoding
+// ---------------------------------------------------------------------------
+
+/** The picker's five meaningful keys, as decoded from a raw stdin sequence. */
+export type PickerKey = "up" | "down" | "enter" | "esc" | "backspace";
+
+/**
+ * Kitty-keyboard-protocol matcher for one functional key: `CSI <code>` +
+ * optional `;1` (no modifiers) + optional `:1` (press) / `:2` (repeat) +
+ * `<final>`. A `:3` (release) or any real modifier does NOT match — releases
+ * must be ignored and modified keys are not picker keys.
+ */
+function kittyPressOrRepeat(code: string, final: string): RegExp {
+  return new RegExp(`^\\x1b\\[${code}(?:;1(?::[12])?)?${final}$`);
+}
+
+const KITTY_UP = kittyPressOrRepeat("1", "A");
+const KITTY_DOWN = kittyPressOrRepeat("1", "B");
+const KITTY_ENTER = kittyPressOrRepeat("13", "u");
+const KITTY_ESC = kittyPressOrRepeat("27", "u");
+const KITTY_BACKSPACE = kittyPressOrRepeat("127", "u");
+
+/**
+ * Decode one raw stdin sequence into a picker key, or `null` when it is not
+ * one (printable characters, releases, modified keys, unknown sequences).
+ *
+ * pi-tui negotiates kitty keyboard protocol flags 7 with the terminal, and a
+ * granting terminal (Ghostty, kitty, …) then encodes arrows as
+ * `CSI 1;1:1 A/B` and Esc as `CSI 27 u` — never the legacy `\x1b[A` / bare
+ * `\x1b` forms. A non-granting terminal keeps the legacy (or SS3
+ * application-cursor-mode) forms. Both worlds are accepted here; kitty
+ * repeats (`:2`) navigate too so holding an arrow scrolls the list.
+ */
+export function decodeKey(data: string): PickerKey | null {
+  if (data === "\x1b[A" || data === "\x1bOA" || KITTY_UP.test(data)) return "up";
+  if (data === "\x1b[B" || data === "\x1bOB" || KITTY_DOWN.test(data)) return "down";
+  if (data === "\r" || data === "\n" || data === "\r\n" || KITTY_ENTER.test(data)) return "enter";
+  if (data === "\x1b" || KITTY_ESC.test(data)) return "esc";
+  if (data === "\x7f" || data === "\x08" || KITTY_BACKSPACE.test(data)) return "backspace";
+  return null;
+}
+
 // ---------------------------------------------------------------------------
 // enter / back — Enter/Esc dispatch
 // ---------------------------------------------------------------------------

package/extensions/zero-models.ts

@@ -44,6 +44,7 @@ import type { AutotunePending } from "./autotune-extension.ts";
 import {
   back,
   createPickerState,
+  decodeKey,
   enter,
   navigate,
   submitText,
@@ -521,14 +522,6 @@ const PICKER_TITLE = "zero · modelos SDD";
 /** The dim help line shown at the foot of the boxed panel. */
 const PICKER_HELP = "↑↓ navegar · enter elegir · esc volver";
 
-/** ANSI arrow-key escape sequences. */
-const KEY_UP = "\x1b[A";
-const KEY_DOWN = "\x1b[B";
-const KEY_ESC = "\x1b";
-/** Enter — CR or LF, depending on the terminal. */
-const KEY_ENTER = new Set(["\r", "\n", "\r\n"]);
-/** Backspace — DEL or BS. */
-const KEY_BACKSPACE = new Set(["\x7f", "\x08"]);
 
 /**
  * Clamp a rendered line to `width` columns so it never overflows the box
@@ -678,7 +671,8 @@ function createPickerComponent(
 
   /** Route a keystroke while the inline text buffer is open. */
   function handleTextInput(data: string): void {
-    if (data === KEY_ESC) {
+    const key = decodeKey(data);
+    if (key === "esc") {
       // Esc abandons the typed value and returns to the current list screen
       // unchanged. `submitText` with an empty string is exactly that no-op:
       // it clears `textPrompt` and rebuilds the list without committing.
@@ -687,13 +681,13 @@ function createPickerComponent(
       tui.requestRender();
       return;
     }
-    if (KEY_ENTER.has(data)) {
+    if (key === "enter") {
       state = submitText(state, buffer ?? "");
       buffer = null;
       tui.requestRender();
       return;
     }
-    if (KEY_BACKSPACE.has(data)) {
+    if (key === "backspace") {
       buffer = (buffer ?? "").slice(0, -1);
       tui.requestRender();
       return;
@@ -714,24 +708,25 @@ function createPickerComponent(
         return;
       }
 
-      if (data === KEY_UP) {
+      const key = decodeKey(data);
+      if (key === "up") {
         state = navigate(state, -1);
         tui.requestRender();
         return;
       }
-      if (data === KEY_DOWN) {
+      if (key === "down") {
         state = navigate(state, 1);
         tui.requestRender();
         return;
       }
-      if (KEY_ENTER.has(data)) {
+      if (key === "enter") {
         const result = enter(state);
         // `enter` on a custom-* row opens `textPrompt`; arm the buffer.
         if (result.type === "state" && result.state.textPrompt) buffer = "";
         applyResult(result);
         return;
       }
-      if (data === KEY_ESC) {
+      if (key === "esc") {
         applyResult(back(state));
         return;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gonrocca/zero-pi",
-  "version": "0.1.63",
+  "version": "0.1.64",
   "description": "zero-pi — an installable layer for pi (pi.dev): the zero spec-driven development workflow (clarify → explore → plan → analyze → build → veredicto) with automatic clarify/analyze gates, per-phase model autotune, and token-efficient batched builds. Adds capability to pi without modifying pi.",
   "type": "module",
   "keywords": [