Struct ApplicationDefinition 

pub struct ApplicationDefinition {
    pub app_id: &'static str,
    pub title: &'static str,
    pub icon: IconDescriptor,
    pub record_kind: RecordKind,
    pub required: Vec<PermissionScope>,
    pub optional: Vec<PermissionScope>,
    pub opens: &'static [&'static str],
    pub room_record: bool,
    pub create: fn(HostContext, LaunchTarget, RestoreInput) -> Result<AppComponent, LaunchError>,
}

Fields

app_id: &'static str

title: &'static str

icon: IconDescriptor

record_kind: RecordKind

required: Vec<PermissionScope>

optional: Vec<PermissionScope>

opens: &'static [&'static str]

Media types (type/subtype, lowercase) the component opens when a host hands it a file (HostContext::take_open_file); ANY_MEDIA_TYPE for a component that opens every file (a hex editor).

room_record: bool

The app keeps one record per room, the room’s own (a conversation everyone in the room shares), rather than a record per window: every window of the app in the room opens it, and the first creates it.

create: fn(HostContext, LaunchTarget, RestoreInput) -> Result<AppComponent, LaunchError>

Implementations

impl ApplicationDefinition

pub fn keeps_room_record(&self) -> bool

Whether the app keeps one record per room, its package primary, rather than a record per window (Self::room_record).

pub fn unsaved_target( &self, records: &RecordStore, ) -> Result<LaunchTarget, RecordOpenError>

The launch target of an instance with no saved record: a new record of its own, or the room’s record (created on first use) for an app that keeps one.

Errors

Preserves an existing record’s ownership, identity or storage failure. Only a missing primary record permits a new reservation.

pub fn opens_media_type(&self, media_type: &str) -> bool

Whether the component opens files of media_type (parameters and case ignored). ANY_MEDIA_TYPE among Self::opens opens every file.

pub fn instantiate( &self, context: HostContext, target: LaunchTarget, restore: RestoreInput, ) -> Result<AppComponent, LaunchError>

Validate, invoke the one factory under its lifetime, then restore presentation only. The factory projects through HostContext::read_record; no mutable Widget::sync or second history/autosave initialization follows its View restoration.

Errors

Ready records survive any checked validation or setup failure through ComponentSetup’s strong owner; Reserved failures cancel without publication.