Optionalenabledfalse draws the pill disabled.
OptionaliconStable id: the pill's data-action, and the key UIManager.removeTopBarAction takes.
OptionalmenuRows behind a caret: the pill becomes a split button, the label running onclick
and the caret opening these. The same row type as the context menus, without
submenu. The function form gets the context, so a row can prompt too; it is called
on every refresh and every open, and no rows means no caret.
OptionalonclickRuns on a click, or Enter / Space on the focused pill. A returned promise disables the pill until it settles, so a slow save cannot be started twice, then refreshes every action.
Optionalplacement'start' follows the built-in pills on the left; 'end' sits just before the
undo-redo group on the right. Declaration order within each.
OptionalshortcutShown as a badge on the pill. Visual only: the binding is the host's to register.
OptionalsvgThe label: "Save as graph", then "Update graph" once saved.
OptionaltitleShown on hover.
Optionalvisiblefalse draws no pill.
One host pill in the top bar: an action on the whole canvas, such as saving it. Every function field is re-read on UIManager.refreshTopBar, after a data change, and once an
onclickthat returned a promise settles.