@geolibre/core 3.3.0 → 3.5.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as BLANK_BASEMAP, $n as QuickFilterKind, $t as LayerPopupConfig, A as PlanetaryBasemap, An as OPENFREEMAP_BASEMAPS, Ar as isDefaultPrintLayout, At as FieldVisibility, B as getEllipsoid, Bn as ProcessingModelGraph, Br as Point, Bt as LabelDedupe, C as ELLIPSOIDS, Cn as ModelGraphNode, Cr as styleValue, Ct as DashboardWidget, D as PLANETARY_BASEMAP_GROUPS, Dn as ModelToolProvider, Dr as PrintLayoutLegendEntry, Dt as DiagramSizeMode, E as PLANETARY_BASEMAPS, En as ModelPortKind, Er as PrintLayoutCorner, Et as DiagramField, F as earthLengthToBody, Fn as PopupDateFormat, Fr as Feature, Ft as GeometryGeneratorType, G as AddTileLayerOptions, Gn as ProcessingRunStatus, Gr as availableCesiumBasemap, Gt as LayerDescriptiveMetadata, H as getPlanetaryBasemapByStyleUrl, Hn as ProcessingRerunRequest, Hr as CESIUM_BASEMAPS, Ht as LabelTransform, I as getActiveBodyRadiusRatio, In as PopupFieldConfig, Ir as FeatureCollection, It as IndicatorAggregation, J as AppRole, Jn as ProjectPluginControlPosition, Jr as sameCesiumImagery, Jt as LayerJoinStats, K as AppCapabilities, Kn as ProjectComment, Kr as basemapToCesiumImagery, Kt as LayerGroup, L as getActiveEllipsoid, Ln as PopupFieldFormat, Lr as Geometry, Lt as LARGE_VECTOR_FEATURE_THRESHOLD, M as PlanetaryBasemapSectionId, Mn as PROTOMAPS_BASEMAPS, Mr as printLayoutConfigsEqual, Mt as GeoLibreLayer, N as bodyLengthToEarth, Nn as ParticipantIdentity, Nr as scrubPrintLayoutForLayers, Nt as GeoLibreProject, O as PLANETARY_BASEMAP_SENTINEL_PREFIX, On as NETCDF_IMAGE_SOURCE_KIND, Or as PrintLayoutPageFilter, Ot as DiagramType, P as earthAreaToBody, Pn as PointRenderer, Pr as scrubPrintLayoutForRemovedLayers, Pt as GeocodingPreferences, Q as AttributeFormWidget, Qn as QuickFilterDateKind, Qt as LayerMetadataTemporalExtent, R as getActiveMeanRadiusMeters, Rn as PopupFieldKind, Rr as LineString, Rt as LAYER_TYPES, S as EARTH_MEAN_RADIUS_METERS, Sn as ModelGraphEdge, Sr as shouldUseTiledRendering, St as DUCKDB_VECTOR_ROUTE_BYTES, T as EllipsoidId, Tn as ModelGraphPort, Tr as PrintLayoutConfig, Tt as DashboardWidgetType, U as meanRadiusMeters, Un as ProcessingRun, Ur as CesiumBasemapId, Ut as LayerCapabilities, V as getPlanetaryBasemapById, Vn as ProcessingModelStep, Vr as Polygon, Vt as LabelStyle, W as setActiveEllipsoidId, Wn as ProcessingRunKind, Wr as CesiumBasemapImagery, Wt as LayerConnection, X as AttributeFormFieldConfig, Xn as ProjectPreferences, Xt as LayerMetadataContact, Y as AttributeFormConfig, Yn as ProjectPluginState, Yt as LayerLibraryEntry, Z as AttributeFormValueMapEntry, Zn as ProjectTemplateEntry, Zt as LayerMetadataLink, _ as unescapePolyline, _n as MapProjection, _r as VectorRule, _t as DEFAULT_MAP_GRID_LAYOUT, a as collectTransitiveJoinSourceIds, an as LegendCustomEntry, ar as StoryActiveSlideMode, at as CollaborationParticipant, b as transformGeojsonElevation, bn as MapViewState, br as detectNonGeographicCoordinates, bt as DEFAULT_STORY_MAP, c as stripJoinFields, cn as LegendItemOverride, cr as StoryChapterAnimation, ct as CollaborationState, d as batchDecodePolylines, dn as MAX_DASHBOARD_COLUMNS, dr as StoryLayerOpacityChange, dt as CommentReply, en as LayerQuickFilter, er as QuickFilterTextOperator, et as BLEND_MODES, f as decodePolyline, fn as MAX_MAP_GRID_DIM, fr as StoryMap, ft as DEFAULT_BASEMAP, g as polylineStrToGeoJSON, gn as MapPreferences, gr as StyleLibraryEntryKind, gt as DEFAULT_LEGEND_CONFIG, h as geoJSONToPolylineStr, hn as MapGridLayout, hr as StyleLibraryEntry, ht as DEFAULT_LAYER_STYLE, i as cascadeLayerJoinRefresh, in as LegendConfig, ir as SecondaryMapView, it as CollaborationMode, j as PlanetaryBasemapGroup, jn as PROJECT_VERSION, jr as normalizePrintLayoutConfig, jt as FillPattern, k as PLANET_SWITCHER_OPTIONS, kn as NonGeographicCoordinates, kr as createDefaultPrintLayout, kt as EditorTrackingConfig, l as PolylineBatchOptions, ln as LegendPanelPosition, lr as StoryChapterLocation, lt as CommentAnchor, m as encodePolyline, mn as MIN_DASHBOARD_COLUMNS, mr as StrokeWidthUnit, mt as DEFAULT_DASHBOARD_COLUMNS, n as applyJoinsToLayer, nn as LayerType, nr as RuntimeEnvironmentVariable, nt as CollabInvite, o as layerJoinKey, on as LegendCustomItem, or as StoryChapter, ot as CollaborationPresence, p as decodePolylineDetailed, pn as MAX_PROCESSING_HISTORY, pr as StorySlideMode, pt as DEFAULT_BLEND_MODE, q as AppPrivilege, qn as ProjectInteraction, qr as normalizeCesiumBasemap, qt as LayerJoin, r as applyLayerJoins, rn as LayerVirtualField, rr as SQL_QUERY_SOURCE_KIND, rt as CollaborationChatMessage, s as reapplyLayerJoins, sn as LegendCustomShape, sr as StoryChapterAlignment, st as CollaborationRole, t as ApplyLayerJoinsResult, tn as LayerStyle, tr as RecentProjectEntry, tt as BlendMode, u as PolylineDecodeResult, un as LineDecoration, ur as StoryInsetPosition, ut as CommentAuthor, v as geojsonHasZCoordinates, vn as MapRendererKind, vr as VectorStyleMode, vt as DEFAULT_PRIMARY_RENDERER, w as Ellipsoid, wn as ModelGraphNodeKind, wr as DEFAULT_PRINT_LAYOUT, wt as DashboardWidgetAggregation, x as DEFAULT_ELLIPSOID_ID, xn as MarkerShape, xr as isDuckDBQueryLayer, xt as DUCKDB_VECTOR_FEATURE_WARN_COUNT, y as horizontalBbox, yn as MapScaleUnit, yr as VectorStyleStop, yt as DEFAULT_PROJECT_PREFERENCES, z as getActiveSemiMajorAxisMeters, zn as ProcessingModel, zr as MultiPolygon, zt as LabelAnchor } from "./joins-CRZZcLqX.mjs";
+import { $ as collectTransitiveJoinSourceIds, $n as LegendConfig, $r as RuntimeEnvironmentVariable, $t as CollaborationParticipant, A as normalizeMapViewState, Ai as scrubPrintLayoutForLayers, An as GeometryGeneratorType, Ar as PopupDateFormat, At as getActiveBodyRadiusRatio, B as normalizeWidgets, Bi as Geometry, Bn as LayerDescriptiveMetadata, Br as ProcessingRunStatus, Bt as AppCapabilities, C as isSessionOnlyLayer, Ci as PrintLayoutCorner, Cn as EditorTrackingConfig, Cr as NETCDF_IMAGE_SOURCE_KIND, Ct as PLANET_SWITCHER_OPTIONS, D as normalizeDashboardColumns, Di as isDefaultPrintLayout, Dn as GeoLibreProject, Dr as PROTOMAPS_BASEMAPS, Dt as bodyLengthToEarth, E as normalizeBookmarks, Ei as createDefaultPrintLayout, En as GeoLibreLayer, Er as PROJECT_VERSION, Et as PlanetaryBasemapSectionId, F as normalizeProcessingHistory, Fi as featureCollectionToGeoArrow, Fn as LabelDedupe, Fr as ProcessingModelGraph, Ft as getPlanetaryBasemapById, G as serializeProject, Gi as CESIUM_BASEMAPS, Gn as LayerMetadataContact, Gr as ProjectPluginControlPosition, Gt as AttributeFormValueMapEntry, H as portableWmsTileUrl, Hi as MultiPolygon, Hn as LayerJoin, Hr as ProjectBookmarkGroup, Ht as AppRole, I as normalizeProjectComments, Ii as geoArrowToFeatureCollection, In as LabelStyle, Ir as ProcessingModelStep, It as getPlanetaryBasemapByStyleUrl, J as storyMapHasContent, Ji as availableCesiumBasemap, Jn as LayerPopupConfig, Jr as ProjectTemplateEntry, Jt as BLEND_MODES, K as serializeProjectWithLayerCache, Ki as CesiumBasemapId, Kn as LayerMetadataLink, Kr as ProjectPluginState, Kt as AttributeFormWidget, L as normalizeProjectInteraction, Li as isGeoArrowBatch, Ln as LabelTransform, Lr as ProcessingRerunRequest, Lt as meanRadiusMeters, M as normalizeModels, Mi as GeoArrowBatch, Mn as LARGE_VECTOR_FEATURE_THRESHOLD, Mr as PopupFieldFormat, Mt as getActiveMeanRadiusMeters, N as normalizeObiaWorkbench, Ni as GeoArrowGeometryType, Nn as LAYER_TYPES, Nr as PopupFieldKind, Nt as getActiveSemiMajorAxisMeters, O as normalizeLegendConfig, Oi as normalizePrintLayoutConfig, On as GeocodingLocator, Or as ParticipantIdentity, Ot as earthAreaToBody, P as normalizePrimaryRenderer, Pi as computeGeoArrowBBox, Pn as LabelAnchor, Pr as ProcessingModel, Pt as getEllipsoid, Q as cascadeLayerJoinRefresh, Qn as LayerVirtualField, Qr as RecentProjectEntry, Qt as CollaborationMode, R as normalizeSecondaryMapViews, Ri as Feature, Rn as LayerCapabilities, Rr as ProcessingRun, Rt as setActiveEllipsoidId, S as isAllowedPluginManifestUrl, Si as PrintLayoutConfig, Sn as DiagramType, Sr as ModelToolProvider, St as PLANETARY_BASEMAP_SENTINEL_PREFIX, T as normalizeBookmarkGroups, Ti as PrintLayoutPageFilter, Tn as FillPattern, Tr as OPENFREEMAP_BASEMAPS, Tt as PlanetaryBasemapGroup, U as projectFromStore, Ui as Point, Un as LayerJoinStats, Ur as ProjectComment, Ut as AttributeFormConfig, V as parseProject, Vi as LineString, Vn as LayerGroup, Vr as ProjectBookmark, Vt as AppPrivilege, W as resolveMapGrid, Wi as Polygon, Wn as LayerLibraryEntry, Wr as ProjectInteraction, Wt as AttributeFormFieldConfig, X as applyJoinsToLayer, Xi as normalizeCesiumBasemap, Xn as LayerStyle, Xr as QuickFilterKind, Xt as CollabInvite, Y as ApplyLayerJoinsResult, Yi as basemapToCesiumImagery, Yn as LayerQuickFilter, Yr as QuickFilterDateKind, Yt as BlendMode, Z as applyLayerJoins, Zi as sameCesiumImagery, Zn as LayerType, Zr as QuickFilterTextOperator, Zt as CollaborationChatMessage, _ as createEmptyProject, _i as detectNonGeographicCoordinates, _n as DashboardWidget, _r as ModelGraphEdge, _t as ELLIPSOIDS, a as ProjectDiffOptions, ai as StoryChapterAnimation, an as CommentReply, ar as LineDecoration, at as batchDecodePolylines, b as detachProjectCopy, bi as styleValue, bn as DiagramField, br as ModelGraphPort, bt as PLANETARY_BASEMAPS, c as diffProjects, ci as StoryLayerOpacityChange, cn as DEFAULT_DASHBOARD_COLUMNS, cr as MAX_PROCESSING_HISTORY, ct as encodePolyline, d as CreateProjectOptions, di as StrokeWidthUnit, dn as DEFAULT_MAP_GRID_LAYOUT, dr as MapPreferences, dt as unescapePolyline, ei as SQL_QUERY_SOURCE_KIND, en as CollaborationPresence, er as LegendCustomEntry, et as layerJoinKey, f as DEFAULT_PROJECT_NAME, fi as StyleLibraryEntry, fn as DEFAULT_PRIMARY_RENDERER, fr as MapProjection, ft as geojsonHasZCoordinates, g as createDefaultMapView, gi as VectorStyleStop, gn as DUCKDB_VECTOR_ROUTE_BYTES, gr as MarkerShape, gt as EARTH_MEAN_RADIUS_METERS, h as applyProjectToStore, hi as VectorStyleMode, hn as DUCKDB_VECTOR_FEATURE_WARN_COUNT, hr as MapViewState, ht as DEFAULT_ELLIPSOID_ID, i as ProjectDiff, ii as StoryChapterAlignment, in as CommentAuthor, ir as LegendPanelPosition, it as PolylineDecodeResult, j as normalizeModelGraph, ji as scrubPrintLayoutForRemovedLayers, jn as IndicatorAggregation, jr as PopupFieldConfig, jt as getActiveEllipsoid, k as normalizeMapLayout, ki as printLayoutConfigsEqual, kn as GeocodingPreferences, kr as PointRenderer, kt as earthLengthToBody, l as jsonValuesEqual, li as StoryMap, ln as DEFAULT_LAYER_STYLE, lr as MIN_DASHBOARD_COLUMNS, lt as geoJSONToPolylineStr, m as ProjectLayerSerializationCache, mi as VectorRule, mn as DEFAULT_STORY_MAP, mr as MapScaleUnit, mt as transformGeojsonElevation, n as LayerDiff, ni as StoryActiveSlideMode, nn as CollaborationState, nr as LegendCustomShape, nt as stripJoinFields, o as ProjectValueChange, oi as StoryChapterLocation, on as DEFAULT_BASEMAP, or as MAX_DASHBOARD_COLUMNS, ot as decodePolyline, p as MAX_PROJECT_BOOKMARKS, pi as StyleLibraryEntryKind, pn as DEFAULT_PROJECT_PREFERENCES, pr as MapRendererKind, pt as horizontalBbox, q as serializeProjectWithLayerCacheAsync, qi as CesiumBasemapImagery, qn as LayerMetadataTemporalExtent, qr as ProjectPreferences, qt as BLANK_BASEMAP, r as PluginDiff, ri as StoryChapter, rn as CommentAnchor, rr as LegendItemOverride, rt as PolylineBatchOptions, s as diffFeatureCollections, si as StoryInsetPosition, sn as DEFAULT_BLEND_MODE, sr as MAX_MAP_GRID_DIM, st as decodePolylineDetailed, t as FeatureChangeSummary, ti as SecondaryMapView, tn as CollaborationRole, tr as LegendCustomItem, tt as reapplyLayerJoins, u as previewValue, ui as StorySlideMode, un as DEFAULT_LEGEND_CONFIG, ur as MapGridLayout, ut as polylineStrToGeoJSON, v as createProjectLayerSerializationCache, vi as isDuckDBQueryLayer, vn as DashboardWidgetAggregation, vr as ModelGraphNode, vt as Ellipsoid, w as normalizeBlankBackgroundColor, wi as PrintLayoutLegendEntry, wn as FieldVisibility, wr as NonGeographicCoordinates, wt as PlanetaryBasemap, x as hydrateProjectLayer, xi as DEFAULT_PRINT_LAYOUT, xn as DiagramSizeMode, xr as ModelPortKind, xt as PLANETARY_BASEMAP_GROUPS, y as createProjectTemplate, yi as shouldUseTiledRendering, yn as DashboardWidgetType, yr as ModelGraphNodeKind, yt as EllipsoidId, z as normalizeStoryMap, zi as FeatureCollection, zn as LayerConnection, zr as ProcessingRunKind, zt as AddTileLayerOptions } from "./project-diff-CyR4d8Sl.mjs";
 import "zustand";
 import "zundo";
 //#region src/diagram.d.ts
@@ -116,6 +116,28 @@ export declare function diagramPixelSize(datum: DiagramDatum, style: LayerStyle,
  *   stroke is not clipped at the edge.
  */
 export declare function drawMarkerPath(ctx: CanvasRenderingContext2D, shape: MarkerShape, size: number): void;
+/**
+ * Whether a custom marker source is a raster image (PNG, JPEG, GIF, ...) rather
+ * than SVG: a non-SVG `data:image/...` URL, or an `http(s)` URL whose path ends
+ * in a raster extension. Raster markers cannot be recolored, so the marker
+ * color and per-class colors only apply to SVG sources. A remote URL without a
+ * telling extension is not classified here; the map sniffs its content type.
+ *
+ * @param markup - The `markerSvg` value.
+ * @returns `true` for a recognizably raster source.
+ */
+export declare function isRasterMarkerSource(markup: string): boolean;
+/**
+ * Whether a remote marker response holds SVG text, judged by its
+ * `content-type` header: `image/svg+xml`, or a text/XML type (a raw GitHub
+ * file is served as `text/plain`), reads as SVG and any other `image/*` does
+ * not. A missing or generic header falls back to a `.svg` path.
+ *
+ * @param url - The requested URL.
+ * @param contentType - The response's `content-type` header, if any.
+ * @returns `true` when the body should be read as SVG markup.
+ */
+export declare function isSvgMarkerResponse(url: string, contentType: string | null): boolean;
 /**
  * Resolve user-supplied SVG input to an `Image.src`: inline markup (starting
  * with `<`) is encoded as a data URL; otherwise only `data:` and `http(s):`
@@ -264,6 +286,186 @@ export declare function getRegionalBasemapById(id: string | undefined): Regional
 /** Whether a style URL is a regional-basemap sentinel, resolvable or not. */
 export declare function isRegionalBasemapSentinel(styleUrl: string | undefined): boolean;
 //#endregion
+//#region src/arcgis-projection.d.ts
+/**
+ * Projections the ArcGIS renderer can draw its flat map in (issue #2708).
+ *
+ * MapLibre and Mapbox only draw Web Mercator and a globe, but the ArcGIS Maps
+ * SDK reprojects vector layers on the client into any projected coordinate
+ * system it knows by WKID. `preferences.map.arcgisWkid` names that system;
+ * absent means the default Web Mercator map. The SDK cannot reproject tiled
+ * layers (XYZ, Esri basemaps), so in another projection those do not draw.
+ */
+/** A projection offered in the settings picker. */
+export interface ArcgisProjectionPreset {
+  /** The Esri or EPSG well-known ID the SDK resolves. */
+  wkid: number;
+  /** English name; the UI translates it by `id`. */
+  name: string;
+  /** Stable key for the translated name (`settings.map.arcgisProjections.<id>`). */
+  id: string;
+}
+/** Presets, verified to load and frame in the SDK pinned by `ARCGIS_SDK_VERSION`. */
+export declare const ARCGIS_PROJECTION_PRESETS: readonly ArcgisProjectionPreset[];
+/**
+ * Normalize a stored ArcGIS projection WKID.
+ *
+ * Args:
+ *   value: The raw `preferences.map.arcgisWkid` value.
+ *
+ * Returns:
+ *   A positive integer WKID other than Web Mercator, or `undefined` for the
+ *   default Web Mercator map (absent, malformed or a Web Mercator code).
+ */
+export declare function normalizeArcgisWkid(value: unknown): number | undefined;
+//#endregion
+//#region src/map-crs.d.ts
+/**
+ * Map coordinate reference systems for the MapLibre renderer (issue #1128).
+ *
+ * MapLibre GL JS 6.15 can draw a flat map in any planar CRS registered with
+ * `maplibregl.addProjection`: tiles are placed on a square quad grid laid over
+ * the CRS plane and are not reprojected, so every tile has to be made in that
+ * CRS already. A WMS does that on request (the `{bbox}` tile token asks for each
+ * tile's box in CRS units), which is how the presets below get native polar and
+ * simple-cylindrical basemaps of Earth, the Moon, Mars and the outer bodies.
+ *
+ * `preferences.map.mapCrs` names the CRS: a preset id from
+ * {@link MAP_CRS_PRESETS}, or `"EPSG:<code>"` for any code the bundled EPSG
+ * tables resolve. Absent means the default Web Mercator / globe map.
+ *
+ * This module is pure data and string handling. Registering the projection and
+ * swapping the style live in `@geolibre/map` (`map-crs.ts`).
+ */
+/** A square quad tile grid over a CRS plane, as MapLibre's `TileMatrixSet`. */
+export interface MapCrsTileMatrixSet {
+  /** Top-left corner of tile 0/0/0, in CRS units. */
+  origin: [number, number];
+  /** Width (and height) of tile 0/0/0, in CRS units. */
+  extentAtZoom0: number;
+}
+/** A WMS basemap served natively in a preset's CRS. */
+export interface MapCrsBasemap {
+  /** GetMap template whose `BBOX` is MapLibre's `{bbox}` token. */
+  tiles: string;
+  /** Attribution HTML. */
+  attribution: string;
+  /** Deepest zoom worth requesting; MapLibre overzooms past it. */
+  maxZoom: number;
+}
+/** Which group a preset is listed under in the settings picker. */
+export type MapCrsBody = "earth" | "moon" | "mars" | "mercury" | "venus" | "io" | "europa" | "ganymede" | "callisto" | "titan" | "pluto" | "charon";
+/** A CRS offered in the settings picker. */
+export interface MapCrsPreset {
+  /** Stable id persisted in `preferences.map.mapCrs`; also the i18n key. */
+  id: string;
+  /** English name; the UI translates it by `id`. */
+  name: string;
+  /**
+   * The CRS's authority code, registered with MapLibre under this name and
+   * written into the `SRS`/`CRS` of WMS layers drawn on the map.
+   */
+  code: string;
+  /**
+   * The label WMS and ArcGIS export layers on the map ask for, when servers
+   * do not read `code`. MapServer's PROJ rejects the planetary IAU codes, so
+   * those presets use the labels USGS Astrogeology serves their grids under.
+   */
+  wmsSrs?: string;
+  /** PROJ string of the CRS, used by proj4 on the page and in the workers. */
+  definition: string;
+  /** Ellipsoid registry id the preset's coordinates describe. */
+  ellipsoidId: MapCrsBody;
+  tileMatrixSet: MapCrsTileMatrixSet;
+  /** Box the map opens on when the preset is chosen, `[west, south, east, north]`. */
+  bounds: [number, number, number, number];
+  basemap: MapCrsBasemap;
+}
+/**
+ * Presets verified to render against their WMS on 2026-10-19.
+ *
+ * The USGS polar map files serve their native polar stereographic grid under
+ * `EPSG:32661`/`EPSG:32761` (MapServer's PROJ rejects the IAU codes they also
+ * list), centred on the pole with no false origin, so those labels are used for
+ * the basemap requests while the map registers the body's IAU code.
+ */
+export declare const MAP_CRS_PRESETS: readonly MapCrsPreset[];
+/**
+ * Look a preset up by its id.
+ *
+ * Args:
+ *   id: A `preferences.map.mapCrs` value.
+ *
+ * Returns:
+ *   The preset, or `undefined` when `id` is not a preset id.
+ */
+export declare function getMapCrsPreset(id: string | undefined): MapCrsPreset | undefined;
+/**
+ * Read an `EPSG:<code>` map CRS value.
+ *
+ * Args:
+ *   value: A `preferences.map.mapCrs` value.
+ *
+ * Returns:
+ *   The numeric EPSG code, or `null` when the value is not an EPSG CRS.
+ */
+export declare function parseMapCrsEpsgCode(value: string | undefined): number | null;
+/**
+ * Normalize a stored map CRS.
+ *
+ * Args:
+ *   value: The raw `preferences.map.mapCrs` value.
+ *
+ * Returns:
+ *   A preset id, `"EPSG:<code>"`, or `undefined` for the default Web Mercator
+ *   map (absent, malformed or a Web Mercator code).
+ */
+export declare function normalizeMapCrs(value: unknown): string | undefined;
+/**
+ * Point a Web Mercator WMS or ArcGIS export template at a map CRS.
+ *
+ * GeoLibre's WMS layers request `BBOX={bbox-epsg-3857}` in `EPSG:3857`. On a
+ * map in another CRS each tile is a box in that CRS instead, which MapLibre
+ * writes into the `{bbox}` token, so the template asks for `{bbox}` in `code`.
+ * WMS requests move to version 1.1.1, whose `SRS` BBOX is east, north for every
+ * CRS (1.3.0 swaps the axes of geographic ones), and an ArcGIS `export`
+ * template has its `bboxSR`/`imageSR` set to the EPSG number.
+ *
+ * Args:
+ *   template: A raster tile template.
+ *   code: The map CRS's authority code, e.g. `EPSG:3031` or `IAU_2015:49918`.
+ *
+ * Returns:
+ *   The template for the CRS, the template unchanged when it already uses
+ *   `{bbox}`, or `null` for a template with no bounding box (an XYZ or TMS
+ *   template), which cannot be drawn in another CRS.
+ */
+export declare function adaptBboxTemplateToCrs(template: string, code: string): string | null;
+/**
+ * The smallest centered square grid over the part of a CRS worth mapping, for
+ * an EPSG code without a published tile grid.
+ *
+ * Samples a 2° lng/lat lattice and keeps the points `projection` takes forward
+ * and back to where they started (a transverse Mercator's far side does not)
+ * whose local scale is at most {@link MAX_RELATIVE_SCALE} times the CRS's
+ * smallest. A polar stereographic map round-trips almost to the other pole,
+ * but out there a kilometre spans thousands of CRS units, and a grid that wide
+ * leaves the CRS's own area a speck at every useful zoom. The extent of the
+ * kept points is padded by 4%. MapLibre finds the edge of a world projection
+ * by walking out from the grid's center, so the grid is centered on them.
+ *
+ * Args:
+ *   projection: Lng/lat to CRS and back, the shape of a proj4 converter.
+ *   geographic: Whether the CRS is in degrees, which gets the whole-world grid.
+ *
+ * Returns:
+ *   The grid, or `null` when no sampled point survives the round trip.
+ */
+export declare function deriveTileMatrixSet(projection: {
+  forward(position: number[]): number[];
+  inverse(position: number[]): number[] | null;
+}, geographic: boolean): MapCrsTileMatrixSet | null;
+//#endregion
 //#region src/color-ramp.d.ts
 /**
  * Color-ramp definitions and classification-break helpers shared by the
@@ -382,7 +584,7 @@ export declare function createEqualIntervalBreaks(min: number, max: number, coun
  */
 export declare function createQuantileBreaks(values: number[], count: number): number[];
 /** The classification schemes the graduated vector renderer offers. */
-export type GraduatedClassificationScheme = "equal-interval" | "quantile" | "natural-breaks";
+export type GraduatedClassificationScheme = "equal-interval" | "quantile" | "natural-breaks" | "standard-deviation" | "geometric-interval";
 /**
  * Builds the class *lower bounds* for a graduated vector renderer.
  *
@@ -401,6 +603,12 @@ export type GraduatedClassificationScheme = "equal-interval" | "quantile" | "nat
  * MapLibre rejects a `step` expression whose inputs are not strictly ascending,
  * so this de-duplication is load-bearing, not cosmetic.
  *
+ * Standard deviation and geometric interval derive their breaks from the data,
+ * so `count` is a ceiling there: a standard-deviation break that falls outside
+ * the sample range is dropped rather than producing an empty class. See
+ * {@link standardDeviationClassBreaks} and {@link geometricIntervalClassBreaks}
+ * for how each treats its edge cases.
+ *
  * @param values - The finite numeric values of the classified property.
  * @param count - Number of classes requested.
  * @param scheme - The classification scheme.
@@ -661,6 +869,18 @@ export declare function requestMatrix(endpoint: string, body: MatrixRequestBody,
  * @returns The Valhalla `/route` response.
  */
 export declare function requestRoute(endpoint: string, body: RouteRequestBody, signal?: AbortSignal): Promise<unknown>;
+/**
+ * Requests a turn-by-turn route from the Valhalla server. Unlike
+ * {@link requestRoute}, the body is passed through as is, so the caller can ask
+ * for Valhalla's OSRM-compatible output with voice and banner instructions,
+ * alternates, a start heading, and costing options (the navigation tool).
+ *
+ * @param endpoint - The Valhalla base URL.
+ * @param body - The `/route` request body.
+ * @param signal - Optional abort signal.
+ * @returns The Valhalla `/route` response.
+ */
+export declare function requestNavigationRoute(endpoint: string, body: Record<string, unknown>, signal?: AbortSignal): Promise<unknown>;
 //#endregion
 //#region src/vector-color.d.ts
 /**
@@ -1484,6 +1704,13 @@ export declare function isAdoptedVectorAwaitingFeatures(layer: {
 export interface AttributeFormEvalOptions {
   /** Map zoom for `["zoom"]` in expressions; defaults to 0. */
   zoom?: number;
+  /**
+   * Constraints a data service enforces regardless of the form's
+   * presentation (ArcGIS domains). A field the form hides is still checked
+   * against its entry here, so a visibility rule cannot let an invalid value
+   * reach the service.
+   */
+  serviceForm?: AttributeFormConfig;
   /**
    * Real feature backing the properties, when the caller has one — its
    * geometry feeds `["geometry-type"]` and geometry-aware operators. Its
@@ -1494,7 +1721,7 @@ export interface AttributeFormEvalOptions {
 }
 /** Why a field's value was rejected; codes map to localized messages. */
 export interface AttributeFormFieldError {
-  code: "required" | "number" | "range" | "valueMap" | "constraint";
+  code: "required" | "number" | "integer" | "text" | "range" | "valueMap" | "constraint";
   /**
    * For `constraint`: the author's `constraintDescription`, or the
    * expression's own error text when it failed to evaluate.
@@ -1546,10 +1773,26 @@ export declare function isAttributeFormFieldVisible(config: AttributeFormFieldCo
 export declare function validateAttributeFormField(config: AttributeFormFieldConfig, properties: Record<string, unknown>, options?: AttributeFormEvalOptions): AttributeFormFieldError | null;
 /**
  * Validate a whole candidate properties record against a form config. Hidden
- * fields (visibility expression currently false) are skipped entirely — a
- * field the form does not show cannot block a save.
+ * fields (visibility expression currently false) skip the form's own rules —
+ * a field the form does not show cannot block a save — but are still checked
+ * against `options.serviceForm`, whose constraints the data service enforces.
  */
 export declare function validateAttributeFormValues(form: AttributeFormConfig | undefined, properties: Record<string, unknown>, options?: AttributeFormEvalOptions): AttributeFormValidation;
+/**
+ * Combine a layer's designer-authored form with the constraints its data
+ * service publishes (for example ArcGIS coded-value and range domains) into
+ * the form the editing surfaces use. The author's presentation choices
+ * (alias, visibility, constraint expression, a narrower value map or bounds)
+ * survive, but never widen what the service accepts: a service value map
+ * forces the value-map widget and keeps only author entries the service also
+ * lists (all service entries when none overlap), bounds take the tighter of
+ * each side, and the service's declared value type always applies.
+ *
+ * @param form - The layer's designer-authored config, if any.
+ * @param service - Service-derived configs, if the layer has any.
+ * @returns The effective config, or `form` itself when there is no service form.
+ */
+export declare function mergeAttributeFormConfigs(form: AttributeFormConfig | undefined, service: AttributeFormConfig | undefined): AttributeFormConfig | undefined;
 //#endregion
 //#region src/layer-descriptive-metadata.d.ts
 /** STAC specification version the Item export targets. */
@@ -2371,461 +2614,6 @@ export declare function scaleAltitudeToActiveBody(earthAltitudeMeters: number |
  */
 export declare function formatCameraAltitude(meters: number, unit: MapScaleUnit): string;
 //#endregion
-//#region src/project.d.ts
-/** Placeholder name a project carries before the user names it. */
-export declare const DEFAULT_PROJECT_NAME = "Untitled Project";
-export interface CreateProjectOptions {
-  basemapStyleUrl?: string;
-  mapView?: MapViewState;
-  /** Celestial body the project describes; defaults to Earth when omitted. */
-  ellipsoidId?: string;
-}
-export declare function normalizeBlankBackgroundColor(value: unknown): string | null;
-export declare function createDefaultMapView(): MapViewState;
-export declare function createEmptyProject(name?: string, options?: CreateProjectOptions): GeoLibreProject;
-/**
- * Serialize a project to `.geolibre.json` text: indented project structure with
- * compact (unindented) embedded GeoJSON. See {@link serializeProjectValue} for
- * why the two halves are formatted differently.
- *
- * @param project Project to serialize.
- * @returns The file contents to write.
- */
-export declare function serializeProject(project: GeoLibreProject): string;
-/**
- * Per-layer serialized text kept across {@link serializeProjectWithLayerCache}
- * calls, keyed by the layer record each entry was built from. A `WeakMap`, so a
- * layer the store has replaced or removed drops its text with it.
- */
-export type ProjectLayerSerializationCache = WeakMap<object, {
-  index: number;
-  text: string;
-}>;
-/** Create an empty {@link ProjectLayerSerializationCache}. */
-export declare function createProjectLayerSerializationCache(): ProjectLayerSerializationCache;
-/**
- * Serialize a project exactly as {@link serializeProject} does, reusing the
- * text of every layer whose source record is unchanged since an earlier call.
- *
- * Feature data lives inside layer records, so re-stringifying every layer on
- * each autosave costs megabytes of main-thread work for a project with large
- * GeoJSON layers — even when only the camera moved (GeoLibre#2633). The store
- * replaces a layer object whenever it changes, so object identity is a sound
- * cache key: a camera move reuses every layer, and an edit to one layer
- * re-serializes only that one.
- *
- * `layerSources[i]` must be the record `project.layers[i]` was derived from
- * (e.g. the store's `layers`, before `projectFromStore` prepared them), and that
- * derivation must depend on the record alone — as `buildProjectSnapshot`'s does
- * — or a cached entry could outlive a change it should have reflected. When the
- * two arrays differ in length the cache is bypassed rather than trusted.
- *
- * @param project Project to serialize, as built from `layerSources`.
- * @param layerSources Immutable source record for each entry of
- *   `project.layers`, in the same order, used as the cache key.
- * @param cache Cache shared between calls; see
- *   {@link createProjectLayerSerializationCache}.
- * @returns The same text {@link serializeProject} returns for `project`.
- */
-export declare function serializeProjectWithLayerCache(project: GeoLibreProject, layerSources: readonly object[], cache: ProjectLayerSerializationCache): string;
-/**
- * {@link serializeProjectWithLayerCache} that hands the main thread back
- * between layers, so autosave on a project with several large layers is many
- * short tasks instead of one 300-400 ms freeze (GeoLibre#2869).
- *
- * The cache makes a camera move free, so the cost lands on the first autosave
- * and on edits to a big layer: each layer that misses the cache is serialized
- * in its own slice, and the thread is released once a slice has run longer than
- * a few milliseconds. A single huge layer is still one slice. The result is
- * identical to the synchronous call. `project` and `layerSources` must not be
- * mutated while this runs; the store replaces records rather than editing them,
- * so a snapshot taken from it stays valid.
- *
- * @param project Project to serialize, as built from `layerSources`.
- * @param layerSources Immutable source record for each entry of
- *   `project.layers`, in the same order, used as the cache key.
- * @param cache Cache shared between calls.
- * @param yieldFn Hands the thread back; replaced in tests.
- * @returns The same text {@link serializeProject} returns for `project`.
- */
-export declare function serializeProjectWithLayerCacheAsync(project: GeoLibreProject, layerSources: readonly object[], cache: ProjectLayerSerializationCache, yieldFn?: () => Promise<void>): Promise<string>;
-export declare function parseProject(json: string): GeoLibreProject;
-/**
- * Validate and coerce a story map loaded from an untrusted project file.
- *
- * Returns null when the value carries no chapters so empty story maps stay out
- * of the saved project, mirroring how plugins are only persisted when present.
- *
- * @param storymap Raw value read from the project JSON.
- * @returns A normalized story map, or null when there is nothing to keep.
- */
-export declare function normalizeStoryMap(storymap: unknown): StoryMap | null;
-/** Whether a story map carries chapters or any non-default setting. */
-export declare function storyMapHasContent(story: StoryMap): boolean;
-/**
- * Coerce an untrusted (possibly hand-edited) `models` array into valid
- * {@link ProcessingModel} records. Drops models and steps without a usable id or
- * tool id, de-duplicates models by id, and keeps step `parameters` as a plain
- * object (the runner validates parameter values per tool at run time). Returns
- * `null` when there is nothing worth persisting, so a model-less project stays
- * free of the key.
- *
- * @param value Raw `models` value from the project JSON.
- * @returns Normalized models, or `null` when none survive.
- */
-export declare function normalizeModels(value: unknown): ProcessingModel[] | null;
-/**
- * Coerce an untrusted `graph` value into a {@link ProcessingModelGraph}. Drops
- * nodes without a usable id or an unknown kind, de-duplicates node ids, and
- * drops edges that do not connect two surviving nodes or that name an empty
- * port. Self-edges are dropped too, since a node cannot feed itself.
- *
- * Structural validity beyond this (cycles, type mismatches, missing required
- * inputs) is the runner's job — those depend on the tool registries, which the
- * project layer deliberately does not import.
- *
- * @param value Raw `graph` value from the project JSON.
- * @returns The normalized graph, or `null` when it has no usable nodes.
- */
-export declare function normalizeModelGraph(value: unknown): ProcessingModelGraph | null;
-/**
- * Coerce an untrusted (possibly hand-edited) `processingHistory` array into
- * valid {@link ProcessingRun} records. Drops entries without a usable id, tool
- * id, or known kind, de-duplicates by id, keeps `parameters` as a plain object,
- * and caps the list at {@link MAX_PROCESSING_HISTORY} (keeping the newest,
- * i.e. last, entries). Returns `null` when nothing survives, so a history-less
- * project stays free of the key.
- *
- * @param value Raw `processingHistory` value from the project JSON.
- * @returns Normalized runs, or `null` when none survive.
- */
-export declare function normalizeProcessingHistory(value: unknown): ProcessingRun[] | null;
-/**
- * Coerce an untrusted (possibly hand-edited) camera object into a valid
- * {@link MapViewState}, falling back to the default view for missing parts.
- */
-export declare function normalizeMapViewState(value: unknown): MapViewState;
-/**
- * Coerce an untrusted `mapLayout` into a valid {@link MapGridLayout}. Returns
- * null when absent or effectively single-pane so default projects stay
- * byte-identical (the field is only written when the grid is larger than 1x1).
- */
-export declare function normalizeMapLayout(value: unknown): MapGridLayout | null;
-/**
- * Coerce an untrusted `primaryRenderer` into a known engine id (issue #2217).
- *
- * Returns null for the default 2D map — absent, unknown, or an explicit
- * `"maplibre"` — because the field is only written when it is not the default,
- * so a MapLibre project serializes byte-identically to before this existed.
- * The return type is narrowed to `"cesium" | "mapbox" | "arcgis" | null` rather
- * than the full {@link MapRendererKind} for that reason: `"maplibre"` is never a
- * result.
- */
-export declare function normalizePrimaryRenderer(value: unknown): "cesium" | "mapbox" | "arcgis" | null;
-/**
- * Coerce an untrusted `secondaryMapViews` array into valid
- * {@link SecondaryMapView} records, dropping entries without a usable id and
- * de-duplicating by id. Returns null when none are valid.
- */
-export declare function normalizeSecondaryMapViews(value: unknown): SecondaryMapView[] | null;
-/**
- * Reconcile a parsed grid layout with its secondary panes so the store invariant
- * holds: `secondaryMapViews.length === rows * cols - 1`. Surplus panes are
- * dropped; missing panes are filled by cloning the primary map. A null/absent
- * layout (or a 1x1 grid) collapses to the single-map default.
- */
-export declare function resolveMapGrid(layout: MapGridLayout | null, secondaryViews: SecondaryMapView[] | null, primary: {
-  mapView: MapViewState;
-}): {
-  mapLayout: MapGridLayout;
-  secondaryMapViews: SecondaryMapView[];
-};
-/**
- * Coerce an untrusted (possibly hand-edited) `widgets` array into valid
- * {@link DashboardWidget} records. Drops widgets without a usable id, layer id,
- * or recognized chart type, de-duplicates by id, and keeps only the optional
- * keys that are present and well-typed (the Dashboard panel falls back to
- * sensible defaults for anything missing). Returns `null` when there is nothing
- * worth persisting, so a widget-less project stays free of the key.
- *
- * @param value Raw `widgets` value from the project JSON.
- * @returns Normalized widgets, or `null` when none survive.
- */
-export declare function normalizeWidgets(value: unknown): DashboardWidget[] | null;
-/**
- * Clamp an untrusted dashboard column count into the supported range, falling
- * back to the default for a missing or non-finite value.
- *
- * @param value Raw `dashboardColumns` value from the project JSON.
- * @returns An integer column count within [MIN, MAX].
- */
-export declare function normalizeDashboardColumns(value: unknown): number;
-/**
- * Coerce an untrusted `interaction` block into a {@link ProjectInteraction}.
- *
- * Layer ids are kept even when no such layer exists: the block is replayed
- * against whatever layers the project has when it opens, and the loader drops
- * the ones it cannot find. Control names are kept as written for the same
- * reason; the app ignores names it does not know.
- *
- * @param value - Raw `interaction` value from the project JSON or the store.
- * @returns The normalized block, or null when it carries nothing to apply.
- */
-export declare function normalizeProjectInteraction(value: unknown): ProjectInteraction | null;
-export declare function isAllowedPluginManifestUrl(url: string): boolean;
-export declare function normalizeProjectComments(rawComments: unknown): ProjectComment[];
-export declare function projectFromStore(state: {
-  projectName: string;
-  mapView: MapViewState;
-  basemapStyleUrl: string;
-  basemapVisible: boolean;
-  basemapOpacity: number;
-  blankBackgroundColor?: string | null;
-  layers: GeoLibreLayer[];
-  selectedLayerId?: string | null;
-  layerGroups?: LayerGroup[];
-  preferences: ProjectPreferences;
-  plugins?: ProjectPluginState | null;
-  legend?: LegendConfig | null;
-  printLayout?: PrintLayoutConfig | null;
-  storymap?: StoryMap | null;
-  models?: ProcessingModel[] | null;
-  processingHistory?: ProcessingRun[] | null;
-  widgets?: DashboardWidget[] | null;
-  dashboardColumns?: number;
-  mapLayout?: MapGridLayout;
-  secondaryMapViews?: SecondaryMapView[];
-  primaryMapLabel?: string;
-  primaryRenderer?: MapRendererKind;
-  /** Project-scoped Style Manager entries (the store's `projectStyleLibrary`). */
-  styleLibrary?: StyleLibraryEntry[] | null;
-  comments?: ProjectComment[] | null;
-  /** Startup interaction state loaded with the project, written back as-is. */
-  interaction?: ProjectInteraction | null;
-  metadata: Record<string, unknown>;
-}): GeoLibreProject;
-/**
- * The plain HTTP(S) WMS template inside the desktop app's `geolibre-wms://`
- * wrapper (its CORS-exempt native fetcher), or the tile unchanged when it is
- * not wrapped or the wrapped URL is not HTTP(S). Shared by project export and
- * the ArcGIS engine's story-export templates.
- *
- * @param tile - A tile template, wrapped or not.
- * @returns The unwrapped template, or `tile` itself.
- */
-export declare function portableWmsTileUrl(tile: unknown): unknown;
-/**
- * The store form of one project layer: its style completed from
- * {@link DEFAULT_LAYER_STYLE} and the project's top-level `styles` entry.
- *
- * Legacy and externally-authored projects can carry a partial top-level style
- * alongside newer fields on the layer itself. Those layer fields are kept,
- * while the top-level copy stays authoritative where it explicitly supplies a
- * value.
- *
- * @param project - The project the layer belongs to (for its `styles` map).
- * @param layer - One of `project.layers`.
- * @returns A new layer record ready for the store.
- */
-export declare function hydrateProjectLayer(project: Pick<GeoLibreProject, "styles">, layer: GeoLibreLayer): GeoLibreLayer;
-export declare function applyProjectToStore(project: GeoLibreProject): {
-  projectName: string;
-  mapView: MapViewState;
-  basemapStyleUrl: string;
-  basemapVisible: boolean;
-  basemapOpacity: number;
-  blankBackgroundColor: string | null;
-  layers: GeoLibreLayer[];
-  layerGroups: LayerGroup[];
-  preferences: ProjectPreferences;
-  projectPlugins: ProjectPluginState | null;
-  legend: LegendConfig;
-  printLayout: PrintLayoutConfig;
-  storymap: StoryMap | null;
-  models: ProcessingModel[];
-  processingHistory: ProcessingRun[];
-  widgets: DashboardWidget[];
-  dashboardColumns: number;
-  mapLayout: MapGridLayout;
-  secondaryMapViews: SecondaryMapView[];
-  primaryMapLabel: string;
-  primaryRenderer: MapRendererKind;
-  projectStyleLibrary: StyleLibraryEntry[];
-  comments: ProjectComment[];
-  projectInteraction: ProjectInteraction | null;
-  metadata: Record<string, unknown>;
-};
-/**
- * Create an unlinked copy of a project, suffixed with "(copy)" by default and
- * stripped of share-specific metadata (shareId, shareUrl, etc.).
- */
-export declare function detachProjectCopy(project: GeoLibreProject, options?: {
-  nameSuffix?: string;
-}): GeoLibreProject;
-/**
- * Create a template snapshot of a project. Optionally strips data layers while
- * keeping basemap, layer groups, styles, legend config, preferences, widgets, and
- * print layout.
- */
-export declare function createProjectTemplate(project: GeoLibreProject, options?: {
-  name?: string;
-  stripDataLayers?: boolean;
-}): GeoLibreProject;
-//#endregion
-//#region src/project-diff.d.ts
-/** One changed value, with bounded human-readable previews of each side. */
-export interface ProjectValueChange {
-  /** Dotted key path relative to the section, e.g. `fillColor` or `labels.field`. */
-  path: string;
-  /** Preview of the earlier value; `undefined` when the key was absent. */
-  before?: string;
-  /** Preview of the later value; `undefined` when the key is now absent. */
-  after?: string;
-}
-/** Counts of embedded GeoJSON feature changes in one layer. */
-export interface FeatureChangeSummary {
-  added: number;
-  removed: number;
-  modified: number;
-  unchanged: number;
-  /**
-   * How features were matched: `"id"` when every feature carries a unique
-   * `id`, `"geometry"` when none does (matched by geometry hash), `"mixed"`
-   * otherwise.
-   */
-  matchedBy: "id" | "geometry" | "mixed";
-}
-/** Changes to one layer between the two projects. */
-export interface LayerDiff {
-  id: string;
-  /** Layer name in the later project (or the earlier one when removed). */
-  name: string;
-  /** Layer type in the later project (or the earlier one when removed). */
-  type: string;
-  status: "added" | "removed" | "changed";
-  /** Set when the layer was renamed. */
-  renamed?: {
-    before: string;
-    after: string;
-  };
-  /**
-   * Set when the layer changed position relative to the layers present in
-   * both projects (bottom-to-top indexes in each project's `layers`).
-   */
-  moved?: {
-    before: number;
-    after: number;
-  };
-  visibility?: {
-    before: boolean;
-    after: boolean;
-  };
-  opacity?: {
-    before: number;
-    after: number;
-  };
-  /** Style keys other than labels. */
-  style: ProjectValueChange[];
-  /** Label style keys (`style.labels.*`), without the `labels.` prefix. */
-  labels: ProjectValueChange[];
-  /** `filterExpression` and `quickFilters`. */
-  filter: ProjectValueChange[];
-  /** `type`, `source.*` and `sourcePath`. */
-  source: ProjectValueChange[];
-  /** Any other persisted layer field (popup, joins, metadata.*, ...). */
-  other: ProjectValueChange[];
-  /** Embedded GeoJSON feature changes; absent when the data is unchanged. */
-  features?: FeatureChangeSummary;
-  /** Feature count for an added or removed layer with embedded GeoJSON. */
-  featureCount?: number;
-}
-/** Changes to one plugin's project state. */
-export interface PluginDiff {
-  id: string;
-  /** `added`/`removed` mean the plugin was activated/deactivated. */
-  status: "added" | "removed" | "changed";
-  changes: ProjectValueChange[];
-}
-/** The full structured difference between two projects. */
-export interface ProjectDiff {
-  layers: {
-    added: LayerDiff[];
-    removed: LayerDiff[];
-    changed: LayerDiff[];
-    /** True when any layer present in both projects changed position. */
-    reordered: boolean;
-  };
-  camera: ProjectValueChange[];
-  basemap: ProjectValueChange[];
-  /** Map projection (`preferences.map.projection`). */
-  projection: ProjectValueChange[];
-  /** Other project preferences (`preferences.*` minus the projection). */
-  preferences: ProjectValueChange[];
-  plugins: PluginDiff[];
-  /** Plugin manifest URLs added to or removed from the project. */
-  pluginManifests: {
-    added: string[];
-    removed: string[];
-  };
-  /** Project name (`name`), `metadata.description` and other metadata keys. */
-  metadata: ProjectValueChange[];
-  /** Other top-level sections that changed (`legend`, `storymap`, ...). */
-  sections: string[];
-  /** Total number of reported changes; 0 means the projects are equivalent. */
-  changeCount: number;
-}
-/** Options for {@link diffProjects}. */
-export interface ProjectDiffOptions {
-  /** Maximum characters of a before/after preview (default 80). */
-  maxPreviewLength?: number;
-}
-/**
- * Deep structural equality for JSON-like values. A key whose value is
- * `undefined` is treated as absent, so an in-memory record compares equal to
- * its JSON round trip.
- *
- * @param a - First value.
- * @param b - Second value.
- * @returns True when the two values are structurally equal.
- */
-export declare function jsonValuesEqual(a: unknown, b: unknown): boolean;
-/**
- * Render a bounded JSON-ish preview of a value without serializing more of it
- * than the preview can show, so a large array or object costs no more than
- * `maxLength` characters of work.
- *
- * @param value - The value to preview.
- * @param maxLength - Maximum preview length; longer output ends with `…`.
- * @returns The preview, or `undefined` for `undefined`.
- */
-export declare function previewValue(value: unknown, maxLength?: number): string | undefined;
-/**
- * Count the features added, removed and modified between two feature
- * collections. Features are matched by `id` when they carry one; id-less
- * features are matched by geometry hash, so a feature whose properties
- * changed but whose geometry did not counts as modified, while a moved
- * id-less feature counts as one removal plus one addition.
- *
- * @param before - Earlier collection (absent counts as empty).
- * @param after - Later collection (absent counts as empty).
- * @returns The change counts.
- */
-export declare function diffFeatureCollections(before: FeatureCollection | null | undefined, after: FeatureCollection | null | undefined): FeatureChangeSummary;
-/**
- * Compute a structured summary of what changed from `before` to `after`.
- *
- * Layers are matched by id. Embedded GeoJSON is compared per feature (by id,
- * falling back to geometry hash) and each feature is hashed once per object,
- * so diffing the same parsed project against several others reuses its
- * hashes; callers keep and pass the same parsed project objects to benefit.
- *
- * @param before - The earlier project (e.g. an autosave snapshot).
- * @param after - The later project (e.g. the current project).
- * @param options - Preview length and other tuning.
- * @returns The grouped change summary.
- */
-export declare function diffProjects(before: GeoLibreProject, after: GeoLibreProject, options?: ProjectDiffOptions): ProjectDiff;
-//#endregion
 //#region src/style-library.d.ts
 /**
  * Layer types whose symbology is driven by the vector {@link LayerStyle}
@@ -2957,6 +2745,26 @@ export declare const MAX_LAYER_LIBRARY_ENTRIES = 500;
  * @returns True when the source alone is enough to recreate the layer's data.
  */
 export declare function hasRestorableLayerSource(layer: Pick<GeoLibreLayer, "source" | "metadata">): boolean;
+/**
+ * The absolute local path a layer's data can be **re-read** from, or undefined.
+ *
+ * A non-empty `sourcePath` is not enough on its own: a file picked in the
+ * browser has no path, and both the vector and raster controls still record the
+ * bare file *name* there for display. Each control marks a genuinely re-readable
+ * absolute path differently, so both conventions are honored:
+ *
+ * - Vector / plain local GeoJSON: `metadata.localFileReloadable` alongside an
+ *   absolute `sourcePath` (`prepareLayerForSave`, `needsLocalFileReload`,
+ *   `restoreVectorLayers`).
+ * - Raster / COG: `metadata.localFilePath` holds the absolute path outright,
+ *   and it is what `restoreRasterLayers` re-reads on restore. Without this
+ *   branch a locally-opened COG could not be saved at all, even though its
+ *   restore pass is fully able to replay it.
+ *
+ * Every candidate is re-validated, because a hand-edited project or an imported
+ * bundle can set these fields to anything.
+ */
+export declare function layerLocalPath(layer: Pick<GeoLibreLayer, "sourcePath" | "metadata">): string | undefined;
 /**
  * Whether "Save to library" applies to a layer at all — the cheap predicate the
  * layer actions menu gates on. Two things have to hold:
@@ -3445,6 +3253,88 @@ export interface LayerStyleMatch {
  */
 export declare function matchLayerStyleEntry(layer: GeoLibreLayer, entries: readonly LayerStyleFileEntry[]): LayerStyleMatch | null;
 //#endregion
+//#region src/layers-file.d.ts
+/** `type` tag identifying a layers file. */
+export declare const LAYERS_FILE_TYPE = "geolibre-layers";
+/** Format version written by {@link serializeLayersFile}. */
+export declare const LAYERS_FILE_VERSION = 1;
+/**
+ * Size ceiling for a layers file, in UTF-8 bytes. A file of references is a few
+ * kilobytes per layer, and the Startup setting keeps a parsed copy in the
+ * desktop settings (localStorage), so a file past this is refused rather than
+ * crowding out the rest of the settings.
+ */
+export declare const MAX_LAYERS_FILE_BYTES: number;
+/** The layers and the folders they sit in. */
+export interface LayersFileContent {
+  /** Layer records in store (bottom-to-top) order. */
+  layers: GeoLibreLayer[];
+  /** The folders the layers belong to, with their ancestors. */
+  layerGroups: LayerGroup[];
+}
+/** The on-disk layers document. */
+export interface LayersFile extends LayersFileContent {
+  type: typeof LAYERS_FILE_TYPE;
+  version: typeof LAYERS_FILE_VERSION;
+}
+/**
+ * Whether a layer (in its saved form) points at its data rather than carrying
+ * it: it has a re-fetchable source, an http(s) source path, or an absolute
+ * local path the desktop app re-reads, and holds no inline features.
+ *
+ * @param layer - A layer as `projectFromStore` writes it.
+ * @returns True when the layer can go in a layers file.
+ */
+export declare function isReferencedLayer(layer: GeoLibreLayer): boolean;
+/**
+ * Pick the layers of a saved project that can go in a layers file.
+ *
+ * @param project - A project as `projectFromStore` writes it. A host that can
+ *   re-fetch a layer's features (a GeoJSON layer loaded from a URL) strips its
+ *   `geojson` first, so the layer counts as a reference here.
+ * @returns The file content, and the names of the layers left out because they
+ *   carry their data inline.
+ */
+export declare function extractLayersFileContent(project: Pick<GeoLibreProject, "layers" | "layerGroups">): {
+  content: LayersFileContent;
+  skipped: string[];
+};
+/**
+ * Serialize layers into the JSON written by Export Layers.
+ *
+ * @param content - The layers and their folders.
+ * @returns Pretty-printed file content.
+ */
+export declare function serializeLayersFile(content: LayersFileContent): string;
+/**
+ * Coerce untrusted layers (a hand-edited file, or the copy kept in settings)
+ * into clean ones. Each layer goes through the same normalization a project
+ * file's layers do; one without an id, a name, a known type, or a reference to
+ * its data is dropped, as is a repeated id.
+ *
+ * @param value - An object with `layers` and optional `layerGroups` arrays.
+ * @returns The usable layers and the folders they sit in.
+ */
+export declare function normalizeLayersFileContent(value: unknown): LayersFileContent;
+/**
+ * Parse a file written by {@link serializeLayersFile}.
+ *
+ * @param json - The file content.
+ * @returns The normalized layers and folders.
+ * @throws Error when the content is too large, is not a layers file, comes
+ *   from a newer format version, or holds no usable layers.
+ */
+export declare function parseLayersFile(json: string): LayersFileContent;
+/**
+ * Add a layers file's layers on top of a project's own, keeping the project's
+ * layers where an id repeats.
+ *
+ * @param project - The project to add to (usually a new, empty one).
+ * @param content - The layers and folders to add.
+ * @returns A new project with the layers added.
+ */
+export declare function addLayersToProject(project: GeoLibreProject, content: LayersFileContent): GeoLibreProject;
+//#endregion
 //#region src/layer-groups.d.ts
 /** Opacity a freshly created {@link LayerGroup} starts at (fully opaque). */
 export declare const DEFAULT_LAYER_GROUP_OPACITY = 1;
@@ -3881,6 +3771,15 @@ export interface S3UrlSigner {
     status: number;
     body: string;
   }>;
+  /**
+   * Drops the cached credentials and signed URLs of the connection that
+   * serves `target`, so the next `presign` resolves them afresh. Called when S3
+   * refuses a request as expired.
+   */
+  invalidateCredentials?(target: {
+    bucket?: string;
+    connectionId?: string;
+  }): void;
   /** The persisted location (`s3://bucket/prefix/`) the S3 browser opens at, or "". */
   defaultLocation?(): string;
   /** Persists the S3 browser's default location; "" clears it. */
@@ -3978,6 +3877,14 @@ export declare function explainS3ReadError(url: string, error: unknown, translat
  */
 export declare function createSampleStoryMap(): StoryMap;
 //#endregion
+//#region src/storymap-duration.d.ts
+/** Default chapter dwell time after the camera arrives, in seconds. */
+export declare const DEFAULT_STORY_CHAPTER_DURATION_SECONDS = 15;
+export declare const MIN_STORY_CHAPTER_DURATION_SECONDS = 1;
+export declare const MAX_STORY_CHAPTER_DURATION_SECONDS = 3600;
+/** Resolve old or hand-authored chapter timings to a safe autoplay duration. */
+export declare function normalizeStoryChapterDurationSeconds(value: unknown): number;
+//#endregion
 //#region src/storymap-playback.d.ts
 /**
  * The opacity a story presentation has applied to a layer.
@@ -4288,7 +4195,10 @@ interface LayersSlice {
   reorderLayer: (id: string, direction: "up" | "down") => void;
   moveLayer: (id: string, targetIndex: number) => void;
   moveLayersRelative: (layerIds: string[], targetLayerId: string, position: "above" | "below") => void;
-  addGeoJsonLayer: (name: string, geojson: FeatureCollection, sourcePath?: string, beforeLayerId?: string | null) => string;
+  addGeoJsonLayer: (name: string, geojson: FeatureCollection, sourcePath?: string, beforeLayerId?: string | null, extra?: {
+    geoarrow?: GeoArrowBatch;
+    metadata?: Record<string, unknown>;
+  }) => string;
   /**
    * Add a georeferenced image overlay (a MapLibre `image` source rendered as a
    * raster layer) from an image URL and its four corner coordinates, and return
@@ -4486,6 +4396,11 @@ interface ProcessingSlice {
   models: ProcessingModel[];
   /** Recorded processing tool runs, oldest first (Processing History; #1292). */
   processingHistory: ProcessingRun[];
+  /**
+   * Object-Based Analysis workbench state saved with the project (#3053), an
+   * app-owned JSON object; null until the workbench is used.
+   */
+  obiaWorkbench: Record<string, unknown> | null;
   /** Insert a new model or replace an existing one matching by `id`. */
   saveModel: (model: ProcessingModel) => void;
   /** Remove a saved model by id. */
@@ -4496,6 +4411,11 @@ interface ProcessingSlice {
   updateProcessingRun: (id: string, patch: Partial<Omit<ProcessingRun, "id">>) => void;
   /** Drop all recorded processing runs. */
   clearProcessingHistory: () => void;
+  /**
+   * Replace the saved workbench state. `markDirty` is false when the app is
+   * only mirroring state it just restored, so opening a project stays clean.
+   */
+  setObiaWorkbench: (value: Record<string, unknown> | null, markDirty?: boolean) => void;
 }
 //#endregion
 //#region src/store/project-content-slice.d.ts
@@ -4505,6 +4425,10 @@ interface ProjectContentSlice {
   widgets: DashboardWidget[];
   /** Number of columns in the Dashboard widget grid. */
   dashboardColumns: number;
+  /** Saved map views from the Bookmarks panel, in panel order (#2869). */
+  bookmarks: ProjectBookmark[];
+  /** Folders the bookmarks are organized into. */
+  bookmarkGroups: ProjectBookmarkGroup[];
   /** Anchored review comments on map points or features (issue #1518). */
   comments: ProjectComment[];
   /**
@@ -4540,6 +4464,11 @@ interface ProjectContentSlice {
   toggleResolveComment: (commentId: string, resolved?: boolean) => void;
   deleteComment: (commentId: string) => void;
   setComments: (comments: ProjectComment[]) => void;
+  /**
+   * Replace every bookmark and folder (the Bookmarks panel writes its whole
+   * state back after each edit). Marks the project dirty.
+   */
+  setBookmarks: (bookmarks: ProjectBookmark[], bookmarkGroups: ProjectBookmarkGroup[]) => void;
 }
 //#endregion
 //#region src/store/project-slice.d.ts
@@ -4564,8 +4493,14 @@ interface ProjectSlice {
    */
   setPrintLayout: (printLayout: PrintLayoutConfig) => void;
   setProjectPlugins: (projectPlugins: ProjectPluginState | null, shouldMarkDirty?: boolean) => void;
+  /**
+   * Start a new, untitled project. `layers` and `layerGroups` seed it with
+   * layers (the Startup setting's default layers).
+   */
   newProject: (options?: CreateProjectOptions & {
     name?: string;
+    layers?: GeoLibreLayer[];
+    layerGroups?: LayerGroup[];
   }) => void;
   loadProject: (project: GeoLibreProject, path?: string | null, options?: {
     rememberRecent?: boolean;
@@ -4664,6 +4599,9 @@ interface SessionSlice {
    * plain meaning.
    */
   identifyLayerIds: string[] | null;
+  /** Transient map-selection gesture activity, published by the primary renderer. */
+  featureSelectionActive: boolean;
+  setFeatureSelectionActive: (active: boolean) => void;
   pointerCoords: [number, number] | null;
   /**
    * Ground elevation in true metres under the pointer, for the status bar
@@ -4848,7 +4786,7 @@ interface AppState extends ProjectSlice, MapViewSlice, LayersSlice, LayerGroupsS
 //#endregion
 //#region src/store/undo-history.d.ts
 /** The fields undo/redo snapshots, restores and compares. */
-type HistoryState = Pick<AppState, "layers" | "layerGroups" | "basemapStyleUrl" | "basemapVisible" | "basemapOpacity" | "blankBackgroundColor" | "storymap" | "comments">;
+type HistoryState = Pick<AppState, "layers" | "layerGroups" | "basemapStyleUrl" | "basemapVisible" | "basemapOpacity" | "blankBackgroundColor" | "storymap" | "comments" | "widgets" | "legend">;
 export declare function subscribeProjectRestoreHistory(listener: () => void): () => void;
 export declare function canUndoProjectRestore(): boolean;
 export declare function canRedoProjectRestore(): boolean;
@@ -4868,6 +4806,14 @@ export declare function registerProjectRestoreHistory(before: GeoLibreProject, b
 export declare function undo(): void;
 /** Step the history forward one entry and mark the project dirty. */
 export declare function redo(): void;
+/**
+ * Apply a store change that is not the user's (data loading in behind a
+ * project) without recording an undo step for it. The history stays as it
+ * was, so undo neither takes the change back out nor loses earlier steps.
+ *
+ * @param change - The store updates to apply.
+ */
+export declare function withoutHistory(change: () => void): void;
 /** Empty both the undo and redo stacks (e.g. on new/loaded project). */
 export declare function clearHistory(): void;
 //#endregion
@@ -5041,7 +4987,8 @@ export declare function trimHistoryBySize<T extends HistorySnapshot>(pastStates:
  *
  * Providers: geocoding is dispatched through a small {@link GeocodingProvider}
  * registry so alternatives to Nominatim (ArcGIS World Geocoder, CartoCiudad, Mapbox,
- * Pelias, Google) can be selected per project. Each provider builds its own request
+ * Pelias, Google, organization-hosted ArcGIS GeocodeServer locators) can be
+ * selected per project. Each provider builds its own request
  * URLs and normalizes its response into a {@link GeocodeMatch} (forward) or a
  * {@link ReverseGeocodeDisplay} (reverse), so the dialog and plugin stay
  * provider-agnostic. Nominatim is the default.
@@ -5084,8 +5031,10 @@ export declare const GEOCODE_SCORE_KEY = "geocode_importance";
 export declare const GEOCODE_PROVIDER_KEY = "geocode_provider";
 /** Whether a row matched, when stamped. See {@link GeocodeStatus}. */
 export declare const GEOCODE_STATUS_KEY = "geocode_status";
+/** Prefix of a matched candidate's own attributes, when they are kept. */
+export declare const GEOCODE_ATTRIBUTE_PREFIX = "geocode_attr_";
 /** Identifier of a selectable geocoding backend. */
-type GeocodingProviderId = "nominatim" | "pelias" | "arcgis" | "mapbox" | "google" | "cartociudad";
+type GeocodingProviderId = "nominatim" | "pelias" | "arcgis" | "arcgis-locator" | "mapbox" | "google" | "cartociudad";
 /** The provider used when none is configured. */
 export declare const DEFAULT_GEOCODING_PROVIDER_ID: GeocodingProviderId;
 interface GeocoderConfig {
@@ -5099,11 +5048,34 @@ interface GeocoderConfig {
   email?: string;
   /** API key / access token for providers that require one. */
   apiKey?: string;
+  /** The selected locator, for the `arcgis-locator` provider. */
+  locator?: GeocodingLocator;
+}
+/**
+ * An error the geocoding service reported about the request itself, as opposed
+ * to a network failure or a search with no matches. ArcGIS answers failures with
+ * HTTP 200 and an `error` envelope, so `response.ok` alone would turn them into
+ * an empty result. `code` is the service's own code (498/499 for a missing or
+ * invalid token, 403 for insufficient permission).
+ */
+export declare class GeocoderServiceError extends Error {
+  readonly code: number | undefined;
+  constructor(message: string, code?: number);
+  /** Whether the service asked for a token or rejected the one it got. */
+  get isAuthError(): boolean;
+}
+/** The configured geocoder does not support the requested operation. */
+export declare class GeocoderUnsupportedError extends Error {
+  constructor(message: string);
 }
 /** Per-request options passed to a provider's forward URL builder. */
 interface ForwardRequestOptions {
   email?: string;
   limit?: number;
+  /** A suggestion's key, so the locator resolves exactly that suggestion. */
+  magicKey?: string;
+  /** Ask for each candidate's own attributes (see {@link GeocodeMatch.attributes}). */
+  attributes?: boolean;
 }
 /** Per-request options passed to a provider's reverse URL builder. */
 interface ReverseRequestOptions {
@@ -5122,6 +5094,19 @@ interface GeocodeMatch {
   lon: number;
   displayName: string;
   score: number | null;
+  /**
+   * The candidate's own attributes, when the service returns them (an
+   * organization locator's parcel or asset identifiers, address type, ...).
+   * Empty values are left out.
+   */
+  attributes?: Record<string, string | number | boolean>;
+}
+/** A partial-text suggestion from a locator's `suggest` operation. */
+interface GeocodeSuggestion {
+  /** The suggested place, as the locator words it. */
+  text: string;
+  /** Opaque key that `findAddressCandidates` resolves to this suggestion. */
+  magicKey: string;
 }
 /**
  * A geocoding backend. Builds provider-specific request URLs and normalizes the
@@ -5218,9 +5203,12 @@ export declare function buildReverseGeocodeUrl(endpoint: string, lon: number, la
  * `extra.providerId`, when passed, also stamps `geocode_provider` and
  * `geocode_status: "matched"` (dropped when omitted, so the existing
  * `GeocodeDialog` call site keeps its current output unchanged).
+ * `extra.attributes` also adds the candidate's own attributes, each under
+ * {@link GEOCODE_ATTRIBUTE_PREFIX} plus its name.
  */
 export declare function geocodeMatchToFeature(match: GeocodeMatch, originalRow?: Record<string, string>, extra?: {
   providerId?: GeocodingProviderId;
+  attributes?: boolean;
 }): Feature<Point> | null;
 /**
  * Build a null-geometry Feature for a CSV row that could not be geocoded, so
@@ -5243,6 +5231,48 @@ export declare function nominatimResultToFeature(result: NominatimForwardResult,
  * null when the point could not be reverse-geocoded.
  */
 export declare function nominatimReverseResultToDisplay(result: NominatimReverseResult | null): ReverseGeocodeDisplay | null;
+/**
+ * The GeocodeServer base URL of a pasted locator URL: an operation suffix
+ * (`/findAddressCandidates`, ...), the query string and any credentials are
+ * dropped, so a token in a pasted URL is never stored.
+ *
+ * @param input - The URL as typed.
+ * @returns The base URL ending in `/GeocodeServer`, or null when it is not one.
+ */
+export declare function normalizeArcGISLocatorUrl(input: string | undefined | null): string | null;
+/**
+ * Coerce a stored locator to a {@link GeocodingLocator}, or null when it has no
+ * usable id or GeocodeServer URL. Used for project files and runtime env, so
+ * anything unexpected is dropped rather than trusted.
+ *
+ * @param value - The stored value.
+ * @returns The locator, or null.
+ */
+export declare function normalizeGeocodingLocator(value: unknown): GeocodingLocator | null;
+/** What a GeocodeServer's `?f=json` metadata says it supports. */
+type ArcGISLocatorCapabilities = Required<Pick<GeocodingLocator, "reverse" | "suggest">> & Pick<GeocodingLocator, "singleLineField" | "addressFields">;
+/**
+ * Read a GeocodeServer's capabilities from its `?f=json` metadata. A service
+ * that lists no `capabilities` (older ArcGIS Server) is taken to support
+ * geocoding and reverse geocoding but not suggestions.
+ *
+ * @param data - The parsed metadata.
+ * @returns The capabilities.
+ * @throws GeocoderServiceError For an error envelope, or metadata that is not a
+ *   GeocodeServer's.
+ * @throws GeocoderUnsupportedError When the service does not geocode.
+ */
+export declare function parseArcGISLocatorInfo(data: unknown): ArcGISLocatorCapabilities;
+/**
+ * The input field a single search string is sent in: the published field the
+ * user chose for it, else the locator's single-line field, else its only
+ * structured field (an asset ID locator often publishes just one), else
+ * ArcGIS's conventional `SingleLine`.
+ *
+ * @param locator - The locator.
+ * @returns The input field name.
+ */
+export declare function arcgisLocatorInputField(locator: GeocodingLocator): string;
 /** All selectable geocoding providers, Nominatim first (the default). */
 export declare const GEOCODING_PROVIDERS: readonly GeocodingProvider[];
 /** Coerce an arbitrary string to a known provider id, defaulting to Nominatim. */
@@ -5253,10 +5283,19 @@ export declare function getGeocodingProvider(id: string | undefined | null): Geo
  * Resolve the geocoder configuration from runtime env, falling back to the
  * selected provider's default endpoints. `VITE_GEOCODER_PROVIDER` selects the
  * backend; `VITE_GEOCODER_ENDPOINT`/`VITE_GEOCODER_REVERSE_ENDPOINT` override
- * the endpoints; `VITE_GEOCODER_EMAIL` supplies the contact email; and
+ * the endpoints (except for `arcgis-locator`, whose endpoints always come from
+ * `VITE_GEOCODER_LOCATOR`); `VITE_GEOCODER_EMAIL` supplies the contact email; and
  * `VITE_GEOCODER_API_KEY` supplies the API key for keyed providers.
  */
 export declare function getGeocoderConfig(): GeocoderConfig;
+/**
+ * The locator the `arcgis-locator` provider uses: the one `locatorId` names,
+ * else the first configured.
+ *
+ * @param input - The geocoding preference.
+ * @returns The locator, or undefined when none is configured.
+ */
+export declare function selectedGeocodingLocator(input: Pick<GeocodingPreferenceInput, "locators" | "locatorId">): GeocodingLocator | undefined;
 /** Inputs to {@link resolveGeocoderConfig}, mirroring the project preference. */
 interface GeocodingPreferenceInput {
   providerId?: string;
@@ -5267,6 +5306,10 @@ interface GeocodingPreferenceInput {
   /** Optional custom reverse endpoint (else the provider default). */
   reverseEndpoint?: string;
   email?: string;
+  /** Configured ArcGIS GeocodeServer locators. */
+  locators?: GeocodingLocator[];
+  /** The locator the `arcgis-locator` provider uses. */
+  locatorId?: string;
 }
 /**
  * Build a {@link GeocoderConfig} from structured project preferences. Used by
@@ -5346,6 +5389,75 @@ export declare function csvRowsToGeocodeRequests(rows: Record<string, string>[],
  * Safe to call multiple times; only the most recent implementation is used.
  */
 export declare function setGeocodingFetch(fetchImpl: typeof globalThis.fetch | null): void;
+/**
+ * Resolves the access token for a secured locator, or undefined to send the
+ * request without one. See {@link setGeocodingTokenProvider}.
+ */
+type GeocodingTokenProvider = (locator: GeocodingLocator) => Promise<string | undefined>;
+/**
+ * Register how a secured locator gets its token, or pass null to remove it.
+ *
+ * Core has no sign-in of its own: the app installs a provider that reuses its
+ * ArcGIS portal sessions. It is only consulted for a locator that names a
+ * `portalUrl`, and the provider decides whether that portal's token may be sent
+ * to the locator's host, so a token is never forwarded to an unrelated server.
+ *
+ * @param provider - The token provider, or null.
+ */
+export declare function setGeocodingTokenProvider(provider: GeocodingTokenProvider | null): void;
+/**
+ * Whether `config` can reverse-geocode: a locator only when its metadata
+ * advertises `reverseGeocode` (unchecked locators are assumed to).
+ *
+ * @param config - The geocoder configuration.
+ * @returns Whether reverse geocoding is available.
+ */
+export declare function geocoderSupportsReverse(config: GeocoderConfig): boolean;
+/**
+ * Whether `config` offers suggestions while typing: a locator whose metadata
+ * advertises `suggest`, searched through its single-line field (a suggestion
+ * is a whole address, so it does not fit a structured field the user chose).
+ *
+ * @param config - The geocoder configuration.
+ * @returns Whether {@link geocodeSuggest} can be used.
+ */
+export declare function geocoderSupportsSuggest(config: GeocoderConfig): boolean;
+/**
+ * Normalize an ArcGIS `suggest` response. Collection suggestions (a category
+ * such as "Coffee shop") are dropped: they name many places, not one.
+ *
+ * @param data - The parsed response body.
+ * @returns The suggestions.
+ */
+export declare function parseArcGISSuggestions(data: unknown): GeocodeSuggestion[];
+/**
+ * Ask the selected locator for suggestions that complete `text`. Resolve one
+ * with {@link geocodeForward} and its `magicKey`.
+ *
+ * @param text - What the user has typed so far.
+ * @param options - Abort signal, configuration and the most suggestions wanted.
+ * @returns The suggestions.
+ * @throws GeocoderUnsupportedError When the geocoder does not suggest.
+ * @throws GeocoderServiceError For an HTTP or service error.
+ */
+export declare function geocodeSuggest(text: string, options?: {
+  signal?: AbortSignal;
+  config?: GeocoderConfig;
+  limit?: number;
+}): Promise<GeocodeSuggestion[]>;
+/**
+ * Fetch and read a GeocodeServer's capabilities. A secured service is asked
+ * with `token`.
+ *
+ * @param url - The locator's GeocodeServer URL (normalized first).
+ * @param options - An abort signal and an optional token.
+ * @returns The capabilities.
+ * @throws GeocoderServiceError For an HTTP or service error.
+ */
+export declare function fetchArcGISLocatorInfo(url: string, options?: {
+  signal?: AbortSignal;
+  token?: string;
+}): Promise<ArcGISLocatorCapabilities>;
 /**
  * Forward-geocode a single query through the configured provider, returning
  * normalized matches.
@@ -5354,6 +5466,10 @@ export declare function geocodeForward(query: string, options?: {
   signal?: AbortSignal;
   config?: GeocoderConfig;
   limit?: number;
+  /** A {@link GeocodeSuggestion}'s key, to resolve that suggestion. */
+  magicKey?: string;
+  /** Ask for each candidate's own attributes, where the provider supports it. */
+  attributes?: boolean;
 }): Promise<GeocodeMatch[]>;
 /**
  * Reverse-geocode a single point ([lon, lat]) through the configured provider,
@@ -6056,5 +6172,94 @@ export declare function localFileName(path: string): string;
 /** Keep imported layers distinguishable, including within a multi-file import. */
 export declare function uniqueImportedLayerName(name: string, names: Iterable<string>): string;
 //#endregion
-export { AddTileLayerOptions, AppCapabilities, AppPrivilege, AppRole, type AppState, ApplyLayerJoinsResult, AttributeFormConfig, AttributeFormFieldConfig, AttributeFormValueMapEntry, AttributeFormWidget, BLANK_BASEMAP, BLEND_MODES, BlendMode, CESIUM_BASEMAPS, CesiumBasemapId, CesiumBasemapImagery, type CesiumIonAssetKind, type CesiumIonLayerOptions, type CesiumIonQuickPick, type CesiumIonQuickPickGroup, type CesiumKmlLayerOptions, CollabInvite, CollaborationChatMessage, CollaborationMode, CollaborationParticipant, CollaborationPresence, CollaborationRole, CollaborationState, CommentAnchor, CommentAuthor, CommentReply, type ConversionToolKind, type CredentialRedactionResult, type CzmlDocument, type CzmlLayerOptions, type CzmlPacket, type CzmlSource, DEFAULT_BASEMAP, DEFAULT_BLEND_MODE, DEFAULT_DASHBOARD_COLUMNS, DEFAULT_ELLIPSOID_ID, DEFAULT_LAYER_STYLE, DEFAULT_LEGEND_CONFIG, DEFAULT_MAP_GRID_LAYOUT, DEFAULT_PRIMARY_RENDERER, DEFAULT_PRINT_LAYOUT, DEFAULT_PROJECT_PREFERENCES, DEFAULT_STORY_MAP, DUCKDB_VECTOR_FEATURE_WARN_COUNT, DUCKDB_VECTOR_ROUTE_BYTES, DashboardWidget, DashboardWidgetAggregation, DashboardWidgetType, DiagramField, DiagramSizeMode, DiagramType, EARTH_MEAN_RADIUS_METERS, ELLIPSOIDS, EditorTrackingConfig, Ellipsoid, EllipsoidId, FieldVisibility, FillPattern, GeoLibreLayer, GeoLibreProject, type GeocodeMatch, type GeocodeRequest, type GeocodeStatus, type GeocoderConfig, type GeocodingPreferenceInput, GeocodingPreferences, type GeocodingProvider, type GeocodingProviderId, GeometryGeneratorType, type GpsStatusFix, type IdentifyState, IndicatorAggregation, LARGE_VECTOR_FEATURE_THRESHOLD, LAYER_TYPES, LabelAnchor, LabelDedupe, LabelStyle, LabelTransform, LayerCapabilities, LayerConnection, LayerDescriptiveMetadata, LayerGroup, LayerJoin, LayerJoinStats, LayerLibraryEntry, LayerMetadataContact, LayerMetadataLink, LayerMetadataTemporalExtent, LayerPopupConfig, LayerQuickFilter, LayerStyle, type LayerSummary, LayerType, LayerVirtualField, LegendConfig, LegendCustomEntry, LegendCustomItem, LegendCustomShape, LegendItemOverride, LegendPanelPosition, LineDecoration, MAX_DASHBOARD_COLUMNS, MAX_MAP_GRID_DIM, MAX_PROCESSING_HISTORY, MIN_DASHBOARD_COLUMNS, MapGridLayout, MapPreferences, MapProjection, MapRendererKind, MapScaleUnit, MapViewState, MarkerShape, ModelGraphEdge, ModelGraphNode, ModelGraphNodeKind, ModelGraphPort, ModelPortKind, ModelToolProvider, NETCDF_IMAGE_SOURCE_KIND, type NetworkToolKind, type NominatimForwardResult, type NominatimReverseResult, NonGeographicCoordinates, OPENFREEMAP_BASEMAPS, PLANETARY_BASEMAPS, PLANETARY_BASEMAP_GROUPS, PLANETARY_BASEMAP_SENTINEL_PREFIX, PLANET_SWITCHER_OPTIONS, PROJECT_VERSION, PROTOMAPS_BASEMAPS, ParticipantIdentity, PlanetaryBasemap, PlanetaryBasemapGroup, PlanetaryBasemapSectionId, PointRenderer, PolylineBatchOptions, PolylineDecodeResult, PopupDateFormat, PopupFieldConfig, PopupFieldFormat, PopupFieldKind, PrintLayoutConfig, PrintLayoutCorner, PrintLayoutLegendEntry, PrintLayoutPageFilter, ProcessingModel, ProcessingModelGraph, ProcessingModelStep, ProcessingRerunRequest, ProcessingRun, ProcessingRunKind, ProcessingRunStatus, ProjectComment, type ProjectCredentialLookup, ProjectInteraction, ProjectPluginControlPosition, ProjectPluginState, ProjectPreferences, ProjectTemplateEntry, QuickFilterDateKind, QuickFilterKind, QuickFilterTextOperator, type RasterToolKind, RecentProjectEntry, type ReverseGeocodeDisplay, RuntimeEnvironmentVariable, SQL_QUERY_SOURCE_KIND, SecondaryMapView, type StatisticsToolKind, StoryActiveSlideMode, StoryChapter, StoryChapterAlignment, StoryChapterAnimation, StoryChapterLocation, StoryInsetPosition, StoryLayerOpacityChange, StoryMap, StorySlideMode, StrokeWidthUnit, StyleLibraryEntry, StyleLibraryEntryKind, VectorRule, VectorStyleMode, VectorStyleStop, type VectorToolKind, applyJoinsToLayer, applyLayerJoins, availableCesiumBasemap, basemapToCesiumImagery, batchDecodePolylines, bodyLengthToEarth, cascadeLayerJoinRefresh, collectTransitiveJoinSourceIds, createDefaultPrintLayout, decodePolyline, decodePolylineDetailed, detectNonGeographicCoordinates, earthAreaToBody, earthLengthToBody, encodePolyline, geoJSONToPolylineStr, geojsonHasZCoordinates, getActiveBodyRadiusRatio, getActiveEllipsoid, getActiveMeanRadiusMeters, getActiveSemiMajorAxisMeters, getEllipsoid, getPlanetaryBasemapById, getPlanetaryBasemapByStyleUrl, horizontalBbox, isDefaultPrintLayout, isDuckDBQueryLayer, layerJoinKey, meanRadiusMeters, normalizeCesiumBasemap, normalizePrintLayoutConfig, polylineStrToGeoJSON, printLayoutConfigsEqual, reapplyLayerJoins, sameCesiumImagery, scrubPrintLayoutForLayers, scrubPrintLayoutForRemovedLayers, setActiveEllipsoidId, shouldUseTiledRendering, stripJoinFields, styleValue, transformGeojsonElevation, unescapePolyline };
+//#region src/datum-shift.d.ts
+/**
+ * Datum shifts (proj4 `+towgs84` Helmert parameters) for coordinate systems
+ * whose datum is not WGS84-compatible, by EPSG code.
+ *
+ * The offline EPSG tables GeoLibre resolves codes with
+ * (`geotiff-geokeys-to-proj4`) leave the shift out for many national grids, and
+ * epsg.io's PROJJSON for a projected CRS carries no transformation either, so
+ * proj4 would treat those datums as WGS84 and place data tens to hundreds of
+ * metres off (about 100 m for the British National Grid). The parameters are
+ * EPSG's (the transformation epsg.io's proj4 strings use), within a few
+ * metres of PROJ's best transformation for each (15 m for the NAD27 mean);
+ * grid-based transformations (OSTN15, NTv2, NADCON) are finer but need grid
+ * files proj4 does not ship. Datums the tables already shift (ED50, AGD66,
+ * AGD84, Tokyo, NZGD49, TM75 and others) are not listed.
+ */
+/**
+ * The `+towgs84` parameters for an EPSG CRS or datum code, or null when the
+ * code is not one whose shift GeoLibre adds.
+ *
+ * @param crs An EPSG geographic or projected CRS code.
+ * @param datum An EPSG datum code, used when the CRS code is unknown.
+ */
+export declare function datumShiftFor(crs: number | null | undefined, datum?: number | null): string | null;
+/**
+ * Add the datum shift to a proj4 definition built for an EPSG CRS (or from a
+ * GeoTIFF's geokeys), when the definition has none and the CRS is one whose
+ * shift is known. A definition that already names a datum transformation
+ * (`+towgs84`, `+datum=`, `+nadgrids=`) is returned unchanged.
+ *
+ * @param definition A proj4 definition string.
+ * @param crs The EPSG CRS code it was built for.
+ * @param datum The EPSG datum code, for a user-defined CRS.
+ */
+export declare function withDatumShift(definition: string, crs: number | null | undefined, datum?: number | null): string;
+/**
+ * Add the datum shift to a proj4 definition built from GeoTIFF geokeys, from
+ * the projected or geographic CRS code, else the datum code.
+ *
+ * @param definition The proj4 definition built from `geoKeys`.
+ * @param geoKeys The GeoTIFF's geokeys (geotiff.js names).
+ */
+export declare function withGeoKeysDatumShift(definition: string, geoKeys: Record<string, unknown> | null | undefined): string;
+/** The part of `cog-tiler-wasm` the datum-shift hook needs (0.5 and later). */
+interface CogTilerCrsHook {
+  setSourceCrsResolver?: (fn: ((def: string, geoKeys: Record<string, unknown>) => string | null | undefined) | null) => void;
+}
+/**
+ * Have `cog-tiler-wasm` add the datum shift to each COG's source CRS, so a
+ * raster it tiles lands where the rest of GeoLibre puts it. Idempotent; a
+ * tiler without the hook is left as it is. WKT definitions are left alone.
+ *
+ * @param module The imported `cog-tiler-wasm` module.
+ */
+export declare function installCogTilerDatumShift(module: CogTilerCrsHook): void;
+//#endregion
+//#region src/cog-jpeg-tables.d.ts
+type NumericArray = ArrayLike<number> | undefined;
+/** Convert separate TIFF Y/Cb/Cr planes to RGB using tags 529 and 532. */
+export declare function convertTiffYCbCrToRgb(yPlane: ArrayLike<number>, cbPlane: ArrayLike<number>, crPlane: ArrayLike<number>, coefficients?: NumericArray, referenceBlackWhite?: NumericArray): [Float64Array, Float64Array, Float64Array];
+/**
+ * Whether a cog-tiler-wasm level's `compression` is baseline JPEG, the only
+ * codec whose tiles may omit their tables (TIFF tag 347) and so need the
+ * geotiff.js window read in {@link patchJpegCogSource}. The string is whitebox-wasm's
+ * enum name, so match `Jpeg`/`OldJpeg` exactly: a looser `/jpeg/i` would also
+ * catch `JpegXl`, which the wasm decoder handles and geotiff.js cannot decode
+ * at all (#2339).
+ */
+export declare function isAbbreviatedJpegCompression(compression: string | undefined): boolean;
+/**
+ * Route an abbreviated-JPEG COG's tile windows through geotiff.js, which reads
+ * the shared tables, converting Y/Cb/Cr to the RGB bands the renderers expect.
+ * Any other source is returned unchanged.
+ *
+ * @param source - A cog-tiler-wasm source.
+ * @returns The same source, patched in place when it needs it.
+ */
+export declare function patchJpegCogSource(source: unknown): unknown;
+/**
+ * A cog-tiler module whose `openCog` returns {@link patchJpegCogSource}-patched
+ * sources; the rest of the module is passed through.
+ *
+ * @param module - The cog-tiler-wasm module (or a test double).
+ * @returns The wrapped module.
+ */
+export declare function withJpegTablesPatch<M extends {
+  openCog: (input: never) => Promise<unknown>;
+}>(module: M): M;
+//#endregion
+export { AddTileLayerOptions, AppCapabilities, AppPrivilege, AppRole, type AppState, ApplyLayerJoinsResult, type ArcGISLocatorCapabilities, AttributeFormConfig, AttributeFormFieldConfig, AttributeFormValueMapEntry, AttributeFormWidget, BLANK_BASEMAP, BLEND_MODES, BlendMode, CESIUM_BASEMAPS, CesiumBasemapId, CesiumBasemapImagery, type CesiumIonAssetKind, type CesiumIonLayerOptions, type CesiumIonQuickPick, type CesiumIonQuickPickGroup, type CesiumKmlLayerOptions, CollabInvite, CollaborationChatMessage, CollaborationMode, CollaborationParticipant, CollaborationPresence, CollaborationRole, CollaborationState, CommentAnchor, CommentAuthor, CommentReply, type ConversionToolKind, CreateProjectOptions, type CredentialRedactionResult, type CzmlDocument, type CzmlLayerOptions, type CzmlPacket, type CzmlSource, DEFAULT_BASEMAP, DEFAULT_BLEND_MODE, DEFAULT_DASHBOARD_COLUMNS, DEFAULT_ELLIPSOID_ID, DEFAULT_LAYER_STYLE, DEFAULT_LEGEND_CONFIG, DEFAULT_MAP_GRID_LAYOUT, DEFAULT_PRIMARY_RENDERER, DEFAULT_PRINT_LAYOUT, DEFAULT_PROJECT_NAME, DEFAULT_PROJECT_PREFERENCES, DEFAULT_STORY_MAP, DUCKDB_VECTOR_FEATURE_WARN_COUNT, DUCKDB_VECTOR_ROUTE_BYTES, DashboardWidget, DashboardWidgetAggregation, DashboardWidgetType, DiagramField, DiagramSizeMode, DiagramType, EARTH_MEAN_RADIUS_METERS, ELLIPSOIDS, EditorTrackingConfig, Ellipsoid, EllipsoidId, FeatureChangeSummary, FieldVisibility, FillPattern, GeoArrowBatch, GeoArrowGeometryType, GeoLibreLayer, GeoLibreProject, type GeocodeMatch, type GeocodeRequest, type GeocodeStatus, type GeocodeSuggestion, type GeocoderConfig, GeocodingLocator, type GeocodingPreferenceInput, GeocodingPreferences, type GeocodingProvider, type GeocodingProviderId, type GeocodingTokenProvider, GeometryGeneratorType, type GpsStatusFix, type IdentifyState, IndicatorAggregation, LARGE_VECTOR_FEATURE_THRESHOLD, LAYER_TYPES, LabelAnchor, LabelDedupe, LabelStyle, LabelTransform, LayerCapabilities, LayerConnection, LayerDescriptiveMetadata, LayerDiff, LayerGroup, LayerJoin, LayerJoinStats, LayerLibraryEntry, LayerMetadataContact, LayerMetadataLink, LayerMetadataTemporalExtent, LayerPopupConfig, LayerQuickFilter, LayerStyle, type LayerSummary, LayerType, LayerVirtualField, LegendConfig, LegendCustomEntry, LegendCustomItem, LegendCustomShape, LegendItemOverride, LegendPanelPosition, LineDecoration, MAX_DASHBOARD_COLUMNS, MAX_MAP_GRID_DIM, MAX_PROCESSING_HISTORY, MAX_PROJECT_BOOKMARKS, MIN_DASHBOARD_COLUMNS, MapGridLayout, MapPreferences, MapProjection, MapRendererKind, MapScaleUnit, MapViewState, MarkerShape, ModelGraphEdge, ModelGraphNode, ModelGraphNodeKind, ModelGraphPort, ModelPortKind, ModelToolProvider, NETCDF_IMAGE_SOURCE_KIND, type NetworkToolKind, type NominatimForwardResult, type NominatimReverseResult, NonGeographicCoordinates, OPENFREEMAP_BASEMAPS, PLANETARY_BASEMAPS, PLANETARY_BASEMAP_GROUPS, PLANETARY_BASEMAP_SENTINEL_PREFIX, PLANET_SWITCHER_OPTIONS, PROJECT_VERSION, PROTOMAPS_BASEMAPS, ParticipantIdentity, PlanetaryBasemap, PlanetaryBasemapGroup, PlanetaryBasemapSectionId, PluginDiff, PointRenderer, PolylineBatchOptions, PolylineDecodeResult, PopupDateFormat, PopupFieldConfig, PopupFieldFormat, PopupFieldKind, PrintLayoutConfig, PrintLayoutCorner, PrintLayoutLegendEntry, PrintLayoutPageFilter, ProcessingModel, ProcessingModelGraph, ProcessingModelStep, ProcessingRerunRequest, ProcessingRun, ProcessingRunKind, ProcessingRunStatus, ProjectBookmark, ProjectBookmarkGroup, ProjectComment, type ProjectCredentialLookup, ProjectDiff, ProjectDiffOptions, ProjectInteraction, ProjectLayerSerializationCache, ProjectPluginControlPosition, ProjectPluginState, ProjectPreferences, ProjectTemplateEntry, ProjectValueChange, QuickFilterDateKind, QuickFilterKind, QuickFilterTextOperator, type RasterToolKind, RecentProjectEntry, type ReverseGeocodeDisplay, RuntimeEnvironmentVariable, SQL_QUERY_SOURCE_KIND, SecondaryMapView, type StatisticsToolKind, StoryActiveSlideMode, StoryChapter, StoryChapterAlignment, StoryChapterAnimation, StoryChapterLocation, StoryInsetPosition, StoryLayerOpacityChange, StoryMap, StorySlideMode, StrokeWidthUnit, StyleLibraryEntry, StyleLibraryEntryKind, VectorRule, VectorStyleMode, VectorStyleStop, type VectorToolKind, applyJoinsToLayer, applyLayerJoins, applyProjectToStore, availableCesiumBasemap, basemapToCesiumImagery, batchDecodePolylines, bodyLengthToEarth, cascadeLayerJoinRefresh, collectTransitiveJoinSourceIds, computeGeoArrowBBox, createDefaultMapView, createDefaultPrintLayout, createEmptyProject, createProjectLayerSerializationCache, createProjectTemplate, decodePolyline, decodePolylineDetailed, detachProjectCopy, detectNonGeographicCoordinates, diffFeatureCollections, diffProjects, earthAreaToBody, earthLengthToBody, encodePolyline, featureCollectionToGeoArrow, geoArrowToFeatureCollection, geoJSONToPolylineStr, geojsonHasZCoordinates, getActiveBodyRadiusRatio, getActiveEllipsoid, getActiveMeanRadiusMeters, getActiveSemiMajorAxisMeters, getEllipsoid, getPlanetaryBasemapById, getPlanetaryBasemapByStyleUrl, horizontalBbox, hydrateProjectLayer, isAllowedPluginManifestUrl, isDefaultPrintLayout, isDuckDBQueryLayer, isGeoArrowBatch, isSessionOnlyLayer, jsonValuesEqual, layerJoinKey, meanRadiusMeters, normalizeBlankBackgroundColor, normalizeBookmarkGroups, normalizeBookmarks, normalizeCesiumBasemap, normalizeDashboardColumns, normalizeLegendConfig, normalizeMapLayout, normalizeMapViewState, normalizeModelGraph, normalizeModels, normalizeObiaWorkbench, normalizePrimaryRenderer, normalizePrintLayoutConfig, normalizeProcessingHistory, normalizeProjectComments, normalizeProjectInteraction, normalizeSecondaryMapViews, normalizeStoryMap, normalizeWidgets, parseProject, polylineStrToGeoJSON, portableWmsTileUrl, previewValue, printLayoutConfigsEqual, projectFromStore, reapplyLayerJoins, resolveMapGrid, sameCesiumImagery, scrubPrintLayoutForLayers, scrubPrintLayoutForRemovedLayers, serializeProject, serializeProjectWithLayerCache, serializeProjectWithLayerCacheAsync, setActiveEllipsoidId, shouldUseTiledRendering, storyMapHasContent, stripJoinFields, styleValue, transformGeojsonElevation, unescapePolyline };
 //# sourceMappingURL=index.d.mts.map