A floating dock group in its own OS window now moves through a window move gesture the app runs, which reports Begin, Update, Commit and Cancel like a layer's move, so the dock marks the target under the pointer and docks the whole window on release. - macOS (Caps::OS_MOVES_TRACKED): the OS moves the window (StartMove), and the app follows the system pointer, button and Cmd through SystemWindows, the running platform's WindowSystem in craft-window. The hand-off ends when the system reports the button up. - X11 and Windows: the app moves the window with SetOuterPosition so the pressed point stays under the pointer; Escape puts it back. - A drag started by a container shown in its own OS window follows that window's pointer, not its parent's. - The runtime's end hook sets NSWindow.movable for every window; a window whose move the app runs is never moved by AppKit from its band.
craft-host
The services every Craft library feature reads from the app: who the app is (AppInfo), the
catalogs and current language, settings sections, command words and background jobs. The app builds
one Host at startup and installs it on the egui context; features read it with Host::of(ui) and
never take services as parameters.
let host = craft_host::Host::builder(craft_host::AppInfo { id: "photocraft", name: "PhotoCraft", version: "1.0" })
.i18n(i18n)
.settings(settings)
.build();
host.install(&ctx); // feature `ui`
Every service has a default, so a test writes Host::builder(app).install(ctx):
| Service | Trait | Default |
|---|---|---|
| Settings sections | SectionStore |
MemorySections |
| Command words | Commands |
NoCommands (English labels) |
| Background work | Jobs |
ThreadJobs; InlineJobs on wasm32 |
| Catalogs | craft_i18n::I18n |
none (English) |
queue::JobQueue runs prioritised background work with one job per key on the host's Jobs.
Stories and tests step it with ManualJobs, which keeps each job until run_next runs it.
Host::install_scoped installs a host until the returned HostScope drops, then puts back the
one installed before. A story swaps in a fake service this way for the time it draws.
Boundaries
- Depends on
craft-i18n,serdeandtomlonly. Implementations depend on this crate:craft-settingsimplementsSectionStore,craft-keymapimplementsCommands. - Feature
uiadds egui forinstallandof. It never depends oncraft-ui. - A settings section is a serde struct saved as one TOML table under
Section::KEY.