Struct SettingsRecords 

pub struct SettingsRecords { /* private fields */ }

The settings sections an app keeps as records, held by a host without a window: the session, which keeps them for the palette and agents whether or not the app is open. Each is published and changed as the app’s window does it, so a change checks the section’s model and is recorded in the settings document with what made it and who; admitting an invocation (the invoker’s grants) is the caller’s, from the published action.

Implementations

impl SettingsRecords

pub fn new(app_id: &'static str, declare: Declare) -> Self

The settings sections declare declares, of the app app_id, as they are stored now.

pub fn in_document( app_id: &'static str, declares: &[Declare], document: SettingsDocument, ) -> Self

The settings sections declares declare, of the app app_id, as document stores them.

pub fn of_person( app_id: &'static str, app_title: &'static str, declares: &[Declare], records: PersonRecords, ) -> Self

The settings sections declares declare, of the app app_id (titled app_title), as the app’s window keeps them for the person whose records hold their shared records: each change is stored in the session’s settings document with what made it and who, and is a step of its invoker’s, undone and redone like any of theirs.

pub fn of_person_named( app_id: &'static str, app_title: &'static str, person: &str, earlier: &[String], declares: &[Declare], ) -> Self

The settings sections declares declare, of the app app_id (titled app_title), changed by person: each change is stored in the session’s settings document with what made it and who, and is a step of its invoker’s, undone and redone like any of theirs. earlier are the ids they went by before this device had an identity: what was changed under one is theirs to take back. The sections’ history is the settings document’s, so the host holds no person records beside them.

pub fn history_owners(&self) -> Vec<HistoryOwner>

The person’s shared records held beside the sections (Self::shared), which the runtime holds for the person; none where no person is.

pub fn shared<P: SharedRecord>(&self) -> Option<PersonRecord<P>>

The person’s shared record P (their accounts, their contacts), kept in the person’s own scope (Self::history_owners), opened on first use; not published here. None where no person is.

pub fn resources(&self) -> Vec<ResourceSpec>

Every section, published with its field edits and verbs, and with the undo and redo of its invoker’s steps where a person is.

pub fn stored(&self, kind: &str) -> Option<Value>

The section kind (settings.appearance) as stored now, as its model writes it: what a control showing one of its fields shows. None for a section not declared here.

pub fn invoke( &self, address: &ActionAddress, arguments: &Map<String, Value>, confirmed: bool, invoker: &ActionInvoker, invoked_by: Option<&InvokingAction>, ) -> Result<ActionOutput, DoorError>

Run the action at address with its typed arguments for invoker, on behalf of the action invoked_by when another action runs it (the palette’s dark mode runs the appearance field edit). The change is recorded with both, so its history tells them apart. A change whose published action asks first, for the value it carries (a later lock), runs only once it is confirmed.