css_ast/rules/
property.rs

1use super::prelude::*;
2use crate::Computed;
3#[cfg(feature = "visitable")]
4use crate::visit::{NodeId, QueryableNode};
5
6// https://drafts.csswg.org/cssom-1/#csspagerule
7// https://drafts.csswg.org/css-page-3/#at-page-rule
8#[derive(Parse, Peek, ToSpan, ToCursors, SemanticEq, Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
9#[cfg_attr(feature = "serde", derive(serde::Serialize), serde())]
10#[cfg_attr(feature = "visitable", derive(csskit_derives::Visitable), visit, queryable(skip))]
11#[cfg_attr(feature = "css_feature_data", derive(::csskit_derives::ToCSSFeature), css_feature("css.at-rules.property"))]
12#[derive(csskit_derives::NodeWithMetadata)]
13#[metadata(node_kinds = AtRule, used_at_rules = Property, property_kinds = Name)]
14pub struct PropertyRule<'a> {
15	#[cfg_attr(feature = "visitable", visit(skip))]
16	#[atom(CssAtomSet::Property)]
17	pub name: T![AtKeyword],
18	pub prelude: PropertyPrelude,
19	#[metadata(delegate)]
20	pub block: PropertyRuleBlock<'a>,
21}
22
23#[cfg(feature = "visitable")]
24impl<'a> QueryableNode for PropertyRule<'a> {
25	const NODE_ID: NodeId = NodeId::PropertyRule;
26
27	fn get_property(&self, kind: PropertyKind) -> Option<Cursor> {
28		match kind {
29			PropertyKind::Name => Some(self.prelude.ident()),
30			_ => None,
31		}
32	}
33}
34
35#[derive(Parse, Peek, ToSpan, ToCursors, SemanticEq, Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
36#[cfg_attr(feature = "serde", derive(serde::Serialize), serde())]
37#[cfg_attr(feature = "visitable", derive(csskit_derives::Visitable), visit(self))]
38#[derive(csskit_derives::NodeWithMetadata)]
39pub struct PropertyPrelude(T![DashedIdent]);
40
41impl PropertyPrelude {
42	/// Returns a cursor to the dashed identifier (e.g., `--my-color`).
43	pub fn ident(&self) -> Cursor {
44		self.0.into()
45	}
46}
47
48#[derive(Parse, Peek, ToSpan, ToCursors, SemanticEq, Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
49#[cfg_attr(feature = "visitable", derive(csskit_derives::Visitable))]
50#[cfg_attr(feature = "serde", derive(serde::Serialize), serde())]
51#[derive(csskit_derives::NodeWithMetadata)]
52pub struct PropertyRuleBlock<'a>(#[metadata(delegate)] DeclarationList<'a, PropertyRuleStyleValue<'a>, CssMetadata>);
53
54#[derive(ToSpan, ToCursors, SemanticEq, Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
55#[cfg_attr(feature = "serde", derive(serde::Serialize), serde())]
56#[cfg_attr(feature = "visitable", derive(csskit_derives::Visitable), visit)]
57pub enum PropertyRuleStyleValue<'a> {
58	InitialValue(ComponentValues<'a>),
59	Syntax(SyntaxValue),
60	Inherits(InheritsValue),
61	Unknown(ComponentValues<'a>),
62}
63
64#[derive(Parse, Peek, IntoCursor, ToCursors, Debug, Copy, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
65#[cfg_attr(feature = "serde", derive(serde::Serialize), serde())]
66#[cfg_attr(feature = "visitable", derive(csskit_derives::Visitable), visit(self))]
67#[derive(csskit_derives::NodeWithMetadata)]
68pub enum InheritsValue {
69	#[atom(CssAtomSet::True)]
70	True(T![Ident]),
71	#[atom(CssAtomSet::False)]
72	False(T![Ident]),
73}
74
75#[derive(Parse, Peek, ToCursors, IntoCursor, Debug, Copy, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
76#[cfg_attr(feature = "serde", derive(serde::Serialize), serde())]
77#[cfg_attr(feature = "visitable", derive(csskit_derives::Visitable), visit(self))]
78#[derive(csskit_derives::NodeWithMetadata)]
79pub struct SyntaxValue(T![String]);
80
81impl<'a, M: NodeMetadata> DeclarationValue<'a, M> for PropertyRuleStyleValue<'a> {
82	type ComputedValue = Computed<'a>;
83
84	fn valid_declaration_name<I>(p: &Parser<'a, I>, c: Cursor) -> bool
85	where
86		I: Iterator<Item = Cursor> + Clone,
87	{
88		matches!(p.to_atom::<CssAtomSet>(c), CssAtomSet::InitialValue | CssAtomSet::Inherits | CssAtomSet::Syntax)
89	}
90
91	fn is_unknown(&self) -> bool {
92		matches!(self, Self::Unknown(_))
93	}
94
95	fn is_initial(&self) -> bool {
96		false
97	}
98
99	fn is_inherit(&self) -> bool {
100		false
101	}
102
103	fn is_unset(&self) -> bool {
104		false
105	}
106
107	fn is_revert(&self) -> bool {
108		false
109	}
110
111	fn is_revert_layer(&self) -> bool {
112		false
113	}
114
115	fn needs_computing(&self) -> bool {
116		matches!(self, Self::Unknown(_))
117	}
118
119	fn parse_declaration_value<I>(p: &mut Parser<'a, I>, c: Cursor) -> ParserResult<Self>
120	where
121		I: Iterator<Item = Cursor> + Clone,
122	{
123		Ok(match p.to_atom::<CssAtomSet>(c) {
124			CssAtomSet::InitialValue => Self::InitialValue(p.parse::<ComponentValues<'a>>()?),
125			CssAtomSet::Inherits => Self::Inherits(p.parse::<InheritsValue>()?),
126			CssAtomSet::Syntax => Self::Syntax(p.parse::<SyntaxValue>()?),
127			_ => Self::Unknown(p.parse::<ComponentValues<'a>>()?),
128		})
129	}
130}
131
132impl<'a, M: NodeMetadata> NodeWithMetadata<M> for PropertyRuleStyleValue<'a> {
133	fn metadata(&self) -> M {
134		M::default()
135	}
136}
137
138#[cfg(test)]
139mod tests {
140	use super::*;
141	use crate::CssAtomSet;
142	use css_parse::assert_parse;
143
144	#[test]
145	fn size_test() {
146		assert_eq!(std::mem::size_of::<PropertyRule>(), 128);
147	}
148
149	#[test]
150	fn test_writes() {
151		assert_parse!(
152			CssAtomSet::ATOMS,
153			PropertyRule,
154			r#"@property --foo{initial-value:0;inherits:false;syntax:"<length>"}"#
155		);
156	}
157}