Module application 

Checked application construction shared by hosts, independent of any runner.

Modules

registry

The applications a multi-app host can mount, registered once per process.

Structs

AppComponent

Real app content and its lifetime; hosts cannot extract an unbound root.

ApplicationCatalog

ApplicationDefinition

ApplicationHost

Capture

What a host prepares an instance for when it renders a screenshot (--shots, --shots-dir, --responsive-matrix) rather than a window someone uses: the app shows a deterministic scene from fixtures and starts nothing that reaches outside the process.

ComponentBehaviour

How the window hosting a component treats its tree. Part of the component, so every host that runs it applies the same behaviour.

ComponentCloseReport

ComponentReplacement

A component an app built to show another record in the place of the one it shows now, and the launch that names that record (the path a person chose to open). The host closes the current component and mounts this one in the same window (AppComponent::take_replacement), then answers the request (Self::into_parts).

ComponentRunnerInputs

Presentation owned by a runner. Authority comes only from the component context.

HostContext

Explicit identity, authority and storage. Apps receive no ambient profile resolver.

HostContextInputs

Host-supplied storage, identity and authority for one instance, checked by HostContext::prepare before any factory runs.

LaunchOption

One of an app’s own command-line options a launch named: --purpose number carries a value, a switch such as --debug-hit-areas none.

NativeProcessHost

The host inputs a normal application process receives from the trusted launcher. Storage and presentation identity are resolved once, before an application factory is allowed to open a record.

NativeProfile

One app’s launcher-owned profile in one workspace, opened by the trusted host from outside the app’s sandbox: the same store, device identity and storage workspace NativeProcessHost resolves inside it. The shell uses it to carry a window’s record and presentation to another workspace (crate::record::transfer); it grants nothing the app itself lacks.

OpenFile

One file to open: its name, media type and bytes.

OpenFileReceipt

What the host keeps of an OpenFile it handed over: which resource the component opened it as, once the component says so.

PlaybackHandoff

Where playback stood on the device or app that handed the launch’s media over: the launch continues it from there. The media itself is what the launch names (its argument or file); this is the transport and the name it played under.

PreparedComponentInputs

Explicit host preparation completed before invoking the application factory.

Reopener

What a component needs to open another record of its app in its own window: the same store, identity, authority and services as the record it shows, for another record. Taken from the HostContext before the factory consumes it (HostContext::reopener).

ReplacementOutcome

What became of a request to show another record in a window: nothing yet, shown, or refused with the reason. The host answers before it closes the asking component and polls the operation that asked, so that operation can be answered from it; a refusal leaves the component open to tell the person on its next frame.

Enums

LaunchTarget

RestoreInput

WindowRole

What a component’s window is to the session.

Constants

ANY_MEDIA_TYPE

The entry of ApplicationDefinition::opens that opens files of every type.

HOSTED_RESOURCE_ENV

The name of the variable a launch carries when the session’s document host keeps the app’s record: its value is the resource address the session publishes there (docs/architecture/apps.md §8 step 2).

MAX_OPEN_FILE_BYTES

The largest file a host may hand a component (128 MiB).

Functions

prepare_private_surface

Prepare definition as one of the desktop’s own surface apps (the bar, the banners, Quick Settings, a sheet): as person on device, its record and view kept in memory under workspace, its window private, so nothing of it is written to disk or offered beyond this device. lend hands it what its host lends it.

session_hosted_resource

The resource address the session’s document host keeps for this launch’s app, when the session launched it: what the app reads its state from and submits its actions against, over its one connection (docs/designs/app-language/one-app-model.md §4). None for a launch the session did not make, and for every app whose record it keeps here.

Type Aliases

ComponentFactory

InstanceId

A window instance of an app, as the runtime numbers it.