@agi-fans/dsh-tui 0.20.0 → 0.22.0

package/lib/input/keybindings-config.js

@@ -1,36 +1,17 @@
-/** User-overridable application keybindings loaded from one JSON document. */
-import { readFileSync } from 'node:fs';
-export const DEFAULT_KEYBINDINGS = Object.freeze({
-    'ctrl+x': 'external-editor',
-    'alt+m': 'preview-images',
-    'alt+i': 'expand-paste',
-    'alt+s': 'steer-turn',
-    'alt+q': 'manage-queue',
-    'alt+v': 'review-changes',
-    'alt+r': 'retry',
-    'ctrl+v': 'paste-clipboard',
-    'alt+c': 'copy-prompt',
-    'ctrl+alt+c': 'copy-line',
-    'alt+a': 'inspect-subagent',
-    'ctrl+p': 'cycle-model-forward',
-    'alt+p': 'cycle-model-backward',
-    'ctrl+t': 'cycle-reasoning',
-    'ctrl+o': 'toggle-tools',
-    'alt+o': 'toggle-tool-details',
-    'pageup': 'scroll-page-up',
-    'pagedown': 'scroll-page-down',
-    'shift+up': 'scroll-fast-up',
-    'shift+down': 'scroll-fast-down',
-    'ctrl+r': 'search-history',
-    'ctrl+f': 'search-transcript',
-});
-const ACTIONS = [
-    'external-editor', 'retry', 'paste-clipboard', 'copy-prompt', 'copy-line', 'inspect-subagent',
-    'cycle-model-forward', 'cycle-model-backward', 'cycle-reasoning',
-    'toggle-tools', 'scroll-page-up', 'scroll-page-down', 'scroll-fast-up', 'scroll-fast-down', 'search-history',
-    'search-transcript', 'toggle-tool-details', 'review-changes', 'expand-paste', 'steer-turn', 'manage-queue', 'preview-images',
-];
-/** Load `{ "key-id": "action" }`; invalid rows are ignored independently. */
+/**
+ * User-overridable application keybindings loaded from one JSON document.
+ *
+ * The catalog in `./actions.ts` is the single source of truth: it supplies the
+ * shipped chords, the accepted aliases, and the wording every surface prints.
+ * This module only layers a user's `{ "key-id": "action" }` document on top and
+ * reports the chords that document makes ambiguous.
+ * @module @agi-fans/dsh-tui
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { DEFAULT_KEYBINDINGS, isPrimaryKey, TUI_ACTIONS, } from "./actions.js";
+export { DEFAULT_KEYBINDINGS, TUI_ACTIONS, TUI_ACTION_CATALOG, TUI_ACTION_LABELS, } from "./actions.js";
+/** Load `{ "key-id": "action" }`; invalid rows are ignored independently, and `null` unbinds a default key. */
 export function loadKeybindings(path) {
     const result = { ...DEFAULT_KEYBINDINGS };
     if (path === undefined)
@@ -40,11 +21,52 @@ export function loadKeybindings(path) {
         if (typeof parsed !== 'object' || parsed === null)
             return result;
         for (const [key, action] of Object.entries(parsed)) {
-            if (typeof action === 'string' && ACTIONS.includes(action))
-                result[key.toLowerCase()] = action;
+            const normalized = key.toLowerCase();
+            if (action === null)
+                delete result[normalized];
+            else if (typeof action === 'string' && TUI_ACTIONS.includes(action))
+                result[normalized] = action;
         }
     }
     catch { /* missing/malformed user config falls back to shipped bindings */ }
     return result;
 }
+/** Persist user keybinding overrides relative to {@link DEFAULT_KEYBINDINGS}. */
+export function saveKeybindings(path, bindings) {
+    const overrides = {};
+    for (const [key, defaultAction] of Object.entries(DEFAULT_KEYBINDINGS)) {
+        const current = bindings[key];
+        if (current === undefined)
+            overrides[key] = null;
+        else if (current !== defaultAction)
+            overrides[key] = current;
+    }
+    for (const [key, action] of Object.entries(bindings)) {
+        const normalized = key.toLowerCase();
+        if (!(normalized in DEFAULT_KEYBINDINGS) && TUI_ACTIONS.includes(action)) {
+            overrides[normalized] = action;
+        }
+    }
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(overrides, null, 2) + '\n', 'utf8');
+}
+/**
+ * The bindings a hint is allowed to print.
+ *
+ * A resolved table also names the aliases a migration kept working, and a hint
+ * that printed `Ctrl+F / Ctrl+Shift+F` for one action would be telling the user
+ * about a chord the interface does not want them to learn. Only chords that are
+ * a shipped primary for their action survive, so an override that deliberately
+ * moves an action is still printed and a straggler alias is not.
+ */
+export function displayBindings(bindings) {
+    const shown = {};
+    for (const [key, action] of Object.entries(bindings)) {
+        // Shipped primary: always shown. Shipped alias for this same action: hidden.
+        // Any key the catalog does not give this action — a user override — is theirs to see.
+        if (isPrimaryKey(action, key) || DEFAULT_KEYBINDINGS[key] !== action)
+            shown[key] = action;
+    }
+    return shown;
+}
 //# sourceMappingURL=keybindings-config.js.map

package/lib/input/keybindings-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"keybindings-config.js","sourceRoot":"","sources":["../../src/input/keybindings-config.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAOtC,MAAM,CAAC,MAAM,mBAAmB,GAAwC,MAAM,CAAC,MAAM,CAAC;IACpF,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,gBAAgB;IACzB,OAAO,EAAE,cAAc;IACvB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,cAAc;IACvB,OAAO,EAAE,gBAAgB;IACzB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,aAAa;IACtB,YAAY,EAAE,WAAW;IACzB,OAAO,EAAE,kBAAkB;IAC3B,QAAQ,EAAE,qBAAqB;IAC/B,OAAO,EAAE,sBAAsB;IAC/B,QAAQ,EAAE,iBAAiB;IAC3B,QAAQ,EAAE,cAAc;IACxB,OAAO,EAAE,qBAAqB;IAC9B,QAAQ,EAAE,gBAAgB;IAC1B,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE,gBAAgB;IAC5B,YAAY,EAAE,kBAAkB;IAChC,QAAQ,EAAE,gBAAgB;IAC1B,QAAQ,EAAE,mBAAmB;CAC9B,CAAC,CAAA;AAEF,MAAM,OAAO,GAAyB;IACpC,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB;IAC7F,qBAAqB,EAAE,sBAAsB,EAAE,iBAAiB;IAChE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB;IAC5G,mBAAmB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB;CAC7H,CAAA;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,IAAwB;IACtD,MAAM,MAAM,GAA8B,EAAE,GAAG,mBAAmB,EAAE,CAAA;IACpE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;QAC9D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAA;QAChE,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAmB,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,MAAmB,CAAA;QAC1H,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,kEAAkE,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"keybindings-config.js","sourceRoot":"","sources":["../../src/input/keybindings-config.ts"],"names":[],"mappings":"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"}

package/lib/input/keys.d.ts

@@ -4,6 +4,7 @@
  * `enter`, `ctrl+a`, `alt+left`, `shift+enter`, …
  * @module @agi-fans/dsh-tui
  */
+import { type OscColorReply } from '../chrome/terminal-colors.ts';
 /** One decoded input event. */
 export type KeyEvent = {
     type: 'key';
@@ -14,6 +15,23 @@ export type KeyEvent = {
 } | {
     type: 'focus';
     focused: boolean;
+} | {
+    type: 'program-status-support';
+} | {
+    type: 'color-reply';
+    reply: OscColorReply;
+} | {
+    type: 'color-scheme';
+    scheme: 'dark' | 'light';
+} | {
+    type: 'kitty-flags';
+    flags: number;
+} | {
+    type: 'device-attributes';
+} | {
+    type: 'mode-report';
+    mode: number;
+    state: number;
 } | {
     type: 'cell-size';
     width: number;

package/lib/input/keys.js

@@ -4,6 +4,7 @@
  * `enter`, `ctrl+a`, `alt+left`, `shift+enter`, …
  * @module @agi-fans/dsh-tui
  */
+import { parseOscColorReply } from "../chrome/terminal-colors.js";
 const CTRL = {
     0x01: 'ctrl+a',
     0x02: 'ctrl+b',
@@ -121,6 +122,30 @@ function parseCsi(seq) {
     const body = seq.slice(1);
     if (body === '')
         return 'partial';
+    // Replies to our capability queries can arrive back to back in one read, so
+    // every one of these matches a PREFIX: anchoring on the end of the buffer
+    // would fail as soon as the terminal answered two queries at once, and the
+    // reply would be echoed into the composer as text.
+    // CSI ?997;N n reports whether the terminal describes itself as dark or light.
+    const scheme = /^\?997;([12])n/u.exec(body);
+    if (scheme !== null)
+        return { event: { type: 'color-scheme', scheme: scheme[1] === '2' ? 'light' : 'dark' }, used: 1 + scheme[0].length };
+    // `CSI ? u` with no flags answers "supported, none enabled"; treat it as zero
+    // rather than letting the bytes fall through as text.
+    if (body.startsWith('?u') || body.startsWith('>u'))
+        return { event: { type: 'kitty-flags', flags: 0 }, used: 1 + 2 };
+    // CSI >|? flags u is the Kitty keyboard protocol's answer to our query.
+    const kittyFlags = /^[>?](\d+)u/u.exec(body);
+    if (kittyFlags !== null)
+        return { event: { type: 'kitty-flags', flags: Number(kittyFlags[1]) }, used: 1 + kittyFlags[0].length };
+    // CSI ? ... c is the primary device-attributes reply, our negotiation sentinel.
+    const attributes = /^\?[\d;]*c/u.exec(body);
+    if (attributes !== null)
+        return { event: { type: 'device-attributes' }, used: 1 + attributes[0].length };
+    // DECRPM: CSI ? mode ; state $ y reports a private mode's support.
+    const decrpm = /^\?(\d+);(\d+)\$y/u.exec(body);
+    if (decrpm !== null)
+        return { event: { type: 'mode-report', mode: Number(decrpm[1]), state: Number(decrpm[2]) }, used: 1 + decrpm[0].length };
     if (body[0] === '<') {
         const parsed = parseSgr(body);
         if (parsed === 'partial')
@@ -129,9 +154,11 @@ function parseCsi(seq) {
             return null;
         return { event: parsed.event, used: parsed.used };
     }
-    const match = /^(?:(\d+)?(?:;(\d+))?(?:;(\d+))?)?([A-Za-z~u])/.exec(body);
+    // Kitty may attach colon sub-parameters (shifted/base key, event type) to the
+    // key code and the modifier; the first value of each field is what we decode.
+    const match = /^(?:(\d+)?(?::\d*)*(?:;(\d+)?(?::\d*)*)?(?:;(\d+))?)?([A-Za-z~u])/.exec(body);
     if (match === null) {
-        if (/^[\d;]*$/.test(body) && body.length < 32)
+        if ((/^[\d;:]*$/.test(body) || /^[>?][\d;]*\$?$/u.test(body)) && body.length < 32)
             return 'partial';
         return null;
     }
@@ -187,12 +214,30 @@ export function parseKeys(input) {
             const second = tail[1];
             if (second === undefined)
                 return { events, rest: tail };
+            if (second === ']') {
+                const end = /\x07|\x1b\\/u.exec(tail.slice(2));
+                if (end === null)
+                    return tail.length < 4096 ? { events, rest: tail } : { events, rest: '' };
+                const body = tail.slice(2, 2 + end.index);
+                if (/^7501;\?(?:[:;].*)?$/u.test(body))
+                    events.push({ type: 'program-status-support' });
+                else {
+                    const reply = parseOscColorReply(body);
+                    if (reply !== undefined)
+                        events.push({ type: 'color-reply', reply });
+                }
+                i += 2 + end.index + end[0].length;
+                continue;
+            }
             if (second === '[') {
                 const parsed = parseCsi(tail.slice(1));
                 if (parsed === 'partial')
                     return { events, rest: tail };
                 if (parsed === null) {
-                    i += 1;
+                    // A complete CSI we do not decode is still control data. Dropping only
+                    // the ESC would type its parameters into the composer.
+                    const complete = /^\x1b\[[\d;:?<=>]*[\x20-\x2f]*[\x40-\x7e]/u.exec(tail);
+                    i += complete === null ? 1 : complete[0].length;
                     continue;
                 }
                 if (parsed.event !== undefined)

package/lib/input/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/input/keys.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/input/keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAsB,MAAM,8BAA8B,CAAA;AAmBrF,MAAM,IAAI,GAA2B;IACnC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,WAAW;CAClB,CAAA;AAED,MAAM,UAAU,GAA2B;IACzC,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,WAAW;CACf,CAAA;AAED,MAAM,SAAS,GAA2B;IACxC,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,UAAU;CACd,CAAA;AAED,MAAM,KAAK,GAA2B;IACpC,CAAC,EAAE,KAAK;IACR,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,QAAQ;IACZ,GAAG,EAAE,WAAW;IAChB,KAAK,EAAE,QAAQ;CAChB,CAAA;AAED,MAAM,WAAW,GAA2B;IAC1C,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,eAAe;IACvB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,YAAY;CACrB,CAAA;AAED,4EAA4E;AAC5E,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,QAAgB;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAA;IACtC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,IAAI,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAChC,IAAI,IAAI,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjC,IAAI,IAAI,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC/B,IAAI,IAAI,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACnC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAA;AACrC,CAAC;AAED,SAAS,OAAO,CAAC,EAAU;IACzB,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IACpE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;AAC5B,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,QAAgB;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IACzB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;IAClE,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,GAAG,GAAG;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC3F,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAA;AAC/D,CAAC;AAED,2FAA2F;AAC3F,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,EAAE,CAAA;QACzB,IAAI,KAA2B,CAAA;QAC/B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,EAAE,CAAC,EAAE,CAAC;YACzD,KAAK,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;QACrE,CAAC;aAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,KAAK,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;gBAC9F,MAAM,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;gBACxE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAA;QAC3D,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;IACjF,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IAC1E,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,0CAA0C;IAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACzB,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,SAAS,CAAA;IACjC,4EAA4E;IAC5E,0EAA0E;IAC1E,2EAA2E;IAC3E,mDAAmD;IACnD,+EAA+E;IAC/E,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;IACzI,8EAA8E;IAC9E,sDAAsD;IACtD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAA;IACpH,wEAAwE;IACxE,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5C,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;IAChI,gFAAgF;IAChF,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;IACxG,mEAAmE;IACnE,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;IAC7I,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC7B,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QAC1C,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAChC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;IACnD,CAAC;IACD,8EAA8E;IAC9E,8EAA8E;IAC9E,MAAM,KAAK,GAAG,mEAAmE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5F,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,SAAS,CAAA;QACnG,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IAChC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3E,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3E,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACnF,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC1B,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,GAAG,EAAE,EAAE,IAAI,EAAE,CAAA;IAC1H,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI;gBAC3G,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,CAAA;IACpE,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAA;IAC3D,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,EAAE,KAAK,GAAG;YAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,CAAA;QAC/D,IAAI,EAAE,KAAK,GAAG;YAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAA;QAC7D,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAA;QAC5C,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAA;QAC1B,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QAChF,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;IACrD,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;IACnF,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;AACjF,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;IACnB,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACxC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IAC/B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,MAAM,GAAe,EAAE,CAAA;IAC7B,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAChC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;YACtB,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;YACvD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC9C,IAAI,GAAG,KAAK,IAAI;oBAAE,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;gBAC3F,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAA;gBACzC,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAA;qBAClF,CAAC;oBACJ,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;oBACtC,IAAI,KAAK,KAAK,SAAS;wBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAA;gBACtE,CAAC;gBACD,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;gBAClC,SAAQ;YACV,CAAC;YACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;gBACtC,IAAI,MAAM,KAAK,SAAS;oBAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;gBACvD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,uEAAuE;oBACvE,uDAAuD;oBACvD,MAAM,QAAQ,GAAG,4CAA4C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBACxE,CAAC,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;oBAC/C,SAAQ;gBACV,CAAC;gBACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;oBAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACzD,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAA;gBACpB,SAAQ;YACV,CAAC;YACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;gBACtC,IAAI,MAAM,KAAK,SAAS;oBAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;gBACvD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,CAAC,IAAI,CAAC,CAAA;oBACN,SAAQ;gBACV,CAAC;gBACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;oBAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACzD,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAA;gBACpB,SAAQ;YACV,CAAC;YACD,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;YAC/B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;gBACrC,CAAC,IAAI,CAAC,CAAA;gBACN,SAAQ;YACV,CAAC;YACD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACvC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAA;gBAC/D,CAAC,IAAI,CAAC,CAAA;gBACN,SAAQ;YACV,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;YAC1C,CAAC,IAAI,CAAC,CAAA;YACN,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;QACvB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;YACtC,CAAC,IAAI,CAAC,CAAA;YACN,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAChB,CAAC,IAAI,CAAC,CAAA;YACN,SAAQ;QACV,CAAC;QACD,iDAAiD;QACjD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACb,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YAChC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;gBAAE,MAAK;YACxD,CAAC,IAAI,CAAC,CAAA;QACR,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;QACvD,CAAC,GAAG,CAAC,CAAA;IACP,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC3D,OAAO,EAAE,CAAA;AACX,CAAC"}

package/lib/input/wheel-scroll.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Wheel scrolling that follows one physical gesture instead of counting
+ * events. Terminals disagree about what a "wheel event" is: a high-resolution
+ * device can split one notch into several reports a few milliseconds apart,
+ * while a classic mouse sends exactly one, and one terminal read can also
+ * batch several real notches together. A notch keeps the familiar three lines;
+ * a near-simultaneous follow-up report moves one line, so a split notch no
+ * longer triples its distance while a batched spin still travels; and a fast
+ * spin earns up to twice the distance per notch. Fractions carry into the next
+ * event so the acceleration stays smooth.
+ *
+ * Local macOS terminals are the exception: the OS already accelerates wheel
+ * and trackpad deltas and reports one event per line, so the TUI keeps a flat
+ * three lines per event there instead of accelerating twice.
+ * @module @agi-fans/dsh-tui/wheel-scroll
+ */
+/** Accumulated state of one wheel gesture. */
+export interface WheelGesture {
+    /** When the most recent report arrived. */
+    countedAt: number;
+    /** Direction of the gesture: -1 up, 1 down, 0 idle. */
+    direction: -1 | 0 | 1;
+    /** Fractional lines not yet scrolled, signed like the direction. */
+    carry: number;
+}
+/** The gesture to start with. */
+export declare const IDLE_WHEEL: WheelGesture;
+/**
+ * Whether the terminal already accelerates wheel input. Local macOS terminals
+ * receive deltas the OS accelerated and emit one event per line; other
+ * platforms, and SSH sessions where the client platform is unknown, usually
+ * send one event per wheel notch.
+ */
+export declare function terminalAcceleratesWheel(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
+/**
+ * How far one wheel event should scroll.
+ * @param gesture - state returned by the previous call.
+ * @param now - this event's timestamp in milliseconds.
+ * @param direction - `-1` for up, `1` for down.
+ * @param terminalAccelerates - the terminal already accelerates deltas, so every event moves a flat {@link BASE_LINES}.
+ * @returns the signed line count to move and the state to carry into the next event.
+ */
+export declare function wheelStep(gesture: WheelGesture, now: number, direction: -1 | 1, terminalAccelerates?: boolean): {
+    lines: number;
+    gesture: WheelGesture;
+};

package/lib/input/wheel-scroll.js

@@ -0,0 +1,69 @@
+/**
+ * Wheel scrolling that follows one physical gesture instead of counting
+ * events. Terminals disagree about what a "wheel event" is: a high-resolution
+ * device can split one notch into several reports a few milliseconds apart,
+ * while a classic mouse sends exactly one, and one terminal read can also
+ * batch several real notches together. A notch keeps the familiar three lines;
+ * a near-simultaneous follow-up report moves one line, so a split notch no
+ * longer triples its distance while a batched spin still travels; and a fast
+ * spin earns up to twice the distance per notch. Fractions carry into the next
+ * event so the acceleration stays smooth.
+ *
+ * Local macOS terminals are the exception: the OS already accelerates wheel
+ * and trackpad deltas and reports one event per line, so the TUI keeps a flat
+ * three lines per event there instead of accelerating twice.
+ * @module @agi-fans/dsh-tui/wheel-scroll
+ */
+/** Lines one notch moves at a deliberate pace, the distance the TUI always used. */
+const BASE_LINES = 3;
+/** Reports closer than this to the previous one are follow-ups, not new notches. */
+const BURST_GAP_MS = 5;
+/** Lines a follow-up report moves. */
+const BURST_LINES = 1;
+/** A pause this long, or a change of direction, ends the gesture. */
+const GESTURE_GAP_MS = 200;
+/** Notch spacing at or below which a spin reaches full acceleration. */
+const FAST_GAP_MS = 40;
+/** Notch spacing at or above which a spin is deliberate and not accelerated. */
+const SLOW_GAP_MS = 120;
+/** Most a fast spin may multiply one notch's distance. */
+const MAX_ACCELERATION = 2;
+/** The gesture to start with. */
+export const IDLE_WHEEL = { countedAt: 0, direction: 0, carry: 0 };
+/**
+ * Whether the terminal already accelerates wheel input. Local macOS terminals
+ * receive deltas the OS accelerated and emit one event per line; other
+ * platforms, and SSH sessions where the client platform is unknown, usually
+ * send one event per wheel notch.
+ */
+export function terminalAcceleratesWheel(env = process.env, platform = process.platform) {
+    return platform === 'darwin'
+        && env.SSH_CONNECTION === undefined
+        && env.SSH_CLIENT === undefined
+        && env.SSH_TTY === undefined;
+}
+/**
+ * How far one wheel event should scroll.
+ * @param gesture - state returned by the previous call.
+ * @param now - this event's timestamp in milliseconds.
+ * @param direction - `-1` for up, `1` for down.
+ * @param terminalAccelerates - the terminal already accelerates deltas, so every event moves a flat {@link BASE_LINES}.
+ * @returns the signed line count to move and the state to carry into the next event.
+ */
+export function wheelStep(gesture, now, direction, terminalAccelerates = false) {
+    if (terminalAccelerates)
+        return { lines: direction * BASE_LINES, gesture: IDLE_WHEEL };
+    const gap = now - gesture.countedAt;
+    const fresh = gesture.direction !== direction || gap > GESTURE_GAP_MS;
+    // A follow-up report: part of a split notch, or one of several batched
+    // notches. Either way it moves a single line, without acceleration.
+    if (!fresh && gap < BURST_GAP_MS) {
+        return { lines: direction * BURST_LINES, gesture: { countedAt: now, direction, carry: gesture.carry } };
+    }
+    const acceleration = fresh ? 1 : 1 + (MAX_ACCELERATION - 1)
+        * Math.max(0, Math.min(1, (SLOW_GAP_MS - gap) / (SLOW_GAP_MS - FAST_GAP_MS)));
+    const total = (fresh ? 0 : gesture.carry) + direction * BASE_LINES * acceleration;
+    const lines = Math.trunc(total);
+    return { lines, gesture: { countedAt: now, direction, carry: total - lines } };
+}
+//# sourceMappingURL=wheel-scroll.js.map

package/lib/input/wheel-scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wheel-scroll.js","sourceRoot":"","sources":["../../src/input/wheel-scroll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,oFAAoF;AACpF,MAAM,UAAU,GAAG,CAAC,CAAA;AACpB,oFAAoF;AACpF,MAAM,YAAY,GAAG,CAAC,CAAA;AACtB,sCAAsC;AACtC,MAAM,WAAW,GAAG,CAAC,CAAA;AACrB,qEAAqE;AACrE,MAAM,cAAc,GAAG,GAAG,CAAA;AAC1B,wEAAwE;AACxE,MAAM,WAAW,GAAG,EAAE,CAAA;AACtB,gFAAgF;AAChF,MAAM,WAAW,GAAG,GAAG,CAAA;AACvB,0DAA0D;AAC1D,MAAM,gBAAgB,GAAG,CAAC,CAAA;AAY1B,iCAAiC;AACjC,MAAM,CAAC,MAAM,UAAU,GAAiB,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAE,WAA4B,OAAO,CAAC,QAAQ;IACzH,OAAO,QAAQ,KAAK,QAAQ;WACvB,GAAG,CAAC,cAAc,KAAK,SAAS;WAChC,GAAG,CAAC,UAAU,KAAK,SAAS;WAC5B,GAAG,CAAC,OAAO,KAAK,SAAS,CAAA;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,OAAqB,EAAE,GAAW,EAAE,SAAiB,EAAE,mBAAmB,GAAG,KAAK;IAC1G,IAAI,mBAAmB;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;IACtF,MAAM,GAAG,GAAG,GAAG,GAAG,OAAO,CAAC,SAAS,CAAA;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,GAAG,GAAG,cAAc,CAAA;IACrE,uEAAuE;IACvE,oEAAoE;IACpE,IAAI,CAAC,KAAK,IAAI,GAAG,GAAG,YAAY,EAAE,CAAC;QACjC,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAA;IACzG,CAAC;IACD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,CAAC;UACvD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;IAC/E,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAA;IACjF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC/B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,EAAE,CAAA;AAChF,CAAC"}

package/lib/prompt-intents.d.ts

@@ -0,0 +1,182 @@
+/**
+ * The four intents a caller actually has when it asks the reader something.
+ *
+ * `TuiPrompt` grew to forty-six optional fields because every new surface added
+ * one: `presentation`, `filterable`, `approveValue`,
+ * `dismissLabel`, `skippable`, `wait`, `interrupt`, `onSuperseded`,
+ * `refreshDocument`, `refreshOptions` … A caller passing `{ title, question,
+ * allowCustom: true }` had to know that omitting `options` means "free text" and
+ * that `allowCustom: false` is what makes a list non-editable. Nothing in the
+ * type said which fields belong together, so each new caller assembled its own
+ * combination and the interface kept widening.
+ *
+ * These four intents are measured, not invented: across 196 call sites, 109 ask
+ * for free text, 45 offer a list, 14 read a document, and the rest are those
+ * shapes with one extra field. Each function below names the intent, defaults
+ * what the intent always wants, and leaves the escape hatch — {@link TuiService.prompt}
+ * with the full type — for the handful of surfaces that genuinely need it.
+ *
+ * @module @agi-fans/dsh-tui/prompt-intents
+ */
+import type { TuiDocumentPosition, TuiDocumentSource, TuiPrompt } from './definition.ts';
+/** One choice a {@link choose} offers. */
+export interface PromptChoice {
+    label: string;
+    /** Answer returned to the caller; defaults to {@link label}. */
+    value?: string;
+    description?: string;
+    /** Parent value when the list is a tree; a missing parent makes a root. */
+    parentValue?: string;
+    /** Secondary content shown above the metadata in a spacious list. */
+    preview?: string;
+    /** Verb shown for Enter on this row. */
+    submitLabel?: string;
+    /** Semantic badge painted after the description. */
+    badge?: {
+        label: string;
+        tone: 'success' | 'warning' | 'error' | 'muted';
+    };
+}
+/** One keyboard chord a {@link choose} list accepts besides Enter and the arrows. */
+export interface PromptAction {
+    key: string;
+    label: string;
+    /** Returned before the selected value, so the caller can tell which chord fired. */
+    valuePrefix: string;
+    /** `list` returns only the prefix, even with no row selected. */
+    scope?: 'selection' | 'list';
+}
+/** A surface that needs no answer, only a decision to stop. */
+export interface CancelSurface {
+    /** Label of the option that cancels; defaults to `Cancel`. */
+    cancelLabel?: string;
+    /** What cancelling does and does not undo. */
+    detail?: string;
+    signal?: AbortSignal;
+    /**
+     * The work behind the surface, so `Esc` and `Ctrl+C` can stop it.
+     *
+     * Returning true keeps a primary turn running: a progress surface belongs to
+     * one operation, not to the session.
+     */
+    interrupt?: () => boolean | void;
+    /** The surface was taken by something with a stronger claim on the screen. */
+    onSuperseded?: (input: string) => void;
+    /** Repaint an open document; read on every refresh. */
+    refreshDocument?: () => string;
+}
+/**
+ * Ask for free text.
+ *
+ * This is the shape 109 of 196 call sites wanted and had to spell as
+ * `{ allowCustom: true, notify: false }`. A bare input needs no `options` array
+ * and no `presentation`; both are supplied here so the caller states one thing.
+ */
+export declare function askPrompt(request: {
+    title: string;
+    question: string;
+    detail?: string;
+    /** Prefilled text the reader can edit. */
+    initialInput?: string;
+    /** Keep indentation and trailing newlines, for message-shaped input. */
+    preserveWhitespace?: boolean;
+    /** Mask what is typed; the real value stays in the editor only. */
+    secret?: boolean;
+    /** Rescue partially typed text when the prompt is dismissed or aborted. */
+    onCancelDraft?: (draft: string) => void;
+    /** Verb shown for Enter, such as `validate`; the input is still free text. */
+    submitLabel?: string;
+    signal?: AbortSignal;
+    /** Announce this prompt; off for user-initiated surfaces the reader just opened. */
+    notify?: boolean;
+}): TuiPrompt;
+/**
+ * Offer a list of choices.
+ *
+ * The list is not editable: a caller that wants both a list and free text wants
+ * {@link askPrompt} with `detail`, or the full {@link TuiPrompt} if it really
+ * needs both. Keeping the two apart is what lets this function state the shape
+ * without an `allowCustom` flag the caller has to reason about.
+ */
+export declare function choosePrompt<const T extends PromptChoice>(request: {
+    title: string;
+    question: string;
+    detail?: string;
+    options: readonly T[];
+    /** Value selected when the list opens. */
+    initialValue?: string;
+    /** Let typed text filter the rows. */
+    filterable?: boolean;
+    /** Text shown when the list has no rows; the caller owns this wording. */
+    emptyText?: string;
+    /** Keyboard chords the list accepts besides Enter and the arrows. */
+    actions?: readonly PromptAction[];
+    /** Allow more than one row to be checked. */
+    multiSelect?: boolean;
+    /** Values checked when a multi-select list opens. */
+    initialValues?: readonly string[];
+    /** Submit an empty answer when every choice is unchecked. */
+    allowEmptySelection?: boolean;
+    /** Verb shown after Enter in the navigation hint. */
+    submitLabel?: string;
+    signal?: AbortSignal;
+    notify?: boolean;
+}): TuiPrompt;
+/**
+ * Ask one yes/no question.
+ *
+ * Returns a boolean rather than a string or null, because "dismissed" and "no"
+ * are the same answer: a reader who presses Escape has not agreed to anything.
+ * Callers that need to tell those apart use the full prompt.
+ */
+export declare function confirmPrompt(prompt: (request: TuiPrompt) => Promise<string | null>, request: {
+    title: string;
+    question: string;
+    detail?: string;
+    /** Verb on the accepting row; the declining row is always a cancel. */
+    acceptLabel?: string;
+    /** One line under the accepting row saying what accepting does. */
+    acceptDescription?: string;
+    /**
+     * Label of the declining row; defaults to `Cancel`.
+     *
+     * Pass `null` for a one-way door: the reader either proceeds or dismisses.
+     * That is a different intent from a yes/no question — "install and enable"
+     * has no meaningful opposite to put beside it — and it is what 24 call sites
+     * meant by a list with a single row.
+     */
+    cancelLabel?: string | null;
+    /** One line under the declining row; usually what staying put means. */
+    cancelDescription?: string;
+    signal?: AbortSignal;
+    notify?: boolean;
+}): Promise<boolean>;
+/**
+ * Show a document the reader can scroll, search, and leave.
+ *
+ * The surface is dropped automatically when the work it describes ends, so the
+ * caller does not have to pair an open with a close.
+ */
+export declare function readPrompt(request: {
+    title: string;
+    question: string;
+    /** The text to read; wrapped by default. */
+    text?: string;
+    /** A prepared source reader with line numbers and search. */
+    source?: TuiDocumentSource;
+    /** Open at this position. */
+    position?: TuiDocumentPosition;
+    /** Open at the latest row, for output that is still arriving. */
+    tail?: boolean;
+    /** A prepared image shown in the dedicated reader. */
+    image?: TuiPrompt['documentImage'];
+    /** Repaint while open; read on every refresh. */
+    refresh?: () => string;
+    /** Told the last visible position when the reader leaves. */
+    onPosition?: (position: TuiDocumentPosition) => void;
+    cancelLabel?: string;
+    detail?: string;
+    signal?: AbortSignal;
+    interrupt?: () => boolean | void;
+    onSuperseded?: (input: string) => void;
+}): TuiPrompt;