1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
//! Generic bridge helpers for consumer apps.
//!
//! ## Why this is mostly documentation
//!
//! Slint generates one `Theme` (and `AnimationPresets`) global per
//! crate that calls [`slint::include_modules!`]. We can't ship a
//! pre-baked `Theme` type from this crate to a consumer because
//! their generated type is local to *their* crate. The bridge is
//! therefore a thin layer that documents the integration pattern
//! plus the canonical macro for one-shot setup.
//!
//! ## The integration pattern
//!
//! Inside your binary that consumes Neon UI:
//!
//! ```ignore
//! use slint::ComponentHandle;
//! slint::include_modules!(); // generates `MainWindow`, `Theme`, …
//!
//! fn main() -> Result<(), slint::PlatformError> {
//! let win = MainWindow::new()?;
//! win.global::<Theme>().set_dark_mode(true);
//! win.run()
//! }
//! ```
//!
//! ## The convenience macro
//!
//! For zero-boilerplate setup, [`neon_ui_setup!`](crate::neon_ui_setup)
//! constructs the window + applies the initial dark-mode flag:
//!
//! ```ignore
//! use slint_ui_system::neon_ui_setup;
//! slint::include_modules!();
//!
//! fn main() -> Result<(), slint::PlatformError> {
//! let win = neon_ui_setup!(MainWindow, Theme, dark = true);
//! win.run()
//! }
//! ```
//!
//! ## Where the actual helpers live
//!
//! * Theme switching helper: [`crate::theme::set_dark_mode`].
//! * Hex color parsing / formatting: [`crate::color`].
//! * Slint-include path constant: [`crate::SLINT_LIBRARY_PATH`].
/// One-shot setup: instantiate a window + apply the dark/light flag.
///
/// `$window` is the generated window type, `$theme` the generated
/// `Theme` global type — both come from `slint::include_modules!()`
/// in the caller's scope. The `dark = true|false` arg drives the
/// initial theme.
///
/// Panics if window construction fails. For graceful error
/// handling, call the underlying methods by hand — this macro is
/// sugar, not a load-bearing API.