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
use std::sync::Arc;
use reactive_core::ReadSignal;
use renderer_assets::SvgData;
/// The lifecycle of an asynchronously-resolved asset. Kept inside a signal so a widget re-renders as the state advances from `Loading` to `Ready`/`Failed`.
#[derive(Clone, Debug)]
pub enum AssetState<T> {
Loading,
Ready(T),
Failed,
}
/// Two resolved states are the same asset when they hold the same `Arc` — identity, not contents. Comparing a
/// decoded asset structurally would walk every path of every glyph to answer a question the pointer already
/// answers, and answer it differently: two identical decodes of the same file are still two arrivals.
///
/// Only `Arc` payloads, which is what an [`AssetSource`] hands out. It exists so a `memo` can hold one, which is
/// what lets a view `match` on an asset as it resolves.
impl<T> PartialEq for AssetState<std::sync::Arc<T>> {
fn eq(&self, other: &Self) -> bool {
match (self, other) {
(AssetState::Loading, AssetState::Loading) => true,
(AssetState::Failed, AssetState::Failed) => true,
(AssetState::Ready(a), AssetState::Ready(b)) => std::sync::Arc::ptr_eq(a, b),
_ => false,
}
}
}
impl<T> AssetState<T> {
pub fn is_ready(&self) -> bool {
matches!(self, AssetState::Ready(_))
}
pub fn as_ready(&self) -> Option<&T> {
match self {
AssetState::Ready(value) => Some(value),
_ => None,
}
}
pub fn into_ready(self) -> Option<T> {
match self {
AssetState::Ready(value) => Some(value),
_ => None,
}
}
}
/// A transport-agnostic source of SVG assets addressed by string id. rsx owns the reactive contract — a signal that advances `Loading` → `Ready`/`Failed` and re-renders whoever read it — while an implementor supplies the bytes from disk, a bundle, or the network entirely outside this crate.
pub trait AssetSource {
/// A reactive handle to the SVG named `id`. Reading it subscribes the caller and may start the load; the state advances as the asset resolves.
fn svg(&self, id: &str) -> ReadSignal<AssetState<Arc<SvgData>>>;
/// The resolved SVG, or `fallback()` while it is still loading or has failed. Reads reactively, so a widget calling this re-renders once the asset lands.
fn svg_or(&self, id: &str, fallback: impl FnOnce() -> Arc<SvgData>) -> Arc<SvgData> {
match self.svg(id).get() {
AssetState::Ready(data) => data,
_ => fallback(),
}
}
}