visgl / visgl/react-map-gl

[Feat] TypeScript 6.0 compatibility via gl-matrix@3.4.4

Open
#2,561 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

feature
Dominant language
TypeScript
Stars
8.5k
Forks
1.4k
Avg merge
5d 17h
Merged PRs (30d)
3

Description

Target Use Case

react-map-gl is currently not compatible with the upcoming TypeScript 6.0 release.

In Q4 2025, TypeScript 6.0 plans to drop support for module-keyword namespaces.

TypeScript ecosystem testing identified that react-map-gl is not compatible with this change due to a transitive dependency on gl-matrix <3.4.4 that uses legacy namespaces. The dependencies have now all been fixed. So the only remaining work is to bump the versions of those dependencies.

Proposal

react-map-gl has three transitive routes to depend on the problematic gl-matrix:

The following package versions have already been made compatible with TS 6.0:

  • gl-matrix@3.4.4
  • mapbox-gl@3.15.0
  • maplibre-gl@5.7.0

Please bump the existing dependencies to use these minimum versions.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with package.json, modules/react-mapbox/package.json, and modules/react-maplibre/package.json, then inspect the dependency tree for the three transitive gl-matrix routes. Update the existing dependency declarations to the minimum compatible versions listed in the issue and verify that all routes resolve to TypeScript 6.0-compatible packages.

Written by the indexing model from the issue text.

Assessment

Tech stack
react, typescript
Domain
build-system, frontend
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.