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<IconSource>> for IconSource {
163 fn into_prop(self) -> Prop<Option<IconSource>> {
164 Prop(PropKind::Value(Some(self)))
165 }
166}
167
168impl IntoProp<Option<Style>> for Style {
169 fn into_prop(self) -> Prop<Option<Style>> {
170 Prop(PropKind::Value(Some(self)))
171 }
172}
173
174impl IntoProp<Option<f32>> for f32 {
176 fn into_prop(self) -> Prop<Option<f32>> {
177 Prop(PropKind::Value(Some(self)))
178 }
179}
180
181impl IntoProp<Anchors> for Edge {
182 fn into_prop(self) -> Prop<Anchors> {
183 Prop(PropKind::Value(Anchors::from(self)))
184 }
185}
186
187impl IntoProp<IconSource> for &str {
189 fn into_prop(self) -> Prop<IconSource> {
190 Prop(PropKind::Value(IconSource::Name(self.to_owned())))
191 }
192}
193
194impl IntoProp<IconSource> for String {
196 fn into_prop(self) -> Prop<IconSource> {
197 Prop(PropKind::Value(IconSource::Name(self)))
198 }
199}
200
201impl IntoProp<PathBuf> for &Path {
202 fn into_prop(self) -> Prop<PathBuf> {
203 Prop(PropKind::Value(self.to_owned()))
204 }
205}
206
207impl IntoProp<PathBuf> for &PathBuf {
208 fn into_prop(self) -> Prop<PathBuf> {
209 Prop(PropKind::Value(self.clone()))
210 }
211}
212
213impl IntoProp<PathBuf> for &str {
214 fn into_prop(self) -> Prop<PathBuf> {
215 Prop(PropKind::Value(PathBuf::from(self)))
216 }
217}
218
219impl IntoProp<PathBuf> for String {
220 fn into_prop(self) -> Prop<PathBuf> {
221 Prop(PropKind::Value(PathBuf::from(self)))
222 }
223}
224
225impl IntoProp<IconSource> for &Path {
227 fn into_prop(self) -> Prop<IconSource> {
228 Prop(PropKind::Value(IconSource::File(self.to_owned())))
229 }
230}
231
232impl IntoProp<IconSource> for PathBuf {
234 fn into_prop(self) -> Prop<IconSource> {
235 Prop(PropKind::Value(IconSource::File(self)))
236 }
237}
238
239#[cfg(test)]
240mod tests {
241 use std::path::PathBuf;
242
243 use super::{IntoProp, PropKind};
244
245 fn value(prop: impl IntoProp<PathBuf>) -> Option<PathBuf> {
246 match prop.into_prop().0 {
247 PropKind::Value(value) => Some(value),
248 PropKind::Binding(_) => None,
249 }
250 }
251
252 #[test]
253 fn a_path_buf_by_reference_is_a_plain_value() {
254 let path = PathBuf::from("/walls");
255 assert_eq!(value(&path), Some(path.clone()));
256 assert_eq!(value(path.as_path()), Some(path.clone()));
257 assert_eq!(value("/walls"), Some(path));
258 }
259}