1use std::cell::RefCell;
4use std::path::{Path, PathBuf};
5use std::rc::Rc;
6use std::time::Duration;
7
8use crate::animation::Transition;
9use crate::image::ImageTransition;
10use crate::input::CursorShape;
11use crate::menu::MenuEntry;
12use crate::popup::Adjust;
13use crate::region::Region;
14use crate::rich::Span;
15use crate::screencopy::CaptureSource;
16use crate::style::{Color, Style};
17use crate::widgets::{Align, Elide, Fit, IconSource, Justify};
18use crate::window::{Anchors, Edge, KeyboardFocus, Layer, Margins};
19
20pub struct Prop<T>(pub(crate) PropKind<T>);
26
27impl<T: Clone + 'static> Prop<T> {
28 pub fn shared(self) -> Rc<dyn Fn() -> T> {
33 match self.0 {
34 PropKind::Value(value) => Rc::new(move || value.clone()),
35 PropKind::Binding(compute) => {
36 let compute = RefCell::new(compute);
37 Rc::new(move || (compute.borrow_mut())())
38 }
39 }
40 }
41}
42
43impl<T: 'static> Prop<T> {
44 pub(crate) fn map<U>(self, f: impl Fn(T) -> U + 'static) -> Prop<U> {
46 Prop(match self.0 {
47 PropKind::Value(value) => PropKind::Value(f(value)),
48 PropKind::Binding(mut compute) => PropKind::Binding(Box::new(move || f(compute()))),
49 })
50 }
51}
52
53pub(crate) enum PropKind<T> {
54 Value(T),
55 Binding(Box<dyn FnMut() -> T>),
56}
57
58pub trait IntoProp<T> {
66 fn into_prop(self) -> Prop<T>;
68}
69
70impl<T, F> IntoProp<T> for F
73where
74 F: FnMut() -> T + 'static,
75{
76 fn into_prop(self) -> Prop<T> {
77 Prop(PropKind::Binding(Box::new(self)))
78 }
79}
80
81impl<T> IntoProp<T> for Prop<T> {
84 fn into_prop(self) -> Prop<T> {
85 self
86 }
87}
88
89impl<T> IntoProp<Option<T>> for Option<T> {
92 fn into_prop(self) -> Prop<Option<T>> {
93 Prop(PropKind::Value(self))
94 }
95}
96
97macro_rules! value_props {
99 ($($ty:ty),* $(,)?) => {
100 $(
101 impl IntoProp<$ty> for $ty {
102 fn into_prop(self) -> Prop<$ty> {
103 Prop(PropKind::Value(self))
104 }
105 }
106 )*
107 };
108}
109
110value_props!(
111 bool,
112 u32,
113 i32,
114 f32,
115 String,
116 Style,
117 Align,
118 Elide,
119 Justify,
120 Anchors,
121 Layer,
122 Margins,
123 KeyboardFocus,
124 PathBuf,
125 Fit,
126 (u32, u32),
127 Adjust,
128 IconSource,
129 CaptureSource,
130 Vec<MenuEntry>,
131 Vec<Span>,
132 Duration,
133 CursorShape,
134 Transition,
135 ImageTransition,
136);
137
138impl IntoProp<String> for &str {
139 fn into_prop(self) -> Prop<String> {
140 Prop(PropKind::Value(self.to_owned()))
141 }
142}
143
144impl IntoProp<Option<Region>> for Region {
145 fn into_prop(self) -> Prop<Option<Region>> {
146 Prop(PropKind::Value(Some(self)))
147 }
148}
149
150impl IntoProp<Option<usize>> for usize {
151 fn into_prop(self) -> Prop<Option<usize>> {
152 Prop(PropKind::Value(Some(self)))
153 }
154}
155
156impl IntoProp<Option<Color>> for Color {
157 fn into_prop(self) -> Prop<Option<Color>> {
158 Prop(PropKind::Value(Some(self)))
159 }
160}
161
162impl IntoProp<Option<Style>> for Style {
163 fn into_prop(self) -> Prop<Option<Style>> {
164 Prop(PropKind::Value(Some(self)))
165 }
166}
167
168impl IntoProp<Option<f32>> for f32 {
170 fn into_prop(self) -> Prop<Option<f32>> {
171 Prop(PropKind::Value(Some(self)))
172 }
173}
174
175impl IntoProp<Anchors> for Edge {
176 fn into_prop(self) -> Prop<Anchors> {
177 Prop(PropKind::Value(Anchors::from(self)))
178 }
179}
180
181impl IntoProp<IconSource> for &str {
183 fn into_prop(self) -> Prop<IconSource> {
184 Prop(PropKind::Value(IconSource::Name(self.to_owned())))
185 }
186}
187
188impl IntoProp<IconSource> for String {
190 fn into_prop(self) -> Prop<IconSource> {
191 Prop(PropKind::Value(IconSource::Name(self)))
192 }
193}
194
195impl IntoProp<PathBuf> for &Path {
196 fn into_prop(self) -> Prop<PathBuf> {
197 Prop(PropKind::Value(self.to_owned()))
198 }
199}
200
201impl IntoProp<PathBuf> for &PathBuf {
202 fn into_prop(self) -> Prop<PathBuf> {
203 Prop(PropKind::Value(self.clone()))
204 }
205}
206
207impl IntoProp<PathBuf> for &str {
208 fn into_prop(self) -> Prop<PathBuf> {
209 Prop(PropKind::Value(PathBuf::from(self)))
210 }
211}
212
213impl IntoProp<PathBuf> for String {
214 fn into_prop(self) -> Prop<PathBuf> {
215 Prop(PropKind::Value(PathBuf::from(self)))
216 }
217}
218
219impl IntoProp<IconSource> for &Path {
221 fn into_prop(self) -> Prop<IconSource> {
222 Prop(PropKind::Value(IconSource::File(self.to_owned())))
223 }
224}
225
226impl IntoProp<IconSource> for PathBuf {
228 fn into_prop(self) -> Prop<IconSource> {
229 Prop(PropKind::Value(IconSource::File(self)))
230 }
231}
232
233#[cfg(test)]
234mod tests {
235 use std::path::PathBuf;
236
237 use super::{IntoProp, PropKind};
238
239 fn value(prop: impl IntoProp<PathBuf>) -> Option<PathBuf> {
240 match prop.into_prop().0 {
241 PropKind::Value(value) => Some(value),
242 PropKind::Binding(_) => None,
243 }
244 }
245
246 #[test]
247 fn a_path_buf_by_reference_is_a_plain_value() {
248 let path = PathBuf::from("/walls");
249 assert_eq!(value(&path), Some(path.clone()));
250 assert_eq!(value(path.as_path()), Some(path.clone()));
251 assert_eq!(value("/walls"), Some(path));
252 }
253}