tsconfig-paths loads Node modules based on the `paths` mappings in your `tsconfig.json` or `jsconfig.json`, translating module load requests into physical file paths that Node can resolve. It supports use at run-time (for example with `node -r tsconfig-paths/register` or `ts-node -r tsconfig-paths/register`) and via its API.
Project status
- The source appears to be in active development on GitHub (last upstream push was 2026-02-23), but the publicly documented library version updates shown here are from 2023-12-14 (v3.15.0) and earlier, so published updates are currently quiet relative to today (2026-06-09).
- Update cadence (based on the provided version history): several releases in 2022, then fewer in 2023 (notably v3.15.0 in Dec 2023). There is a long gap from the last listed update in 2023 to the current date.
AI summary generated 2026-06-09
Recent updates
v3.15.0
2023-12-14v3.15.0 adds support for using tsconfig `extends` as an array of strings, not just a single string. The implementation also improves error reporting when parsing invalid JSON5 and adjusts how `baseUrl` is resolved relative to extended configs.
Featuresv4.2.0
2023-03-29Version v4.2.0 updates tsconfig loading to support `tsconfig` `extends` as an array of strings. The change is implemented in `src/tsconfig-loader.ts` by adding new internal logic to load and merge multiple extended configs.
Featuresv3.14.2
2023-02-25Release v3.14.2 has no provided release notes. The code diff only shows a package version bump plus dependency and lockfile changes, with no application/source code modifications visible in the diff.
v4.1.2
2023-01-01Release v4.1.2 updates the project version and bumps the json5 dependency from 2.2.1 to 2.2.2. The only code-related change shown in the diff is the dependency upgrade, intended to address a known security issue.
Securityv4.1.1
2022-11-30Release v4.1.1 was published on 2022-11-30, but no release notes were provided by the publisher. As a result, the changelog cannot be verified for new features, breaking changes, bug fixes, security updates, or migrations.
v4.1.0
2022-08-06Version v4.1.0 expands tsconfig-paths runtime resolution to support nested package.json main field selectors, and updates public TypeScript types and docs accordingly. It also improves tsconfig JSON5 parsing error reporting by wrapping parse failures with a file-path-inclusive error message, and adds a Node engine constraint in package.json.
Featuresv4.0.0
2022-05-02GitHub release notes for v4.0.0 were not provided in the publisher's release payload. Based on repository documentation (CHANGELOG.md) and the actual code diff, this version adds jsconfig.json support, adds a cwd override to the register flow, and changes path resolution to support absolute paths in tsconfig paths and absolute baseUrl values. Several type and default-behavior changes are present in code but are not clearly documented in the release notes payload.
Featuresv3.14.1
2022-03-22Release v3.14.1 does not include publisher-provided release notes, and the diff shows no changes to the library source code itself. The update is primarily a dependency refresh, notably upgrading the runtime dependency minimist to address a prototype pollution issue, plus several dev tooling and lockfile updates.
Securityv3.14.0
2022-03-13v3.14.0 introduces support for tsconfig path mappings whose pattern starts with a slash (for example, '/opt/*'). The core implementation change is in getPathsToTry, plus a new unit test covering these slash-prefixed mapping patterns. Release notes were not provided by the publisher, so the behavioral changes below may not be communicated to consumers.
BreakingFeaturesv3.13.0
2022-03-03Release v3.13.0 was published on 2022-03-03. No release notes were provided by the publisher, so there is no documented information about new features, fixes, breaking changes, or dependency updates for this version.