${o.body}
`
}
/**
* Section marks.
*
* A document of twelve sections is navigated by flicking through it, and
* a shape is found faster than a word is read. Drawn in the title's own
* grey at a single stroke weight so they mark the section without
* competing with the states, which are the only colour that carries
* meaning here.
*/
const ICON_PATHS: Record = {
summary: '',
node: '',
cluster: '',
architecture: '',
disks: '',
network: '',
storage: '',
guests: '',
passthrough: '',
software: '',
findings: '',
scope: '',
memory: '',
controller: '',
adapter: '',
bridge: '',
observation: '',
latency: '',
}
/** An inline mark, sized to sit on the line of the text it precedes. */
export function icon(name: keyof typeof ICON_PATHS | string, size = 16,
color = "#64748b"): string {
const path = ICON_PATHS[name]
if (!path) return ""
return ``
}
export function section(index: number, title: string, body: string,
mark?: string): string {
return `
${mark ? icon(mark) : ""}${index}. ${esc(title)}
${body}
`
}
/** A heading inside a section, carrying its own mark. */
export function heading(title: string, mark?: string, note?: string): string {
return `
`
}
export function table(headers: string[], rows: string[][]): string {
// No headers means the first column labels the second: a record read
// down rather than across.
const head = headers.length
? `
${headers.map((h) => `
${esc(h)}
`).join("")}
`
: ""
return `
${head}
${rows.map((r) => `
${r.map((c) => `
${c}
`).join("")}
`).join("")}
`
}
/**
* Opens the report window on the click itself, before any data is
* fetched, so the popup blocker sees the user gesture. The spinner is
* what the reader looks at while the document is composed.
*/
export function openReportWindow(loadingText: string): Window | null {
const w = window.open("about:blank", "_blank")
if (w) {
w.document.write(`
${esc(loadingText)}
`)
}
return w
}
/**
* Hands the composed document to the window that was opened on the click.
*
* The window is *navigated* to the document rather than written into.
* Writing into an about:blank window leaves it, as far as the browser is
* concerned, still on about:blank — no navigation happened — and an
* installed web app then shows none of its own chrome, so on a phone the
* report opens with no way back to the page that launched it. Navigating
* to a blob URL is a real navigation, and the app supplies its close and
* back controls exactly as it does for the other reports.
*/
export function writeReport(target: Window | null, html: string): void {
const url = URL.createObjectURL(new Blob([html], { type: "text/html" }))
if (target && !target.closed) {
target.location.href = url
return
}
// The window was blocked or the reader closed it while the document
// was being composed.
window.open(url, "_blank")
}