Struct DashboardRegistry 

pub struct DashboardRegistry { /* private fields */ }

Ordered, id-keyed collection of sections.

Shadowing, not overwriting. A later registration for an id that is already taken is appended, and the id resolves to the LAST entry. That makes replace-by-id (CR.4’s stated capability — a plugin replacing getting-started) a stack rather than a destructive write, so unregister_plugin is a plain retain and the displaced builtin resurfaces on its own. The alternative — overwrite, and save the previous occupant somewhere for unload to put back — is explicit bookkeeping across three unload paths, and the kind that gets forgotten on one of them.

Implementations

impl DashboardRegistry

pub fn new() -> Self

pub fn into_handle(self) -> DashboardRegistryHandle

Wrap this registry in a fresh DashboardRegistryHandle, so consumers do not each have to name arc_swap.

pub fn register(&mut self, section: Arc<dyn DashboardSection>) -> &mut Self

Register a section.

A registration for an id already held by a different owner shadows it (see the type docs). A registration by the same owner for the same id replaces in place, so re-running builtin_registry stays idempotent and a plugin reload cannot grow the shadow stack.

pub fn unregister_plugin(&mut self, plugin_id: u64) -> usize

Drop every section contributed by plugin_id, returning how many were removed. Idempotent: a second call reports zero.

A builtin the plugin had shadowed becomes visible again with no restore step, because it was never removed — that is the whole reason register appends.

pub fn resolve(&self, id: &str) -> Option<&Arc<dyn DashboardSection>>

The section that currently owns id — the last registration for it.

pub fn ids(&self) -> Vec<&str>

All registered ids, de-duplicated, in FIRST-registration order (not the display order).

First-registration order rather than last: a plugin replacing a builtin keeps the slot the builtin occupied, so loading a plugin does not reshuffle the list a user reads.

pub fn ordered( &self, selection: &SectionSelection, ) -> Vec<Arc<dyn DashboardSection>>

Resolve the display order for a selection.

Unknown ids in an explicit selection are skipped with a logged warning (never a hard error — a stale dashboard.sections entry must not break the page).

pub fn compose( &self, ctx: &DashboardCtx, selection: &SectionSelection, ) -> Vec<DashboardFragment>

Render the selected sections in order to their fragments.

Trait Implementations

impl Clone for DashboardRegistry

fn clone(&self) -> DashboardRegistry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for DashboardRegistry

fn default() -> DashboardRegistry

Returns the “default value” for a type.