What is the NodeHtmlBlock block_type field, please?

[mightyiam]

Sorry, I couldn't figure out what this field represents.

comrak/src/nodes.rs

Lines 337 to 346 in 4c909b6

	/// The metadata of an included HTML block.
	#[derive(Debug, Default, Clone, PartialEq, Eq)]
	pub struct NodeHtmlBlock {
	/// The HTML block's type
	pub block_type: u8,
	/// The literal contents of the HTML block. Per NodeCodeBlock, the content is included here
	/// rather than in any inline.
	pub literal: String,
	}

[kivikakk]

Haha, good call, it's not very clear, is it? Here's where it's assigned in the code:

comrak/src/parser/mod.rs

Lines 1052 to 1065 in 4c909b6

	} else if !indented
	&& (unwrap_into(
	scanners::html_block_start(&line[self.first_nonspace..]),
	&mut matched,
	) || (!node_matches!(container, NodeValue::Paragraph)
	&& unwrap_into(
	scanners::html_block_start_7(&line[self.first_nonspace..]),
	&mut matched,
	)))
	{
	let nhb = NodeHtmlBlock {
	block_type: matched as u8,
	literal: String::new(),
	};

This is also not very clear — tl;dr it stores a number from 1 to 7, corresponding to these seven start/end condition pairs in CommonMark § 4.6:

1. Start condition: line begins with the string <pre, <script, <style, or <textarea (case-insensitive), followed by a space, a tab, the string >, or the end of the line.
   End condition: line contains an end tag </pre>, </script>, </style>, or </textarea> (case-insensitive; it need not match the start tag).

2. Start condition: line begins with the string <!--.
   End condition: line contains the string -->.

3. Start condition: line begins with the string <?.
   End condition: line contains the string ?>.

4. Start condition: line begins with the string <! followed by an ASCII letter.
   End condition: line contains the character >.

5. Start condition: line begins with the string <![CDATA[.
   End condition: line contains the string ]]>.

6. Start condition: line begins the string < or </ followed by one of the strings (case-insensitive) address, article, aside, base, basefont, blockquote, body, caption, center, col, colgroup, dd, details, dialog, dir, div, dl, dt, fieldset, figcaption, figure, footer, form, frame, frameset, h1, h2, h3, h4, h5, h6, head, header, hr, html, iframe, legend, li, link, main, menu, menuitem, nav, noframes, ol, optgroup, option, p, param, section, source, summary, table, tbody, td, tfoot, th, thead, title, tr, track, ul, followed by a space, a tab, the end of the line, the string >, or the string />.
   End condition: line is followed by a blank line.

7. Start condition: line begins with a complete open tag (with any tag name other than pre, script, style, or textarea) or a complete closing tag, followed by zero or more spaces and tabs, followed by the end of the line.
   End condition: line is followed by a blank line.

[mightyiam]

Thank you!