Row height and spacing come from dialogLayout.bs (LIST_ROW_*), where the spacing gate covers them. LIST_ROW_SPACING matches JRLabelList's own default so the dialog's list has the same visual rhythm as every other list in the app.

Cancel this dialog from OUTSIDE — see cancelOpenDialog() in source/utils/dialogs.bs. Routed through resolveDialog so the once-only guard and the standard cancelled result both apply: a third party clearing the screen must be indistinguishable from the user pressing Back, or the owner waiting on the result is stranded.

Same close mechanics as JRDialog / OverviewDialog: removeChild + returnFocusTo.

A row is LIST_ROW_HEIGHT tall and the gaps sit BETWEEN rows, so n rows occupy n * height + (n - 1) * spacing. The two helpers below are inverses of each other; keeping them adjacent is what stops the pair drifting.

Screen-reader announcement, driven by the focus event itself rather than a guessed delay (see JRDialog.onButtonFocusChanged for the full reasoning).

Only the opening announcement is ours. The list is a real LabelList, which the platform narrates itself (focused row title plus a navigation hint), and there is nothing else in this dialog to announce.

Announce the dialog once the platform's own focus announcement is out of the way.

Resolve exactly once, then close. index = -1 means dismissed without choosing.

Most rows that fit in available. Add one spacing back before dividing, because the last row does not carry one. Never returns 0: a dialog with no visible rows is worse than one row over budget, and the caller has already established there is at least one option.

Lay out NOW, called by presentOverlayDialog once this dialog is attached.

The dialog is hidden until this returns, so there is no renderTracking to wait on — and none is needed, because localBoundingRect() answers while hidden. See dialogReveal.bs.