feat(plugin-asset): support generator['asset'].importMode for Rslib

[SoonIter]

Summary

for web-infra-dev/rslib#570 and associated with web-infra-dev/rslib#684

For mid-level artifacts such as libraries in ESM/CJS formats, import statements for assets can be preserved to allow the upper-level applications to handle them.

In Rslib, we provide an option for users to choose, this feature needs to be implemented in Rspack.

Details

this pr does these things below:

1. add generator['asset/resource'].importMode

type: 'url' | 'preserve' default: 'url'

When this option is turned on, we will keep the require or import statement for asset. (you can see the example below from Rslib or you can see the test-case)

input

└── src
    ├── assets
    │   └── logo.svg   // <--
    └── index.tsx

// index.tsx
import foo from './assets/logo.svg';
console.log(foo);

output

./dist
└── esm
    ├── assets
    │   └── logo.mjs     // <--
    ├── static/svg
    │   └── logo.svg     // <--
    ├── index.d.ts
    └── index.mjs

// dist/esm/index.mjs
import foo from './assets/logo.mjs';
console.log(foo);

// dist/esm/assets/logo.mjs
import url from '../static/svg/logo.svg';
export { url as default };

---

2. add CodeGenerationPublicPathAutoReplace to generator_context.data, it can mark the js modules need to do replacements of AUTO_PUBLIC_PATH_PLACEHOLDER, it has the similar logic with experiments.css

   [Feature]: Support publicPath: auto in asset module #8748

   // For performance, mark the js modules contains AUTO_PUBLIC_PATH_PLACEHOLDER, and replace it
   #[derive(Clone, Debug)]
   pub struct CodeGenerationPublicPathAutoReplace(pub bool);

   // logo.mjs
   // before
   import logo_namespaceObject from 'AUTO_PUBLIC_PATH_PLACEHOLDERstatic/svg/logo.svg';
   export { logo_namespaceObject as default };
   // after
   import logo_namespaceObject from '../../static/svg/logo.svg';
   export { logo_namespaceObject as default };

---

3. fix webpack asset module bugs(different from webpack)

   • concaten: when using asset as entry, the asset is missing because of being concatenated
   • exports dependency: asset module has default export literally, however, it has no export dependeny in webpack which is an ancient mistake I think. it causes weird behavior when asset module is set as entry, or being concatenated

Related links

close #8711
partially support #8748

Checklist

• Tests updated (or not required).
• Documentation updated (or not required).

[netlify]

✅ Deploy Preview for rspack canceled.

Name	Link
🔨 Latest commit	22235e3
🔍 Latest deploy log	https://app.netlify.com/sites/rspack/deploys/678e255de146d400087627ba

[hardfist]

!pkg.pr.new

[codspeed-hq]

CodSpeed Performance Report

Merging #8724 will not alter performance

_{Comparing export-asset (22235e3) with main (876f50e)}

Summary

✅ 3 untouched benchmarks

[SoonIter]

One drawback is that there may be some errors in the sourcemap, I have not tested it at present

[ahabhgk]

We need a more general name for this, this shouldn't be lib specific

[SoonIter]

@JSerFeng @ahabhgk has been renamed to generator['asset'].experimentalPreserveImport

[JSerFeng]

LGTM @ahabhgk