cranpose 0.9.29

Build desktop, mobile and web apps with composable Rust functions
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

use std::{cell::OnceCell, rc::Rc};

use cranpose_core::{CompositionLocal, compositionLocalOf};
use cranpose_ui::Locale;

/// Reads ordered host language preferences, preserving regions and script subtags.
/// Android includes the application's locale override from its resources configuration.
pub fn system_languages() -> Vec<Locale> {
    let supplied = cranpose_services::host_controller()
        .map_or_else(Vec::new, |host| host.preferred_languages());
    let tags = if supplied.is_empty() {
        sys_locale::get_locales().collect()
    } else {
        supplied
    };
    tags.into_iter()
        .filter_map(|tag| Locale::parse(&tag).ok())
        .collect()
}

/// The current host language preferences for this application subtree.
/// Native configuration changes and app resumes refresh this value automatically.
pub fn local_system_languages() -> CompositionLocal<Rc<[Locale]>> {
    thread_local! {
        static LOCAL: OnceCell<CompositionLocal<Rc<[Locale]>>> = const { OnceCell::new() };
    }
    LOCAL.with(|local| {
        local
            .get_or_init(|| compositionLocalOf(|| system_languages().into()))
            .clone()
    })
}

/// Provides stored language choices and automatic host-language updates to an app.
/// Preference I/O runs on workers; UI labels, accessibility and scoped controls
/// update after a successful choice without a platform-specific application adapter.
#[expect(non_snake_case)]
#[track_caller]
pub fn ProvideApplicationLocalization(
    application: cranpose_ui::localization::Localization,
    content: impl FnOnce(),
) {
    let system = local_system_languages().current();
    cranpose_ui::ProvideLanguagePreferences(application, &system, content);
}