Repository Public
1// SP Notes Core2// File: Sources/SPNotesDocument/HTMLExport.swift3// Description: Standalone HTML5 export of a note, following the server's docToHtml / printHtml (html.ts): escaped4// text, semantic tags, safe URLs, embedded stylesheet. Math is exported as its LaTeX source.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8import Foundation910enum HTMLExport {11 static func escape(_ s: String) -> String {12 var out = ""13 for u in s.unicodeScalars {14 switch u {15 case "&": out += "&"16 case "<": out += "<"17 case ">": out += ">"18 case "\"": out += """19 default: out.unicodeScalars.append(u)20 }21 }22 return out23 }2425 /// `esc(value)`: null and undefined give an empty string.26 static func esc(_ v: JSONValue?) -> String { escape(JS.nullish(v).map(JS.string) ?? "") }2728 static func safeHref(_ v: JSONValue?) -> String {29 let s = JS.nullish(v).map(JS.string) ?? ""30 let l = s.lowercased()31 let ok = ["http://", "https://", "mailto:", "/p/", "/api/files/", "./", "../", "#"].contains { l.hasPrefix($0) }32 return ok ? s : "#"33 }3435 static func safeSrc(_ v: JSONValue?) -> String {36 let s = JS.nullish(v).map(JS.string) ?? ""37 let l = s.lowercased()38 let image = ["png", "jpg", "jpeg", "gif", "webp", "avif"].contains { l.hasPrefix("data:image/\($0);base64,") }39 return image ? s : safeHref(v)40 }4142 static func inline(_ n: PMNode) -> String {43 let a = n.attrs44 if n.type == "text" {45 var t = escape(n.text ?? "")46 for m in n.allMarks {47 switch m.type {48 case "bold": t = "<strong>\(t)</strong>"49 case "italic": t = "<em>\(t)</em>"50 case "code": t = "<code>\(t)</code>"51 case "strike": t = "<s>\(t)</s>"52 case "underline": t = "<u>\(t)</u>"53 case "highlight": t = "<mark>\(t)</mark>"54 case "subscript": t = "<sub>\(t)</sub>"55 case "superscript": t = "<sup>\(t)</sup>"56 case "link": t = "<a href=\"\(escape(safeHref(m.attrs?["href"])))\">\(t)</a>"57 default: break58 }59 }60 return t61 }62 switch n.type {63 case "hardBreak": return "<br>"64 case "mention": return "<span class=\"mention\">@\(esc(JS.nullish(a?["label"]) ?? a?["id"]))</span>"65 case "inlineMath", "math": return "<code class=\"math\">\(esc(a?["latex"]))</code>"66 case "citation": return NextNodes.html(n) ?? ""67 case "footnoteRef": return "<sup class=\"fn\"><a href=\"#fn-\(esc(a?["id"]))\">\(esc(a?["id"]))</a></sup>"68 default: return (n.content ?? []).map(inline).joined()69 }70 }7172 static func blocks(_ nodes: [PMNode]?) -> String { (nodes ?? []).map(block).joined(separator: "\n") }7374 static func block(_ n: PMNode) -> String {75 let a = n.attrs76 switch n.type {77 case "paragraph": return "<p>\(inline(n))</p>"78 case "heading":79 let raw = JS.nullish(a?["level"]).map(JS.number) ?? 180 let l = raw.isNaN ? 1 : Int(min(6, max(1, raw)))81 return "<h\(l)>\(inline(n))</h\(l)>"82 case "blockquote": return "<blockquote>\(blocks(n.content))</blockquote>"83 case "codeBlock":84 let code = (n.content ?? []).map { $0.text ?? "" }.joined()85 return "<pre><code class=\"language-\(esc(a?["language"]))\">\(escape(code))</code></pre>"86 case "bulletList": return "<ul>\((n.content ?? []).map { "<li>\(blocks($0.content))</li>" }.joined())</ul>"87 case "orderedList":88 let start = JS.string(.double(JS.nullish(a?["start"]).map(JS.number) ?? 1))89 return "<ol start=\"\(start)\">\((n.content ?? []).map { "<li>\(blocks($0.content))</li>" }.joined())</ol>"90 case "taskList":91 return "<ul class=\"tasks\">" + (n.content ?? []).map { li -> String in92 let done = JS.truthy(li.attrs?["checked"])93 return "<li class=\"\(done ? "done" : "")\"><input type=\"checkbox\" disabled \(done ? "checked" : "")> <div>\(blocks(li.content))</div></li>"94 }.joined() + "</ul>"95 case "table":96 let rows = (n.content ?? []).enumerated().map { i, row -> String in97 let cells = (row.content ?? []).map { c -> String in98 let tag = c.type == "tableHeader" || i == 0 ? "th" : "td"99 let colspan = JS.number(c.attrs?["colspan"]) > 1 ? " colspan=\"\(esc(c.attrs?["colspan"]))\"" : ""100 let rowspan = JS.number(c.attrs?["rowspan"]) > 1 ? " rowspan=\"\(esc(c.attrs?["rowspan"]))\"" : ""101 return "<\(tag)\(colspan)\(rowspan)>\(blocks(c.content))</\(tag)>"102 }.joined()103 return "<tr>\(cells)</tr>"104 }.joined()105 return "<table>\(rows)</table>"106 case "horizontalRule": return "<hr>"107 case "image":108 let caption = JS.truthy(a?["title"]) ? "<figcaption>\(esc(a?["title"]))</figcaption>" : ""109 return "<figure><img src=\"\(escape(safeSrc(a?["src"])))\" alt=\"\(esc(a?["alt"]))\">\(caption)</figure>"110 case "fileBlock":111 var size = ""112 if JS.truthy(a?["size"]) {113 let kb = (JS.number(a?["size"]) / 1024 + 0.5).rounded(.down)114 size = " <small>(\(JS.string(.double(kb))) KB)</small>"115 }116 return "<p class=\"file\">📎 <a href=\"\(escape(safeHref(a?["src"])))\">\(esc(JS.nullish(a?["name"]) ?? "file"))</a>\(size)</p>"117 case "youtube": return "<p class=\"file\">▶ <a href=\"\(escape(safeHref(a?["src"])))\">\(esc(a?["src"]))</a></p>"118 case "blockMath": return "<div class=\"math-block\"><code class=\"math\">\(esc(a?["latex"]))</code></div>"119 case "callout":120 return "<div class=\"callout callout-\(esc(JS.nullish(a?["kind"]) ?? "note"))\"><span class=\"callout-icon\">\(esc(JS.nullish(a?["icon"]) ?? "💡"))</span><div>\(blocks(n.content))</div></div>"121 case "aiBlock": return "<div class=\"ai-block\" title=\"Generated by \(esc(JS.nullish(a?["model"]) ?? "AI"))\">\(blocks(n.content))</div>"122 case "details":123 let s = n.content?.first { $0.type == "detailsSummary" }124 let b = n.content?.first { $0.type == "detailsContent" }125 return "<details open><summary>\(s.map(inline) ?? "")</summary>\(blocks(b?.content))</details>"126 case "footnote":127 return "<p class=\"footnote\" id=\"fn-\(esc(a?["id"]))\"><sup>\(esc(a?["id"]))</sup> \((n.content ?? []).map(inline).joined(separator: " "))</p>"128 default:129 if let next = NextNodes.html(n) { return next }130 if let kids = n.content { return blocks(kids) }131 if let t = n.text, !t.isEmpty { return "<p>\(escape(t))</p>" }132 return ""133 }134 }135136 /// The body markup of a document (what the server's `docToHtml` returns, math aside).137 static func body(_ doc: PMNode) -> String { blocks(doc.content) }138139 static let css = """140 :root{--fg:#111;--muted:#666;--line:#ddd;--sunk:#f5f5f4;--accent:#2563eb}141 *{box-sizing:border-box}html{-webkit-print-color-adjust:exact;print-color-adjust:exact}142 body{margin:0;background:#fff;color:var(--fg);font:15px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Inter,Roboto,Helvetica,Arial,sans-serif}143 main{max-width:760px;margin:0 auto;padding:40px 28px 60px}144 header.doc h1{font-size:30px;line-height:1.2;margin:0 0 6px;letter-spacing:-.01em}145 h1,h2,h3,h4{line-height:1.25;margin:1.5em 0 .5em;page-break-after:avoid}h1{font-size:24px}h2{font-size:20px}h3{font-size:17px}h4{font-size:15px}146 p{margin:.6em 0}a{color:var(--accent);text-decoration:none}.mention{background:var(--sunk);padding:0 4px;border-radius:4px;color:inherit}147 code{font:13px ui-monospace,SFMono-Regular,Menlo,monospace;background:var(--sunk);padding:1px 4px;border-radius:4px}148 pre{background:var(--sunk);border:1px solid var(--line);border-radius:8px;padding:12px 14px;overflow-x:auto;page-break-inside:avoid}pre code{background:none;padding:0}149 blockquote{margin:1em 0;padding:2px 16px;border-left:3px solid var(--line);color:#333}150 table{border-collapse:collapse;width:100%;margin:1em 0;font-size:13.5px;page-break-inside:avoid}th,td{border:1px solid var(--line);padding:6px 9px;vertical-align:top;text-align:left}th{background:var(--sunk)}td p,th p{margin:0}151 ul,ol{padding-left:1.5em}li>p{margin:.2em 0}ul.tasks{list-style:none;padding-left:.2em}ul.tasks li{display:flex;gap:8px;align-items:flex-start}ul.tasks li.done{color:var(--muted);text-decoration:line-through}ul.tasks input{margin-top:6px}152 figure{margin:1.2em 0;text-align:center;page-break-inside:avoid}figure img{max-width:100%;height:auto;border-radius:6px}figcaption{color:var(--muted);font-size:12.5px;margin-top:4px}153 hr{border:0;border-top:1px solid var(--line);margin:2em 0}mark{background:#fef08a}154 .callout{display:flex;gap:10px;padding:12px 14px;border-radius:8px;background:var(--sunk);border:1px solid var(--line);margin:1em 0;page-break-inside:avoid}.callout-warning{background:#fef3c7}.callout-danger{background:#fee2e2}.callout-info{background:#dbeafe}.callout>div>p:first-child{margin-top:0}.callout>div>p:last-child{margin-bottom:0}155 .ai-block{border-left:3px solid #8b5cf6;padding-left:12px;margin:1em 0}.math-block{margin:1em 0;overflow-x:auto;text-align:center}156 .file{background:var(--sunk);border:1px solid var(--line);border-radius:6px;padding:6px 10px}157 details{border:1px solid var(--line);border-radius:6px;padding:6px 12px;margin:1em 0}summary{font-weight:600;cursor:pointer}158 .footnote{font-size:13px;color:#333}159 .nx{margin:1em 0;page-break-inside:avoid}.nx img{max-width:100%;height:auto}.nx-output{border-left:3px solid var(--line)}.nx-error{border-left-color:#dc2626}160 .nx-seg{margin:.25em 0}.nx-seg small{color:var(--muted);font:12px ui-monospace,SFMono-Regular,Menlo,monospace}.nx-pdf ul{margin:.3em 0 0;color:#333;font-size:13.5px}161 span.nx-citation{margin:0;color:var(--muted)}.nx-query,.nx-blockref,.nx-canvas{color:var(--muted)}.nx-chart figcaption{text-align:left;font-weight:600;color:var(--fg);font-size:14px}162 @page{margin:18mm 16mm}163 @media print{main{max-width:none;padding:0}a{color:inherit}}164 """165166 static func page(_ doc: PMNode, title: String) -> String {167 """168 <!doctype html>169 <html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>\(escape(title))</title>170 <style>171 \(css)172 </style></head>173 <body><main><header class="doc"><h1>\(escape(title))</h1></header>174 <article>\(body(doc))</article>175 </main></body></html>176177 """178 }179}180181extension NoteDocument {182 /// The HTML of the note's body alone (no `<html>` wrapper), same markup as `html(title:)`.183 public func htmlBody() -> String { HTMLExport.body(pmNode()) }184}185