//! The browser shell: web `Services` and the eframe web runner. use figcraft_engine::Session; use figcraft_ui_egui::{FigApp, Services}; use wasm_bindgen::JsCast as _; const CANVAS_ID: &str = "figcraft_canvas"; const LOADING_ID: &str = "figcraft_loading"; pub fn start() { eframe::WebLogger::init(log::LevelFilter::Info).ok(); wasm_bindgen_futures::spawn_local(async { let Some(document) = web_sys::window().and_then(|w| w.document()) else { log::error!("no document"); return; }; let Some(canvas) = document.get_element_by_id(CANVAS_ID).and_then(|e| e.dyn_into::().ok()) else { log::error!("missing "); return; }; let mut options = eframe::WebOptions::default(); // `?webgl`: force the WebGL2 backend (troubleshooting, and headless browsers whose WebGPU // adapter request returns nothing). if query().contains("webgl") && let eframe::egui_wgpu::WgpuSetup::CreateNew(create) = &mut options.wgpu_options.wgpu_setup { create.instance_descriptor.backends = eframe::wgpu::Backends::GL; } let result = eframe::WebRunner::new() .start( canvas, options, Box::new(|cc| { if let Some(rs) = &cc.wgpu_render_state { log::info!("figcraft-web: wgpu backend {:?}", rs.adapter.get_info().backend); } let reduce_motion = web_sys::window().and_then(|w| w.match_media("(prefers-reduced-motion: reduce)").ok().flatten()); let mut session = Session::new(); // Live sessions: the browser joins sessions a desktop app hosts; whatever arrives // on the socket wakes the page for a frame. let ctx = cc.egui_ctx.clone(); session.live.install(Box::new(figcraft_collab_net::NetLink::new(std::sync::Arc::new(move || ctx.request_repaint())))); let fig = FigApp::new(session, Box::new(WebServices { reduce_motion, ctx: cc.egui_ctx.clone() })); Ok(Box::new(WebShell { fig })) }), ) .await; if let Some(el) = document.get_element_by_id(LOADING_ID) { match result { Ok(()) => el.remove(), Err(e) => el.set_inner_html(&format!("

FigCraft failed to start: {e:?}

A browser with WebGPU or WebGL2 is required.

")), } } }); } fn query() -> String { web_sys::window().and_then(|w| w.location().search().ok()).unwrap_or_default() } struct WebShell { fig: FigApp, } impl eframe::App for WebShell { // `FigApp::ui` runs its own per-frame logic first (fonts, theme), like the desktop app. fn ui(&mut self, ui: &mut egui::Ui, _frame: &mut eframe::Frame) { self.fig.ui(ui); } } /// Browser services. Open dialogs return nothing for now (the trait's defaults); files are saved /// as downloads. Copies go to the system clipboard through egui's output; pastes arrive as paste /// events with their text (a page can't read the clipboard when it likes). struct WebServices { /// `prefers-reduced-motion: reduce` (it follows the setting while the page is open). reduce_motion: Option, ctx: egui::Context, } impl Services for WebServices { fn downloads(&self) -> bool { true } /// A Blob behind a temporary `` link, clicked and removed. fn download(&mut self, name: &str, bytes: &[u8]) -> bool { match download(name, bytes) { Ok(()) => true, Err(e) => { log::error!("couldn't download {name}: {e:?}"); false } } } fn clipboard_set_text(&mut self, s: &str) { figcraft_ui_egui::egui_copy_text(&self.ctx, s); } fn clipboard_set_png(&mut self, w: u32, h: u32, rgba: &[u8]) { figcraft_ui_egui::egui_copy_png(&self.ctx, w, h, rgba); } fn open_url(&mut self, url: &str) { let Some(window) = web_sys::window() else { return }; if let Err(e) = window.open_with_url_and_target(url, "_blank") { log::error!("couldn't open {url}: {e:?}"); } } fn reduce_motion(&self) -> bool { self.reduce_motion.as_ref().is_some_and(web_sys::MediaQueryList::matches) } /// The browser's language (`navigator.language`). fn system_language(&self) -> Option { web_sys::window().and_then(|w| w.navigator().language()) } /// The Gamepad API's controllers with the standard mapping (its button order is the layout's; /// others are skipped). Browsers list controllers once one of their buttons is pressed. fn gamepad_held(&mut self) -> u32 { let Some(pads) = web_sys::window().and_then(|w| w.navigator().get_gamepads().ok()) else { return 0 }; let mut held = 0; for pad in pads.iter().filter_map(|p| p.dyn_into::().ok()) { if pad.mapping() != web_sys::GamepadMappingType::Standard { continue; } for (i, b) in pad.buttons().iter().take(32).enumerate() { if b.dyn_into::().is_ok_and(|b| b.pressed()) { held |= 1 << i; } } } held } } fn download(name: &str, bytes: &[u8]) -> Result<(), wasm_bindgen::JsValue> { let window = web_sys::window().ok_or("no window")?; let document = window.document().ok_or("no document")?; let body = document.body().ok_or("no body")?; let parts = js_sys::Array::of1(&js_sys::Uint8Array::from(bytes)); let blob = web_sys::Blob::new_with_u8_array_sequence_and_options(&parts, &{ let o = web_sys::BlobPropertyBag::new(); o.set_type("application/octet-stream"); o })?; let url = web_sys::Url::create_object_url_with_blob(&blob)?; let a: web_sys::HtmlAnchorElement = document.create_element("a")?.dyn_into()?; a.set_href(&url); a.set_download(name); body.append_child(&a)?; a.click(); a.remove(); // Revoked later, not at once: some browsers cancel a download whose URL goes before it starts. let revoke = wasm_bindgen::closure::Closure::once_into_js(move || { let _ = web_sys::Url::revoke_object_url(&url); }); // Without the timer the URL just stays until the page closes. let _ = window.set_timeout_with_callback_and_timeout_and_arguments_0(revoke.unchecked_ref(), REVOKE_DOWNLOAD_MS); Ok(()) } /// How long a download's object URL is kept (milliseconds). const REVOKE_DOWNLOAD_MS: i32 = 40_000;