fret-framework 0.1.0

Fret framework facade crate: opt-in re-exports for advanced/manual assembly.
Documentation 
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

//! Fret's kernel facade crate.
//!
//! This crate is intended to be the small, memorable entry point for **manual/advanced assembly**
//! and integrations. It re-exports selected workspace crates behind opt-in feature flags, without
//! pulling ecosystem defaults (components, policies, tooling) into `crates/*`.
//!
//! For the batteries-included desktop-first experience, prefer:
//! - `fret` (ecosystem meta crate; app entry points)
//! - `fretboard` (dev tooling)
//!
//! See ADR 0109: `docs/adr/0109-user-facing-crate-surfaces-and-golden-path.md`.
//!
//! Default features are intentionally minimal (`core` only). Enable additional feature bundles
//! explicitly, or use `fret` for the batteries-included golden path.

#[cfg(feature = "core")]
pub mod core {
    pub use fret_core::*;
}

#[cfg(feature = "app")]
pub mod app {
    pub use fret_app::*;
}

#[cfg(feature = "ui")]
pub mod ui {
    pub use fret_ui::*;
}

#[cfg(feature = "runtime")]
pub mod runtime {
    pub use fret_runtime::*;
}

#[cfg(feature = "render")]
pub mod render {
    pub use fret_render::*;
}

#[cfg(feature = "fonts")]
pub mod fonts {
    pub use fret_fonts::*;
}

#[cfg(feature = "platform-contracts")]
pub mod platform {
    pub use fret_platform::*;
}

#[cfg(feature = "platform-native")]
pub mod platform_native {
    pub use fret_platform_native::*;
}

#[cfg(feature = "platform-web")]
pub mod platform_web {
    pub use fret_platform_web::*;
}

#[cfg(feature = "runner-winit")]
pub mod runner_winit {
    pub use fret_runner_winit::*;
}

#[cfg(feature = "runner-web")]
pub mod runner_web {
    pub use fret_runner_web::*;
}

#[cfg(feature = "launch")]
pub mod launch {
    //! Curated launch-facing exports for manual assembly.
    //!
    //! This module intentionally exposes the core launch/builder/driver contract used by advanced
    //! assembly code while avoiding a full mirror of `fret_launch::*`.
    //!
    //! Prefer depending on `fret-launch` directly when you need specialized interop/media helpers,
    //! compatibility-only runner traits such as `WinitAppDriver`, or when runner-facing naming
    //! itself is part of your public API.
    pub use fret_launch::{
        EngineFrameKeepalive, EngineFrameUpdate, FnDriver, FnDriverHooks, RunnerError, WgpuInit,
        WindowCreateSpec, WindowLogicalSize, WindowPhysicalPosition, WindowPosition,
        WinitCommandContext, WinitEventContext, WinitGlobalContext, WinitHotReloadContext,
        WinitRenderContext, WinitRunnerConfig, WinitWindowContext,
    };

    #[cfg(not(target_arch = "wasm32"))]
    pub use fret_launch::{WinitAppBuilder, run_app, run_app_with_event_loop};

    #[cfg(target_arch = "wasm32")]
    pub use fret_launch::{WebRunnerHandle, run_app_with_handle};
}

pub mod prelude {
    #[cfg(feature = "app")]
    pub use fret_app::{App, Effect};

    #[cfg(feature = "core")]
    pub use fret_core::{AppWindowId, CursorIcon, Event, Point, Px, Rect, Scene, Size};

    #[cfg(feature = "runtime")]
    pub use fret_runtime::{
        CommandId, Effect as RuntimeEffect, GlobalsHost, PlatformCapabilities, PlatformCompletion,
        TickId, UiHost,
    };

    #[cfg(feature = "ui")]
    pub use fret_ui::{ElementContext, ElementRuntime, UiTree};
}