Skip to main content

Dependency Versions

ESLint

The version range of ESLint currently supported is ^9.3.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 to Node'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.6.0.

We mirror DefinitelyTyped'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 and we 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 also find 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.
  • We generally 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 the rc version is released.

Version Warning Logs

Note that our packages have an open peerDependency 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 your parserOptions. See: Packages > Parser > warnOnUnsupportedTypeScriptVersion.

Dependant Version Upgrades

See Maintenance > Dependent Version Upgrades for maintenance steps to update these versions.