Disponibilidade de material de apoio

Esta cópia do catálogo contém as orientações inline abaixo, mas não inclui os seguintes caminhos de suporte. Eles são pré-requisitos externos, não arquivos incluídos:

• <support-root>/references/persistence-patterns.md
• <support-root>/references/state-structures.md
• <support-root>/references/moly-state-patterns.md

Solicite o material de apoio original ou uma instalação existente antes de usar uma etapa que dependa desses caminhos; este catálogo não identifica uma fonte de download verificada para eles. Resolva cada caminho em relação a essa instalação, inspecione seu conteúdo e verifique quaisquer licenças e pré-requisitos de execução aplicáveis. Não execute um comando nem afirme que um procedimento referenciado foi seguido até que seu arquivo necessário exista. Não fabrique os scripts ausentes nem trate um arquivo não relacionado com o mesmo nome como equivalente. Etapas independentes totalmente documentadas aqui podem prosseguir dentro do escopo autorizado do usuário; relate qualquer etapa dependente como indisponível.

Skill de Gerenciamento de Estado Robius

Melhores práticas para gerenciamento de estado e persistência em aplicações Makepad baseadas em bases de código Robrix e Moly.

Bases de código fonte:

• Robrix: Cliente de chat Matrix - AppState, SelectedRoom, persistência via serde
• Moly: Aplicação de chat com IA - Padrão Central Store, inicialização assíncrona, Preferências

Quando Usar

Use esta skill quando:

• Projetando a estrutura de estado da aplicação
• Implementando a persistência de estado
• Passando estado pela árvore de widgets
• Gerenciando o estado da UI entre sessões
• Palavras-chave: estado do app, estado makepad, persistência, Scope::with_data, salvar estado, carregar estado

Padrões de Produção

Para padrões de gerenciamento de estado prontos para produção, consulte o diretório _base/:

Estrutura do AppState

Definição do Estado Principal

use serde::{Serialize, Deserialize};
use std::collections::HashMap;
use matrix_sdk::ruma::OwnedRoomId;

/// App-wide state that is stored persistently across multiple app runs
/// and shared/updated across various parts of the app.
#[derive(Clone, Default, Debug, Serialize, Deserialize)]
pub struct AppState {
    /// The currently-selected room
    pub selected_room: Option<SelectedRoom>,

    /// Saved UI layout state for main view
    pub saved_layout_state: SavedLayoutState,

    /// Per-item saved states (e.g., per-space dock layouts)
    pub saved_state_per_item: HashMap<OwnedRoomId, SavedLayoutState>,

    /// Whether a user is currently logged in
    #[serde(skip)]  // Don't persist login state
    pub logged_in: bool,
}

/// Represents a currently selected item
#[derive(Clone, Debug, Serialize, Deserialize)]
pub enum SelectedRoom {
    JoinedRoom { room_name_id: RoomNameId },
    InvitedRoom { room_name_id: RoomNameId },
    Space { space_name_id: RoomNameId },
}

impl SelectedRoom {
    pub fn room_id(&self) -> &OwnedRoomId {
        match self {
            Self::JoinedRoom { room_name_id } => room_name_id.room_id(),
            Self::InvitedRoom { room_name_id } => room_name_id.room_id(),
            Self::Space { space_name_id } => space_name_id.room_id(),
        }
    }

    /// Upgrade from invited to joined state
    pub fn upgrade_invite_to_joined(&mut self, room_id: &RoomId) -> bool {
        match self {
            Self::InvitedRoom { room_name_id } if room_name_id.room_id() == room_id => {
                let name = room_name_id.clone();
                *self = Self::JoinedRoom { room_name_id: name };
                true
            }
            _ => false,
        }
    }
}

// Equality based on room_id only
impl PartialEq for SelectedRoom {
    fn eq(&self, other: &Self) -> bool {
        self.room_id() == other.room_id()
    }
}
impl Eq for SelectedRoom {}

Persistência de Estado de Layout/Dock

/// Um snapshot do estado do layout da UI para restauração
#[derive(Clone, Default, Debug, Serialize, Deserialize)]
pub struct SavedLayoutState {
    /// Todos os itens contidos no layout, chaveados por ID
    pub layout_items: HashMap<LiveIdSerde, LayoutItemSerde>,

    /// Itens atualmente abertos, chaveados por ID
    pub open_items: HashMap<LiveIdSerde, SelectedRoom>,

    /// Ordem em que os itens foram abertos (cronológica)

…