feat: CLI 和配置增强

Author: Sunny-117

TODO.md

@@ -8,17 +8,17 @@
 
 ### 🔧 CLI 和配置增强
 
-- [ ] **多格式输出支持** - 支持 `esm`, `cjs`, `iife`, `umd` 多种输出格式
-- [ ] **全局变量名配置** - 为 IIFE/UMD 格式指定全局变量名 (`globalName`)
-- [ ] **平台目标配置** - 支持 `browser`, `node`, `neutral` 平台目标
-- [ ] **目标环境配置** - 支持 ES 版本目标如 `es2015`, `esnext` 等
-- [ ] **外部依赖配置** - 更灵活的 `external` 和 `noExternal` 配置
-- [ ] **别名配置** - 模块路径别名支持 (`alias`)
-- [ ] **环境变量注入** - 编译时环境变量定义 (`env`, `define`)
+- [x] **多格式输出支持** - 支持 `esm`, `cjs`, `iife`, `umd` 多种输出格式
+- [x] **全局变量名配置** - 为 IIFE/UMD 格式指定全局变量名 (`globalName`)
+- [x] **平台目标配置** - 支持 `browser`, `node`, `neutral` 平台目标
+- [x] **目标环境配置** - 支持 ES 版本目标如 `es2015`, `esnext` 等
+- [x] **外部依赖配置** - 更灵活的 `external` 和 `noExternal` 配置
+- [x] **别名配置** - 模块路径别名支持 (`alias`)
+- [x] **环境变量注入** - 编译时环境变量定义 (`env`, `define`)
 
 ### 🏗️ 构建功能增强
 
-- [ ] **清理功能** - 构建前自动清理输出目录 (`clean`)
+- [x] **清理功能** - 构建前自动清理输出目录 (`clean`)
 - [ ] **文件复制** - 静态资源复制功能 (`copy`)
 - [ ] **文件哈希** - 输出文件名哈希支持 (`hash`)
 - [ ] **固定扩展名** - 强制使用 `.cjs`/`.mjs` 扩展名 (`fixedExtension`)
@@ -74,6 +74,8 @@
 3. ✅ 环境变量注入 - 支持 env 和 define 配置，编译时变量替换
 4. ✅ 平台目标配置 - 支持 browser, node, neutral 平台目标
 5. ✅ 外部依赖配置增强 - 增强 external 和 noExternal 配置，支持正则表达式和函数
+6. ✅ 目标环境配置 - 支持 ES 版本目标 (es5, es2015-es2022, esnext)
+7. ✅ 别名配置 - 模块路径别名支持，支持 bundle 和 transform 模式
 
 #### 实现详情
 

src/builders/bundle.ts

@@ -100,6 +100,7 @@ export async function rolldownBuild(
   // Get configuration with defaults
   const formats = Array.isArray(entry.format) ? entry.format : [entry.format || 'esm']
   const platform = entry.platform || 'node'
+  const target = entry.target || 'es2022'
   const outDir = entry.outDir || 'dist'
   const fullOutDir = resolve(ctx.pkgDir, outDir)
   const isMultiFormat = formats.length > 1
@@ -187,6 +188,12 @@ export async function rolldownBuild(
       ? entry.external
       : externalDeps,
     define: defineOptions,
+    resolve: {
+      alias: entry.alias || {},
+    },
+    transform: {
+      target,
+    },
   } satisfies InputOptions)
 
   await hooks.rolldownConfig?.(baseRolldownConfig, ctx)

src/builders/transform.ts

@@ -159,21 +159,37 @@ async function transformModule(entryPath: string, entry: TransformEntry) {
 
   const magicString = new MagicString(sourceText)
 
-  // Rewrite relative imports
+  // Rewrite relative imports and aliases
   const updatedStarts = new Set<number>()
   const rewriteSpecifier = (req: {
     value: string
     start: number
     end: number
   }) => {
-    const moduleId = req.value
-    if (!moduleId.startsWith('.')) {
+    let moduleId = req.value
+    let wasAliasResolved = false
+
+    // Handle aliases first
+    if (entry.alias) {
+      for (const [alias, target] of Object.entries(entry.alias)) {
+        if (moduleId === alias || moduleId.startsWith(alias + '/')) {
+          moduleId = moduleId.replace(alias, target)
+          wasAliasResolved = true
+          break
+        }
+      }
+    }
+
+    // Skip external modules unless they were resolved from aliases
+    if (!moduleId.startsWith('.') && !wasAliasResolved) {
       return
     }
+
     if (updatedStarts.has(req.start)) {
       return // prevent double rewritings
     }
     updatedStarts.add(req.start)
+
     const resolvedAbsolute = resolveModulePath(moduleId, resolveOptions)
     const newId = relative(
       dirname(entryPath),
@@ -204,6 +220,7 @@ async function transformModule(entryPath: string, entry: TransformEntry) {
     ...entry.oxc,
     ...sourceOptions,
     cwd: dirname(entryPath),
+    target: entry.target || 'es2022',
     typescript: {
       declaration: { stripInternal: true },
       ...entry.oxc?.typescript,

src/cli.ts

@@ -32,6 +32,9 @@ const args = parseArgs({
     'platform': {
       type: 'string',
     },
+    'target': {
+      type: 'string',
+    },
     'global-name': {
       type: 'string',
     },
@@ -70,6 +73,7 @@ Options:
   -w, --watch              Enable watch mode
   --format <format>        Output format(s): esm, cjs, iife, umd (can be used multiple times)
   --platform <platform>    Target platform: browser, node, neutral
+  --target <target>        Target ES version: es5, es2015, es2016, es2017, es2018, es2019, es2020, es2021, es2022, esnext
   --global-name <name>     Global variable name for IIFE/UMD formats
   --clean                  Clean output directory before build (default: true)
   --no-clean               Disable cleaning output directory
@@ -131,6 +135,11 @@ const entries: BuildEntry[] = rawEntries.map((entry) => {
         baseEntry.platform = args.values.platform
       }
 
+      // Target option
+      if (args.values.target) {
+        baseEntry.target = args.values.target
+      }
+
       // Global name for IIFE/UMD
       if (args.values['global-name']) {
         baseEntry.globalName = args.values['global-name']

src/types.ts

@@ -13,6 +13,7 @@ import type { Options as DtsOptions } from 'rolldown-plugin-dts'
 
 export type OutputFormat = 'esm' | 'cjs' | 'iife' | 'umd'
 export type Platform = 'browser' | 'node' | 'neutral'
+export type Target = 'es5' | 'es2015' | 'es2016' | 'es2017' | 'es2018' | 'es2019' | 'es2020' | 'es2021' | 'es2022' | 'esnext'
 
 export interface BuildContext {
   pkgDir: string
@@ -46,11 +47,25 @@ export interface _BuildEntry {
    */
   platform?: Platform
 
+  /**
+   * Target ES version for the build.
+   *
+   * Defaults to `'es2022'` if not provided.
+   */
+  target?: Target
+
   /**
    * Global variable name for IIFE/UMD formats.
    */
   globalName?: string
 
+  /**
+   * Module path aliases.
+   *
+   * Allows defining path mappings for imports.
+   */
+  alias?: Record<string, string>
+
   /**
    * Clean output directory before build.
    *

test/__snapshots__/target-and-alias-configuration/should-support-alias-configuration-in-bundle-mode.snap.md

@@ -0,0 +1,13 @@
+## index.mjs
+
+```js
+//#region src/utils/helper.ts
+const helper = "helper function";
+
+//#endregion
+//#region src/index.ts
+const test = helper;
+
+//#endregion
+export { test };
+```

test/__snapshots__/target-and-alias-configuration/should-support-alias-configuration-in-transform-mode.snap.md

@@ -0,0 +1,28 @@
+## index.d.mts
+
+```ts
+export declare const test: unknown;
+
+```
+
+## index.mjs
+
+```js
+import { helper } from "./utils/helper.mjs";
+export const test = helper;
+
+```
+
+## utils/helper.d.mts
+
+```ts
+export declare const helper = "helper function";
+
+```
+
+## utils/helper.mjs
+
+```js
+export const helper = "helper function";
+
+```

test/__snapshots__/target-and-alias-configuration/should-support-target-configuration-in-transform-mode.snap.md

@@ -0,0 +1,31 @@
+## index.d.mts
+
+```ts
+export declare const test: unknown;
+
+```
+
+## index.mjs
+
+```js
+const _excluded = ["a"];
+import _objectWithoutProperties from "@oxc-project/runtime/helpers/objectWithoutProperties";
+import _asyncToGenerator from "@oxc-project/runtime/helpers/asyncToGenerator";
+export const test = function() {
+	var _ref = _asyncToGenerator(function* () {
+		const obj = {
+			a: 1,
+			b: 2
+		};
+		const { a } = obj, rest = _objectWithoutProperties(obj, _excluded);
+		return {
+			a,
+			rest
+		};
+	});
+	return function test() {
+		return _ref.apply(this, arguments);
+	};
+}();
+
+```