//! Site icons, `` link/script assembly, and image HTML assembly. //! Tables stay data; assembly is a function — 配置即数据、装配即函数. use serde_json::{json, Map, Value}; use std::path::{Path, PathBuf}; use crate::table::normalize_ref; #[derive(Clone, Debug)] pub struct HeadLink { pub rel: String, pub href: String, pub type_: String, pub sizes: String, pub media: String, pub as_: String, pub crossorigin: String, /// When `Some(true)`, emit `defer` on classic scripts (not modules). pub defer: Option, pub async_: bool, /// Query `?v=` bump for cache busting. pub version: String, } #[derive(Clone, Debug)] pub struct IconRoute { pub url: String, pub path: PathBuf, pub content_type: String, } fn cell_str(v: &Value) -> String { match v { Value::Null => String::new(), Value::String(s) => s.clone(), Value::Bool(b) => b.to_string(), Value::Number(n) => n.to_string(), other => other.to_string(), } } fn pick<'a>(m: &'a Map, keys: &[&str]) -> Option<&'a Value> { keys.iter().find_map(|k| m.get(*k)) } fn cell_boolish(v: &Value) -> Option { match v { Value::Bool(b) => Some(*b), Value::Number(n) => Some(n.as_i64().unwrap_or(0) != 0), Value::String(s) => { let s = s.trim(); if s.is_empty() { return None; } if matches!( s, "1" | "true" | "True" | "yes" | "on" | "真" | "是" ) { Some(true) } else if matches!( s, "0" | "false" | "False" | "no" | "off" | "假" | "否" ) { Some(false) } else { None } } _ => None, } } fn row_bool(m: &Map, keys: &[&str]) -> Option { pick(m, keys).and_then(cell_boolish) } fn row_str(m: &Map, keys: &[&str]) -> String { pick(m, keys) .map(|v| normalize_ref(&cell_str(v))) .unwrap_or_default() .trim() .to_string() } /// Append `?v=` / `&v=` for cache busting. pub fn href_with_version(href: &str, version: &str) -> String { let version = version.trim(); if version.is_empty() { return href.to_string(); } if href.contains('?') { format!("{href}&v={version}") } else { format!("{href}?v={version}") } } fn esc(s: &str) -> String { s.replace('&', "&") .replace('<', "<") .replace('>', ">") .replace('"', """) } /// Infer Content-Type from file extension. pub fn mime_for_path(path: &str) -> &'static str { let lower = path.to_ascii_lowercase(); if lower.ends_with(".ico") { "image/x-icon" } else if lower.ends_with(".png") { "image/png" } else if lower.ends_with(".svg") { "image/svg+xml" } else if lower.ends_with(".webp") { "image/webp" } else if lower.ends_with(".jpg") || lower.ends_with(".jpeg") { "image/jpeg" } else if lower.ends_with(".gif") { "image/gif" } else if lower.ends_with(".webmanifest") || lower.ends_with(".json") { "application/manifest+json" } else if lower.ends_with(".css") { "text/css; charset=utf-8" } else if lower.ends_with(".js") || lower.ends_with(".mjs") { "text/javascript; charset=utf-8" } else { "application/octet-stream" } } fn rows_of(table: &Value) -> Vec> { match table { Value::Array(a) => a .iter() .filter_map(|v| v.as_object().cloned()) .collect(), Value::Object(m) => { // Columnar GFM: { 关系: […], 地址: […] } let keys: Vec = m.keys().cloned().collect(); if keys.is_empty() { return Vec::new(); } let len = m .values() .filter_map(|v| v.as_array().map(|a| a.len())) .max() .unwrap_or(0); if len == 0 { return vec![m.clone()]; } let mut out = Vec::with_capacity(len); for i in 0..len { let mut row = Map::new(); for k in &keys { if let Some(Value::Array(a)) = m.get(k) { row.insert(k.clone(), a.get(i).cloned().unwrap_or(Value::Null)); } else if i == 0 { row.insert(k.clone(), m.get(k).cloned().unwrap_or(Value::Null)); } } out.push(row); } out } _ => Vec::new(), } } /// Normalize a Head resource table → list of HeadLink. pub fn as_head_links(table: &Value) -> Vec { let mut out = Vec::new(); for m in rows_of(table) { let rel = row_str(&m, &["关系", "rel", "Rel"]); let href = row_str( &m, &["地址", "href", "src", "url", "Href", "Src", "URL"], ); if href.is_empty() { continue; } let rel = if rel.is_empty() { "stylesheet".into() } else { rel }; out.push(HeadLink { rel, href, type_: row_str(&m, &["类型", "type", "Type"]), sizes: row_str(&m, &["尺寸", "sizes", "Sizes"]), media: row_str(&m, &["媒体", "media", "Media"]), as_: row_str(&m, &["作为", "as", "As"]), crossorigin: row_str(&m, &["跨域", "crossorigin", "crossOrigin"]), defer: row_bool(&m, &["推迟", "defer", "Defer"]), async_: row_bool(&m, &["异步", "async", "Async"]).unwrap_or(false), version: row_str(&m, &["版本", "version", "Version", "v"]), }); } out } pub fn head_links_to_json(links: &[HeadLink]) -> Value { Value::Array( links .iter() .map(|l| { let mut o = json!({ "rel": l.rel, "href": l.href, "type": l.type_, "sizes": l.sizes, "media": l.media, "as": l.as_, "crossorigin": l.crossorigin, "async": l.async_, "version": l.version, }); if let Some(d) = l.defer { o.as_object_mut() .unwrap() .insert("defer".into(), json!(d)); } o }) .collect(), ) } pub fn head_links_from_json(v: &Value) -> Vec { let Some(arr) = v.as_array() else { return as_head_links(v); }; let mut out = Vec::new(); for item in arr { let Some(m) = item.as_object() else { continue; }; let href = row_str(m, &["href", "src", "url", "地址"]); if href.is_empty() { continue; } out.push(HeadLink { rel: row_str(m, &["rel", "关系"]), href, type_: row_str(m, &["type", "类型"]), sizes: row_str(m, &["sizes", "尺寸"]), media: row_str(m, &["media", "媒体"]), as_: row_str(m, &["as", "作为"]), crossorigin: row_str(m, &["crossorigin", "跨域"]), defer: row_bool(m, &["defer", "推迟"]), async_: row_bool(m, &["async", "异步"]).unwrap_or(false), version: row_str(m, &["version", "版本", "v"]), }); } out } /// Render HeadLink list to HTML (link / script tags). pub fn render_head_links(links: &[HeadLink]) -> String { render_head_links_with_version(links, "") } pub fn render_head_links_with_version(links: &[HeadLink], asset_version: &str) -> String { let mut s = String::new(); for l in links { let rel = l.rel.trim().to_ascii_lowercase(); let ver = if !l.version.trim().is_empty() { l.version.as_str() } else { asset_version }; let href = href_with_version(&l.href, ver); if rel == "script" || rel == "module" { let mut tag = String::from("", esc(&href))); s.push_str(&tag); continue; } let mut tag = format!(""); s.push_str(&tag); } s } /// Module-level preview: assemble head table → HTML string. pub fn make_head_html(table: &Value) -> String { render_head_links(&as_head_links(table)) } /// Normalize icons table → (icons json array, site_head links, file routes). pub fn normalize_icons(table: &Value) -> (Value, Vec, Vec) { let mut icons = Vec::new(); let mut head = Vec::new(); let mut routes = Vec::new(); let mut saw_favicon_url = false; for m in rows_of(table) { let path = row_str(&m, &["路径", "path", "file", "Path"]); let mut rel = row_str(&m, &["关系", "rel", "Rel"]); if rel.is_empty() { rel = "icon".into(); } let mut type_ = row_str(&m, &["类型", "type", "Type"]); let sizes = row_str(&m, &["尺寸", "sizes", "Sizes"]); let mut url = row_str(&m, &["地址", "url", "href", "Href", "URL"]); if type_.is_empty() && !path.is_empty() { type_ = mime_for_path(&path).to_string(); } if url.is_empty() { if !path.is_empty() { let name = Path::new(&path) .file_name() .and_then(|s| s.to_str()) .unwrap_or("icon"); let lower = path.to_ascii_lowercase(); if rel.to_ascii_lowercase().contains("icon") && lower.ends_with(".ico") { url = "/favicon.ico".into(); } else { url = format!("/icons/{name}"); } } else { continue; } } if url == "/favicon.ico" { saw_favicon_url = true; } icons.push(json!({ "path": path, "rel": rel, "type": type_, "sizes": sizes, "url": url, })); if !url.is_empty() { head.push(HeadLink { rel: rel.clone(), href: url.clone(), type_: type_.clone(), sizes: sizes.clone(), media: String::new(), as_: String::new(), crossorigin: String::new(), defer: None, async_: false, version: String::new(), }); } if !path.is_empty() && !url.is_empty() { routes.push(IconRoute { url: url.clone(), path: PathBuf::from(&path), content_type: if type_.is_empty() { mime_for_path(&path).to_string() } else { type_.clone() }, }); } } // Ensure browser default path if we have an icon file but no /favicon.ico. if !saw_favicon_url { if let Some(first) = icons.iter().find(|v| { v.get("rel") .and_then(|r| r.as_str()) .map(|r| r.to_ascii_lowercase().contains("icon")) .unwrap_or(false) && v.get("path") .and_then(|p| p.as_str()) .map(|p| !p.is_empty()) .unwrap_or(false) }) { let path = first.get("path").and_then(|v| v.as_str()).unwrap_or(""); let type_ = first .get("type") .and_then(|v| v.as_str()) .unwrap_or_else(|| mime_for_path(path)); routes.push(IconRoute { url: "/favicon.ico".into(), path: PathBuf::from(path), content_type: type_.to_string(), }); head.insert( 0, HeadLink { rel: "icon".into(), href: "/favicon.ico".into(), type_: type_.to_string(), sizes: first .get("sizes") .and_then(|v| v.as_str()) .unwrap_or("") .to_string(), media: String::new(), as_: String::new(), crossorigin: String::new(), defer: None, async_: false, version: String::new(), }, ); } } (Value::Array(icons), head, routes) } /// Convention: if static_dir has favicon.ico|png|svg and icons empty, register defaults. pub fn convention_favicon(static_dir: &Path) -> Option<(Vec, Vec)> { for name in ["favicon.ico", "favicon.png", "favicon.svg"] { let p = static_dir.join(name); if p.is_file() { let ct = mime_for_path(name).to_string(); let head = vec![HeadLink { rel: "icon".into(), href: "/favicon.ico".into(), type_: ct.clone(), sizes: String::new(), media: String::new(), as_: String::new(), crossorigin: String::new(), defer: None, async_: false, version: String::new(), }]; let routes = vec![IconRoute { url: "/favicon.ico".into(), path: p, content_type: ct, }]; return Some((head, routes)); } } None } /// Merge site_head into a page value (dedupe by href+rel). pub fn merge_site_head(page: &mut Value, site_head: &[HeadLink]) { if site_head.is_empty() { return; } let obj = match page.as_object_mut() { Some(o) => o, None => return, }; let mut existing = obj .get("head") .map(head_links_from_json) .unwrap_or_default(); for link in site_head { let dup = existing.iter().any(|e| { e.href == link.href && e.rel.eq_ignore_ascii_case(&link.rel) }); if !dup { existing.push(link.clone()); } } obj.insert("head".into(), head_links_to_json(&existing)); } /// GFM image table → HTML fragment. pub fn make_images_html(table: &Value) -> String { let mut figures = String::new(); for m in rows_of(table) { let src = row_str(&m, &["源", "src", "Src", "url", "URL"]); if src.is_empty() { continue; } let alt = row_str(&m, &["替代", "alt", "Alt"]); let title = row_str(&m, &["标题", "title", "Title"]); let class = row_str(&m, &["类", "class", "Class"]); let href = row_str(&m, &["链接", "href", "link", "Href", "Link"]); let width = row_str(&m, &["宽度", "width", "Width"]); let height = row_str(&m, &["高度", "height", "Height"]); let mut loading = row_str(&m, &["加载", "loading", "Loading"]); if loading.is_empty() { loading = "lazy".into(); } let caption = row_str(&m, &["图注", "caption", "Caption"]); let mut img = format!("\"{}\"",", esc(&loading))); let inner = if href.is_empty() { img } else { format!("{}", esc(&href), img) }; let fig_class = if class.is_empty() { "mq-img".into() } else { format!("mq-img {}", class) }; figures.push_str(&format!("
{}", fig_class, inner)); if !caption.is_empty() { figures.push_str(&format!("
{}
", esc(&caption))); } figures.push_str("
"); } if figures.is_empty() { return String::new(); } format!("
{figures}
") } #[cfg(test)] mod tests { use super::*; use serde_json::json; #[test] fn images_basic() { let t = json!([ {"源": "/a.png", "替代": "A", "类": "logo", "加载": "eager"} ]); let h = make_images_html(&t); assert!(h.contains("mq-images")); assert!(h.contains("src=\"/a.png\"")); assert!(h.contains("loading=\"eager\"")); assert!(h.contains("class=\"mq-img logo\"")); } #[test] fn head_script_and_icon() { let t = json!([ {"关系": "icon", "地址": "/favicon.ico", "类型": "image/x-icon"}, {"关系": "script", "地址": "/static/a.js"} ]); let h = make_head_html(&t); assert!(h.contains("rel=\"icon\"")); assert!(h.contains("")); assert!(!h.contains(" defer"), "{h}"); } #[test] fn head_script_defer_async_version() { let t = json!([ {"关系": "script", "地址": "/static/a.js", "推迟": true, "版本": "3"}, {"关系": "module", "地址": "/static/b.js", "版本": "9"}, {"关系": "stylesheet", "地址": "/static/t.css", "版本": "1"}, ]); let h = make_head_html(&t); assert!(h.contains(""), "{h}"); assert!(h.contains("type=\"module\""), "{h}"); assert!(h.contains("src=\"/static/b.js?v=9\""), "{h}"); assert!(h.contains("href=\"/static/t.css?v=1\""), "{h}"); } #[test] fn head_asset_version_fallback() { let links = as_head_links(&json!([ {"关系": "script", "地址": "/static/a.js", "推迟": "真"}, ])); let h = render_head_links_with_version(&links, "2026-09-04"); assert!( h.contains(""), "{h}" ); } }