@m4ike1/ion-tui 0.1.0

package/dist/keybindings.d.ts

@@ -0,0 +1,366 @@
+import { type KeyId } from "./keys.ts";
+/**
+ * Global keybinding registry.
+ * Downstream packages can add keybindings via declaration merging.
+ */
+export interface Keybindings {
+    "tui.editor.cursorUp": true;
+    "tui.editor.cursorDown": true;
+    "tui.editor.historyPrevious": true;
+    "tui.editor.historyNext": true;
+    "tui.editor.cursorLeft": true;
+    "tui.editor.cursorRight": true;
+    "tui.editor.cursorWordLeft": true;
+    "tui.editor.cursorWordRight": true;
+    "tui.editor.cursorLineStart": true;
+    "tui.editor.cursorLineEnd": true;
+    "tui.editor.jumpForward": true;
+    "tui.editor.jumpBackward": true;
+    "tui.editor.pageUp": true;
+    "tui.editor.pageDown": true;
+    "tui.editor.deleteCharBackward": true;
+    "tui.editor.deleteCharForward": true;
+    "tui.editor.deleteWordBackward": true;
+    "tui.editor.deleteWordForward": true;
+    "tui.editor.deleteToLineStart": true;
+    "tui.editor.deleteToLineEnd": true;
+    "tui.editor.yank": true;
+    "tui.editor.yankPop": true;
+    "tui.editor.undo": true;
+    "tui.input.newLine": true;
+    "tui.input.submit": true;
+    "tui.input.tab": true;
+    "tui.input.copy": true;
+    "tui.select.up": true;
+    "tui.select.down": true;
+    "tui.select.pageUp": true;
+    "tui.select.pageDown": true;
+    "tui.select.confirm": true;
+    "tui.select.cancel": true;
+    "tui.altScreen.pageUp": true;
+    "tui.altScreen.pageDown": true;
+    "tui.altScreen.halfPageUp": true;
+    "tui.altScreen.halfPageDown": true;
+    "tui.altScreen.lineUp": true;
+    "tui.altScreen.lineDown": true;
+    "tui.altScreen.previousPrompt": true;
+    "tui.altScreen.nextPrompt": true;
+    "tui.altScreen.search": true;
+    "tui.altScreen.searchNext": true;
+    "tui.altScreen.searchPrevious": true;
+    "tui.altScreen.searchClose": true;
+    "tui.altScreen.top": true;
+    "tui.altScreen.bottom": true;
+}
+export type Keybinding = keyof Keybindings;
+/**
+ * Routing context for a keybinding.
+ *
+ * - `global`: active regardless of focus. Reserved for downstream app bindings;
+ *   no stock `tui.*` binding uses it.
+ * - `transcript`: fullscreen viewport navigation. Consumed by the viewport input
+ *   listener before the focused component sees the key.
+ * - `editor`: prompt editing. Handled by the focused editor.
+ * - `dialog`: selection lists and modal prompts. Handled by the focused overlay.
+ *
+ * Same-key claims across different contexts are intentional sharing, resolved by
+ * the single focus owner. Same-key claims within one context are reported by
+ * {@link KeybindingsManager.getContextConflicts}.
+ */
+export type KeybindingContext = "global" | "transcript" | "editor" | "dialog";
+export interface KeybindingDefinition {
+    defaultKeys: KeyId | KeyId[];
+    description?: string;
+    /**
+     * Routing context for this binding. Required on every stock `tui.*` binding
+     * (enforced by test); optional for downstream extension bindings, which
+     * default to `global` when omitted.
+     */
+    context?: KeybindingContext;
+}
+export type KeybindingDefinitions = Record<string, KeybindingDefinition>;
+export type KeybindingsConfig = Record<string, KeyId | KeyId[] | undefined>;
+export declare const TUI_KEYBINDINGS: {
+    readonly "tui.editor.cursorUp": {
+        readonly context: "editor";
+        readonly defaultKeys: "up";
+        readonly description: "Move cursor up";
+    };
+    readonly "tui.editor.cursorDown": {
+        readonly context: "editor";
+        readonly defaultKeys: "down";
+        readonly description: "Move cursor down";
+    };
+    readonly "tui.editor.historyPrevious": {
+        readonly context: "editor";
+        readonly defaultKeys: [];
+        readonly description: "Select previous prompt history entry";
+    };
+    readonly "tui.editor.historyNext": {
+        readonly context: "editor";
+        readonly defaultKeys: [];
+        readonly description: "Select next prompt history entry";
+    };
+    readonly "tui.editor.cursorLeft": {
+        readonly context: "editor";
+        readonly defaultKeys: ["left", "ctrl+b"];
+        readonly description: "Move cursor left";
+    };
+    readonly "tui.editor.cursorRight": {
+        readonly context: "editor";
+        readonly defaultKeys: ["right", "ctrl+f"];
+        readonly description: "Move cursor right";
+    };
+    readonly "tui.editor.cursorWordLeft": {
+        readonly context: "editor";
+        readonly defaultKeys: ["alt+left", "ctrl+left", "alt+b"];
+        readonly description: "Move cursor word left";
+    };
+    readonly "tui.editor.cursorWordRight": {
+        readonly context: "editor";
+        readonly defaultKeys: ["alt+right", "ctrl+right", "alt+f"];
+        readonly description: "Move cursor word right";
+    };
+    readonly "tui.editor.cursorLineStart": {
+        readonly context: "editor";
+        readonly defaultKeys: ["home", "ctrl+home", "ctrl+a"];
+        readonly description: "Move to line start";
+    };
+    readonly "tui.editor.cursorLineEnd": {
+        readonly context: "editor";
+        readonly defaultKeys: ["end", "ctrl+end", "ctrl+e"];
+        readonly description: "Move to line end";
+    };
+    readonly "tui.editor.jumpForward": {
+        readonly context: "editor";
+        readonly defaultKeys: "ctrl+]";
+        readonly description: "Jump forward to character";
+    };
+    readonly "tui.editor.jumpBackward": {
+        readonly context: "editor";
+        readonly defaultKeys: "ctrl+alt+]";
+        readonly description: "Jump backward to character";
+    };
+    readonly "tui.editor.pageUp": {
+        readonly context: "editor";
+        readonly defaultKeys: ["pageUp", "ctrl+pageUp"];
+        readonly description: "Page up";
+    };
+    readonly "tui.editor.pageDown": {
+        readonly context: "editor";
+        readonly defaultKeys: ["pageDown", "ctrl+pageDown"];
+        readonly description: "Page down";
+    };
+    readonly "tui.editor.deleteCharBackward": {
+        readonly context: "editor";
+        readonly defaultKeys: "backspace";
+        readonly description: "Delete character backward";
+    };
+    readonly "tui.editor.deleteCharForward": {
+        readonly context: "editor";
+        readonly defaultKeys: ["delete", "ctrl+d"];
+        readonly description: "Delete character forward";
+    };
+    readonly "tui.editor.deleteWordBackward": {
+        readonly context: "editor";
+        readonly defaultKeys: ["ctrl+w", "alt+backspace"];
+        readonly description: "Delete word backward";
+    };
+    readonly "tui.editor.deleteWordForward": {
+        readonly context: "editor";
+        readonly defaultKeys: ["alt+d", "alt+delete"];
+        readonly description: "Delete word forward";
+    };
+    readonly "tui.editor.deleteToLineStart": {
+        readonly context: "editor";
+        readonly defaultKeys: "ctrl+u";
+        readonly description: "Delete to line start";
+    };
+    readonly "tui.editor.deleteToLineEnd": {
+        readonly context: "editor";
+        readonly defaultKeys: "ctrl+k";
+        readonly description: "Delete to line end";
+    };
+    readonly "tui.editor.yank": {
+        readonly context: "editor";
+        readonly defaultKeys: "ctrl+y";
+        readonly description: "Yank";
+    };
+    readonly "tui.editor.yankPop": {
+        readonly context: "editor";
+        readonly defaultKeys: "alt+y";
+        readonly description: "Yank pop";
+    };
+    readonly "tui.editor.undo": {
+        readonly context: "editor";
+        readonly defaultKeys: "ctrl+-";
+        readonly description: "Undo";
+    };
+    readonly "tui.input.newLine": {
+        readonly context: "editor";
+        readonly defaultKeys: ["shift+enter", "ctrl+j"];
+        readonly description: "Insert newline";
+    };
+    readonly "tui.input.submit": {
+        readonly context: "editor";
+        readonly defaultKeys: "enter";
+        readonly description: "Submit input";
+    };
+    readonly "tui.input.tab": {
+        readonly context: "editor";
+        readonly defaultKeys: "tab";
+        readonly description: "Tab / autocomplete";
+    };
+    readonly "tui.input.copy": {
+        readonly context: "editor";
+        readonly defaultKeys: "ctrl+c";
+        readonly description: "Copy selection";
+    };
+    readonly "tui.select.up": {
+        readonly context: "dialog";
+        readonly defaultKeys: "up";
+        readonly description: "Move selection up";
+    };
+    readonly "tui.select.down": {
+        readonly context: "dialog";
+        readonly defaultKeys: "down";
+        readonly description: "Move selection down";
+    };
+    readonly "tui.select.pageUp": {
+        readonly context: "dialog";
+        readonly defaultKeys: "pageUp";
+        readonly description: "Selection page up";
+    };
+    readonly "tui.select.pageDown": {
+        readonly context: "dialog";
+        readonly defaultKeys: "pageDown";
+        readonly description: "Selection page down";
+    };
+    readonly "tui.select.confirm": {
+        readonly context: "dialog";
+        readonly defaultKeys: "enter";
+        readonly description: "Confirm selection";
+    };
+    readonly "tui.select.cancel": {
+        readonly context: "dialog";
+        readonly defaultKeys: ["escape", "ctrl+c"];
+        readonly description: "Cancel selection";
+    };
+    readonly "tui.altScreen.pageUp": {
+        readonly context: "transcript";
+        readonly defaultKeys: "pageUp";
+        readonly description: "Scroll viewport up one page";
+    };
+    readonly "tui.altScreen.pageDown": {
+        readonly context: "transcript";
+        readonly defaultKeys: "pageDown";
+        readonly description: "Scroll viewport down one page";
+    };
+    readonly "tui.altScreen.halfPageUp": {
+        readonly context: "transcript";
+        readonly defaultKeys: [];
+        readonly description: "Scroll viewport up half a page";
+    };
+    readonly "tui.altScreen.halfPageDown": {
+        readonly context: "transcript";
+        readonly defaultKeys: [];
+        readonly description: "Scroll viewport down half a page";
+    };
+    readonly "tui.altScreen.lineUp": {
+        readonly context: "transcript";
+        readonly defaultKeys: [];
+        readonly description: "Scroll viewport up one line";
+    };
+    readonly "tui.altScreen.lineDown": {
+        readonly context: "transcript";
+        readonly defaultKeys: [];
+        readonly description: "Scroll viewport down one line";
+    };
+    readonly "tui.altScreen.previousPrompt": {
+        readonly context: "transcript";
+        readonly defaultKeys: ["ctrl+shift+up", "ctrl+up"];
+        readonly description: "Jump to previous semantic prompt";
+    };
+    readonly "tui.altScreen.nextPrompt": {
+        readonly context: "transcript";
+        readonly defaultKeys: ["ctrl+shift+down", "ctrl+down"];
+        readonly description: "Jump to next semantic prompt";
+    };
+    readonly "tui.altScreen.search": {
+        readonly context: "transcript";
+        readonly defaultKeys: "ctrl+shift+f";
+        readonly description: "Search the primary scroll view";
+    };
+    readonly "tui.altScreen.searchNext": {
+        readonly context: "transcript";
+        readonly defaultKeys: ["enter", "ctrl+g"];
+        readonly description: "Select the next search match";
+    };
+    readonly "tui.altScreen.searchPrevious": {
+        readonly context: "transcript";
+        readonly defaultKeys: ["shift+enter", "ctrl+shift+g"];
+        readonly description: "Select the previous search match";
+    };
+    readonly "tui.altScreen.searchClose": {
+        readonly context: "transcript";
+        readonly defaultKeys: "escape";
+        readonly description: "Close transcript search";
+    };
+    readonly "tui.altScreen.top": {
+        readonly context: "transcript";
+        readonly defaultKeys: "home";
+        readonly description: "Scroll viewport to top";
+    };
+    readonly "tui.altScreen.bottom": {
+        readonly context: "transcript";
+        readonly defaultKeys: "end";
+        readonly description: "Scroll viewport to bottom";
+    };
+};
+export interface KeybindingConflict {
+    key: KeyId;
+    keybindings: string[];
+}
+/**
+ * Same key claimed by multiple bindings within one routing context. Unlike
+ * {@link KeybindingConflict} (user overrides only), this covers resolved
+ * bindings including defaults, so a conflict is visible at the declaration
+ * site instead of being discovered at runtime.
+ */
+export interface KeybindingContextConflict {
+    key: KeyId;
+    context: KeybindingContext;
+    keybindings: string[];
+}
+export declare class KeybindingsManager {
+    private definitions;
+    private userBindings;
+    private keysById;
+    private conflicts;
+    constructor(definitions: KeybindingDefinitions, userBindings?: KeybindingsConfig);
+    private rebuild;
+    matches(data: string, keybinding: Keybinding): boolean;
+    getKeys(keybinding: Keybinding): KeyId[];
+    getDefinition(keybinding: Keybinding): KeybindingDefinition;
+    getConflicts(): KeybindingConflict[];
+    /**
+     * Routing context declared for a binding. Extension bindings without a
+     * declared context default to `global`.
+     */
+    getContext(keybinding: Keybinding): KeybindingContext;
+    /** All binding ids declared for one routing context. */
+    getBindingsByContext(context: KeybindingContext): Keybinding[];
+    /**
+     * 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(): KeybindingContextConflict[];
+    setUserBindings(userBindings: KeybindingsConfig): void;
+    getUserBindings(): KeybindingsConfig;
+    getResolvedBindings(): KeybindingsConfig;
+}
+export declare function setKeybindings(keybindings: KeybindingsManager): void;
+export declare function getKeybindings(): KeybindingsManager;
+//# sourceMappingURL=keybindings.d.ts.map

package/dist/keybindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keybindings.d.ts","sourceRoot":"","sources":["../src/keybindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAc,MAAM,WAAW,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAE3B,qBAAqB,EAAE,IAAI,CAAC;IAC5B,uBAAuB,EAAE,IAAI,CAAC;IAC9B,4BAA4B,EAAE,IAAI,CAAC;IACnC,wBAAwB,EAAE,IAAI,CAAC;IAC/B,uBAAuB,EAAE,IAAI,CAAC;IAC9B,wBAAwB,EAAE,IAAI,CAAC;IAC/B,2BAA2B,EAAE,IAAI,CAAC;IAClC,4BAA4B,EAAE,IAAI,CAAC;IACnC,4BAA4B,EAAE,IAAI,CAAC;IACnC,0BAA0B,EAAE,IAAI,CAAC;IACjC,wBAAwB,EAAE,IAAI,CAAC;IAC/B,yBAAyB,EAAE,IAAI,CAAC;IAChC,mBAAmB,EAAE,IAAI,CAAC;IAC1B,qBAAqB,EAAE,IAAI,CAAC;IAC5B,+BAA+B,EAAE,IAAI,CAAC;IACtC,8BAA8B,EAAE,IAAI,CAAC;IACrC,+BAA+B,EAAE,IAAI,CAAC;IACtC,8BAA8B,EAAE,IAAI,CAAC;IACrC,8BAA8B,EAAE,IAAI,CAAC;IACrC,4BAA4B,EAAE,IAAI,CAAC;IACnC,iBAAiB,EAAE,IAAI,CAAC;IACxB,oBAAoB,EAAE,IAAI,CAAC;IAC3B,iBAAiB,EAAE,IAAI,CAAC;IAExB,mBAAmB,EAAE,IAAI,CAAC;IAC1B,kBAAkB,EAAE,IAAI,CAAC;IACzB,eAAe,EAAE,IAAI,CAAC;IACtB,gBAAgB,EAAE,IAAI,CAAC;IAEvB,eAAe,EAAE,IAAI,CAAC;IACtB,iBAAiB,EAAE,IAAI,CAAC;IACxB,mBAAmB,EAAE,IAAI,CAAC;IAC1B,qBAAqB,EAAE,IAAI,CAAC;IAC5B,oBAAoB,EAAE,IAAI,CAAC;IAC3B,mBAAmB,EAAE,IAAI,CAAC;IAE1B,sBAAsB,EAAE,IAAI,CAAC;IAC7B,wBAAwB,EAAE,IAAI,CAAC;IAC/B,0BAA0B,EAAE,IAAI,CAAC;IACjC,4BAA4B,EAAE,IAAI,CAAC;IACnC,sBAAsB,EAAE,IAAI,CAAC;IAC7B,wBAAwB,EAAE,IAAI,CAAC;IAC/B,8BAA8B,EAAE,IAAI,CAAC;IACrC,0BAA0B,EAAE,IAAI,CAAC;IACjC,sBAAsB,EAAE,IAAI,CAAC;IAC7B,0BAA0B,EAAE,IAAI,CAAC;IACjC,8BAA8B,EAAE,IAAI,CAAC;IACrC,2BAA2B,EAAE,IAAI,CAAC;IAClC,mBAAmB,EAAE,IAAI,CAAC;IAC1B,sBAAsB,EAAE,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACpC,WAAW,EAAE,KAAK,GAAG,KAAK,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AACzE,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,SAAS,CAAC,CAAC;AAE5E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyLc,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IAClC,GAAG,EAAE,KAAK,CAAC;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACzC,GAAG,EAAE,KAAK,CAAC;IACX,OAAO,EAAE,iBAAiB,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB;AAgBD,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,SAAS,CAA4B;IAE7C,YAAY,WAAW,EAAE,qBAAqB,EAAE,YAAY,GAAE,iBAAsB,EAInF;IAED,OAAO,CAAC,OAAO;IA2Bf,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAMrD;IAED,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,EAAE,CAEvC;IAED,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,oBAAoB,CAE1D;IAED,YAAY,IAAI,kBAAkB,EAAE,CAEnC;IAED;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,iBAAiB,CAEpD;IAED,wDAAwD;IACxD,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,EAAE,CAQ7D;IAED;;;;;OAKG;IACH,mBAAmB,IAAI,yBAAyB,EAAE,CA4BjD;IAED,eAAe,CAAC,YAAY,EAAE,iBAAiB,GAAG,IAAI,CAGrD;IAED,eAAe,IAAI,iBAAiB,CAEnC;IAED,mBAAmB,IAAI,iBAAiB,CAOvC;CACD;AAID,wBAAgB,cAAc,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAEpE;AAED,wBAAgB,cAAc,IAAI,kBAAkB,CAKnD","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"]}