@m4ike1/ion-tui 0.1.0

package/dist/keybindings.js

@@ -0,0 +1,331 @@
+import { matchesKey } from "./keys.js";
+export const TUI_KEYBINDINGS = {
+    "tui.editor.cursorUp": { context: "editor", defaultKeys: "up", description: "Move cursor up" },
+    "tui.editor.cursorDown": { context: "editor", defaultKeys: "down", description: "Move cursor down" },
+    "tui.editor.historyPrevious": {
+        context: "editor",
+        defaultKeys: [],
+        description: "Select previous prompt history entry",
+    },
+    "tui.editor.historyNext": {
+        context: "editor",
+        defaultKeys: [],
+        description: "Select next prompt history entry",
+    },
+    "tui.editor.cursorLeft": {
+        context: "editor",
+        defaultKeys: ["left", "ctrl+b"],
+        description: "Move cursor left",
+    },
+    "tui.editor.cursorRight": {
+        context: "editor",
+        defaultKeys: ["right", "ctrl+f"],
+        description: "Move cursor right",
+    },
+    "tui.editor.cursorWordLeft": {
+        context: "editor",
+        defaultKeys: ["alt+left", "ctrl+left", "alt+b"],
+        description: "Move cursor word left",
+    },
+    "tui.editor.cursorWordRight": {
+        context: "editor",
+        defaultKeys: ["alt+right", "ctrl+right", "alt+f"],
+        description: "Move cursor word right",
+    },
+    "tui.editor.cursorLineStart": {
+        context: "editor",
+        defaultKeys: ["home", "ctrl+home", "ctrl+a"],
+        description: "Move to line start",
+    },
+    "tui.editor.cursorLineEnd": {
+        context: "editor",
+        defaultKeys: ["end", "ctrl+end", "ctrl+e"],
+        description: "Move to line end",
+    },
+    "tui.editor.jumpForward": {
+        context: "editor",
+        defaultKeys: "ctrl+]",
+        description: "Jump forward to character",
+    },
+    "tui.editor.jumpBackward": {
+        context: "editor",
+        defaultKeys: "ctrl+alt+]",
+        description: "Jump backward to character",
+    },
+    "tui.editor.pageUp": {
+        context: "editor",
+        defaultKeys: ["pageUp", "ctrl+pageUp"],
+        description: "Page up",
+    },
+    "tui.editor.pageDown": {
+        context: "editor",
+        defaultKeys: ["pageDown", "ctrl+pageDown"],
+        description: "Page down",
+    },
+    "tui.editor.deleteCharBackward": {
+        context: "editor",
+        defaultKeys: "backspace",
+        description: "Delete character backward",
+    },
+    "tui.editor.deleteCharForward": {
+        context: "editor",
+        defaultKeys: ["delete", "ctrl+d"],
+        description: "Delete character forward",
+    },
+    "tui.editor.deleteWordBackward": {
+        context: "editor",
+        defaultKeys: ["ctrl+w", "alt+backspace"],
+        description: "Delete word backward",
+    },
+    "tui.editor.deleteWordForward": {
+        context: "editor",
+        defaultKeys: ["alt+d", "alt+delete"],
+        description: "Delete word forward",
+    },
+    "tui.editor.deleteToLineStart": {
+        context: "editor",
+        defaultKeys: "ctrl+u",
+        description: "Delete to line start",
+    },
+    "tui.editor.deleteToLineEnd": {
+        context: "editor",
+        defaultKeys: "ctrl+k",
+        description: "Delete to line end",
+    },
+    "tui.editor.yank": { context: "editor", defaultKeys: "ctrl+y", description: "Yank" },
+    "tui.editor.yankPop": { context: "editor", defaultKeys: "alt+y", description: "Yank pop" },
+    "tui.editor.undo": { context: "editor", defaultKeys: "ctrl+-", description: "Undo" },
+    "tui.input.newLine": {
+        context: "editor",
+        defaultKeys: ["shift+enter", "ctrl+j"],
+        description: "Insert newline",
+    },
+    "tui.input.submit": { context: "editor", defaultKeys: "enter", description: "Submit input" },
+    "tui.input.tab": { context: "editor", defaultKeys: "tab", description: "Tab / autocomplete" },
+    "tui.input.copy": { context: "editor", defaultKeys: "ctrl+c", description: "Copy selection" },
+    // Selection lists share keys (up/down/enter/escape/...) with editor and
+    // transcript bindings by design; the single focus owner resolves them.
+    "tui.select.up": { context: "dialog", defaultKeys: "up", description: "Move selection up" },
+    "tui.select.down": { context: "dialog", defaultKeys: "down", description: "Move selection down" },
+    "tui.select.pageUp": { context: "dialog", defaultKeys: "pageUp", description: "Selection page up" },
+    "tui.select.pageDown": {
+        context: "dialog",
+        defaultKeys: "pageDown",
+        description: "Selection page down",
+    },
+    "tui.select.confirm": { context: "dialog", defaultKeys: "enter", description: "Confirm selection" },
+    "tui.select.cancel": {
+        context: "dialog",
+        defaultKeys: ["escape", "ctrl+c"],
+        description: "Cancel selection",
+    },
+    // These intentionally shadow the unmodified editor bindings in fullscreen mode.
+    // Viewport navigation shares keys (pageUp/pageDown/home/end/enter/escape/...)
+    // with editor and dialog bindings by design; the focus owner resolves them.
+    "tui.altScreen.pageUp": {
+        context: "transcript",
+        defaultKeys: "pageUp",
+        description: "Scroll viewport up one page",
+    },
+    "tui.altScreen.pageDown": {
+        context: "transcript",
+        defaultKeys: "pageDown",
+        description: "Scroll viewport down one page",
+    },
+    "tui.altScreen.halfPageUp": {
+        context: "transcript",
+        defaultKeys: [],
+        description: "Scroll viewport up half a page",
+    },
+    "tui.altScreen.halfPageDown": {
+        context: "transcript",
+        defaultKeys: [],
+        description: "Scroll viewport down half a page",
+    },
+    "tui.altScreen.lineUp": {
+        context: "transcript",
+        defaultKeys: [],
+        description: "Scroll viewport up one line",
+    },
+    "tui.altScreen.lineDown": {
+        context: "transcript",
+        defaultKeys: [],
+        description: "Scroll viewport down one line",
+    },
+    "tui.altScreen.previousPrompt": {
+        context: "transcript",
+        defaultKeys: ["ctrl+shift+up", "ctrl+up"],
+        description: "Jump to previous semantic prompt",
+    },
+    "tui.altScreen.nextPrompt": {
+        context: "transcript",
+        defaultKeys: ["ctrl+shift+down", "ctrl+down"],
+        description: "Jump to next semantic prompt",
+    },
+    "tui.altScreen.search": {
+        context: "transcript",
+        defaultKeys: "ctrl+shift+f",
+        description: "Search the primary scroll view",
+    },
+    "tui.altScreen.searchNext": {
+        context: "transcript",
+        defaultKeys: ["enter", "ctrl+g"],
+        description: "Select the next search match",
+    },
+    "tui.altScreen.searchPrevious": {
+        context: "transcript",
+        defaultKeys: ["shift+enter", "ctrl+shift+g"],
+        description: "Select the previous search match",
+    },
+    "tui.altScreen.searchClose": {
+        context: "transcript",
+        defaultKeys: "escape",
+        description: "Close transcript search",
+    },
+    "tui.altScreen.top": { context: "transcript", defaultKeys: "home", description: "Scroll viewport to top" },
+    "tui.altScreen.bottom": { context: "transcript", defaultKeys: "end", description: "Scroll viewport to bottom" },
+};
+function normalizeKeys(keys) {
+    if (keys === undefined)
+        return [];
+    const keyList = Array.isArray(keys) ? keys : [keys];
+    const seen = new Set();
+    const result = [];
+    for (const key of keyList) {
+        if (!seen.has(key)) {
+            seen.add(key);
+            result.push(key);
+        }
+    }
+    return result;
+}
+export class KeybindingsManager {
+    definitions;
+    userBindings;
+    keysById = new Map();
+    conflicts = [];
+    constructor(definitions, userBindings = {}) {
+        this.definitions = definitions;
+        this.userBindings = userBindings;
+        this.rebuild();
+    }
+    rebuild() {
+        this.keysById.clear();
+        this.conflicts = [];
+        const userClaims = new Map();
+        for (const [keybinding, keys] of Object.entries(this.userBindings)) {
+            if (!(keybinding in this.definitions))
+                continue;
+            for (const key of normalizeKeys(keys)) {
+                const claimants = userClaims.get(key) ?? new Set();
+                claimants.add(keybinding);
+                userClaims.set(key, claimants);
+            }
+        }
+        for (const [key, keybindings] of userClaims) {
+            if (keybindings.size > 1) {
+                this.conflicts.push({ key, keybindings: [...keybindings] });
+            }
+        }
+        for (const [id, definition] of Object.entries(this.definitions)) {
+            const userKeys = this.userBindings[id];
+            const keys = userKeys === undefined ? normalizeKeys(definition.defaultKeys) : normalizeKeys(userKeys);
+            this.keysById.set(id, keys);
+        }
+    }
+    matches(data, keybinding) {
+        const keys = this.keysById.get(keybinding) ?? [];
+        for (const key of keys) {
+            if (matchesKey(data, key))
+                return true;
+        }
+        return false;
+    }
+    getKeys(keybinding) {
+        return [...(this.keysById.get(keybinding) ?? [])];
+    }
+    getDefinition(keybinding) {
+        return this.definitions[keybinding];
+    }
+    getConflicts() {
+        return this.conflicts.map((conflict) => ({ ...conflict, keybindings: [...conflict.keybindings] }));
+    }
+    /**
+     * Routing context declared for a binding. Extension bindings without a
+     * declared context default to `global`.
+     */
+    getContext(keybinding) {
+        return this.definitions[keybinding]?.context ?? "global";
+    }
+    /** All binding ids declared for one routing context. */
+    getBindingsByContext(context) {
+        const result = [];
+        for (const id of Object.keys(this.definitions)) {
+            if (this.getContext(id) === context) {
+                result.push(id);
+            }
+        }
+        return result;
+    }
+    /**
+     * Same-key claims within a single routing context across resolved bindings
+     * (defaults plus user overrides). Cross-context sharing (e.g. `enter` for
+     * both editor submit and dialog confirm) is intentional and resolved by the
+     * focus owner, so it is not reported here.
+     */
+    getContextConflicts() {
+        const claims = new Map();
+        for (const [id, keys] of this.keysById) {
+            const context = this.getContext(id);
+            for (const key of keys) {
+                let byContext = claims.get(key);
+                if (!byContext) {
+                    byContext = new Map();
+                    claims.set(key, byContext);
+                }
+                let keybindings = byContext.get(context);
+                if (!keybindings) {
+                    keybindings = new Set();
+                    byContext.set(context, keybindings);
+                }
+                keybindings.add(id);
+            }
+        }
+        const conflicts = [];
+        for (const [key, byContext] of claims) {
+            for (const [context, keybindings] of byContext) {
+                if (keybindings.size > 1) {
+                    conflicts.push({ key, context, keybindings: [...keybindings].sort() });
+                }
+            }
+        }
+        conflicts.sort((a, b) => a.context.localeCompare(b.context) || a.key.localeCompare(b.key));
+        return conflicts;
+    }
+    setUserBindings(userBindings) {
+        this.userBindings = userBindings;
+        this.rebuild();
+    }
+    getUserBindings() {
+        return { ...this.userBindings };
+    }
+    getResolvedBindings() {
+        const resolved = {};
+        for (const id of Object.keys(this.definitions)) {
+            const keys = this.keysById.get(id) ?? [];
+            resolved[id] = keys.length === 1 ? keys[0] : [...keys];
+        }
+        return resolved;
+    }
+}
+let globalKeybindings = null;
+export function setKeybindings(keybindings) {
+    globalKeybindings = keybindings;
+}
+export function getKeybindings() {
+    if (!globalKeybindings) {
+        globalKeybindings = new KeybindingsManager(TUI_KEYBINDINGS);
+    }
+    return globalKeybindings;
+}
+//# sourceMappingURL=keybindings.js.map

package/dist/keybindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keybindings.js","sourceRoot":"","sources":["../src/keybindings.ts"],"names":[],"mappings":"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","sourcesContent":["import { type KeyId, matchesKey } from \"./keys.ts\";\n\n/**\n * Global keybinding registry.\n * Downstream packages can add keybindings via declaration merging.\n */\nexport interface Keybindings {\n\t// Editor navigation and editing\n\t\"tui.editor.cursorUp\": true;\n\t\"tui.editor.cursorDown\": true;\n\t\"tui.editor.historyPrevious\": true;\n\t\"tui.editor.historyNext\": true;\n\t\"tui.editor.cursorLeft\": true;\n\t\"tui.editor.cursorRight\": true;\n\t\"tui.editor.cursorWordLeft\": true;\n\t\"tui.editor.cursorWordRight\": true;\n\t\"tui.editor.cursorLineStart\": true;\n\t\"tui.editor.cursorLineEnd\": true;\n\t\"tui.editor.jumpForward\": true;\n\t\"tui.editor.jumpBackward\": true;\n\t\"tui.editor.pageUp\": true;\n\t\"tui.editor.pageDown\": true;\n\t\"tui.editor.deleteCharBackward\": true;\n\t\"tui.editor.deleteCharForward\": true;\n\t\"tui.editor.deleteWordBackward\": true;\n\t\"tui.editor.deleteWordForward\": true;\n\t\"tui.editor.deleteToLineStart\": true;\n\t\"tui.editor.deleteToLineEnd\": true;\n\t\"tui.editor.yank\": true;\n\t\"tui.editor.yankPop\": true;\n\t\"tui.editor.undo\": true;\n\t// Generic input actions\n\t\"tui.input.newLine\": true;\n\t\"tui.input.submit\": true;\n\t\"tui.input.tab\": true;\n\t\"tui.input.copy\": true;\n\t// Generic selection actions\n\t\"tui.select.up\": true;\n\t\"tui.select.down\": true;\n\t\"tui.select.pageUp\": true;\n\t\"tui.select.pageDown\": true;\n\t\"tui.select.confirm\": true;\n\t\"tui.select.cancel\": true;\n\t// Alternate-screen viewport navigation\n\t\"tui.altScreen.pageUp\": true;\n\t\"tui.altScreen.pageDown\": true;\n\t\"tui.altScreen.halfPageUp\": true;\n\t\"tui.altScreen.halfPageDown\": true;\n\t\"tui.altScreen.lineUp\": true;\n\t\"tui.altScreen.lineDown\": true;\n\t\"tui.altScreen.previousPrompt\": true;\n\t\"tui.altScreen.nextPrompt\": true;\n\t\"tui.altScreen.search\": true;\n\t\"tui.altScreen.searchNext\": true;\n\t\"tui.altScreen.searchPrevious\": true;\n\t\"tui.altScreen.searchClose\": true;\n\t\"tui.altScreen.top\": true;\n\t\"tui.altScreen.bottom\": true;\n}\n\nexport type Keybinding = keyof Keybindings;\n\n/**\n * Routing context for a keybinding.\n *\n * - `global`: active regardless of focus. Reserved for downstream app bindings;\n *   no stock `tui.*` binding uses it.\n * - `transcript`: fullscreen viewport navigation. Consumed by the viewport input\n *   listener before the focused component sees the key.\n * - `editor`: prompt editing. Handled by the focused editor.\n * - `dialog`: selection lists and modal prompts. Handled by the focused overlay.\n *\n * Same-key claims across different contexts are intentional sharing, resolved by\n * the single focus owner. Same-key claims within one context are reported by\n * {@link KeybindingsManager.getContextConflicts}.\n */\nexport type KeybindingContext = \"global\" | \"transcript\" | \"editor\" | \"dialog\";\n\nexport interface KeybindingDefinition {\n\tdefaultKeys: KeyId | KeyId[];\n\tdescription?: string;\n\t/**\n\t * Routing context for this binding. Required on every stock `tui.*` binding\n\t * (enforced by test); optional for downstream extension bindings, which\n\t * default to `global` when omitted.\n\t */\n\tcontext?: KeybindingContext;\n}\n\nexport type KeybindingDefinitions = Record<string, KeybindingDefinition>;\nexport type KeybindingsConfig = Record<string, KeyId | KeyId[] | undefined>;\n\nexport const TUI_KEYBINDINGS = {\n\t\"tui.editor.cursorUp\": { context: \"editor\", defaultKeys: \"up\", description: \"Move cursor up\" },\n\t\"tui.editor.cursorDown\": { context: \"editor\", defaultKeys: \"down\", description: \"Move cursor down\" },\n\t\"tui.editor.historyPrevious\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [],\n\t\tdescription: \"Select previous prompt history entry\",\n\t},\n\t\"tui.editor.historyNext\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [],\n\t\tdescription: \"Select next prompt history entry\",\n\t},\n\t\"tui.editor.cursorLeft\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"left\", \"ctrl+b\"],\n\t\tdescription: \"Move cursor left\",\n\t},\n\t\"tui.editor.cursorRight\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"right\", \"ctrl+f\"],\n\t\tdescription: \"Move cursor right\",\n\t},\n\t\"tui.editor.cursorWordLeft\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"alt+left\", \"ctrl+left\", \"alt+b\"],\n\t\tdescription: \"Move cursor word left\",\n\t},\n\t\"tui.editor.cursorWordRight\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"alt+right\", \"ctrl+right\", \"alt+f\"],\n\t\tdescription: \"Move cursor word right\",\n\t},\n\t\"tui.editor.cursorLineStart\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"home\", \"ctrl+home\", \"ctrl+a\"],\n\t\tdescription: \"Move to line start\",\n\t},\n\t\"tui.editor.cursorLineEnd\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"end\", \"ctrl+end\", \"ctrl+e\"],\n\t\tdescription: \"Move to line end\",\n\t},\n\t\"tui.editor.jumpForward\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: \"ctrl+]\",\n\t\tdescription: \"Jump forward to character\",\n\t},\n\t\"tui.editor.jumpBackward\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: \"ctrl+alt+]\",\n\t\tdescription: \"Jump backward to character\",\n\t},\n\t\"tui.editor.pageUp\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"pageUp\", \"ctrl+pageUp\"],\n\t\tdescription: \"Page up\",\n\t},\n\t\"tui.editor.pageDown\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"pageDown\", \"ctrl+pageDown\"],\n\t\tdescription: \"Page down\",\n\t},\n\t\"tui.editor.deleteCharBackward\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: \"backspace\",\n\t\tdescription: \"Delete character backward\",\n\t},\n\t\"tui.editor.deleteCharForward\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"delete\", \"ctrl+d\"],\n\t\tdescription: \"Delete character forward\",\n\t},\n\t\"tui.editor.deleteWordBackward\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"ctrl+w\", \"alt+backspace\"],\n\t\tdescription: \"Delete word backward\",\n\t},\n\t\"tui.editor.deleteWordForward\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"alt+d\", \"alt+delete\"],\n\t\tdescription: \"Delete word forward\",\n\t},\n\t\"tui.editor.deleteToLineStart\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: \"ctrl+u\",\n\t\tdescription: \"Delete to line start\",\n\t},\n\t\"tui.editor.deleteToLineEnd\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: \"ctrl+k\",\n\t\tdescription: \"Delete to line end\",\n\t},\n\t\"tui.editor.yank\": { context: \"editor\", defaultKeys: \"ctrl+y\", description: \"Yank\" },\n\t\"tui.editor.yankPop\": { context: \"editor\", defaultKeys: \"alt+y\", description: \"Yank pop\" },\n\t\"tui.editor.undo\": { context: \"editor\", defaultKeys: \"ctrl+-\", description: \"Undo\" },\n\t\"tui.input.newLine\": {\n\t\tcontext: \"editor\",\n\t\tdefaultKeys: [\"shift+enter\", \"ctrl+j\"],\n\t\tdescription: \"Insert newline\",\n\t},\n\t\"tui.input.submit\": { context: \"editor\", defaultKeys: \"enter\", description: \"Submit input\" },\n\t\"tui.input.tab\": { context: \"editor\", defaultKeys: \"tab\", description: \"Tab / autocomplete\" },\n\t\"tui.input.copy\": { context: \"editor\", defaultKeys: \"ctrl+c\", description: \"Copy selection\" },\n\t// Selection lists share keys (up/down/enter/escape/...) with editor and\n\t// transcript bindings by design; the single focus owner resolves them.\n\t\"tui.select.up\": { context: \"dialog\", defaultKeys: \"up\", description: \"Move selection up\" },\n\t\"tui.select.down\": { context: \"dialog\", defaultKeys: \"down\", description: \"Move selection down\" },\n\t\"tui.select.pageUp\": { context: \"dialog\", defaultKeys: \"pageUp\", description: \"Selection page up\" },\n\t\"tui.select.pageDown\": {\n\t\tcontext: \"dialog\",\n\t\tdefaultKeys: \"pageDown\",\n\t\tdescription: \"Selection page down\",\n\t},\n\t\"tui.select.confirm\": { context: \"dialog\", defaultKeys: \"enter\", description: \"Confirm selection\" },\n\t\"tui.select.cancel\": {\n\t\tcontext: \"dialog\",\n\t\tdefaultKeys: [\"escape\", \"ctrl+c\"],\n\t\tdescription: \"Cancel selection\",\n\t},\n\t// These intentionally shadow the unmodified editor bindings in fullscreen mode.\n\t// Viewport navigation shares keys (pageUp/pageDown/home/end/enter/escape/...)\n\t// with editor and dialog bindings by design; the focus owner resolves them.\n\t\"tui.altScreen.pageUp\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: \"pageUp\",\n\t\tdescription: \"Scroll viewport up one page\",\n\t},\n\t\"tui.altScreen.pageDown\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: \"pageDown\",\n\t\tdescription: \"Scroll viewport down one page\",\n\t},\n\t\"tui.altScreen.halfPageUp\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: [],\n\t\tdescription: \"Scroll viewport up half a page\",\n\t},\n\t\"tui.altScreen.halfPageDown\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: [],\n\t\tdescription: \"Scroll viewport down half a page\",\n\t},\n\t\"tui.altScreen.lineUp\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: [],\n\t\tdescription: \"Scroll viewport up one line\",\n\t},\n\t\"tui.altScreen.lineDown\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: [],\n\t\tdescription: \"Scroll viewport down one line\",\n\t},\n\t\"tui.altScreen.previousPrompt\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: [\"ctrl+shift+up\", \"ctrl+up\"],\n\t\tdescription: \"Jump to previous semantic prompt\",\n\t},\n\t\"tui.altScreen.nextPrompt\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: [\"ctrl+shift+down\", \"ctrl+down\"],\n\t\tdescription: \"Jump to next semantic prompt\",\n\t},\n\t\"tui.altScreen.search\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: \"ctrl+shift+f\",\n\t\tdescription: \"Search the primary scroll view\",\n\t},\n\t\"tui.altScreen.searchNext\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: [\"enter\", \"ctrl+g\"],\n\t\tdescription: \"Select the next search match\",\n\t},\n\t\"tui.altScreen.searchPrevious\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: [\"shift+enter\", \"ctrl+shift+g\"],\n\t\tdescription: \"Select the previous search match\",\n\t},\n\t\"tui.altScreen.searchClose\": {\n\t\tcontext: \"transcript\",\n\t\tdefaultKeys: \"escape\",\n\t\tdescription: \"Close transcript search\",\n\t},\n\t\"tui.altScreen.top\": { context: \"transcript\", defaultKeys: \"home\", description: \"Scroll viewport to top\" },\n\t\"tui.altScreen.bottom\": { context: \"transcript\", defaultKeys: \"end\", description: \"Scroll viewport to bottom\" },\n} as const satisfies KeybindingDefinitions;\n\nexport interface KeybindingConflict {\n\tkey: KeyId;\n\tkeybindings: string[];\n}\n\n/**\n * Same key claimed by multiple bindings within one routing context. Unlike\n * {@link KeybindingConflict} (user overrides only), this covers resolved\n * bindings including defaults, so a conflict is visible at the declaration\n * site instead of being discovered at runtime.\n */\nexport interface KeybindingContextConflict {\n\tkey: KeyId;\n\tcontext: KeybindingContext;\n\tkeybindings: string[];\n}\n\nfunction normalizeKeys(keys: KeyId | KeyId[] | undefined): KeyId[] {\n\tif (keys === undefined) return [];\n\tconst keyList = Array.isArray(keys) ? keys : [keys];\n\tconst seen = new Set<KeyId>();\n\tconst result: KeyId[] = [];\n\tfor (const key of keyList) {\n\t\tif (!seen.has(key)) {\n\t\t\tseen.add(key);\n\t\t\tresult.push(key);\n\t\t}\n\t}\n\treturn result;\n}\n\nexport class KeybindingsManager {\n\tprivate definitions: KeybindingDefinitions;\n\tprivate userBindings: KeybindingsConfig;\n\tprivate keysById = new Map<Keybinding, KeyId[]>();\n\tprivate conflicts: KeybindingConflict[] = [];\n\n\tconstructor(definitions: KeybindingDefinitions, userBindings: KeybindingsConfig = {}) {\n\t\tthis.definitions = definitions;\n\t\tthis.userBindings = userBindings;\n\t\tthis.rebuild();\n\t}\n\n\tprivate rebuild(): void {\n\t\tthis.keysById.clear();\n\t\tthis.conflicts = [];\n\n\t\tconst userClaims = new Map<KeyId, Set<Keybinding>>();\n\t\tfor (const [keybinding, keys] of Object.entries(this.userBindings)) {\n\t\t\tif (!(keybinding in this.definitions)) continue;\n\t\t\tfor (const key of normalizeKeys(keys)) {\n\t\t\t\tconst claimants = userClaims.get(key) ?? new Set<Keybinding>();\n\t\t\t\tclaimants.add(keybinding as Keybinding);\n\t\t\t\tuserClaims.set(key, claimants);\n\t\t\t}\n\t\t}\n\n\t\tfor (const [key, keybindings] of userClaims) {\n\t\t\tif (keybindings.size > 1) {\n\t\t\t\tthis.conflicts.push({ key, keybindings: [...keybindings] });\n\t\t\t}\n\t\t}\n\n\t\tfor (const [id, definition] of Object.entries(this.definitions)) {\n\t\t\tconst userKeys = this.userBindings[id];\n\t\t\tconst keys = userKeys === undefined ? normalizeKeys(definition.defaultKeys) : normalizeKeys(userKeys);\n\t\t\tthis.keysById.set(id as Keybinding, keys);\n\t\t}\n\t}\n\n\tmatches(data: string, keybinding: Keybinding): boolean {\n\t\tconst keys = this.keysById.get(keybinding) ?? [];\n\t\tfor (const key of keys) {\n\t\t\tif (matchesKey(data, key)) return true;\n\t\t}\n\t\treturn false;\n\t}\n\n\tgetKeys(keybinding: Keybinding): KeyId[] {\n\t\treturn [...(this.keysById.get(keybinding) ?? [])];\n\t}\n\n\tgetDefinition(keybinding: Keybinding): KeybindingDefinition {\n\t\treturn this.definitions[keybinding];\n\t}\n\n\tgetConflicts(): KeybindingConflict[] {\n\t\treturn this.conflicts.map((conflict) => ({ ...conflict, keybindings: [...conflict.keybindings] }));\n\t}\n\n\t/**\n\t * Routing context declared for a binding. Extension bindings without a\n\t * declared context default to `global`.\n\t */\n\tgetContext(keybinding: Keybinding): KeybindingContext {\n\t\treturn this.definitions[keybinding]?.context ?? \"global\";\n\t}\n\n\t/** All binding ids declared for one routing context. */\n\tgetBindingsByContext(context: KeybindingContext): Keybinding[] {\n\t\tconst result: Keybinding[] = [];\n\t\tfor (const id of Object.keys(this.definitions)) {\n\t\t\tif (this.getContext(id as Keybinding) === context) {\n\t\t\t\tresult.push(id as Keybinding);\n\t\t\t}\n\t\t}\n\t\treturn result;\n\t}\n\n\t/**\n\t * Same-key claims within a single routing context across resolved bindings\n\t * (defaults plus user overrides). Cross-context sharing (e.g. `enter` for\n\t * both editor submit and dialog confirm) is intentional and resolved by the\n\t * focus owner, so it is not reported here.\n\t */\n\tgetContextConflicts(): KeybindingContextConflict[] {\n\t\tconst claims = new Map<KeyId, Map<KeybindingContext, Set<string>>>();\n\t\tfor (const [id, keys] of this.keysById) {\n\t\t\tconst context = this.getContext(id);\n\t\t\tfor (const key of keys) {\n\t\t\t\tlet byContext = claims.get(key);\n\t\t\t\tif (!byContext) {\n\t\t\t\t\tbyContext = new Map<KeybindingContext, Set<string>>();\n\t\t\t\t\tclaims.set(key, byContext);\n\t\t\t\t}\n\t\t\t\tlet keybindings = byContext.get(context);\n\t\t\t\tif (!keybindings) {\n\t\t\t\t\tkeybindings = new Set<string>();\n\t\t\t\t\tbyContext.set(context, keybindings);\n\t\t\t\t}\n\t\t\t\tkeybindings.add(id);\n\t\t\t}\n\t\t}\n\t\tconst conflicts: KeybindingContextConflict[] = [];\n\t\tfor (const [key, byContext] of claims) {\n\t\t\tfor (const [context, keybindings] of byContext) {\n\t\t\t\tif (keybindings.size > 1) {\n\t\t\t\t\tconflicts.push({ key, context, keybindings: [...keybindings].sort() });\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tconflicts.sort((a, b) => a.context.localeCompare(b.context) || a.key.localeCompare(b.key));\n\t\treturn conflicts;\n\t}\n\n\tsetUserBindings(userBindings: KeybindingsConfig): void {\n\t\tthis.userBindings = userBindings;\n\t\tthis.rebuild();\n\t}\n\n\tgetUserBindings(): KeybindingsConfig {\n\t\treturn { ...this.userBindings };\n\t}\n\n\tgetResolvedBindings(): KeybindingsConfig {\n\t\tconst resolved: KeybindingsConfig = {};\n\t\tfor (const id of Object.keys(this.definitions)) {\n\t\t\tconst keys = this.keysById.get(id as Keybinding) ?? [];\n\t\t\tresolved[id] = keys.length === 1 ? keys[0]! : [...keys];\n\t\t}\n\t\treturn resolved;\n\t}\n}\n\nlet globalKeybindings: KeybindingsManager | null = null;\n\nexport function setKeybindings(keybindings: KeybindingsManager): void {\n\tglobalKeybindings = keybindings;\n}\n\nexport function getKeybindings(): KeybindingsManager {\n\tif (!globalKeybindings) {\n\t\tglobalKeybindings = new KeybindingsManager(TUI_KEYBINDINGS);\n\t}\n\treturn globalKeybindings;\n}\n"]}

package/dist/keys.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Keyboard input handling for terminal applications.
+ *
+ * Supports both legacy terminal sequences and Kitty keyboard protocol.
+ * See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/
+ * Reference: https://github.com/sst/opentui/blob/7da92b4088aebfe27b9f691c04163a48821e49fd/packages/core/src/lib/parse.keypress.ts
+ *
+ * Symbol keys are also supported, however some ctrl+symbol combos
+ * overlap with ASCII codes, e.g. ctrl+[ = ESC.
+ * See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/#legacy-ctrl-mapping-of-ascii-keys
+ * Those can still be * used for ctrl+shift combos
+ *
+ * API:
+ * - matchesKey(data, keyId) - Check if input matches a key identifier
+ * - parseKey(data) - Parse input and return the key identifier
+ * - Key - Helper object for creating typed key identifiers
+ * - setKittyProtocolActive(active) - Set global Kitty protocol state
+ * - isKittyProtocolActive() - Query global Kitty protocol state
+ */
+/**
+ * Set the global Kitty keyboard protocol state.
+ * Called by ProcessTerminal after detecting protocol support.
+ */
+export declare function setKittyProtocolActive(active: boolean): void;
+/**
+ * Query whether Kitty keyboard protocol is currently active.
+ */
+export declare function isKittyProtocolActive(): boolean;
+type Letter = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z";
+type Digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9";
+type SymbolKey = "`" | "-" | "=" | "[" | "]" | "\\" | ";" | "'" | "," | "." | "/" | "!" | "@" | "#" | "$" | "%" | "^" | "&" | "*" | "(" | ")" | "_" | "+" | "|" | "~" | "{" | "}" | ":" | "<" | ">" | "?";
+type SpecialKey = "escape" | "esc" | "enter" | "return" | "tab" | "space" | "backspace" | "delete" | "insert" | "clear" | "home" | "end" | "pageUp" | "pageDown" | "up" | "down" | "left" | "right" | "f1" | "f2" | "f3" | "f4" | "f5" | "f6" | "f7" | "f8" | "f9" | "f10" | "f11" | "f12";
+type BaseKey = Letter | Digit | SymbolKey | SpecialKey;
+type ModifierName = "ctrl" | "shift" | "alt" | "super";
+type ModifiedKeyId<Key extends string, RemainingModifiers extends ModifierName = ModifierName> = {
+    [M in RemainingModifiers]: `${M}+${Key}` | `${M}+${ModifiedKeyId<Key, Exclude<RemainingModifiers, M>>}`;
+}[RemainingModifiers];
+/**
+ * Union type of all valid key identifiers.
+ * Provides autocomplete and catches typos at compile time.
+ */
+export type KeyId = BaseKey | ModifiedKeyId<BaseKey>;
+/**
+ * Helper object for creating typed key identifiers with autocomplete.
+ *
+ * Usage:
+ * - Key.escape, Key.enter, Key.tab, etc. for special keys
+ * - Key.backtick, Key.comma, Key.period, etc. for symbol keys
+ * - Key.ctrl("c"), Key.alt("x"), Key.super("k") for single modifiers
+ * - Key.ctrlShift("p"), Key.ctrlAlt("x"), Key.ctrlSuper("k") for combined modifiers
+ */
+export declare const Key: {
+    readonly escape: "escape";
+    readonly esc: "esc";
+    readonly enter: "enter";
+    readonly return: "return";
+    readonly tab: "tab";
+    readonly space: "space";
+    readonly backspace: "backspace";
+    readonly delete: "delete";
+    readonly insert: "insert";
+    readonly clear: "clear";
+    readonly home: "home";
+    readonly end: "end";
+    readonly pageUp: "pageUp";
+    readonly pageDown: "pageDown";
+    readonly up: "up";
+    readonly down: "down";
+    readonly left: "left";
+    readonly right: "right";
+    readonly f1: "f1";
+    readonly f2: "f2";
+    readonly f3: "f3";
+    readonly f4: "f4";
+    readonly f5: "f5";
+    readonly f6: "f6";
+    readonly f7: "f7";
+    readonly f8: "f8";
+    readonly f9: "f9";
+    readonly f10: "f10";
+    readonly f11: "f11";
+    readonly f12: "f12";
+    readonly backtick: "`";
+    readonly hyphen: "-";
+    readonly equals: "=";
+    readonly leftbracket: "[";
+    readonly rightbracket: "]";
+    readonly backslash: "\\";
+    readonly semicolon: ";";
+    readonly quote: "'";
+    readonly comma: ",";
+    readonly period: ".";
+    readonly slash: "/";
+    readonly exclamation: "!";
+    readonly at: "@";
+    readonly hash: "#";
+    readonly dollar: "$";
+    readonly percent: "%";
+    readonly caret: "^";
+    readonly ampersand: "&";
+    readonly asterisk: "*";
+    readonly leftparen: "(";
+    readonly rightparen: ")";
+    readonly underscore: "_";
+    readonly plus: "+";
+    readonly pipe: "|";
+    readonly tilde: "~";
+    readonly leftbrace: "{";
+    readonly rightbrace: "}";
+    readonly colon: ":";
+    readonly lessthan: "<";
+    readonly greaterthan: ">";
+    readonly question: "?";
+    readonly ctrl: <K extends BaseKey>(key: K) => `ctrl+${K}`;
+    readonly shift: <K extends BaseKey>(key: K) => `shift+${K}`;
+    readonly alt: <K extends BaseKey>(key: K) => `alt+${K}`;
+    readonly super: <K extends BaseKey>(key: K) => `super+${K}`;
+    readonly ctrlShift: <K extends BaseKey>(key: K) => `ctrl+shift+${K}`;
+    readonly shiftCtrl: <K extends BaseKey>(key: K) => `shift+ctrl+${K}`;
+    readonly ctrlAlt: <K extends BaseKey>(key: K) => `ctrl+alt+${K}`;
+    readonly altCtrl: <K extends BaseKey>(key: K) => `alt+ctrl+${K}`;
+    readonly shiftAlt: <K extends BaseKey>(key: K) => `shift+alt+${K}`;
+    readonly altShift: <K extends BaseKey>(key: K) => `alt+shift+${K}`;
+    readonly ctrlSuper: <K extends BaseKey>(key: K) => `ctrl+super+${K}`;
+    readonly superCtrl: <K extends BaseKey>(key: K) => `super+ctrl+${K}`;
+    readonly shiftSuper: <K extends BaseKey>(key: K) => `shift+super+${K}`;
+    readonly superShift: <K extends BaseKey>(key: K) => `super+shift+${K}`;
+    readonly altSuper: <K extends BaseKey>(key: K) => `alt+super+${K}`;
+    readonly superAlt: <K extends BaseKey>(key: K) => `super+alt+${K}`;
+    readonly ctrlShiftAlt: <K extends BaseKey>(key: K) => `ctrl+shift+alt+${K}`;
+    readonly ctrlShiftSuper: <K extends BaseKey>(key: K) => `ctrl+shift+super+${K}`;
+};
+/**
+ * Event types from Kitty keyboard protocol (flag 2)
+ * 1 = key press, 2 = key repeat, 3 = key release
+ */
+export type KeyEventType = "press" | "repeat" | "release";
+/**
+ * Check if the last parsed key event was a key release.
+ * Only meaningful when Kitty keyboard protocol with flag 2 is active.
+ */
+export declare function isKeyRelease(data: string): boolean;
+/**
+ * Check if the last parsed key event was a key repeat.
+ * Only meaningful when Kitty keyboard protocol with flag 2 is active.
+ */
+export declare function isKeyRepeat(data: string): boolean;
+/**
+ * Match input data against a key identifier string.
+ *
+ * Supported key identifiers:
+ * - Single keys: "escape", "tab", "enter", "backspace", "delete", "home", "end", "space"
+ * - Arrow keys: "up", "down", "left", "right"
+ * - Ctrl combinations: "ctrl+c", "ctrl+z", etc.
+ * - Shift combinations: "shift+tab", "shift+enter"
+ * - Alt combinations: "alt+enter", "alt+backspace"
+ * - Super combinations: "super+k", "super+enter"
+ * - Combined modifiers: "shift+ctrl+p", "ctrl+alt+x", "ctrl+super+k"
+ *
+ * Use the Key helper for autocomplete: Key.ctrl("c"), Key.escape, Key.ctrlShift("p"), Key.super("k")
+ *
+ * @param data - Raw input data from terminal
+ * @param keyId - Key identifier (e.g., "ctrl+c", "escape", Key.ctrl("c"))
+ */
+export declare function matchesKey(data: string, keyId: KeyId): boolean;
+export declare function parseKey(data: string): string | undefined;
+/**
+ * Decode a Kitty CSI-u sequence into a printable character, if applicable.
+ *
+ * When Kitty keyboard protocol flag 1 (disambiguate) is active, terminals send
+ * CSI-u sequences for all keys, including plain printable characters. This
+ * function extracts the printable character from such sequences.
+ *
+ * Only accepts plain or Shift-modified keys. Rejects Ctrl, Alt, and unsupported
+ * modifier combinations (those are handled by keybinding matching instead).
+ * Prefers the shifted keycode when Shift is held and a shifted key is reported.
+ *
+ * @param data - Raw input data from terminal
+ * @returns The printable character, or undefined if not a printable CSI-u sequence
+ */
+export declare function decodeKittyPrintable(data: string): string | undefined;
+export declare function decodePrintableKey(data: string): string | undefined;
+export {};
+//# sourceMappingURL=keys.d.ts.map