feat(dts): support dts.alias

[Timeless0911]

Summary

dts.alias

• Type: Record<string, string>
• Default: {}

Configure the path alias for declaration files.

dts.alias will be merged with compilerOptions.paths configured in tsconfig.json and dts.alias has a higher priority.

In most cases, you don't need to use dts.alias, but consider using it when you need to use path alias only in declaration files without wanting to affect JavaScript outputs. For example, map the declaration file of foo to ./compiled/foo.

export default {
  lib: [
    {
      // [!code highlight:5]
      dts: {
        alias: {
          foo: './compiled/foo',
        },
      },
    },
  ],
};

Related Links

Checklist

• Tests updated (or not required).
• Documentation updated (or not required).

[Copilot]

Pull Request Overview

This PR adds support for a new dts.alias configuration option that allows configuring path aliases specifically for TypeScript declaration files. The feature enables users to set path aliases that only affect declaration file generation without impacting JavaScript output.

• Adds a new dts.alias configuration option of type Record<string, string>
• Implements merging logic that combines dts.alias with tsconfig.json paths, with dts.alias taking higher priority
• Updates documentation in both English and Chinese to explain the new feature

Reviewed Changes

Copilot reviewed 17 out of 19 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
packages/core/src/types/config.ts	Adds the alias property to the Dts type definition
packages/core/src/config.ts	Passes the dts.alias option to the DTS plugin configuration
packages/plugin-dts/src/index.ts	Adds alias parameter to PluginDtsOptions and initializes default value
packages/plugin-dts/src/dts.ts	Implements the alias merging logic with tsconfig paths
packages/plugin-dts/src/utils.ts	Adds utility function mergeAliasWithTsConfigPaths for merging aliases
packages/plugin-dts/src/tsc.ts	Updates function signatures to pass paths through the processing pipeline
packages/plugin-dts/README.md	Documents the new alias option with usage examples
website/docs/en/config/lib/dts.mdx	Adds English documentation for the new dts.alias configuration
website/docs/zh/config/lib/dts.mdx	Adds Chinese documentation for the new dts.alias configuration
website/docs/en/guide/advanced/dts.mdx	Updates the configuration table to include the new option
website/docs/zh/guide/advanced/dts.mdx	Updates the configuration table to include the new option
tests/integration/dts/bundle-false/alias/*	Adds integration test files for the new alias functionality

Files not reviewed (1)

• pnpm-lock.yaml: Language not supported

[netlify]

✅ Deploy Preview for rslib ready!

Name	Link
🔨 Latest commit	183eee2
🔍 Latest deploy log	https://app.netlify.com/projects/rslib/deploys/6888af1c6343c00008f38b1f
😎 Deploy Preview	https://deploy-preview-1135--rslib.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.