Files
marqdo/plugins/web-rust-archive/src/assets.rs
T
cflmyandCursor ca40c698a2 refactor(web): start Go ABI rewrite of plugins/web (W-G0)
Archive the Rust web plugin and add a Go c-shared skeleton with ABI v2
bridge, build script, design doc/ADR, and smoke test so multi-language
plugins and full web parity can proceed wave by wave.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-10 14:47:43 +08:00

608 lines
20 KiB
Rust

//! Site icons, `<head>` 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<bool>,
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<String, Value>, keys: &[&str]) -> Option<&'a Value> {
keys.iter().find_map(|k| m.get(*k))
}
fn cell_boolish(v: &Value) -> Option<bool> {
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<String, Value>, keys: &[&str]) -> Option<bool> {
pick(m, keys).and_then(cell_boolish)
}
fn row_str(m: &Map<String, Value>, 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('&', "&amp;")
.replace('<', "&lt;")
.replace('>', "&gt;")
.replace('"', "&quot;")
}
/// 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<Map<String, Value>> {
match table {
Value::Array(a) => a
.iter()
.filter_map(|v| v.as_object().cloned())
.collect(),
Value::Object(m) => {
// Columnar GFM: { 关系: […], 地址: […] }
let keys: Vec<String> = 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<HeadLink> {
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<HeadLink> {
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("<script");
let is_module = rel == "module" || l.type_ == "module";
if is_module {
tag.push_str(" type=\"module\"");
} else if !l.type_.is_empty() {
tag.push_str(&format!(" type=\"{}\"", esc(&l.type_)));
}
// Modules are deferred by browsers; classic scripts honor explicit defer.
if !is_module && l.defer == Some(true) {
tag.push_str(" defer");
}
if l.async_ {
tag.push_str(" async");
}
if !l.crossorigin.is_empty() {
tag.push_str(&format!(" crossorigin=\"{}\"", esc(&l.crossorigin)));
}
tag.push_str(&format!(" src=\"{}\"></script>", esc(&href)));
s.push_str(&tag);
continue;
}
let mut tag = format!("<link rel=\"{}\" href=\"{}\"", esc(&l.rel), esc(&href));
if !l.type_.is_empty() {
tag.push_str(&format!(" type=\"{}\"", esc(&l.type_)));
}
if !l.sizes.is_empty() {
tag.push_str(&format!(" sizes=\"{}\"", esc(&l.sizes)));
}
if !l.media.is_empty() {
tag.push_str(&format!(" media=\"{}\"", esc(&l.media)));
}
if !l.as_.is_empty() {
tag.push_str(&format!(" as=\"{}\"", esc(&l.as_)));
}
if !l.crossorigin.is_empty() {
tag.push_str(&format!(" crossorigin=\"{}\"", esc(&l.crossorigin)));
}
tag.push_str("/>");
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<HeadLink>, Vec<IconRoute>) {
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<HeadLink>, Vec<IconRoute>)> {
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!("<img src=\"{}\" alt=\"{}\"", esc(&src), esc(&alt));
if !title.is_empty() {
img.push_str(&format!(" title=\"{}\"", esc(&title)));
}
if !width.is_empty() {
img.push_str(&format!(" width=\"{}\"", esc(&width)));
}
if !height.is_empty() {
img.push_str(&format!(" height=\"{}\"", esc(&height)));
}
img.push_str(&format!(" loading=\"{}\"/>", esc(&loading)));
let inner = if href.is_empty() {
img
} else {
format!("<a href=\"{}\">{}</a>", esc(&href), img)
};
let fig_class = if class.is_empty() {
"mq-img".into()
} else {
format!("mq-img {}", class)
};
figures.push_str(&format!("<figure class=\"{}\">{}", fig_class, inner));
if !caption.is_empty() {
figures.push_str(&format!("<figcaption>{}</figcaption>", esc(&caption)));
}
figures.push_str("</figure>");
}
if figures.is_empty() {
return String::new();
}
format!("<div class=\"mq-images\" data-slot=\"main\">{figures}</div>")
}
#[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("<script src=\"/static/a.js\"></script>"));
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("<script defer src=\"/static/a.js?v=3\"></script>"), "{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("<script defer src=\"/static/a.js?v=2026-09-04\"></script>"),
"{h}"
);
}
}