tonnage 0.2.0 → 0.3.0

package/AGENTS.md

@@ -2,6 +2,8 @@
 
 CI-first runtime JavaScript bundle measurement with checked-in README reports.
 
+- Install `galley.md@^0.1.1` alongside tonnage. It is a required peer for CLI rendering, the programmatic API, and MDX components.
+
 - Tonnage measures emitted minified JavaScript and level-9 gzip bytes. Do not include declarations, source maps, CSS, or other assets in those figures.
 - Public-module rows retain the complete runtime export surface. Recipe rows use reviewable entry files and tree-shake unused exports.
 - Treat each recipe as one realistic runtime boundary. Keep server and client recipes separate, and count shared modules once within each bundle.

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # tonnage
 
+## 0.3.0
+
+### Minor Changes
+
+- 02567f0: Make galley.md ^0.1.1 a required peer dependency so consumers control the Galley version used by report rendering and MDX components. Install a compatible galley.md version alongside tonnage, including for standalone CLI use.
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -10,6 +10,16 @@ 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.
 
+## Install
+
+Install tonnage and its required Galley peer:
+
+```sh
+pnpm add -D tonnage 'galley.md@^0.1.1'
+```
+
+Galley is required for CLI and programmatic report rendering as well as MDX documents.
+
 ## Configure
 
 Add the generated-section comments to the target README, then create a config
@@ -162,7 +172,7 @@ import Example from "./examples/recipes/react-app.ts" with { type: "code", lang:
 <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.
+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 uses your installed Galley peer; run `galley write` and `galley check` when authoring documents.
 
 ## Bundle size
 
@@ -170,9 +180,9 @@ 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 |
+| Import           | Minified JS |  Gzip JS |
+| ---------------- | ----------: | -------: |
+| `tonnage`        |    50,614 B | 18,071 B |
+| `tonnage/galley` |    49,315 B | 17,579 B |
 
 Report maintained with [tonnage](https://github.com/jeremybanka/tonnage).

package/README.mdx

@@ -14,6 +14,16 @@ 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.
 
+## Install
+
+Install tonnage and its required Galley peer:
+
+```sh
+pnpm add -D tonnage 'galley.md@^0.1.1'
+```
+
+Galley is required for CLI and programmatic report rendering as well as MDX documents.
+
 ## Configure
 
 Add the generated-section comments to the target README, then create a config
@@ -138,6 +148,6 @@ import Example from "./examples/recipes/react-app.ts" with { type: "code", lang:
 <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.
+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 uses your installed Galley peer; run `galley write` and `galley check` when authoring documents.
 
 <Tonnage config={{ platform: "node", exports: { include: [".", "./galley"] } }} />

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tonnage",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Keep deterministic bundle size reports in README files and CI.",
   "repository": {
     "type": "git",
@@ -36,13 +36,17 @@
   ],
   "dependencies": {
     "comline": "0.9.0",
-    "esbuild": "0.28.2",
-    "galley.md": "0.1.1"
+    "esbuild": "0.28.2"
   },
   "devDependencies": {
     "@types/node": "26.6.5",
+    "breakage": "0.8.5",
+    "galley.md": "0.1.1",
     "typescript": "7.1.0-dev.20261020.3"
   },
+  "peerDependencies": {
+    "galley.md": "^0.1.1"
+  },
   "engines": {
     "node": ">=22.18.0"
   },
@@ -51,6 +55,8 @@
   },
   "scripts": {
     "build": "vp pack",
+    "pack:breakage": "pnpm --reporter=silent pack --out .breakage/package.tgz",
+    "test:breakage:peers": "breakage npm check",
     "test": "vp test",
     "test:watch": "vp test watch"
   }