Description

Adds bundle size reporting utilities to the tree-shaking analysis scripts, including minification and gzip size stages, human-readable formatting, and reduction percentage calculations.

New exports in scripts/treeshaking.ts:

• formatBundleSize(bytes) — formats bytes to human-readable string (512 B, 1.00 KB, etc.)
• getReductionPercent(baseline, reduced) — calculates size reduction as a percentage
• getBundleSizeReport(components) — returns a full report across 4 stages: es6-folder, tree-shaken, minified, minified+gzip
• Types: BundleSizeStage, BundleSizeReport

Dependencies: Added terser for minification.

Lock file: Rebased package-lock.json onto current main (rollup 4.59.0 + terser 5.46.0).

Related Issue

Motivation and Context

Tooling to understand the real-world impact of tree-shaking — raw bundle size alone is insufficient; minified+gzip size is what users actually ship.

How Has This Been Tested?

Unit tests cover formatBundleSize, getReductionPercent, and getBundleSizeReport including stage ordering, size relationships (minified ≤ tree-shaken, gzip ≤ minified), and reduction percentage monotonicity.

Screenshots (if appropriate):

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.
• I have added a storybook story or VR test, or extended an existing story or VR test to show my changes

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.