But these type definitions describe the JavaScript API of Mapbox GL, not every asset distributed with the package.

For example, TypeScript can understand Mapbox's JavaScript API:

import mapboxgl from 'mapbox-gl'

but that doesn't automatically tell TypeScript what to do with:

import 'mapbox-gl/dist/mapbox-gl.css'

The CSS file is a static asset, not a TypeScript module containing type declarations.

Therefore, you need to tell TypeScript how to handle CSS imports.

How to Fix TypeScript CSS Import Errors

The most common solution is to create an ambient module declaration for CSS files.

Create a file called:

global.d.ts

Then add: