@crouton-kit/crouter 0.3.70 → 0.3.78

package/dist/core/keybindings/__tests__/resolve.test.js

@@ -0,0 +1,224 @@
+import { after, before, beforeEach, test } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { BINDING_CATALOG, KeybindingConcurrentEditError, KeybindingValidationError, SAFETY_REQUIREMENTS, canonicalTerminalStroke, formatStroke, matchesTerminalInput, normalizeGesture, normalizeSparseOverrides, persistUserKeybindings, resolveKeybindings, resolveUserKeybindings, } from '../index.js';
+import { readConfig } from '../../config.js';
+const typeCheckedBindingId = 'crtr.graph.down';
+// @ts-expect-error The catalog type rejects IDs that are not built in.
+const rejectedBindingId = 'crtr.graph.not-real';
+void typeCheckedBindingId;
+void rejectedBindingId;
+function ids(prefix, actions) {
+    return actions.map((action) => `${prefix}.${action}`);
+}
+const REQUIRED_IDS = [
+    ...ids('crtr.tmux.menu', ['open', 'promote', 'resume', 'demote', 'detach', 'close-subtree', 'context', 'graph', 'focus-manager', 'issues']),
+    ...ids('crtr.tmux.menu.issue', ['idea', 'bug']),
+    ...ids('crtr.tmux.node', ['next', 'previous']),
+    ...ids('crtr.tmux.view', ['next', 'previous']),
+    ...ids('crtr.attach', ['detach', 'clear-or-detach', 'graph.toggle', 'model-ladder.next']),
+    'crtr.mode.cycle',
+    ...ids('crtr.graph', ['down', 'up', 'first', 'last', 'collapse-or-manager', 'expand-or-child', 'focus', 'focus-manager', 'close-subtree', 'dismiss']),
+    ...ids('crtr.graph.confirm', ['accept', 'cancel']),
+    ...ids('crtr.view.host', ['force-quit', 'editor.backspace']),
+    ...ids('crtr.view.canvas', ['down', 'up', 'refresh', 'quit']),
+    ...ids('crtr.view.chat', ['submit', 'contextual-cancel', 'reconnect', 'request-control', 'release-control', 'quit']),
+    ...ids('crtr.view.git-pr', ['down', 'up', 'refresh', 'quit']),
+    ...ids('crtr.view.inbox', ['down', 'up', 'open', 'reply', 'react', 'filter', 'refresh', 'connect-linkedin', 'connect-gmail', 'quit', 'submit-reply', 'cancel', 'reaction-previous', 'reaction-next', 'submit-reaction']),
+    ...ids('crtr.view.linkedin', ['down', 'up', 'open', 'reply', 'react', 'refresh', 'quit', 'submit-reply', 'cancel', 'reaction-previous', 'reaction-next', 'submit-reaction']),
+    ...ids('crtr.view.prompt-review', ['down', 'up', 'compare-previous', 'compare-next', 'toggle-mode', 'expand', 'export', 'refresh', 'quit']),
+    ...ids('crtr.view.settings', ['down', 'up', 'cell-previous', 'cell-next', 'refresh', 'quit', 'edit-or-submit', 'cancel-edit']),
+    ...ids('crtr.view.workspace-sidebar', ['down', 'up', 'open', 'refresh', 'quit']),
+    ...ids('crtr.view-picker', ['down', 'up', 'run', 'quit']),
+    ...ids('crtr.browse', ['quit', 'down', 'up', 'first', 'last', 'expand-or-child', 'collapse-or-parent', 'toggle-fold', 'tab-next', 'tab-previous', 'tab.1', 'tab.2', 'tab.3', 'tab.4', 'close-subtree', 'confirm-close', 'sort', 'scope', 'residents', 'preview', 'search', 'revive-now', 'focus']),
+    ...ids('crtr.browse.search', ['cancel', 'commit', 'delete', 'quit']),
+    ...ids('crtr.profile.menu', ['up', 'down', 'select', 'accept-default', 'abort', 'slot.1', 'slot.2', 'slot.3', 'slot.4', 'slot.5', 'slot.6', 'slot.7', 'slot.8', 'slot.9', 'create', 'search-existing', 'use-root', 'set-default', 'add-directory', 'unpin']),
+    ...ids('crtr.profile.search', ['up', 'down', 'pick', 'back', 'delete', 'abort']),
+    ...ids('crtr.setup', ['cancel', 'tab-next', 'tab-previous', 'open', 'list-down', 'list-up', 'toggle', 'details', 'advance']),
+    ...ids('crtr.setup.confirm', ['accept', 'back']),
+    ...ids('crtr.setup.keybindings', ['edit', 'commit-edit', 'cancel-edit', 'unbind', 'reset-row', 'reset-all', 'save', 'discard', 'page-up', 'page-down', 'filter', 'filter-delete', 'filter-clear']),
+];
+let home;
+let realHome;
+let realCwd;
+before(() => {
+    realHome = process.env['HOME'];
+    realCwd = process.cwd();
+});
+beforeEach(() => {
+    home = mkdtempSync(join(tmpdir(), 'crtr-keybindings-'));
+    process.env['HOME'] = home;
+    process.chdir(realCwd);
+});
+after(() => {
+    process.chdir(realCwd);
+    if (realHome === undefined)
+        delete process.env['HOME'];
+    else
+        process.env['HOME'] = realHome;
+});
+test.afterEach(() => rmSync(home, { recursive: true, force: true }));
+test('catalog is closed, complete, ordered, and has valid collision-free defaults', () => {
+    const actualIds = BINDING_CATALOG.map((definition) => definition.id);
+    assert.deepEqual(actualIds, REQUIRED_IDS);
+    assert.equal(actualIds.length, REQUIRED_IDS.length);
+    assert.equal(new Set(actualIds).size, actualIds.length);
+    for (const definition of BINDING_CATALOG) {
+        assert.match(definition.id, /^crtr\.[a-z0-9.-]+$/);
+        assert.ok(definition.name.length > 0);
+        assert.ok(definition.description.length > 0);
+        assert.ok(definition.contexts.length > 0);
+        for (const gesture of definition.defaults)
+            assert.equal(normalizeGesture(gesture, definition), gesture);
+    }
+    const resolved = resolveKeybindings();
+    assert.equal(resolved.bindings.size, BINDING_CATALOG.length);
+    assert.deepEqual(resolved.diagnostics, []);
+    assert.ok(SAFETY_REQUIREMENTS.length > 0);
+});
+test('normalizes aliases, modifier order, uppercase printables, sequences, and duplicate gestures', () => {
+    assert.equal(normalizeGesture('M-C-X'), 'ctrl+alt+shift+x');
+    assert.equal(normalizeGesture('alt+ctrl+x'), 'ctrl+alt+x');
+    assert.equal(normalizeGesture('return'), 'enter');
+    assert.equal(normalizeGesture('esc'), 'escape');
+    assert.equal(normalizeGesture('meta+j'), 'alt+j');
+    assert.equal(normalizeGesture('+'), '+');
+    assert.equal(normalizeGesture('ctrl++'), 'ctrl++');
+    assert.equal(normalizeGesture('alt+>'), 'alt+>');
+    assert.equal(formatStroke('ctrl++'), 'Ctrl++');
+    assert.equal(canonicalTerminalStroke({ input: '+', ctrl: true }), 'ctrl++');
+    const resolved = resolveKeybindings({
+        'crtr.attach.graph.toggle': ['M-X', 'alt+x'],
+        'crtr.tmux.view.next': ['M-V > ]', 'alt+v > ]'],
+        'crtr.tmux.menu.promote': ['space'],
+    });
+    assert.deepEqual(resolved.gestures('crtr.attach.graph.toggle'), ['alt+shift+x', 'alt+x']);
+    assert.deepEqual(resolved.gestures('crtr.tmux.view.next'), ['alt+shift+v > ]', 'alt+v > ]']);
+    assert.deepEqual(resolved.gestures('crtr.tmux.menu.promote'), ['space']);
+});
+test('terminal literal space matches named space bindings', () => {
+    const raw = { input: ' ' };
+    assert.equal(canonicalTerminalStroke(raw), 'space');
+    assert.equal(matchesTerminalInput(resolveKeybindings(), 'crtr.browse.toggle-fold', raw), true);
+});
+test('invalid values and unknown IDs diagnose precisely while valid overrides still apply', () => {
+    const resolved = resolveKeybindings({
+        'crtr.unknown': ['x'],
+        'crtr.graph.down': 'down',
+        'crtr.attach.graph.toggle': ['alt+x'],
+        'crtr.tmux.view.next': ['alt+v'],
+    });
+    assert.equal(resolved.gestures('crtr.graph.down')[0], 'j');
+    assert.deepEqual(resolved.gestures('crtr.attach.graph.toggle'), ['alt+x']);
+    assert.equal(resolved.gestures('crtr.tmux.view.next')[0], 'alt+v > ]');
+    assert.deepEqual(new Set(resolved.diagnostics.map((item) => item.code)), new Set(['unknown-binding', 'invalid-override']));
+});
+test('colliding overrides fall back without affecting unrelated contexts', () => {
+    const resolved = resolveKeybindings({
+        'crtr.graph.down': ['k'],
+        'crtr.view.canvas.quit': ['x'],
+        'crtr.attach.graph.toggle': ['alt+c'],
+        'crtr.attach.detach': ['j'],
+        'crtr.setup.list-down': ['space'],
+        'crtr.view.settings.cancel-edit': ['q'],
+    });
+    assert.equal(resolved.gestures('crtr.graph.down')[0], 'j');
+    assert.deepEqual(resolved.gestures('crtr.view.canvas.quit'), ['x']);
+    assert.deepEqual(resolved.gestures('crtr.attach.graph.toggle'), ['alt+g']);
+    assert.deepEqual(resolved.gestures('crtr.attach.detach'), ['ctrl+d']);
+    assert.deepEqual(resolved.gestures('crtr.setup.list-down'), ['j', 'down']);
+    assert.deepEqual(resolved.gestures('crtr.view.settings.cancel-edit'), ['escape']);
+    assert.equal(resolved.diagnostics.filter((item) => item.code === 'collision').length, 5);
+});
+test('tmux menu selectors collide only inside their own menu', () => {
+    const resolved = resolveKeybindings({ 'crtr.tmux.menu.open': ['o'] });
+    assert.deepEqual(resolved.gestures('crtr.tmux.menu.open'), ['o']);
+    assert.deepEqual(resolved.diagnostics, []);
+});
+test('reachability rejects deliberate unbinding that would trap a context', () => {
+    const graph = resolveKeybindings({
+        'crtr.graph.dismiss': [],
+        'crtr.graph.down': ['escape'],
+    });
+    assert.deepEqual(graph.gestures('crtr.graph.dismiss'), ['escape']);
+    assert.deepEqual(graph.gestures('crtr.graph.down'), ['j']);
+    assert.ok(graph.diagnostics.some((item) => item.code === 'unreachable'));
+    assert.ok(graph.diagnostics.some((item) => item.code === 'collision'));
+    const setup = resolveKeybindings({
+        'crtr.setup.keybindings.discard': [],
+        'crtr.setup.keybindings.save': [],
+    });
+    assert.equal(setup.diagnostics.filter((item) => item.code === 'unreachable').length, 1);
+});
+test('sparsification omits defaults, preserves explicit unbinds, and reset removes the override', () => {
+    assert.deepEqual(normalizeSparseOverrides({ 'crtr.attach.graph.toggle': ['alt+g'] }), {});
+    assert.deepEqual(normalizeSparseOverrides({ 'crtr.graph.close-subtree': [] }), {
+        'crtr.graph.close-subtree': [],
+    });
+    assert.deepEqual(normalizeSparseOverrides({}), {});
+    assert.throws(() => normalizeSparseOverrides({ 'crtr.graph.down': ['k'] }), KeybindingValidationError);
+});
+test('user resolution ignores project keybindings', () => {
+    mkdirSync(join(home, '.crouter'), { recursive: true });
+    writeFileSync(join(home, '.crouter', 'config.json'), JSON.stringify({ keybindings: { 'crtr.graph.down': ['down'] } }));
+    const project = mkdtempSync(join(tmpdir(), 'crtr-keybindings-project-'));
+    mkdirSync(join(project, '.crouter'), { recursive: true });
+    writeFileSync(join(project, '.crouter', 'config.json'), JSON.stringify({ keybindings: { 'crtr.graph.down': ['up'] } }));
+    try {
+        process.chdir(project);
+        assert.deepEqual(resolveUserKeybindings().gestures('crtr.graph.down'), ['down']);
+    }
+    finally {
+        process.chdir(realCwd);
+        rmSync(project, { recursive: true, force: true });
+    }
+});
+test('config hard cut exposes only sparse keybindings and ignores unsupported raw fields', () => {
+    mkdirSync(join(home, '.crouter'), { recursive: true });
+    writeFileSync(join(home, '.crouter', 'config.json'), JSON.stringify({
+        canvasNav: { prefixKey: 'alt+x' },
+        keybindings: { 'crtr.graph.down': ['down'], bad: 3 },
+    }));
+    const config = readConfig('user');
+    assert.deepEqual(config.keybindings, { 'crtr.graph.down': ['down'] });
+    assert.equal(Object.hasOwn(config, 'canvasNav'), false);
+});
+test('atomic persistence preserves latest unrelated fields and writes only sparse normalized overrides', () => {
+    mkdirSync(join(home, '.crouter'), { recursive: true });
+    const path = join(home, '.crouter', 'config.json');
+    writeFileSync(path, JSON.stringify({
+        customFutureField: { retained: true },
+        max_panes_per_window: 4,
+        canvasNav: { prefixKey: 'alt+z' },
+    }));
+    persistUserKeybindings({
+        'crtr.attach.graph.toggle': ['M-X'],
+        'crtr.graph.close-subtree': [],
+        'crtr.graph.down': ['j'],
+    });
+    const raw = JSON.parse(readFileSync(path, 'utf8'));
+    assert.deepEqual(raw.customFutureField, { retained: true });
+    assert.equal(raw.max_panes_per_window, 4);
+    assert.deepEqual(raw.keybindings, {
+        'crtr.attach.graph.toggle': ['alt+shift+x'],
+        'crtr.graph.close-subtree': [],
+    });
+    assert.equal(raw.canvasNav, undefined);
+});
+test('reset-all removes the top-level member and concurrent keybinding edits are refused', () => {
+    mkdirSync(join(home, '.crouter'), { recursive: true });
+    const path = join(home, '.crouter', 'config.json');
+    const original = { 'crtr.graph.down': ['down'] };
+    writeFileSync(path, JSON.stringify({ keybindings: original, retained: 1 }));
+    persistUserKeybindings({}, { expectedKeybindings: original });
+    let raw = JSON.parse(readFileSync(path, 'utf8'));
+    assert.equal(raw.keybindings, undefined);
+    assert.equal(raw.retained, 1);
+    writeFileSync(path, JSON.stringify({ keybindings: { 'crtr.graph.up': ['up'] }, retained: 2 }));
+    assert.throws(() => persistUserKeybindings({}, { expectedKeybindings: original }), KeybindingConcurrentEditError);
+    raw = JSON.parse(readFileSync(path, 'utf8'));
+    assert.deepEqual(raw.keybindings, { 'crtr.graph.up': ['up'] });
+    assert.equal(raw.retained, 2);
+});

package/dist/core/keybindings/catalog.d.ts

@@ -0,0 +1,14 @@
+import type { BindingDefinition, SafetyRequirement } from './types.js';
+type TmuxMenuAction = 'open' | 'promote' | 'resume' | 'demote' | 'detach' | 'close-subtree' | 'context' | 'graph' | 'focus-manager' | 'issues';
+type GraphAction = 'down' | 'up' | 'first' | 'last' | 'collapse-or-manager' | 'expand-or-child' | 'focus' | 'focus-manager' | 'close-subtree' | 'dismiss';
+type InboxAction = 'down' | 'up' | 'open' | 'reply' | 'react' | 'filter' | 'refresh' | 'connect-linkedin' | 'connect-gmail' | 'quit' | 'submit-reply' | 'cancel' | 'reaction-previous' | 'reaction-next' | 'submit-reaction';
+type LinkedinAction = Exclude<InboxAction, 'filter' | 'connect-linkedin' | 'connect-gmail'>;
+type BrowseAction = 'quit' | 'down' | 'up' | 'first' | 'last' | 'expand-or-child' | 'collapse-or-parent' | 'toggle-fold' | 'tab-next' | 'tab-previous' | `tab.${1 | 2 | 3 | 4}` | 'close-subtree' | 'confirm-close' | 'sort' | 'scope' | 'residents' | 'preview' | 'search' | 'revive-now' | 'focus';
+type ProfileMenuAction = 'up' | 'down' | 'select' | 'accept-default' | 'abort' | `slot.${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}` | 'create' | 'search-existing' | 'use-root' | 'set-default' | 'add-directory' | 'unpin';
+type SetupAction = 'cancel' | 'tab-next' | 'tab-previous' | 'open' | 'list-down' | 'list-up' | 'toggle' | 'details' | 'advance';
+type SetupKeybindingAction = 'edit' | 'commit-edit' | 'cancel-edit' | 'unbind' | 'reset-row' | 'reset-all' | 'save' | 'discard' | 'page-up' | 'page-down' | 'filter' | 'filter-delete' | 'filter-clear';
+export type BindingId = `crtr.tmux.menu.${TmuxMenuAction}` | `crtr.tmux.menu.issue.${'idea' | 'bug'}` | `crtr.tmux.node.${'next' | 'previous'}` | `crtr.tmux.view.${'next' | 'previous'}` | `crtr.attach.${'detach' | 'clear-or-detach' | 'graph.toggle' | 'model-ladder.next'}` | 'crtr.mode.cycle' | `crtr.graph.${GraphAction}` | `crtr.graph.confirm.${'accept' | 'cancel'}` | `crtr.view.host.${'force-quit' | 'editor.backspace'}` | `crtr.view.canvas.${'down' | 'up' | 'refresh' | 'quit'}` | `crtr.view.chat.${'submit' | 'contextual-cancel' | 'reconnect' | 'request-control' | 'release-control' | 'quit'}` | `crtr.view.git-pr.${'down' | 'up' | 'refresh' | 'quit'}` | `crtr.view.inbox.${InboxAction}` | `crtr.view.linkedin.${LinkedinAction}` | `crtr.view.prompt-review.${'down' | 'up' | 'compare-previous' | 'compare-next' | 'toggle-mode' | 'expand' | 'export' | 'refresh' | 'quit'}` | `crtr.view.settings.${'down' | 'up' | 'cell-previous' | 'cell-next' | 'refresh' | 'quit' | 'edit-or-submit' | 'cancel-edit'}` | `crtr.view.workspace-sidebar.${'down' | 'up' | 'open' | 'refresh' | 'quit'}` | `crtr.view-picker.${'down' | 'up' | 'run' | 'quit'}` | `crtr.browse.${BrowseAction}` | `crtr.browse.search.${'cancel' | 'commit' | 'delete' | 'quit'}` | `crtr.profile.menu.${ProfileMenuAction}` | `crtr.profile.search.${'up' | 'down' | 'pick' | 'back' | 'delete' | 'abort'}` | `crtr.setup.${SetupAction}` | `crtr.setup.confirm.${'accept' | 'back'}` | `crtr.setup.keybindings.${SetupKeybindingAction}`;
+export declare const BINDING_CATALOG: readonly [BindingDefinition<"crtr.tmux.menu.open">, BindingDefinition<"crtr.tmux.menu.promote">, BindingDefinition<"crtr.tmux.menu.resume">, BindingDefinition<"crtr.tmux.menu.demote">, BindingDefinition<"crtr.tmux.menu.detach">, BindingDefinition<"crtr.tmux.menu.close-subtree">, BindingDefinition<"crtr.tmux.menu.context">, BindingDefinition<"crtr.tmux.menu.graph">, BindingDefinition<"crtr.tmux.menu.focus-manager">, BindingDefinition<"crtr.tmux.menu.issues">, BindingDefinition<"crtr.tmux.menu.issue.idea">, BindingDefinition<"crtr.tmux.menu.issue.bug">, BindingDefinition<"crtr.tmux.node.next">, BindingDefinition<"crtr.tmux.node.previous">, BindingDefinition<"crtr.tmux.view.next">, BindingDefinition<"crtr.tmux.view.previous">, BindingDefinition<"crtr.attach.detach">, BindingDefinition<"crtr.attach.clear-or-detach">, BindingDefinition<"crtr.attach.graph.toggle">, BindingDefinition<"crtr.attach.model-ladder.next">, BindingDefinition<"crtr.mode.cycle">, BindingDefinition<"crtr.graph.down">, BindingDefinition<"crtr.graph.up">, BindingDefinition<"crtr.graph.first">, BindingDefinition<"crtr.graph.last">, BindingDefinition<"crtr.graph.collapse-or-manager">, BindingDefinition<"crtr.graph.expand-or-child">, BindingDefinition<"crtr.graph.focus">, BindingDefinition<"crtr.graph.focus-manager">, BindingDefinition<"crtr.graph.close-subtree">, BindingDefinition<"crtr.graph.dismiss">, BindingDefinition<"crtr.graph.confirm.accept">, BindingDefinition<"crtr.graph.confirm.cancel">, BindingDefinition<"crtr.view.host.force-quit">, BindingDefinition<"crtr.view.host.editor.backspace">, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<"crtr.view.chat.submit">, BindingDefinition<"crtr.view.chat.contextual-cancel">, BindingDefinition<"crtr.view.chat.reconnect">, BindingDefinition<"crtr.view.chat.request-control">, BindingDefinition<"crtr.view.chat.release-control">, BindingDefinition<"crtr.view.chat.quit">, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.view.prompt-review.down"> | BindingDefinition<"crtr.view.prompt-review.up"> | BindingDefinition<"crtr.view.prompt-review.compare-previous"> | BindingDefinition<"crtr.view.prompt-review.compare-next"> | BindingDefinition<"crtr.view.prompt-review.toggle-mode"> | BindingDefinition<"crtr.view.prompt-review.expand"> | BindingDefinition<"crtr.view.prompt-review.export"> | BindingDefinition<"crtr.view.prompt-review.refresh"> | BindingDefinition<"crtr.view.prompt-review.quit"> | BindingDefinition<"crtr.view.settings.down"> | BindingDefinition<"crtr.view.settings.up"> | BindingDefinition<"crtr.view.settings.cell-previous"> | BindingDefinition<"crtr.view.settings.cell-next"> | BindingDefinition<"crtr.view.settings.refresh"> | BindingDefinition<"crtr.view.settings.quit"> | BindingDefinition<"crtr.view.settings.edit-or-submit"> | BindingDefinition<"crtr.view.settings.cancel-edit"> | BindingDefinition<"crtr.view.workspace-sidebar.down"> | BindingDefinition<"crtr.view.workspace-sidebar.up"> | BindingDefinition<"crtr.view.workspace-sidebar.open"> | BindingDefinition<"crtr.view.workspace-sidebar.refresh"> | BindingDefinition<"crtr.view.workspace-sidebar.quit"> | BindingDefinition<"crtr.view-picker.down"> | BindingDefinition<"crtr.view-picker.up"> | BindingDefinition<"crtr.view-picker.run"> | BindingDefinition<"crtr.view-picker.quit"> | BindingDefinition<"crtr.browse.quit"> | BindingDefinition<"crtr.browse.down"> | BindingDefinition<"crtr.browse.up"> | BindingDefinition<"crtr.browse.first"> | BindingDefinition<"crtr.browse.last"> | BindingDefinition<"crtr.browse.expand-or-child"> | BindingDefinition<"crtr.browse.collapse-or-parent"> | BindingDefinition<"crtr.browse.toggle-fold"> | BindingDefinition<"crtr.browse.tab-next"> | BindingDefinition<"crtr.browse.tab-previous"> | BindingDefinition<"crtr.browse.tab.2" | "crtr.browse.tab.1" | "crtr.browse.tab.3" | "crtr.browse.tab.4"> | BindingDefinition<"crtr.browse.close-subtree"> | BindingDefinition<"crtr.browse.confirm-close"> | BindingDefinition<"crtr.browse.sort"> | BindingDefinition<"crtr.browse.scope"> | BindingDefinition<"crtr.browse.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | BindingDefinition<"crtr.browse.search.cancel"> | BindingDefinition<"crtr.browse.search.commit"> | BindingDefinition<"crtr.browse.search.delete"> | BindingDefinition<"crtr.browse.search.quit"> | BindingDefinition<"crtr.profile.menu.up"> | BindingDefinition<"crtr.profile.menu.down"> | BindingDefinition<"crtr.profile.menu.select"> | BindingDefinition<"crtr.profile.menu.accept-default"> | BindingDefinition<"crtr.profile.menu.abort"> | BindingDefinition<"crtr.profile.menu.slot.2" | "crtr.profile.menu.slot.1" | "crtr.profile.menu.slot.3" | "crtr.profile.menu.slot.4" | "crtr.profile.menu.slot.5" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.9">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.search.up">, BindingDefinition<"crtr.profile.search.down">, BindingDefinition<"crtr.profile.search.pick">, BindingDefinition<"crtr.profile.search.back">, BindingDefinition<"crtr.profile.search.delete">, BindingDefinition<"crtr.profile.search.abort">, BindingDefinition<"crtr.setup.cancel">, BindingDefinition<"crtr.setup.tab-next">, BindingDefinition<"crtr.setup.tab-previous">, BindingDefinition<"crtr.setup.open">, BindingDefinition<"crtr.setup.list-down">, BindingDefinition<"crtr.setup.list-up">, BindingDefinition<"crtr.setup.toggle">, BindingDefinition<"crtr.setup.details">, BindingDefinition<"crtr.setup.advance">, BindingDefinition<"crtr.setup.confirm.accept">, BindingDefinition<"crtr.setup.confirm.back">, BindingDefinition<"crtr.setup.keybindings.edit">, BindingDefinition<"crtr.setup.keybindings.commit-edit">, BindingDefinition<"crtr.setup.keybindings.cancel-edit">, BindingDefinition<"crtr.setup.keybindings.unbind">, BindingDefinition<"crtr.setup.keybindings.reset-row">, BindingDefinition<"crtr.setup.keybindings.reset-all">, BindingDefinition<"crtr.setup.keybindings.save">, BindingDefinition<"crtr.setup.keybindings.discard">, BindingDefinition<"crtr.setup.keybindings.page-up">, BindingDefinition<"crtr.setup.keybindings.page-down">, BindingDefinition<"crtr.setup.keybindings.filter">, BindingDefinition<"crtr.setup.keybindings.filter-delete">, BindingDefinition<"crtr.setup.keybindings.filter-clear">];
+export declare const BINDING_IDS: ReadonlySet<string>;
+export declare const SAFETY_REQUIREMENTS: readonly SafetyRequirement[];
+export {};

package/dist/core/keybindings/catalog.js

@@ -0,0 +1,256 @@
+function binding(id, group, name, description, defaults, inputKind, contexts, safety) {
+    return Object.freeze({
+        id,
+        group,
+        name,
+        description,
+        defaults: Object.freeze([...defaults]),
+        inputKind,
+        contexts: Object.freeze([...contexts]),
+        ...(safety === undefined ? {} : { safety }),
+    });
+}
+const b = binding;
+const ATTACH_CONTEXTS = ['attach', 'graph', 'graph.confirm'];
+const VIEW_CONTEXTS = [
+    'view.canvas', 'view.chat', 'view.git-pr',
+    'view.inbox.list', 'view.inbox.compose', 'view.inbox.react',
+    'view.linkedin.list', 'view.linkedin.compose', 'view.linkedin.react',
+    'view.prompt-review', 'view.settings', 'view.settings.edit',
+    'view.workspace-sidebar',
+];
+const SETUP_CANCEL_CONTEXTS = [
+    'setup.login', 'setup.list', 'setup.input', 'setup.keybindings',
+    'setup.keybindings.edit', 'setup.keybindings.filter',
+];
+const SETUP_TAB_CONTEXTS = ['setup.login', 'setup.list', 'setup.keybindings'];
+export const BINDING_CATALOG = Object.freeze([
+    b('crtr.tmux.menu.open', 'Global tmux', 'Open crouter menu', 'Open the crouter action menu.', ['alt+c'], 'host-global', ['tmux.root']),
+    b('crtr.tmux.menu.promote', 'Global tmux', 'Promote node', 'Promote the focused node to orchestrator.', ['o'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.resume', 'Global tmux', 'Resume node', 'Open the node resume picker.', ['r'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.demote', 'Global tmux', 'Demote node', 'Demote the focused node to terminal.', ['d'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.detach', 'Global tmux', 'Detach node', 'Detach the focused node to the background.', ['shift+d'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.close-subtree', 'Global tmux', 'Close subtree', 'Close the focused node and its subtree.', ['x'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.context', 'Global tmux', 'Browse context', 'Browse the focused node context.', ['c'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.graph', 'Global tmux', 'Open graph', 'Open the canvas graph.', ['g'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.focus-manager', 'Global tmux', 'Focus manager', 'Focus the node manager.', ['m'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.issues', 'Global tmux', 'Open issue menu', 'Open the issue type submenu.', ['i'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.issue.idea', 'Global tmux', 'Create idea', 'Create an idea issue.', ['i'], 'tmux-menu-selector', ['tmux.menu.issue']),
+    b('crtr.tmux.menu.issue.bug', 'Global tmux', 'Create bug', 'Create a bug issue.', ['b'], 'tmux-menu-selector', ['tmux.menu.issue']),
+    b('crtr.tmux.node.next', 'Global tmux', 'Next node', 'Focus the next canvas node.', ['alt+]'], 'host-global', ['tmux.root']),
+    b('crtr.tmux.node.previous', 'Global tmux', 'Previous node', 'Focus the previous canvas node.', ['alt+['], 'host-global', ['tmux.root']),
+    b('crtr.tmux.view.next', 'Global tmux', 'Next view', 'Focus the next view.', ['alt+v > ]'], 'tmux-sequence', ['tmux.root']),
+    b('crtr.tmux.view.previous', 'Global tmux', 'Previous view', 'Focus the previous view.', ['alt+v > ['], 'tmux-sequence', ['tmux.root']),
+    b('crtr.attach.detach', 'Attach', 'Detach', 'Detach from the node.', ['ctrl+d'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.attach.clear-or-detach', 'Attach', 'Clear or detach', 'Clear input or detach when input is empty.', ['ctrl+c'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.attach.graph.toggle', 'Attach', 'Toggle graph', 'Open or close the graph overlay.', ['alt+g'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.attach.model-ladder.next', 'Attach', 'Next model ladder', 'Move to the next model ladder rung.', ['alt+shift+m'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.mode.cycle', 'Attach', 'Cycle mode', 'Cycle the active agent mode.', ['alt+m'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.graph.down', 'GRAPH', 'Move down', 'Move to the next graph row.', ['j'], 'terminal', ['graph']),
+    b('crtr.graph.up', 'GRAPH', 'Move up', 'Move to the previous graph row.', ['k'], 'terminal', ['graph']),
+    b('crtr.graph.first', 'GRAPH', 'First row', 'Move to the first graph row.', ['g'], 'terminal', ['graph']),
+    b('crtr.graph.last', 'GRAPH', 'Last row', 'Move to the last graph row.', ['shift+g'], 'terminal', ['graph']),
+    b('crtr.graph.collapse-or-manager', 'GRAPH', 'Collapse or manager', 'Collapse a node or move to its manager.', ['h'], 'terminal', ['graph']),
+    b('crtr.graph.expand-or-child', 'GRAPH', 'Expand or child', 'Expand a node or move to its child.', ['l'], 'terminal', ['graph']),
+    b('crtr.graph.focus', 'GRAPH', 'Focus node', 'Focus the selected node.', ['enter'], 'terminal', ['graph']),
+    b('crtr.graph.focus-manager', 'GRAPH', 'Focus manager', 'Focus the selected node manager.', ['m'], 'terminal', ['graph']),
+    b('crtr.graph.close-subtree', 'GRAPH', 'Close subtree', 'Ask to close the selected subtree.', ['x'], 'terminal', ['graph']),
+    b('crtr.graph.dismiss', 'GRAPH', 'Dismiss graph', 'Close the graph overlay.', ['escape'], 'terminal', ['graph'], 'dismiss-modal'),
+    b('crtr.graph.confirm.accept', 'GRAPH', 'Confirm close', 'Confirm closing the selected subtree.', ['y'], 'terminal', ['graph.confirm']),
+    b('crtr.graph.confirm.cancel', 'GRAPH', 'Cancel close', 'Cancel closing the selected subtree.', ['n', 'escape'], 'terminal', ['graph.confirm'], 'dismiss-modal'),
+    b('crtr.view.host.force-quit', 'Views', 'Force quit view', 'Immediately leave a hosted view.', ['ctrl+c'], 'host-global', VIEW_CONTEXTS, 'leave-screen'),
+    b('crtr.view.host.editor.backspace', 'Views', 'Delete captured text', 'Delete the previous captured character.', ['backspace'], 'host-global', ['view.chat', 'view.inbox.compose', 'view.linkedin.compose', 'view.settings.edit']),
+    ...viewNavigation('canvas', 'Canvas view'),
+    b('crtr.view.chat.submit', 'Views', 'Submit chat', 'Submit the current chat input.', ['enter'], 'terminal', ['view.chat']),
+    b('crtr.view.chat.contextual-cancel', 'Views', 'Cancel chat action', 'Cancel the active chat action.', ['escape'], 'terminal', ['view.chat']),
+    b('crtr.view.chat.reconnect', 'Views', 'Reconnect chat', 'Reconnect the chat stream.', ['r'], 'terminal', ['view.chat']),
+    b('crtr.view.chat.request-control', 'Views', 'Request control', 'Request control of the chat.', ['c'], 'terminal', ['view.chat']),
+    b('crtr.view.chat.release-control', 'Views', 'Release control', 'Release control of the chat.', ['shift+c', 'ctrl+r'], 'terminal', ['view.chat']),
+    b('crtr.view.chat.quit', 'Views', 'Quit chat', 'Leave the chat view.', ['q'], 'terminal', ['view.chat'], 'leave-screen'),
+    ...viewNavigation('git-pr', 'Git PR view'),
+    ...listView('inbox', 'Inbox', [
+        ['open', 'Open item', 'Open the selected inbox item.', ['enter']],
+        ['reply', 'Reply', 'Reply to the selected inbox item.', ['r']],
+        ['react', 'React', 'React to the selected inbox item.', ['e']],
+        ['filter', 'Filter', 'Filter inbox items.', ['f']],
+        ['refresh', 'Refresh', 'Refresh inbox items.', ['g']],
+        ['connect-linkedin', 'Connect LinkedIn', 'Connect the LinkedIn inbox.', ['shift+l']],
+        ['connect-gmail', 'Connect Gmail', 'Connect the Gmail inbox.', ['shift+g']],
+    ]),
+    ...composeAndReact('inbox', 'Inbox'),
+    ...listView('linkedin', 'LinkedIn', [
+        ['open', 'Open item', 'Open the selected LinkedIn item.', ['enter']],
+        ['reply', 'Reply', 'Reply to the selected LinkedIn item.', ['r']],
+        ['react', 'React', 'React to the selected LinkedIn item.', ['e']],
+        ['refresh', 'Refresh', 'Refresh LinkedIn items.', ['g']],
+    ]),
+    ...composeAndReact('linkedin', 'LinkedIn'),
+    b('crtr.view.prompt-review.down', 'Views', 'Move down', 'Move to the next prompt review row.', ['j', 'down'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.up', 'Views', 'Move up', 'Move to the previous prompt review row.', ['k', 'up'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.compare-previous', 'Views', 'Previous comparison', 'Select the previous comparison.', ['h', 'left'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.compare-next', 'Views', 'Next comparison', 'Select the next comparison.', ['l', 'right'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.toggle-mode', 'Views', 'Toggle mode', 'Toggle the prompt review mode.', ['tab'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.expand', 'Views', 'Expand', 'Expand the selected prompt review.', ['enter'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.export', 'Views', 'Export', 'Export the prompt review.', ['e'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.refresh', 'Views', 'Refresh', 'Refresh the prompt review.', ['g'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.quit', 'Views', 'Quit', 'Leave the prompt review.', ['q'], 'terminal', ['view.prompt-review'], 'leave-screen'),
+    b('crtr.view.settings.down', 'Views', 'Move down', 'Move to the next settings row.', ['j', 'down'], 'terminal', ['view.settings']),
+    b('crtr.view.settings.up', 'Views', 'Move up', 'Move to the previous settings row.', ['k', 'up'], 'terminal', ['view.settings']),
+    b('crtr.view.settings.cell-previous', 'Views', 'Previous cell', 'Select the previous settings cell.', ['h', 'left'], 'terminal', ['view.settings']),
+    b('crtr.view.settings.cell-next', 'Views', 'Next cell', 'Select the next settings cell.', ['l', 'right'], 'terminal', ['view.settings']),
+    b('crtr.view.settings.refresh', 'Views', 'Refresh', 'Refresh settings.', ['g'], 'terminal', ['view.settings']),
+    b('crtr.view.settings.quit', 'Views', 'Quit', 'Leave settings.', ['q'], 'terminal', ['view.settings', 'view.settings.edit'], 'leave-screen'),
+    b('crtr.view.settings.edit-or-submit', 'Views', 'Edit or submit', 'Edit or submit the selected setting.', ['enter'], 'terminal', ['view.settings']),
+    b('crtr.view.settings.cancel-edit', 'Views', 'Cancel edit', 'Cancel the active settings edit.', ['escape'], 'terminal', ['view.settings.edit'], 'dismiss-modal'),
+    b('crtr.view.workspace-sidebar.down', 'Views', 'Move down', 'Move to the next workspace.', ['j', 'down'], 'terminal', ['view.workspace-sidebar']),
+    b('crtr.view.workspace-sidebar.up', 'Views', 'Move up', 'Move to the previous workspace.', ['k', 'up'], 'terminal', ['view.workspace-sidebar']),
+    b('crtr.view.workspace-sidebar.open', 'Views', 'Open workspace', 'Open the selected workspace.', ['enter'], 'terminal', ['view.workspace-sidebar']),
+    b('crtr.view.workspace-sidebar.refresh', 'Views', 'Refresh', 'Refresh workspaces.', ['g', 'r'], 'terminal', ['view.workspace-sidebar']),
+    b('crtr.view.workspace-sidebar.quit', 'Views', 'Quit', 'Leave the workspace sidebar.', ['q'], 'terminal', ['view.workspace-sidebar'], 'leave-screen'),
+    b('crtr.view-picker.down', 'Browse and pickers', 'Move down', 'Move to the next view.', ['j', 'down'], 'terminal', ['view-picker']),
+    b('crtr.view-picker.up', 'Browse and pickers', 'Move up', 'Move to the previous view.', ['k', 'up'], 'terminal', ['view-picker']),
+    b('crtr.view-picker.run', 'Browse and pickers', 'Run view', 'Run the selected view.', ['enter'], 'terminal', ['view-picker']),
+    b('crtr.view-picker.quit', 'Browse and pickers', 'Quit picker', 'Leave the view picker.', ['q', 'escape', 'ctrl+c'], 'terminal', ['view-picker'], 'leave-screen'),
+    ...browseBindings(),
+    ...profileBindings(),
+    ...setupBindings(),
+]);
+function viewNavigation(id, label) {
+    const context = `view.${id}`;
+    return [
+        b(`crtr.view.${id}.down`, 'Views', 'Move down', `Move to the next ${label.toLowerCase()} row.`, ['j', 'down'], 'terminal', [context]),
+        b(`crtr.view.${id}.up`, 'Views', 'Move up', `Move to the previous ${label.toLowerCase()} row.`, ['k', 'up'], 'terminal', [context]),
+        b(`crtr.view.${id}.refresh`, 'Views', 'Refresh', `Refresh the ${label.toLowerCase()}.`, ['g'], 'terminal', [context]),
+        b(`crtr.view.${id}.quit`, 'Views', 'Quit', `Leave the ${label.toLowerCase()}.`, ['q'], 'terminal', [context], 'leave-screen'),
+    ];
+}
+function listView(id, label, actions) {
+    const context = `view.${id}.list`;
+    return [
+        b(`crtr.view.${id}.down`, 'Views', 'Move down', `Move to the next ${label} item.`, ['j', 'down'], 'terminal', [context]),
+        b(`crtr.view.${id}.up`, 'Views', 'Move up', `Move to the previous ${label} item.`, ['k', 'up'], 'terminal', [context]),
+        ...actions.map(([action, name, description, defaults]) => b(`crtr.view.${id}.${action}`, 'Views', name, description, defaults, 'terminal', [context])),
+        b(`crtr.view.${id}.quit`, 'Views', 'Quit', `Leave ${label}.`, ['q'], 'terminal', [context], 'leave-screen'),
+    ];
+}
+function composeAndReact(id, label) {
+    return [
+        b(`crtr.view.${id}.submit-reply`, 'Views', 'Submit reply', `Submit the ${label} reply.`, ['enter'], 'terminal', [`view.${id}.compose`]),
+        b(`crtr.view.${id}.cancel`, 'Views', 'Cancel', `Cancel ${label} composition or reaction.`, ['escape'], 'terminal', [`view.${id}.compose`, `view.${id}.react`], 'dismiss-modal'),
+        b(`crtr.view.${id}.reaction-previous`, 'Views', 'Previous reaction', 'Select the previous reaction.', id === 'inbox' ? ['h', 'left'] : ['left', 'h'], 'terminal', [`view.${id}.react`]),
+        b(`crtr.view.${id}.reaction-next`, 'Views', 'Next reaction', 'Select the next reaction.', id === 'inbox' ? ['l', 'right'] : ['right', 'l'], 'terminal', [`view.${id}.react`]),
+        b(`crtr.view.${id}.submit-reaction`, 'Views', 'Submit reaction', `Submit the ${label} reaction.`, ['enter'], 'terminal', [`view.${id}.react`]),
+    ];
+}
+function browseBindings() {
+    const nav = 'browse';
+    return [
+        b('crtr.browse.quit', 'Browse and pickers', 'Quit browse', 'Leave canvas browse.', ['q', 'escape', 'ctrl+c'], 'terminal', [nav], 'leave-screen'),
+        b('crtr.browse.down', 'Browse and pickers', 'Move down', 'Move to the next row.', ['j', 'down'], 'terminal', [nav]),
+        b('crtr.browse.up', 'Browse and pickers', 'Move up', 'Move to the previous row.', ['k', 'up'], 'terminal', [nav]),
+        b('crtr.browse.first', 'Browse and pickers', 'First row', 'Move to the first row.', ['g'], 'terminal', [nav]),
+        b('crtr.browse.last', 'Browse and pickers', 'Last row', 'Move to the last row.', ['shift+g'], 'terminal', [nav]),
+        b('crtr.browse.expand-or-child', 'Browse and pickers', 'Expand or child', 'Expand a row or move to its child.', ['l', 'right'], 'terminal', [nav]),
+        b('crtr.browse.collapse-or-parent', 'Browse and pickers', 'Collapse or parent', 'Collapse a row or move to its parent.', ['h', 'left'], 'terminal', [nav]),
+        b('crtr.browse.toggle-fold', 'Browse and pickers', 'Toggle fold', 'Toggle the selected fold.', ['space'], 'terminal', [nav]),
+        b('crtr.browse.tab-next', 'Browse and pickers', 'Next tab', 'Select the next browse tab.', ['tab', ']'], 'terminal', [nav]),
+        b('crtr.browse.tab-previous', 'Browse and pickers', 'Previous tab', 'Select the previous browse tab.', ['shift+tab', '['], 'terminal', [nav]),
+        ...[1, 2, 3, 4].map((slot) => b(`crtr.browse.tab.${slot}`, 'Browse and pickers', `Tab ${slot}`, `Select browse tab ${slot}.`, [`${slot}`], 'terminal', [nav])),
+        b('crtr.browse.close-subtree', 'Browse and pickers', 'Close subtree', 'Ask to close the selected subtree.', ['x'], 'terminal', [nav]),
+        b('crtr.browse.confirm-close', 'Browse and pickers', 'Confirm close', 'Confirm closing the selected subtree.', ['y'], 'terminal', ['browse.confirm']),
+        b('crtr.browse.sort', 'Browse and pickers', 'Change sort', 'Change the browse sort.', ['s'], 'terminal', [nav]),
+        b('crtr.browse.scope', 'Browse and pickers', 'Change scope', 'Change the browse scope.', ['c'], 'terminal', [nav]),
+        b('crtr.browse.residents', 'Browse and pickers', 'Toggle residents', 'Toggle resident display.', ['r'], 'terminal', [nav]),
+        b('crtr.browse.preview', 'Browse and pickers', 'Toggle preview', 'Toggle the preview panel.', ['p'], 'terminal', [nav]),
+        b('crtr.browse.search', 'Browse and pickers', 'Search', 'Open browse search.', ['/'], 'terminal', [nav]),
+        b('crtr.browse.revive-now', 'Browse and pickers', 'Revive now', 'Revive the selected node now.', ['shift+k'], 'terminal', [nav]),
+        b('crtr.browse.focus', 'Browse and pickers', 'Focus node', 'Focus the selected node.', ['enter'], 'terminal', [nav]),
+        b('crtr.browse.search.cancel', 'Browse and pickers', 'Cancel search', 'Cancel browse search.', ['escape'], 'terminal', ['browse.search'], 'dismiss-modal'),
+        b('crtr.browse.search.commit', 'Browse and pickers', 'Commit search', 'Apply browse search.', ['enter'], 'terminal', ['browse.search']),
+        b('crtr.browse.search.delete', 'Browse and pickers', 'Delete search text', 'Delete the previous search character.', ['backspace'], 'terminal', ['browse.search']),
+        b('crtr.browse.search.quit', 'Browse and pickers', 'Quit browse', 'Leave canvas browse from search.', ['ctrl+c'], 'terminal', ['browse.search'], 'leave-screen'),
+    ];
+}
+function profileBindings() {
+    const menu = 'profile.menu';
+    const search = 'profile.search';
+    return [
+        b('crtr.profile.menu.up', 'Profiles', 'Move up', 'Move to the previous profile.', ['k', 'up'], 'terminal', [menu]),
+        b('crtr.profile.menu.down', 'Profiles', 'Move down', 'Move to the next profile.', ['j', 'down'], 'terminal', [menu]),
+        b('crtr.profile.menu.select', 'Profiles', 'Select profile', 'Select the highlighted profile.', ['enter'], 'terminal', [menu]),
+        b('crtr.profile.menu.accept-default', 'Profiles', 'Accept default', 'Accept the default profile.', ['escape'], 'terminal', [menu], 'leave-screen'),
+        b('crtr.profile.menu.abort', 'Profiles', 'Abort', 'Leave profile selection.', ['ctrl+c'], 'terminal', [menu], 'leave-screen'),
+        ...[1, 2, 3, 4, 5, 6, 7, 8, 9].map((slot) => b(`crtr.profile.menu.slot.${slot}`, 'Profiles', `Profile slot ${slot}`, `Select profile slot ${slot}.`, [`${slot}`], 'terminal', [menu])),
+        b('crtr.profile.menu.create', 'Profiles', 'Create profile', 'Create a profile.', ['c'], 'terminal', [menu]),
+        b('crtr.profile.menu.search-existing', 'Profiles', 'Search profiles', 'Search existing profiles.', ['s'], 'terminal', [menu]),
+        b('crtr.profile.menu.use-root', 'Profiles', 'Use root profile', 'Use the root profile.', ['r'], 'terminal', [menu]),
+        b('crtr.profile.menu.set-default', 'Profiles', 'Set default', 'Set the selected profile as default.', ['d'], 'terminal', [menu]),
+        b('crtr.profile.menu.add-directory', 'Profiles', 'Add directory', 'Add a directory to the profile.', ['a'], 'terminal', [menu]),
+        b('crtr.profile.menu.unpin', 'Profiles', 'Unpin directory', 'Unpin the selected directory.', ['u'], 'terminal', [menu]),
+        b('crtr.profile.search.up', 'Profiles', 'Move up', 'Move to the previous search result.', ['up', 'ctrl+p'], 'terminal', [search]),
+        b('crtr.profile.search.down', 'Profiles', 'Move down', 'Move to the next search result.', ['down', 'ctrl+n'], 'terminal', [search]),
+        b('crtr.profile.search.pick', 'Profiles', 'Pick profile', 'Pick the highlighted profile.', ['enter'], 'terminal', [search]),
+        b('crtr.profile.search.back', 'Profiles', 'Back', 'Return to profile selection.', ['escape'], 'terminal', [search], 'leave-screen'),
+        b('crtr.profile.search.delete', 'Profiles', 'Delete filter text', 'Delete the previous filter character.', ['backspace'], 'terminal', [search]),
+        b('crtr.profile.search.abort', 'Profiles', 'Abort', 'Leave profile search.', ['ctrl+c'], 'terminal', [search], 'leave-screen'),
+    ];
+}
+function setupBindings() {
+    return [
+        b('crtr.setup.cancel', 'Setup', 'Cancel setup', 'Leave the setup wizard.', ['q', 'ctrl+c', 'ctrl+d'], 'terminal', SETUP_CANCEL_CONTEXTS, 'leave-screen'),
+        b('crtr.setup.tab-next', 'Setup', 'Next tab', 'Select the next setup tab.', ['tab', 'right'], 'terminal', SETUP_TAB_CONTEXTS),
+        b('crtr.setup.tab-previous', 'Setup', 'Previous tab', 'Select the previous setup tab.', ['shift+tab', 'left'], 'terminal', SETUP_TAB_CONTEXTS),
+        b('crtr.setup.open', 'Setup', 'Open', 'Open the selected setup item.', ['enter'], 'terminal', ['setup.login']),
+        b('crtr.setup.list-down', 'Setup', 'Move down', 'Move to the next setup item.', ['j', 'down'], 'terminal', ['setup.list']),
+        b('crtr.setup.list-up', 'Setup', 'Move up', 'Move to the previous setup item.', ['k', 'up'], 'terminal', ['setup.list']),
+        b('crtr.setup.toggle', 'Setup', 'Toggle', 'Toggle the selected setup item.', ['space'], 'terminal', ['setup.list']),
+        b('crtr.setup.details', 'Setup', 'Show details', 'Show details for the selected item.', ['?'], 'terminal', ['setup.list']),
+        b('crtr.setup.advance', 'Setup', 'Advance', 'Advance the setup flow.', ['enter'], 'terminal', ['setup.list']),
+        b('crtr.setup.confirm.accept', 'Setup', 'Confirm', 'Accept the setup confirmation.', ['y', 'enter'], 'terminal', ['setup.confirm']),
+        b('crtr.setup.confirm.back', 'Setup', 'Go back', 'Cancel the setup confirmation.', ['n', 'escape', 'q'], 'terminal', ['setup.confirm'], 'dismiss-modal'),
+        b('crtr.setup.keybindings.edit', 'Setup', 'Edit binding', 'Edit the selected binding.', ['enter'], 'terminal', ['setup.keybindings']),
+        b('crtr.setup.keybindings.commit-edit', 'Setup', 'Commit edit', 'Commit the active binding edit.', ['enter'], 'terminal', ['setup.keybindings.edit']),
+        b('crtr.setup.keybindings.cancel-edit', 'Setup', 'Cancel edit', 'Cancel the active binding edit.', ['escape'], 'terminal', ['setup.keybindings.edit'], 'dismiss-modal'),
+        b('crtr.setup.keybindings.unbind', 'Setup', 'Unbind', 'Disable the selected binding.', ['delete'], 'terminal', ['setup.keybindings']),
+        b('crtr.setup.keybindings.reset-row', 'Setup', 'Reset binding', 'Reset the selected binding.', ['r'], 'terminal', ['setup.keybindings']),
+        b('crtr.setup.keybindings.reset-all', 'Setup', 'Reset all bindings', 'Reset all bindings to defaults.', ['shift+r'], 'terminal', ['setup.keybindings']),
+        b('crtr.setup.keybindings.save', 'Setup', 'Save bindings', 'Save keybinding changes.', ['s'], 'terminal', ['setup.keybindings'], 'save-keybindings'),
+        b('crtr.setup.keybindings.discard', 'Setup', 'Discard changes', 'Discard keybinding changes.', ['escape'], 'terminal', ['setup.keybindings'], 'leave-screen'),
+        b('crtr.setup.keybindings.page-up', 'Setup', 'Page up', 'Move up one keybinding page.', ['pageup'], 'terminal', ['setup.keybindings', 'setup.keybindings.edit']),
+        b('crtr.setup.keybindings.page-down', 'Setup', 'Page down', 'Move down one keybinding page.', ['pagedown'], 'terminal', ['setup.keybindings', 'setup.keybindings.edit']),
+        b('crtr.setup.keybindings.filter', 'Setup', 'Filter bindings', 'Open the keybinding filter.', ['/'], 'terminal', ['setup.keybindings']),
+        b('crtr.setup.keybindings.filter-delete', 'Setup', 'Delete filter text', 'Delete the previous filter character.', ['backspace'], 'terminal', ['setup.keybindings.filter']),
+        b('crtr.setup.keybindings.filter-clear', 'Setup', 'Clear filter', 'Clear the keybinding filter.', ['escape'], 'terminal', ['setup.keybindings.filter'], 'dismiss-modal'),
+    ];
+}
+export const BINDING_IDS = new Set(BINDING_CATALOG.map((definition) => definition.id));
+export const SAFETY_REQUIREMENTS = Object.freeze([
+    { context: 'graph', capability: 'dismiss-modal' },
+    { context: 'graph.confirm', capability: 'dismiss-modal' },
+    { context: 'view.canvas', capability: 'leave-screen' },
+    { context: 'view.chat', capability: 'leave-screen' },
+    { context: 'view.git-pr', capability: 'leave-screen' },
+    { context: 'view.inbox.list', capability: 'leave-screen' },
+    { context: 'view.inbox.compose', capability: 'dismiss-modal' },
+    { context: 'view.inbox.react', capability: 'dismiss-modal' },
+    { context: 'view.linkedin.list', capability: 'leave-screen' },
+    { context: 'view.linkedin.compose', capability: 'dismiss-modal' },
+    { context: 'view.linkedin.react', capability: 'dismiss-modal' },
+    { context: 'view.prompt-review', capability: 'leave-screen' },
+    { context: 'view.settings', capability: 'leave-screen' },
+    { context: 'view.settings.edit', capability: 'dismiss-modal' },
+    { context: 'view.workspace-sidebar', capability: 'leave-screen' },
+    { context: 'view-picker', capability: 'leave-screen' },
+    { context: 'browse', capability: 'leave-screen' },
+    { context: 'browse.search', capability: 'dismiss-modal' },
+    { context: 'profile.menu', capability: 'leave-screen' },
+    { context: 'profile.search', capability: 'leave-screen' },
+    { context: 'setup.login', capability: 'leave-screen' },
+    { context: 'setup.list', capability: 'leave-screen' },
+    { context: 'setup.input', capability: 'leave-screen' },
+    { context: 'setup.confirm', capability: 'dismiss-modal' },
+    { context: 'setup.keybindings', capability: 'leave-screen' },
+    { context: 'setup.keybindings', capability: 'save-keybindings' },
+    { context: 'setup.keybindings.edit', capability: 'dismiss-modal' },
+    { context: 'setup.keybindings.filter', capability: 'dismiss-modal' },
+]);

package/dist/core/keybindings/index.d.ts

@@ -0,0 +1,5 @@
+export { BINDING_CATALOG, BINDING_IDS, SAFETY_REQUIREMENTS, type BindingId, } from './catalog.js';
+export { GestureSyntaxError, KeybindingValidationError, normalizeGesture, normalizeSparseOverrides, normalizeStroke, resolveKeybindings, resolveUserKeybindings, } from './resolve.js';
+export { canonicalTerminalStroke, formatBinding, formatGesture, formatStroke, matchesPiTuiInput, matchesTerminalInput, type PiTuiMatcher, type RawTerminalInput, } from './match.js';
+export { KeybindingConcurrentEditError, persistUserKeybindings, type PersistedKeybindings, type PersistKeybindingsOptions, } from './persistence.js';
+export type { BindingDefinition, BindingInputKind, BindingResolution, BindingSafetyCapability, EffectiveBinding, KeybindingDiagnostic, KeybindingDiagnosticCode, SafetyRequirement, SparseKeybindingOverrides, } from './types.js';

package/dist/core/keybindings/index.js

@@ -0,0 +1,4 @@
+export { BINDING_CATALOG, BINDING_IDS, SAFETY_REQUIREMENTS, } from './catalog.js';
+export { GestureSyntaxError, KeybindingValidationError, normalizeGesture, normalizeSparseOverrides, normalizeStroke, resolveKeybindings, resolveUserKeybindings, } from './resolve.js';
+export { canonicalTerminalStroke, formatBinding, formatGesture, formatStroke, matchesPiTuiInput, matchesTerminalInput, } from './match.js';
+export { KeybindingConcurrentEditError, persistUserKeybindings, } from './persistence.js';

package/dist/core/keybindings/match.d.ts

@@ -0,0 +1,29 @@
+import type { BindingId } from './catalog.js';
+import type { BindingResolution } from './types.js';
+export declare function formatStroke(stroke: string): string;
+export declare function formatGesture(gesture: string): string;
+export declare function formatBinding(bindingSet: BindingResolution<BindingId>, id: BindingId): string;
+export interface RawTerminalInput {
+    readonly input?: string;
+    readonly upArrow?: boolean;
+    readonly downArrow?: boolean;
+    readonly leftArrow?: boolean;
+    readonly rightArrow?: boolean;
+    readonly return?: boolean;
+    readonly escape?: boolean;
+    readonly ctrl?: boolean;
+    readonly meta?: boolean;
+    readonly shift?: boolean;
+    readonly tab?: boolean;
+    readonly shiftTab?: boolean;
+    readonly backspace?: boolean;
+    readonly delete?: boolean;
+    readonly pageUp?: boolean;
+    readonly pageDown?: boolean;
+    readonly home?: boolean;
+    readonly end?: boolean;
+}
+export declare function canonicalTerminalStroke(raw: RawTerminalInput): string | null;
+export declare function matchesTerminalInput(bindingSet: BindingResolution<BindingId>, id: BindingId, raw: RawTerminalInput): boolean;
+export type PiTuiMatcher<Input> = (input: Input, gesture: string) => boolean;
+export declare function matchesPiTuiInput<Input>(bindingSet: BindingResolution<BindingId>, id: BindingId, input: Input, matchesKey: PiTuiMatcher<Input>): boolean;