enhancement/issue 1317 import map generation refactor for exports and leveraging import.meta.resolve

[thescientist13]

Related Issue

#1317 / #1309

Test repos (WIP)

• PNPM - adopt pnpm thescientist13/greenwood-lit-ssr#21
• Shoelace - [demo] Shoelace thescientist13/greenwood-lit-ssr#23
• Spectrum WCs - [demo] Spectrum Web Components thescientist13/greenwood-lit-ssr#24
• USWDS - [demo] Demo USWDS thescientist13/greenwood-lit-ssr#26

Summary of Changes

1. Complete refactor of import map generation
   • leverage import.meta.resolve instead of hardcoding location for node_modules (helps with PNPM support (not hardcoding location of node_modules on disk) #1313)
   • should cover the entire exports map spec - https://nodejs.org/api/packages.html#package-entry-points
2. This now enables support non-JavaScript file formats for import maps #1310
3. Assuming its in an export map this will now work - auto-resolve dependencies that only import from a directory #907
4. Upgrade testing dependencies and test dependencies for modern exports (was able to drop @rollup/plugin-replace as a dependency 🎉 )
5. Resolves auto-resolve dependencies that only import from a directory #907
6. This will require a minimum NodeJS bump to 20.x for JSON Modules bug and will indirectly resolve Upgrade to Node 20.x (latest LTS) #1202

Plan is to extend import.meta.resolve throughout Greenwood for plugins, building. So for that reason #1313 / #684 will carry over into a follow up PR, which should address all the demo PRs.

Documentation

1. improve website docs / recommendations on using scripts and styles (non launch gating?) - improve documentation around referencing scripts and import map diagnostics www.greenwoodjs.dev#144
   • avoid /, always use relative
   • node modules compat
   • what our import map resolver supports
2. Known issues with import maps - improve documentation around referencing scripts and import map diagnostics www.greenwoodjs.dev#144
   • @types/trusted-types has an empty main field - https://unpkg.com/browse/@types/[email protected]/package.json
   • matches-selector has no entry point at all (just a bin entry point)- https://unpkg.com/browse/[email protected]/package.json
3. Minimum Node version - hmm, build seems to be fine on Node 18 and not getting locally at all? Seems like we leave it as is

TODOs

1. Bump NodeJS version to minimum version per - ERR_INTERNAL_ASSERTION with Strapi CLI nodejs/node#51354
   • engines
   • GitHub Actions
2. Fix Windows test cases
3. merge enhancement/issue 1218 native import attributes parsing #1321 and rebase (copy over walker package ranger 1)
4. error handling / diagnostics
   • console log about building up import map?
   • track / "collapse" module not found error messages
   • warn if valid condition not met
5. clean up demo code / console logs / leave good comments (backup branch first for easy reference of import maps behavior)
   • https://github.com/ProjectEvergreen/greenwood/tree/enhancement/issue-1317-import-map-generation-refactor-sandbox