use std::collections::HashMap;
use markdoc::types::{RenderableTreeNode, Scalar, Tag};
use super::block::bump_heading_counters;
use super::inline::anchor_id_attr;
use super::style::HeadingNumbering;
pub fn build_crossref_labels(
root: &RenderableTreeNode,
numbering: &HeadingNumbering,
) -> HashMap<String, String> {
let mut labels = HashMap::new();
let mut counters = [0u32; 6];
walk(root, numbering, &mut counters, &mut labels);
labels
}
fn walk(
node: &RenderableTreeNode,
numbering: &HeadingNumbering,
counters: &mut [u32; 6],
labels: &mut HashMap<String, String>,
) {
let RenderableTreeNode::Tag(tag) = node else {
return;
};
if let Some(level) = heading_level(&tag.name) {
record_heading(tag, level, numbering, counters, labels);
}
for child in &tag.children {
walk(child, numbering, counters, labels);
}
}
fn heading_level(name: &str) -> Option<u8> {
match name {
"h1" => Some(1),
"h2" => Some(2),
"h3" => Some(3),
"h4" => Some(4),
"h5" => Some(5),
"h6" => Some(6),
_ => None,
}
}
fn record_heading(
tag: &Tag,
level: u8,
numbering: &HeadingNumbering,
counters: &mut [u32; 6],
labels: &mut HashMap<String, String>,
) {
let mut heading_anchor: Option<String> = None;
let mut opt_out_numbering = false;
for child in &tag.children {
if let RenderableTreeNode::Tag(t) = child
&& t.name == "tag"
{
if heading_anchor.is_none()
&& let Some(id) = anchor_id_attr(t)
{
heading_anchor = Some(id);
}
if attr_is_false(t, "numbered") {
opt_out_numbering = true;
}
}
}
let title = extract_heading_title(&tag.children);
if title.is_empty() {
return;
}
let number = if numbering.enabled && !opt_out_numbering {
bump_heading_counters(counters, level, numbering.max_depth)
} else {
None
};
let Some(id) = heading_anchor else {
return;
};
let label = match number {
Some(n) => format!("{n}{}{title}", numbering.separator),
None => title,
};
labels.insert(id, label);
}
fn extract_heading_title(children: &[RenderableTreeNode]) -> String {
let mut out = String::new();
extract_plain(&mut out, children);
out.split_whitespace().collect::<Vec<_>>().join(" ")
}
fn extract_plain(out: &mut String, children: &[RenderableTreeNode]) {
for child in children {
match child {
RenderableTreeNode::Scalar(value) => {
if let Some(text) = super::inline::scalar_text(value) {
out.push_str(&text);
}
}
RenderableTreeNode::Tag(t) if t.name == "tag" => {}
RenderableTreeNode::Tag(t) => extract_plain(out, &t.children),
}
}
}
fn attr_is_false(tag: &Tag, key: &str) -> bool {
match tag.attributes.get(key) {
Some(Scalar::Boolean(b)) => !b,
Some(Scalar::String(s)) => {
let s = s.trim();
s.eq_ignore_ascii_case("false") || s == "0"
}
_ => false,
}
}
#[cfg(test)]
mod tests {
use super::*;
fn enabled_numbering() -> HeadingNumbering {
HeadingNumbering {
enabled: true,
max_depth: 3,
separator: " ".to_string(),
}
}
fn labels_for(src: &str, numbering: HeadingNumbering) -> HashMap<String, String> {
let tree = crate::pipeline::render_tree(src).unwrap();
build_crossref_labels(&tree, &numbering)
}
#[test]
fn numbered_heading_tag_gets_section_label() {
let src = r#"
# Usage
## Manual brake release {% tag "manual_brake_release_switch" /%}
See later.
"#;
let labels = labels_for(src, enabled_numbering());
assert_eq!(
labels
.get("manual_brake_release_switch")
.map(String::as_str),
Some("1.1 Manual brake release")
);
}
#[test]
fn unnumbered_opt_out_uses_title_only() {
let src = r#"
# Intro {% tag id="intro" numbered="false" /%}
# Usage {% tag id="usage" /%}
"#;
let labels = labels_for(src, enabled_numbering());
assert_eq!(labels.get("intro").map(String::as_str), Some("Intro"));
assert_eq!(labels.get("usage").map(String::as_str), Some("1 Usage"));
}
#[test]
fn primary_shorthand_with_numbered_false() {
let src = r#"# Intro {% tag "intro" numbered="false" /%}"#;
let labels = labels_for(src, enabled_numbering());
assert_eq!(labels.get("intro").map(String::as_str), Some("Intro"));
}
#[test]
fn numbering_disabled_uses_title_only() {
let src = r#"# Manual brake release {% tag id="x" /%}"#;
let mut numbering = enabled_numbering();
numbering.enabled = false;
let labels = labels_for(src, numbering);
assert_eq!(
labels.get("x").map(String::as_str),
Some("Manual brake release")
);
}
}