Luigit
repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by admin

quickshell/nuguland/features/launcher/fixtures/suite.mjs

Raw
// `just ui-test launcher`: the registry launcher feature in the real Bar inside
// nested niri, driven by real pointer and keyboard against the feature's
// Launcher double. Query, selection, scroll and the details disclosure live in
// the host's session object. Closing without a launch (Escape, outside click,
// the chip) keeps the query, which the reopened field holds fully selected, so
// typing replaces it; a launch (app or desktop action, keyboard or pointer)
// clears query and selection and closes the popup through the panel's
// `closeRequested` intent; the disclosure survives both. Without matches one
// empty state replaces results and actions. Apps start in title order; a
// launched app leads the empty query on reopen (the double's frecency stand-in).
// The suite contract (snapshot shape, helpers) is documented in .system/RULES.md.
export default async function launcherSuite({ assert, open, check, click, input, key, screenshot, within, call }) {
    const launcher = value => value.features.launcher;
    const service = value => launcher(value).service;
    const retained = value => launcher(value).retained;
    const item = (value, name) => launcher(value).items[name];
    const control = (value, name) => launcher(value).controls[name];
    const texts = value => launcher(value).texts;
    const search = value => item(value, 'searchField');
    const filtered = value => retained(value).query === 'terminal' && control(value, 'fixture terminal') && !control(value, 'fixture editor');
    const launched = (value, reason = 'launcher-activated') => !value.popup.open && value.popup.lastCloseReason === reason;
    const entryDetails = value => item(value, 'launcherEntryDetails');
    const emptyState = value => item(value, 'launcherEmptyState');
    // The empty state replaces both panes: no rows, no launch or detail controls.
    const emptied = value => !!emptyState(value)?.rect && !item(value, 'launcherDetails') && !control(value, 'open') && !control(value, 'fixture terminal') && !control(value, 'fixture editor');
    // A reopen after dismissal: the focused field holds the kept query.
    const restored = (value, query) => retained(value).query === query && search(value)?.focused && search(value).filled;
    // A reopen after a launch: the focused field is empty.
    const fresh = value => retained(value).query === '' && search(value)?.focused && !search(value).filled;

    // The terminal row sits above the editor row.
    const terminalFirst = value => control(value, 'fixture terminal')?.rect.y < control(value, 'fixture editor')?.rect.y;

    // A point on the output but off the popup card, for outside dismissal.
    function outsideRect(state) {
        const card = state.popup.card;
        const candidates = [
            { x: state.width - 14, y: state.height - 14, width: 6, height: 6 },
            { x: 8, y: state.height - 14, width: 6, height: 6 },
            { x: state.width - 14, y: 40, width: 6, height: 6 },
        ];
        const result = candidates.find(rect => rect.x + rect.width < card.x || rect.x > card.x + card.width || rect.y + rect.height < card.y || rect.y > card.y + card.height);
        assert(result && within(result, state.width, state.height), 'mapped output must contain an outside-click target');
        return result;
    }

    let state = await open('launcher', value => search(value)?.rect);
    assert(search(state).focused, 'launcher search must receive initial focus');
    assert(control(state, 'fixture terminal') && control(state, 'fixture editor'), 'both apps render');
    assert(!terminalFirst(state), 'without launches apps keep title order');
    assert.equal(retained(state).selectedId, 'editor', 'the first app is selected');
    assert(within(item(state, 'launcherDetails').rect, state.width, state.height), 'details inside output');
    assert.equal(service(state).rows, 2, 'the double serves two apps');
    assert(!control(state, 'expand details'), 'an app without desktop-entry facts offers no disclosure');
    assert(!emptyState(state), 'apps hide the empty state');
    assert(item(state, 'launcherDetailIcon')?.rect && texts(state).filter(text => text === 'fixture editor').length === 1 && !texts(state).includes('editor'),
        'the detail pane shows the icon and actions without repeating the selected row');
    await screenshot('launcher-apps');

    // An entry named by its desktop id reads as the app, its missing kind as app.
    call('launcher', 'setMachineNames', true);
    state = await check('a desktop id renders as the app name, never the id', value =>
        control(value, 'nautilus') && texts(value).includes('nautilus') && !texts(value).some(text => /org\.gnome|\.desktop/.test(text)));
    await screenshot('launcher-desktop-id');
    call('launcher', 'setMachineNames', false);
    state = await check('the desktop-id entry leaves the list', value => !control(value, 'nautilus') && control(value, 'fixture editor') && retained(value).selectedId === 'editor');

    // Escape keeps query and selection; the reopened query is selected, so arrows
    // still move the selection and a typed character replaces the query.
    input('type', 'fixture');
    state = await check('a query matching both apps keeps title order', value => retained(value).query === 'fixture' && control(value, 'fixture terminal') && control(value, 'fixture editor') && retained(value).selectedId === 'editor');
    key('Down');
    state = await check('Down selects the next app from the search field', value => retained(value).selectedId === 'terminal' && search(value).focused);
    assert(control(state, 'expand details') && !entryDetails(state) && !texts(state).includes('category'), 'desktop-entry facts wait behind a collapsed disclosure');
    key('Escape');
    await check('Escape closes launcher without launching', value => launched(value, 'escape-key') && service(value).activations === 0);
    state = await open('launcher', value => search(value)?.rect);
    state = await check('Escape kept the query and selection for the reopen', value => restored(value, 'fixture') && retained(value).selectedId === 'terminal');
    await screenshot('launcher-restored');
    key('Up');
    state = await check('Up works on the restored query', value => retained(value).query === 'fixture' && retained(value).selectedId === 'editor');
    key('Down');
    state = await check('Down returns to the terminal', value => retained(value).query === 'fixture' && retained(value).selectedId === 'terminal');
    input('type', 'd');
    state = await check('a typed character replaces the selected query instead of appending', value => retained(value).query === 'd' && control(value, 'fixture editor') && !control(value, 'fixture terminal') && retained(value).selectedId === 'editor' && !emptyState(value));
    await screenshot('launcher-replaced');
    key('BackSpace');
    input('type', 'term');
    state = await check('a typed query filters to the terminal', value => retained(value).query === 'term' && control(value, 'fixture terminal') && !control(value, 'fixture editor'));
    key('Return');
    state = await check('Enter launches the typed match once and closes', value => service(value).activations === 1 && service(value).launches.terminal === 1 && launched(value));

    state = await open('launcher', value => search(value)?.rect);
    state = await check('a keyboard launch cleared the query: the launched app leads the empty query on reopen', value => fresh(value) && terminalFirst(value) && retained(value).selectedId === 'terminal');
    await screenshot('launcher-frecent');
    click(control(state, 'expand details').rect);
    state = await check('the disclosure reveals desktop-entry facts', value => retained(value).detailsExpanded === true && control(value, 'collapse details') && within(entryDetails(value)?.rect, value.width, value.height) && texts(value).includes('category'));
    await screenshot('launcher-details');
    click(search(state).rect);
    await check('a click returns focus to the search field', value => search(value).focused);
    input('type', 'term');
    state = await check('a query keeps the disclosure open', value => retained(value).query === 'term' && control(value, 'fixture terminal') && !control(value, 'fixture editor') && entryDetails(value));
    key('ctrl+1');
    state = await check('Ctrl+1 runs the first desktop action and closes', value => service(value).actionActivations === 1 && service(value).activations === 1 && service(value).launches.terminal === 2 && launched(value));

    state = await open('launcher', value => search(value)?.rect);
    state = await check('a desktop action cleared the query; the disclosure stays open', value => fresh(value) && terminalFirst(value) && retained(value).selectedId === 'terminal' && entryDetails(value) && control(value, 'collapse details'));
    input('type', 'terminal');
    state = await check('launcher query filters without exposing editable text', value => filtered(value) && retained(value).selectedId === 'terminal');
    await screenshot('launcher-filtered');
    click(outsideRect(state));
    await check('outside click closes launcher without launching', value => launched(value, 'outside') && service(value).activations === 1);
    state = await open('launcher', value => search(value)?.rect);
    state = await check('the outside click kept the query', value => restored(value, 'terminal') && filtered(value));
    key('Return');
    state = await check('Enter launches the selected match of the restored query once and closes', value => service(value).activations === 2 && service(value).launches.terminal === 3 && launched(value));

    state = await open('launcher', value => search(value)?.rect);
    state = await check('launching the restored query cleared it', value => fresh(value) && terminalFirst(value));
    input('type', 'terminal');
    state = await check('typing filters before a pointer launch', value => filtered(value));
    click(control(state, 'open').rect);
    state = await check('pointer open launches once and closes', value => service(value).activations === 3 && service(value).actionActivations === 1 && launched(value));

    state = await open('launcher', value => search(value)?.rect);
    state = await check('a pointer launch cleared the query', value => fresh(value) && terminalFirst(value) && retained(value).selectedId === 'terminal');
    input('type', 'terminal');
    state = await check('typing filters the fresh query', value => filtered(value));
    click(state.chips.launcher.rect);
    await check('same Bar chip closes launcher without launching', value => launched(value, 'bar-toggle') && service(value).activations === 3);
    state = await open('launcher', value => search(value)?.rect);
    state = await check('the chip toggle kept the query', value => restored(value, 'terminal') && filtered(value));
    click(search(state).rect);
    input('type', 'x');
    state = await check('a click places the caret, so typing appends; the miss shows one empty state with clear search', value => retained(value).query === 'terminalx' && retained(value).selectedId === '' && emptied(value) && texts(value).includes('no apps match "terminalx"') && control(value, 'clear search')?.enabled === true);
    assert(within(control(state, 'clear search').rect, state.width, state.height), 'clear search inside output');
    await screenshot('launcher-no-matches');
    key('Return');
    state = await check('Enter without matches launches nothing and stays open', value => value.popup.open && value.popup.name === 'launcher' && service(value).activations === 3 && retained(value).query === 'terminalx');
    key('BackSpace');
    state = await check('clearing the extra character restores the match', value => filtered(value) && control(value, 'open')?.enabled === true && !emptyState(value));
    input('type', 'x');
    state = await check('the empty state returns for the miss', value => emptied(value) && search(value).focused);
    key('Tab');
    state = await check('Tab reaches clear search', value => control(value, 'clear search')?.focused === true);
    key('Return');
    state = await check('Enter on clear search empties the query and refocuses search', value => retained(value).query === '' && search(value).focused && control(value, 'fixture terminal') && control(value, 'fixture editor') && !emptyState(value));
    input('type', 'terminal');
    state = await check('typing after clearing filters again', value => filtered(value));
    click(control(state, 'collapse details').rect);
    state = await check('the disclosure collapses desktop-entry facts', value => retained(value).detailsExpanded === false && control(value, 'expand details') && !entryDetails(value));

    click(state.chips.launcher.rect);
    await check('same Bar chip closes launcher', value => launched(value, 'bar-toggle'));
    state = await open('launcher', value => search(value)?.rect);
    assert(restored(state, 'terminal') && filtered(state), 'launcher draft must survive close and reopen');
    assert(control(state, 'expand details') && !entryDetails(state), 'the collapsed disclosure survives close and reopen');

    call('launcher', 'setEmpty', true);
    state = await check('losing every app shows the miss for the retained query', value => service(value).empty === true && emptied(value) && texts(value).includes('no apps match "terminal"'));
    click(control(state, 'clear search').rect);
    state = await check('without a query the empty state says no apps exist and offers no action', value => retained(value).query === '' && emptied(value) && texts(value).includes('no apps found') && texts(value).includes('installed apps appear here') && !control(value, 'clear search') && search(value).focused);
    await screenshot('launcher-no-apps');
    call('launcher', 'setEmpty', false);
    state = await check('apps returning replace the empty state', value => control(value, 'fixture terminal') && control(value, 'fixture editor') && !emptyState(value) && retained(value).selectedId === 'terminal');
    key('Escape');
    await check('Escape closes launcher without launching', value => launched(value, 'escape-key') && service(value).activations === 3 && !launcher(value).open);
}