The High Cost of Aesthetic Imports: When Documentation Lies to Developers

Developers often prioritize clean-looking import paths that mimic enterprise-grade modularity without building the underlying package infrastructure. This misalignment creates a critical disconnect between the documentation and the actual npm package, highlighting the maintenance burden of subpath exports maps.