beet_dom 0.0.8

Utilities for dom rendering and interaction
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
114
115
116
117
118
119
120
121
122
123
124
125

use crate::prelude::*;
use beet_core::prelude::*;
use std::hash::Hash;

/// Specify types for variadic functions like TokenizeComponent
pub type LangDirectives = (
	StyleScope,
	StyleCascade,
	ScriptElement,
	StyleElement,
	CodeNode,
	LangSnippetHash,
	InnerText,
	FileInnerText,
);



/// A hash of all aspects of a lang node that makes it unique,
/// including:
/// - [`NodeTag`]
/// - [`InnerText`]
/// - [`StyleScope`]
/// - [`HtmlHoistDirective`]
/// This is used for several purposes:
/// - deduplication of lang nodes
/// - assigning unique style ids to css content
/// 	- in this case the hash may be compressed to a shorter alphanumeric string
#[derive(
	Debug, Copy, Clone, PartialEq, Eq, Hash, Deref, Component, Reflect,
)]
#[reflect(Component)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(feature = "tokens", derive(ToTokens))]
#[component(immutable)]
pub struct LangSnippetHash(pub u64);
impl LangSnippetHash {
	/// Create a new [`LangSnippetHash`] from a `u64`.
	pub fn new(hash: u64) -> Self { Self(hash) }
}
impl std::fmt::Display for LangSnippetHash {
	fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
		write!(f, "{}", self.0)
	}
}


#[derive(Debug, Clone, PartialEq, Hash, Component, Reflect)]
#[reflect(Component)]
#[component(immutable)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(feature = "tokens", derive(ToTokens))]
pub struct ScriptElement;

#[derive(Debug, Clone, PartialEq, Hash, Component, Reflect)]
#[reflect(Component)]
#[component(immutable)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(feature = "tokens", derive(ToTokens))]
pub struct StyleElement;

/// Convenience component equivelent to `children![TextNode]`, often used by elements
/// like `script`,`style` or `code` which require further processing.
///
/// Adding an [`InnerText`] also adds a [`ElementNode::open`].
#[derive(
	Debug, Default, Clone, PartialEq, Hash, Deref, DerefMut, Component, Reflect,
)]
#[reflect(Component)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(feature = "tokens", derive(ToTokens))]
#[component(on_add= on_add)]
pub struct InnerText(pub String);

fn on_add(mut world: DeferredWorld, cx: HookContext) {
	world
		.commands()
		.entity(cx.entity)
		.insert(ElementNode::open());
}


/// An intermediate representation of an [`InnerText`] defined by a `src` attribute,
/// ie `<style src="style.css">`.
/// Upon tokenization this is replaced with an include_str,
/// ie [`InnerText(include_str!("style.css"))`],
/// feature gated behind a  [`not(feature="client")`] to avoid excessivly large
/// client bundles.
///
/// This type is also collected in beet_build and manually loaded, so we can
/// live reload the contents of an `include_str!`.
#[derive(Debug, Clone, PartialEq, Hash, Component, Reflect)]
#[reflect(Component)]
#[component(immutable)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct FileInnerText {
	/// path to the file relative to the source file,
	pub path: String,
}
impl FileInnerText {
	/// Create a new [`FileInnerText`] from a path `String`.
	pub fn new(path: impl Into<String>) -> Self { Self { path: path.into() } }
}


/// A FileInnerText is tokenized directly `include_str!(file)`
///
/// When used in `beet_parse`, any [`FileInnerText`] that requires macro-level parsing
/// will not be tokenized, and instead loaded by `load_file_inner_text`
#[cfg(feature = "tokens")]
impl TokenizeSelf for FileInnerText {
	fn self_tokens(&self, tokens: &mut proc_macro2::TokenStream) {
		let path = &self.path;
		// it would be nice to exclude this in client side but that doesnt work
		// for dynamically added content.
		tokens.extend(quote::quote! {
				InnerText::new(include_str!(#path))
		});
	}
}

impl InnerText {
	/// Create a new [`InnerText`] from a `String`.
	pub fn new(text: impl Into<String>) -> Self { Self(text.into()) }
}