SolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.
Help: check for updates and show results in the selected language (#8896)
SvenCarstensenaff810620547
diff --git a/apps/solidcraft/src/native_menu.rs b/apps/solidcraft/src/native_menu.rsindex 1d75df7a87..0e64b53871 100644--- a/apps/solidcraft/src/native_menu.rs+++ b/apps/solidcraft/src/native_menu.rs@@ -101,6 +101,7 @@ impl NativeMenu {])?;for (action, label) in [("docs", "Documentation"),+ ("updates", app.tr("update.check_for_updates")),("shortcuts", "Keyboard Shortcuts"),("messages", "Messages\u{2026}"),("report", "Report an Issue\u{2026}"),diff --git a/assets/locales/pending/help-check-for-updates.json b/assets/locales/pending/help-check-for-updates.jsonnew file mode 100644index 0000000000..560ed77b7b--- /dev/null+++ b/assets/locales/pending/help-check-for-updates.json@@ -0,0 +1,122 @@+{+ "en": {+ "update.check_for_updates": "Check for updates",+ "update.check_unavailable": "Update checks are not available for this installation."+ },+ "ar": {+ "update.check_for_updates": "التحقق من وجود تحديثات",+ "update.check_unavailable": "التحقق من التحديثات غير متاح لهذا التثبيت."+ },+ "bs": {+ "update.check_for_updates": "Provjeri ažuriranja",+ "update.check_unavailable": "Provjera ažuriranja nije dostupna za ovu instalaciju."+ },+ "cs": {+ "update.check_for_updates": "Zkontrolovat aktualizace",+ "update.check_unavailable": "Pro tuto instalaci není kontrola aktualizací dostupná."+ },+ "da": {+ "update.check_for_updates": "Søg efter opdateringer",+ "update.check_unavailable": "Søgning efter opdateringer er ikke tilgængelig for denne installation."+ },+ "de": {+ "update.check_for_updates": "Nach Updates suchen",+ "update.check_unavailable": "Für diese Installation ist keine Update-Prüfung verfügbar."+ },+ "es": {+ "update.check_for_updates": "Buscar actualizaciones",+ "update.check_unavailable": "La búsqueda de actualizaciones no está disponible para esta instalación."+ },+ "fr": {+ "update.check_for_updates": "Rechercher des mises à jour",+ "update.check_unavailable": "La recherche de mises à jour n’est pas disponible pour cette installation."+ },+ "gl": {+ "update.check_for_updates": "Buscar actualizacións",+ "update.check_unavailable": "A busca de actualizacións non está dispoñible para esta instalación."+ },+ "he": {+ "update.check_for_updates": "בדיקת עדכונים",+ "update.check_unavailable": "בדיקת עדכונים אינה זמינה עבור התקנה זו."+ },+ "hr": {+ "update.check_for_updates": "Provjeri ažuriranja",+ "update.check_unavailable": "Provjera ažuriranja nije dostupna za ovu instalaciju."+ },+ "hu": {+ "update.check_for_updates": "Frissítések keresése",+ "update.check_unavailable": "Ehhez a telepítéshez nem érhető el a frissítések keresése."+ },+ "id": {+ "update.check_for_updates": "Periksa pembaruan",+ "update.check_unavailable": "Pemeriksaan pembaruan tidak tersedia untuk instalasi ini."+ },+ "it": {+ "update.check_for_updates": "Verifica aggiornamenti",+ "update.check_unavailable": "La verifica degli aggiornamenti non è disponibile per questa installazione."+ },+ "ja": {+ "update.check_for_updates": "アップデートを確認",+ "update.check_unavailable": "このインストールではアップデートを確認できません。"+ },+ "ko": {+ "update.check_for_updates": "업데이트 확인",+ "update.check_unavailable": "이 설치에서는 업데이트를 확인할 수 없습니다."+ },+ "ms": {+ "update.check_for_updates": "Semak kemas kini",+ "update.check_unavailable": "Semakan kemas kini tidak tersedia untuk pemasangan ini."+ },+ "nb": {+ "update.check_for_updates": "Se etter oppdateringer",+ "update.check_unavailable": "Søk etter oppdateringer er ikke tilgjengelig for denne installasjonen."+ },+ "nl": {+ "update.check_for_updates": "Controleren op updates",+ "update.check_unavailable": "Controleren op updates is niet beschikbaar voor deze installatie."+ },+ "pl": {+ "update.check_for_updates": "Sprawdź aktualizacje",+ "update.check_unavailable": "Sprawdzanie aktualizacji nie jest dostępne dla tej instalacji."+ },+ "pt-BR": {+ "update.check_for_updates": "Verificar atualizações",+ "update.check_unavailable": "A verificação de atualizações não está disponível para esta instalação."+ },+ "ro": {+ "update.check_for_updates": "Caută actualizări",+ "update.check_unavailable": "Căutarea actualizărilor nu este disponibilă pentru această instalare."+ },+ "ru": {+ "update.check_for_updates": "Проверить обновления",+ "update.check_unavailable": "Проверка обновлений недоступна для этой установки."+ },+ "sr": {+ "update.check_for_updates": "Провери ажурирања",+ "update.check_unavailable": "Провера ажурирања није доступна за ову инсталацију."+ },+ "sv": {+ "update.check_for_updates": "Sök efter uppdateringar",+ "update.check_unavailable": "Sökning efter uppdateringar är inte tillgänglig för den här installationen."+ },+ "tr": {+ "update.check_for_updates": "Güncellemeleri denetle",+ "update.check_unavailable": "Bu kurulum için güncelleme denetimi kullanılamıyor."+ },+ "uk": {+ "update.check_for_updates": "Перевірити оновлення",+ "update.check_unavailable": "Перевірка оновлень недоступна для цього встановлення."+ },+ "vi": {+ "update.check_for_updates": "Kiểm tra bản cập nhật",+ "update.check_unavailable": "Không thể kiểm tra bản cập nhật cho bản cài đặt này."+ },+ "zh": {+ "update.check_for_updates": "检查更新",+ "update.check_unavailable": "此安装版本无法检查更新。"+ },+ "zh-TW": {+ "update.check_for_updates": "檢查更新",+ "update.check_unavailable": "此安裝版本無法檢查更新。"+ }+}diff --git a/crates/ui-egui/src/control.rs b/crates/ui-egui/src/control.rsindex d4e44acb8d..17c43ccbab 100644--- a/crates/ui-egui/src/control.rs+++ b/crates/ui-egui/src/control.rs@@ -32,7 +32,7 @@//! - `ui.window {action: minimize|maximize|restore|toggle|close}`: what the title bar's buttons do//! - `ui.confirm {accept?}`: the Delete confirmation (without `accept`: what it lists)//! - `ui.shortcut {command, key?, slot?, replace?}`: a command's keys, or bind one ("" clears)-//! - `ui.help {item?: about|shortcuts|report}`: the Help menu; returns the version and diagnostics+//! - `ui.help {item?: about|updates|shortcuts|report}`: the Help menu; returns the version and diagnostics//! - `ui.prefs {...}`: the preferences (default_units, nav, zoom_reverse, orbit_around, msaa,//! length_decimals, angle_decimals); returns them all//! - `ui.capture {action?: capture|revert|cancel}`: the Capture Position question@@ -1131,7 +1131,7 @@ fn dispatch(app: &mut SolveApp, ctx: &egui::Context, method: &str, p: &Value) ->"ui.prefs" => wrap(crate::prefs::control(app, p)),"ui.agent_chat" => wrap(crate::agent_chat::control(app, ctx, p)),"ui.help" => match s("item") {- Some(i @ ("about" | "shortcuts" | "report" | "crashes")) => {+ Some(i @ ("about" | "updates" | "shortcuts" | "report" | "crashes")) => {crate::help::run(app, ctx, i);ok(json!({"diagnostics": crate::help::diagnostics(app), "version": crate::help::VERSION, "commit": crate::help::COMMIT, "built": crate::help::BUILD_DATE}),diff --git a/crates/ui-egui/src/help.rs b/crates/ui-egui/src/help.rsindex ea6f7fec25..fbef19384a 100644--- a/crates/ui-egui/src/help.rs+++ b/crates/ui-egui/src/help.rs@@ -44,10 +44,10 @@ pub fn diagnostics(app: &SolveApp) -> String {/// Whether a Help menu item can run now: behind an open bug report, the items that open a/// window would cover it (#7188). Report an Issue… shows the report.pub fn available(app: &SolveApp, item: &str) -> bool {- app.issue_report.draft.is_none() || !matches!(item, "about" | "shortcuts" | "messages" | "crashes" | "connect")+ app.issue_report.draft.is_none() || !matches!(item, "about" | "shortcuts" | "messages" | "crashes" | "connect" | "updates")}-/// Run a Help menu item: `docs`, `about`, `shortcuts`, `messages`, `report`, `crashes`, `connect`, `install_cli` (macOS).+/// Run a Help menu item: `docs`, `about`, `updates`, `shortcuts`, `messages`, `report`, `crashes`, `connect`, `install_cli` (macOS).pub fn run(app: &mut SolveApp, ctx: &egui::Context, item: &str) {app.help.menu = false;if !available(app, item) {@@ -56,6 +56,7 @@ pub fn run(app: &mut SolveApp, ctx: &egui::Context, item: &str) {match item {"docs" => ctx.open_url(egui::OpenUrl::new_tab(DOCS_URL)),"about" => app.help.about = true,+ "updates" => crate::update::check_now(app, ctx),"shortcuts" => {app.keymap.open = true;app.keymap.read_only = true;@@ -131,6 +132,7 @@ pub fn show(app: &mut SolveApp, ctx: &egui::Context, anchor: egui::Pos2) {for (id, label, icon) in [("docs", "Documentation", "library"),("about", "About SolidCraft", "help"),+ ("updates", crate::i18n::tr("update.check_for_updates"), "update"),("shortcuts", "Keyboard Shortcuts", "list"),("messages", "Messages…", "list"),("report", "Report an Issue…", "bug_report"),diff --git a/crates/ui-egui/src/toolbar.rs b/crates/ui-egui/src/toolbar.rsindex 61501ef356..2e53fd5d54 100644--- a/crates/ui-egui/src/toolbar.rs+++ b/crates/ui-egui/src/toolbar.rs@@ -3334,11 +3334,12 @@ mod header_report_tests {FileAction::Quit.run(&mut h.app);assert!(h.app.docs.quitting.is_none() && h.app.docs.closing.is_none());// Help's windows wait too; Report an Issue… shows the report.- for item in ["about", "shortcuts", "messages", "crashes", "connect"] {+ for item in ["about", "shortcuts", "messages", "crashes", "connect", "updates"] {assert!(!crate::help::available(&h.app, item), "{item}");crate::help::run(&mut h.app, &h.ctx, item);}assert!(!h.app.help.about && !h.app.keymap.open && !h.app.messages.open && h.app.help.connect.is_none());+ assert!(!h.app.updater.open);assert!(crate::help::available(&h.app, "report") && crate::help::available(&h.app, "docs"));h.app.issue_report.draft = None;assert!(FileAction::Undo.enabled(&h.app) && FileAction::Settings.enabled(&h.app) && FileAction::Quit.enabled(&h.app));diff --git a/crates/ui-egui/src/update.rs b/crates/ui-egui/src/update.rsindex 16d249fc06..9f27e25c8b 100644--- a/crates/ui-egui/src/update.rs+++ b/crates/ui-egui/src/update.rs@@ -728,10 +728,21 @@ pub fn tick(app: &mut SolveApp, ctx: &egui::Context) {}}-/// Check now (Preferences): ignores the daily interval, not GitHub's rate limit.+/// Check now (Help or Preferences): show progress and the result, ignoring the daily interval,+/// but not GitHub's rate limit. A check already in flight serves the manual request too.pub fn check_now(app: &mut SolveApp, ctx: &egui::Context) {+ app.updater.open = true;+ // Keep a download or a completed installation on screen without starting another check.+ if app.updater.job.is_some() || app.updater.installed.as_ref().is_some_and(Result::is_ok) || !available(app) {+ return;+ }+ if let Some((_, manual)) = &mut app.updater.rx {+ *manual = true;+ app.updater.last_manual = unix_now();+ return;+ }let now = unix_now();- if app.updater.rx.is_some() || now - app.updater.last_manual < MANUAL_COOLDOWN_S || !available(app) {+ if now - app.updater.last_manual < MANUAL_COOLDOWN_S {return;}if now < app.preferences.update.rate_limited_until {@@ -773,9 +784,9 @@ fn start(app: &mut SolveApp, ctx: &egui::Context, manual: bool) {let _ = tx.send(fetch());ctx.request_repaint();});- if spawned.is_err() {+ if let Err(error) = spawned {app.updater.rx = None;- app.updater.status = Status::Idle;+ app.updater.status = if manual { Status::Failed(error.to_string()) } else { Status::Idle };}}#[cfg(target_arch = "wasm32")]@@ -801,10 +812,10 @@ fn poll(app: &mut SolveApp) {let newer = is_newer(&release.tag, current_version());app.updater.status = if newer { Status::Idle } else { Status::UpToDate };if newer && manual {- // Asked for: show it even if it was skipped or put off.+ // Asked for: offer it even if it was skipped or put off. check_now already+ // opened the window; don't reopen it if the user closed it while checking.app.preferences.update.skipped.clear();app.preferences.update.remind_after = 0.0;- app.updater.open = true;}if app.updater.job.is_none() && app.updater.release.as_ref().is_none_or(|known| !is_newer(&known.tag, &release.tag)) {app.updater.release = Some(release);@@ -954,10 +965,14 @@ pub fn show(app: &mut SolveApp, ctx: &egui::Context) {if !app.updater.open {return;}- let Some(release) = app.updater.release.clone() else {- app.updater.open = false;+ if app.updater.job.is_none()+ && !app.updater.installed.as_ref().is_some_and(Result::is_ok)+ && (matches!(app.updater.status, Status::Checking | Status::Failed(_)) || offered_or_newer(app).is_none())+ {+ show_check_status(app, ctx);return;- };+ }+ let Some(release) = app.updater.release.clone() else { return };let kind = app.updater.kind().clone();let install = install_method(app);let managed = app.updater.managed_by().map(str::to_string);@@ -1102,6 +1117,34 @@ pub fn show(app: &mut SolveApp, ctx: &egui::Context) {}}+/// Manual checks also have a visible result when no update can be offered.+fn show_check_status(app: &mut SolveApp, ctx: &egui::Context) {+ let (message, warning) = if !available(app) {+ (crate::i18n::tr("update.check_unavailable").to_string(), false)+ } else {+ match &app.updater.status {+ Status::Checking => (crate::i18n::tr("update.checking").to_string(), false),+ Status::UpToDate => (crate::i18n::tr("update.up_to_date").to_string(), false),+ Status::Failed(error) => (crate::i18n::format("update.failed", &[("error", error)]), true),+ Status::Idle => (crate::i18n::tr("update.check_unavailable").to_string(), false),+ }+ };+ let id = egui::Id::new("sc_update");+ let (closed, action) = ui_kit::Window::new(id, "update", crate::i18n::tr("update.check_for_updates"))+ .cards(1.7)+ .actions("", crate::i18n::tr("ui.close"), None)+ .show(ctx, true, |ui| {+ ui_kit::text(ui, &message, ui_kit::Text::Report("check_status", warning));+ ui_kit::text(ui, &crate::i18n::format("update.you_have", &[("version", current_version())]), ui_kit::Text::Note("have"));+ });+ if let Some(area) = ctx.memory(|m| m.area_rect(id)) {+ crate::scenario::publish_rect("update:window", area);+ }+ if closed || action == ui_kit::Action::Cancel {+ app.updater.open = false;+ }+}+/// What the Update card shows below the notes.#[derive(Clone, Copy, PartialEq, Eq)]enum State {diff --git a/crates/ui-egui/src/update/tests.rs b/crates/ui-egui/src/update/tests.rsindex 0301405b22..0f2606a465 100644--- a/crates/ui-egui/src/update/tests.rs+++ b/crates/ui-egui/src/update/tests.rs@@ -358,6 +358,149 @@ fn turning_off_automatic_checks_stops_the_launch_check() {assert!(h.app.updater.release.is_none());}+#[test]+fn help_menu_checks_with_automatic_checks_off_and_offers_installation() {+ let dir = scratch();+ let (feed, version) = next_release_feed(&dir.0);+ let mut h = crate::scenario::Harness::new();+ h.app.preferences.check_updates = false;+ h.app.preferences.update.skipped = format!("v{version}");+ h.app.preferences.update.remind_after = unix_now() + REMIND_DELAY_S;+ h.app.updater.feed = Some(feed);+ h.app.updater.kind = Some(InstallKind::MacApp("/Applications/SolidCraft.app".into()));+ h.app.updater.managed = Some(None);+ h.app.services.http_get = Some(Arc::new(|_| panic!("the check must use the test feed")));+ h.app.services.http_download = Some(Arc::new(|_, _, _| panic!("offering an update must not install it")));+ h.app.help.menu = true;+ h.frames(2);+ let [x, y] = h.widget("Check for updates").expect("the Help menu has an update check");+ h.call("ui.click", json!({"x": x, "y": y}));+ wait_for_check(&mut h);+ h.frames(2);+ assert!(!h.app.help.menu);+ assert!(h.app.updater.open);+ assert!(h.app.preferences.update.skipped.is_empty());+ assert_eq!(h.app.preferences.update.remind_after, 0.0);+ assert!(h.widget(&format!("SolidCraft {version} is available")).is_some());+ assert!(h.widget("Download and open").is_some(), "the macOS installation is offered immediately");+ assert!(h.app.updater.job.is_none());+}++/// Hold an automatic check at its result channel so the manual request can join it without+/// a second HTTP request or a wall-clock race.+fn pending_check() -> (crate::scenario::Harness, std::sync::mpsc::Sender<Result<Release, FetchError>>) {+ let mut h = crate::scenario::Harness::new();+ h.app.preferences.check_updates = false;+ h.app.updater.kind = Some(InstallKind::WindowsMsi);+ h.app.services.http_get = Some(Arc::new(|_| panic!("do not start a second check")));+ let (tx, rx) = std::sync::mpsc::channel();+ h.app.updater.rx = Some((rx, false));+ h.app.updater.status = Status::Checking;+ (h, tx)+}++#[test]+fn help_check_shows_progress_and_up_to_date_then_closes() {+ let (mut h, tx) = pending_check();+ h.call("ui.help", json!({"item": "updates"}));+ assert!(h.app.updater.open);+ assert!(h.app.updater.rx.as_ref().unwrap().1, "the in-flight automatic check becomes manual");+ assert!(h.widget("Checking…").is_some());+ let release = Release::parse(+ json!({"tag_name": format!("v{}", comparable(&parse_version(current_version()).unwrap())), "assets": []}).to_string().as_bytes(),+ )+ .unwrap();+ tx.send(Ok(release)).unwrap();+ h.frames(2);+ assert_eq!(h.app.updater.status, Status::UpToDate);+ assert!(h.widget("SolidCraft is up to date.").is_some());+ assert!(h.widget("Download").is_none() && h.widget("Update now").is_none());+ let [x, y] = h.widget("Close").unwrap();+ h.call("ui.click", json!({"x": x, "y": y}));+ assert!(!h.app.updater.open);+ // Reopening during the cooldown still shows the result, without another request.+ h.app.updater.last_manual = unix_now();+ h.call("ui.help", json!({"item": "updates"}));+ assert!(h.widget("SolidCraft is up to date.").is_some());+ assert!(h.app.updater.rx.is_none());+}++#[test]+fn help_check_reports_network_errors_and_rate_limits_in_the_window() {+ for error in [FetchError::Failed("offline".into()), FetchError::RateLimited { retry_after_s: 3600 }] {+ let (mut h, tx) = pending_check();+ h.call("ui.help", json!({"item": "updates"}));+ tx.send(Err(error.clone())).unwrap();+ h.frames(2);+ assert_eq!(h.app.updater.status, Status::Failed(error.to_string()));+ assert!(h.widget(&format!("Couldn't check: {error}")).is_some());+ assert!(h.widget("SolidCraft is up to date.").is_none());+ if matches!(error, FetchError::RateLimited { .. }) {+ h.call("ui.help", json!({"item": "updates"}));+ assert!(h.app.updater.rx.is_none(), "the server's rate limit is honoured");+ assert!(matches!(h.app.updater.status, Status::Failed(_)));+ }+ }+}++#[test]+fn help_check_result_follows_the_selected_language() {+ let (mut h, tx) = pending_check();+ h.call("ui.prefs", json!({"language": "de"}));+ h.call("ui.help", json!({"item": "updates"}));+ let release = Release::parse(json!({"tag_name": current_version(), "assets": []}).to_string().as_bytes()).unwrap();+ tx.send(Ok(release)).unwrap();+ h.frames(2);+ assert!(h.widget("SolidCraft ist aktuell.").is_some());+ for (language, title, message) in [+ ("fr", "Rechercher des mises à jour", "SolidCraft est à jour."),+ ("ja", "アップデートを確認", "SolidCraft は最新です。"),+ ("zh-TW", "檢查更新", "SolidCraft 已是最新版本。"),+ ] {+ h.call("ui.prefs", json!({"language": language}));+ assert!(h.widget(title).is_some(), "the window title follows {language}");+ assert!(h.widget(message).is_some(), "the result follows {language}");+ assert!(h.widget("SolidCraft is up to date.").is_none());+ }+}++#[test]+fn help_check_explains_when_checks_are_unavailable() {+ let mut h = crate::scenario::Harness::new();+ h.app.updater.off = true;+ h.call("ui.help", json!({"item": "updates"}));+ assert!(h.widget("Update checks are not available for this installation.").is_some());+ assert!(h.widget("SolidCraft is up to date.").is_none());+ assert!(h.app.updater.rx.is_none());+}++#[test]+fn closing_a_manual_check_does_not_reopen_it_when_an_update_arrives() {+ let (mut h, tx) = pending_check();+ h.call("ui.help", json!({"item": "updates"}));+ let [x, y] = h.widget("Close").unwrap();+ h.call("ui.click", json!({"x": x, "y": y}));+ assert!(!h.app.updater.open);+ let release = Release::parse(br#"{"tag_name":"v999.0.0","assets":[]}"#).unwrap();+ tx.send(Ok(release)).unwrap();+ h.frames(2);+ assert!(!h.app.updater.open);+ assert!(offered(&h.app).is_some(), "the update remains available from the title bar");+}++#[test]+fn help_check_keeps_an_active_installation_on_screen() {+ let (mut h, dir) = open_update_window(None);+ let (_tx, rx) = std::sync::mpsc::channel();+ h.app.updater.job = Some((rx, Arc::new(install::Progress::default())));+ h.app.updater.open = false;+ h.call("ui.help", json!({"item": "updates"}));+ assert!(h.app.updater.open && h.app.updater.job.is_some());+ assert!(h.app.updater.rx.is_none());+ assert!(h.widget("Cancel").is_some());+ drop(dir);+}+#[test]fn the_title_bar_offers_the_new_version_and_opens_the_update_window() {let dir = scratch();diff --git a/docs/book/src/guide/updates.md b/docs/book/src/guide/updates.mdindex 76df4de2eb..96041e4475 100644--- a/docs/book/src/guide/updates.md+++ b/docs/book/src/guide/updates.md@@ -22,6 +22,11 @@ up straight away, and again once a day while it stays open.**Preferences ▸ General ▸ Updates** has **Check for updates automatically** (on by default) and**Check now**, which checks right away and shows the window even for a version you skipped.+**Help ▸ Check for updates** runs the same check, including from the macOS menu bar. The window+shows progress, offers the installation or download when a newer version exists, or says+**SolidCraft is up to date.** If the check fails, it shows the error instead. Manual checks work+even when automatic checks are turned off; builds that cannot check explain that in the window.+## Updating in one clickWhere SolidCraft can replace itself safely, the window also has **Update now**:diff --git a/docs/control-protocol.md b/docs/control-protocol.mdindex 530e130adc..0a547730eb 100644--- a/docs/control-protocol.md+++ b/docs/control-protocol.md@@ -376,7 +376,7 @@ labels; `prefs:measure_axis_distances` identifies the checkbox.| `ui.file` | `path`; `insert?`: bool | starts an interactive background Open or Insert; poll `ui.inspect.file_busy` for completion; the window stays responsive || `ui.home` | `open?`: bool; `sample?`: index | the start page: show or hide it, open a built-in sample (once built); returns `open` and the recent designs || `ui.shortcut` | `command`, `key?`, `slot?`, `replace?` | a command's keys (`key`: the first, shown in menus; `keys`: all), or rebinds it: `key` becomes its only key, or with `slot` replaces its key there (one past the last adds a key, `""` there removes that key); `""` without `slot` clears them; a key another command uses is refused unless `replace` |-| `ui.help` | `item?`: `about`, `shortcuts` (read only), `report` (opens a report draft for review), `crashes` (the Crash Reports window) | the version, commit, build date and diagnostic text |+| `ui.help` | `item?`: `about`, `updates` (checks for updates and shows the result), `shortcuts` (read only), `report` (opens a report draft for review), `crashes` (the Crash Reports window) | the version, commit, build date and diagnostic text || `ui.prefs` | any of the [`ui.prefs` settings](#uiprefs-settings) below; also `open`, `button` and `stand_up` (listed there) | sets preferences (kept between runs), returns them all plus `dialog` (the open page or null), `apply_enabled` (whether the dialog's Apply has a change to keep), `dark`, `viewport_dark` (whether the 3D view is dark), `stand_up_offer` (the offered bodies, or null), `stand_up_note` (whether that offer is the note), `theme_followed` and `theme_follow_error` || `ui.capture` | `action?`: `capture`, `revert`, `cancel` | answers the Capture Position question (asked when a command starts or the design is saved while components were moved without capturing); without `action`, what waits || `ui.window` | `action`: minimize, maximize, restore, toggle, close | what the title bar's caption buttons do (on Windows and Linux the application bar is the title bar); close asks about unsaved designs first |