@ploaness/governance 1.6.0 → 1.8.0

package/dist/compliance-report-html.js

@@ -0,0 +1,365 @@
+// Render the compliance report as one self-contained HTML document: no external asset, so the file is
+// the whole deliverable whether it is opened offline, attached to a message, or printed to PDF.
+import { fontFaces, REPORT_SCRIPT, REPORT_STYLE } from './compliance-report-assets.js';
+import { admonition, CLASS_LABELS, CLASSES, cells, classChip, code, embeddedJson, escapeHtml, facts, formatCount, idList, inventoryCsv, lettered, nowrap, packageLink, percentOf, plural, relationLabel, scopeLabel, severityChip, table, versionLabel, } from './compliance-report-markup.js';
+import { section, sectionReference, subheading, tableOfContents } from './compliance-report-outline.js';
+const SHORT_COMMIT = 12;
+const CHART_LICENSES = 10;
+const shortCommit = (commit) => commit.slice(0, SHORT_COMMIT);
+const draftNotice = (report) => report.draftReasons.length === 0
+    ? ''
+    : admonition('warning', `<p>This report is a draft and must not be treated as release evidence. ${report.draftReasons
+        .map((reason) => escapeHtml(reason))
+        .join(' ')}</p>`);
+const verdictNotice = (report) => {
+    const threshold = escapeHtml(report.vulnerabilities.threshold);
+    return report.isCompliant
+        ? admonition('ok', '<p><strong>Compliant.</strong> Every dependency is licensed within the stated policy, and no known ' +
+            `vulnerability at or above ${threshold} severity stands unresolved.</p>`)
+        : admonition('fail', '<p><strong>Not compliant</strong>. At least one dependency is outside the license policy, or a known ' +
+            `vulnerability at or above ${threshold} severity stands unresolved. The sections below name each one.</p>`);
+};
+const header = () => `<div id="header"><h1>Open Source Software Compliance Report</h1>${tableOfContents()}</div>`;
+const opening = (report) => `<div id="preamble">${draftNotice(report)}${verdictNotice(report)}${facts([
+    ['Project', escapeHtml(report.projectName)],
+    ...(report.projectDescription === undefined
+        ? []
+        : [['Description', escapeHtml(report.projectDescription)]]),
+    ['Source commit', code(report.source.commit)],
+    ['Report generated', escapeHtml(report.generatedAt)],
+    ['Advisory data as of', escapeHtml(report.auditedAt)],
+    ['Package versions', formatCount(report.packages.length)],
+    ['Software bill of materials', `CycloneDX 1.6, ${plural(report.sbom.components, 'component')}`],
+])}</div>`;
+const figure = (value, label, tone) => `<div class="figure ${tone}"><b>${formatCount(value)}</b><span>${escapeHtml(label)}</span></div>`;
+const toneOf = (count, whenPresent) => (count > 0 ? whenPresent : 'good');
+const keyFigures = (report) => {
+    const total = report.packages.length;
+    const open = report.vulnerabilities.unsuppressed.length;
+    const weak = report.classCounts['weak-copyleft'];
+    const refused = report.classCounts.refused;
+    return `<div class="figures">${[
+        figure(total, 'package versions in the resolved set', 'plain'),
+        figure(report.productionCount, 'in the production dependency graph', 'plain'),
+        figure(total - report.productionCount, 'used only for development and build', 'plain'),
+        figure(weak, 'under a weak copyleft license', toneOf(weak, 'warn')),
+        figure(refused, 'licenses outside the policy', toneOf(refused, 'bad')),
+        figure(open, `open vulnerabilities at or above ${report.vulnerabilities.threshold}`, toneOf(open, 'bad')),
+    ].join('')}</div>`;
+};
+const classStack = (report) => {
+    const total = report.packages.length;
+    const share = (licenseClass) => percentOf(report.classCounts[licenseClass], total);
+    const description = CLASSES.map((licenseClass) => `${CLASS_LABELS[licenseClass]} ${share(licenseClass)} percent`).join(', ');
+    return (`<div class="stack" role="img" aria-label="${description}">${CLASSES.map((licenseClass) => `<i class="seg-${licenseClass}" style="width:${share(licenseClass)}%"></i>`).join('')}</div>` +
+        `<ul class="legend">${CLASSES.map((licenseClass) => `<li class="key-${licenseClass}">${CLASS_LABELS[licenseClass]}: ` +
+            `${formatCount(report.classCounts[licenseClass])} (${share(licenseClass)}%)</li>`).join('')}</ul>`);
+};
+const bar = (label, count, largest, tone) => `<span class="label">${escapeHtml(label)}</span><span class="track"><span class="fill fill-${tone}" ` +
+    `style="width:${percentOf(count, largest)}%"></span></span><span class="count">${formatCount(count)}</span>`;
+const licenseBars = (report) => {
+    const shown = report.licenseCounts.slice(0, CHART_LICENSES);
+    const rest = report.licenseCounts.slice(CHART_LICENSES);
+    const largest = shown[0]?.count ?? 0;
+    const restCount = rest.reduce((sum, entry) => sum + entry.count, 0);
+    return `<div class="bars">${[
+        ...shown.map((entry) => bar(entry.license, entry.count, largest, entry.licenseClass)),
+        ...(rest.length > 0 ? [bar(plural(rest.length, 'other license'), restCount, largest, 'other')] : []),
+    ].join('')}</div>`;
+};
+const severityRow = (counts) => `<ul class="severities">${counts
+    .map((entry) => `<li>${severityChip(entry.severity)} ${formatCount(entry.count)}</li>`)
+    .join('')}</ul>`;
+const statement = (outcome, text) => `<li class="${outcome}">${text}</li>`;
+const verdictOf = (isPassing) => (isPassing ? 'pass' : 'fail');
+const licenseFinding = (report) => statement(verdictOf(report.classCounts.refused === 0), report.classCounts.refused === 0
+    ? `All ${plural(report.packages.length, 'package version')} declare a license the policy admits.`
+    : `${plural(report.classCounts.refused, 'package version')} declare a license outside the policy.`);
+const vulnerabilityFindings = (report) => {
+    const open = report.vulnerabilities.unsuppressed.length;
+    const threshold = escapeHtml(report.vulnerabilities.threshold);
+    const excused = report.vulnerabilities.suppressed.length;
+    const stale = report.vulnerabilities.deadEntries.length;
+    const excusedVerb = excused === 1 ? 'is' : 'are';
+    return [
+        statement(verdictOf(open === 0), open === 0
+            ? `No known vulnerability at or above ${threshold} severity stands unresolved across ` +
+                `${plural(report.advisoryRecords, 'advisory record')}.`
+            : `${plural(open, 'known vulnerability', 'known vulnerabilities')} at or above ${threshold} severity ` +
+                'stand unresolved.'),
+        statement(verdictOf(stale === 0), stale === 0
+            ? `${plural(excused, 'advisory', 'advisories')} at or above the threshold ${excusedVerb} excused by a ` +
+                'recorded, justified and dated exception.'
+            : `${plural(stale, 'recorded exception')} no longer match any finding.`),
+    ];
+};
+const noticeFinding = (report) => statement('info', `${plural(report.notices.length, 'distinct license text')} reproduced for the production dependencies.` +
+    (report.withoutNotice.length === 0
+        ? ''
+        : ` ${plural(report.withoutNotice.length, 'production package version')} ship no license file and are ` +
+            `attributed by their declared license in ${sectionReference('inventory')}.`));
+const findings = (report) => `<ul class="statements">${[
+    licenseFinding(report),
+    statement('info', `${plural(report.classCounts['weak-copyleft'], 'package version')} carry a weak copyleft license. Each is ` +
+        `listed with its scope in ${sectionReference('copyleft')}.`),
+    ...vulnerabilityFindings(report),
+    noticeFinding(report),
+].join('')}</ul>`;
+const summary = (report) => section('summary', lettered([
+    'This section states what the report establishes, in one view.',
+    'Every figure is computed from the installed dependency tree of the source commit named above, with the ' +
+        'same data the project build uses to pass or fail.',
+]) +
+    subheading('key-figures') +
+    keyFigures(report) +
+    subheading('license-classes') +
+    classStack(report) +
+    subheading('common-licenses') +
+    licenseBars(report) +
+    subheading('severities') +
+    severityRow(report.severityCounts) +
+    subheading('findings') +
+    findings(report));
+const policy = (report) => section('policy', lettered([
+    'This section states the policy the build enforces, rendered from the same definition the license check reads.',
+    'A license is identified by its Software Package Data Exchange (SPDX) identifier.',
+    'In a compound expression, an OR is satisfied by any admitted alternative, because the recipient may choose ' +
+        'it, and an AND requires every part.',
+]) +
+    subheading('policy-permissive') +
+    lettered([
+        `The policy admits ${plural(report.policy.permissive.length, 'license')} with no copyleft obligation.`,
+        `Attribution, where the license requires it, is satisfied by ${sectionReference('notices')}.`,
+    ]) +
+    idList(report.policy.permissive) +
+    subheading('policy-weak-copyleft') +
+    lettered([
+        `The policy admits ${plural(report.policy.weakCopyleft.length, 'license')} only for dependencies used ` +
+            'unmodified.',
+        'File-level copyleft, as in the Mozilla, Eclipse, and Common Development and Distribution licenses, ' +
+            'doesn&#39;t extend to the project&#39;s own source when the component is used as published.',
+        'Neither does library-level copyleft, as in the GNU Lesser General Public License.',
+    ]) +
+    idList(report.policy.weakCopyleft) +
+    subheading('policy-outside') +
+    lettered([
+        'Every other license is outside the policy, including strong copyleft such as the GNU General ' +
+            'Public License and the GNU Affero General Public License, licenses that restrict the field of use, and ' +
+            'any package whose license can&#39;t be resolved.',
+        'A single such package fails the build.',
+    ]));
+const REVIEW_HEADINGS = ['Package', 'Version', 'License', 'Scope', 'Relation'];
+const reviewRow = (row) => {
+    const version = nowrap(escapeHtml(versionLabel(row)));
+    return cells([
+        packageLink(row),
+        `<span class="mono">${version}</span>`,
+        code(row.license),
+        nowrap(scopeLabel(row)),
+        nowrap(relationLabel(row)),
+    ]);
+};
+const copyleft = (report) => section('copyleft', lettered([
+    'This section lists every package version whose license carries any copyleft condition.',
+    'The policy admits weak copyleft only for components used unmodified.',
+    'Production components are part of the distributed application. Development components are build, test and ' +
+        'analysis tools that aren&#39;t distributed with it.',
+]) +
+    subheading('review-weak-copyleft') +
+    table(REVIEW_HEADINGS, report.copyleft.map((row) => reviewRow(row)), 'No dependency carries a weak copyleft license.') +
+    subheading('review-outside') +
+    table(REVIEW_HEADINGS, report.refused.map((row) => reviewRow(row)), 'No dependency declares a license outside the policy.'));
+const advisoryLink = (advisory) => advisory.url?.startsWith('https://') === true
+    ? `<a href="${escapeHtml(advisory.url)}" rel="noreferrer noopener">${nowrap(code(advisory.id))}</a>`
+    : nowrap(code(advisory.id));
+const aliasLine = (advisory) => advisory.aliases.length > 0 ? `<br><span class="mono">${escapeHtml(advisory.aliases.join(', '))}</span>` : '';
+const advisoryCells = (advisory) => [
+    severityChip(advisory.severity),
+    `${advisoryLink(advisory)}${aliasLine(advisory)}<br>${escapeHtml(advisory.title)}`,
+    escapeHtml(advisory.packageName),
+];
+const ADVISORY_HEADINGS = ['Severity', 'Advisory', 'Package'];
+const excusedRow = (entry) => cells([
+    ...advisoryCells(entry.advisory),
+    escapeHtml(entry.exception.reason) +
+        (entry.isHarnessException ? '<br><span class="empty">Recorded by the build harness.</span>' : ''),
+    `<span class="mono">${nowrap(escapeHtml(entry.exception.addedOn))}</span>`,
+]);
+const listItem = (text) => `<li>${escapeHtml(text)}</li>`;
+const staleExceptions = (entries) => entries.length > 0
+    ? `<ul>${entries.map((entry) => listItem(entry)).join('')}</ul>`
+    : '<p class="empty">Every recorded exception still matches a finding.</p>';
+const vulnerabilityIntroduction = (report) => lettered([
+    'Every package in the resolved set, development tools included, was checked against the npm registry ' +
+        'advisory service, which publishes the GitHub Advisory Database.',
+    `The query ran at ${escapeHtml(report.auditedAt)} and returned ` +
+        `${plural(report.advisoryRecords, 'advisory record')}.`,
+    `The build fails on any advisory at or above <strong>${escapeHtml(report.vulnerabilities.threshold)}</strong> ` +
+        'severity unless a recorded exception explains why the project can&#39;t reach it.',
+    'Unlike the rest of this report, this section reflects the database at the time of the query and can change ' +
+        'for the same source.',
+]);
+const vulnerabilities = (report) => {
+    const { threshold, unsuppressed, suppressed, belowThreshold, deadEntries } = report.vulnerabilities;
+    return section('vulnerabilities', vulnerabilityIntroduction(report) +
+        subheading('advisories-open') +
+        table(ADVISORY_HEADINGS, unsuppressed.map((advisory) => cells(advisoryCells(advisory))), `No advisory at or above ${threshold} severity stands unresolved.`) +
+        subheading('advisories-excused') +
+        table([...ADVISORY_HEADINGS, "Why it isn't reachable", 'Recorded'], suppressed.map((entry) => excusedRow(entry)), 'No exception is in use.') +
+        subheading('advisories-stale') +
+        staleExceptions(deadEntries) +
+        subheading('advisories-below') +
+        table(ADVISORY_HEADINGS, belowThreshold.map((advisory) => cells(advisoryCells(advisory))), 'No advisory below the threshold was reported.'));
+};
+const inventoryRow = (row) => `<tr data-scope="${row.isProduction ? 'production' : 'development'}" data-class="${row.licenseClass}">` +
+    `<td>${packageLink(row)}</td><td class="mono nowrap">${escapeHtml(versionLabel(row))}</td>` +
+    `<td>${code(row.license)}</td><td>${classChip(row.licenseClass)}</td>` +
+    `<td class="nowrap">${scopeLabel(row)}</td><td class="nowrap">${relationLabel(row)}</td></tr>`;
+const classOption = (licenseClass) => `<option value="${licenseClass}">${CLASS_LABELS[licenseClass]}</option>`;
+const inventoryControls = (fileStem) => '<div class="downloads">' +
+    `<button type="button" data-download="sbom" data-file="${escapeHtml(fileStem)}.cdx.json" hidden>` +
+    'Download SBOM (CycloneDX JSON)</button>' +
+    `<button type="button" data-download="csv" data-file="${escapeHtml(fileStem)}.csv" hidden>` +
+    'Download inventory (CSV)</button></div>' +
+    '<div class="controls">' +
+    '<input id="filter-text" type="search" placeholder="Filter by package or license" ' +
+    'aria-label="Filter by package or license">' +
+    '<select id="filter-scope" aria-label="Scope"><option value="">All scopes</option>' +
+    '<option value="production">Production</option><option value="development">Development</option></select>' +
+    '<select id="filter-class" aria-label="License class"><option value="">All license classes</option>' +
+    CLASSES.map((licenseClass) => classOption(licenseClass)).join('') +
+    '</select><output id="filter-count" aria-live="polite"></output></div>';
+const INVENTORY_HEADINGS = ['Package', 'Version', 'License', 'Class', 'Scope', 'Relation'];
+const inventory = (report, fileStem) => section('inventory', lettered([
+    `This section lists every installed package version, ${plural(report.packages.length, 'row')}, with the ` +
+        'license its installed manifest declares.',
+    'Scope is production when the version is reachable from a production dependency of any workspace package, ' +
+        'and development otherwise.',
+    'Relation is direct when a workspace manifest declares the package by name.',
+]) +
+    inventoryControls(fileStem) +
+    '<div class="table-wrap"><table class="tableblock" id="inventory-table"><thead><tr>' +
+    INVENTORY_HEADINGS.map((heading) => `<th scope="col" data-sort>${heading}</th>`).join('') +
+    `</tr></thead><tbody>${report.packages.map((row) => inventoryRow(row)).join('')}` +
+    '</tbody></table></div>');
+const LICENSE_HEADING = /^#{1,6}[ \t]+/u;
+const LICENSE_RULE = /^[-=_*~]{3,}$/u;
+// A web or e-mail address cannot break between words, and a copyright statement is a short line of names,
+// so justifying either opens wide gaps. Such a paragraph is set flush left instead.
+const FLUSH_LEFT = /\b(?:https?:\/\/|www\.)\S{20}|<[^<>\s]{1,80}@[^<>\s]{1,80}>|^(?:\(c\)|copyright\b|\u{A9})/iu;
+// A licence block is plain lines, except that a bundle of licences titles each one with a Markdown heading
+// and separates them with a ruled line. Those two are drawn as what they are, not printed as characters.
+const licenseLine = (line) => {
+    if (LICENSE_RULE.test(line)) {
+        return '<hr>';
+    }
+    return LICENSE_HEADING.test(line)
+        ? `<p class="license-heading">${escapeHtml(line.replace(LICENSE_HEADING, ''))}</p>`
+        : `<p>${escapeHtml(line)}</p>`;
+};
+const licenseBlock = (block) => {
+    const lines = block.split('\n');
+    const isStructured = lines.some((line) => LICENSE_RULE.test(line) || LICENSE_HEADING.test(line));
+    const alignment = FLUSH_LEFT.test(block) ? ' class="ragged"' : '';
+    return isStructured
+        ? `<div class="license-entry">${lines.map((line) => licenseLine(line)).join('')}</div>`
+        : `<p${alignment}>${lines.map((line) => escapeHtml(line)).join('<br>')}</p>`;
+};
+// The package is what a reader looks for, so it heads the entry. The file names follow, with the number of
+// package versions that share the text when there is more than one.
+const noticeSource = (group) => escapeHtml(group.fileNames.join(', ')) +
+    (group.coordinates.length > 1 ? `, shared by ${plural(group.coordinates.length, 'package version')}` : '');
+const noticeGroup = (group, index) => `<div class="notice" id="notice-${String(index + 1)}">` +
+    `<p class="title">${escapeHtml(group.coordinates.join(', '))}</p>` +
+    `<p class="notice-packages">${noticeSource(group)}</p>` +
+    `<div class="license-text">${group.text
+        .split('\n\n')
+        .map((block) => licenseBlock(block))
+        .join('')}</div></div>`;
+const missingNotices = (report) => report.withoutNotice.length > 0
+    ? lettered([
+        'These production package versions ship no license file.',
+        `Their declared license is listed in ${sectionReference('inventory')}, and no text is invented for them.`,
+    ]) + idList(report.withoutNotice)
+    : '<p class="empty">Every production package version ships a license file.</p>';
+const notices = (report) => section('notices', lettered([
+    'This section reproduces the license and notice files shipped by each production dependency, from the ' +
+        'installed package.',
+    'The words are unchanged. Only the fixed-width line breaks and the Markdown markers of the original files ' +
+        'are removed so the text reads as paragraphs.',
+    'Identical texts are printed once with every package version that ships them.',
+    'Development dependencies aren&#39;t distributed with the application, so this section doesn&#39;t ' +
+        'reproduce them.',
+]) +
+    subheading('notices-missing') +
+    missingNotices(report) +
+    subheading('notices-texts') +
+    (report.notices.length > 0
+        ? report.notices.map((group, index) => noticeGroup(group, index)).join('')
+        : '<p class="empty">No production dependency ships a license file.</p>'));
+// A digest is read as one value, so it is set in the code face without a chip, which would split in two
+// where the value wraps.
+const digest = (value) => `<span class="digest">${escapeHtml(value)}</span>`;
+const provenance = (report) => section('provenance', lettered([
+    'This report is generated by the build, not written by hand.',
+    'It reads the same installed dependency tree, license policy and advisory data that the license and ' +
+        'vulnerability checks of the build use to pass or fail, so the report and the verdict can&#39;t disagree.',
+    'Anyone with the repository can regenerate it from the commit below.',
+]) +
+    subheading('provenance-source') +
+    facts([
+        ['Source commit', code(report.source.commit)],
+        ['Uncommitted changes', report.source.isDirty ? 'Present, so this report is a draft' : 'None'],
+        ['Source fingerprint (SHA-256)', digest(report.source.fingerprint)],
+        ['Lockfile (SHA-256)', digest(report.source.lockfileSha256)],
+        ['SBOM (SHA-256)', digest(report.sbom.sha256)],
+        ['SBOM generator', digest(report.sbom.generator)],
+        ['Report date', escapeHtml(report.generatedAt)],
+        ['Regenerate', code('pnpm exec ploaness compliance-report')],
+    ]) +
+    subheading('provenance-scope') +
+    lettered([
+        'The report covers every package the pnpm workspace resolves, for every workspace package, including ' +
+            'development and build tools.',
+        'A license is the one the installed package manifest declares.',
+        'The embedded SBOM lists the same resolved set with its dependency graph.',
+    ]));
+const body = (report, fileStem) => [
+    opening(report),
+    summary(report),
+    policy(report),
+    copyleft(report),
+    vulnerabilities(report),
+    inventory(report, fileStem),
+    notices(report),
+    provenance(report),
+];
+/**
+ * Render the compliance report as one self-contained HTML document.
+ * @param report the assembled report.
+ * @param attachments the exact bytes the report carries, and the typefaces it is set in.
+ * @param fileStem the file name, without extension, downloads are offered under.
+ * @returns the complete document.
+ */
+export const renderComplianceReport = (report, attachments, fileStem) => [
+    '<!doctype html>',
+    '<html lang="en">',
+    '<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">',
+    `<title>Open source compliance report - ${escapeHtml(report.projectName)}</title>`,
+    `<style>${fontFaces(attachments.fonts)}${REPORT_STYLE}</style></head>`,
+    '<body class="article toc2 toc-left">',
+    header(),
+    '<div id="content">',
+    ...body(report, fileStem),
+    '</div>',
+    `<div id="footer">Report for ${escapeHtml(report.projectName)} at commit ` +
+        `${code(shortCommit(report.source.commit))}, ${escapeHtml(report.generatedAt)}.</div>`,
+    `<script type="application/json" id="report-data">${embeddedJson({
+        sbom: attachments.sbom,
+        csv: inventoryCsv(report.packages),
+    })}</script>`,
+    `<script>${REPORT_SCRIPT}</script>`,
+    '</body></html>',
+    '',
+].join('\n');
+//# sourceMappingURL=compliance-report-html.js.map

package/dist/compliance-report-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compliance-report-html.js","sourceRoot":"","sources":["../src/compliance-report-html.ts"],"names":[],"mappings":"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"}

package/dist/compliance-report-markup.d.ts

@@ -0,0 +1,62 @@
+import type { ReportPackage } from './compliance-report.js';
+import type { LicenseClass } from './license-allowlist.js';
+/**
+ * Escape text for an HTML text node or a quoted attribute.
+ * @param text untrusted text, such as a package name or a licence file.
+ * @returns the text with every markup character replaced by its entity.
+ */
+export declare const escapeHtml: (text: string) => string;
+/** The label each licence class is printed with. */
+export declare const CLASS_LABELS: Readonly<Record<LicenseClass, string>>;
+/** Every licence class, from the least to the most restrictive. */
+export declare const CLASSES: readonly LicenseClass[];
+export declare const scopeLabel: (row: ReportPackage) => string;
+export declare const relationLabel: (row: ReportPackage) => string;
+export declare const versionLabel: (row: ReportPackage) => string;
+export declare const percentOf: (count: number, total: number) => string;
+export declare const formatCount: (count: number) => string;
+export declare const plural: (count: number, singular: string, several?: string) => string;
+export declare const classChip: (licenseClass: LicenseClass) => string;
+export declare const severityChip: (severity: string) => string;
+export declare const nowrap: (html: string) => string;
+export declare const code: (text: string) => string;
+export declare const cells: (values: readonly string[]) => string;
+/**
+ * A ruled table, or a sentence saying it would be empty.
+ * @param headings the column headings.
+ * @param rows the rendered rows.
+ * @param empty what to say when there are no rows.
+ * @returns the table markup.
+ */
+export declare const table: (headings: readonly string[], rows: readonly string[], empty: string) => string;
+/**
+ * A two-column table of labelled facts.
+ * @param rows each label with its already rendered value.
+ * @returns the table markup.
+ */
+export declare const facts: (rows: readonly (readonly [string, string])[]) => string;
+export declare const packageLink: (row: ReportPackage) => string;
+export declare const idList: (ids: readonly string[]) => string;
+/**
+ * Statements set as a lettered list, the way every statement of the report is addressed.
+ * @param items each statement, already rendered.
+ * @returns the list markup.
+ */
+export declare const lettered: (items: readonly string[]) => string;
+/** The icon an admonition carries. */
+export type AdmonitionKind = 'warning' | 'ok' | 'fail';
+/**
+ * A notice set apart from the text by an icon and a rule, where a reader looks first.
+ * @param kind the icon.
+ * @param html the notice, already rendered.
+ * @returns the admonition markup.
+ */
+export declare const admonition: (kind: AdmonitionKind, html: string) => string;
+export declare const embeddedJson: (value: unknown) => string;
+/**
+ * The package inventory as CSV, one row per installed package version.
+ * @param packages the report's packages.
+ * @returns the CSV text with a header row.
+ */
+export declare const inventoryCsv: (packages: readonly ReportPackage[]) => string;
+//# sourceMappingURL=compliance-report-markup.d.ts.map

package/dist/compliance-report-markup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compliance-report-markup.d.ts","sourceRoot":"","sources":["../src/compliance-report-markup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAU1D;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,MACyD,CAAA;AAEnG,oDAAoD;AACpD,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAI/D,CAAA;AAED,mEAAmE;AACnE,eAAO,MAAM,OAAO,EAAE,SAAS,YAAY,EAA+C,CAAA;AAE1F,eAAO,MAAM,UAAU,GAAI,KAAK,aAAa,KAAG,MAA2D,CAAA;AAC3G,eAAO,MAAM,aAAa,GAAI,KAAK,aAAa,KAAG,MAAkD,CAAA;AACrG,eAAO,MAAM,YAAY,GAAI,KAAK,aAAa,KAAG,MAAoE,CAAA;AAItH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,MACG,CAAA;AAE5D,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAAuC,CAAA;AAEnF,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,EAAE,UAAU,MAAM,EAAE,UAAS,MAAuB,KAAG,MAC9B,CAAA;AAE7D,eAAO,MAAM,SAAS,GAAI,cAAc,YAAY,KAAG,MACyB,CAAA;AAEhF,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,KAAG,MAG/C,CAAA;AAED,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,MAA+C,CAAA;AAErF,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAA4C,CAAA;AAIhF,eAAO,MAAM,KAAK,GAAI,QAAQ,SAAS,MAAM,EAAE,KAAG,MACyB,CAAA;AAE3E;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,UAAU,SAAS,MAAM,EAAE,EAAE,MAAM,SAAS,MAAM,EAAE,EAAE,OAAO,MAAM,KAAG,MAKf,CAAA;AAE7E;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,KAAG,MAKhC,CAAA;AAIrC,eAAO,MAAM,WAAW,GAAI,KAAK,aAAa,KAAG,MAGvB,CAAA;AAI1B,eAAO,MAAM,MAAM,GAAI,KAAK,SAAS,MAAM,EAAE,KAAG,MACgC,CAAA;AAIhF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,SAAS,MAAM,EAAE,KAAG,MAG1B,CAAA;AAE1B,sCAAsC;AACtC,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAA;AAWtD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,cAAc,EAAE,MAAM,MAAM,KAAG,MAGmC,CAAA;AAInG,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAAmE,CAAA;AAWjH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,SAAS,aAAa,EAAE,KAAG,MAe/C,CAAA"}

package/dist/compliance-report-markup.js

@@ -0,0 +1,118 @@
+const HTML_ESCAPES = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+};
+/**
+ * Escape text for an HTML text node or a quoted attribute.
+ * @param text untrusted text, such as a package name or a licence file.
+ * @returns the text with every markup character replaced by its entity.
+ */
+export const escapeHtml = (text) => text.replaceAll(/[&<>"']/gu, (character) => HTML_ESCAPES[character] ?? character);
+/** The label each licence class is printed with. */
+export const CLASS_LABELS = {
+    permissive: 'Permissive',
+    'weak-copyleft': 'Weak copyleft',
+    refused: 'Outside policy',
+};
+/** Every licence class, from the least to the most restrictive. */
+export const CLASSES = ['permissive', 'weak-copyleft', 'refused'];
+export const scopeLabel = (row) => (row.isProduction ? 'Production' : 'Development');
+export const relationLabel = (row) => (row.isDirect ? 'Direct' : 'Transitive');
+export const versionLabel = (row) => (row.version.length > 0 ? row.version : 'local directory');
+const PERCENT = 100;
+export const percentOf = (count, total) => total === 0 ? '0' : ((count / total) * PERCENT).toFixed(1);
+export const formatCount = (count) => count.toLocaleString('en-US');
+export const plural = (count, singular, several = `${singular}s`) => `${formatCount(count)} ${count === 1 ? singular : several}`;
+export const classChip = (licenseClass) => `<span class="chip chip-${licenseClass}">${CLASS_LABELS[licenseClass]}</span>`;
+export const severityChip = (severity) => {
+    const escaped = escapeHtml(severity.toLowerCase());
+    return `<span class="sev sev-${escaped}">${escaped}</span>`;
+};
+export const nowrap = (html) => `<span class="nowrap">${html}</span>`;
+export const code = (text) => `<code>${escapeHtml(text)}</code>`;
+const cell = (value) => `<td>${value}</td>`;
+export const cells = (values) => `<tr>${values.map((value) => cell(value)).join('')}</tr>`;
+/**
+ * A ruled table, or a sentence saying it would be empty.
+ * @param headings the column headings.
+ * @param rows the rendered rows.
+ * @param empty what to say when there are no rows.
+ * @returns the table markup.
+ */
+export const table = (headings, rows, empty) => rows.length === 0
+    ? `<p class="empty">${escapeHtml(empty)}</p>`
+    : `<div class="table-wrap"><table class="tableblock"><thead><tr>${headings
+        .map((heading) => `<th scope="col">${escapeHtml(heading)}</th>`)
+        .join('')}</tr></thead><tbody>${rows.join('')}</tbody></table></div>`;
+/**
+ * A two-column table of labelled facts.
+ * @param rows each label with its already rendered value.
+ * @returns the table markup.
+ */
+export const facts = (rows) => `<div class="table-wrap"><table class="tableblock facts"><tbody>${rows
+    .map(([label, value]) => `<tr><td>${escapeHtml(label)}</td><td>${value}</td></tr>`)
+    .join('')}</tbody></table></div>`;
+const WEB_LINK = /^https?:\/\//u;
+export const packageLink = (row) => row.homepage !== undefined && WEB_LINK.test(row.homepage)
+    ? `<a href="${escapeHtml(row.homepage)}" rel="noreferrer noopener">${escapeHtml(row.name)}</a>`
+    : escapeHtml(row.name);
+const idItem = (id) => `<li>${code(id)}</li>`;
+export const idList = (ids) => `<ul class="ids">${ids.map((id) => idItem(id)).join('')}</ul>`;
+const letteredItem = (html) => `<li><p>${html}</p></li>`;
+/**
+ * Statements set as a lettered list, the way every statement of the report is addressed.
+ * @param items each statement, already rendered.
+ * @returns the list markup.
+ */
+export const lettered = (items) => `<div class="olist upperalpha"><ol class="upperalpha" type="A">${items
+    .map((item) => letteredItem(item))
+    .join('')}</ol></div>`;
+const ICON_PATHS = {
+    warning: 'M12 2.5 1.5 21h21L12 2.5Zm-1.1 6.5h2.2l-.35 6.6h-1.5L10.9 9Zm1.1 10a1.3 1.3 0 1 1 0-2.6 1.3 1.3 0 0 1 0 2.6Z',
+    ok: 'M12 1.5a10.5 10.5 0 1 0 0 21 10.5 10.5 0 0 0 0-21Zm-1.6 15.2-4.7-4.7 1.6-1.6 3.1 3.1 6.3-6.3 1.6 1.6-7.9 7.9Z',
+    fail: 'M12 1.5a10.5 10.5 0 1 0 0 21 10.5 10.5 0 0 0 0-21Zm-1.1 5h2.2l-.35 7.6h-1.5L10.9 6.5Zm1.1 11.6a1.3 1.3 0 1 1 ' +
+        '0-2.6 1.3 1.3 0 0 1 0 2.6Z',
+};
+/**
+ * A notice set apart from the text by an icon and a rule, where a reader looks first.
+ * @param kind the icon.
+ * @param html the notice, already rendered.
+ * @returns the admonition markup.
+ */
+export const admonition = (kind, html) => `<div class="admonitionblock ${kind}"><table><tbody><tr><td class="icon">` +
+    `<svg class="icon-${kind}" viewBox="0 0 24 24" aria-hidden="true"><path fill="currentColor" ` +
+    `d="${ICON_PATHS[kind]}"/></svg></td><td class="content">${html}</td></tr></tbody></table></div>`;
+// Embedded data is JSON inside a script element; escaping `<` keeps a `</script>` in a licence file or a
+// package name from ending the element early.
+export const embeddedJson = (value) => JSON.stringify(value).replaceAll('<', String.raw `\u003c`);
+const CSV_FORMULA_START = /^[=+\-@\t\r]/u;
+// Every field is quoted, and a field a spreadsheet would read as a formula is prefixed with an apostrophe:
+// a package name is registry input, and a CSV opened in a spreadsheet is a place it could execute.
+const csvField = (value) => {
+    const safe = CSV_FORMULA_START.test(value) ? `'${value}` : value;
+    return `"${safe.replaceAll('"', '""')}"`;
+};
+/**
+ * The package inventory as CSV, one row per installed package version.
+ * @param packages the report's packages.
+ * @returns the CSV text with a header row.
+ */
+export const inventoryCsv = (packages) => [
+    ['package', 'version', 'license', 'license class', 'scope', 'relation', 'homepage'],
+    ...packages.map((row) => [
+        row.name,
+        row.version,
+        row.license,
+        CLASS_LABELS[row.licenseClass],
+        scopeLabel(row),
+        relationLabel(row),
+        row.homepage ?? '',
+    ]),
+]
+    .map((fields) => fields.map((field) => csvField(field)).join(','))
+    .join('\r\n')
+    .concat('\r\n');
+//# sourceMappingURL=compliance-report-markup.js.map

package/dist/compliance-report-markup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compliance-report-markup.js","sourceRoot":"","sources":["../src/compliance-report-markup.ts"],"names":[],"mappings":"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"}

package/dist/compliance-report-outline.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A numbered subsection heading.
+ * @param id the outline entry.
+ * @returns the heading element.
+ */
+export declare const subheading: (id: string) => string;
+/**
+ * A numbered top-level section.
+ * @param id the outline section.
+ * @param body the section's markup after its heading.
+ * @returns the section element.
+ */
+export declare const section: (id: string, body: string) => string;
+/**
+ * The table of contents, read from the same outline as the headings.
+ * @returns the contents navigation.
+ */
+export declare const tableOfContents: () => string;
+/**
+ * The cross-reference text for a section, such as "section 3".
+ * @param id the outline entry.
+ * @returns the reference text.
+ */
+export declare const sectionReference: (id: string) => string;
+/**
+ * The page of every outline entry, from the bookmarks of a printed report. A bookmark is titled with the
+ * heading's text, which starts with the entry's number, so the number is what is matched.
+ * @param bookmarks the page by bookmark title, as read from the PDF.
+ * @returns the page number by outline id, for every entry found.
+ */
+export declare const contentsPages: (bookmarks: ReadonlyMap<string, number>) => ReadonlyMap<string, number>;
+//# sourceMappingURL=compliance-report-outline.d.ts.map