hikari-theme 0.2.2

Theme system with SCSS/CSS variable generation for the Hikari design system
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
111
112
113

//! Theme context for global theme state
//!
//! This module provides the [`ThemeContext`] struct which
//! holds the current theme configuration and color palette.
//! It works with the [`ThemeProvider`] component to enable
//! theme switching across the application.
//!
//! # Example
//!
//! ```rust,no_run
//! use theme::{ThemeContext, ThemeProvider};
//! use palette::themes::Hikari;
//!
//! # fn main() {
//! #     let context = ThemeContext {
//! #         palette: "hikari".to_string(),
//! #         colors: Hikari::palette(),
//! #         direction: LayoutDirection::Ltr,
//! #         set_theme: Callback::new(|_| {}),
//! #     };
//! # }
//! ```

use crate::prelude::*;

/// Layout direction for RTL/LTR support
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default)]
pub enum LayoutDirection {
    #[default]
    Ltr,
    Rtl,
}

impl LayoutDirection {
    pub fn as_str(&self) -> &'static str {
        match self {
            LayoutDirection::Ltr => "ltr",
            LayoutDirection::Rtl => "rtl",
        }
    }

    pub fn is_rtl(&self) -> bool {
        matches!(self, LayoutDirection::Rtl)
    }

    pub fn start(&self) -> &'static str {
        match self {
            LayoutDirection::Ltr => "left",
            LayoutDirection::Rtl => "right",
        }
    }

    pub fn end(&self) -> &'static str {
        match self {
            LayoutDirection::Ltr => "right",
            LayoutDirection::Rtl => "left",
        }
    }
}

/// Theme context state
///
/// Represents the current theme configuration with palette identifier
/// and color scheme.
///
/// # Fields
///
/// - `palette` - Identifier string for the current theme (e.g., "hikari", "tairitsu")
/// - `colors` - The active [`Palette`] with color definitions
/// - `direction` - Layout direction (LTR or RTL) for internationalization support
/// - `set_theme` - Callback to switch to a different theme
#[derive(Clone)]
pub struct ThemeContext {
    pub palette: String,
    pub colors: Palette,
    pub direction: LayoutDirection,
    pub set_theme: Callback<String>,
}

impl Default for ThemeContext {
    fn default() -> Self {
        ThemeContext {
            palette: "hikari".to_string(),
            colors: themes::Hikari::palette(),
            direction: LayoutDirection::Ltr,
            set_theme: Callback::new(|_| {}),
        }
    }
}

/// Hook to access theme context
///
/// # Panics
///
/// Panics if called outside of a ThemeProvider.
pub fn use_theme() -> ThemeContext {
    let ctx = use_context::<ThemeContext>().expect("ThemeContext not found");
    ctx.get().clone()
}

/// Hook to try to access theme context
///
/// Returns None if called outside of a ThemeProvider.
pub fn try_use_theme() -> Option<ThemeContext> {
    use_context::<ThemeContext>().map(|ctx| ctx.get().clone())
}

/// Hook to get layout direction, with fallback to LTR if no ThemeProvider
pub fn use_layout_direction() -> LayoutDirection {
    use_context::<ThemeContext>()
        .map(|ctx| ctx.get().direction)
        .unwrap_or_default()
}