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.pagemounts 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