Troubleshooting Bundler Compatibility Issues

Systematic approach for diagnosing library compatibility issues with modern bundlers.

Diagnostic Checklist

1. Version Verification

• Check installed npm version vs CDN availability (CDNs often lag behind npm)
• Use Context7 to get latest library documentation
• Check library changelog for breaking changes in asset loading

2. Identify Asset Type

• What does the library need: worker, wasm, static asset, CSS?
• Expected format: URL string, blob, or module import?
• ES module vs CommonJS vs raw text?

3. Bundler Investigation