/** * @license * Copyright 2025 Google LLC * SPDX-License-Identifier: Apache-2.0 */ import { describe, it, expect } from 'vitest'; import type { KeyBindingConfig } from './keyBindings.js'; import { Command, commandCategories, commandDescriptions, defaultKeyBindings, } from './keyBindings.js'; describe('keyBindings config', () => { describe('defaultKeyBindings', () => { it('should have bindings for all commands', () => { const commands = Object.values(Command); for (const command of commands) { expect(defaultKeyBindings[command]).toBeDefined(); expect(Array.isArray(defaultKeyBindings[command])).toBe(true); expect(defaultKeyBindings[command]?.length).toBeGreaterThan(0); } }); it('should have valid key binding structures', () => { for (const [_, bindings] of Object.entries(defaultKeyBindings)) { for (const binding of bindings) { // Each binding must have a key name expect(typeof binding.key).toBe('string'); expect(binding.key.length).toBeGreaterThan(0); // Modifier properties should be boolean or undefined if (binding.shift !== undefined) { expect(typeof binding.shift).toBe('boolean'); } if (binding.alt !== undefined) { expect(typeof binding.alt).toBe('boolean'); } if (binding.ctrl !== undefined) { expect(typeof binding.ctrl).toBe('boolean'); } if (binding.cmd !== undefined) { expect(typeof binding.cmd).toBe('boolean'); } } } }); it('should export all required types', () => { // Basic type checks expect(typeof Command.HOME).toBe('string'); expect(typeof Command.END).toBe('string'); // Config should be readonly const config: KeyBindingConfig = defaultKeyBindings; expect(config[Command.HOME]).toBeDefined(); }); it('should have correct specific bindings', () => { // Verify navigation ignores shift const navUp = defaultKeyBindings[Command.NAVIGATION_UP]; expect(navUp).toContainEqual({ key: 'up', shift: false }); const navDown = defaultKeyBindings[Command.NAVIGATION_DOWN]; expect(navDown).toContainEqual({ key: 'down', shift: false }); // Verify dialog navigation const dialogNavUp = defaultKeyBindings[Command.DIALOG_NAVIGATION_UP]; expect(dialogNavUp).toContainEqual({ key: 'up', shift: false }); expect(dialogNavUp).toContainEqual({ key: 'k', shift: false }); const dialogNavDown = defaultKeyBindings[Command.DIALOG_NAVIGATION_DOWN]; expect(dialogNavDown).toContainEqual({ key: 'down', shift: false }); expect(dialogNavDown).toContainEqual({ key: 'j', shift: false }); // Verify physical home/end keys for cursor movement expect(defaultKeyBindings[Command.HOME]).toContainEqual({ key: 'home', ctrl: false, shift: false, }); expect(defaultKeyBindings[Command.END]).toContainEqual({ key: 'end', ctrl: false, shift: false, }); // Verify physical home/end keys for scrolling expect(defaultKeyBindings[Command.SCROLL_HOME]).toContainEqual({ key: 'home', ctrl: true, }); expect(defaultKeyBindings[Command.SCROLL_END]).toContainEqual({ key: 'end', ctrl: true, }); }); }); describe('command metadata', () => { const commandValues = Object.values(Command); it('has a description entry for every command', () => { const describedCommands = Object.keys(commandDescriptions); expect(describedCommands.sort()).toEqual([...commandValues].sort()); for (const command of commandValues) { expect(typeof commandDescriptions[command]).toBe('string'); expect(commandDescriptions[command]?.trim()).not.toHaveLength(0); } }); it('categorizes each command exactly once', () => { const seen = new Set(); for (const category of commandCategories) { expect(typeof category.title).toBe('string'); expect(Array.isArray(category.commands)).toBe(true); for (const command of category.commands) { expect(commandValues).toContain(command); expect(seen.has(command)).toBe(false); seen.add(command); } } expect(seen.size).toBe(commandValues.length); }); }); });