feat: basic load config and build architecture (#15)

Author: Timeless0911

.github/workflows/test-ubuntu.yml

@@ -100,3 +100,8 @@ jobs:
         run: |
           pnpm run test:artifact
           pnpm run test:e2e
+
+      - name: Examples Test
+        if: steps.changes.outputs.changed == 'true'
+        run: |
+          pnpm run build:examples

e2e/cases/define/index.test.ts

@@ -1,18 +1,40 @@
-import { build } from '@rslib/core';
+import { join } from 'node:path';
+import { type RslibConfig, build } from '@rslib/core';
 import { expect, test } from 'vitest';
 import { globContentJSON } from '#helper';
 
 test.fails('define', async () => {
   delete process.env.NODE_ENV;
 
-  const rslibConfig = {
-    root: __dirname,
-    entry: './js/src/index.js',
-    outDir: 'dist',
+  const rslibConfig: RslibConfig = {
+    lib: [
+      {
+        format: 'esm',
+        output: {
+          distPath: {
+            root: join(__dirname, './dist/esm'),
+          },
+        },
+      },
+      {
+        format: 'cjs',
+        output: {
+          distPath: {
+            root: join(__dirname, './dist/cjs'),
+          },
+        },
+      },
+    ],
+    source: {
+      entry: {
+        main: join(__dirname, './js/src/index.js'),
+      },
+    },
   };
 
   const instance = await build(rslibConfig);
-  const results = await globContentJSON(instance.context.distPath, {
+
+  const results = await globContentJSON(instance[0]!.context.distPath, {
     absolute: true,
     ignore: ['/**/*.map'],
   });

examples/basic/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@examples/basic",
+  "private": true,
+  "scripts": {
+    "build": "rslib build"
+  },
+  "devDependencies": {
+    "@rslib/core": "workspace:*",
+    "typescript": "^5.4.5"
+  }
+}

examples/basic/rslib.config.ts

@@ -0,0 +1,27 @@
+import { defineConfig } from '@rslib/core';
+
+export default defineConfig({
+  lib: [
+    {
+      format: 'esm',
+      output: {
+        distPath: {
+          root: './dist/esm',
+        },
+      },
+    },
+    {
+      format: 'cjs',
+      output: {
+        distPath: {
+          root: './dist/cjs',
+        },
+      },
+    },
+  ],
+  source: {
+    entry: {
+      main: './src/index.ts',
+    },
+  },
+});

examples/basic/src/index.ts

@@ -0,0 +1,3 @@
+const message: string = 'Hello, Rslib';
+
+console.log(message);

package.json

@@ -2,7 +2,8 @@
   "name": "rslib-monorepo",
   "private": true,
   "scripts": {
-    "build": "cross-env NX_DAEMON=false nx run-many -t build --parallel=10",
+    "build": "cross-env NX_DAEMON=false nx run-many -t build --exclude @examples/* --parallel=10",
+    "build:examples": "cross-env NX_DAEMON=false nx run-many -t build --projects @examples/* --parallel=10",
     "check-dependency-version": "check-dependency-version-consistency .",
     "lint": "biome check . --diagnostic-level=warn",
     "prebundle": "nx run-many -t prebundle",
@@ -24,16 +25,16 @@
     "package.json": "pnpm run check-dependency-version"
   },
   "devDependencies": {
-    "@biomejs/biome": "^1.7.0",
-    "@modern-js/module-tools": "^2.48.6",
+    "@biomejs/biome": "^1.8.1",
+    "@modern-js/module-tools": "^2.53.0",
     "check-dependency-version-consistency": "^4.1.0",
     "cross-env": "^7.0.3",
     "nano-staged": "^0.8.0",
     "nx": "^19.3.0",
-    "prettier": "^3.2.4",
+    "prettier": "^3.3.2",
     "prettier-plugin-packagejson": "^2.5.0",
-    "simple-git-hooks": "^2.10.0",
-    "vitest": "^1.5.0"
+    "simple-git-hooks": "^2.11.1",
+    "vitest": "^1.6.0"
   },
   "packageManager": "[email protected]",
   "engines": {

packages/core/package.json

@@ -38,7 +38,7 @@
     "prebundle": "prebundle"
   },
   "dependencies": {
-    "@rsbuild/core": "0.6.2"
+    "@rsbuild/core": "0.7.9"
   },
   "devDependencies": {
     "@rslib/tsconfig": "workspace:*",

packages/core/src/build.ts

@@ -1,12 +1,21 @@
-import { createRsbuild } from '@rsbuild/core';
-import { composeCreateRsbuildConfig } from './config';
-import type { RslibConfig } from './types';
-
-export async function build(config: RslibConfig) {
-  const createRsbuildConfig = composeCreateRsbuildConfig(config);
-  const rsbuildInstance = await createRsbuild(createRsbuildConfig);
-  await rsbuildInstance.build({
-    mode: 'production',
-  });
-  return rsbuildInstance;
+import type { RsbuildInstance } from '@rsbuild/core';
+import type { BuildOptions } from './cli/commands';
+import { initRsbuild } from './config';
+import type { RslibConfig } from './types/config';
+
+export async function build(config: RslibConfig, options?: BuildOptions) {
+  const rsbuildInstances = await initRsbuild(config);
+
+  const buildPromises = rsbuildInstances.map(
+    async (rsbuildInstance: RsbuildInstance) => {
+      return await rsbuildInstance.build({
+        mode: 'production',
+        watch: options?.watch,
+      });
+    },
+  );
+
+  await Promise.all(buildPromises);
+
+  return rsbuildInstances;
 }

packages/core/src/cli/commands.ts

@@ -1,23 +1,46 @@
-import { program } from 'commander';
+import { type Command, program } from 'commander';
 import { build } from '../build';
-import type { RslibConfig } from '../types';
+import { loadConfig } from '../config';
+import { logger } from '../utils/logger';
+
+export type CommonOptions = {
+  config?: string;
+  envMode?: string;
+};
+
+export type BuildOptions = CommonOptions & {
+  watch?: boolean;
+};
+
+const applyCommonOptions = (command: Command) => {
+  command
+    .option(
+      '-c --config <config>',
+      'specify the configuration file, can be a relative or absolute path',
+    )
+    .option(
+      '--env-mode <mode>',
+      'specify the env mode to load the `.env.[mode]` file',
+    );
+};
 
 export function runCli() {
   program.name('rslib').usage('<command> [options]').version(RSLIB_VERSION);
 
   const buildCommand = program.command('build');
 
+  [buildCommand].forEach(applyCommonOptions);
+
   buildCommand
-    .description('build the app for production')
-    .option('--entry <entry>', 'entrypoint file to build')
-    .option('--outDir <outDir>', 'dist directory to build to')
-    .action(async (options: RslibConfig) => {
+    .option('-w --watch', 'turn on watch mode, watch for changes and rebuild')
+    .description('build the library for production')
+    .action(async (options: BuildOptions) => {
       try {
-        await build({
-          entry: options.entry,
-          outDir: options.outDir,
-        });
+        const rslibConfig = await loadConfig(options.config, options.envMode);
+        await build(rslibConfig, options);
       } catch (err) {
+        logger.error('Failed to build.');
+        logger.error(err);
         process.exit(1);
       }
     });