@un-fao/map

Experimental browser map primitives for Data Explorer. This is a review release: its API and package contract may change before a stable release.

Install

Install the review tag and its required peers:

npm install @un-fao/map@review [email protected] \
  [email protected] [email protected] [email protected]

For a reproducible review, replace @review with @0.1.0-review.0. npm may also point latest to this version when the new package is first created, so use the review tag or exact version instead of a bare package install.

Use

import { MapViewport, defaultMapStyle } from '@un-fao/map';

export function View() {
  return (
    <MapViewport
      initialViewState={{ longitude: 12.5, latitude: 41.9, zoom: 6 }}
      mapStyle={defaultMapStyle}
    />
  );
}

The package has one public entry with four exports: defaultMapStyle, MapViewport, MapViewportProps, and MapViewportRef. The entry supplies MapLibre CSS automatically for the verified Vite consumer; do not import that CSS again for this setup.

Verified review boundary

The package is browser/client ESM. This release is verified with MapLibre 5.21.1, React and React DOM 19.2.4, react-map-gl 8.1.0, Vite 8.0.3, npm 11.17.0 using its default hoisted installation, and TypeScript consumer checking with moduleResolution: "Bundler" and skipLibCheck: true. The published peer ranges remain broader than this one verified tuple.

The linked source repository is currently private and is expected to become public later. Other runtimes, bundlers, package managers, server rendering, and full dependency-declaration checking are unverified rather than known to be incompatible.