@spec actor_opts(Phoenix.LiveView.Socket.t()) :: keyword()

Keyword opts threading the acting user's uuid into context mutations.

Returns [actor_uuid: uuid], or [] when there is no current user (so the context call is unaffected).

@spec actor_uuid(Phoenix.LiveView.Socket.t()) :: String.t() | nil

The current user's uuid from socket assigns, or nil.

@spec list_roles() :: [struct()]

All roles (for pickers); [] when the roles API is unavailable.

@spec manageable_by?(map(), String.t() | nil) :: boolean()

Whether actor_uuid may manage (edit/delete) dashboard: own personal ones, or any shared/role one (the admin section is already owner/admin-gated). Takes the actor uuid so socket callers (actor_uuid(socket)) and render-side callers (the current-user uuid) share one rule — replacing the former can_delete? / deletable? / can_manage? triplet.

@spec scope_label(String.t()) :: String.t()

Translated label for a dashboard scope enum value.

@spec translate_catalog(String.t() | nil) :: String.t() | nil

Dynamic translation for catalog DATA (widget names, descriptions, view names, settings labels — plain strings from the provider contract). Falls back to the input when no translation exists, so provider strings pass through.

@spec user_role_uuids(Phoenix.LiveView.Socket.t()) :: [String.t()]

The current user's role uuids, mapped from the scope's cached role names — used by both LiveViews to resolve role-scoped dashboard visibility. Reuses a @roles assign if present, else queries core once. [] when roles are unavailable.

@spec viewable_by?(map(), Phoenix.LiveView.Socket.t()) :: boolean()

Whether dashboard is viewable by the socket's user (own personal · any shared/system · role dashboards for the user's roles). The single view rule, shared by the list page and the builder so the two never disagree.