v2.0.0

This is a major version bump. The library went a long time without updates while Mapbox GL JS,
MapLibre GL JS, and SolidJS all moved forward — bringing it current required breaking some things
on purpose rather than silently.

Breaking Changes

• Default map container styling changed. <MapGL>'s container div used to default to
  position: absolute; inset: 0; z-index: -1 (full-bleed, behind sibling content) unless you
  supplied class/classList/style, in which case the entire default was dropped. It now
  defaults to a plain, in-flow width: 100%; height: 100%, and a supplied class/classList/
  style layers on top of that minimal default instead of replacing it outright.
  Migrate: if you relied on the map auto-filling a positioned ancestor as a full-bleed
  background layer, add that explicitly: <MapGL style={{ position: "absolute", inset: 0, "z-index": -1 }} ... />. If you already supplied your own class/style, check it doesn't
  conflict with the new additive width: 100%; height: 100% default.

• window.MapLib global removed. MapGL used to stash whichever library it loaded on
  window.MapLib (never documented, but reachable). The active library (and an isMapLibre flag)
  is now exposed through Solid context instead. Migrate: replace window.MapLib.SomeClass
  reads with ctx.mapLib.SomeClass, where const [ctx] = useMapContext() — ctx.mapLib and
  ctx.isMapLibre are new keys alongside the existing ctx.map.

• Peer dependency ranges are now enforced. mapbox-gl and solid-js used to be unbounded
  ("*"). Now: mapbox-gl: ^3.0.0, maplibre-gl: ^4.0.0 || ^5.0.0 || ^6.0.0 (added as a
  first-class peer instead of only usable via mapLib), solid-js: ^1.8.0 <2.0.0. Both
  mapbox-gl/maplibre-gl are marked optional in peerDependenciesMeta, since a consumer only
  ever needs one. Migrate: if you're pinned to mapbox-gl v1.x/v2.x, upgrade alongside
  solid-map-gl or stay on the last pre-upgrade version. Peer-dependency mismatches are warnings,
  not install-blocking errors, under npm 7+/pnpm/yarn — a newer major than declared will still
  install, just with a warning.

• config prop no longer throws on MapLibre — it silently no-ops instead. Passing config
  while using MapLibre used to throw TypeError: map.setConfigProperty is not a function from
  inside a reactive effect. It's now feature-detected and ignored (with a debug() log if
  debug/debugEvents is enabled), since MapLibre has no equivalent to Mapbox's Standard Style
  config system. Migrate: nothing required.

• Draw's showLength/showArea props now actually work. These props existed but did
  nothing — the custom draw modes that read them were imported but never wired into Draw's
  modes map. They now produce real, live length/area labels while drawing lines, polygons, and
  rectangles. Draw also registers four extra opt-in modes with no built-in equivalent:
  multi_point, radius, rectangle, rectangle_assisted (activate via
  draw.changeMode(...)). Migrate: if you were already passing showLength/showArea
  (previously inert), your drawn UI will now show measurement labels — remove the props if you
  don't want that.

• Atmosphere's style prop shape now distinguishes Mapbox Fog from MapLibre Sky.
  style is now typed as FogSpecification | MapLibreSky, and Atmosphere branches on
  ctx.isMapLibre to call map.setFog(...) (Mapbox) or map.setSky(...) (MapLibre) with the
  correct shape. Migrate: Mapbox-only users see no change. MapLibre users who were passing
  Mapbox-shaped Fog properties (previously inert) need to switch to MapLibre's sky property
  names (sky-color, horizon-color, fog-color, atmosphere-blend, ...).

• Control type="traffic" / type="language" removed from the documented type union.
  These were documented but never implemented — passing either value threw new undefined(...)
  at runtime. Docs now only list implemented types (navigation, scale, attribution,
  fullscreen, geolocate, logo, terrain). Migrate: use the custom prop with a
  manually-constructed instance, e.g. <Control custom={new MapboxTraffic()} />.

Fixed

• Terrain's MapLibre-specific DEM defaults now actually take effect — the flag they branched on
  (isMapLibre) was never set, so every Terrain silently used Mapbox's DEM source regardless of
  which library was active.
• Light is no longer dropped on a base-style swap (e.g. toggling mb:dark → mb:light, or
  dark-mode auto-switching).
• Source's cached getSource() handle no longer goes stale after a base-style swap — every
  reactive update now fetches a fresh handle instead of mutating a detached Style's source
  object.
• Source's reactive data/url/tiles updates are no longer silently dropped when the source
  happens to be mid-tiling at the instant the effect runs.
• Restoring app layers after a base-style swap no longer clobbers another layer sharing the same
  beforeType/beforeId anchor (an off-by-one in insertLayers).
• Draw on MapLibre: keyboard shortcuts (Delete/Backspace/1/2/3) and native-looking control
  styling now work — both were silently broken because mapbox-gl-draw reads Mapbox's CSS class
  names internally. Mouse-driven drawing itself was unaffected either way.

Added

• DeckOverlay component for integrating deck.gl layers on top of the map. You supply the
  overlay class (MapboxOverlay/MapLibreOverlay); solid-map-gl never imports @deck.gl/*
  itself, not even as an optional peer.
• Expanded config prop support for the full Mapbox Standard/Standard Satellite schema (3D
  toggles, theme, ~20 color overrides).
• TypeDoc-generated API reference, committed under docs/api/.

Changed (non-breaking)

• Deep mapbox-gl/src/... type imports replaced with mapbox-gl's own public top-level types;
  @types/mapbox-gl dropped (it had become an empty stub). Only affects unsupported deep imports
  of solid-map-gl's own internals, not normal import MapGL, { Viewport } from "solid-map-gl"
  usage.
• import.meta.env.VITE_MAPBOX_ACCESS_TOKEN / VITE_VECTOR_API_KEY / VITE_RASTER_API_KEY
  auto-detection is now guarded so non-Vite bundlers no longer crash when no explicit
  apikey/accessToken is passed.
• Build output (dist/) structure changed: moved from rollup-preset-solid to
  tsup-preset-solid. dist/ is now three flat, fully bundled files instead of the old
  per-file source tree. The public solid-map-gl entry point and its exports conditions are
  unaffected — only undocumented deep imports like solid-map-gl/dist/esm/... could break.
  mapbox-gl.css's import is now left external for the consumer's own bundler to resolve.
• Live examples moved from ~30 separately hand-maintained external StackBlitz projects into
  examples/ in this repo, linked via stackblitz.com/fork/github/... instead.