@element-editor/adapter-maplibre 0.0.0-stage → 0.2.1

package/dist/src/basemaps/index.d.ts

@@ -0,0 +1,3 @@
+export { resolveBasemap, loadBasemapStyle, setBasemap, DEFAULT_GLYPHS_URL, DEFAULT_SPRITE_URL } from './style.js';
+export type { BasemapInput, BuiltinBasemapId, BasemapNetwork } from './style.js';
+export { BASEMAPS } from './catalog.js';

package/dist/src/basemaps/style.d.cts

@@ -0,0 +1,61 @@
+import { Map as MapLibreMap, StyleSpecification } from 'maplibre-gl';
+import { BasemapIds } from '../basemapIds.cjs';
+import { NetworkConfig } from '@element-editor/core';
+/** The map-tile part of `config.network` (what the basemap styles read). */
+export type BasemapNetwork = Pick<NetworkConfig, 'vectorTiles' | 'dem' | 'osmRaster' | 'glyphs' | 'sprite'>;
+export type BuiltinBasemapId = 'streets' | 'terrain' | 'light' | 'dark' | 'osm';
+/**
+ * A built-in id, `'auto'`, a MapLibre style (URL or object) or a raster `{ url }`. `id` names a
+ * custom entry in the picker and in the remembered pick; give every style object one (two
+ * id-less style objects can't be told apart).
+ */
+export type BasemapInput = BuiltinBasemapId | 'auto' | {
+    style: string | StyleSpecification;
+    id?: string;
+    label?: string;
+    thumbnail?: string;
+} | {
+    url: string;
+    attribution: string;
+    maxZoom?: number;
+    id?: string;
+    label?: string;
+    thumbnail?: string;
+};
+type Theme = 'light' | 'dark';
+type Resolved = Exclude<BasemapInput, 'auto'>;
+/** Only `'auto'` changes: light theme -> streets, dark theme -> dark. */
+export declare function resolveBasemap(input: BasemapInput, theme: Theme): Resolved;
+export declare const DEFAULT_GLYPHS_URL = "https://tiles.openfreemap.org/fonts/{fontstack}/{range}.pbf";
+/** Default sprite (custom `*-badge` icons OpenFreeMap lacks), served from jsDelivr at the package's own version. */
+export declare const DEFAULT_SPRITE_URL: string;
+/**
+ * Raw style JSON (sources + layers) -> full MapLibre style, on the servers `network` names
+ * (`vectorTiles` → the `openmaptiles` source, `dem` → `terrain-dem`, `glyphs`, `sprite`). Exported for tests.
+ */
+export declare function finishStyle(json: any, network?: BasemapNetwork): StyleSpecification;
+/**
+ * The MapLibre style for `input`. Built-ins use the servers `opts.network` names (the editor's
+ * `config.network`: `vectorTiles`, `dem`, `glyphs`, `sprite`, `osmRaster`); a style URL is returned as-is.
+ */
+export declare function loadBasemapStyle(input: BasemapInput, opts?: {
+    theme?: Theme;
+    network?: BasemapNetwork;
+}): Promise<StyleSpecification | string>;
+/**
+ * Carries everything that isn't the old basemap from the previous style over to the new one:
+ * Element's `elm-*` sources and layers and, when `basemap` (the previous basemap's ids) is known,
+ * the host's own sources and layers too. Carried layers keep their order relative to each other
+ * and sit above the new basemap's layers. A carried source whose id the new basemap also uses is
+ * dropped (the new basemap's wins). Without `basemap` only `elm-*` is carried.
+ */
+export declare function carryOverElm(prev: StyleSpecification | undefined, next: StyleSpecification, basemap?: BasemapIds): StyleSpecification;
+/**
+ * Loads the basemap and applies it, keeping Element's layers and the host's own layers and sources
+ * (those that weren't part of the previous basemap). The latest call wins.
+ */
+export declare function setBasemap(map: MapLibreMap, input: BasemapInput, opts?: {
+    theme?: Theme;
+    network?: BasemapNetwork;
+}): Promise<void>;
+export {};

package/dist/src/basemaps/style.d.ts

@@ -0,0 +1,61 @@
+import { Map as MapLibreMap, StyleSpecification } from 'maplibre-gl';
+import { BasemapIds } from '../basemapIds.js';
+import { NetworkConfig } from '@element-editor/core';
+/** The map-tile part of `config.network` (what the basemap styles read). */
+export type BasemapNetwork = Pick<NetworkConfig, 'vectorTiles' | 'dem' | 'osmRaster' | 'glyphs' | 'sprite'>;
+export type BuiltinBasemapId = 'streets' | 'terrain' | 'light' | 'dark' | 'osm';
+/**
+ * A built-in id, `'auto'`, a MapLibre style (URL or object) or a raster `{ url }`. `id` names a
+ * custom entry in the picker and in the remembered pick; give every style object one (two
+ * id-less style objects can't be told apart).
+ */
+export type BasemapInput = BuiltinBasemapId | 'auto' | {
+    style: string | StyleSpecification;
+    id?: string;
+    label?: string;
+    thumbnail?: string;
+} | {
+    url: string;
+    attribution: string;
+    maxZoom?: number;
+    id?: string;
+    label?: string;
+    thumbnail?: string;
+};
+type Theme = 'light' | 'dark';
+type Resolved = Exclude<BasemapInput, 'auto'>;
+/** Only `'auto'` changes: light theme -> streets, dark theme -> dark. */
+export declare function resolveBasemap(input: BasemapInput, theme: Theme): Resolved;
+export declare const DEFAULT_GLYPHS_URL = "https://tiles.openfreemap.org/fonts/{fontstack}/{range}.pbf";
+/** Default sprite (custom `*-badge` icons OpenFreeMap lacks), served from jsDelivr at the package's own version. */
+export declare const DEFAULT_SPRITE_URL: string;
+/**
+ * Raw style JSON (sources + layers) -> full MapLibre style, on the servers `network` names
+ * (`vectorTiles` → the `openmaptiles` source, `dem` → `terrain-dem`, `glyphs`, `sprite`). Exported for tests.
+ */
+export declare function finishStyle(json: any, network?: BasemapNetwork): StyleSpecification;
+/**
+ * The MapLibre style for `input`. Built-ins use the servers `opts.network` names (the editor's
+ * `config.network`: `vectorTiles`, `dem`, `glyphs`, `sprite`, `osmRaster`); a style URL is returned as-is.
+ */
+export declare function loadBasemapStyle(input: BasemapInput, opts?: {
+    theme?: Theme;
+    network?: BasemapNetwork;
+}): Promise<StyleSpecification | string>;
+/**
+ * Carries everything that isn't the old basemap from the previous style over to the new one:
+ * Element's `elm-*` sources and layers and, when `basemap` (the previous basemap's ids) is known,
+ * the host's own sources and layers too. Carried layers keep their order relative to each other
+ * and sit above the new basemap's layers. A carried source whose id the new basemap also uses is
+ * dropped (the new basemap's wins). Without `basemap` only `elm-*` is carried.
+ */
+export declare function carryOverElm(prev: StyleSpecification | undefined, next: StyleSpecification, basemap?: BasemapIds): StyleSpecification;
+/**
+ * Loads the basemap and applies it, keeping Element's layers and the host's own layers and sources
+ * (those that weren't part of the previous basemap). The latest call wins.
+ */
+export declare function setBasemap(map: MapLibreMap, input: BasemapInput, opts?: {
+    theme?: Theme;
+    network?: BasemapNetwork;
+}): Promise<void>;
+export {};

package/dist/src/components/BoundaryLayer.d.cts

@@ -0,0 +1,11 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+interface Props {
+    map: MapLibreMap;
+}
+/** Fits the map bounds to the loaded features once on mount if initialData had content. */
+export declare function FitBounds({ map }: Props): null;
+/** One-shot autofit from URL boundary param. Store convention is [S, N, W, E]
+ * (shared with adapter-leaflet). MapLibre's `fitBounds` wants
+ * `[[west, south], [east, north]]` so we reorder. */
+export default function BoundaryLayer({ map }: Props): null;
+export {};

package/dist/src/components/BoundaryLayer.d.ts

@@ -0,0 +1,11 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+interface Props {
+    map: MapLibreMap;
+}
+/** Fits the map bounds to the loaded features once on mount if initialData had content. */
+export declare function FitBounds({ map }: Props): null;
+/** One-shot autofit from URL boundary param. Store convention is [S, N, W, E]
+ * (shared with adapter-leaflet). MapLibre's `fitBounds` wants
+ * `[[west, south], [east, north]]` so we reorder. */
+export default function BoundaryLayer({ map }: Props): null;
+export {};

package/dist/src/components/BoxSelectHandler.d.cts

@@ -0,0 +1,13 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+interface Props {
+    map: MapLibreMap;
+    /**
+     * Called when the drag ends without matching any features but a single
+     * line/polygon is already selected — supplies indices of vertices that
+     * fell inside the rubber band. Parent can choose whether to enter vertex
+     * edit mode with those pre-selected.
+     */
+    onVertexBoxSelect?: (featureId: string, indices: number[]) => void;
+}
+export default function BoxSelectHandler({ map, onVertexBoxSelect }: Props): null;
+export {};

package/dist/src/components/BoxSelectHandler.d.ts

@@ -0,0 +1,13 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+interface Props {
+    map: MapLibreMap;
+    /**
+     * Called when the drag ends without matching any features but a single
+     * line/polygon is already selected — supplies indices of vertices that
+     * fell inside the rubber band. Parent can choose whether to enter vertex
+     * edit mode with those pre-selected.
+     */
+    onVertexBoxSelect?: (featureId: string, indices: number[]) => void;
+}
+export default function BoxSelectHandler({ map, onVertexBoxSelect }: Props): null;
+export {};

package/dist/src/components/DrawingLayer.d.cts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+interface Props {
+    map: MapLibreMap;
+    /** Deprecated `routingApiKey` prop of the controls (`config.network.routing.apiKey` wins). */
+    routingApiKey?: string;
+}
+export default function DrawingLayer({ map, routingApiKey }: Props): null;
+export {};

package/dist/src/components/DrawingLayer.d.ts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+interface Props {
+    map: MapLibreMap;
+    /** Deprecated `routingApiKey` prop of the controls (`config.network.routing.apiKey` wins). */
+    routingApiKey?: string;
+}
+export default function DrawingLayer({ map, routingApiKey }: Props): null;
+export {};

package/dist/src/components/DrawingPreviewLayer.d.cts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initPreviewLayers(map: MapLibreMap): void;
+export declare function cleanupPreviewLayers(map: MapLibreMap): void;
+interface Props {
+    map: MapLibreMap;
+}
+export default function DrawingPreviewLayer({ map }: Props): null;
+export {};

package/dist/src/components/DrawingPreviewLayer.d.ts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initPreviewLayers(map: MapLibreMap): void;
+export declare function cleanupPreviewLayers(map: MapLibreMap): void;
+interface Props {
+    map: MapLibreMap;
+}
+export default function DrawingPreviewLayer({ map }: Props): null;
+export {};

package/dist/src/components/FeatureInteractionLayer.d.cts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initDragGhostLayers(map: MapLibreMap): void;
+export declare function cleanupDragGhostLayers(map: MapLibreMap): void;
+interface Props {
+    map: MapLibreMap;
+}
+export default function FeatureInteractionLayer({ map }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/components/FeatureInteractionLayer.d.ts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initDragGhostLayers(map: MapLibreMap): void;
+export declare function cleanupDragGhostLayers(map: MapLibreMap): void;
+interface Props {
+    map: MapLibreMap;
+}
+export default function FeatureInteractionLayer({ map }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/components/FeatureLayer.d.cts

@@ -0,0 +1,15 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initFeatureLayers(map: MapLibreMap): void;
+export declare function cleanupFeatureLayers(map: MapLibreMap): void;
+export declare const INTERACTIVE_FEATURE_LAYERS: string[];
+interface Props {
+    map: MapLibreMap;
+}
+export default function FeatureLayer({ map }: Props): null;
+declare module 'maplibre-gl' {
+    interface GeoJSONSource {
+        setData(data: GeoJSON.FeatureCollection | string): void;
+    }
+}
+export declare function setHoverState(map: MapLibreMap, id: string | null, prevId: string | null): void;
+export {};

package/dist/src/components/FeatureLayer.d.ts

@@ -0,0 +1,15 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initFeatureLayers(map: MapLibreMap): void;
+export declare function cleanupFeatureLayers(map: MapLibreMap): void;
+export declare const INTERACTIVE_FEATURE_LAYERS: string[];
+interface Props {
+    map: MapLibreMap;
+}
+export default function FeatureLayer({ map }: Props): null;
+declare module 'maplibre-gl' {
+    interface GeoJSONSource {
+        setData(data: GeoJSON.FeatureCollection | string): void;
+    }
+}
+export declare function setHoverState(map: MapLibreMap, id: string | null, prevId: string | null): void;
+export {};

package/dist/src/components/GeometryProcessingPreview.d.cts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initProcessingPreviewLayers(map: MapLibreMap): void;
+export declare function cleanupProcessingPreviewLayers(map: MapLibreMap): void;
+interface Props {
+    map: MapLibreMap;
+}
+export default function GeometryProcessingPreview({ map }: Props): null;
+export {};

package/dist/src/components/GeometryProcessingPreview.d.ts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initProcessingPreviewLayers(map: MapLibreMap): void;
+export declare function cleanupProcessingPreviewLayers(map: MapLibreMap): void;
+interface Props {
+    map: MapLibreMap;
+}
+export default function GeometryProcessingPreview({ map }: Props): null;
+export {};

package/dist/src/components/MeasurePreviewLayer.d.cts

@@ -0,0 +1,9 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare const MEASURE_INTERACTIVE_LAYERS: string[];
+export declare function initMeasurePreviewLayers(map: MapLibreMap): void;
+export declare function cleanupMeasurePreviewLayers(map: MapLibreMap): void;
+interface Props {
+    map: MapLibreMap;
+}
+export default function MeasurePreviewLayer({ map }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/components/MeasurePreviewLayer.d.ts

@@ -0,0 +1,9 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare const MEASURE_INTERACTIVE_LAYERS: string[];
+export declare function initMeasurePreviewLayers(map: MapLibreMap): void;
+export declare function cleanupMeasurePreviewLayers(map: MapLibreMap): void;
+interface Props {
+    map: MapLibreMap;
+}
+export default function MeasurePreviewLayer({ map }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/components/MeasurementTooltip.d.cts

@@ -0,0 +1,6 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+interface Props {
+    map: MapLibreMap;
+}
+export default function MeasurementTooltip({ map }: Props): import('react').ReactPortal | null;
+export {};

package/dist/src/components/MeasurementTooltip.d.ts

@@ -0,0 +1,6 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+interface Props {
+    map: MapLibreMap;
+}
+export default function MeasurementTooltip({ map }: Props): import('react').ReactPortal | null;
+export {};

package/dist/src/components/OsmTraceHandler.d.cts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initOverlayLayers(map: MapLibreMap): void;
+export declare function cleanupOverlayLayers(map: MapLibreMap): void;
+interface Props {
+    map: MapLibreMap;
+}
+export declare function OsmTraceHandler({ map }: Props): import('react').ReactPortal | null;
+export default OsmTraceHandler;

package/dist/src/components/OsmTraceHandler.d.ts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initOverlayLayers(map: MapLibreMap): void;
+export declare function cleanupOverlayLayers(map: MapLibreMap): void;
+interface Props {
+    map: MapLibreMap;
+}
+export declare function OsmTraceHandler({ map }: Props): import('react').ReactPortal | null;
+export default OsmTraceHandler;

package/dist/src/components/PreciseCoordsOverlay.d.cts

@@ -0,0 +1,10 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+interface Props {
+    map: MapLibreMap;
+    coords: [number, number];
+    /** Commit the new coordinate (take an undo snapshot first). */
+    onSave: (coord: [number, number]) => void;
+    onClose: () => void;
+}
+export default function PreciseCoordsOverlay({ map, coords, onSave, onClose }: Props): import('react').ReactPortal;
+export {};

package/dist/src/components/PreciseCoordsOverlay.d.ts

@@ -0,0 +1,10 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+interface Props {
+    map: MapLibreMap;
+    coords: [number, number];
+    /** Commit the new coordinate (take an undo snapshot first). */
+    onSave: (coord: [number, number]) => void;
+    onClose: () => void;
+}
+export default function PreciseCoordsOverlay({ map, coords, onSave, onClose }: Props): import('react').ReactPortal;
+export {};

package/dist/src/components/SnapController.d.cts

@@ -0,0 +1,9 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initSnapLayers(map: MapLibreMap): void;
+export declare function cleanupSnapLayers(map: MapLibreMap): void;
+export declare function ensureDiamondIcon(map: MapLibreMap, color: string): void;
+interface Props {
+    map: MapLibreMap;
+}
+export default function SnapController({ map }: Props): null;
+export {};

package/dist/src/components/SnapController.d.ts

@@ -0,0 +1,9 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+export declare function initSnapLayers(map: MapLibreMap): void;
+export declare function cleanupSnapLayers(map: MapLibreMap): void;
+export declare function ensureDiamondIcon(map: MapLibreMap, color: string): void;
+interface Props {
+    map: MapLibreMap;
+}
+export default function SnapController({ map }: Props): null;
+export {};

package/dist/src/components/TextEditOverlay.d.cts

@@ -0,0 +1,9 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+import { GeoJSONFeature } from '@element-editor/core';
+interface Props {
+    map: MapLibreMap;
+    feature: GeoJSONFeature;
+    onDone: () => void;
+}
+export default function TextEditOverlay({ map, feature, onDone }: Props): import('react').ReactPortal;
+export {};

package/dist/src/components/TextEditOverlay.d.ts

@@ -0,0 +1,9 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+import { GeoJSONFeature } from '@element-editor/core';
+interface Props {
+    map: MapLibreMap;
+    feature: GeoJSONFeature;
+    onDone: () => void;
+}
+export default function TextEditOverlay({ map, feature, onDone }: Props): import('react').ReactPortal;
+export {};

package/dist/src/components/TransformControls.d.cts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+import { GeoJSONFeature } from '@element-editor/core';
+interface Props {
+    map: MapLibreMap;
+    features: GeoJSONFeature[];
+}
+export default function TransformControls({ map, features }: Props): null;
+export {};

package/dist/src/components/TransformControls.d.ts

@@ -0,0 +1,8 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+import { GeoJSONFeature } from '@element-editor/core';
+interface Props {
+    map: MapLibreMap;
+    features: GeoJSONFeature[];
+}
+export default function TransformControls({ map, features }: Props): null;
+export {};

package/dist/src/components/VertexEditor.d.cts

@@ -0,0 +1,15 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+import { GeoJSONFeature } from '@element-editor/core';
+interface Props {
+    map: MapLibreMap;
+    feature: GeoJSONFeature;
+    /**
+     * Pre-selected vertex indices (ring 0 only) — used by box-select-while-
+     * a-feature-is-selected to drop the user straight into vertex edit with
+     * those vertices ready for bulk delete/simplify. Parent is responsible
+     * for clearing this the turn after we consume it.
+     */
+    initialSelectedIndices?: number[];
+}
+export default function VertexEditor({ map, feature, initialSelectedIndices }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/components/VertexEditor.d.ts

@@ -0,0 +1,15 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+import { GeoJSONFeature } from '@element-editor/core';
+interface Props {
+    map: MapLibreMap;
+    feature: GeoJSONFeature;
+    /**
+     * Pre-selected vertex indices (ring 0 only) — used by box-select-while-
+     * a-feature-is-selected to drop the user straight into vertex edit with
+     * those vertices ready for bulk delete/simplify. Parent is responsible
+     * for clearing this the turn after we consume it.
+     */
+    initialSelectedIndices?: number[];
+}
+export default function VertexEditor({ map, feature, initialSelectedIndices }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/contexts/FeatureStyleContext.d.cts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+import { FeatureStyle, GeoJSONFeature } from '@element-editor/core';
+export type { FeatureStyle };
+export type FeatureStyleFn = (feature: GeoJSONFeature) => FeatureStyle | undefined | null;
+export declare function FeatureStyleProvider({ getFeatureStyle, children, }: {
+    getFeatureStyle?: FeatureStyleFn;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useFeatureStyle(): FeatureStyleFn | undefined;

package/dist/src/contexts/FeatureStyleContext.d.ts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+import { FeatureStyle, GeoJSONFeature } from '@element-editor/core';
+export type { FeatureStyle };
+export type FeatureStyleFn = (feature: GeoJSONFeature) => FeatureStyle | undefined | null;
+export declare function FeatureStyleProvider({ getFeatureStyle, children, }: {
+    getFeatureStyle?: FeatureStyleFn;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useFeatureStyle(): FeatureStyleFn | undefined;

package/dist/src/contexts/MapControllerContext.d.cts

@@ -0,0 +1,2 @@
+export { MapControllerProvider, useMapController, useSetMapController } from '@element-editor/ui';
+export type { MapController } from '@element-editor/ui';

package/dist/src/contexts/MapControllerContext.d.ts

@@ -0,0 +1,2 @@
+export { MapControllerProvider, useMapController, useSetMapController } from '@element-editor/ui';
+export type { MapController } from '@element-editor/ui';

package/dist/src/contexts/StyleEpochContext.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Bumped each time Element (re)created its `elm-*` sources on the map's current style: the first
+ * init and every repair after a `map.setStyle`. Effects that push data into an `elm-*` source list
+ * it as a dependency, so they refill the new, empty sources.
+ */
+export declare const StyleEpochContext: import('react').Context<number>;
+export declare const useStyleEpoch: () => number;

package/dist/src/contexts/StyleEpochContext.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Bumped each time Element (re)created its `elm-*` sources on the map's current style: the first
+ * init and every repair after a `map.setStyle`. Effects that push data into an `elm-*` source list
+ * it as a dependency, so they refill the new, empty sources.
+ */
+export declare const StyleEpochContext: import('react').Context<number>;
+export declare const useStyleEpoch: () => number;

package/dist/src/elementLayers.d.cts

@@ -0,0 +1,17 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+/**
+ * Adds whatever of Element's sources, layers and images the map's style lacks, on top of the
+ * style. Idempotent. Throws while the style is still loading ("Style is not done loading").
+ */
+export declare function ensureElementLayers(map: MapLibreMap): void;
+export declare function cleanupElementLayers(map: MapLibreMap): void;
+/**
+ * Keeps Element's layers on `map`: adds them now (or once the style can take them) and again
+ * whenever the style is replaced — anyone's `map.setStyle`, full rebuild or diff (both drop
+ * `elm-*`), or a full rebuild in our own `setBasemap` (which carries the layers over, but as new
+ * sources without their feature-state). The trigger: `elm-features` is missing or isn't the source
+ * object last synced. Nothing gates on `isStyleLoaded()` / `loaded()` (both lie under StrictMode):
+ * a still-loading style throws, and the next `styledata` / `style.load` / `load` retries.
+ * `onSynced` runs after each (re)add, so callers refill the new, empty sources. Returns the unsubscribe.
+ */
+export declare function watchElementLayers(map: MapLibreMap, onSynced: () => void): () => void;

package/dist/src/elementLayers.d.ts

@@ -0,0 +1,17 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+/**
+ * Adds whatever of Element's sources, layers and images the map's style lacks, on top of the
+ * style. Idempotent. Throws while the style is still loading ("Style is not done loading").
+ */
+export declare function ensureElementLayers(map: MapLibreMap): void;
+export declare function cleanupElementLayers(map: MapLibreMap): void;
+/**
+ * Keeps Element's layers on `map`: adds them now (or once the style can take them) and again
+ * whenever the style is replaced — anyone's `map.setStyle`, full rebuild or diff (both drop
+ * `elm-*`), or a full rebuild in our own `setBasemap` (which carries the layers over, but as new
+ * sources without their feature-state). The trigger: `elm-features` is missing or isn't the source
+ * object last synced. Nothing gates on `isStyleLoaded()` / `loaded()` (both lie under StrictMode):
+ * a still-loading style throws, and the next `styledata` / `style.load` / `load` retries.
+ * `onSynced` runs after each (re)add, so callers refill the new, empty sources. Returns the unsubscribe.
+ */
+export declare function watchElementLayers(map: MapLibreMap, onSynced: () => void): () => void;

package/dist/src/hooks/lastPointer.d.cts

@@ -0,0 +1,18 @@
+/**
+ * Module-level pointer tracker. Parallel to `adapter-leaflet/src/hooks/lastPointer.ts`.
+ * Used by `FeatureInteractionLayer` to synthesise a `mousemove` on MapLibre's
+ * internal event pipeline when a new feature lands under a stationary cursor —
+ * the user's mouse didn't move, so no hover hit-test fires on its own and
+ * modifier-cursor affordances (Cmd/Alt) never activate on the fresh feature.
+ *
+ * Listeners are installed **eagerly at module load** (never lazily), so state
+ * reflects every `mousemove` that happened before the first consumer runs.
+ */
+export type PointerState = {
+    x: number;
+    y: number;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    altKey: boolean;
+};
+export declare function getLastPointer(): PointerState;

package/dist/src/hooks/lastPointer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Module-level pointer tracker. Parallel to `adapter-leaflet/src/hooks/lastPointer.ts`.
+ * Used by `FeatureInteractionLayer` to synthesise a `mousemove` on MapLibre's
+ * internal event pipeline when a new feature lands under a stationary cursor —
+ * the user's mouse didn't move, so no hover hit-test fires on its own and
+ * modifier-cursor affordances (Cmd/Alt) never activate on the fresh feature.
+ *
+ * Listeners are installed **eagerly at module load** (never lazily), so state
+ * reflects every `mousemove` that happened before the first consumer runs.
+ */
+export type PointerState = {
+    x: number;
+    y: number;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    altKey: boolean;
+};
+export declare function getLastPointer(): PointerState;

package/dist/src/hooks/useCursorWhileMode.d.cts

@@ -0,0 +1,20 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+/**
+ * Tracks the latest map cursor lng/lat while a caller-specified mode is active
+ * and resets on every `editingMode` transition so exiting-and-re-entering the
+ * same tool (e.g. press R → off → R from a new cursor position) doesn't leak
+ * the previous session's coordinates on the first frame.
+ *
+ * React's "set state during render" reset pattern is used intentionally — it
+ * produces a synchronous re-render with cleared state before the browser
+ * paints, so there's no stale-coord flash.
+ *
+ * Usage:
+ *
+ *   const mouse = useCursorWhileMode(map, editingMode, editingMode === 'draw-rect')
+ *
+ * Pass a predicate that's true whenever cursor updates should flow into state.
+ * On mouseout (cursor leaves the map canvas) the value resets to null, so
+ * tooltips / previews that depend on it disappear.
+ */
+export declare function useCursorWhileMode(map: MapLibreMap, editingMode: string, isActive: boolean): [number, number] | null;