{"id":25277,"library":"esbuild-dts-path-alias","title":"esbuild-dts-path-alias","description":"esbuild plugin for compiling TypeScript declaration files (.d.ts) with path alias transformation. Version 4.2.1 (latest) requires esbuild ^0.17.0, TypeScript >=5, and Node >=16.10.0. It resolves path aliases like '@utils/foo' into relative import paths in the output .d.ts files, solving a common pain point when using path aliases in TypeScript projects. It offers configurable tsconfig path, output directory, and debug logging. As a fork of esbuild-plugin-d-ts-alias, it maintains compatibility with recent esbuild and TypeScript versions. The plugin is ESM-only and ships TypeScript declarations.","status":"active","version":"4.2.1","language":"javascript","source_language":"en","source_url":"https://github.com/ArtemKlyuev/esbuild-plugin-d-ts-path-alias","tags":["javascript","typescript","compiler","esbuild","plugin","declaration","dts"],"install":[{"cmd":"npm install esbuild-dts-path-alias","lang":"bash","label":"npm"},{"cmd":"yarn add esbuild-dts-path-alias","lang":"bash","label":"yarn"},{"cmd":"pnpm add esbuild-dts-path-alias","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency - provides the build system and plugin API at ^0.17.0, ^0.18.0, or ^0.21.0","package":"esbuild","optional":false},{"reason":"Peer dependency - required for TypeScript declaration compilation, >=5.0","package":"typescript","optional":false}],"imports":[{"note":"Package is ESM-only since v4.0.0. CommonJS require() will fail in Node ESM contexts.","wrong":"const dTSPathAliasPlugin = require('esbuild-plugin-d-ts-path-alias')","symbol":"dTSPathAliasPlugin","correct":"import { dTSPathAliasPlugin } from 'esbuild-plugin-d-ts-path-alias'"},{"note":"The plugin also supports default export for convenience, but named export is recommended for consistency.","wrong":"","symbol":"dTSPathAliasPlugin (default export)","correct":"import dTSPathAliasPlugin from 'esbuild-plugin-d-ts-path-alias'"},{"note":"Type-only import for TypeScript users. PluginConfig includes tsconfigPath, outputPath, and debug options.","wrong":"","symbol":"PluginConfig (type)","correct":"import type { PluginConfig } from 'esbuild-plugin-d-ts-path-alias'"}],"quickstart":{"code":"import { build } from 'esbuild';\nimport { dTSPathAliasPlugin } from 'esbuild-plugin-d-ts-path-alias';\n\nbuild({\n  entryPoints: ['./src/index.ts'],\n  outfile: './dist/index.js',\n  bundle: true,\n  format: 'esm',\n  target: 'es2020',\n  plugins: [dTSPathAliasPlugin()],\n}).catch(() => process.exit(1));","lang":"typescript","description":"Demonstrates basic usage: include the plugin in esbuild build config to transform path aliases in .d.ts files."},"warnings":[{"fix":"Upgrade TypeScript to >=5 and esbuild to >=0.17.0, and Node to >=16.10.0.","message":"Version 3.0.0 dropped support for TypeScript <5 and esbuild <0.17.0.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Use dynamic import() or switch to ESM project configuration. For CommonJS require, pin to v3.x.","message":"Version 4.0.0 changed to ESM-only package (type:module in package.json).","severity":"breaking","affected_versions":">=4.0.0"},{"fix":"Monitor the GitHub repository for updates or consider forking as needed.","message":"The original plugin was forked without indication of upstream changes. Check for newer versions.","severity":"deprecated","affected_versions":"any"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Switch to ESM (set type: module in package.json or use .mjs extension) and use import syntax.","cause":"Using CommonJS require() to load an ESM-only package (v4+).","error":"require() of ES Module esbuild-plugin-d-ts-path-alias from node_modules not supported"},{"fix":"Install the package: npm install esbuild-plugin-d-ts-path-alias --save-dev. Ensure tsconfig.json has \"moduleResolution\": \"node16\" or \"bundler\".","cause":"Missing installation or wrong import path when using TypeScript with strict moduleResolution.","error":"Cannot find module 'esbuild-plugin-d-ts-path-alias' or its corresponding type declarations"},{"fix":"Provide explicit tsconfigPath option to dTSPathAliasPlugin({ tsconfigPath: './path/to/tsconfig.json' }) or ensure default tsconfig.json exists at project root.","cause":"The plugin cannot locate tsconfig.json, or a custom tsconfigPath is incorrect.","error":"Error: tsconfig.json not found"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}