Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import { describe, expect, it } from 'vitest'
import {
findKeybindingConflicts,
isDigitIndexActionId,
keybindingFromInputForAction,
matchKeybindingDigitIndex,
normalizeKeybindingArrayForAction,
normalizeKeybindingListForAction
} from './keybindings'
describe('digit-index shortcuts', () => {
const digitInput = (
digit: string,
modifiers: { meta?: boolean; control?: boolean; alt?: boolean; shift?: boolean }
): Parameters<typeof matchKeybindingDigitIndex>[1] => ({
key: digit,
code: `Digit${digit}`,
meta: Boolean(modifiers.meta),
control: Boolean(modifiers.control),
alt: Boolean(modifiers.alt),
shift: Boolean(modifiers.shift)
})
it('flags the two ranged actions as digit-index rows', () => {
expect(isDigitIndexActionId('tab.selectByIndex')).toBe(true)
expect(isDigitIndexActionId('workspace.selectByIndex')).toBe(true)
expect(isDigitIndexActionId('tab.newTerminal')).toBe(false)
})
it('resolves the default ranges per platform', () => {
// macOS: workspace = Cmd+1-9, tab = Ctrl+1-9.
expect(
matchKeybindingDigitIndex(
'workspace.selectByIndex',
digitInput('3', { meta: true }),
'darwin'
)
).toBe(2)
expect(
matchKeybindingDigitIndex('tab.selectByIndex', digitInput('3', { meta: true }), 'darwin')
).toBeNull()
expect(
matchKeybindingDigitIndex('tab.selectByIndex', digitInput('3', { control: true }), 'darwin')
).toBe(2)
// Windows/Linux: workspace = Ctrl+1-9, tab = Alt+1-9.
expect(
matchKeybindingDigitIndex(
'workspace.selectByIndex',
digitInput('4', { control: true }),
'linux'
)
).toBe(3)
expect(
matchKeybindingDigitIndex('tab.selectByIndex', digitInput('4', { alt: true }), 'linux')
).toBe(3)
})
it.each([
['1', '¡'],
['2', '™'],
['3', '£'],
['4', '¢'],
['5', '∞'],
['6', '§'],
['7', '¶'],
['8', '•'],
['9', 'ª']
])('captures and matches macOS Option+%s composed as %s', (digit, key) => {
const input = { ...digitInput(digit, { alt: true }), key }
for (const actionId of ['tab.selectByIndex', 'workspace.selectByIndex'] as const) {
expect(keybindingFromInputForAction(actionId, input, 'darwin')).toEqual({
ok: true,
value: 'Alt+1'
})
expect(matchKeybindingDigitIndex(actionId, input, 'darwin', { [actionId]: ['Alt+1'] })).toBe(
Number(digit) - 1
)
expect(matchKeybindingDigitIndex(actionId, input, 'darwin')).toBeNull()
expect(matchKeybindingDigitIndex(actionId, input, 'darwin', { [actionId]: [] })).toBeNull()
}
})
it.each(['linux', 'win32'] as const)(
'preserves composed Alt and AltGr input on %s',
(platform) => {
const input = { ...digitInput('2', { alt: true }), key: '™' }
expect(keybindingFromInputForAction('tab.selectByIndex', input, platform).ok).toBe(false)
expect(
matchKeybindingDigitIndex('tab.selectByIndex', input, platform, {
'tab.selectByIndex': ['Alt+1']
})
).toBeNull()
const altGr = { ...input, control: true }
expect(keybindingFromInputForAction('tab.selectByIndex', altGr, platform).ok).toBe(false)
expect(
matchKeybindingDigitIndex('tab.selectByIndex', altGr, platform, {
'tab.selectByIndex': ['Mod+Alt+1']
})
).toBeNull()
}
)
it('keeps logical keys ahead of macOS Option digit codes', () => {
const input = { ...digitInput('2', { alt: true }), key: '3' }
expect(keybindingFromInputForAction('tab.selectByIndex', input, 'darwin')).toEqual({
ok: true,
value: 'Alt+1'
})
expect(
matchKeybindingDigitIndex('tab.selectByIndex', input, 'darwin', {
'tab.selectByIndex': ['Alt+1']
})
).toBe(2)
expect(
matchKeybindingDigitIndex('tab.selectByIndex', { ...input, key: '[' }, 'darwin', {
'tab.selectByIndex': ['Alt+1']
})
).toBeNull()
})
it('requires matching modifiers and excludes zero from digit-index ranges', () => {
const input = { ...digitInput('2', { alt: true, shift: true }), key: '€' }
expect(
matchKeybindingDigitIndex('tab.selectByIndex', input, 'darwin', {
'tab.selectByIndex': ['Alt+1']
})
).toBeNull()
expect(
matchKeybindingDigitIndex('tab.selectByIndex', input, 'darwin', {
'tab.selectByIndex': ['Alt+Shift+1']
})
).toBe(1)
const zero = { ...digitInput('0', { alt: true }), key: 'º' }
expect(keybindingFromInputForAction('tab.selectByIndex', zero, 'darwin').ok).toBe(false)
expect(
matchKeybindingDigitIndex('tab.selectByIndex', zero, 'darwin', {
'tab.selectByIndex': ['Alt+1']
})
).toBeNull()
expect(
matchKeybindingDigitIndex(
'tab.selectByIndex',
{ ...input, alt: false, control: true },
'darwin',
{
'tab.selectByIndex': ['Ctrl+Shift+1']
}
)
).toBeNull()
})
it('ignores non-range presses and extra modifiers', () => {
expect(
matchKeybindingDigitIndex(
'workspace.selectByIndex',
digitInput('3', { meta: true, shift: true }),
'darwin'
)
).toBeNull()
expect(
matchKeybindingDigitIndex(
'tab.selectByIndex',
{ key: 'p', code: 'KeyP', meta: false, control: true, alt: false, shift: false },
'darwin'
)
).toBeNull()
})
it('honors custom bindings, including swapping tab and workspace modifiers', () => {
const swapped = {
'tab.selectByIndex': ['Mod+1'],
'workspace.selectByIndex': ['Ctrl+1']
}
expect(
matchKeybindingDigitIndex(
'tab.selectByIndex',
digitInput('5', { meta: true }),
'darwin',
swapped
)
).toBe(4)
expect(
matchKeybindingDigitIndex(
'workspace.selectByIndex',
digitInput('5', { control: true }),
'darwin',
swapped
)
).toBe(4)
expect(
matchKeybindingDigitIndex('tab.selectByIndex', digitInput('5', { control: true }), 'darwin', {
'tab.selectByIndex': []
})
).toBeNull()
})
it('respects the terminal-first context gate', () => {
expect(
matchKeybindingDigitIndex(
'tab.selectByIndex',
digitInput('2', { control: true }),
'darwin',
undefined,
{
context: 'terminal',
terminalShortcutPolicy: 'terminal-first'
}
)
).toBeNull()
expect(
matchKeybindingDigitIndex(
'tab.selectByIndex',
digitInput('2', { control: true }),
'darwin',
undefined,
{
context: 'terminal',
terminalShortcutPolicy: 'orca-first'
}
)
).toBe(1)
})
it('canonicalizes a captured chord to the digit-1 representative', () => {
expect(
keybindingFromInputForAction(
'workspace.selectByIndex',
digitInput('7', { meta: true }),
'darwin'
)
).toEqual({ ok: true, value: 'Mod+1' })
expect(
keybindingFromInputForAction(
'tab.selectByIndex',
digitInput('9', { control: true }),
'darwin'
)
).toEqual({ ok: true, value: 'Ctrl+1' })
expect(
keybindingFromInputForAction(
'tab.selectByIndex',
{ key: 'p', code: 'KeyP', meta: true, control: false, alt: false, shift: false },
'darwin'
)
).toMatchObject({ ok: false })
})
it('allows extra modifiers (e.g. Shift) on a digit-index chord', () => {
expect(
keybindingFromInputForAction(
'tab.selectByIndex',
digitInput('5', { control: true, shift: true }),
'darwin'
)
).toEqual({ ok: true, value: 'Ctrl+Shift+1' })
expect(normalizeKeybindingListForAction('workspace.selectByIndex', 'Mod+Shift+5')).toEqual([
'Mod+Shift+1'
])
})
it('matches via the physical-code fallback when the key value is unavailable', () => {
// macOS/IME edge cases can leave key empty while code carries the digit.
expect(
matchKeybindingDigitIndex(
'tab.selectByIndex',
{ key: '', code: 'Digit5', meta: false, control: true, alt: false, shift: false },
'darwin'
)
).toBe(4)
})
it('canonicalizes stored bindings and rejects non-number chords', () => {
expect(normalizeKeybindingListForAction('workspace.selectByIndex', 'Mod+5')).toEqual(['Mod+1'])
expect(normalizeKeybindingArrayForAction('tab.selectByIndex', ['Ctrl+9'])).toEqual(['Ctrl+1'])
expect(normalizeKeybindingListForAction('tab.selectByIndex', 'Mod+P')).toMatchObject({
ok: false
})
})
it('lets the two ranges swap modifiers without a false conflict', () => {
// Tab/workspace ranges can swap modifiers because their scopes differ.
expect(
findKeybindingConflicts('darwin', {
'tab.selectByIndex': ['Mod+1'],
'workspace.selectByIndex': ['Ctrl+1']
})
).toEqual([])
})
})