1mod event;
 2#[cfg(target_os = "macos")]
 3pub mod mac;
 4pub mod test;
 5pub mod current {
 6    #[cfg(target_os = "macos")]
 7    pub use super::mac::*;
 8}
 9
10use crate::{
11    executor,
12    fonts::{FontId, GlyphId, Metrics as FontMetrics, Properties as FontProperties},
13    geometry::{
14        rect::{RectF, RectI},
15        vector::Vector2F,
16    },
17    text_layout::Line,
18    Menu, Scene,
19};
20use async_task::Runnable;
21pub use event::Event;
22use std::{any::Any, ops::Range, path::PathBuf, rc::Rc, sync::Arc};
23
24pub trait Platform {
25    fn on_menu_command(&self, callback: Box<dyn FnMut(&str, Option<&dyn Any>)>);
26    fn on_become_active(&self, callback: Box<dyn FnMut()>);
27    fn on_resign_active(&self, callback: Box<dyn FnMut()>);
28    fn on_event(&self, callback: Box<dyn FnMut(Event) -> bool>);
29    fn on_open_files(&self, callback: Box<dyn FnMut(Vec<PathBuf>)>);
30    fn run(&self, on_finish_launching: Box<dyn FnOnce() -> ()>);
31
32    fn dispatcher(&self) -> Arc<dyn Dispatcher>;
33    fn fonts(&self) -> Arc<dyn FontSystem>;
34
35    fn activate(&self, ignoring_other_apps: bool);
36    fn open_window(
37        &self,
38        id: usize,
39        options: WindowOptions,
40        executor: Rc<executor::Foreground>,
41    ) -> Box<dyn Window>;
42    fn key_window_id(&self) -> Option<usize>;
43    fn prompt_for_paths(&self, options: PathPromptOptions) -> Option<Vec<PathBuf>>;
44    fn quit(&self);
45    fn copy(&self, text: &str);
46    fn set_menus(&self, menus: Vec<Menu>);
47}
48
49pub trait Dispatcher: Send + Sync {
50    fn is_main_thread(&self) -> bool;
51    fn run_on_main_thread(&self, task: Runnable);
52}
53
54pub trait Window: WindowContext {
55    fn on_event(&mut self, callback: Box<dyn FnMut(Event)>);
56    fn on_resize(&mut self, callback: Box<dyn FnMut(&mut dyn WindowContext)>);
57}
58
59pub trait WindowContext {
60    fn size(&self) -> Vector2F;
61    fn scale_factor(&self) -> f32;
62    fn present_scene(&mut self, scene: Scene);
63}
64
65pub struct WindowOptions<'a> {
66    pub bounds: RectF,
67    pub title: Option<&'a str>,
68}
69
70pub struct PathPromptOptions {
71    pub files: bool,
72    pub directories: bool,
73    pub multiple: bool,
74}
75
76pub trait FontSystem: Send + Sync {
77    fn load_family(&self, name: &str) -> anyhow::Result<Vec<FontId>>;
78    fn select_font(
79        &self,
80        font_ids: &[FontId],
81        properties: &FontProperties,
82    ) -> anyhow::Result<FontId>;
83    fn font_metrics(&self, font_id: FontId) -> FontMetrics;
84    fn typographic_bounds(&self, font_id: FontId, glyph_id: GlyphId) -> anyhow::Result<RectF>;
85    fn glyph_for_char(&self, font_id: FontId, ch: char) -> Option<GlyphId>;
86    fn rasterize_glyph(
87        &self,
88        font_id: FontId,
89        font_size: f32,
90        glyph_id: GlyphId,
91        subpixel_shift: Vector2F,
92        scale_factor: f32,
93    ) -> Option<(RectI, Vec<u8>)>;
94    fn layout_str(&self, text: &str, font_size: f32, runs: &[(Range<usize>, FontId)]) -> Line;
95}