feat: add case "compatible" and "node16" to option declaration

README.md

@@ -53,7 +53,7 @@ Update `package.json`:
     }
   },
   "main": "./dist/index.cjs",
-  "types": "./dist/index.d.cts",
+  "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ]
@@ -84,7 +84,7 @@ export default {
 }
 ```
 
-You can either use `unbuild` key in `package.json` or `build.config.{js,ts,json}` to specify configuration.
+You can either use `unbuild` key in `package.json` or `build.config.{js,cjs,mjs,ts,mts,cts,json}` to specify configuration.
 
 See options [here](./src/types.ts).
 
@@ -109,8 +109,14 @@ export default defineBuildConfig({
     // Change outDir, default is 'dist'
     outDir: 'build',
 
-    // Generates .d.ts declaration file
-    declaration: true,
+    /**
+     * * `compatible` means "src/index.ts" will generate "dist/index.d.mts", "dist/index.d.cts" and "dist/index.d.ts".
+     * * `node16` means "src/index.ts" will generate "dist/index.d.mts" and "dist/index.d.cts".
+     * * `true` is equivalent to `compatible`.
+     * * `false` will disable declaration generation.
+     * * `undefined` will auto detect based on "package.json". If "package.json" has "types" field, it will be `"compatible"`, otherwise `false`.
+     */
+    declaration: 'compatible',
 })
 ```
 

package.json

@@ -9,7 +9,7 @@
       "import": "./dist/index.mjs"
     }
   },
-  "types": "./dist/index.d.mts",
+  "types": "./dist/index.d.ts",
   "bin": {
     "unbuild": "./dist/cli.mjs"
   },

src/builder/mkdist.ts

@@ -20,7 +20,7 @@ export async function mkdistBuild(ctx: BuildContext) {
         distDir,
         format: entry.format,
         cleanDist: false,
-        declaration: entry.declaration,
+        declaration: !!entry.declaration,
         pattern: entry.pattern,
         // @ts-ignore
         ext: entry.ext,

src/builder/rollup.ts

@@ -195,12 +195,17 @@ export async function rollupBuild(ctx: BuildContext) {
       chunkFileNames: (chunk) => getChunkFilename(ctx, chunk, "d.mts"),
     });
     // #endregion
-    // #region .d.ts for node10 compatibility
-    await typesBuild.write({
-      dir: resolve(ctx.options.rootDir, ctx.options.outDir),
-      entryFileNames: "[name].d.ts",
-      chunkFileNames: (chunk) => getChunkFilename(ctx, chunk, "d.ts"),
-    });
+    // #region .d.ts for node10 compatibility (TypeScript version < 4.7)
+    if (
+      ctx.options.declaration === true ||
+      ctx.options.declaration === "compatible"
+    ) {
+      await typesBuild.write({
+        dir: resolve(ctx.options.rootDir, ctx.options.outDir),
+        entryFileNames: "[name].d.ts",
+        chunkFileNames: (chunk) => getChunkFilename(ctx, chunk, "d.ts"),
+      });
+    }
     // #endregion
   }
 

src/types.ts

@@ -20,7 +20,7 @@ export interface BaseBuildEntry {
   input: string;
   name?: string;
   outDir?: string;
-  declaration?: boolean;
+  declaration?: "compatible" | "node16" | boolean;
 }
 
 export interface UntypedBuildEntry extends BaseBuildEntry {
@@ -64,7 +64,14 @@ export interface BuildOptions {
   rootDir: string;
   entries: BuildEntry[];
   clean: boolean;
-  declaration?: boolean;
+  /**
+   * * `compatible` means "src/index.ts" will generate "dist/index.d.mts", "dist/index.d.cts" and "dist/index.d.ts".
+   * * `node16` means "src/index.ts" will generate "dist/index.d.mts" and "dist/index.d.cts".
+   * * `true` is equivalent to `compatible`.
+   * * `false` will disable declaration generation.
+   * * `undefined` will auto detect based on "package.json". If "package.json" has "types" field, it will be `"compatible"`, otherwise `false`.
+   */
+  declaration?: "compatible" | "node16" | boolean;
   outDir: string;
   stub: boolean;
   externals: (string | RegExp)[];