Method parse

crates/css_parse/src/syntax/block.rs:60–191

(p: &mut Parser<'a, Iter>)

	M: NodeMetadata,
{
	fn parse<Iter>(p: &mut Parser<'a, Iter>) -> Result<Self>
	where
		Iter: Iterator<Item = crate::Cursor> + Clone,
	{
		let open_curly = p.parse::<T!['{']>()?;
		let mut declarations = Vec::new_in(p.bump());
		let mut rules = Vec::new_in(p.bump());
		let mut meta = M::default();

		// Per CSS Syntax spec: maintain a buffer of declarations to flush when we encounter rules.
		// This enables proper interleaving of declarations and rules.
		let mut decls: Vec<'a, DeclarationOrBad<'a, D, M>> = Vec::new_in(p.bump());

		// Flush the decls buffer into the rules list as a DeclarationGroup.
		// Per spec: "If decls is not empty, append it to rules, and set decls to a fresh empty list"
		macro_rules! flush_decls {
			() => {
				if !decls.is_empty() {
					let group = DeclarationGroup { declarations: std::mem::replace(&mut decls, Vec::new_in(p.bump())) };
					if let Some(rule) = R::from_declaration_group(group) {
						meta = meta.merge(rule.metadata());
						rules.push(rule);
					}
				}
			};
		}

		loop {
			// While by default the parser will skip whitespace, the Declaration or Rule type may be a whitespace sensitive
			// node, for example `ComponentValues`. As such whitespace needs to be consumed here, before Declarations and
			// Rules are parsed.
			// Additional tokens, such as CDC (`-->`) and CDO (`<!--`), Semicolon, RightParen, RightSquare are not valid
			// component values and are not consumed by the declaration/rule/bad-declaration recovery paths below. Left
			// unconsumed they cause a zero-progress loop and unbounded allocation. Per CSS Syntax they are only meaningful
			// at the stylesheet top level, so discard them here, mirroring the stylesheet top-level loop.
			p.consume_trivia_as_leading();
			const ERROR_KINDS: KindSet = KindSet::new(&[
				Kind::CdcOrCdo,
				Kind::Semicolon,
				Kind::RightParen,
				Kind::RightSquare,
				Kind::BadString,
				Kind::BadUrl,
			]);
			let c = p.peek_n(1);
			if c == ERROR_KINDS {
				let old_skip = p.set_skip(ERROR_KINDS);
				p.consume_trivia_as_leading();
				p.set_skip(old_skip);
				continue;
			}
			if p.at_end() {
				break;
			}
			let c = p.peek_n(1);
			if <T!['}']>::peek(p, c) {
				break;
			}