/* SPDX-License-Identifier: GPL-3.0-only */
/* Local OLED status UI and bounded, direct-API recovery controls. */

#pragma once

#include "esp_err.h"
#include "local_ui_config.h"

#ifdef __cplusplus
extern "C" {
#endif

/*
 * Starts the low-priority status renderer and local recovery controls. The
 * task never becomes a broker client or serial writer. The OLED and buttons
 * are optional, so a missing display is not an error.
 */
esp_err_t local_status_ui_start(const local_ui_config_t *config);

/* Runtime settings are copied atomically and never expose display-frame ownership. */
esp_err_t local_status_ui_get_config(local_ui_config_t *config);
esp_err_t local_status_ui_apply_config(const local_ui_config_t *config);

/* Preserve a manually selected display diagnostic for a bounded interval. */
void local_status_ui_hold_for_diagnostics(void);

#ifdef __cplusplus
}
#endif