docs: generate THIRD_PARTY_NOTICES.md for the shipped components (P2.3)

scripts/generate-third-party-notices.mjs works offline: it lists the npm
packages of the sidecar and web UI closures from package-lock.json, the
Node.js runtime and npm that bundle-node.mjs stages, and the Rust crates of
the desktop shell from `cargo metadata --offline`, and reproduces each
distinct license text once. A section covers the LGPL (libvips,
node-webpmux), MPL (servo crates), OFL (fonts) and unlicensed components
and what their licenses ask.

The Windows and Linux crates are not in the local cargo cache, so this
first file covers the macOS crates and says so; regenerate after
`cargo fetch` before a release.

Log UF-058 (installers ship third-party code without notices) and UF-059
(buffers 0.1.1 has no license) in the upstream fixes.
This commit is contained in:
shumeiko.it
2026-11-01 00:31:26 +01:00
parent 3ebe97e033
commit 8a308aac01
3 changed files with 28949 additions and 0 deletions

28494
THIRD_PARTY_NOTICES.md Normal file

File diff suppressed because it is too large Load Diff

View File

@@ -86,6 +86,8 @@ Baseline: commit `b20b138` of `git.os-dev.tech/oleg.m/waggle-os`.
| UF-055 | Home greets the user by the assistant's name | Fixed | Sidecar, Web UI | | UF-055 | Home greets the user by the assistant's name | Fixed | Sidecar, Web UI |
| UF-056 | Home calls the last 24 hours "While you slept" | Fixed | Web UI | | UF-056 | Home calls the last 24 hours "While you slept" | Fixed | Web UI |
| UF-057 | At phone width the sidebar rail takes a fifth of the screen | Fixed | Web UI | | UF-057 | At phone width the sidebar rail takes a fifth of the screen | Fixed | Web UI |
| UF-058 | Installers ship third-party code without its notices | Open | Licensing, packaging |
| UF-059 | The sidecar ships `buffers` 0.1.1, which has no license | Open | Licensing |
## Entries ## Entries
@@ -575,3 +577,21 @@ Entries UF-010 to UF-019 come from the UI audit `anti-slop/audit-001-2026-10-14.
- Cause: the layout has two states, the icon rail and the full sidebar; nothing replaces the rail on a phone, and the Home heading and padding keep their desktop minimums. - Cause: the layout has two states, the icon rail and the full sidebar; nothing replaces the rail on a phone, and the Home heading and padding keep their desktop minimums.
- What we did: below 640px the rail is hidden and a bottom bar carries the five places plus "More", which opens ⌘K for everything else. Every target is at least 56px tall, the bar respects the safe-area inset, and the canvas stops above it. Home uses 16px side padding and a 28px minimum heading on phones. A test covers the bar. - What we did: below 640px the rail is hidden and a bottom bar carries the five places plus "More", which opens ⌘K for everything else. Every target is at least 56px tall, the bar respects the safe-area inset, and the canvas stops above it. Home uses 16px side padding and a 28px minimum heading on phones. A test covers the bar.
- Recommendation: apply the same change in the main project. - Recommendation: apply the same change in the main project.
### UF-058. Installers ship third-party code without its notices
- Status: Open
- Found: 2026-11-01
- Where: at commit `b20b138`, `app/src-tauri/tauri.conf.json:16` (`bundle.resources`); `scripts/build-sidecar.mjs` (esbuild bundle of `service.js`); the Vite build of `apps/web`; `app/src-tauri/Cargo.toml`
- Symptom: the desktop installers contain no list of the third-party components and no copy of their license texts. `service.js` inlines about 90 npm packages, the web UI bundle inlines about 300, and the Tauri executable links about 330 Rust crates; most of their licenses (MIT, BSD, Apache-2.0) require the notice to travel with the copies. The LGPL-3.0 libvips libraries that sharp loads (`@img/sharp-libvips-*`, the libvips DLLs in `@img/sharp-win32-x64`) carry no license file of their own, so the installers ship them without the LGPL and GPL texts and without a pointer to their source. Only the packages staged whole into `resources/node_modules` keep their own license files.
- Cause: no step of the build collects third-party notices, and transitive licenses were not checked.
- What we did: the OSS edition generates `THIRD_PARTY_NOTICES.md` with `scripts/generate-third-party-notices.mjs` (the sidecar and web UI closures, the Node.js runtime, the Rust crates, the license texts, and a section on the LGPL, MPL and OFL conditions), and CI runs a license gate (`npm run check:licenses`, cargo-deny with `app/src-tauri/deny.toml`). The notices file is not yet copied into the installers.
- Recommendation: generate the notices in the main project too, add the file to `bundle.resources` and link it from the About screen, and keep a CI license check. The licensing review decides how the LGPL source offer is made.
### UF-059. The sidecar ships `buffers` 0.1.1, which has no license
- Status: Open
- Found: 2026-11-01
- Where: at commit `b20b138`, `packages/server/package.json:37` (`exceljs` ^4.4.0); dependency path `exceljs > unzipper@0.10.14 > binary@0.3.0 > buffers@0.1.1`
- Symptom: `buffers` 0.1.1 has no `license` field, no license file and no license statement in its README. Without a license grant the code may not be redistributed, yet `stage-sidecar-deps.mjs` copies it into `resources/node_modules` of every desktop installer.
- Cause: `exceljs` 4.4.0 still depends on `unzipper` 0.10, which pulls in the unmaintained `binary` and `buffers` packages.
- What we did: nothing in the code yet. The OSS license gate lists it as an exception pending the licensing review, so the issue shows on every run.
- Recommendation: remove the dependency, for example with an npm override to a newer `unzipper` release if one no longer depends on `binary` (check that `exceljs` still reads workbooks), or ask the author for a license.

View File

@@ -0,0 +1,435 @@
#!/usr/bin/env node
/**
* Write THIRD_PARTY_NOTICES.md: the third-party components that ship in the
* community edition, their licenses and the license texts they carry.
*
* Offline. npm packages come from package-lock.json (closures in
* scripts/license-inventory.mjs) and their texts from the installed packages;
* Rust crates come from `cargo metadata --offline` and their texts from the
* cargo registry cache. Targets whose crates are not cached are reported in the
* file and on stderr. Platform packages (npm installs them on some of the v1
* platforms only) are listed without their texts, because a machine has only
* its own platform's variants installed; that keeps the output the same on
* every platform.
*
* Usage: node scripts/generate-third-party-notices.mjs
*/
import fs from 'node:fs';
import path from 'node:path';
import {
ROOT,
RUST_TARGETS,
bundledNodeVersion,
manifestLicense,
npmArtifacts,
npmClosure,
readInstalledManifest,
readLicenseFiles,
readLockfilePackages,
rustCrates,
uniqueVersions,
} from './license-inventory.mjs';
import { ALLOWED_LICENSES, EXCEPTIONS, evaluateLicense, findException } from './check-licenses.mjs';
const OUTPUT = path.join(ROOT, 'THIRD_PARTY_NOTICES.md');
const TARGET_LABELS = {
'x86_64-pc-windows-msvc': 'Windows x64',
'aarch64-apple-darwin': 'macOS arm64',
'x86_64-apple-darwin': 'macOS x64',
'x86_64-unknown-linux-gnu': 'Linux x64',
};
// Licenses that impose no conditions beyond keeping the notice. MPL-2.0 is on
// the allowlist but is file-level copyleft, so it is reported with LGPL.
const PERMISSIVE = new Set(ALLOWED_LICENSES.filter((id) => id !== 'MPL-2.0'));
const COPYLEFT_LEAF = /^(?:A?GPL|LGPL|MPL|EPL|EUPL|CDDL|OFL)/;
// ── License texts, deduplicated by content ─────────────────────────────────
const texts = [];
const textIndex = new Map();
function registerTexts(files, owner) {
return files.map(({ file, text }) => {
const key = text.replace(/\s+/g, ' ');
if (!textIndex.has(key)) {
texts.push({ number: texts.length + 1, text, source: `${file} of ${owner}`, users: [] });
textIndex.set(key, texts.length - 1);
}
const entry = texts[textIndex.get(key)];
entry.users.push(owner);
return entry.number;
});
}
function textLinks(numbers) {
return numbers.length > 0 ? numbers.map((n) => `[${n}](#license-text-${n})`).join(', ') : '';
}
function fence(text) {
const longest = Math.max(0, ...[...text.matchAll(/`+/g)].map((match) => match[0].length));
return '`'.repeat(Math.max(3, longest + 1));
}
function cell(value) {
return String(value ?? '').replace(/\|/g, '\\|').replace(/\n/g, ' ');
}
function byNameAndVersion(a, b) {
return a.name.localeCompare(b.name) || a.version.localeCompare(b.version, undefined, { numeric: true });
}
function findText(pattern) {
return texts.find((entry) => pattern.test(entry.text.slice(0, 400)));
}
// ── Classification for the copyleft section ────────────────────────────────
function leafIds(expression) {
return expression.replace(/[()]/g, ' ').split(/\s+/).filter((token) => token && !/^(?:AND|OR|WITH)$/i.test(token));
}
/** Cargo still accepts "MIT/Apache-2.0"; read the slash as OR. */
function normalizeCargoLicense(license) {
return license ? license.replace(/\s*\/\s*/g, ' OR ') : license;
}
function classify(component) {
const declared = component.license;
const result = evaluateLicense(declared, PERMISSIVE);
if (result.status === 'allowed') {
const copyleftOptions = leafIds(declared).filter((id) => COPYLEFT_LEAF.test(id));
return copyleftOptions.length > 0 ? 'dual' : null;
}
if (result.status === 'denied') {
const ids = leafIds(declared);
if (ids.some((id) => /^LGPL/.test(id))) return 'lgpl';
if (ids.some((id) => /^MPL/.test(id))) return 'mpl';
if (ids.some((id) => /^OFL/.test(id))) return 'ofl';
}
const exception = component.ecosystem === 'npm'
? findException({ name: component.name, license: component.lockLicense })
: undefined;
if (exception && !exception.pending) return null;
if (!declared) return 'none';
return 'other';
}
function permissiveChoice(expression) {
const options = expression.replace(/^\((.*)\)$/, '$1').split(/\s+OR\s+/i);
return options.find((option) => evaluateLicense(option, PERMISSIVE).status === 'allowed') ?? '';
}
// ── Inventory ──────────────────────────────────────────────────────────────
const lockPackages = readLockfilePackages();
const artifacts = npmArtifacts().map((artifact) => {
const { packages, unresolved } = npmClosure(lockPackages, artifact);
for (const missing of unresolved) console.warn(`[notices] not in package-lock.json: ${missing}`);
const rows = uniqueVersions(packages.values()).map((pkg) => {
const manifest = pkg.platformSpecific ? null : readInstalledManifest(ROOT, pkg.key);
const license = pkg.license ?? manifestLicense(manifest);
const files = pkg.platformSpecific ? [] : readLicenseFiles(path.join(ROOT, pkg.key));
if (!pkg.platformSpecific && !manifest) {
console.warn(`[notices] ${pkg.name}@${pkg.version} is not installed; run npm ci first`);
}
return {
...pkg,
ecosystem: 'npm',
artifact: artifact.title,
license,
lockLicense: pkg.license,
textNumbers: registerTexts(files, `${pkg.name} ${pkg.version}`),
installed: Boolean(manifest),
};
});
return { ...artifact, rows };
});
const { crates, unresolvedTargets } = rustCrates();
const resolvedTargets = RUST_TARGETS.filter((target) => !unresolvedTargets.some((entry) => entry.target === target));
for (const { target, reason } of unresolvedTargets) {
console.warn(`[notices] Rust target ${target} not resolved offline: ${reason}`);
}
const crateRows = [...crates.values()].sort(byNameAndVersion).map((crate) => ({
...crate,
ecosystem: 'cargo',
artifact: 'Desktop shell',
license: normalizeCargoLicense(crate.license),
declaredLicense: crate.license ?? (crate.licenseFile ? `see ${crate.licenseFile}` : null),
textNumbers: registerTexts(
readLicenseFiles(crate.dir, crate.licenseFile ? [crate.licenseFile] : []),
`${crate.name} ${crate.version}`,
),
}));
// ── Rendering ──────────────────────────────────────────────────────────────
const nodeVersion = bundledNodeVersion();
const out = [];
const line = (text = '') => out.push(text);
function npmSource(row) {
if (row.resolved) return row.resolved;
return row.key.startsWith('node_modules/') || row.key.includes('/node_modules/')
? ''
: `vendored at \`${row.key}\``;
}
function platformLabel(row) {
if (!row.platformSpecific) return 'all';
return [row.os?.join('/'), row.cpu?.join('/')].filter(Boolean).join(' ');
}
line('# Third-party notices');
line();
line('The Waggle community edition is MIT-licensed and ships the third-party components listed');
line('below. Each entry names its license; the license and notice texts the components carry are');
line('reproduced at the end of this file.');
line();
line('Generated by `node scripts/generate-third-party-notices.mjs` from `package-lock.json`, the');
line('installed npm packages and `cargo metadata --offline` for `app/src-tauri`. Do not edit by hand;');
line('regenerate after changing dependencies. `npm run check:licenses` checks the same npm packages');
line('against the license policy, and cargo-deny checks the crates (`app/src-tauri/deny.toml`).');
line();
line('## Contents');
line();
line('- [What ships](#what-ships)');
line('- [LGPL, MPL and other licenses with conditions](#lgpl-mpl-and-other-licenses-with-conditions)');
line('- [Node.js runtime and npm](#nodejs-runtime-and-npm)');
for (const artifact of artifacts) {
const anchor = `${artifact.title} npm packages`.toLowerCase().replace(/[^a-z0-9 -]/g, '').replace(/ /g, '-');
line(`- [${artifact.title} npm packages](#${anchor})`);
}
line('- [Rust crates](#rust-crates)');
line('- [License texts](#license-texts)');
line();
line('## What ships');
line();
line('| Artifact | Contents | Third-party components |');
line('|---|---|---|');
for (const artifact of artifacts) {
line(`| ${artifact.title} | ${artifact.ships} | ${artifact.rows.length} npm packages |`);
}
line(`| Node.js runtime | Node.js ${nodeVersion} and npm, staged by \`scripts/bundle-node.mjs\` for the desktop sidecar | 2 components with their own notices |`);
line(`| Desktop shell | the Tauri executable built from \`app/src-tauri\` | ${crateRows.length} Rust crates |`);
line();
line('The npm lists are the production dependency closures of `packages/server` and `apps/web`');
line('from `package-lock.json`, restricted to the v1 platforms (Windows x64, macOS arm64 and x64,');
line('Linux x64). They include everything the bundlers could pull in, so a few packages that');
line('tree-shaking drops may be listed. The sidecar list leaves out the packages that');
line('`scripts/stage-sidecar-deps.mjs` never ships (its `SKIP` set).');
line();
// Copyleft section
const components = [...artifacts.flatMap((artifact) => artifact.rows), ...crateRows];
const groups = { lgpl: [], mpl: [], ofl: [], none: [], other: [], dual: [] };
for (const component of components) {
const group = classify(component);
if (group) groups[group].push(component);
}
const lgplText = findText(/GNU LESSER GENERAL PUBLIC LICENSE\s+Version 3/);
const gplText = texts.find((entry) => /\bGNU GENERAL PUBLIC LICENSE\s+Version 3, 29 June 2007/.test(entry.text));
const textRef = (entry, name) => (entry ? `[license text ${entry.number}](#license-text-${entry.number})` : `the ${name} text (not found in any shipped package; add it before distribution)`);
function componentTable(rows) {
line('| Component | Version | Artifact | License | Source |');
line('|---|---|---|---|---|');
for (const row of rows) {
const source = row.ecosystem === 'cargo'
? `https://crates.io/crates/${row.name}/${row.version}${row.repository ? ` (repository: ${row.repository})` : ''}`
: npmSource(row);
line(`| ${cell(row.name)} | ${cell(row.version)} | ${row.artifact} | ${cell(row.declaredLicense ?? row.license ?? 'none declared')} | ${cell(source)} |`);
}
line();
}
line('## LGPL, MPL and other licenses with conditions');
line();
line('Most components are under permissive licenses that only ask for their notice to be kept,');
line('which this file does. The components below carry further conditions. The summaries say what');
line('the licenses ask of whoever distributes Waggle; they are engineering notes, not legal advice,');
line('and the licensing review of the project owner (pending decision Q6) decides whether the');
line('measures are sufficient.');
line();
line('### LGPL-3.0');
line();
if (groups.lgpl.length === 0) {
line('No shipped component is under the LGPL.');
line();
} else {
componentTable(groups.lgpl.sort(byNameAndVersion));
line('How they ship: `build-sidecar.mjs` keeps `@huggingface/transformers`, `sharp` and');
line('`whatsapp-web.js` external to `service.js`, and `stage-sidecar-deps.mjs` copies these');
line('packages unmodified into `resources/node_modules` of the desktop app. The libvips packages');
line('(and, on Windows, `@img/sharp-win32-x64`) hold prebuilt shared libraries that sharp loads');
line('at runtime; node-webpmux is a JavaScript package that whatsapp-web.js loads at startup.');
line('None of them is compiled into Waggle code.');
line();
line('What LGPL-3.0 asks when they are distributed with Waggle:');
line();
line('1. Keep each library a separate file that the user can replace with a modified version');
line(' (section 4(d)). The packaged layout above does this; a signed macOS or Windows bundle');
line(' loses its signature when a file inside it is replaced, which the licensing review should');
line(' consider.');
line('2. Say prominently that the library is used and is covered by the LGPL, and ship the');
line(` LGPL-3.0 and GPL-3.0 texts with it (sections 4(a) and 4(b)). LGPL-3.0: ${textRef(lgplText, 'LGPL-3.0')}.`);
line(` GPL-3.0: ${textRef(gplText, 'GPL-3.0')}. The libvips packages contain no license file of their own.`);
line('3. Make the source of the exact library version available, or point to where it is');
line(' published (section 4(d)). The Source column links the npm tarballs; for the libvips');
line(' packages these contain only binaries, and the build scripts and the upstream versions');
line(' (`versions.json` in each package) are in the sharp-libvips repository of the same release.');
line('4. Do not forbid users to modify the combined work or to reverse engineer it to debug such');
line(' modifications (section 4). MIT does not.');
line();
const libvipsDir = ['darwin-arm64', 'darwin-x64', 'linux-x64', 'linuxmusl-x64', 'win32-x64']
.map((suffix) => path.join(ROOT, 'node_modules', '@img', `sharp-libvips-${suffix}`))
.find((dir) => fs.existsSync(path.join(dir, 'README.md')));
if (libvipsDir) {
const readme = fs.readFileSync(path.join(libvipsDir, 'README.md'), 'utf8');
const table = /## Licensing[\s\S]*?(\|[\s\S]*?\n)(?:\n[^|]|$)/.exec(readme);
if (table) {
line('The libvips packages bundle further libraries. Their README lists them as follows (for');
line('cairo under MPL-2.0, see below):');
line();
for (const row of table[1].trim().split('\n')) line(row);
line();
}
}
}
line('### MPL-2.0');
line();
if (groups.mpl.length === 0) {
line('No shipped component is under the MPL alone.');
line();
} else {
componentTable(groups.mpl.sort(byNameAndVersion));
}
const mplText = findText(/Mozilla Public License,? Version 2\.0/);
line(`MPL-2.0 is a per-file copyleft; its text is ${textRef(mplText, 'MPL-2.0')}. What it asks:`);
line();
line('1. MPL-covered files stay under MPL-2.0, and a modified MPL file must be published under');
line(' MPL-2.0. Waggle uses these components unmodified.');
line('2. With the executable, tell recipients where the source of the MPL-covered files is');
line(' available (section 3.2(a)). The Source column links the exact published versions; cairo');
line(' inside libvips is published by the sharp-libvips release named above.');
line('3. Keep the MPL notices intact. The executable may be distributed under other terms (MIT)');
line(' as long as they do not restrict access to that source (section 3.2(b)).');
line();
if (groups.ofl.length > 0) {
line('### OFL-1.1 (fonts)');
line();
componentTable(groups.ofl.sort(byNameAndVersion));
line('The SIL Open Font License allows bundling the fonts with software. The license text and');
line('copyright notice must ship with the fonts (they are reproduced in this file), the fonts');
line('may not be sold on their own, and modified fonts may not use the reserved font names.');
line();
}
if (groups.none.length > 0 || groups.other.length > 0) {
line('### No license or an unrecognised license');
line();
componentTable([...groups.none, ...groups.other].sort(byNameAndVersion));
line('Without a license grant the code cannot be redistributed. These need a decision of the');
line('licensing review or a dependency change before release.');
line();
}
if (groups.dual.length > 0) {
line('### Dual-licensed components used under the permissive option');
line();
line('| Component | Version | Artifact | License | Used under |');
line('|---|---|---|---|---|');
for (const row of groups.dual.sort(byNameAndVersion)) {
line(`| ${cell(row.name)} | ${cell(row.version)} | ${row.artifact} | ${cell(row.declaredLicense ?? row.license)} | ${cell(permissiveChoice(row.license))} |`);
}
line();
}
// Runtime
const lockEntry = (key) => lockPackages[key] ?? {};
const braceExpansion = lockEntry('node_modules/archiver-utils/node_modules/brace-expansion');
const ipAddress = lockEntry('node_modules/ip-address');
line('## Node.js runtime and npm');
line();
line(`The desktop sidecar runs on Node.js ${nodeVersion}, which \`scripts/bundle-node.mjs\` downloads from`);
line('nodejs.org and verifies against the official SHA-256 sums. It is not an npm dependency of');
line('Waggle and is not part of the npm lists below.');
line();
line('| Component | Version | License | Where its notices ship |');
line('|---|---|---|---|');
line(`| Node.js | ${nodeVersion} | MIT, plus the licenses of the libraries Node.js includes (OpenSSL, ICU, libuv, V8 and others) | Node's LICENSE file, which reproduces all of them, as \`resources/node_modules/waggle-node-runtime/NODE-LICENSE\` |`);
line(`| npm | the release bundled with Node.js ${nodeVersion} | Artistic-2.0; its bundled dependencies carry their own licenses | with its LICENSE and its bundled \`node_modules\` in \`resources/node_modules/waggle-node-runtime/node_modules/npm\`; two bundled dependencies are replaced (next row) |`);
line(`| brace-expansion, ip-address | ${braceExpansion.version ?? '?'}, ${ipAddress.version ?? '?'} | ${braceExpansion.license ?? '?'}, ${ipAddress.license ?? '?'} | copied from \`package-lock.json\` over npm's bundled copies by \`bundle-node.mjs\` |`);
line();
// npm tables
for (const artifact of artifacts) {
line(`## ${artifact.title} npm packages`);
line();
line(`${artifact.rows.length} packages from the production dependencies of \`${artifact.workspace}\`; they ship in ${artifact.ships}.`);
line();
line('| Package | Version | License | Platforms | License texts |');
line('|---|---|---|---|---|');
for (const row of artifact.rows) {
let note = textLinks(row.textNumbers);
if (row.platformSpecific) note = 'platform package; ships its own files';
else if (!row.installed) note = 'not installed when generated';
else if (!note) note = 'no license file in the package';
const vendored = npmSource(row).startsWith('vendored') ? ` (${npmSource(row)}, modified)` : '';
line(`| ${cell(row.name)}${vendored} | ${cell(row.version)} | ${cell(row.license ?? 'none declared')} | ${platformLabel(row)} | ${note} |`);
}
line();
}
// Rust
line('## Rust crates');
line();
line(`${crateRows.length} crates that the desktop shell (\`app/src-tauri\`) links, following normal dependencies`);
line('(build and dev dependencies do not ship).');
line();
line(`Resolved offline for: ${resolvedTargets.map((target) => TARGET_LABELS[target]).join(', ') || 'none'}.`);
if (unresolvedTargets.length > 0) {
line();
const labels = unresolvedTargets.map(({ target }) => TARGET_LABELS[target]);
const named = labels.length > 1 ? `${labels.slice(0, -1).join(', ')} and ${labels.at(-1)}` : labels[0];
line(`**Incomplete:** the crates for ${named} were`);
line('not in the local cargo cache when this file was generated, so crates used only on those');
line('platforms are missing below. Fetch them (`cargo fetch --locked --manifest-path');
line('app/src-tauri/Cargo.toml`, which needs network access) and regenerate before a release.');
}
line();
const targetSets = new Set(crateRows.map((row) => [...row.targets].sort().join(',')));
const showTargets = targetSets.size > 1;
line(`| Crate | Version | License |${showTargets ? ' Targets |' : ''} License texts |`);
line(`|---|---|---|${showTargets ? '---|' : ''}---|`);
for (const row of crateRows) {
const targets = showTargets ? ` ${[...row.targets].map((target) => TARGET_LABELS[target]).join(', ')} |` : '';
const note = textLinks(row.textNumbers) || 'no license file in the crate';
line(`| ${cell(row.name)} | ${cell(row.version)} | ${cell(row.declaredLicense ?? 'none declared')} |${targets} ${note} |`);
}
line();
// Texts
line('## License texts');
line();
line('Each text appears once, followed by the components that carry it.');
line();
for (const entry of texts) {
const marker = fence(entry.text);
line(`### License text ${entry.number}`);
line();
line(`From ${entry.source}. Carried by: ${entry.users.join(', ')}.`);
line();
line(`${marker}text`);
line(entry.text);
line(marker);
line();
}
fs.writeFileSync(OUTPUT, `${out.join('\n').trimEnd()}\n`, 'utf8');
const pendingExceptions = EXCEPTIONS.filter((exception) => exception.pending).length;
console.log(
`[notices] Wrote ${path.relative(ROOT, OUTPUT)}: ${artifacts.map((a) => `${a.rows.length} ${a.id}`).join(', ')} npm packages, `
+ `${crateRows.length} crates, ${texts.length} distinct license texts`
+ ` (${pendingExceptions} npm exceptions pending review)`,
);