#lib.dts

• Type:

type Dts =
  | {
      bundle?: boolean | { bundledPackages?: string[] };
      distPath?: string;
      build?: boolean;
      abortOnError?: boolean;
      autoExtension?: boolean;
    }
  | boolean;

• Default: undefined

Configure the generation of the TypeScript declaration files.

#Boolean type

Declaration files generation is an optional feature, you can set dts: true to enable bundleless declaration files generation.

export default {
  lib: [
    {
      format: 'esm',
      dts: true,
    },
  ],
};

If you want to disable declaration files generation, you can set dts: false or do not specify the dts option.

export default {
  lib: [
    {
      format: 'esm',
      dts: false,
    },
  ],
};

#Object type

If you want to customize the declaration files generation, you can set the dts option to an object.

#dts.bundle

• Type: boolean | { bundledPackages?: string[] }
• Default: false

Whether to bundle the declaration files.

If you want to bundle declaration files files, you should:

1. Install @microsoft/api-extractor as a development dependency, which is the underlying tool used for bundling declaration files.

npm add @microsoft/api-extractor -D

2. Set dts.bundle to true.

export default {
  lib: [
    {
      format: 'esm',
      dts: {
        bundle: true,
      },
    },
  ],
};

#dts.bundle.bundledPackages

• Type: string[]

Specifies the dependencies whose declaration files should be bundled. This configuration is passed to the bundledPackages option of @microsoft/api-extractor.

By default, Rslib determines externalized dependencies based on the following configurations. For details, refer to Handle third-party dependencies.

• autoExternal configuration
• output.externals configuration

Direct dependencies (declared in package.json) that are not externalized will be automatically added to bundledPackages, and their declaration files will be bundled into the final output.

When the default behavior does not meet the requirements, you can explicitly specify the dependencies whose declaration files need to be bundled through dts.bundle.bundledPackages. After setting this configuration, the above default behavior will be completely overwritten.

This is typically used for bundling transitive dependencies (dependencies of direct dependencies). For example, if the project directly depends on foo, and foo depends on bar, you can bundle both foo and bar's declaration files as follows:

export default {
  lib: [
    {
      format: 'esm',
      dts: {
        bundle: {
          bundledPackages: ['foo', 'bar'],
        },
      },
    },
  ],
};

#dts.distPath

• Type: string

The output directory of declaration files.

#Default value

The default value follows the priority below:

1. The dts.distPath value in the current lib configuration.
2. The declarationDir value in the tsconfig.json file.
3. The output.distPath.root value in the current lib configuration.

#Example

export default {
  lib: [
    {
      format: 'esm',
      dts: {
        distPath: './dist-types',
      },
    },
  ],
};

#dts.build

• Type: boolean
• Default: false

Whether to generate declaration files with building the project references. This is equivalent to using the --build flag with the tsc command. See Project References for more details.

#dts.abortOnError

• Type: boolean
• Default: true

Whether to abort the build process when an error occurs during declaration files generation.

By default, type errors will cause the build to fail.

When abortOnError is set to false like below, the build will still succeed even if there are type issues in the code.

export default {
  lib: [
    {
      format: 'esm',
      dts: {
        abortOnError: false,
      },
    },
  ],
};

#dts.autoExtension

• Type: boolean
• Default: false

Whether to automatically set the declaration file extension based on the format option.

#Default extension

By default that when dts.autoExtension is false, the declaration file extension will be .d.ts.

When dts.autoExtension is set to true, the declaration file extension will be:

• .d.ts with esm format and .d.cts with cjs format when type: module in package.json.

• .d.ts with cjs format and .d.mts with esm format when type: commonjs or no type field in package.json.