@sascha384/tic 5.0.0 → 5.2.0

package/dist/commands.js

@@ -12,6 +12,11 @@ const commands = [
         label: 'Create item',
         category: 'Actions',
         shortcut: 'c',
+        keys: ['c'],
+        screen: 'list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'create',
         when: (ctx) => ctx.screen === 'list',
     },
     {
@@ -19,6 +24,11 @@ const commands = [
         label: 'Edit item',
         category: 'Actions',
         shortcut: 'enter',
+        keys: [{ special: 'return' }],
+        screen: 'list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'edit',
         when: (ctx) => ctx.screen === 'list' && ctx.hasSelectedItem,
     },
     {
@@ -26,6 +36,11 @@ const commands = [
         label: 'Delete item',
         category: 'Actions',
         shortcut: 'd',
+        keys: ['d'],
+        screen: 'list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'delete',
         when: (ctx) => ctx.screen === 'list' && ctx.hasSelectedItem,
     },
     {
@@ -33,6 +48,9 @@ const commands = [
         label: 'Open in browser',
         category: 'Actions',
         shortcut: 'o',
+        keys: ['o'],
+        screen: 'list',
+        helpGroup: 'Actions',
         when: (ctx) => ctx.screen === 'list' && ctx.hasSelectedItem,
     },
     {
@@ -40,6 +58,9 @@ const commands = [
         label: 'Create branch/worktree',
         category: 'Actions',
         shortcut: 'b',
+        keys: ['b'],
+        screen: 'list',
+        helpGroup: 'Other',
         when: (ctx) => ctx.screen === 'list' && ctx.hasSelectedItem && ctx.gitAvailable,
     },
     {
@@ -47,6 +68,9 @@ const commands = [
         label: 'Refresh/sync',
         category: 'Actions',
         shortcut: 'r',
+        keys: ['r'],
+        screen: 'list',
+        helpGroup: 'Other',
         when: (ctx) => ctx.screen === 'list' && ctx.hasSyncManager,
     },
     {
@@ -54,6 +78,9 @@ const commands = [
         label: 'Order by...',
         category: 'Actions',
         shortcut: 'O',
+        keys: ['O'],
+        screen: 'list',
+        helpGroup: 'Actions',
         when: (ctx) => ctx.screen === 'list',
     },
     // Navigation
@@ -62,6 +89,9 @@ const commands = [
         label: 'Go to iterations',
         category: 'Navigation',
         shortcut: 'i',
+        keys: ['i'],
+        screen: 'list',
+        helpGroup: 'Switching',
         when: (ctx) => ctx.screen === 'list' && ctx.capabilities.iterations,
     },
     {
@@ -69,13 +99,21 @@ const commands = [
         label: 'Go to settings',
         category: 'Navigation',
         shortcut: ',',
+        keys: [','],
+        screen: 'list',
+        helpGroup: 'Switching',
+        footer: true,
+        footerLabel: 'settings',
         when: (ctx) => ctx.screen === 'list',
     },
     {
         id: 'status',
         label: 'Go to status',
         category: 'Navigation',
-        shortcut: 's',
+        shortcut: 'S',
+        keys: ['S'],
+        screen: 'list',
+        helpGroup: 'Switching',
         when: (ctx) => ctx.screen === 'list',
     },
     {
@@ -83,9 +121,10 @@ const commands = [
         label: 'Go to help',
         category: 'Navigation',
         shortcut: '?',
-        when: (ctx) => ctx.screen === 'list' ||
-            ctx.screen === 'branch-list' ||
-            ctx.screen === 'pr-list',
+        keys: ['?'],
+        screen: 'global',
+        footer: true,
+        footerLabel: 'help',
     },
     // Bulk
     {
@@ -93,6 +132,9 @@ const commands = [
         label: 'Mark/unmark item',
         category: 'Bulk',
         shortcut: 'm',
+        keys: ['m'],
+        screen: 'list',
+        helpGroup: 'Actions',
         when: (ctx) => ctx.screen === 'list' && ctx.hasSelectedItem,
     },
     {
@@ -100,12 +142,19 @@ const commands = [
         label: 'Clear all marks',
         category: 'Bulk',
         shortcut: 'M',
+        keys: ['M'],
+        screen: 'list',
+        helpGroup: 'Bulk',
         when: (ctx) => ctx.screen === 'list' && ctx.markedCount > 0,
     },
     {
         id: 'set-priority',
         label: 'Set priority',
         category: 'Bulk',
+        shortcut: 'y',
+        keys: ['y'],
+        screen: 'list',
+        helpGroup: 'Bulk',
         when: (ctx) => ctx.screen === 'list' &&
             ctx.capabilities.fields.priority &&
             (ctx.hasSelectedItem || ctx.markedCount > 0),
@@ -115,6 +164,9 @@ const commands = [
         label: 'Set assignee',
         category: 'Bulk',
         shortcut: 'a',
+        keys: ['a'],
+        screen: 'list',
+        helpGroup: 'Actions',
         when: (ctx) => ctx.screen === 'list' &&
             ctx.capabilities.fields.assignee &&
             (ctx.hasSelectedItem || ctx.markedCount > 0),
@@ -124,6 +176,9 @@ const commands = [
         label: 'Set labels',
         category: 'Bulk',
         shortcut: 'l',
+        keys: ['l'],
+        screen: 'list',
+        helpGroup: 'Actions',
         when: (ctx) => ctx.screen === 'list' &&
             ctx.capabilities.fields.labels &&
             (ctx.hasSelectedItem || ctx.markedCount > 0),
@@ -133,6 +188,9 @@ const commands = [
         label: 'Set type',
         category: 'Bulk',
         shortcut: 't',
+        keys: ['t'],
+        screen: 'list',
+        helpGroup: 'Bulk',
         when: (ctx) => ctx.screen === 'list' &&
             ctx.capabilities.customTypes &&
             (ctx.hasSelectedItem || ctx.markedCount > 0),
@@ -141,14 +199,19 @@ const commands = [
         id: 'bulk-menu',
         label: 'Bulk actions menu',
         category: 'Bulk',
-        shortcut: 'B',
-        when: (ctx) => ctx.screen === 'list' && ctx.markedCount > 0,
+        shortcut: 'x',
+        keys: ['x'],
+        screen: 'list',
+        helpGroup: 'Bulk',
     },
     {
         id: 'filter',
         label: 'Filter...',
         category: 'Actions',
         shortcut: 'F',
+        keys: ['F'],
+        screen: 'list',
+        helpGroup: 'Actions',
         when: (ctx) => ctx.screen === 'list',
     },
     {
@@ -156,6 +219,9 @@ const commands = [
         label: 'Clear filters',
         category: 'Actions',
         shortcut: 'X',
+        keys: ['X'],
+        screen: 'list',
+        helpGroup: 'Actions',
         when: (ctx) => ctx.screen === 'list' && ctx.hasActiveFilters,
     },
     {
@@ -163,26 +229,224 @@ const commands = [
         label: 'Load view...',
         category: 'Actions',
         shortcut: 'V',
+        keys: ['V'],
+        screen: 'list',
+        helpGroup: 'Actions',
         when: (ctx) => ctx.screen === 'list',
     },
     {
         id: 'save-view',
         label: 'Save current view...',
         category: 'Actions',
+        screen: 'list',
         when: (ctx) => ctx.screen === 'list' && ctx.hasActiveFilters,
     },
     {
         id: 'delete-view',
         label: 'Delete view...',
         category: 'Actions',
+        screen: 'list',
         when: (ctx) => ctx.screen === 'list' && ctx.hasSavedViews,
     },
+    // List-screen navigation
+    {
+        id: 'list-navigate',
+        label: 'Navigate items',
+        category: 'Navigation',
+        shortcut: '↑/↓',
+        keys: [{ special: 'upArrow' }, { special: 'downArrow' }],
+        screen: 'list',
+        helpGroup: 'Navigation',
+        footer: true,
+        footerLabel: 'navigate',
+    },
+    {
+        id: 'list-page',
+        label: 'Page up / page down',
+        category: 'Navigation',
+        shortcut: 'pgup/pgdn',
+        keys: [{ special: 'pageUp' }, { special: 'pageDown' }],
+        screen: 'list',
+        helpGroup: 'Navigation',
+    },
+    {
+        id: 'list-home-end',
+        label: 'Jump to first / last item',
+        category: 'Navigation',
+        shortcut: 'home/end',
+        keys: [{ special: 'home' }, { special: 'end' }],
+        screen: 'list',
+        helpGroup: 'Navigation',
+    },
+    {
+        id: 'list-collapse',
+        label: 'Collapse or jump to parent',
+        category: 'Navigation',
+        shortcut: '←',
+        keys: [{ special: 'leftArrow' }],
+        screen: 'list',
+        helpGroup: 'Navigation',
+        when: (ctx) => ctx.capabilities.relationships,
+    },
+    {
+        id: 'list-expand',
+        label: 'Expand children',
+        category: 'Navigation',
+        shortcut: '→',
+        keys: [{ special: 'rightArrow' }],
+        screen: 'list',
+        helpGroup: 'Navigation',
+        when: (ctx) => ctx.capabilities.relationships,
+    },
+    // List-screen actions missing from registry
+    {
+        id: 'list-undo',
+        label: 'Undo last action',
+        category: 'Actions',
+        shortcut: 'u',
+        keys: ['u'],
+        screen: 'list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'undo',
+    },
+    {
+        id: 'list-status',
+        label: 'Set status',
+        category: 'Actions',
+        shortcut: 's',
+        keys: ['s'],
+        screen: 'list',
+        helpGroup: 'Actions',
+    },
+    {
+        id: 'list-parent',
+        label: 'Set parent',
+        category: 'Actions',
+        shortcut: 'g',
+        keys: ['g'],
+        screen: 'list',
+        helpGroup: 'Actions',
+        when: (ctx) => ctx.capabilities.fields.parent,
+    },
+    {
+        id: 'list-pr-create',
+        label: 'Create pull request',
+        category: 'Actions',
+        shortcut: 'p',
+        keys: ['p'],
+        screen: 'list',
+        helpGroup: 'Actions',
+    },
+    {
+        id: 'list-pr-list',
+        label: 'Pull requests',
+        category: 'Navigation',
+        shortcut: 'P',
+        keys: ['P'],
+        screen: 'list',
+        helpGroup: 'Actions',
+    },
+    {
+        id: 'list-branch-manage',
+        label: 'Branch management',
+        category: 'Navigation',
+        shortcut: 'B',
+        keys: ['B'],
+        screen: 'list',
+        helpGroup: 'Actions',
+        when: (ctx) => ctx.gitAvailable,
+    },
+    {
+        id: 'list-range-select',
+        label: 'Range select',
+        category: 'Bulk',
+        shortcut: 'shift+↑↓',
+        keys: [
+            { special: 'upArrow', modifier: 'shift' },
+            { special: 'downArrow', modifier: 'shift' },
+        ],
+        screen: 'list',
+        helpGroup: 'Actions',
+    },
+    {
+        id: 'list-tab',
+        label: 'Cycle work item type',
+        category: 'Switching',
+        shortcut: 'tab',
+        keys: [{ special: 'tab' }],
+        screen: 'list',
+        helpGroup: 'Switching',
+        when: (ctx) => ctx.capabilities.customTypes,
+    },
+    {
+        id: 'list-toggle-description',
+        label: 'Toggle full description',
+        category: 'Other',
+        shortcut: 'space',
+        keys: [' '],
+        screen: 'list',
+        helpGroup: 'Other',
+    },
+    {
+        id: 'list-command-bar',
+        label: 'Command bar',
+        category: 'Actions',
+        shortcut: '/',
+        keys: ['/'],
+        screen: 'list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'commands',
+    },
+    // Navigation shared across sub-screens
+    {
+        id: 'nav-back',
+        label: 'Back to list',
+        category: 'Navigation',
+        shortcut: 'esc',
+        keys: [{ special: 'escape' }],
+        screen: ['pr-list', 'branch-list', 'iteration-picker'],
+        helpGroup: 'Navigation',
+        footer: true,
+        footerLabel: 'back',
+        when: (ctx) => ctx.screen === 'pr-list' ||
+            ctx.screen === 'branch-list' ||
+            ctx.screen === 'iteration-picker',
+    },
     // Branch list actions
+    {
+        id: 'branch-navigate',
+        label: 'Navigate branches',
+        category: 'Navigation',
+        shortcut: 'j/k',
+        keys: [{ special: 'upArrow' }, { special: 'downArrow' }],
+        screen: 'branch-list',
+        helpGroup: 'Navigation',
+        footer: true,
+        footerLabel: 'navigate',
+    },
+    {
+        id: 'branch-search',
+        label: 'Search branches',
+        category: 'Actions',
+        shortcut: '/',
+        keys: ['/'],
+        screen: 'branch-list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'search',
+    },
     {
         id: 'branch-switch',
         label: 'Switch to branch',
         category: 'Actions',
         shortcut: 'enter',
+        keys: [{ special: 'return' }],
+        screen: 'branch-list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'switch',
         when: (ctx) => ctx.screen === 'branch-list' &&
             ctx.hasSelectedBranch &&
             !ctx.isCurrentBranch,
@@ -192,6 +456,11 @@ const commands = [
         label: 'Create new branch',
         category: 'Actions',
         shortcut: 'c',
+        keys: ['c'],
+        screen: 'branch-list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'new',
         when: (ctx) => ctx.screen === 'branch-list',
     },
     {
@@ -199,6 +468,11 @@ const commands = [
         label: 'Delete branch',
         category: 'Actions',
         shortcut: 'd',
+        keys: ['d'],
+        screen: 'branch-list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'delete',
         when: (ctx) => ctx.screen === 'branch-list' &&
             ctx.hasSelectedBranch &&
             !ctx.isCurrentBranch,
@@ -208,6 +482,11 @@ const commands = [
         label: 'Merge into current',
         category: 'Actions',
         shortcut: 'm',
+        keys: ['m'],
+        screen: 'branch-list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'merge',
         when: (ctx) => ctx.screen === 'branch-list' &&
             ctx.hasSelectedBranch &&
             !ctx.isCurrentBranch,
@@ -217,6 +496,11 @@ const commands = [
         label: 'Push to remote',
         category: 'Actions',
         shortcut: 'P',
+        keys: ['P'],
+        screen: 'branch-list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'push',
         when: (ctx) => ctx.screen === 'branch-list' && ctx.hasSelectedBranch,
     },
     {
@@ -224,6 +508,9 @@ const commands = [
         label: 'Create PR for branch',
         category: 'Actions',
         shortcut: 'p',
+        keys: ['p'],
+        screen: 'branch-list',
+        helpGroup: 'Actions',
         when: (ctx) => ctx.screen === 'branch-list' &&
             ctx.hasSelectedBranch &&
             ctx.hasPrCreateCapability,
@@ -233,6 +520,11 @@ const commands = [
         label: 'Open worktree shell',
         category: 'Actions',
         shortcut: 'w',
+        keys: ['w'],
+        screen: 'branch-list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'worktree',
         when: (ctx) => ctx.screen === 'branch-list' && ctx.hasSelectedBranch && ctx.hasWorktree,
     },
     {
@@ -240,29 +532,223 @@ const commands = [
         label: 'Refresh branches',
         category: 'Actions',
         shortcut: 'r',
+        keys: ['r'],
+        screen: 'branch-list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'refresh',
         when: (ctx) => ctx.screen === 'branch-list',
     },
+    // PR list actions
     {
-        id: 'branch-back',
-        label: 'Back to items',
+        id: 'pr-navigate',
+        label: 'Navigate pull requests',
         category: 'Navigation',
-        shortcut: 'esc',
-        when: (ctx) => ctx.screen === 'branch-list',
+        shortcut: 'j/k',
+        keys: [{ special: 'upArrow' }, { special: 'downArrow' }],
+        screen: 'pr-list',
+        helpGroup: 'Navigation',
+        footer: true,
+        footerLabel: 'navigate',
     },
-    // PR list actions
     {
         id: 'pr-open',
         label: 'Open in browser',
         category: 'Actions',
-        shortcut: 'enter',
+        shortcut: 'enter/o',
+        keys: ['o', { special: 'return' }],
+        screen: 'pr-list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'open',
         when: (ctx) => ctx.screen === 'pr-list' && ctx.hasSelectedPr,
     },
     {
-        id: 'pr-back',
-        label: 'Back to items',
+        id: 'pr-search',
+        label: 'Search pull requests',
+        category: 'Actions',
+        shortcut: '/',
+        keys: ['/'],
+        screen: 'pr-list',
+        helpGroup: 'Actions',
+        footer: true,
+        footerLabel: 'search',
+    },
+    // Form commands
+    {
+        id: 'form-navigate',
+        label: 'Move between fields',
         category: 'Navigation',
+        shortcut: '↑/↓',
+        keys: [{ special: 'upArrow' }, { special: 'downArrow' }],
+        screen: 'form',
+        helpGroup: 'Navigation',
+    },
+    {
+        id: 'form-edit',
+        label: 'Edit field / open $EDITOR (description) / navigate to related item',
+        category: 'Actions',
+        shortcut: 'enter',
+        keys: [{ special: 'return' }],
+        screen: 'form',
+        helpGroup: 'Editing',
+    },
+    {
+        id: 'form-revert',
+        label: 'Revert field to previous value (in edit mode)',
+        category: 'Actions',
         shortcut: 'esc',
-        when: (ctx) => ctx.screen === 'pr-list',
+        keys: [{ special: 'escape' }],
+        screen: 'form',
+        helpGroup: 'Editing',
+    },
+    {
+        id: 'form-confirm',
+        label: 'Confirm field value',
+        category: 'Actions',
+        shortcut: 'enter/select',
+        screen: 'form',
+        helpGroup: 'Editing',
+    },
+    {
+        id: 'form-save',
+        label: 'Save and go back',
+        category: 'Actions',
+        shortcut: 's',
+        keys: ['s'],
+        screen: 'form',
+        helpGroup: 'Save & Exit',
+    },
+    {
+        id: 'form-back',
+        label: 'Go back (prompts to save/discard if unsaved changes)',
+        category: 'Navigation',
+        shortcut: 'esc',
+        keys: [{ special: 'escape' }],
+        screen: 'form',
+        helpGroup: 'Save & Exit',
+    },
+    // Iteration picker commands
+    {
+        id: 'iter-navigate',
+        label: 'Navigate iterations',
+        category: 'Navigation',
+        shortcut: '↑/↓',
+        keys: [{ special: 'upArrow' }, { special: 'downArrow' }],
+        screen: 'iteration-picker',
+        helpGroup: 'Navigation',
+    },
+    {
+        id: 'iter-select',
+        label: 'Select iteration',
+        category: 'Actions',
+        shortcut: 'enter',
+        keys: [{ special: 'return' }],
+        screen: 'iteration-picker',
+        helpGroup: 'Navigation',
+    },
+    // Settings commands
+    {
+        id: 'settings-navigate',
+        label: 'Navigate options',
+        category: 'Navigation',
+        shortcut: '↑/↓',
+        keys: [{ special: 'upArrow' }, { special: 'downArrow' }],
+        screen: 'settings',
+        helpGroup: 'Navigation',
+    },
+    {
+        id: 'settings-select',
+        label: 'Select or edit',
+        category: 'Actions',
+        shortcut: 'enter',
+        keys: [{ special: 'return' }],
+        screen: 'settings',
+        helpGroup: 'Navigation',
+    },
+    {
+        id: 'settings-back',
+        label: 'Go back',
+        category: 'Navigation',
+        shortcut: 'esc/,',
+        keys: [{ special: 'escape' }, ','],
+        screen: 'settings',
+        helpGroup: 'Navigation',
+    },
+    {
+        id: 'settings-edit',
+        label: 'Edit field value',
+        category: 'Actions',
+        shortcut: 'type',
+        screen: 'settings',
+        helpGroup: 'Editing',
+    },
+    {
+        id: 'settings-confirm',
+        label: 'Confirm',
+        category: 'Actions',
+        shortcut: 'enter/esc',
+        screen: 'settings',
+        helpGroup: 'Editing',
+    },
+    {
+        id: 'settings-create-template',
+        label: 'Create template',
+        category: 'Actions',
+        shortcut: 'c',
+        keys: ['c'],
+        screen: 'settings',
+        helpGroup: 'Templates',
+        when: (ctx) => ctx.capabilities.templates,
+    },
+    {
+        id: 'settings-delete-template',
+        label: 'Delete template',
+        category: 'Actions',
+        shortcut: 'd',
+        keys: ['d'],
+        screen: 'settings',
+        helpGroup: 'Templates',
+        when: (ctx) => ctx.capabilities.templates,
+    },
+    {
+        id: 'settings-edit-template',
+        label: 'Edit template',
+        category: 'Actions',
+        shortcut: 'enter',
+        keys: [{ special: 'return' }],
+        screen: 'settings',
+        helpGroup: 'Templates',
+        when: (ctx) => ctx.capabilities.templates,
+    },
+    // Status screen commands
+    {
+        id: 'status-scroll',
+        label: 'Scroll errors',
+        category: 'Navigation',
+        shortcut: '↑/↓',
+        keys: [{ special: 'upArrow' }, { special: 'downArrow' }],
+        screen: 'status',
+        helpGroup: 'Navigation',
+    },
+    {
+        id: 'status-back',
+        label: 'Go back',
+        category: 'Navigation',
+        shortcut: 'esc/q',
+        keys: [{ special: 'escape' }, 'q'],
+        screen: 'status',
+        helpGroup: 'Navigation',
+    },
+    {
+        id: 'status-retry',
+        label: 'Retry failed sync operations',
+        category: 'Actions',
+        shortcut: 'r',
+        keys: ['r'],
+        screen: 'status',
+        helpGroup: 'Actions',
+        when: (ctx) => ctx.hasSyncManager,
     },
     // Other
     {
@@ -270,6 +756,9 @@ const commands = [
         label: 'Toggle detail panel',
         category: 'Other',
         shortcut: 'v',
+        keys: ['v'],
+        screen: 'list',
+        helpGroup: 'Other',
         when: (ctx) => ctx.screen === 'list',
     },
     {
@@ -277,8 +766,69 @@ const commands = [
         label: 'Quit',
         category: 'Other',
         shortcut: 'q',
+        keys: ['q'],
+        screen: 'global',
+        helpGroup: 'Other',
         when: () => true,
     },
+    // Editor commands
+    {
+        id: 'editor-save',
+        label: 'Save and return',
+        category: 'Actions',
+        shortcut: 'Ctrl+S',
+        keys: [],
+        screen: 'editor',
+        helpGroup: 'Editor',
+    },
+    {
+        id: 'editor-cancel',
+        label: 'Cancel and return',
+        category: 'Navigation',
+        shortcut: 'Esc',
+        keys: [],
+        screen: 'editor',
+        helpGroup: 'Editor',
+    },
+    {
+        id: 'editor-undo',
+        label: 'Undo',
+        category: 'Actions',
+        shortcut: 'Ctrl+Z',
+        keys: [],
+        screen: 'editor',
+        helpGroup: 'Editor',
+    },
+    {
+        id: 'editor-redo',
+        label: 'Redo',
+        category: 'Actions',
+        shortcut: 'Ctrl+Shift+Z',
+        keys: [],
+        screen: 'editor',
+        helpGroup: 'Editor',
+    },
+    // Help screen commands
+    {
+        id: 'help-scroll',
+        label: 'Scroll help',
+        category: 'Navigation',
+        keys: [{ special: 'upArrow' }, { special: 'downArrow' }],
+        shortcut: '↑/↓',
+        screen: 'help',
+        helpGroup: 'Navigation',
+    },
+    {
+        id: 'help-back',
+        label: 'Go back',
+        category: 'Navigation',
+        keys: [{ special: 'escape' }],
+        shortcut: 'esc',
+        screen: 'help',
+        helpGroup: 'Navigation',
+        footer: true,
+        footerLabel: 'back',
+    },
 ];
 export function filterCommands(commands, query) {
     if (query.trim() === '')
@@ -297,7 +847,7 @@ export function groupCommandsByCategory(commands) {
     return groups;
 }
 export function getVisibleCommands(ctx) {
-    const visible = commands.filter((cmd) => cmd.when(ctx));
+    const visible = commands.filter((cmd) => !cmd.when || cmd.when(ctx));
     // Add dynamic switch-type commands
     if (ctx.screen === 'list' && ctx.capabilities.customTypes) {
         for (const type of ctx.types) {
@@ -309,10 +859,80 @@ export function getVisibleCommands(ctx) {
                 label: `Switch to ${plural}`,
                 category: 'Switching',
                 shortcut: 'tab',
+                screen: 'list',
                 when: () => true,
             });
         }
     }
     return visible;
 }
+export function findCommand(id) {
+    return commands.find((cmd) => cmd.id === id);
+}
+export function getCommandsForScreen(screen, ctx) {
+    return commands.filter((cmd) => {
+        const screens = cmd.screen;
+        if (screens === 'global') {
+            // global matches all
+        }
+        else if (Array.isArray(screens)) {
+            if (!screens.includes(screen))
+                return false;
+        }
+        else {
+            if (screens !== screen)
+                return false;
+        }
+        if (cmd.when && !cmd.when(ctx))
+            return false;
+        return true;
+    });
+}
+export function getFooterCommands(screen, ctx) {
+    return getCommandsForScreen(screen, ctx).filter((cmd) => cmd.footer);
+}
+export function buildFooterHints(screen, ctx, availableWidth) {
+    const footerCmds = getFooterCommands(screen, ctx);
+    const sep = '  ';
+    let result = '';
+    for (const cmd of footerCmds) {
+        if (!cmd.shortcut)
+            continue;
+        const label = cmd.footerLabel ?? cmd.label;
+        const entry = `${cmd.shortcut} ${label}`;
+        const candidate = result ? result + sep + entry : entry;
+        if (candidate.length > availableWidth)
+            break;
+        result = candidate;
+    }
+    return result;
+}
+export function matchesCommand(id, input, key) {
+    const cmd = findCommand(id);
+    if (!cmd?.keys)
+        return false;
+    return cmd.keys.some((k) => {
+        if (typeof k === 'string')
+            return input === k;
+        if (k.modifier === 'shift')
+            return key[k.special] && key['shift'];
+        return key[k.special] && !key['shift'];
+    });
+}
+export function groupByHelpGroup(commands) {
+    const groups = [];
+    const seen = new Map();
+    for (const cmd of commands) {
+        if (!cmd.helpGroup || !cmd.shortcut)
+            continue;
+        let group = seen.get(cmd.helpGroup);
+        if (!group) {
+            group = { label: cmd.helpGroup, shortcuts: [] };
+            seen.set(cmd.helpGroup, group);
+            groups.push(group);
+        }
+        group.shortcuts.push({ key: cmd.shortcut, description: cmd.label });
+    }
+    return groups;
+}
 //# sourceMappingURL=commands.js.map