tonnage 0.1.2 → 0.2.0

package/dist/{run-CZ_FO4C7.mjs → report-B3HrJ4UQ.mjs}

@@ -1,30 +1,10 @@
 import fs from "node:fs/promises";
 import path from "node:path";
+import { renderMarkdown } from "galley.md";
 import { gzipSync } from "node:zlib";
 import { build } from "esbuild";
 import os from "node:os";
-//#region src/readme.ts
-function tonnageMarkers(marker = `default`) {
-	validateMarker(marker);
-	return {
-		end: `<!-- tonnage:${marker}:end -->`,
-		start: `<!-- tonnage:${marker}:start -->`
-	};
-}
-function updateGeneratedSection(readme, markdown, marker) {
-	const { end, start } = tonnageMarkers(marker);
-	const startIndex = readme.indexOf(start);
-	const endIndex = readme.indexOf(end);
-	if (startIndex === -1 || endIndex === -1) throw new Error(`README must contain exactly one ${start} and one ${end} marker.`);
-	if (readme.slice(startIndex + start.length).includes(start) || readme.slice(endIndex + end.length).includes(end)) throw new Error(`README must contain exactly one ${start} and one ${end} marker.`);
-	if (endIndex < startIndex) throw new Error(`${end} must appear after ${start}.`);
-	const contentStart = startIndex + start.length;
-	return `${readme.slice(0, contentStart)}\n\n${markdown.trim()}\n\n${readme.slice(endIndex)}`;
-}
-function validateMarker(marker) {
-	if (!/^[a-z0-9][a-z0-9._-]*$/i.test(marker)) throw new Error(`Tonnage marker names may contain letters, numbers, dots, underscores, and hyphens.`);
-}
-//#endregion
+import { jsx } from "galley.md/jsx-runtime";
 //#region src/measure.ts
 async function measureEntry(entry, options) {
 	return measureEntryWithPlugins(entry, options);
@@ -107,6 +87,80 @@ function escapeRegExp(value) {
 	return value.replace(/[.*+?^${}()|[\]\\]/g, `\\$&`);
 }
 //#endregion
+//#region src/report-content.ts
+/** Use Galley's JSX runtime directly so the source CLI stays executable by Node. */
+function reportContent(report, config = {}) {
+	const hasExports = report.exports.length > 0;
+	const hasRecipes = report.recipes.length > 0;
+	const hasMultipleSections = hasExports && hasRecipes;
+	const content = [jsx("h2", { children: config.heading ?? "Bundle size" })];
+	if (hasExports) content.push(jsx("p", { children: "Package export sizes include complete runtime export surfaces." }));
+	if (hasRecipes) content.push(jsx("p", { children: "Usage example sizes bundle their entry files and tree-shake unused exports." }));
+	content.push(jsx("p", { children: "Sizes are exact minified and level-9 gzip JavaScript byte counts. Declarations, source maps, CSS, and other assets are excluded. Peer dependencies stay external, and shared modules are counted once per bundle." }));
+	if (hasExports) {
+		if (hasMultipleSections) content.push(jsx("h3", { children: "Package exports" }));
+		content.push(table([
+			{ title: "Import" },
+			{
+				title: "Minified JS",
+				align: "right"
+			},
+			{
+				title: "Gzip JS",
+				align: "right"
+			}
+		], report.exports.map((row) => [
+			code(row.name),
+			formatBytes(row.rawBytes),
+			formatBytes(row.gzipBytes)
+		])));
+	}
+	if (hasRecipes) {
+		if (hasMultipleSections) content.push(jsx("h3", { children: "Usage examples" }));
+		content.push(table([
+			{ title: "Recipe" },
+			{ title: "Entry" },
+			{
+				title: "Minified JS",
+				align: "right"
+			},
+			{
+				title: "Gzip JS",
+				align: "right"
+			}
+		], report.recipes.map((row) => [
+			row.name,
+			code(row.entry),
+			formatBytes(row.rawBytes),
+			formatBytes(row.gzipBytes)
+		])));
+	}
+	content.push(jsx("p", { children: [
+		"Report maintained with ",
+		jsx("a", {
+			href: "https://github.com/jeremybanka/tonnage",
+			children: "tonnage"
+		}),
+		"."
+	] }));
+	return content;
+}
+function code(value) {
+	return {
+		type: "inlineCode",
+		value
+	};
+}
+function formatBytes(bytes) {
+	return `${new Intl.NumberFormat("en-US").format(bytes)} B`;
+}
+function table(columns, rows) {
+	return jsx("table", { children: [jsx("thead", { children: jsx("tr", { children: columns.map(({ title, align }) => jsx("th", {
+		children: title,
+		align
+	})) }) }), jsx("tbody", { children: rows.map((cells) => jsx("tr", { children: cells.map((children) => jsx("td", { children })) })) })] });
+}
+//#endregion
 //#region src/report.ts
 async function createTonnageReport(config, configDirectory) {
 	const packageJsonPath = path.resolve(configDirectory, config.packageJson ?? `package.json`);
@@ -147,56 +201,13 @@ async function createTonnageReport(config, configDirectory) {
 		recipes: recipeRows
 	};
 }
-function renderTonnageMarkdown(report, config = {}) {
-	const hasExports = report.exports.length > 0;
-	const hasRecipes = report.recipes.length > 0;
-	const hasMultipleSections = hasExports && hasRecipes;
-	const lines = [
-		`## ${config.heading ?? `Bundle size`}`,
-		``,
-		...methodologyLines({
-			hasExports,
-			hasRecipes
-		})
-	];
-	if (hasExports) lines.push(``, ...hasMultipleSections ? [`### Package exports`, ``] : [], ...markdownTable([
-		`Import`,
-		`Minified JS`,
-		`Gzip JS`
-	], report.exports.map((row) => [
-		code(row.name),
-		formatBytes(row.rawBytes),
-		formatBytes(row.gzipBytes)
-	]), [
-		`left`,
-		`right`,
-		`right`
-	]));
-	if (hasRecipes) lines.push(``, ...hasMultipleSections ? [`### Usage examples`, ``] : [], ...markdownTable([
-		`Recipe`,
-		`Entry`,
-		`Minified JS`,
-		`Gzip JS`
-	], report.recipes.map((row) => [
-		escapeCell(row.name),
-		code(row.entry),
-		formatBytes(row.rawBytes),
-		formatBytes(row.gzipBytes)
-	]), [
-		`left`,
-		`left`,
-		`right`,
-		`right`
-	]));
-	lines.push(``, `Report maintained with [tonnage](https://github.com/jeremybanka/tonnage).`);
-	return lines.join(`\n`);
-}
-function methodologyLines({ hasExports, hasRecipes }) {
-	const lines = [];
-	if (hasExports) lines.push(`Package export sizes include complete runtime export surfaces.`);
-	if (hasRecipes) lines.push(`Usage example sizes bundle their entry files and tree-shake unused exports.`);
-	lines.push(`Sizes are exact minified and level-9 gzip JavaScript byte counts. Declarations, source maps, CSS, and other assets are excluded. Peer dependencies stay external, and shared modules are counted once per bundle.`);
-	return lines;
+/** Serialize a report with the same Galley elements used by the document component. */
+async function renderTonnageMarkdown(report, config = {}) {
+	const directory = process.cwd();
+	return renderMarkdown(reportContent(report, config), {
+		directory,
+		path: path.resolve(directory, config.readme ?? "README.md")
+	});
 }
 function selectExportImports(packageName, exportsValue, selection) {
 	if (selection === false) return [];
@@ -217,48 +228,10 @@ function toPackageImport(packageName, exportKey) {
 	if (!exportKey.startsWith(`./`)) throw new Error(`Invalid package export key: ${exportKey}`);
 	return `${packageName}/${exportKey.slice(2)}`;
 }
-function formatBytes(bytes) {
-	return `${new Intl.NumberFormat(`en-US`).format(bytes)} B`;
-}
-function code(value) {
-	return `<code>${escapeCell(value)}</code>`;
-}
-function escapeCell(value) {
-	return value.replaceAll(`&`, `&amp;`).replaceAll(`|`, `&#124;`);
-}
 function unique(values) {
 	return [...new Set(values)];
 }
-function markdownTable(headings, rows, alignments) {
-	const widths = headings.map((heading, column) => Math.max(heading.length, ...rows.map((row) => row[column]?.length ?? 0), 3));
-	const renderRow = (cells) => `| ${cells.map((cell, column) => padCell(cell, widths[column] ?? 3, alignments[column] ?? `left`)).join(` | `)} |`;
-	const separator = widths.map((width, column) => alignments[column] === `right` ? `${`-`.repeat(width - 1)}:` : `-`.repeat(width));
-	return [
-		renderRow(headings),
-		renderRow(separator),
-		...rows.map(renderRow)
-	];
-}
-function padCell(cell, width, alignment) {
-	return alignment === `right` ? cell.padStart(width) : cell.padEnd(width);
-}
-//#endregion
-//#region src/run.ts
-async function runTonnage(config, options) {
-	const configDirectory = path.resolve(options.configDirectory ?? process.cwd());
-	const readmePath = path.resolve(configDirectory, config.readme ?? `README.md`);
-	const oldReadme = await fs.readFile(readmePath, `utf8`);
-	const report = await createTonnageReport(config, configDirectory);
-	const newReadme = updateGeneratedSection(oldReadme, renderTonnageMarkdown(report, config), config.marker);
-	const changed = oldReadme !== newReadme;
-	if (options.mode === `write` && changed) await fs.writeFile(readmePath, newReadme);
-	return {
-		changed,
-		readmePath,
-		report
-	};
-}
 //#endregion
-export { measureImports as a, measureEntry as i, createTonnageReport as n, tonnageMarkers as o, renderTonnageMarkdown as r, updateGeneratedSection as s, runTonnage as t };
+export { measureImports as a, measureEntry as i, renderTonnageMarkdown as n, reportContent as r, createTonnageReport as t };
 
-//# sourceMappingURL=run-CZ_FO4C7.mjs.map
+//# sourceMappingURL=report-B3HrJ4UQ.mjs.map

package/dist/report-B3HrJ4UQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-B3HrJ4UQ.mjs","names":[],"sources":["../src/measure.ts","../src/package-resolution.ts","../src/report-content.ts","../src/report.ts"],"sourcesContent":["import path from \"node:path\"\nimport { gzipSync } from \"node:zlib\"\n\nimport { build, type BuildOptions, type Plugin } from \"esbuild\"\n\nimport type { BundleMeasurement, BundlePlatform } from \"./types.ts\"\n\nexport type MeasureImportsOptions = {\n\texternal?: readonly string[] | undefined\n\tplatform?: BundlePlatform | undefined\n\tresolveDirectory: string\n\ttarget?: string | undefined\n}\n\nexport type MeasureEntryOptions = MeasureImportsOptions\n\ntype InternalMeasureOptions = MeasureImportsOptions & {\n\tplugins?: readonly Plugin[]\n}\n\nexport async function measureEntry(\n\tentry: string,\n\toptions: MeasureEntryOptions,\n): Promise<BundleMeasurement> {\n\treturn measureEntryWithPlugins(entry, options)\n}\n\nexport async function measureEntryWithPlugins(\n\tentry: string,\n\toptions: InternalMeasureOptions,\n): Promise<BundleMeasurement> {\n\treturn measureBuild(\n\t\t{ entryPoints: [path.resolve(options.resolveDirectory, entry)] },\n\t\toptions,\n\t)\n}\n\nexport async function measureImports(\n\timports: readonly string[],\n\toptions: MeasureImportsOptions,\n): Promise<BundleMeasurement> {\n\treturn measureImportsWithPlugins(imports, options)\n}\n\nexport async function measureImportsWithPlugins(\n\timports: readonly string[],\n\toptions: InternalMeasureOptions,\n): Promise<BundleMeasurement> {\n\tif (imports.length === 0) {\n\t\tthrow new Error(`A tonnage entry must import at least one module.`)\n\t}\n\n\tconst entry = imports\n\t\t.map(\n\t\t\t(specifier, index) =>\n\t\t\t\t`export * as entry${index} from ${JSON.stringify(specifier)}`,\n\t\t)\n\t\t.join(`\\n`)\n\treturn measureBuild(\n\t\t{\n\t\t\tstdin: {\n\t\t\t\tcontents: entry,\n\t\t\t\tloader: `js`,\n\t\t\t\tresolveDir: options.resolveDirectory,\n\t\t\t\tsourcefile: `tonnage-entry.js`,\n\t\t\t},\n\t\t},\n\t\toptions,\n\t)\n}\n\nasync function measureBuild(\n\tentry: Pick<BuildOptions, `entryPoints` | `stdin`>,\n\toptions: InternalMeasureOptions,\n): Promise<BundleMeasurement> {\n\tconst platform = options.platform ?? `neutral`\n\n\tconst result = await build({\n\t\tbundle: true,\n\t\tcharset: `utf8`,\n\t\texternal: [\n\t\t\t...(options.external ?? []),\n\t\t\t...(platform === `browser` ? [] : [`node:*`]),\n\t\t],\n\t\tformat: `esm`,\n\t\tlegalComments: `none`,\n\t\tlogLevel: `silent`,\n\t\t...(platform === `neutral` ? { mainFields: [`module`, `main`] } : {}),\n\t\tminify: true,\n\t\toutdir: `out`,\n\t\tplatform,\n\t\tplugins: [...(options.plugins ?? [])],\n\t\t...entry,\n\t\ttarget: options.target ?? `es2022`,\n\t\ttreeShaking: true,\n\t\twrite: false,\n\t})\n\n\tconst outputFiles = [...(result.outputFiles ?? [])]\n\t\t.filter((output) => output.path.endsWith(`.js`))\n\t\t.sort((left, right) => left.path.localeCompare(right.path))\n\tif (outputFiles.length === 0) {\n\t\tthrow new Error(`The tonnage entry did not emit any runtime JavaScript.`)\n\t}\n\tconst rawBytes = outputFiles.reduce(\n\t\t(total, output) => total + output.contents.byteLength,\n\t\t0,\n\t)\n\tconst gzipBytes = outputFiles.reduce(\n\t\t(total, output) =>\n\t\t\ttotal + gzipSync(output.contents, { level: 9 }).byteLength,\n\t\t0,\n\t)\n\n\treturn { gzipBytes, rawBytes }\n}\n","import fs from \"node:fs/promises\"\nimport os from \"node:os\"\nimport path from \"node:path\"\n\nimport type { Plugin } from \"esbuild\"\n\nexport async function withPackageResolver<Result>(\n\tpackageName: string,\n\tpackageDirectory: string,\n\tuseResolver: (plugin: Plugin) => Promise<Result>,\n): Promise<Result> {\n\tconst temporaryDirectory = await fs.mkdtemp(\n\t\tpath.join(os.tmpdir(), `tonnage-package-`),\n\t)\n\ttry {\n\t\tconst nodeModulesDirectory = path.join(temporaryDirectory, `node_modules`)\n\t\tconst packageLinkPath = path.resolve(nodeModulesDirectory, packageName)\n\t\tif (!packageLinkPath.startsWith(`${nodeModulesDirectory}${path.sep}`)) {\n\t\t\tthrow new Error(`Invalid package name: ${packageName}`)\n\t\t}\n\n\t\tawait fs.mkdir(path.dirname(packageLinkPath), { recursive: true })\n\t\tawait fs.symlink(\n\t\t\tpackageDirectory,\n\t\t\tpackageLinkPath,\n\t\t\tprocess.platform === `win32` ? `junction` : `dir`,\n\t\t)\n\n\t\tconst filter = new RegExp(`^${escapeRegExp(packageName)}(?:/.*)?$`)\n\t\tconst plugin: Plugin = {\n\t\t\tname: `tonnage-package-resolution`,\n\t\t\tsetup(build) {\n\t\t\t\tbuild.onResolve({ filter }, async (args) => {\n\t\t\t\t\tif (args.resolveDir === temporaryDirectory) {\n\t\t\t\t\t\treturn\n\t\t\t\t\t}\n\n\t\t\t\t\treturn build.resolve(args.path, {\n\t\t\t\t\t\timporter: args.importer,\n\t\t\t\t\t\tkind: args.kind,\n\t\t\t\t\t\tnamespace: args.namespace,\n\t\t\t\t\t\tresolveDir: temporaryDirectory,\n\t\t\t\t\t\twith: args.with,\n\t\t\t\t\t})\n\t\t\t\t})\n\t\t\t},\n\t\t}\n\n\t\treturn await useResolver(plugin)\n\t} finally {\n\t\tawait fs.rm(temporaryDirectory, { force: true, recursive: true })\n\t}\n}\n\nfunction escapeRegExp(value: string): string {\n\treturn value.replace(/[.*+?^${}()|[\\]\\\\]/g, `\\\\$&`)\n}\n","import type { Content, Element } from \"galley.md\"\nimport { jsx } from \"galley.md/jsx-runtime\"\n\nimport type { TonnageConfig, TonnageReport } from \"./types.ts\"\n\n/** Use Galley's JSX runtime directly so the source CLI stays executable by Node. */\nexport function reportContent(\n\treport: TonnageReport,\n\tconfig: TonnageConfig = {},\n): Element[] {\n\tconst hasExports = report.exports.length > 0\n\tconst hasRecipes = report.recipes.length > 0\n\tconst hasMultipleSections = hasExports && hasRecipes\n\tconst content = [jsx(\"h2\", { children: config.heading ?? \"Bundle size\" })]\n\n\tif (hasExports)\n\t\tcontent.push(\n\t\t\tjsx(\"p\", {\n\t\t\t\tchildren:\n\t\t\t\t\t\"Package export sizes include complete runtime export surfaces.\",\n\t\t\t}),\n\t\t)\n\tif (hasRecipes)\n\t\tcontent.push(\n\t\t\tjsx(\"p\", {\n\t\t\t\tchildren:\n\t\t\t\t\t\"Usage example sizes bundle their entry files and tree-shake unused exports.\",\n\t\t\t}),\n\t\t)\n\tcontent.push(\n\t\tjsx(\"p\", {\n\t\t\tchildren:\n\t\t\t\t\"Sizes are exact minified and level-9 gzip JavaScript byte counts. Declarations, source maps, CSS, and other assets are excluded. Peer dependencies stay external, and shared modules are counted once per bundle.\",\n\t\t}),\n\t)\n\n\tif (hasExports) {\n\t\tif (hasMultipleSections)\n\t\t\tcontent.push(jsx(\"h3\", { children: \"Package exports\" }))\n\t\tcontent.push(\n\t\t\ttable(\n\t\t\t\t[\n\t\t\t\t\t{ title: \"Import\" },\n\t\t\t\t\t{ title: \"Minified JS\", align: \"right\" },\n\t\t\t\t\t{ title: \"Gzip JS\", align: \"right\" },\n\t\t\t\t],\n\t\t\t\treport.exports.map((row) => [\n\t\t\t\t\tcode(row.name),\n\t\t\t\t\tformatBytes(row.rawBytes),\n\t\t\t\t\tformatBytes(row.gzipBytes),\n\t\t\t\t]),\n\t\t\t),\n\t\t)\n\t}\n\n\tif (hasRecipes) {\n\t\tif (hasMultipleSections)\n\t\t\tcontent.push(jsx(\"h3\", { children: \"Usage examples\" }))\n\t\tcontent.push(\n\t\t\ttable(\n\t\t\t\t[\n\t\t\t\t\t{ title: \"Recipe\" },\n\t\t\t\t\t{ title: \"Entry\" },\n\t\t\t\t\t{ title: \"Minified JS\", align: \"right\" },\n\t\t\t\t\t{ title: \"Gzip JS\", align: \"right\" },\n\t\t\t\t],\n\t\t\t\treport.recipes.map((row) => [\n\t\t\t\t\trow.name,\n\t\t\t\t\tcode(row.entry),\n\t\t\t\t\tformatBytes(row.rawBytes),\n\t\t\t\t\tformatBytes(row.gzipBytes),\n\t\t\t\t]),\n\t\t\t),\n\t\t)\n\t}\n\n\tcontent.push(\n\t\tjsx(\"p\", {\n\t\t\tchildren: [\n\t\t\t\t\"Report maintained with \",\n\t\t\t\tjsx(\"a\", {\n\t\t\t\t\thref: \"https://github.com/jeremybanka/tonnage\",\n\t\t\t\t\tchildren: \"tonnage\",\n\t\t\t\t}),\n\t\t\t\t\".\",\n\t\t\t],\n\t\t}),\n\t)\n\treturn content\n}\n\nfunction code(value: string): Content {\n\treturn { type: \"inlineCode\", value }\n}\n\nfunction formatBytes(bytes: number): string {\n\treturn `${new Intl.NumberFormat(\"en-US\").format(bytes)} B`\n}\n\nfunction table(\n\tcolumns: readonly { title: string; align?: \"right\" }[],\n\trows: readonly (readonly Content[])[],\n): Element {\n\treturn jsx(\"table\", {\n\t\tchildren: [\n\t\t\tjsx(\"thead\", {\n\t\t\t\tchildren: jsx(\"tr\", {\n\t\t\t\t\tchildren: columns.map(({ title, align }) =>\n\t\t\t\t\t\tjsx(\"th\", { children: title, align }),\n\t\t\t\t\t),\n\t\t\t\t}),\n\t\t\t}),\n\t\t\tjsx(\"tbody\", {\n\t\t\t\tchildren: rows.map((cells) =>\n\t\t\t\t\tjsx(\"tr\", {\n\t\t\t\t\t\tchildren: cells.map((children) => jsx(\"td\", { children })),\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\t}),\n\t\t],\n\t})\n}\n","import fs from \"node:fs/promises\"\nimport path from \"node:path\"\n\nimport { renderMarkdown } from \"galley.md\"\n\nimport {\n\tmeasureEntryWithPlugins,\n\tmeasureImportsWithPlugins,\n} from \"./measure.ts\"\nimport { withPackageResolver } from \"./package-resolution.ts\"\nimport { reportContent } from \"./report-content.ts\"\nimport type {\n\tTonnageConfig,\n\tTonnageExports,\n\tTonnageReport,\n\tTonnageRow,\n} from \"./types.ts\"\n\ntype PackageJson = {\n\texports?: unknown\n\tname?: string\n\tpeerDependencies?: Record<string, string>\n}\n\nexport async function createTonnageReport(\n\tconfig: TonnageConfig,\n\tconfigDirectory: string,\n): Promise<TonnageReport> {\n\tconst packageJsonPath = path.resolve(\n\t\tconfigDirectory,\n\t\tconfig.packageJson ?? `package.json`,\n\t)\n\tconst packageJson = JSON.parse(\n\t\tawait fs.readFile(packageJsonPath, `utf8`),\n\t) as PackageJson\n\tif (!packageJson.name) {\n\t\tthrow new Error(`${packageJsonPath} does not declare a package name.`)\n\t}\n\n\tconst resolveDirectory = path.dirname(packageJsonPath)\n\tconst peerDependencies = Object.keys(packageJson.peerDependencies ?? {})\n\tconst external = unique([...peerDependencies, ...(config.external ?? [])])\n\tconst exportImports = selectExportImports(\n\t\tpackageJson.name,\n\t\tpackageJson.exports,\n\t\tconfig.exports,\n\t)\n\n\tconst { exportRows, recipeRows } = await withPackageResolver(\n\t\tpackageJson.name,\n\t\tresolveDirectory,\n\t\tasync (packageResolver) => {\n\t\t\tconst exportRows = await Promise.all(\n\t\t\t\texportImports.map(async (specifier): Promise<TonnageRow> => ({\n\t\t\t\t\t...(await measureImportsWithPlugins([specifier], {\n\t\t\t\t\t\texternal,\n\t\t\t\t\t\tplatform: config.platform,\n\t\t\t\t\t\tplugins: [packageResolver],\n\t\t\t\t\t\tresolveDirectory,\n\t\t\t\t\t\ttarget: config.target,\n\t\t\t\t\t})),\n\t\t\t\t\timports: [specifier],\n\t\t\t\t\tname: specifier,\n\t\t\t\t})),\n\t\t\t)\n\t\t\tconst recipeRows = await Promise.all(\n\t\t\t\t(config.recipes ?? []).map(async (recipe) => ({\n\t\t\t\t\t...(await measureEntryWithPlugins(recipe.entry, {\n\t\t\t\t\t\texternal: unique([...external, ...(recipe.external ?? [])]),\n\t\t\t\t\t\tplatform: recipe.platform ?? config.platform,\n\t\t\t\t\t\tplugins: [packageResolver],\n\t\t\t\t\t\tresolveDirectory,\n\t\t\t\t\t\ttarget: config.target,\n\t\t\t\t\t})),\n\t\t\t\t\tentry: recipe.entry,\n\t\t\t\t\tname: recipe.name,\n\t\t\t\t})),\n\t\t\t)\n\n\t\t\treturn { exportRows, recipeRows }\n\t\t},\n\t)\n\n\treturn {\n\t\texports: exportRows,\n\t\tpackageName: packageJson.name,\n\t\trecipes: recipeRows,\n\t}\n}\n\n/** Serialize a report with the same Galley elements used by the document component. */\nexport async function renderTonnageMarkdown(\n\treport: TonnageReport,\n\tconfig: TonnageConfig = {},\n): Promise<string> {\n\tconst directory = process.cwd()\n\treturn renderMarkdown(reportContent(report, config), {\n\t\tdirectory,\n\t\tpath: path.resolve(directory, config.readme ?? \"README.md\"),\n\t})\n}\n\nfunction selectExportImports(\n\tpackageName: string,\n\texportsValue: unknown,\n\tselection: TonnageConfig[`exports`],\n): string[] {\n\tif (selection === false) {\n\t\treturn []\n\t}\n\n\tconst exportKeys = getExportKeys(exportsValue)\n\tconst options: TonnageExports = typeof selection === `object` ? selection : {}\n\tconst included = options.include\n\t\t? [...options.include]\n\t\t: exportKeys.filter((exportKey) => exportKey !== `./package.json`)\n\tconst excluded = new Set(options.exclude ?? [])\n\n\treturn included\n\t\t.filter((exportKey) => !excluded.has(exportKey))\n\t\t.map((exportKey) => toPackageImport(packageName, exportKey))\n}\n\nfunction getExportKeys(exportsValue: unknown): string[] {\n\tif (typeof exportsValue === `string` || Array.isArray(exportsValue)) {\n\t\treturn [`.`]\n\t}\n\tif (!exportsValue || typeof exportsValue !== `object`) {\n\t\treturn [`.`]\n\t}\n\n\tconst keys = Object.keys(exportsValue)\n\treturn keys.some((key) => key.startsWith(`.`)) ? keys : [`.`]\n}\n\nfunction toPackageImport(packageName: string, exportKey: string): string {\n\tif (exportKey === `.`) {\n\t\treturn packageName\n\t}\n\tif (!exportKey.startsWith(`./`)) {\n\t\tthrow new Error(`Invalid package export key: ${exportKey}`)\n\t}\n\treturn `${packageName}/${exportKey.slice(2)}`\n}\n\nfunction unique(values: readonly string[]): string[] {\n\treturn [...new Set(values)]\n}\n"],"mappings":"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"}

package/dist/run-BJN1MXRf.mjs

@@ -0,0 +1,44 @@
+import { n as renderTonnageMarkdown, t as createTonnageReport } from "./report-B3HrJ4UQ.mjs";
+import fs from "node:fs/promises";
+import path from "node:path";
+//#region src/readme.ts
+function tonnageMarkers(marker = `default`) {
+	validateMarker(marker);
+	return {
+		end: `<!-- tonnage:${marker}:end -->`,
+		start: `<!-- tonnage:${marker}:start -->`
+	};
+}
+function updateGeneratedSection(readme, markdown, marker) {
+	const { end, start } = tonnageMarkers(marker);
+	const startIndex = readme.indexOf(start);
+	const endIndex = readme.indexOf(end);
+	if (startIndex === -1 || endIndex === -1) throw new Error(`README must contain exactly one ${start} and one ${end} marker.`);
+	if (readme.slice(startIndex + start.length).includes(start) || readme.slice(endIndex + end.length).includes(end)) throw new Error(`README must contain exactly one ${start} and one ${end} marker.`);
+	if (endIndex < startIndex) throw new Error(`${end} must appear after ${start}.`);
+	const contentStart = startIndex + start.length;
+	return `${readme.slice(0, contentStart)}\n\n${markdown.trim()}\n\n${readme.slice(endIndex)}`;
+}
+function validateMarker(marker) {
+	if (!/^[a-z0-9][a-z0-9._-]*$/i.test(marker)) throw new Error(`Tonnage marker names may contain letters, numbers, dots, underscores, and hyphens.`);
+}
+//#endregion
+//#region src/run.ts
+async function runTonnage(config, options) {
+	const configDirectory = path.resolve(options.configDirectory ?? process.cwd());
+	const readmePath = path.resolve(configDirectory, config.readme ?? `README.md`);
+	const oldReadme = await fs.readFile(readmePath, `utf8`);
+	const report = await createTonnageReport(config, configDirectory);
+	const newReadme = updateGeneratedSection(oldReadme, await renderTonnageMarkdown(report, config), config.marker);
+	const changed = oldReadme !== newReadme;
+	if (options.mode === `write` && changed) await fs.writeFile(readmePath, newReadme);
+	return {
+		changed,
+		readmePath,
+		report
+	};
+}
+//#endregion
+export { tonnageMarkers as n, updateGeneratedSection as r, runTonnage as t };
+
+//# sourceMappingURL=run-BJN1MXRf.mjs.map

package/dist/run-BJN1MXRf.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-BJN1MXRf.mjs","names":[],"sources":["../src/readme.ts","../src/run.ts"],"sourcesContent":["export function tonnageMarkers(marker = `default`): {\n\tend: string\n\tstart: string\n} {\n\tvalidateMarker(marker)\n\treturn {\n\t\tend: `<!-- tonnage:${marker}:end -->`,\n\t\tstart: `<!-- tonnage:${marker}:start -->`,\n\t}\n}\n\nexport function updateGeneratedSection(\n\treadme: string,\n\tmarkdown: string,\n\tmarker?: string,\n): string {\n\tconst { end, start } = tonnageMarkers(marker)\n\tconst startIndex = readme.indexOf(start)\n\tconst endIndex = readme.indexOf(end)\n\n\tif (startIndex === -1 || endIndex === -1) {\n\t\tthrow new Error(\n\t\t\t`README must contain exactly one ${start} and one ${end} marker.`,\n\t\t)\n\t}\n\tif (\n\t\treadme.slice(startIndex + start.length).includes(start) ||\n\t\treadme.slice(endIndex + end.length).includes(end)\n\t) {\n\t\tthrow new Error(\n\t\t\t`README must contain exactly one ${start} and one ${end} marker.`,\n\t\t)\n\t}\n\tif (endIndex < startIndex) {\n\t\tthrow new Error(`${end} must appear after ${start}.`)\n\t}\n\n\tconst contentStart = startIndex + start.length\n\treturn `${readme.slice(0, contentStart)}\\n\\n${markdown.trim()}\\n\\n${readme.slice(endIndex)}`\n}\n\nfunction validateMarker(marker: string): void {\n\tif (!/^[a-z0-9][a-z0-9._-]*$/i.test(marker)) {\n\t\tthrow new Error(\n\t\t\t`Tonnage marker names may contain letters, numbers, dots, underscores, and hyphens.`,\n\t\t)\n\t}\n}\n","import fs from \"node:fs/promises\"\nimport path from \"node:path\"\n\nimport { updateGeneratedSection } from \"./readme.ts\"\nimport { createTonnageReport, renderTonnageMarkdown } from \"./report.ts\"\nimport type { TonnageConfig, TonnageMode, TonnageRunResult } from \"./types.ts\"\n\nexport async function runTonnage(\n\tconfig: TonnageConfig,\n\toptions: {\n\t\tconfigDirectory?: string\n\t\tmode: TonnageMode\n\t},\n): Promise<TonnageRunResult> {\n\tconst configDirectory = path.resolve(options.configDirectory ?? process.cwd())\n\tconst readmePath = path.resolve(configDirectory, config.readme ?? `README.md`)\n\tconst oldReadme = await fs.readFile(readmePath, `utf8`)\n\tconst report = await createTonnageReport(config, configDirectory)\n\tconst markdown = await renderTonnageMarkdown(report, config)\n\tconst newReadme = updateGeneratedSection(oldReadme, markdown, config.marker)\n\tconst changed = oldReadme !== newReadme\n\n\tif (options.mode === `write` && changed) {\n\t\tawait fs.writeFile(readmePath, newReadme)\n\t}\n\n\treturn { changed, readmePath, report }\n}\n"],"mappings":";;;;AAAA,SAAgB,eAAe,SAAS,WAGtC;CACD,eAAe,MAAM;CACrB,OAAO;EACN,KAAK,gBAAgB,OAAO;EAC5B,OAAO,gBAAgB,OAAO;CAC/B;AACD;AAEA,SAAgB,uBACf,QACA,UACA,QACS;CACT,MAAM,EAAE,KAAK,UAAU,eAAe,MAAM;CAC5C,MAAM,aAAa,OAAO,QAAQ,KAAK;CACvC,MAAM,WAAW,OAAO,QAAQ,GAAG;CAEnC,IAAI,eAAe,MAAM,aAAa,IACrC,MAAM,IAAI,MACT,mCAAmC,MAAM,WAAW,IAAI,SACzD;CAED,IACC,OAAO,MAAM,aAAa,MAAM,MAAM,CAAC,CAAC,SAAS,KAAK,KACtD,OAAO,MAAM,WAAW,IAAI,MAAM,CAAC,CAAC,SAAS,GAAG,GAEhD,MAAM,IAAI,MACT,mCAAmC,MAAM,WAAW,IAAI,SACzD;CAED,IAAI,WAAW,YACd,MAAM,IAAI,MAAM,GAAG,IAAI,qBAAqB,MAAM,EAAE;CAGrD,MAAM,eAAe,aAAa,MAAM;CACxC,OAAO,GAAG,OAAO,MAAM,GAAG,YAAY,EAAE,MAAM,SAAS,KAAK,EAAE,MAAM,OAAO,MAAM,QAAQ;AAC1F;AAEA,SAAS,eAAe,QAAsB;CAC7C,IAAI,CAAC,0BAA0B,KAAK,MAAM,GACzC,MAAM,IAAI,MACT,oFACD;AAEF;;;ACxCA,eAAsB,WACrB,QACA,SAI4B;CAC5B,MAAM,kBAAkB,KAAK,QAAQ,QAAQ,mBAAmB,QAAQ,IAAI,CAAC;CAC7E,MAAM,aAAa,KAAK,QAAQ,iBAAiB,OAAO,UAAU,WAAW;CAC7E,MAAM,YAAY,MAAM,GAAG,SAAS,YAAY,MAAM;CACtD,MAAM,SAAS,MAAM,oBAAoB,QAAQ,eAAe;CAEhE,MAAM,YAAY,uBAAuB,WAAW,MAD7B,sBAAsB,QAAQ,MAAM,GACG,OAAO,MAAM;CAC3E,MAAM,UAAU,cAAc;CAE9B,IAAI,QAAQ,SAAS,WAAW,SAC/B,MAAM,GAAG,UAAU,YAAY,SAAS;CAGzC,OAAO;EAAE;EAAS;EAAY;CAAO;AACtC"}

package/dist/types-Ddtp95Z3.d.mts

@@ -0,0 +1,49 @@
+//#region src/types.d.ts
+type BundlePlatform = `browser` | `neutral` | `node`;
+type TonnageExports = {
+  exclude?: readonly string[];
+  include?: readonly string[];
+};
+type TonnageRecipe = {
+  entry: string;
+  external?: readonly string[];
+  name: string;
+  platform?: BundlePlatform;
+};
+type TonnageConfig = {
+  exports?: boolean | TonnageExports;
+  external?: readonly string[];
+  heading?: string;
+  marker?: string;
+  packageJson?: string;
+  platform?: BundlePlatform;
+  readme?: string;
+  recipes?: readonly TonnageRecipe[];
+  target?: string;
+};
+type BundleMeasurement = {
+  gzipBytes: number;
+  rawBytes: number;
+};
+type TonnageRow = BundleMeasurement & {
+  imports: readonly string[];
+  name: string;
+};
+type TonnageRecipeRow = BundleMeasurement & {
+  entry: string;
+  name: string;
+};
+type TonnageReport = {
+  exports: readonly TonnageRow[];
+  packageName: string;
+  recipes: readonly TonnageRecipeRow[];
+};
+type TonnageMode = `check` | `write`;
+type TonnageRunResult = {
+  changed: boolean;
+  readmePath: string;
+  report: TonnageReport;
+};
+//#endregion
+export { TonnageMode as a, TonnageReport as c, TonnageExports as i, TonnageRow as l, BundlePlatform as n, TonnageRecipe as o, TonnageConfig as r, TonnageRecipeRow as s, BundleMeasurement as t, TonnageRunResult as u };
+//# sourceMappingURL=types-Ddtp95Z3.d.mts.map

package/dist/types-Ddtp95Z3.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-Ddtp95Z3.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";KAAY;KAEA;EACX;EACA;;KAGW;EACX;EACA;EACA;EACA,WAAW;;KAGA;EACX,oBAAoB;EACpB;EACA;EACA;EACA;EACA,WAAW;EACX;EACA,mBAAmB;EACnB;;KAGW;EACX;EACA;;KAGW,aAAa;EACxB;EACA;;KAGW,mBAAmB;EAC9B;EACA;;KAGW;EACX,kBAAkB;EAClB;EACA,kBAAkB;;KAGP;KAEA;EACX;EACA;EACA,QAAQ"}

package/package.json

@@ -1,33 +1,19 @@
 {
   "name": "tonnage",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Keep deterministic bundle size reports in README files and CI.",
-  "type": "module",
-  "license": "MPL-2.0",
-  "author": "Jeremy Banka",
-  "engines": {
-    "node": ">=22.18.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jeremybanka/tonnage.git"
   },
-  "files": [
-    "AGENTS.md",
-    "CHANGELOG.md",
-    "dist",
-    "src",
-    "examples",
-    "README.md",
-    "LICENSE"
-  ],
-  "bin": {
-    "tonnage": "dist/cli.mjs"
-  },
+  "license": "MPL-2.0",
+  "author": "Jeremy Banka",
+  "type": "module",
   "exports": {
+    "./galley": {
+      "types": "./dist/galley.d.mts",
+      "import": "./dist/galley.mjs"
+    },
     ".": {
       "import": "./dist/index.mjs",
       "types": "./dist/index.d.mts"
@@ -36,16 +22,36 @@
   },
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
+  "bin": {
+    "tonnage": "dist/cli.mjs"
+  },
+  "files": [
+    "AGENTS.md",
+    "CHANGELOG.md",
+    "dist",
+    "src",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
   "dependencies": {
-    "comline": "0.5.2",
-    "esbuild": "0.28.2"
+    "comline": "0.9.0",
+    "esbuild": "0.28.2",
+    "galley.md": "0.1.1"
   },
   "devDependencies": {
-    "@types/node": "26.4.0",
-    "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.24"
+    "@types/node": "26.6.5",
+    "typescript": "7.1.0-dev.20261020.3"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "scripts": {
     "build": "vp pack",
-    "test": "vp test"
+    "test": "vp test",
+    "test:watch": "vp test watch"
   }
 }

package/src/cli.ts

@@ -4,7 +4,13 @@ import fs from "node:fs/promises"
 import path from "node:path"
 import { pathToFileURL } from "node:url"
 
-import { parseTonnageCli, renderTonnageCliHelp } from "./command-line.ts"
+import { logWarnings } from "comline"
+
+import {
+	completeTonnageCli,
+	parseTonnageCli,
+	renderTonnageCliHelp,
+} from "./command-line.ts"
 import { runTonnage } from "./run.ts"
 import type { TonnageConfig } from "./types.ts"
 
@@ -15,7 +21,14 @@ const DEFAULT_CONFIG_FILES = [
 ]
 
 async function main(): Promise<void> {
-	const invocation = parseTonnageCli([`tonnage`, ...process.argv.slice(2)])
+	const completion = await completeTonnageCli(process.argv)
+	if (completion !== undefined) {
+		process.stdout.write(completion)
+		return
+	}
+
+	const invocation = parseTonnageCli(process.argv)
+	logWarnings(invocation.warnings)
 	if (invocation.kind === `help`) {
 		process.stdout.write(renderTonnageCliHelp())
 		return

package/src/command-line.ts

@@ -1,4 +1,11 @@
-import { cli, help, helpOption, optional } from "comline"
+import {
+	type CliWarning,
+	cli,
+	completionResponse,
+	help,
+	helpOption,
+	optional,
+} from "comline"
 
 import type { TonnageMode } from "./types.ts"
 
@@ -22,18 +29,29 @@ const tonnageCli = cli({
 		write: WRITE_MANUAL,
 		"write/$configPath": WRITE_MANUAL,
 	},
+	positionalCompletions: {
+		"check/$configPath": { fileSystem: `files` },
+		"write/$configPath": { fileSystem: `files` },
+	},
 	discoverConfigPath: () => undefined,
 })
 
-export type TonnageCliInvocation =
+export type TonnageCliInvocation = { warnings: CliWarning[] } & (
 	| { kind: `help` }
 	| { configArgument?: string; kind: `run`; mode: TonnageMode }
+)
+
+export function completeTonnageCli(
+	args: string[],
+): Promise<string | undefined> {
+	return completionResponse(tonnageCli.definition, args)
+}
 
 export function parseTonnageCli(args: string[]): TonnageCliInvocation {
-	const { inputs } = tonnageCli(args)
+	const { inputs, warnings } = tonnageCli(args)
 
 	if (inputs.case === `` || inputs.opts.help) {
-		return { kind: `help` }
+		return { kind: `help`, warnings }
 	}
 
 	const mode =
@@ -43,8 +61,8 @@ export function parseTonnageCli(args: string[]): TonnageCliInvocation {
 	const configArgument = inputs.path[1]
 
 	return configArgument === undefined
-		? { kind: `run`, mode }
-		: { configArgument, kind: `run`, mode }
+		? { kind: `run`, mode, warnings }
+		: { configArgument, kind: `run`, mode, warnings }
 }
 
 export function renderTonnageCliHelp(): string {

package/src/galley.ts

@@ -0,0 +1,25 @@
+import path from "node:path"
+
+import type { DocumentContext, Element } from "galley.md"
+
+import { createTonnageReport } from "./report.ts"
+import { reportContent } from "./report-content.ts"
+import type { TonnageConfig } from "./types.ts"
+
+export type TonnageProps = {
+	config?: TonnageConfig
+	/** Override the document directory when measuring a different package. */
+	directory?: string
+}
+
+/** Measure bundles and include the report in a galley.md document. */
+export async function Tonnage(
+	{ config = {}, directory }: TonnageProps,
+	context: DocumentContext,
+): Promise<Element[]> {
+	const report = await createTonnageReport(
+		config,
+		path.resolve(context.directory, directory ?? "."),
+	)
+	return reportContent(report, config)
+}