/**
* Keyboard reachability.
*
* Tabbing through the whole app used to yield fourteen stops, every one
* of them chrome: the sidebar was a list of `
`, a track list
* had no tab stop at all, and the *closed* queue panel still had two
* (`.planning/audits/2026-08-11-ui/hands-on.md`, H-5).
*/
import { describe, expect, it, beforeEach } from 'vitest';
import '@components/sidebar/app-sidebar';
import '@components/queue-panel/queue-panel';
import '@components/track-list/track-list';
import { stub } from '@test/support/harness';
import { fixture, shadow, shadowAll, update } from '@test/support/render';
/** Two fixture tracks, enough to move a focus ring between. */
const TRACKS = [
{
FilePath: '/music/a.mp3',
TrackName: 'Alpha',
ArtistName: 'One',
Album: 'First',
Duration: 100,
},
{
FilePath: '/music/b.mp3',
TrackName: 'Beta',
ArtistName: 'Two',
Album: 'First',
Duration: 120,
},
] as never[];
describe(' is reachable', () => {
it('renders every destination as a button, not a bare list item', async () => {
const el = await fixture('app-sidebar');
const items = shadowAll(el, 'li button');
expect(items).toHaveLength(11);
expect(items.every((item) => item.tagName === 'BUTTON')).toBe(true);
});
it('puts the nav in a landmark, so it can be jumped to', async () => {
const el = await fixture('app-sidebar');
expect(shadow(el, 'nav')?.getAttribute('aria-label')).toBe('Main');
});
});
describe(' when closed', () => {
it('is inert, so its buttons are not tab stops', async () => {
const el = await fixture('queue-panel');
expect(el.inert).toBe(true);
});
it('is not inert once opened', async () => {
const el = await fixture('queue-panel');
await update(el, { open: true });
expect(el.inert).toBe(false);
});
});
describe(' roving tabindex', () => {
beforeEach(() => {
stub('library.Library.GetTracks', TRACKS);
});
it('offers exactly one tab stop, however many rows there are', async () => {
const el = await fixture('track-list', { externalTracks: TRACKS });
const stops = shadowAll(el, '.track-row[tabindex="0"]');
expect(stops).toHaveLength(1);
});
it('gives the rows grid semantics rather than none', async () => {
const el = await fixture('track-list', { externalTracks: TRACKS });
const row = shadow(el, '.track-row');
expect({
row: row?.getAttribute('role'),
grid: shadow(el, '.table-container')?.getAttribute('role'),
cell: shadow(el, '.track-row .cell')?.getAttribute('role'),
}).toEqual({ row: 'row', grid: 'grid', cell: 'gridcell' });
});
it('moves the tab stop with the arrow keys', async () => {
const el = await fixture('track-list', { externalTracks: TRACKS });
shadow(el, '.table-container')?.dispatchEvent(
new KeyboardEvent('keydown', {
key: 'ArrowDown',
bubbles: true,
cancelable: true,
}),
);
await el.updateComplete;
expect(
shadow(el, '.track-row[tabindex="0"]')?.getAttribute('data-index'),
).toBe('1');
});
it('claims the tracklist shortcut scope while it is on screen', async () => {
const el = await fixture('track-list', { externalTracks: TRACKS });
expect(el.dataset['shortcutScope']).toBe('tracklist');
});
});