yera.ui.rendering.views.settings
Render validated configuration as Settings pages and fragments.
The module presents one coherent SettingsState across overview, profile,
provider, model, and appearance screens. Plain configuration values are escaped
as they enter HTML. Editable controls delegate to the shared schema renderer,
while read-only secret values reveal only whether a value is set.
Symbols
render_appearance_settings
render_appearance_settings(
state: SettingsState,
) → TrustedHTMLRender browser-local appearance settings.
Parameters
Loaded settings state used to provide the surrounding Settings page context.
Returns
Trusted HTML for the appearance settings form.
render_default_models_settings
render_default_models_settings(
state: SettingsState,
) → TrustedHTMLRender the active profile's default-model settings page.
Parameters
Loaded settings state containing the active profile and model catalogue.
Returns
Trusted HTML for editing the active profile's default model of each supported type.
render_model_settings
render_model_settings(
state: SettingsState,
model_type: str,
model_id: str,
) → TrustedHTMLRender one discovered model and its editable inference defaults.
Parameters
Loaded settings state containing the model catalogue.
Catalogue type containing the requested model.
Fully qualified identifier of the model to render.
Returns
Trusted HTML showing the model identity, capabilities, and editable inference defaults.
render_models_settings
render_models_settings(
state: SettingsState,
) → TrustedHTMLRender the model catalogue available to the active profile.
Parameters
Current Settings configuration state.
Returns
Trusted HTML containing the filterable model catalogue.
render_profile_settings
render_profile_settings(
state: SettingsState,
) → TrustedHTMLRender editable settings for the active profile.
Parameters
Settings state containing the active profile and its available provider connections.
Returns
Trusted HTML containing the active-profile settings form.
render_provider_connection_form
render_provider_connection_form(
state: SettingsState,
provider_type: str,
connection_name: str,
active: bool,
error: str | None = None,
) → TrustedHTMLRender an editor for an existing provider connection.
Parameters
Current Settings configuration state.
Provider key containing the connection.
Name of the connection to edit.
Whether the active profile selects this connection.
Optional validation or configuration conflict message.
Returns
Trusted HTML containing the provider connection form.
render_provider_connection_settings
render_provider_connection_settings(
state: SettingsState,
provider_type: str,
connection_name: str,
) → TrustedHTMLRender one configured provider connection.
Parameters
Loaded settings state containing provider and profile configuration.
Provider type containing the requested connection.
Name of the connection to render.
Returns
Trusted HTML for editing the selected provider connection.
render_providers_settings
render_providers_settings(
state: SettingsState,
open_provider: str | None = None,
open_connection: str | None = None,
) → TrustedHTMLRender the configured provider connections.
Parameters
Loaded settings state containing provider and profile configuration.
Optional provider type whose connection disclosure should be expanded.
Optional connection name to expand within
open_provider.
Returns
Trusted HTML listing the existing provider connections and their editable forms.
render_settings_home
render_settings_home(
state: SettingsState,
) → TrustedHTMLRender the top-level Settings navigation page.
Parameters
Loaded settings state used to identify the active profile.
Returns
Trusted HTML for the Settings overview.
render_settings_sidebar
render_settings_sidebar(
state: SettingsState,
current: str | None,
) → TrustedHTMLRender Settings navigation in the shell sidebar.
Parameters
Loaded settings state used to show the active profile and configuration path.
Key of the currently selected Settings destination, or
None when no destination is active.
Returns
Trusted HTML for the Settings sidebar.