tonnage 0.1.3 → 0.2.0

package/AGENTS.md

@@ -8,3 +8,5 @@ CI-first runtime JavaScript bundle measurement with checked-in README reports.
 - Peer dependencies stay external by default. Use explicit `external` entries only for additional dependencies intentionally supplied by consumers.
 - Run `tonnage write` to update a generated README section and `tonnage check` in CI to detect drift.
 - Keep marker names stable and use the `tonnage:<name>:start` and `tonnage:<name>:end` comment forms.
+- For a galley.md document, import `Tonnage` from `tonnage/galley`. Its config paths default to the containing document's directory. The component measures and renders a report without writing a README or requiring section markers.
+- Await `renderTonnageMarkdown(report, config)` when using the programmatic API. CLI reports and document components share Galley's table rendering, escaping literal text and aligning byte columns to the right.

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # tonnage
 
+## 0.2.0
+
+### Minor Changes
+
+- 0521e43: Render reports through galley.md 0.1.1 native table elements and expose a Tonnage component from tonnage/galley for MDX documents. Galley is now a runtime dependency, renderTonnageMarkdown returns a Promise and must be awaited, and inline code and table text use Galley's Markdown escaping and column alignment.
+
 ## 0.1.3
 
 ### Patch Changes

package/README.md

@@ -15,11 +15,43 @@ per bundle.
 Add the generated-section comments to the target README, then create a config
 beside the package manifest. The complete configuration exhibit is in
 [examples/tonnage.config.ts](./examples/tonnage.config.ts).
+
+```ts
+import { defineConfig, type TonnageConfig } from "tonnage"
+
+// @exhibit-region start config
+const config: TonnageConfig = defineConfig({
+	exports: {
+		exclude: [`./package.json`],
+	},
+	marker: `my-package`,
+	recipes: [
+		{
+			entry: `examples/recipes/react-app.ts`,
+			name: `React app`,
+			platform: `browser`,
+		},
+	],
+})
+
+export default config
+// @exhibit-region end config
+
+```
+
 Each recipe points to a reviewable entry file such as
 [examples/recipes/react-app.ts](./examples/recipes/react-app.ts). Use named
 imports in these files to represent the runtime surface a real application uses;
 unused package exports are tree-shaken.
 
+```ts
+// @exhibit-region start recipe
+export { atom } from "my-package"
+export { useO } from "my-package/react"
+// @exhibit-region end recipe
+
+```
+
 The default generated-section marker is `default`; the example uses `my-package`.
 The opening and closing comments use the forms
 `tonnage:my-package:start` and `tonnage:my-package:end`.
@@ -81,6 +113,23 @@ JavaScript bytes, with declarations, source maps, CSS, and other assets excluded
 Peer dependencies remain external, and shared modules are counted once in each
 bundle.
 
+Reports use Galley's native table elements, with right-aligned byte columns and
+literal escaping for import names, entry paths, and recipe labels.
+
+For programmatic use, await both measurement and Markdown rendering:
+
+```ts
+import {
+	createTonnageReport,
+	defineConfig,
+	renderTonnageMarkdown,
+} from "tonnage"
+
+const config = defineConfig({ platform: "node" })
+const report = await createTonnageReport(config, process.cwd())
+const markdown = await renderTonnageMarkdown(report, config)
+```
+
 ## Package resolution and platforms
 
 Tonnage resolves the package's own public import name from the manifest selected
@@ -98,3 +147,32 @@ commonly fall through to their `default` target. Set `platform` to `browser` or
 `node` when that runtime is what you want to measure; those choices retain
 esbuild's native export conditions and main-field behavior. A recipe's
 `platform` overrides the report-wide setting for that recipe.
+
+## MDX documents
+
+Use [galley.md](https://www.npmjs.com/package/galley.md) to compose a README from source examples and reports:
+
+```mdx
+import { Tonnage } from "tonnage/galley"
+import config from "./tonnage.config.ts"
+import Example from "./examples/recipes/react-app.ts" with { type: "code", lang: "ts" }
+
+<Example />
+
+<Tonnage config={config} />
+```
+
+The component resolves paths relative to the containing document. Pass `directory` to measure another package. It produces the same tables as the CLI without writing a README or requiring generated-section markers. Tonnage includes Galley as a runtime dependency; add `galley.md` directly to your project's development dependencies to run `galley write` and `galley check` when authoring documents.
+
+## Bundle size
+
+Package export sizes include complete runtime export surfaces.
+
+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.
+
+| Import           | Minified JS |   Gzip JS |
+| ---------------- | ----------: | --------: |
+| `tonnage`        |   491,915 B | 153,965 B |
+| `tonnage/galley` |   484,581 B | 151,561 B |
+
+Report maintained with [tonnage](https://github.com/jeremybanka/tonnage).

package/README.mdx

@@ -0,0 +1,143 @@
+import { Tonnage } from "tonnage/galley"
+import Configuration from "./examples/tonnage.config.ts" with { type: "code", lang: "ts" }
+import Recipe from "./examples/recipes/react-app.ts" with { type: "code", lang: "ts" }
+
+# tonnage
+
+Keep exact bundle size tables in a package README and fail CI when the checked-in
+numbers drift.
+
+The tool bundles real public package imports with esbuild, minifies the result,
+and reports JavaScript bytes before and after level-9 gzip. Public-module rows
+retain every runtime export; recipe entry files can select named exports and
+tree-shake the rest. Declarations, source maps, CSS, and other assets are not
+counted. Peer dependencies stay external, and shared modules are counted once
+per bundle.
+
+## Configure
+
+Add the generated-section comments to the target README, then create a config
+beside the package manifest. The complete configuration exhibit is in
+[examples/tonnage.config.ts](./examples/tonnage.config.ts).
+<Configuration />
+
+Each recipe points to a reviewable entry file such as
+[examples/recipes/react-app.ts](./examples/recipes/react-app.ts). Use named
+imports in these files to represent the runtime surface a real application uses;
+unused package exports are tree-shaken.
+
+<Recipe />
+
+The default generated-section marker is `default`; the example uses `my-package`.
+The opening and closing comments use the forms
+`tonnage:my-package:start` and `tonnage:my-package:end`.
+
+## Run
+
+Run `tonnage write` during development to update the README. Run
+`tonnage check` in CI to recompute the same report without writing and exit
+nonzero when the README is stale. Run `tonnage --help` to see both commands and
+their optional config-path arguments.
+
+Pass a config path with `tonnage check path/to/tonnage.config.ts` or
+`tonnage write path/to/tonnage.config.ts`. Otherwise, Tonnage looks in the current
+directory for `tonnage.config.ts`, then `tonnage.config.mjs`, then
+`tonnage.config.js`. Config modules may use top-level `await`. Missing configs
+are errors. Use `--` before a config path that starts with a dash.
+
+Unknown options are ignored with warnings on stderr. Warnings do not change the
+exit status; `check` still exits nonzero when the report is stale.
+
+By default the tool reads `package.json`, writes `README.md`, and measures every
+public export except `./package.json`. Paths are resolved relative to the config
+file. Use `exports.include` or `exports.exclude` to select subpaths, recipe entry
+files to describe realistic runtime boundaries, and `external` for non-peer
+imports that the package intentionally leaves to its consumers.
+
+### Shell completion
+
+With `tonnage` available on your shell's `PATH`, install completion for your shell:
+
+```sh
+tonnage completion install bash
+tonnage completion install zsh
+tonnage completion install fish
+tonnage completion install nushell
+tonnage completion install carapace
+```
+
+Choose the integration you use. Completion suggests commands, help options, and
+config paths without loading your config or measuring bundles. Installation
+checks the shell's prerequisites and writes to its completion directory without
+editing shell profiles. It reports any setup needed for your shell. If Nushell
+already uses Carapace, install only the Carapace integration.
+
+Run `tonnage completion bash` (or another target above) to print the integration
+file without installing it. The `completion` command and comline's internal
+completion protocol commands are reserved for shell integration.
+
+## Report layout
+
+Generated reports adapt to the measurements they contain. An exports-only or
+recipes-only report puts its table directly below the configured report heading
+and describes only that type of measurement. A report with both types labels the
+tables `Package exports` and `Usage examples` so readers can distinguish complete
+runtime export surfaces from tree-shaken recipe bundles.
+
+Every layout states the exact measurement semantics: minified and level-9 gzip
+JavaScript bytes, with declarations, source maps, CSS, and other assets excluded.
+Peer dependencies remain external, and shared modules are counted once in each
+bundle.
+
+Reports use Galley's native table elements, with right-aligned byte columns and
+literal escaping for import names, entry paths, and recipe labels.
+
+For programmatic use, await both measurement and Markdown rendering:
+
+```ts
+import {
+	createTonnageReport,
+	defineConfig,
+	renderTonnageMarkdown,
+} from "tonnage"
+
+const config = defineConfig({ platform: "node" })
+const report = await createTonnageReport(config, process.cwd())
+const markdown = await renderTonnageMarkdown(report, config)
+```
+
+## Package resolution and platforms
+
+Tonnage resolves the package's own public import name from the manifest selected
+by `packageJson`; a workspace package does not need to install or declare itself
+as a dependency. Root and subpath imports still go through esbuild's package
+resolver, so the manifest's `exports` restrictions and conditions apply. Runtime
+dependencies resolve from the measured package, while its peer dependencies stay
+external.
+
+The default `platform` is `neutral`. For packages without `exports`, Tonnage
+configures neutral resolution to try the `module` field and then `main`, so
+main-only packages and dependencies are actionable by default. With conditional
+`exports`, neutral does not enable the `browser` or `node` condition, so exports
+commonly fall through to their `default` target. Set `platform` to `browser` or
+`node` when that runtime is what you want to measure; those choices retain
+esbuild's native export conditions and main-field behavior. A recipe's
+`platform` overrides the report-wide setting for that recipe.
+
+## MDX documents
+
+Use [galley.md](https://www.npmjs.com/package/galley.md) to compose a README from source examples and reports:
+
+```mdx
+import { Tonnage } from "tonnage/galley"
+import config from "./tonnage.config.ts"
+import Example from "./examples/recipes/react-app.ts" with { type: "code", lang: "ts" }
+
+<Example />
+
+<Tonnage config={config} />
+```
+
+The component resolves paths relative to the containing document. Pass `directory` to measure another package. It produces the same tables as the CLI without writing a README or requiring generated-section markers. Tonnage includes Galley as a runtime dependency; add `galley.md` directly to your project's development dependencies to run `galley write` and `galley check` when authoring documents.
+
+<Tonnage config={{ platform: "node", exports: { include: [".", "./galley"] } }} />

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as runTonnage } from "./run-CZ_FO4C7.mjs";
+import { t as runTonnage } from "./run-BJN1MXRf.mjs";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";

package/dist/galley.d.mts

@@ -0,0 +1,12 @@
+import { r as TonnageConfig } from "./types-Ddtp95Z3.mjs";
+import { DocumentContext, Element } from "galley.md";
+//#region src/galley.d.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 declare function Tonnage({ config, directory }: TonnageProps, context: DocumentContext): Promise<Element[]>;
+//#endregion
+//# sourceMappingURL=galley.d.mts.map

package/dist/galley.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"galley.d.mts","names":[],"sources":["../src/galley.ts"],"mappings":";;;YAQY;EACX,SAAS;;EAET;;;wBAIqB,UACnB,QAAa,aAAa,cAC5B,SAAS,kBACP,QAAQ"}

package/dist/galley.mjs

@@ -0,0 +1,12 @@
+import { r as reportContent, t as createTonnageReport } from "./report-B3HrJ4UQ.mjs";
+import path from "node:path";
+//#region src/galley.ts
+/** Measure bundles and include the report in a galley.md document. */
+async function Tonnage({ config = {}, directory }, context) {
+	const report = await createTonnageReport(config, path.resolve(context.directory, directory ?? "."));
+	return reportContent(report, config);
+}
+//#endregion
+export { Tonnage };
+
+//# sourceMappingURL=galley.mjs.map

package/dist/galley.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"galley.mjs","names":[],"sources":["../src/galley.ts"],"sourcesContent":["import path from \"node:path\"\n\nimport type { DocumentContext, Element } from \"galley.md\"\n\nimport { createTonnageReport } from \"./report.ts\"\nimport { reportContent } from \"./report-content.ts\"\nimport type { TonnageConfig } from \"./types.ts\"\n\nexport type TonnageProps = {\n\tconfig?: TonnageConfig\n\t/** Override the document directory when measuring a different package. */\n\tdirectory?: string\n}\n\n/** Measure bundles and include the report in a galley.md document. */\nexport async function Tonnage(\n\t{ config = {}, directory }: TonnageProps,\n\tcontext: DocumentContext,\n): Promise<Element[]> {\n\tconst report = await createTonnageReport(\n\t\tconfig,\n\t\tpath.resolve(context.directory, directory ?? \".\"),\n\t)\n\treturn reportContent(report, config)\n}\n"],"mappings":";;;;AAeA,eAAsB,QACrB,EAAE,SAAS,CAAC,GAAG,aACf,SACqB;CACrB,MAAM,SAAS,MAAM,oBACpB,QACA,KAAK,QAAQ,QAAQ,WAAW,aAAa,GAAG,CACjD;CACA,OAAO,cAAc,QAAQ,MAAM;AACpC"}

package/dist/index.d.mts

@@ -1,51 +1,5 @@
+import { a as TonnageMode, c as TonnageReport, i as TonnageExports, l as TonnageRow, n as BundlePlatform, o as TonnageRecipe, r as TonnageConfig, s as TonnageRecipeRow, t as BundleMeasurement, u as TonnageRunResult } from "./types-Ddtp95Z3.mjs";
 import "esbuild";
-//#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
 //#region src/define-config.d.ts
 export declare function defineConfig(config: TonnageConfig): TonnageConfig;
 //#endregion
@@ -69,7 +23,8 @@ export declare function updateGeneratedSection(readme: string, markdown: string,
 //#endregion
 //#region src/report.d.ts
 export declare function createTonnageReport(config: TonnageConfig, configDirectory: string): Promise<TonnageReport>;
-export declare function renderTonnageMarkdown(report: TonnageReport, config?: TonnageConfig): string;
+/** Serialize a report with the same Galley elements used by the document component. */
+export declare function renderTonnageMarkdown(report: TonnageReport, config?: TonnageConfig): Promise<string>;
 //#endregion
 //#region src/run.d.ts
 export declare function runTonnage(config: TonnageConfig, options: {

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/define-config.ts","../src/measure.ts","../src/readme.ts","../src/report.ts","../src/run.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;;;;wBClDO,aAAa,QAAQ,gBAAgB;;;KCKzC;EACX;EACA,WAAW;EACX;EACA;;KAGW,sBAAsB;wBAMZ,aACrB,eACA,SAAS,sBACP,QAAQ;wBAcW,eACrB,4BACA,SAAS,wBACP,QAAQ;;;wBCxCK,eAAe;EAC9B;EACA;;wBASe,uBACf,gBACA,kBACA;;;wBCOqB,oBACrB,QAAQ,eACR,0BACE,QAAQ;wBA+DK,sBACf,QAAQ,eACR,SAAQ;;;wBClFa,WACrB,QAAQ,eACR;EACC;EACA,MAAM;IAEL,QAAQ"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/define-config.ts","../src/measure.ts","../src/readme.ts","../src/report.ts","../src/run.ts"],"mappings":";;;wBAEgB,aAAa,QAAQ,gBAAgB;;;KCKzC;EACX;EACA,WAAW;EACX;EACA;;KAGW,sBAAsB;wBAMZ,aACrB,eACA,SAAS,sBACP,QAAQ;wBAcW,eACrB,4BACA,SAAS,wBACP,QAAQ;;;wBCxCK,eAAe;EAC9B;EACA;;wBASe,uBACf,gBACA,kBACA;;;wBCUqB,oBACrB,QAAQ,eACR,0BACE,QAAQ;;wBAgEW,sBACrB,QAAQ,eACR,SAAQ,gBACN;;;wBCvFmB,WACrB,QAAQ,eACR;EACC;EACA,MAAM;IAEL,QAAQ"}

package/dist/index.mjs

@@ -1,4 +1,5 @@
-import { a as measureImports, i as measureEntry, n as createTonnageReport, o as tonnageMarkers, r as renderTonnageMarkdown, s as updateGeneratedSection, t as runTonnage } from "./run-CZ_FO4C7.mjs";
+import { n as tonnageMarkers, r as updateGeneratedSection, t as runTonnage } from "./run-BJN1MXRf.mjs";
+import { a as measureImports, i as measureEntry, n as renderTonnageMarkdown, t as createTonnageReport } from "./report-B3HrJ4UQ.mjs";
 //#region src/define-config.ts
 function defineConfig(config) {
 	return config;

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/define-config.ts"],"sourcesContent":["import type { TonnageConfig } from \"./types.ts\"\n\nexport function defineConfig(config: TonnageConfig): TonnageConfig {\n\treturn config\n}\n"],"mappings":";;AAEA,SAAgB,aAAa,QAAsC;CAClE,OAAO;AACR"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/define-config.ts"],"sourcesContent":["import type { TonnageConfig } from \"./types.ts\"\n\nexport function defineConfig(config: TonnageConfig): TonnageConfig {\n\treturn config\n}\n"],"mappings":";;;AAEA,SAAgB,aAAa,QAAsC;CAClE,OAAO;AACR"}

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.3",
+  "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.7.0",
-    "esbuild": "0.28.2"
+    "comline": "0.9.0",
+    "esbuild": "0.28.2",
+    "galley.md": "0.1.1"
   },
   "devDependencies": {
-    "@types/node": "26.5.1",
-    "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/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)
+}

package/src/report-content.ts

@@ -0,0 +1,122 @@
+import type { Content, Element } from "galley.md"
+import { jsx } from "galley.md/jsx-runtime"
+
+import type { TonnageConfig, TonnageReport } from "./types.ts"
+
+/** Use Galley's JSX runtime directly so the source CLI stays executable by Node. */
+export function reportContent(
+	report: TonnageReport,
+	config: TonnageConfig = {},
+): Element[] {
+	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: string): Content {
+	return { type: "inlineCode", value }
+}
+
+function formatBytes(bytes: number): string {
+	return `${new Intl.NumberFormat("en-US").format(bytes)} B`
+}
+
+function table(
+	columns: readonly { title: string; align?: "right" }[],
+	rows: readonly (readonly Content[])[],
+): Element {
+	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 })),
+					}),
+				),
+			}),
+		],
+	})
+}

package/src/report.ts

@@ -1,11 +1,14 @@
 import fs from "node:fs/promises"
 import path from "node:path"
 
+import { renderMarkdown } from "galley.md"
+
 import {
 	measureEntryWithPlugins,
 	measureImportsWithPlugins,
 } from "./measure.ts"
 import { withPackageResolver } from "./package-resolution.ts"
+import { reportContent } from "./report-content.ts"
 import type {
 	TonnageConfig,
 	TonnageExports,
@@ -85,80 +88,16 @@ export async function createTonnageReport(
 	}
 }
 
-export function renderTonnageMarkdown(
+/** Serialize a report with the same Galley elements used by the document component. */
+export async function renderTonnageMarkdown(
 	report: TonnageReport,
 	config: TonnageConfig = {},
-): string {
-	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,
-}: {
-	hasExports: boolean
-	hasRecipes: boolean
-}): string[] {
-	const lines: string[] = []
-	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
+): Promise<string> {
+	const directory = process.cwd()
+	return renderMarkdown(reportContent(report, config), {
+		directory,
+		path: path.resolve(directory, config.readme ?? "README.md"),
+	})
 }
 
 function selectExportImports(
@@ -204,45 +143,6 @@ function toPackageImport(packageName: string, exportKey: string): string {
 	return `${packageName}/${exportKey.slice(2)}`
 }
 
-function formatBytes(bytes: number): string {
-	return `${new Intl.NumberFormat(`en-US`).format(bytes)} B`
-}
-
-function code(value: string): string {
-	return `<code>${escapeCell(value)}</code>`
-}
-
-function escapeCell(value: string): string {
-	return value.replaceAll(`&`, `&amp;`).replaceAll(`|`, `&#124;`)
-}
-
 function unique(values: readonly string[]): string[] {
 	return [...new Set(values)]
 }
-
-function markdownTable(
-	headings: readonly string[],
-	rows: readonly (readonly string[])[],
-	alignments: readonly (`left` | `right`)[],
-): string[] {
-	const widths = headings.map((heading, column) =>
-		Math.max(heading.length, ...rows.map((row) => row[column]?.length ?? 0), 3),
-	)
-	const renderRow = (cells: readonly string[]): string =>
-		`| ${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: string,
-	width: number,
-	alignment: `left` | `right`,
-): string {
-	return alignment === `right` ? cell.padStart(width) : cell.padEnd(width)
-}

package/src/run.ts

@@ -16,7 +16,7 @@ export async function runTonnage(
 	const readmePath = path.resolve(configDirectory, config.readme ?? `README.md`)
 	const oldReadme = await fs.readFile(readmePath, `utf8`)
 	const report = await createTonnageReport(config, configDirectory)
-	const markdown = renderTonnageMarkdown(report, config)
+	const markdown = await renderTonnageMarkdown(report, config)
 	const newReadme = updateGeneratedSection(oldReadme, markdown, config.marker)
 	const changed = oldReadme !== newReadme
 

package/dist/run-CZ_FO4C7.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-CZ_FO4C7.mjs","names":[],"sources":["../src/readme.ts","../src/measure.ts","../src/package-resolution.ts","../src/report.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 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 fs from \"node:fs/promises\"\nimport path from \"node:path\"\n\nimport {\n\tmeasureEntryWithPlugins,\n\tmeasureImportsWithPlugins,\n} from \"./measure.ts\"\nimport { withPackageResolver } from \"./package-resolution.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\nexport function renderTonnageMarkdown(\n\treport: TonnageReport,\n\tconfig: TonnageConfig = {},\n): string {\n\tconst hasExports = report.exports.length > 0\n\tconst hasRecipes = report.recipes.length > 0\n\tconst hasMultipleSections = hasExports && hasRecipes\n\tconst lines = [\n\t\t`## ${config.heading ?? `Bundle size`}`,\n\t\t``,\n\t\t...methodologyLines({ hasExports, hasRecipes }),\n\t]\n\n\tif (hasExports) {\n\t\tlines.push(\n\t\t\t``,\n\t\t\t...(hasMultipleSections ? [`### Package exports`, ``] : []),\n\t\t\t...markdownTable(\n\t\t\t\t[`Import`, `Minified JS`, `Gzip JS`],\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\t[`left`, `right`, `right`],\n\t\t\t),\n\t\t)\n\t}\n\n\tif (hasRecipes) {\n\t\tlines.push(\n\t\t\t``,\n\t\t\t...(hasMultipleSections ? [`### Usage examples`, ``] : []),\n\t\t\t...markdownTable(\n\t\t\t\t[`Recipe`, `Entry`, `Minified JS`, `Gzip JS`],\n\t\t\t\treport.recipes.map((row) => [\n\t\t\t\t\tescapeCell(row.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\t[`left`, `left`, `right`, `right`],\n\t\t\t),\n\t\t)\n\t}\n\n\tlines.push(\n\t\t``,\n\t\t`Report maintained with [tonnage](https://github.com/jeremybanka/tonnage).`,\n\t)\n\n\treturn lines.join(`\\n`)\n}\n\nfunction methodologyLines({\n\thasExports,\n\thasRecipes,\n}: {\n\thasExports: boolean\n\thasRecipes: boolean\n}): string[] {\n\tconst lines: string[] = []\n\tif (hasExports) {\n\t\tlines.push(`Package export sizes include complete runtime export surfaces.`)\n\t}\n\tif (hasRecipes) {\n\t\tlines.push(\n\t\t\t`Usage example sizes bundle their entry files and tree-shake unused exports.`,\n\t\t)\n\t}\n\tlines.push(\n\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)\n\treturn lines\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 formatBytes(bytes: number): string {\n\treturn `${new Intl.NumberFormat(`en-US`).format(bytes)} B`\n}\n\nfunction code(value: string): string {\n\treturn `<code>${escapeCell(value)}</code>`\n}\n\nfunction escapeCell(value: string): string {\n\treturn value.replaceAll(`&`, `&amp;`).replaceAll(`|`, `&#124;`)\n}\n\nfunction unique(values: readonly string[]): string[] {\n\treturn [...new Set(values)]\n}\n\nfunction markdownTable(\n\theadings: readonly string[],\n\trows: readonly (readonly string[])[],\n\talignments: readonly (`left` | `right`)[],\n): string[] {\n\tconst widths = headings.map((heading, column) =>\n\t\tMath.max(heading.length, ...rows.map((row) => row[column]?.length ?? 0), 3),\n\t)\n\tconst renderRow = (cells: readonly string[]): string =>\n\t\t`| ${cells.map((cell, column) => padCell(cell, widths[column] ?? 3, alignments[column] ?? `left`)).join(` | `)} |`\n\tconst separator = widths.map((width, column) =>\n\t\talignments[column] === `right`\n\t\t\t? `${`-`.repeat(width - 1)}:`\n\t\t\t: `-`.repeat(width),\n\t)\n\n\treturn [renderRow(headings), renderRow(separator), ...rows.map(renderRow)]\n}\n\nfunction padCell(\n\tcell: string,\n\twidth: number,\n\talignment: `left` | `right`,\n): string {\n\treturn alignment === `right` ? cell.padStart(width) : cell.padEnd(width)\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 = 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":"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"}