@hexagoneui/core

Brique bas-niveau de Hexagone UI — « shadcn/ui pour la cartographie française ».

Hooks et composants React drop-in, câblés sur les données officielles françaises (IGN/Géoplateforme, BAN), rendus avec MapLibre GL JS.

Ce package absorbe les quirks de l'API Géoplateforme (post-bascule wxs.ign.fr → data.geopf.fr) pour que les composants de plus haut niveau n'aient pas à s'en soucier.

Installation

pnpm add @hexagoneui/core maplibre-gl react react-dom

react, react-dom et maplibre-gl sont des peerDependencies.

Exports

| Import | Contenu | |---|---| | @hexagoneui/core | tout (ré-export) | | @hexagoneui/core/geoplateforme | useGeoplateforme, helpers WFS/WMTS, constantes | | @hexagoneui/core/geocode | useGeocodeFR (BAN) | | @hexagoneui/core/components | <MapFR>, <AddressSearch>, <LayerControl> |

Hooks

useGeoplateforme()

Construit les sources/styles MapLibre pour n'importe quelle ressource data.geopf.fr et gère les quirks WFS.

const { getWMTSSource, getWFSFeatures, getStyle } = useGeoplateforme();
const features = await getWFSFeatures(
  "CADASTRALPARCELS.PARCELLAIRE_EXPRESS:parcelle",
  bbox,
);

useGeocodeFR()

Géocodage + autocomplétion sur la Base Adresse Nationale.

const { suggestions, geocode, reverse } = useGeocodeFR();
const [match] = await geocode("12 rue de Rivoli, Paris");
// { label, lat, lon, citycode, postcode, score, parcelId? }

Composants

import { MapFR, AddressSearch, LayerControl } from "@hexagoneui/core/components";

<MapFR basemap="plan-ign" center={[2.35, 48.85]} zoom={12} attribution>
  <AddressSearch onSelect={(r) => {}} />
  <LayerControl position="top-right" collapsible />
</MapFR>;

Les quirks Géoplateforme gérés ici

• Le bbox de l'objet n'est plus dans properties → param global bbox sur /wfs.
• geometry_name vaut désormais geom (et non the_geom/geometrie).
• Anciennes URLs wxs.ign.fr mortes → tout passe par data.geopf.fr.
• Service d'autoconfiguration déprécié → constantes en dur dans geoplateforme/constants.ts.

MIT © geekles