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 anyhow::Result;
21use async_task::Runnable;
22pub use event::Event;
23use std::{ops::Range, path::PathBuf, rc::Rc, sync::Arc};
24
25pub trait Runner {
26    fn on_finish_launching<F: 'static + FnOnce()>(self, callback: F) -> Self;
27    fn on_menu_command<F: 'static + FnMut(&str)>(self, callback: F) -> Self;
28    fn on_become_active<F: 'static + FnMut()>(self, callback: F) -> Self;
29    fn on_resign_active<F: 'static + FnMut()>(self, callback: F) -> Self;
30    fn on_event<F: 'static + FnMut(Event) -> bool>(self, callback: F) -> Self;
31    fn on_open_files<F: 'static + FnMut(Vec<PathBuf>)>(self, callback: F) -> Self;
32    fn set_menus(self, menus: &[Menu]) -> Self;
33    fn run(self);
34}
35
36pub trait App {
37    fn dispatcher(&self) -> Arc<dyn Dispatcher>;
38    fn activate(&self, ignoring_other_apps: bool);
39    fn open_window(
40        &self,
41        options: WindowOptions,
42        executor: Rc<executor::Foreground>,
43    ) -> Result<Box<dyn Window>>;
44    fn prompt_for_paths(&self, options: PathPromptOptions) -> Option<Vec<PathBuf>>;
45    fn fonts(&self) -> Arc<dyn FontSystem>;
46    fn quit(&self);
47    fn copy(&self, text: &str);
48}
49
50pub trait Dispatcher: Send + Sync {
51    fn is_main_thread(&self) -> bool;
52    fn run_on_main_thread(&self, task: Runnable);
53}
54
55pub trait Window: WindowContext {
56    fn on_event(&mut self, callback: Box<dyn FnMut(Event)>);
57    fn on_resize(&mut self, callback: Box<dyn FnMut(&mut dyn WindowContext)>);
58}
59
60pub trait WindowContext {
61    fn size(&self) -> Vector2F;
62    fn scale_factor(&self) -> f32;
63    fn present_scene(&mut self, scene: Scene);
64}
65
66pub struct WindowOptions<'a> {
67    pub bounds: RectF,
68    pub title: Option<&'a str>,
69}
70
71pub struct PathPromptOptions {
72    pub files: bool,
73    pub directories: bool,
74    pub multiple: bool,
75}
76
77pub trait FontSystem: Send + Sync {
78    fn load_family(&self, name: &str) -> anyhow::Result<Vec<FontId>>;
79    fn select_font(
80        &self,
81        font_ids: &[FontId],
82        properties: &FontProperties,
83    ) -> anyhow::Result<FontId>;
84    fn font_metrics(&self, font_id: FontId) -> FontMetrics;
85    fn typographic_bounds(&self, font_id: FontId, glyph_id: GlyphId) -> anyhow::Result<RectF>;
86    fn glyph_for_char(&self, font_id: FontId, ch: char) -> Option<GlyphId>;
87    fn rasterize_glyph(
88        &self,
89        font_id: FontId,
90        font_size: f32,
91        glyph_id: GlyphId,
92        subpixel_shift: Vector2F,
93        scale_factor: f32,
94    ) -> Option<(RectI, Vec<u8>)>;
95    fn layout_str(&self, text: &str, font_size: f32, runs: &[(Range<usize>, FontId)]) -> Line;
96}