SPB Git

Repository Public

HTMLExport.swift 10.9 KB 185 lines swift

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 += "&amp;"16            case "<": out += "&lt;"17            case ">": out += "&gt;"18            case "\"": out += "&quot;"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
Files main
Menu

Theme