retro_desktop_host library

Retro Desktop's host layer, for an app that shows the look's screens in a shell of its own: the scaffold every look shares (package:ui_core/host.dart: its tabs, its main action, its background and insets, the preview frame and platform) and Retro Desktop's own part of it. An app that draws its screens from package:retro_desktop_ui/retro_desktop_ui.dart does not need this library; the look's own chrome, gallery and tests import it beside that one.

Outside semver: this library may change in any version, a patch included; the CHANGELOG says how to move.

Classes

ChromeGroundScope
Publishes the ChromeGround of the page it wraps. ChromeRoutes.page mounts one inside a pushed page and inside a branch root (from its NavTab.ground); a system's chrome inside the page reads it.
DisplayFormat
English display formats for amounts, counts and dates.
MediaSlot
Where a slot's picture comes from.
MediaSlotImage
Trusted image delivery for one declared media slot, shared by a system's photo and avatar components. fallback stands in while the picture is pending and whenever it misses, so a pending image never delays layout, first paint or publication.
One tab of the shell's navigation: a branch's root, with the glyph and the words it wears. The runtime emits one per StatefulShellBranch, in branch order; the system decides how it looks.
PreviewDevice
The device a platform previews on: its logical size and pixel density. The oracle captures and the gallery's renders use the same numbers.
PreviewFrame
The frame a preview stands in: publishes its platform and brightness to everything inside it, scopes the platform override there, and publishes its box as the screen.
PreviewFrameData
What a PreviewFrame publishes to everything inside it.
PreviewStage
A stage that raises a previewed page on a route over itself once it is on screen, and keeps it raised: how a pushed or sheet page is previewed alone, so its exit renders as it does live and the chrome it derives is the real one (RoutePresentation.pushed or the sheet's).
RetroDesktopChromeMetrics
Shared hit-target minima for desktop chrome, controls and kit composites.
RetroDesktopChromeScope
What every page under the shell reads: the app's name and its places.
RetroDesktopHost
The app's host, mounted once around the router's navigator: Retro Desktop's theme, desk and text defaults.
RetroDesktopInventoryGallery
Retro Desktop's inventory, listed: each group under its heading with how many of its rows the look carries, then each row in a card, its class and what a person calls it over its live specimen, or the reason the look leaves it out. It scrolls itself, so it fills a screen that does not scroll (RetroDesktopScaffold(scroll: false)).
RetroDesktopPage<T>
The router's page for a route pushed off a root, on the desk.
RetroDesktopPreview
One page's isolated preview: the same host, strip, route and sheet the app gives it live, without the router.
RetroDesktopSheetPage<T>
The router's page for a sheet, raised on the root navigator over the shell: from a phone's foot, as a window in the middle of a desktop. drawer stands it as tall as its content. The screen inside derives its close.
RetroDesktopShellAction
The app-level act beside the tabs: a square in the middle of a phone's strip, an icon in the menu bar on a desktop. Lit when accent is on.
RetroDesktopUtility
A small fact at the menu bar's end: synced, an hour. On a phone an item with an icon shows only the icon. highlighted gives the icon the highlight.
RoutePresentationScope
Publishes the RoutePresentation of the route it stands in, overriding what the route's position implies. A system's sheet page wraps its child in one with RoutePresentation.sheet; a preview or a hand-built navigator may publish any presentation.
ShellAction
The app-level act beside the shell's tabs: the one thing reachable from every root — add, compose, capture — with the glyph it wears and what it does. A system draws it in its own way (a floating action button, a disc in the bar, a square at its end).
ShellInsets
The bottom inset the shell's bar asks every branch root to keep clear: published by a system's shell over its branch container (and by a preview that stands the bar under a lone page), spent by the system's screen on its scroll padding and by its toast on its inset.

Enums

ChromeGround
The ground a page stands on, which is what its chrome is drawn against: the system's own surface, or media — a full-bleed feed of video or photographs, over which the chrome is dark and solid.
PreviewPlatform
The platform a preview is drawn for: its device size and the platform whose behaviour applies inside it. The look is the system's everywhere; behaviour (scroll physics, back gestures, text handling) follows this platform.
RetroDesktopPresentation
How a page stands in its preview.
RoutePresentation
How a route is presented, which is what a screen derives its bar from: the title on a root, the back affordance on a pushed page, the dismiss affordance on a sheet. A page never authors its own back or close; it reads its presentation (of).

Extensions

PreviewPlatformDevice on PreviewPlatform
The platform's device, as data on the enum.

Constants

retroDesktopInventoryHeights → const Map<String, double>
The specimens that fill the height they are given; a gallery frames each in a box of this height.

Properties

retroDesktopInventory → DesignInventory
Retro Desktop's inventory: every row of the shared component list, answered.
final