feat: support outBase config

Author: fi3ework

packages/core/src/config.ts

@@ -889,13 +889,14 @@ const composeEntryConfig = async (
   bundle: LibConfig['bundle'],
   root: string,
   cssModulesAuto: CssLoaderOptionsAuto,
-): Promise<{ entryConfig: EnvironmentConfig; lcp: string | null }> => {
+  userOutBase?: string,
+): Promise<{ entryConfig: EnvironmentConfig; outBase: string | null }> => {
   let entries: RsbuildConfigEntry = rawEntry;
 
   if (!entries) {
     // In bundle mode, return directly to let Rsbuild apply default entry to './src/index.ts'
     if (bundle !== false) {
-      return { entryConfig: {}, lcp: null };
+      return { entryConfig: {}, outBase: null };
     }
 
     // In bundleless mode, set default entry to './src/**'
@@ -957,13 +958,22 @@ const composeEntryConfig = async (
           entry: appendEntryQuery(resolveEntryPath(entries, root)),
         },
       },
-      lcp: null,
+      outBase: null,
     };
   }
 
   const scanGlobEntries = async (calcLcp: boolean) => {
     // In bundleless mode, resolve glob patterns and convert them to entry object.
     const resolvedEntries: Record<string, string> = {};
+
+    const calcOutBase = async (resolvedEntryFiles: string[]) => {
+      // Similar to `rootDir` in tsconfig and `outbase` in esbuild.
+      const lcp = await calcLongestCommonPath(resolvedEntryFiles);
+      // Using the longest common path of all non-declaration input files by default.
+      const outBase = userOutBase ?? (lcp === null ? root : lcp);
+      return outBase;
+    };
+
     for (const key of Object.keys(entries)) {
       const entry = entries[key];
 
@@ -998,10 +1008,7 @@ const composeEntryConfig = async (
         throw new Error(`Cannot find ${resolvedEntryFiles}`);
       }
 
-      // Similar to `rootDir` in tsconfig and `outbase` in esbuild.
-      const lcp = await calcLongestCommonPath(resolvedEntryFiles);
-      // Using the longest common path of all non-declaration input files by default.
-      const outBase = lcp === null ? root : lcp;
+      const outBase = await calcOutBase(resolvedEntryFiles);
 
       function getEntryName(file: string) {
         const { dir, name } = path.parse(path.relative(outBase, file));
@@ -1036,14 +1043,14 @@ const composeEntryConfig = async (
     }
 
     if (calcLcp) {
-      const lcp = await calcLongestCommonPath(Object.values(resolvedEntries));
-      return { resolvedEntries, lcp };
+      const outBase = await calcOutBase(Object.values(resolvedEntries));
+      return { resolvedEntries, outBase };
     }
-    return { resolvedEntries, lcp: null };
+    return { resolvedEntries, outBase: null };
   };
 
   // LCP could only be determined at the first time of glob scan.
-  const { lcp } = await scanGlobEntries(true);
+  const { outBase } = await scanGlobEntries(true);
   const entryConfig: EnvironmentConfig = {
     tools: {
       rspack: {
@@ -1057,7 +1064,7 @@ const composeEntryConfig = async (
 
   return {
     entryConfig,
-    lcp,
+    outBase,
   };
 };
 
@@ -1415,14 +1422,15 @@ async function composeLibRsbuildConfig(
     pkgJson,
     userExternals: config.output?.externals,
   });
-  const { entryConfig, lcp } = await composeEntryConfig(
+  const { entryConfig, outBase } = await composeEntryConfig(
     config.source?.entry!,
     config.bundle,
     rootPath,
     cssModulesAuto,
+    config.outBase,
   );
   const cssConfig = composeCssConfig(
-    lcp,
+    outBase,
     config.bundle,
     banner?.css,
     footer?.css,
@@ -1431,7 +1439,7 @@ async function composeLibRsbuildConfig(
 
   const entryChunkConfig = composeEntryChunkConfig({
     enabledImportMetaUrlShim: enabledShims.cjs['import.meta.url'],
-    contextToWatch: lcp,
+    contextToWatch: outBase,
   });
   const dtsConfig = await composeDtsConfig(config, dtsExtension);
   const externalsWarnConfig = composeExternalsWarnConfig(
@@ -1548,6 +1556,7 @@ export async function composeCreateRsbuildConfig(
           dts: true,
           shims: true,
           umdName: true,
+          outBase: true,
         }),
       ),
     };

packages/core/src/types/config.ts

@@ -285,6 +285,12 @@ export interface LibConfig extends EnvironmentConfig {
    * @see {@link https://lib.rsbuild.dev/config/lib/umd-name}
    */
   umdName?: string;
+  /**
+   * The base directory of the output files.
+   * @defaultValue `undefined`
+   * @see {@link https://lib.rsbuild.dev/config/lib/out-base}
+   */
+  outBase?: string;
 }
 
 export type LibOnlyConfig = Omit<LibConfig, keyof EnvironmentConfig>;

pnpm-lock.yaml

@@ -0,0 +1,6 @@
+{
+  "name": "outbase-nested-dir-test",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module"
+}

tests/integration/outBase/custom/package.json

@@ -0,0 +1,16 @@
+import { defineConfig } from '@rslib/core';
+import { generateBundleEsmConfig } from 'test-helper';
+
+export default defineConfig({
+  lib: [
+    generateBundleEsmConfig({
+      bundle: false,
+      outBase: './src/utils',
+      source: {
+        entry: {
+          index: './src/utils/foo',
+        },
+      },
+    }),
+  ],
+});

tests/integration/outBase/custom/rslib.config.ts

@@ -0,0 +1 @@
+export const bar = 'foo';

tests/integration/outBase/custom/src/bar/index.ts

@@ -0,0 +1 @@
+export const foo = 'foo';

tests/integration/outBase/custom/src/utils/foo/index.ts

@@ -0,0 +1,2 @@
+export { foo } from './foo';
+export { bar } from './bar';

tests/integration/outBase/custom/src/utils/index.ts

@@ -0,0 +1,33 @@
+import { join } from 'node:path';
+import { buildAndGetResults } from 'test-helper';
+import { describe, expect, test } from 'vitest';
+
+describe('outBase', async () => {
+  test('nested-dir', async () => {
+    const fixturePath = join(__dirname, 'nested-dir');
+    const { files } = await buildAndGetResults({
+      fixturePath,
+    });
+
+    expect(files.esm.sort()).toMatchInlineSnapshot(`
+      [
+        "<ROOT>/tests/integration/outBase/nested-dir/dist/esm/utils/bar/index.js",
+        "<ROOT>/tests/integration/outBase/nested-dir/dist/esm/utils/foo/index.js",
+        "<ROOT>/tests/integration/outBase/nested-dir/dist/esm/utils/index.js",
+      ]
+    `);
+  });
+
+  test('custom', async () => {
+    const fixturePath = join(__dirname, 'custom');
+    const { files } = await buildAndGetResults({
+      fixturePath,
+    });
+
+    expect(files.esm.sort()).toMatchInlineSnapshot(`
+      [
+        "<ROOT>/tests/integration/outBase/custom/dist/esm/foo/index.js",
+      ]
+    `);
+  });
+});

tests/integration/outBase/index.test.ts

@@ -0,0 +1,6 @@
+{
+  "name": "outbase-custom-test",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module"
+}