repositories / dotfiles
dotfiles
bugabingas dorkfiles
owned by admin
quickshell/nuguland/features/connectivity/fixtures/suite.mjs
Raw// `just ui-test connectivity`: the registry connectivity feature in the real Bar
// inside nested niri, driven by real pointer and keyboard against the feature's
// Network and Bluetooth doubles. A secured network's passphrase is only ever
// masked presence: it survives a live service refresh, never close and reopen,
// while the expanded SSID is retained across close and reorientation.
// Then every designed state: bluetooth off, empty and populated, with visible
// trust and block toggles and a forget that arms first and disarms on every
// dismissal; a failed join
// with its next step; offline, no link of any kind, which turns the Bar chip
// into a strong warning and names the unplugged cable; wireless off; no
// wireless device, whose controls are disabled; and a wired link without
// wireless, which reads wired · connected and keeps the chip quiet.
// The suite contract (snapshot shape, helpers) is documented in .system/RULES.md.
export default async function connectivitySuite({ assert, snapshot, open, check, click, input, key, screenshot, within, call, fixture }) {
const connectivity = value => value.features.connectivity;
const service = value => connectivity(value).service;
const control = (value, name) => connectivity(value).controls[name];
const texts = value => connectivity(value).texts;
const passphrase = value => control(value, 'passphrase');
const expanded = value => connectivity(value).retained.expandedSsid === 'fixture-secure' && !!control(value, 'collapse fixture-secure');
const chip = value => value.chips.connectivity;
const quietChip = value => !chip(value).active && !chip(value).strong && chip(value).role === 'ui.accent';
const warningChip = value => chip(value).active && chip(value).strong && chip(value).role === 'warning';
let state = await open('connectivity', value => control(value, 'expand fixture-secure')?.rect);
state = await check('opening focuses the first network row', value => control(value, 'expand fixture-home')?.focused);
assert.equal(chip(state).label, 'network');
assert(quietChip(state), 'a joined network keeps the chip quiet');
assert(connectivity(state).items.networkRateRow, 'network rates render from the system service');
assert(control(state, 'wireless')?.checked && control(state, 'wireless').enabled, 'the wireless toggle is a checked noun');
assert(control(state, 'bluetooth') && !control(state, 'bluetooth').checked, 'the bluetooth toggle is an unchecked noun');
assert(control(state, 'scan for networks')?.enabled && control(state, 'scan for devices')?.enabled, 'each section has its own scan');
assert(texts(state).includes('connected'), 'the joined network is marked connected');
assert(!passphrase(state), 'no credential editor before a secured network expands');
assert.equal(connectivity(state).retained.expandedSsid, '');
assert(connectivity(state).items.bluetoothEmptyState && texts(state).includes('bluetooth is off') && control(state, 'turn on bluetooth'), 'bluetooth off is a sentence with its action');
assert(!texts(state).includes('trust') && !texts(state).includes('battery'), 'no device table header without devices');
assert(!connectivity(state).items.wiredStatus && !texts(state).some(text => text.startsWith('wired')), 'no wired line without a wired port');
await screenshot('connectivity-open');
click(control(state, 'expand fixture-secure').rect);
state = await check('secured network expands a focused masked editor', value => expanded(value) && passphrase(value)?.rect && passphrase(value).focused && passphrase(value).masked && !passphrase(value).filled);
assert(within(passphrase(state).rect, state.width, state.height));
assert(texts(state).includes('secured · fair signal') && !texts(state).some(text => text.includes('dBm')), 'security and signal in words, without the raw reading');
input('type', 'fixture-only');
state = await check('network secret remains represented only as masked presence', value => passphrase(value)?.filled && passphrase(value).masked && passphrase(value).text === '');
const editor = passphrase(state).id;
call('connectivity', 'externalUpdate');
state = await check('live network update preserves masked input and row identity', value => service(value).generation === 1 && expanded(value) && passphrase(value)?.filled && passphrase(value).masked && passphrase(value).id === editor && service(value).connects === 0 && texts(value).includes('secured · strong signal'));
await screenshot('connectivity-masked-update');
click(chip(state).rect);
await check('same Bar chip closes connectivity', value => !value.popup.open && value.popup.lastCloseReason === 'bar-toggle');
fixture('vertical');
await check('real Bar moves to vertical layout', value => value.orientation === 'vertical' && within(value.chips.connectivity.rect, value.width, value.height));
state = await open('connectivity', value => passphrase(value)?.rect);
state = await check('SSID survives close and reorientation but credential input does not', value => expanded(value) && passphrase(value) && !passphrase(value).filled && passphrase(value).masked && service(value).connects === 0);
await screenshot('connectivity-vertical');
click(passphrase(state).rect);
await check('passphrase editor takes focus by pointer', value => passphrase(value)?.focused);
input('type', 'fixture-only');
await check('typed passphrase is masked presence again', value => passphrase(value)?.filled && passphrase(value).masked);
key('Return');
state = await check('Enter joins once with the typed passphrase and collapses the row', value => service(value).connects === 1 && service(value).knownPassphrase && connectivity(value).retained.expandedSsid === '' && !passphrase(value) && !!control(value, 'expand fixture-secure'));
key('Escape');
await check('Escape closes connectivity', value => !value.popup.open);
fixture('horizontal');
await check('real Bar returns to horizontal layout', value => value.orientation === 'horizontal');
// Bluetooth: off, then on without devices, then a scan that finds one.
state = await open('connectivity', value => control(value, 'turn on bluetooth')?.rect);
click(control(state, 'turn on bluetooth').rect);
state = await check('powered bluetooth without devices says so and points at scan', value => control(value, 'bluetooth')?.checked && texts(value).includes('no devices') && texts(value).includes('put a device in pairing mode, then scan') && !control(value, 'turn on bluetooth') && !texts(value).includes('trust'));
await screenshot('connectivity-bluetooth-empty');
click(control(state, 'scan for devices').rect);
state = await check('a found device brings its row without a column header', value => !!control(value, 'disconnect fixture headphones') && texts(value).includes('connected') && !texts(value).includes('linked') && !texts(value).includes('trust') && !texts(value).includes('device') && !connectivity(value).items.bluetoothEmptyState && !texts(value).includes('no devices'));
for (const name of ['untrust device', 'block device', 'forget device'])
assert(control(state, name)?.rect.width >= 24 && control(state, name).rect.height >= 24, `${name} is a visible 24 px target`);
await screenshot('connectivity-bluetooth-devices');
// Trust and block are separate visible toggles, each with its own opposite.
click(control(state, 'untrust device').rect);
state = await check('untrust device leaves an untrusted device unblocked', value => texts(value).includes('untrusted') && !!control(value, 'trust device') && !!control(value, 'block device'));
click(control(state, 'trust device').rect);
state = await check('trust device trusts it again', value => texts(value).includes('trusted') && !!control(value, 'untrust device'));
click(control(state, 'block device').rect);
state = await check('block device marks the device blocked', value => control(value, 'unblock device')?.checked && texts(value).includes('trusted'));
click(control(state, 'unblock device').rect);
state = await check('unblock device clears the block', value => !!control(value, 'block device') && !control(value, 'block device').checked);
// Forgetting needs pairing again: it arms a confirmation below the row first.
const confirmForget = value => control(value, 'confirm forget device');
const forgetArmed = value => confirmForget(value)?.rect && control(value, 'forget device')?.checked && texts(value).includes('forget fixture headphones?') && !!control(value, 'disconnect fixture headphones') && within(connectivity(value).items.forgetConfirmation.rect, value.width, value.height);
click(control(state, 'forget device').rect);
state = await check('forget device arms a confirmation and keeps the device', value => forgetArmed(value));
await screenshot('connectivity-forget-armed');
key('Escape');
await check('Escape closes connectivity and disarms forget', value => !value.popup.open);
state = await open('connectivity', value => control(value, 'forget device')?.rect);
assert(!confirmForget(state) && !control(state, 'forget device').checked && control(state, 'disconnect fixture headphones'), 'connectivity reopens unarmed with the device kept');
click(control(state, 'forget device').rect);
state = await check('forget device arms again', value => forgetArmed(value));
click(control(state, 'cancel').rect);
state = await check('cancel disarms and returns focus to forget device', value => !confirmForget(value) && control(value, 'forget device')?.focused && !!control(value, 'disconnect fixture headphones'));
key('Return');
state = await check('Enter arms forget without forgetting', value => forgetArmed(value) && control(value, 'forget device').focused);
key('Tab');
await check('Tab reaches cancel before the confirmation', value => control(value, 'cancel')?.focused);
key('Tab');
await check('Tab reaches the explicit forget confirmation', value => confirmForget(value)?.focused);
key('Return');
state = await check('confirming forgets the device and moves focus to bluetooth', value => !control(value, 'disconnect fixture headphones') && texts(value).includes('no devices') && control(value, 'bluetooth')?.focused);
// A device that sends no name reads as a bluetooth device, never as its address.
click(control(state, 'scan for devices').rect);
state = await check('a nameless device renders as bluetooth device', value =>
control(value, 'connect bluetooth device') && texts(value).includes('bluetooth device') && !texts(value).some(text => text.includes('AA:BB')));
await screenshot('connectivity-nameless-device');
// A failed secured join names the problem and the next step in the panel.
call('connectivity', 'setScenario', 'failed');
state = await check('a failed join names its network and next step', value => texts(value).includes('could not join fixture-secure · check the passphrase') && quietChip(value));
await screenshot('connectivity-join-next-step');
// Offline, no link of any kind: the chip turns into a strong warning; the
// panel says why, the unplugged cable included.
call('connectivity', 'setScenario', 'offline');
state = await check('offline turns the chip into a strong warning', value => warningChip(value) && chip(value).title === 'network offline' && texts(value).includes('not connected · pick a network to join') && texts(value).includes('wired · unplugged') && !texts(value).includes('connected'));
await screenshot('connectivity-offline');
click(control(state, 'wireless').rect);
state = await check('wireless off empties the list into a sentence with its action', value => !service(value).wifiEnabled && !control(value, 'wireless').checked && texts(value).includes('wireless is off') && control(value, 'turn on wireless') && !control(value, 'scan for networks').enabled && warningChip(value));
await screenshot('connectivity-wireless-off');
click(control(state, 'turn on wireless').rect);
state = await check('turn on brings the networks back', value => service(value).wifiEnabled && control(value, 'wireless').checked && !!control(value, 'expand fixture-secure'));
// No wireless device: unavailable in words, controls disabled, a retry.
call('connectivity', 'setScenario', 'no-device');
state = await check('a missing device disables wireless and offers a retry', value => texts(value).includes('no wireless device') && !control(value, 'wireless').enabled && !control(value, 'wireless').checked && !control(value, 'scan for networks').enabled && control(value, 'find wireless device')?.enabled && warningChip(value));
await screenshot('connectivity-no-device');
click(control(state, 'find wireless device').rect);
await check('retry looks for the device again', value => service(value).retries === 1);
// A wired link without wireless is online: the panel says so and the chip stays quiet.
call('connectivity', 'setScenario', 'wired');
state = await check('a wired link without wireless reads wired · connected and quiets the chip', value => texts(value).includes('wired · connected') && connectivity(value).items.wiredStatus && texts(value).includes('no wireless device') && !texts(value).includes('start the wireless service or plug in an adapter') && !texts(value).includes('not connected · pick a network to join') && quietChip(value) && chip(value).title === 'network and bluetooth');
await screenshot('connectivity-wired');
call('connectivity', 'setScenario', 'no-device');
await check('without any link the missing device names its next step again', value => texts(value).includes('start the wireless service or plug in an adapter') && !texts(value).some(text => text.startsWith('wired')) && warningChip(value));
key('Escape');
await check('Escape closes connectivity and leaves the strong warning chip', value => !value.popup.open && warningChip(value) && chip(value).label === 'network');
await screenshot('connectivity-offline-bar');
// The vertical Bar trades the word for the wifi-off glyph and keeps the warning.
fixture('vertical');
await check('the vertical offline chip shows wifi-off with strong warning emphasis', value => value.orientation === 'vertical' && chip(value).icon === '\u{F05AA}' && warningChip(value));
await screenshot('connectivity-offline-vertical-bar');
call('connectivity', 'setScenario', 'wired');
await check('the vertical wired chip shows the ethernet glyph without emphasis', value => quietChip(value) && chip(value).icon === '\u{F0200}');
await screenshot('connectivity-wired-vertical-bar');
call('connectivity', 'setScenario', 'online');
await check('a joined network quiets the chip and restores the wifi glyph', value => quietChip(value) && chip(value).icon === '\u{F05A9}' && chip(value).title === 'network and bluetooth');
}