Rationale
Without the sideEffects flag, bundlers must assume every module has import-time side effects and cannot tree-shake the large root barrel. The codebase is declaration-heavy and side-effect-free at import time (runtime detection and extension registration run on demand, not at import).
Scope
- Add
"sideEffects": false to package.json.
- Audit for accidental import-time side effects; validate via the smoke build on all three runtimes.
Documentation
Acceptance
- Smoke suites green on Bun/Node/Deno.
- A bundler probe (e.g. esbuild) demonstrates unused exports are dropped from a minimal consumer bundle.
Relates
Improvement program M3. Subpath-exports issue.
Rationale
Without the
sideEffectsflag, bundlers must assume every module has import-time side effects and cannot tree-shake the large root barrel. The codebase is declaration-heavy and side-effect-free at import time (runtime detection and extension registration run on demand, not at import).Scope
"sideEffects": falseto package.json.Documentation
Acceptance
Relates
Improvement program M3. Subpath-exports issue.