Package dev.turboism.sdk.ui.toolbar

Interface MainToolbarRegistry

public interface MainToolbarRegistry

Registry for declarative main-toolbar contributions.

Action IDs resolve through the contributing plugin's action registry. The runtime owns host widgets, UI-thread dispatch, localization, placement, collision policy, and cleanup. Retaining a descriptor does not establish that the main-toolbar provider is available on a real host.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static enum	MainToolbarRegistry.Anchor	Semantic anchors currently recognized by the main-toolbar provider contract.
static final record	MainToolbarRegistry.IconVariants	Toolkit-neutral icon resource variants for a toolbar button.
static final record	MainToolbarRegistry.MainToolbarButtonContribution	Declarative main-toolbar button with state-aware icon variants and typed placement.
static final record	MainToolbarRegistry.MainToolbarContribution	Legacy-compatible declarative main-toolbar descriptor.
static final record	MainToolbarRegistry.Placement	Typed placement relative to a known main-toolbar anchor.
static enum	MainToolbarRegistry.Position	Position rule for a toolbar contribution.

Method Summary

Modifier and Type	Method	Description
Registration	contribute(MainToolbarRegistry.MainToolbarContribution contribution)	Registers a legacy-compatible main-toolbar contribution.
default Registration	contributeButton(MainToolbarRegistry.MainToolbarButtonContribution contribution)	Registers a richer button contribution through its legacy-compatible representation.

Method Details

contribute

Registration contribute(MainToolbarRegistry.MainToolbarContribution contribution)

Registers a legacy-compatible main-toolbar contribution.

Parameters:

contribution - non-null contribution descriptor

Returns:

a closeable registration that removes the contribution

Throws:

NullPointerException - if contribution is null

contributeButton

default Registration contributeButton(MainToolbarRegistry.MainToolbarButtonContribution contribution)

Registers a richer button contribution through its legacy-compatible representation.

Parameters:

contribution - non-null button descriptor

Returns:

a closeable registration that removes the contribution

Throws:

NullPointerException - if contribution is null