rolldown-plugin-dts 0.15.0 → 0.15.1

package/README.md

@@ -91,11 +91,19 @@ Resolve external types used in `.d.ts` files from `node_modules`.
 > [!NOTE]
 > These options are only applicable when `oxc` and `tsgo` are not enabled.
 
+#### `build`
+
+Build mode for the TypeScript compiler:
+
+- If `true`, the plugin will use [`tsc -b`](https://www.typescriptlang.org/docs/handbook/project-references.html#build-mode-for-typescript) to build the project and all referenced projects before emitting `.d.ts` files.
+- If `false`, the plugin will use [`tsc`](https://www.typescriptlang.org/docs/handbook/compiler-options.html) to emit `.d.ts` files without building referenced projects.
+
+**Default:** `false`
+
 #### `incremental`
 
 Controls how project references and incremental builds are handled:
 
-- If your `tsconfig.json` uses [`references`](https://www.typescriptlang.org/tsconfig/#references), the plugin will use [`tsc -b`](https://www.typescriptlang.org/docs/handbook/project-references.html#build-mode-for-typescript) to build the project and all referenced projects before emitting `.d.ts` files.
 - If `incremental` is `true`, all built files (including [`.tsbuildinfo`](https://www.typescriptlang.org/tsconfig/#tsBuildInfoFile)) will be written to disk, similar to running `tsc -b` in your project.
 - If `incremental` is `false`, built files are kept in memory, minimizing disk usage.
 

package/dist/{index-D_X_vGiL.d.ts → index-BPD4iQBs.d.ts}

@@ -12,6 +12,7 @@ interface TscOptions {
   tsconfig?: string;
   tsconfigRaw: TsConfigJson;
   cwd: string;
+  build: boolean;
   incremental: boolean;
   entries?: string[];
   id: string;

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { TsConfigJson } from "get-tsconfig";
 import { Plugin } from "rolldown";
 
 //#region src/options.d.ts
-interface Options {
+interface GeneralOptions {
   /**
   * The directory in which the plugin will search for the `tsconfig.json` file.
   */
@@ -37,6 +37,31 @@ interface Options {
   */
   tsconfigRaw?: Omit<TsConfigJson, "compilerOptions">;
   /**
+  * Override the `compilerOptions` specified in `tsconfig.json`.
+  *
+  * @see https://www.typescriptlang.org/tsconfig/#compilerOptions
+  */
+  compilerOptions?: TsConfigJson.CompilerOptions;
+  /**
+  * If `true`, the plugin will generate declaration maps (`.d.ts.map`) for `.d.ts` files.
+  */
+  sourcemap?: boolean;
+  /**
+  * Resolve external types used in `.d.ts` files from `node_modules`.
+  */
+  resolve?: boolean | (string | RegExp)[];
+}
+interface TscOptions {
+  /**
+  * Build mode for the TypeScript compiler:
+  *
+  * - If `true`, the plugin will use [`tsc -b`](https://www.typescriptlang.org/docs/handbook/project-references.html#build-mode-for-typescript) to build the project and all referenced projects before emitting `.d.ts` files.
+  * - If `false`, the plugin will use [`tsc`](https://www.typescriptlang.org/docs/handbook/compiler-options.html) to emit `.d.ts` files without building referenced projects.
+  *
+  * @default false
+  */
+  build?: boolean;
+  /**
   * If your tsconfig.json has
   * [`references`](https://www.typescriptlang.org/tsconfig/#references) option,
   * `rolldown-plugin-dts` will use [`tsc
@@ -67,27 +92,6 @@ interface Options {
   */
   incremental?: boolean;
   /**
-  * Override the `compilerOptions` specified in `tsconfig.json`.
-  *
-  * @see https://www.typescriptlang.org/tsconfig/#compilerOptions
-  */
-  compilerOptions?: TsConfigJson.CompilerOptions;
-  /**
-  * If `true`, the plugin will generate `.d.ts` files using Oxc,
-  * which is significantly faster than the TypeScript compiler.
-  *
-  * This option is automatically enabled when `isolatedDeclarations` in `compilerOptions` is set to `true`.
-  */
-  oxc?: boolean | Omit<IsolatedDeclarationsOptions, "sourcemap">;
-  /**
-  * If `true`, the plugin will generate declaration maps (`.d.ts.map`) for `.d.ts` files.
-  */
-  sourcemap?: boolean;
-  /**
-  * Resolve external types used in `.d.ts` files from `node_modules`.
-  */
-  resolve?: boolean | (string | RegExp)[];
-  /**
   * If `true`, the plugin will generate `.d.ts` files using `vue-tsc`.
   */
   vue?: boolean;
@@ -103,15 +107,6 @@ interface Options {
   */
   eager?: boolean;
   /**
-  * **[Experimental]** Enables DTS generation using `tsgo`.
-  *
-  * To use this option, make sure `@typescript/native-preview` is installed as a dependency.
-  *
-  * **Note:** This option is not yet recommended for production environments.
-  * `tsconfigRaw` and `isolatedDeclarations` options will be ignored when this option is enabled.
-  */
-  tsgo?: boolean;
-  /**
   * If `true`, the plugin will create a new isolated context for each build,
   * ensuring that previously generated `.d.ts` code and caches are not reused.
   *
@@ -132,6 +127,24 @@ interface Options {
   */
   emitJs?: boolean;
 }
+interface Options extends GeneralOptions, TscOptions {
+  /**
+  * If `true`, the plugin will generate `.d.ts` files using Oxc,
+  * which is significantly faster than the TypeScript compiler.
+  *
+  * This option is automatically enabled when `isolatedDeclarations` in `compilerOptions` is set to `true`.
+  */
+  oxc?: boolean | Omit<IsolatedDeclarationsOptions, "sourcemap">;
+  /**
+  * **[Experimental]** Enables DTS generation using `tsgo`.
+  *
+  * To use this option, make sure `@typescript/native-preview` is installed as a dependency.
+  *
+  * **Note:** This option is not yet recommended for production environments.
+  * `tsconfigRaw` and `isolatedDeclarations` options will be ignored when this option is enabled.
+  */
+  tsgo?: boolean;
+}
 type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
 type OptionsResolved = Overwrite<Required<Omit<Options, "compilerOptions">>, {
   tsconfig: string | undefined;
@@ -140,21 +153,22 @@ type OptionsResolved = Overwrite<Required<Omit<Options, "compilerOptions">>, {
 }>;
 declare function resolveOptions({
   cwd,
+  dtsInput,
+  emitDtsOnly,
   tsconfig,
-  incremental,
-  compilerOptions,
   tsconfigRaw: overriddenTsconfigRaw,
-  oxc,
+  compilerOptions,
   sourcemap,
-  dtsInput,
-  emitDtsOnly,
   resolve,
+  build,
+  incremental,
   vue,
   parallel,
   eager,
-  tsgo,
   newContext,
-  emitJs
+  emitJs,
+  oxc,
+  tsgo
 }: Options): OptionsResolved;
 //#endregion
 //#region src/fake-js.d.ts
@@ -167,6 +181,7 @@ declare function createFakeJsPlugin({
 declare function createGeneratePlugin({
   tsconfig,
   tsconfigRaw,
+  build,
   incremental,
   cwd,
   oxc,
@@ -177,7 +192,7 @@ declare function createGeneratePlugin({
   tsgo,
   newContext,
   emitJs
-}: Pick<OptionsResolved, "cwd" | "tsconfig" | "tsconfigRaw" | "incremental" | "oxc" | "emitDtsOnly" | "vue" | "parallel" | "eager" | "tsgo" | "newContext" | "emitJs">): Plugin;
+}: Pick<OptionsResolved, "cwd" | "tsconfig" | "tsconfigRaw" | "build" | "incremental" | "oxc" | "emitDtsOnly" | "vue" | "parallel" | "eager" | "tsgo" | "newContext" | "emitJs">): Plugin;
 //#endregion
 //#region src/index.d.ts
 declare function dts(options?: Options): Plugin[];

package/dist/index.js

@@ -639,7 +639,7 @@ const spawnAsync = (...args) => new Promise((resolve, reject) => {
 	child.on("close", () => resolve());
 	child.on("error", (error) => reject(error));
 });
-function createGeneratePlugin({ tsconfig, tsconfigRaw, incremental, cwd, oxc, emitDtsOnly, vue, parallel, eager, tsgo, newContext, emitJs }) {
+function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd, oxc, emitDtsOnly, vue, parallel, eager, tsgo, newContext, emitJs }) {
 	const dtsMap = /* @__PURE__ */ new Map();
 	/**
 	* A map of input id to output file name
@@ -765,6 +765,7 @@ function createGeneratePlugin({ tsconfig, tsconfigRaw, incremental, cwd, oxc, em
 					const options = {
 						tsconfig,
 						tsconfigRaw,
+						build,
 						incremental,
 						cwd,
 						entries,
@@ -827,7 +828,7 @@ async function runTsgo(root, tsconfig) {
 //#endregion
 //#region src/options.ts
 let warnedTsgo = false;
-function resolveOptions({ cwd = process.cwd(), tsconfig, incremental = false, compilerOptions = {}, tsconfigRaw: overriddenTsconfigRaw = {}, oxc, sourcemap, dtsInput = false, emitDtsOnly = false, resolve = false, vue = false, parallel = false, eager = false, tsgo = false, newContext = false, emitJs }) {
+function resolveOptions({ cwd = process.cwd(), dtsInput = false, emitDtsOnly = false, tsconfig, tsconfigRaw: overriddenTsconfigRaw = {}, compilerOptions = {}, sourcemap, resolve = false, build = false, incremental = false, vue = false, parallel = false, eager = false, newContext = false, emitJs, oxc, tsgo = false }) {
 	let resolvedTsconfig;
 	if (tsconfig === true || tsconfig == null) {
 		const { config, path: path$1 } = getTsconfig(cwd) || {};
@@ -867,20 +868,21 @@ function resolveOptions({ cwd = process.cwd(), tsconfig, incremental = false, co
 	}
 	return {
 		cwd,
+		dtsInput,
+		emitDtsOnly,
 		tsconfig,
 		tsconfigRaw,
-		incremental,
-		oxc,
 		sourcemap,
-		dtsInput,
-		emitDtsOnly,
 		resolve,
+		build,
+		incremental,
 		vue,
 		parallel,
 		eager,
-		tsgo,
 		newContext,
-		emitJs
+		emitJs,
+		oxc,
+		tsgo
 	};
 }
 

package/dist/{tsc-BjWJCGE1.js → tsc-BSxLVaDe.js}

@@ -177,11 +177,11 @@ function parseTsconfig(tsconfigPath, fsSystem) {
 	if (diagnostics.length) throw new Error(`[rolldown-plugin-dts] Unable to read ${tsconfigPath}: ${ts.formatDiagnostics(diagnostics, formatHost)}`);
 	return parsedConfig;
 }
-function createTsProgram({ entries, id, tsconfig, tsconfigRaw, incremental, vue, cwd, context = globalContext }) {
+function createTsProgram({ entries, id, tsconfig, tsconfigRaw, build, incremental, vue, cwd, context = globalContext }) {
 	const fsSystem = createFsSystem(context.files);
 	const baseDir = tsconfig ? path.dirname(tsconfig) : cwd;
 	const parsedConfig = ts.parseJsonConfigFileContent(tsconfigRaw, fsSystem, baseDir);
-	if (tsconfig && parsedConfig.projectReferences?.length) {
+	if (tsconfig && build) {
 		const projectPaths = buildSolution(tsconfig, incremental, context);
 		debug(`collected projects: ${JSON.stringify(projectPaths)}`);
 		const project = findProjectContainingFile(projectPaths, id, fsSystem);

package/dist/tsc-worker.d.ts

@@ -1,5 +1,5 @@
 import "./context-DIRjVfC4.js";
-import { tscEmit } from "./index-D_X_vGiL.js";
+import { tscEmit } from "./index-BPD4iQBs.js";
 
 //#region src/tsc/worker.d.ts
 declare const functions: {

package/dist/tsc-worker.js

@@ -1,5 +1,5 @@
 import "./context-BG0dlajy.js";
-import { tscEmit } from "./tsc-BjWJCGE1.js";
+import { tscEmit } from "./tsc-BSxLVaDe.js";
 import process from "node:process";
 import { createBirpc } from "birpc";
 

package/dist/tsc.d.ts

@@ -1,3 +1,3 @@
 import "./context-DIRjVfC4.js";
-import { TscModule, TscOptions, TscResult, tscEmit } from "./index-D_X_vGiL.js";
+import { TscModule, TscOptions, TscResult, tscEmit } from "./index-BPD4iQBs.js";
 export { TscModule, TscOptions, TscResult, tscEmit };

package/dist/tsc.js

@@ -1,4 +1,4 @@
 import "./context-BG0dlajy.js";
-import { tscEmit } from "./tsc-BjWJCGE1.js";
+import { tscEmit } from "./tsc-BSxLVaDe.js";
 
 export { tscEmit };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rolldown-plugin-dts",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "A Rolldown plugin to bundle dts files",
   "type": "module",
   "license": "MIT",