review: name the icon-only controls, and make two guards mean what they say

Acting on the review of #626.  No bugs; one suggestion and three nits.

The map's icon-only controls had no accessible name.  IconButton requires a
label by construction and AddToPlaylistButton supplies one, but the plain Button
and APIButton used for edit, delete and the catalog preview reached assistive tech
as unnamed buttons -- and my own Cypress fixtures carefully passed `aria-label`
on the same pattern while production did not, which is its own kind of tell.  All
four are named now, and named with the row's subject rather than the verb alone:
"Delete Water tank", not "Delete", because a table of pins otherwise offers a
screen reader a column of identical buttons.

A source guard holds that: it scans for controls that carry an icon and no label
text, and reports any without an `aria-label`.  Paired with a premise that it
found some, since a scanner matching nothing reads exactly like a clean file.

The Group guard asserted only that `<Group` appeared somewhere in the cell, which
would pass on an empty Group left beside the bare siblings it was meant to wrap.
It now checks that every control in the cell is inside the Group -- and the first
version of THAT was wrong too: it sliced from `<Group` to the end of the cell
rather than to `</Group>`, so controls after the closing tag still counted as
inside, and the empty-Group plant stayed green.  Slicing between the tags makes
it fail.

Coverage the review asked for: the Semantic size names the call sites actually
use (`small`, `big`, `huge`) rather than only the Mantine ones, since the
translation step was untested on the exact spellings that were broken; icon-only
buttons stay square while loading, when the glyph is replaced by a spinner sized
from the button's height; and `iconAfter`-only squares as well as `icon`-only.

On the size passthrough, which was flagged as the highest-risk change outside the
map: the buttons that grow are Settings' Shutdown and Reboot (`huge`, to 60px),
Settings' Upgrade and Save and Channels' Save (`big`, to 50px), and VideoPlayer's
Refresh (`large`, to 50px).  All six read as deliberate emphasis -- the two
biggest are the two destructive ones -- so they are left honoured rather than
re-broken at the call site.  `size='small'` resolves to `sm`, which is what the
accidental default already was, so the detail pages do not move.

1134 jest / 64 suites, 246 in ui-layout.cy.js, clean npm run build.
This commit is contained in:
Roland 2026-08-02 17:57:27 -06:00
parent b0a7c9da1e
commit f997f730e1
No known key found for this signature in database
GPG key ID: 1BA620CE6C9A4680
3 changed files with 146 additions and 3 deletions

View file

@ -71,8 +71,88 @@ describe('the map pin action cells', () => {
* message argument -- that is chai, and passing one throws rather than annotating.
* A rename of the marker would otherwise turn this into a test of nothing.
*/
expect({marker, found: cell !== undefined, grouped: !!cell?.includes('<Group')})
.toEqual({marker, found: true, grouped: true});
/*
* The Group must CONTAIN the cell's controls, not merely appear in it. Asserting
* that `<Group` is present anywhere would pass on an empty one left beside the
* bare siblings it was supposed to wrap.
*/
const between = (text, open, close) => {
const from = text.indexOf(open);
if (from === -1) return '';
const to = text.indexOf(close, from);
// An unclosed Group would otherwise swallow the rest of the cell, which is how
// the first version of this let an EMPTY Group pass with the controls left
// outside it.
return to === -1 ? '' : text.slice(from, to);
};
const inGroup = cell === undefined ? '' : between(cell, '<Group', '</Group>');
const controls = (text) =>
(text.match(/<(?:API)?Button\b|<IconButton\b|<AddToPlaylistButton\b/g) || []).length;
expect({
marker,
found: cell !== undefined,
grouped: !!cell?.includes('<Group'),
// Every control the cell has is inside the Group, none left outside it.
controlsInsideGroup: cell === undefined ? 0 : controls(inGroup),
controlsInCell: cell === undefined ? -1 : controls(cell),
}).toEqual({
marker, found: true, grouped: true,
controlsInsideGroup: cell === undefined ? 0 : controls(cell),
controlsInCell: cell === undefined ? -1 : controls(cell),
});
});
});
});
describe('the map\'s icon-only controls have accessible names', () => {
/*
* An icon-only Button carries no text, so without `aria-label` it reaches assistive tech
* as an unnamed button. `IconButton` requires a label by construction and
* AddToPlaylistButton supplies one; the plain Button and APIButton used for edit, delete
* and the catalog preview did not, and this change rewrote all three rows.
*
* In the source, for the same reason as the Group guard: these rows are built inside the
* module and fetched from the API.
*/
const openingTag = (text, at) => {
let depth = 0;
for (let i = at; i < text.length; i++) {
const c = text[i];
if (c === '{' || c === '(') depth += 1;
else if (c === '}' || c === ')') depth -= 1;
else if (c === '>' && depth === 0) return {tag: text.slice(at, i + 1), end: i};
}
return {tag: '', end: at};
};
/** Every `<Button>`/`<APIButton>` in the file whose only content is an icon. */
const iconOnlyControls = () => {
const found = [];
for (const match of source.matchAll(/<(?:API)?Button\b/g)) {
const {tag, end} = openingTag(source, match.index);
if (!/\bicon=/.test(tag)) continue;
// Self-closing, or immediately followed by another tag rather than by a label.
const following = source.slice(end + 1, end + 40).trim();
if (!(tag.endsWith('/>') || following.startsWith('<') || following.startsWith('}'))) {
continue;
}
found.push({line: source.slice(0, match.index).split('\n').length, tag});
}
return found;
};
it('finds the icon-only controls at all', () => {
// The premise. A scanner that matched nothing would report no offenders and read
// exactly like a file that was already correct.
expect(iconOnlyControls().length).toBeGreaterThan(2);
});
it('names every one of them', () => {
const unnamed = iconOnlyControls()
.filter(({tag}) => !/aria-label/.test(tag))
.map(({line, tag}) => `line ${line}: ${tag.split('\n')[0].trim()}`);
expect(unnamed).toEqual([]);
});
});