feat: css external

Author: SoonIter

packages/core/src/config.ts

@@ -977,7 +977,8 @@ const composeBundlelessExternalConfig = (
 } => {
   if (bundle) return { config: {} };
 
-  const isStyleRedirected = redirect.style ?? true;
+  const styleRedirectPath = redirect.style?.path ?? true;
+  const styleRedirectExtension = redirect.style?.extension ?? true;
   const jsRedirectPath = redirect.js?.path ?? true;
   const jsRedirectExtension = redirect.js?.extension ?? true;
 
@@ -996,50 +997,57 @@ const composeBundlelessExternalConfig = (
             if (!request || !getResolve || !context || !contextInfo) {
               return callback();
             }
+            const { issuer } = contextInfo;
 
             if (!resolver) {
               resolver = (await getResolve()) as RspackResolver;
             }
 
+            async function redirectPath(request: string): Promise<string> {
+              try {
+                let resolvedRequest = request;
+                resolvedRequest = await resolver!(context!, resolvedRequest);
+                resolvedRequest = normalizeSlash(
+                  path.relative(path.dirname(issuer), resolvedRequest),
+                );
+                // Requests that fall through here cannot be matched by any other externals config ahead.
+                // Treat all these requests as relative import of source code. Node.js won't add the
+                // leading './' to the relative path resolved by `path.relative`. So add manually it here.
+                if (resolvedRequest[0] !== '.') {
+                  resolvedRequest = `./${resolvedRequest}`;
+                }
+                return resolvedRequest;
+              } catch (e) {
+                // e.g. A react component library importing and using 'react' but while not defining
+                // it in devDependencies and peerDependencies. Preserve 'react' as-is if so.
+                logger.warn(
+                  `Failed to resolve module ${color.green(`"${request}"`)} from ${color.green(issuer)}. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.`,
+                );
+                return request;
+              }
+            }
+
             // Issuer is not empty string when the module is imported by another module.
             // Prevent from externalizing entry modules here.
-            if (contextInfo.issuer) {
+            if (issuer) {
               let resolvedRequest: string = request;
 
-              const cssExternal = cssExternalHandler(
+              const cssExternal = await cssExternalHandler(
                 resolvedRequest,
                 callback,
                 jsExtension,
                 cssModulesAuto,
-                isStyleRedirected,
+                styleRedirectPath,
+                styleRedirectExtension,
+                redirectPath,
               );
 
               if (cssExternal !== false) {
                 return cssExternal;
               }
 
               if (jsRedirectPath) {
-                try {
-                  resolvedRequest = await resolver(context, resolvedRequest);
-                  resolvedRequest = normalizeSlash(
-                    path.relative(
-                      path.dirname(contextInfo.issuer),
-                      resolvedRequest,
-                    ),
-                  );
-                  // Requests that fall through here cannot be matched by any other externals config ahead.
-                  // Treat all these requests as relative import of source code. Node.js won't add the
-                  // leading './' to the relative path resolved by `path.relative`. So add manually it here.
-                  if (resolvedRequest[0] !== '.') {
-                    resolvedRequest = `./${resolvedRequest}`;
-                  }
-                } catch (e) {
-                  // e.g. A react component library importing and using 'react' but while not defining
-                  // it in devDependencies and peerDependencies. Preserve 'react' as-is if so.
-                  logger.warn(
-                    `Failed to resolve module ${color.green(`"${resolvedRequest}"`)} from ${color.green(contextInfo.issuer)}. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.`,
-                  );
-                }
+                resolvedRequest = await redirectPath(resolvedRequest);
               }
 
               // Node.js ECMAScript module loader does no extension searching.

packages/core/src/css/cssConfig.ts

@@ -79,32 +79,42 @@ export function isCssGlobalFile(
 
 type ExternalCallback = (arg0?: undefined, arg1?: string) => void;
 
-export function cssExternalHandler(
+export async function cssExternalHandler(
   request: string,
   callback: ExternalCallback,
   jsExtension: string,
   auto: CssLoaderOptionsAuto,
-  isStyleRedirect: boolean,
-): void | false {
-  const isCssModulesRequest = isCssModulesFile(request, auto);
-
+  styleRedirectPath: boolean,
+  styleRedirectExtension: boolean,
+  redirectPath: (request: string, emitWarning: boolean) => Promise<string>,
+): Promise<false | void> {
   // cssExtract would execute the file handled by css-loader, so we cannot external the "helper import" from css-loader
   // do not external @rsbuild/core/compiled/css-loader/noSourceMaps.js, sourceMaps.js, api.mjs etc.
   if (/compiled\/css-loader\//.test(request)) {
     return callback();
   }
 
+  let resolvedRequest = request;
+
+  if (styleRedirectPath) {
+    resolvedRequest = await redirectPath(request, false);
+  }
+
   // 1. css modules: import './CounterButton.module.scss' -> import './CounterButton.module.mjs'
   // 2. css global: import './CounterButton.scss' -> import './CounterButton.css'
-  if (request[0] === '.' && isCssFile(request)) {
+  if (resolvedRequest[0] === '.' && isCssFile(resolvedRequest)) {
     // preserve import './CounterButton.module.scss'
-    if (!isStyleRedirect) {
-      return callback(undefined, request);
+    if (!styleRedirectExtension) {
+      return callback(undefined, resolvedRequest);
     }
+    const isCssModulesRequest = isCssModulesFile(resolvedRequest, auto);
     if (isCssModulesRequest) {
-      return callback(undefined, request.replace(/\.[^.]+$/, jsExtension));
+      return callback(
+        undefined,
+        resolvedRequest.replace(/\.[^.]+$/, jsExtension),
+      );
     }
-    return callback(undefined, request.replace(/\.[^.]+$/, '.css'));
+    return callback(undefined, resolvedRequest.replace(/\.[^.]+$/, '.css'));
   }
 
   return false;

packages/core/src/types/config.ts

@@ -91,6 +91,19 @@ export type JsRedirect = {
   extension?: boolean;
 };
 
+export type StyleRedirect = {
+  /**
+   * Whether to automatically redirect the import paths of JavaScript output files.
+   * @defaultValue `true`
+   */
+  path?: boolean;
+  /**
+   * Whether to automatically add the file extension to import paths based on the JavaScript output files.
+   * @defaultValue `true`
+   */
+  extension?: boolean;
+};
+
 // @ts-expect-error TODO: support dts redirect in the future
 type DtsRedirect = {
   path?: boolean;
@@ -101,7 +114,7 @@ export type Redirect = {
   /** Controls the redirect of the import paths of output JavaScript files. */
   js?: JsRedirect;
   /** Whether to redirect the import path of the style file. */
-  style?: boolean;
+  style?: StyleRedirect;
   // TODO: support other redirects
   // asset?: boolean;
   // dts?: DtsRedirect;

pnpm-lock.yaml

@@ -18,8 +18,11 @@ test('redirect.js default', async () => {
     `
     [
       "warn    Failed to resolve module "./bar.js" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
+      "warn    Failed to resolve module "./bar.js" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
+      "warn    Failed to resolve module "./foo" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
       "warn    Failed to resolve module "./foo" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
       "warn    Failed to resolve module "lodash" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
+      "warn    Failed to resolve module "lodash" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
     ]
   `,
   );
@@ -81,8 +84,11 @@ test('redirect.js.extension: false', async () => {
     `
     [
       "warn    Failed to resolve module "./bar.js" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
+      "warn    Failed to resolve module "./bar.js" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
+      "warn    Failed to resolve module "./foo" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
       "warn    Failed to resolve module "./foo" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
       "warn    Failed to resolve module "lodash" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
+      "warn    Failed to resolve module "lodash" from <ROOT>/tests/integration/redirect/js-not-resolve/src/index.js. If it's an npm package, consider adding it to dependencies or peerDependencies in package.json to make it externalized.",
     ]
   `,
   );

tests/integration/redirect/jsNotResolved.test.ts

@@ -6,23 +6,27 @@ export default defineConfig({
     generateBundleEsmConfig({
       bundle: false,
       redirect: {
-        style: false,
+        style: {
+          extension: false,
+        },
       },
     }),
     generateBundleCjsConfig({
       bundle: false,
       redirect: {
-        style: false,
+        style: {
+          extension: false,
+        },
       },
     }),
   ],
   source: {
     entry: {
-      index: ['./src/index.ts'],
+      index: ['./src/**', '!./src/**/*.less'],
     },
   },
   output: {
     target: 'web',
-    copy: [{ from: './src/index.less' }, { from: './src/style.module.less' }],
+    copy: [{ from: './**/*.less', context: './src' }],
   },
 });

tests/integration/redirect/style-false/package.json renamed to tests/integration/redirect/style-extension/package.json

@@ -0,0 +1 @@
+import './index.less';