Dependency Versions
ESLint
The version range of ESLint currently supported is
^8.57.0 || ^9.0.0
.
We generally support at least the latest two major versions of ESLint; though sometimes we may restrict this if the APIs change too much between major releases.
Node
The version range of NodeJS currently supported is
^18.18.0 || ^20.9.0 || >=21.1.0
.
We make an effort to support Active LTS and Maintenance LTS release statuses of Node according toNode's release document.Support for specific Current status releases are considered periodically.
TypeScript
The version range of TypeScript currently supported is
>=4.8.4 <5.9.0
.
We mirrorDefinitelyTyped's version support window - meaning we only support versions of TypeScript less than 2 years old.
You may find that our tooling works on older TypeScript versions however we provide no guarantees andwe will not accept issues against unsupported versions.
We will always endeavor to support the latest stable version of TypeScript.Sometimes, but not always, changes in TypeScript will not require breaking changes in this project, and so we are able to support more than one version of TypeScript.In some cases, we may even be able to support additional pre-releases (i.e. betas and release candidates) of TypeScript, but only if doing so does not require us to compromise on support for the latest stable version.
Supporting New TypeScript Releases
With each new TypeScript release we file an issue to track the changes in the new version. The issue should always be pinned, and you can alsofind the issues by searching for issues tagged with "New TypeScript Version". If the issue is open, we do not have official support yet - please be patient.
In terms of what versions we support:
- We do not support the
beta
releases. - Wegenerally do not officially support the
rc
releases. - We endeavor to support the latest stable TypeScript versions as soon as possible after the release.
Generally we will begin working on supporting the next release when therc
version is released.
Version Warning Logs
Note that our packages have an openpeerDependency
requirement in order to allow for experimentation on newer/beta versions of TypeScript.
If you use a non-supported version of TypeScript, the parser will log a warning to the console.If you want to disable this warning, you can configure this in yourparserOptions
.See:Packages > Parser >warnOnUnsupportedTypeScriptVersion
.
Dependant Version Upgrades
SeeMaintenance > Dependent Version Upgrades for maintenance steps to update these versions.