Struct BrowserApp 

pub struct BrowserApp { /* private fields */ }

Main browser application struct.

Responsibilities:

• Manage the window collection and per-window BrowserUi instances.
• Forward winit window events to each window’s UI.
• Coordinate resource loading and route fetched results to the owning window.

Tab state, input handling, and rendering are delegated to BrowserUi / [BrowserRenderer].

Typical lifecycle:

1. Construct BrowserApp::new(...), which wires platform components (network, system).
2. Create Tab objects, wrap them in a BrowserUi, and call set_default_ui.
3. Call run() to start the event loop. Each loop iteration:
   • Forward winit events to the owning window’s BrowserUi.
   • Tick the UI, forward fetch requests to the network, and route responses back.

Example usage:

use orinium_browser::browser::{BrowserApp, BrowserUi, Tab};

let mut tab = Tab::default();
tab.navigate("resource:///test/test.html".parse().unwrap());
let mut app = BrowserApp::default();
app.set_default_ui(BrowserUi::with_tab(tab));
app.run().unwrap();

Implementations

impl BrowserApp

pub fn run(self) -> Result<()>

Starts the main browser event loop asynchronously. Returns an error if no default UI was set via set_default_ui.

pub fn new( default_window_size: (u32, u32), default_window_title: String, ) -> Result<Self, Error>

Creates a new browser instance with the given default window size and title. Windows are registered later via open_window.

pub fn open_window_with_ui( &mut self, window_id: WindowId, geometry: WindowGeometry, root_ui: BrowserUi, )

Opens a window showing a caller-supplied UI.

This is the in-process entry point used by embedders that build one UI per window. The BrowserHost port deliberately offers no such hook: the OS shell only knows how to describe a window, never what to put in it.

pub fn close_window(&mut self, window_id: WindowId)

Removes a window’s state when the window is closed.

pub fn set_default_ui(&mut self, ui: BrowserUi)

Sets the UI to use when the first window opens. Must be called before run().

pub fn handle_window_event( &mut self, window_id: WindowId, event: WindowEvent, sink: &mut dyn DrawSink, ) -> BrowserCommand

Handles a winit window event for the given window and returns a BrowserCommand.

pub fn redraw(&mut self, window_id: WindowId, sink: &mut dyn DrawSink)

Rebuilds the render tree and sends draw commands to the GPU for the given window.

pub fn apply_draw_commands(&self, window_id: WindowId, sink: &mut dyn DrawSink)

Applies the current draw commands for the given window to the GPU renderer.

pub fn window_size(&self, window_id: WindowId) -> (f32, f32)

Returns the current window size for the given window as (width, height) in floating-point pixels.

pub fn window_title(&self, window_id: WindowId) -> String

Returns the window title for the given window.

Trait Implementations

impl BrowserHost for BrowserApp

Bridges the browser core to the OS shell.

The trait lives in crate::platform::system::shell so the event loop can be driven by any host without naming a browser type.

fn default_window_size(&self) -> (u32, u32)

The size to give a newly opened window.

fn default_window_title(&self) -> String

The title to give a newly opened window.

fn open_window(&mut self, window_id: WindowId, geometry: WindowGeometry)

Registers a window with the host.

fn has_pending_default_window(&self) -> bool

Whether a UI is still waiting to be installed in the first window.

fn close_window(&mut self, window_id: WindowId)

Forgets a window that the shell closed.

fn window_title(&self, window_id: WindowId) -> String

The current title for a window.

fn handle_window_event( &mut self, window_id: WindowId, event: WindowEvent, sink: &mut dyn DrawSink, ) -> ShellCommand

Handles one OS event for a window and reports what the shell should do.

fn apply_draw_commands(&mut self, window_id: WindowId, sink: &mut dyn DrawSink)

Uploads the window’s pending draw commands to the sink, without presenting.

fn poll_window(&mut self, window_id: WindowId) -> bool

Advances background page work for a window, returning whether it needs a repaint.

impl Default for BrowserApp

fn default() -> Self

Returns the “default value” for a type.