doc

Author: fi3ework

params.md

@@ -155,17 +155,20 @@ describe('build command', async () => {
 
   test('build options', async () => {
     const fixturePath = path.join(__dirname, 'options');
-    await fse.remove(path.join(fixturePath, 'fooDist'));
+    await fse.remove(path.join(fixturePath, 'dist/ok'));
 
     const stdout = runCliSync(
-      'build ' + '--entry="./src/*" ' + '--dist-path=dist/ok ' + '--no-bundle ',
-      // '--format=esm ' +
-      // '--syntax=es2015 ' +
-      // '--target=web ' +
-      // '--dts=true ' +
-      // '--external=./bar ' +
-      // '--minify=false ' +
-      // '--auto-extension=false' +
+      'build ' +
+        '--entry="./src/*" ' +
+        '--dist-path=dist/ok ' +
+        '--no-bundle ' +
+        '--format=esm ' +
+        `--syntax='["node 14", "Chrome 103"]' ` +
+        '--target=web ' +
+        '--dts=true ' +
+        '--externals=./bar ' +
+        '--minify=false ' +
+        '--auto-extension=false',
       {
         cwd: fixturePath,
         env: {
@@ -176,15 +179,22 @@ describe('build command', async () => {
     );
 
     const rslibConfigText = stripAnsi(extractRslibConfig(stdout));
-    console.log('👩‍❤️‍💋‍👩', stdout);
     expect(rslibConfigText).toMatchInlineSnapshot(`
       "{
         lib: [
           {
-            format: 'cjs',
-            output: { distPath: { root: 'dist/ok' } },
             bundle: false,
-            source: { entry: { index: './src/*' } }
+            source: { entry: { index: './src/*' } },
+            format: 'esm',
+            output: {
+              distPath: { root: 'dist/ok' },
+              target: 'web',
+              minify: false,
+              externals: [ './bar' ]
+            },
+            syntax: [ 'node 14', 'Chrome 103' ],
+            dts: true,
+            autoExtension: 'false'
           }
         ],
         _privateMeta: {
@@ -194,10 +204,15 @@ describe('build command', async () => {
       }"
     `);
 
-    // const files = await globContentJSON(path.join(fixturePath, 'fooDist'));
-    // const fileNames = Object.keys(files).sort();
-    // expect(fileNames).toMatchInlineSnapshot(`[]`);
-    // const output = files[fileNames[0]!];
-    // expect(output).toMatch(/export { .* }/);
+    const files = await globContentJSON(path.join(fixturePath, 'dist/ok'));
+    const fileNames = Object.keys(files).sort();
+    expect(fileNames).toMatchInlineSnapshot(`
+      [
+        "<ROOT>/tests/integration/cli/build/options/dist/ok/foo.d.ts",
+        "<ROOT>/tests/integration/cli/build/options/dist/ok/foo.js",
+      ]
+    `);
+    const output = files[fileNames[1]!];
+    expect(output).toMatch(/export { .* }/);
   });
 });

tests/integration/cli/build/build.test.ts

@@ -3,6 +3,12 @@ import { defineConfig } from '@rslib/core';
 export default defineConfig({
   lib: [
     {
+      bundle: false,
+      source: {
+        entry: {
+          index: './src/*',
+        },
+      },
       format: 'cjs',
       output: {
         distPath: {

tests/integration/cli/build/fooDist/index.js

@@ -0,0 +1,7 @@
+{
+  "extends": "@rslib/tsconfig/base",
+  "compilerOptions": {
+    "baseUrl": "./"
+  },
+  "include": ["src"]
+}

tests/integration/cli/build/options/rslib.config.ts

@@ -29,7 +29,6 @@ export const rslibBinPath = join(
 
 export function runCliSync(command: string, options?: ExecSyncOptions) {
   try {
-    console.log('🤯', command);
     const stdout = execSync(`node ${rslibBinPath} ${command}`, options);
     return stdout.toString();
   } catch (error) {

tests/integration/cli/build/options/tsconfig.json

@@ -2,6 +2,7 @@
 
 - **Type:** `boolean`
 - **Default:** `true`
+- **CLI:** `--auto-extension` / `--no-auto-extension`
 
 Whether to automatically set the file extension based on the [`format`](/config/lib/format) option in the JavaScript output files.
 

tests/scripts/shared.ts

@@ -26,6 +26,7 @@ type AutoExternal =
 - **Default:**
   - `true` when [format](/config/lib/format) is `cjs` or `esm`
   - `false` when [format](/config/lib/format) is `umd` or `mf`
+- **CLI:** `--auto-external` / `--no-auto-external`
 
 Whether to automatically externalize dependencies of different dependency types and do not bundle them.
 

website/docs/en/config/lib/auto-extension.mdx

@@ -2,6 +2,7 @@
 
 - **Type:** `boolean`
 - **Default:** `true`
+- **CLI:** `--bundle` / `--no-bundle`
 
 Specify whether to bundle the library, which is known as bundle mode when `bundle` is set to `true`, and bundleless mode when set to `false`.
 

website/docs/en/config/lib/auto-external.mdx

@@ -21,6 +21,7 @@ type Dts =
 ```
 
 - **Default:** `undefined`
+- **CLI:** `--dts` / `--no-dts`
 
 Configure the generation of the TypeScript declaration files.