@geolibre/core 2.9.0 → 3.0.0

package/dist/index.d.mts

@@ -1,3 +1,232 @@
+//#region src/cesium-imagery.d.ts
+/**
+ * Maps the project's basemap onto imagery the Cesium globe can render.
+ *
+ * The 2D panes render `basemapStyleUrl` through MapLibre, which understands
+ * vector GL styles and GeoLibre's `geolibre://` sentinels. Cesium understands
+ * neither: it draws imagery from tile providers only. So a globe pane that
+ * simply mounted the store basemap would show nothing, which is why the pane
+ * used to hardcode Ion World Imagery (with a token) or OpenStreetMap (without)
+ * and ignore the user's choice entirely — leaving a bright globe beside dark 2D
+ * panes and breaking the "same map, different projection" promise the multi-map
+ * grid makes.
+ *
+ * This module is the translation. It is deliberately **engine-free** — it
+ * returns a plain descriptor and never imports Cesium — so it lives in
+ * `@geolibre/core` beside the basemap catalogs it reads, the 2D and 3D
+ * renderers share one source of truth, and the Cesium chunk boundary in
+ * `vite.config.ts` stays intact.
+ *
+ * Three outcomes are possible, and the caller has to handle all three (see
+ * {@link CesiumBasemapImagery}): tiles to draw, nothing to draw, or "no raster
+ * equivalent exists — pick your own default".
+ */
+/** Stable project IDs and the corresponding Cesium bundled thumbnails / ion assets. */
+export declare const CESIUM_BASEMAPS: readonly [{
+  readonly id: "project";
+  readonly name: "Project basemap";
+  readonly icon: "naturalEarthII.png";
+}, {
+  readonly id: "natural-earth";
+  readonly name: "Natural Earth II";
+  readonly icon: "naturalEarthII.png";
+}, {
+  readonly id: "bing-aerial";
+  readonly name: "Bing Maps Aerial";
+  readonly icon: "bingAerial.png";
+  readonly assetId: 2;
+}, {
+  readonly id: "bing-labels";
+  readonly name: "Bing Maps Aerial with Labels";
+  readonly icon: "bingAerialLabels.png";
+  readonly assetId: 3;
+}, {
+  readonly id: "bing-roads";
+  readonly name: "Bing Maps Roads";
+  readonly icon: "bingRoads.png";
+  readonly assetId: 4;
+}, {
+  readonly id: "sentinel-2";
+  readonly name: "Sentinel-2";
+  readonly icon: "sentinel-2.png";
+  readonly assetId: 3954;
+}, {
+  readonly id: "blue-marble";
+  readonly name: "Blue Marble";
+  readonly icon: "blueMarble.png";
+  readonly assetId: 3845;
+}, {
+  readonly id: "earth-at-night";
+  readonly name: "Earth at night";
+  readonly icon: "earthAtNight.png";
+  readonly assetId: 3812;
+}, {
+  readonly id: "google-satellite";
+  readonly name: "Google Maps Satellite";
+  readonly icon: "googleSatellite.png";
+  readonly assetId: 3830182;
+}, {
+  readonly id: "google-labels";
+  readonly name: "Google Maps Satellite with Labels";
+  readonly icon: "googleSatelliteLabels.png";
+  readonly assetId: 3830183;
+}, {
+  readonly id: "google-roads";
+  readonly name: "Google Maps Roadmap";
+  readonly icon: "googleRoadmap.png";
+  readonly assetId: 3830184;
+}, {
+  readonly id: "google-contour";
+  readonly name: "Google Maps Contour";
+  readonly icon: "googleContour.png";
+  readonly assetId: 3830186;
+}, {
+  readonly id: "azure-aerial";
+  readonly name: "Azure Maps Aerial";
+  readonly icon: "azureAerial.png";
+  readonly assetId: 3891168;
+}, {
+  readonly id: "azure-roads";
+  readonly name: "Azure Maps Roads";
+  readonly icon: "azureRoads.png";
+  readonly assetId: 3891169;
+}, {
+  readonly id: "esri-imagery";
+  readonly name: "ArcGIS World Imagery";
+  readonly icon: "ArcGisMapServiceWorldImagery.png";
+  readonly category: "Other";
+  readonly service: "World_Imagery";
+}, {
+  readonly id: "esri-hillshade";
+  readonly name: "ArcGIS World Hillshade";
+  readonly icon: "ArcGisMapServiceWorldHillshade.png";
+  readonly category: "Other";
+  readonly service: "Elevation/World_Hillshade";
+}, {
+  readonly id: "esri-ocean";
+  readonly name: "Esri World Ocean";
+  readonly icon: "ArcGisMapServiceWorldOcean.png";
+  readonly category: "Other";
+  readonly service: "Ocean/World_Ocean_Base";
+}, {
+  readonly id: "osm";
+  readonly name: "OpenStreetMap";
+  readonly icon: "openStreetMap.png";
+  readonly category: "Other";
+}, {
+  readonly id: "stadia-watercolor";
+  readonly name: "Stadia x Stamen Watercolor";
+  readonly icon: "stamenWatercolor.png";
+  readonly category: "Other";
+  readonly stadiaStyle: "stamen_watercolor";
+  readonly maximumLevel: 16;
+  readonly extension: "jpg";
+}, {
+  readonly id: "stadia-toner";
+  readonly name: "Stadia x Stamen Toner";
+  readonly icon: "stamenToner.png";
+  readonly category: "Other";
+  readonly stadiaStyle: "stamen_toner";
+  readonly maximumLevel: 20;
+  readonly extension: "png";
+}, {
+  readonly id: "stadia-smooth";
+  readonly name: "Stadia Alidade Smooth";
+  readonly icon: "stadiaAlidadeSmooth.png";
+  readonly category: "Other";
+  readonly stadiaStyle: "alidade_smooth";
+  readonly maximumLevel: 20;
+  readonly extension: "png";
+}, {
+  readonly id: "stadia-dark";
+  readonly name: "Stadia Alidade Smooth Dark";
+  readonly icon: "stadiaAlidadeSmoothDark.png";
+  readonly category: "Other";
+  readonly stadiaStyle: "alidade_smooth_dark";
+  readonly maximumLevel: 20;
+  readonly extension: "png";
+}];
+export type CesiumBasemapId = (typeof CESIUM_BASEMAPS)[number]["id"];
+export declare function normalizeCesiumBasemap(value: unknown): CesiumBasemapId;
+/** Missing credentials fall back to the project background without changing the saved choice. */
+export declare function availableCesiumBasemap(value: unknown, hasIonToken: boolean): CesiumBasemapId;
+/**
+ * What the globe should draw underneath the project's data layers.
+ *
+ * - `xyz` — a tile template to render, with the credit and zoom bounds that go
+ *   with it.
+ * - `none` — the user chose the blank basemap; draw a bare ellipsoid.
+ * - `default` — this basemap has no raster equivalent (a custom style URL, a
+ *   provider style, an offline archive). The renderer falls back to whatever it
+ *   can offer, which is Ion World Imagery when a token is configured and
+ *   OpenStreetMap otherwise.
+ */
+export type CesiumBasemapImagery = {
+  kind: "none";
+} | {
+  kind: "default";
+} | {
+  kind: "ion";
+  assetId: number;
+} | {
+  kind: "natural-earth";
+} | {
+  kind: "arcgis";
+  url: string;
+} | {
+  kind: "xyz";
+  /** Tile template with `{z}`/`{x}`/`{y}` placeholders. */
+  template: string;
+  /** Credentials are resolved at render time, never embedded in the descriptor. */
+  apiKeyProvider?: "stadia";
+  /** Credit to show on the globe, as the HTML the 2D map already uses. */
+  attribution: string;
+  /** Max native zoom of the source, so the globe overzooms rather than 404s. */
+  maximumLevel?: number;
+  /**
+   * Tile row ordering. `"tms"` numbers rows from the bottom; absent means
+   * standard XYZ. Cesium has no `scheme` option, so a TMS template needs
+   * `{y}` swapped for its `{reverseY}` placeholder at render time.
+   */
+  scheme?: "tms";
+  /**
+   * A transparent overlay drawn directly above {@link template} — the
+   * roads-and-labels tiles a hybrid basemap (Amap Hybrid) bakes in, so one
+   * basemap selection still yields a labelled satellite globe.
+   */
+  overlayTemplate?: string;
+};
+/**
+ * Whether two descriptors would draw the same thing.
+ *
+ * Descriptors are built fresh on every call, so two basemaps resolving to the
+ * same analogue — OpenFreeMap `liberty` and `bright` are both the streets
+ * tone — yield equal but distinct objects. A renderer that remembers the
+ * descriptor it drew (to skip redundant work) must compare by value: a
+ * reference check would miss that case and tear down and re-add an identical
+ * tile provider, costing a flash and a round of re-requested tiles for no
+ * visible change.
+ */
+export declare function sameCesiumImagery(a: CesiumBasemapImagery, b: CesiumBasemapImagery): boolean;
+/**
+ * Translate a basemap style URL into imagery for the Cesium globe.
+ *
+ * Planetary and regional basemaps are already raster tile sets, so they carry
+ * straight over — the globe shows the same Mars/Moon/Amap tiles the 2D panes
+ * do. GeoLibre's own vector styles map to a keyless raster basemap of matching
+ * tone, so switching the project to a dark basemap darkens the globe too.
+ * Everything else reports `default`, leaving the choice of fallback imagery to
+ * the renderer (which knows whether an Ion token is configured).
+ *
+ * A `geolibre://` sentinel that no longer resolves is treated as the default
+ * basemap, mirroring what `resolveMapStyle` does for the 2D map rather than
+ * handing the sentinel onward as if it were fetchable.
+ *
+ * @param styleUrl - The project's `basemapStyleUrl`.
+ * @returns What the globe should draw beneath the data layers.
+ */
+export declare function basemapToCesiumImagery(styleUrl: string | undefined, cesiumBasemap?: CesiumBasemapId): CesiumBasemapImagery;
+//#endregion
 //#region ../../node_modules/@types/geojson/index.d.ts
 /**
  * The value values for the "type" property of GeoJSON Objects.
@@ -198,16 +427,16 @@ interface FeatureCollection<G extends Geometry | null = Geometry, P = GeoJsonPro
  * a corner on one side without the other fails the build.
  */
 /** A page corner an overlay block can be pinned to. */
-type PrintLayoutCorner = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export type PrintLayoutCorner = "top-left" | "top-right" | "bottom-left" | "bottom-right";
 /** Which features a data block covers when the atlas paginates the map. */
-type PrintLayoutPageFilter = "all" | "contained" | "intersecting";
+export type PrintLayoutPageFilter = "all" | "contained" | "intersecting";
 /** One hand-authored swatch in the composer's user-defined legend. */
-interface PrintLayoutLegendEntry {
+export interface PrintLayoutLegendEntry {
   id: string;
   label: string;
   color: string;
 }
-interface PrintLayoutConfig {
+export interface PrintLayoutConfig {
   title: string;
   subtitle: string;
   titlePlacement: "outside" | "inside";
@@ -296,9 +525,9 @@ interface PrintLayoutConfig {
  * `printLayout` is filled out against. Also the dialog's initial state, so
  * "new project" and "a project saved before this feature" compose identically.
  */
-declare const DEFAULT_PRINT_LAYOUT: PrintLayoutConfig;
+export declare const DEFAULT_PRINT_LAYOUT: PrintLayoutConfig;
 /** A fresh copy of the defaults, safe to hand to a store or a component. */
-declare function createDefaultPrintLayout(): PrintLayoutConfig;
+export declare function createDefaultPrintLayout(): PrintLayoutConfig;
 /**
  * Coerce an untrusted (possibly hand-edited, possibly partial) `printLayout`
  * into a complete {@link PrintLayoutConfig}, filling every missing or
@@ -308,18 +537,18 @@ declare function createDefaultPrintLayout(): PrintLayoutConfig;
  * @returns The normalized config, or null when the project carries none, so
  *   callers can tell "absent" from "explicitly default".
  */
-declare function normalizePrintLayoutConfig(value: unknown): PrintLayoutConfig | null;
+export declare function normalizePrintLayoutConfig(value: unknown): PrintLayoutConfig | null;
 /**
  * Whether a config is still the untouched default, so a project that never
  * opened the composer serializes without a `printLayout` key and stays
  * byte-identical to one saved before this feature.
  */
-declare function isDefaultPrintLayout(config: PrintLayoutConfig): boolean;
+export declare function isDefaultPrintLayout(config: PrintLayoutConfig): boolean;
 /**
  * Structural equality for two configs. Used to skip no-op store writes, so
  * merely opening the Print Layout dialog never marks a project dirty.
  */
-declare function printLayoutConfigsEqual(a: PrintLayoutConfig, b: PrintLayoutConfig): boolean;
+export declare function printLayoutConfigsEqual(a: PrintLayoutConfig, b: PrintLayoutConfig): boolean;
 /**
  * Drop references to layers the project no longer carries, so a composer that
  * pointed at a since-deleted layer opens with the block cleared instead of
@@ -330,7 +559,7 @@ declare function printLayoutConfigsEqual(a: PrintLayoutConfig, b: PrintLayoutCon
  * @param existingLayerIds - Ids of the layers present in the project.
  * @returns The same object when nothing referenced a missing layer.
  */
-declare function scrubPrintLayoutForLayers(config: PrintLayoutConfig, existingLayerIds: ReadonlySet<string>): PrintLayoutConfig;
+export declare function scrubPrintLayoutForLayers(config: PrintLayoutConfig, existingLayerIds: ReadonlySet<string>): PrintLayoutConfig;
 /**
  * The delete-time counterpart, matching `scrubLegendForRemovedLayers` and its
  * siblings: called when layers are removed from the open project so the saved
@@ -340,10 +569,10 @@ declare function scrubPrintLayoutForLayers(config: PrintLayoutConfig, existingLa
  * @param layerIds - The removed layer id, or ids.
  * @returns The same object when no block referenced a removed layer.
  */
-declare function scrubPrintLayoutForRemovedLayers(config: PrintLayoutConfig, layerIds: string | Iterable<string>): PrintLayoutConfig;
+export declare function scrubPrintLayoutForRemovedLayers(config: PrintLayoutConfig, layerIds: string | Iterable<string>): PrintLayoutConfig;
 //#endregion
 //#region src/types.d.ts
-declare const OPENFREEMAP_BASEMAPS: readonly [{
+export declare const OPENFREEMAP_BASEMAPS: readonly [{
   readonly id: "liberty";
   readonly name: "Liberty";
   readonly styleUrl: "https://tiles.openfreemap.org/styles/liberty";
@@ -375,7 +604,7 @@ declare const OPENFREEMAP_BASEMAPS: readonly [{
  * the GitHub Pages web demo), so consumers should hide these options when no
  * key is available.
  */
-declare const PROTOMAPS_BASEMAPS: readonly [{
+export declare const PROTOMAPS_BASEMAPS: readonly [{
   readonly id: "protomaps-light";
   readonly name: "Light";
   readonly flavor: "light";
@@ -396,17 +625,17 @@ declare const PROTOMAPS_BASEMAPS: readonly [{
   readonly name: "Black";
   readonly flavor: "black";
 }];
-declare const DEFAULT_BASEMAP = "https://tiles.openfreemap.org/styles/liberty";
-declare const BLANK_BASEMAP = "";
-declare const PROJECT_VERSION = "0.2.0";
+export declare const DEFAULT_BASEMAP = "https://tiles.openfreemap.org/styles/liberty";
+export declare const BLANK_BASEMAP = "";
+export declare const PROJECT_VERSION = "0.2.0";
 /**
  * Every layer type, as a runtime list so untrusted input (an imported Layer
  * Library bundle, a hand-edited project) can be validated against it.
  * {@link LayerType} is derived from this array, so the two cannot drift.
  */
-declare const LAYER_TYPES: readonly ["geojson", "raster", "wms", "wmts", "xyz", "vector-tiles", "arcgis", "pmtiles", "mbtiles", "zarr", "lidar", "gaussian-splat", "3d-tiles", "cog", "flatgeobuf", "geoparquet", "duckdb-query", "deckgl-viz", "video", "image"];
-type LayerType = (typeof LAYER_TYPES)[number];
-type VectorStyleMode = "single" | "graduated" | "categorized" | "rule-based" | "expression";
+export declare const LAYER_TYPES: readonly ["geojson", "raster", "wms", "wmts", "xyz", "vector-tiles", "arcgis", "pmtiles", "mbtiles", "zarr", "lidar", "gaussian-splat", "3d-tiles", "cog", "flatgeobuf", "geoparquet", "duckdb-query", "deckgl-viz", "video", "image"];
+export type LayerType = (typeof LAYER_TYPES)[number];
+export type VectorStyleMode = "single" | "graduated" | "categorized" | "rule-based" | "expression";
 /**
  * One entry in a {@link LayerStyle.vectorRules} rule-based renderer. Each rule
  * pairs a MapLibre filter expression (a boolean expression array, serialized as
@@ -415,7 +644,7 @@ type VectorStyleMode = "single" | "graduated" | "categorized" | "rule-based" | "
  * the color for features no other rule matched. Mirrors the QGIS/ArcGIS
  * rule-based renderer.
  */
-interface VectorRule {
+export interface VectorRule {
   id: string;
   /** Human-readable label shown in the editor and the legend. */
   label: string;
@@ -488,25 +717,25 @@ interface VectorRule {
  * named patterns are generated as recolorable sprite tiles; `"svg"` rasterizes
  * the user-supplied markup in {@link LayerStyle.fillPatternSvg}.
  */
-type FillPattern = "none" | "hatch" | "cross-hatch" | "horizontal" | "vertical" | "dots" | "svg";
+export type FillPattern = "none" | "hatch" | "cross-hatch" | "horizontal" | "vertical" | "dots" | "svg";
 /**
  * The built-in marker shape for a point layer, or `"custom"` to rasterize the
  * user-supplied SVG in {@link LayerStyle.markerSvg}. Built-in shapes are drawn
  * on a sprite tile and recolored via {@link LayerStyle.markerColor}.
  */
-type MarkerShape = "circle" | "square" | "triangle" | "diamond" | "star" | "cross" | "pin" | "custom";
+export type MarkerShape = "circle" | "square" | "triangle" | "diamond" | "star" | "cross" | "pin" | "custom";
 /**
  * How a point layer is rendered: as individual markers, a density heatmap, or
  * clustered bubbles. Only applies to point geometry.
  */
-type PointRenderer = "single" | "heatmap" | "cluster";
+export type PointRenderer = "single" | "heatmap" | "cluster";
 /**
  * The repeated decoration symbol drawn along line features (and polygon
  * outlines), or `"none"` when decorations are off. Mirrors the QGIS
  * marker-line / arrow symbol layers: `"arrow"` renders directional arrowheads
  * that follow the line, the other shapes render as repeated markers.
  */
-type LineDecoration = "none" | "arrow" | "triangle" | "circle" | "square";
+export type LineDecoration = "none" | "arrow" | "triangle" | "circle" | "square";
 /**
  * The per-feature derived geometry rendered by the geometry generator, or
  * `"none"` when the generator is off. Mirrors QGIS geometry-generator symbol
@@ -514,13 +743,13 @@ type LineDecoration = "none" | "arrow" | "triangle" | "circle" | "square";
  * hull, or a buffer) is drawn as an extra symbol over the layer's normal
  * symbology. `"centroid"` derives points; the rest derive polygons.
  */
-type GeometryGeneratorType = "none" | "centroid" | "bounding-box" | "convex-hull" | "buffer";
+export type GeometryGeneratorType = "none" | "centroid" | "bounding-box" | "convex-hull" | "buffer";
 /**
  * Unit a stroke/line width is measured in. `"pixels"` is constant screen space;
  * `"meters"` is ground distance, so the rendered width scales with the map
  * scale (zoom). See {@link LayerStyle.strokeWidthUnit}.
  */
-type StrokeWidthUnit = "pixels" | "meters";
+export type StrokeWidthUnit = "pixels" | "meters";
 /**
  * The chart drawn on top of each feature by the diagram renderer (QGIS-style
  * diagram symbology), or `"none"` when diagrams are off. Diagrams visualize
@@ -528,7 +757,7 @@ type StrokeWidthUnit = "pixels" | "meters";
  * party per county — and render through the shared deck.gl overlay on the
  * feature's point location or polygon centroid.
  */
-type DiagramType = "none" | "pie" | "donut" | "bar" | "stacked-bar";
+export type DiagramType = "none" | "pie" | "donut" | "bar" | "stacked-bar";
 /**
  * How the overall diagram size is determined.
  *
@@ -539,21 +768,21 @@ type DiagramType = "none" | "pie" | "donut" | "bar" | "stacked-bar";
  * - `"attribute"`: scaled the same way by the single numeric attribute in
  *   {@link LayerStyle.diagramSizeProperty}.
  */
-type DiagramSizeMode = "fixed" | "sum" | "attribute";
+export type DiagramSizeMode = "fixed" | "sum" | "attribute";
 /** One attribute rendered as a slice/bar of a feature diagram. */
-interface DiagramField {
+export interface DiagramField {
   /** Numeric feature property visualized by this slice/bar. */
   property: string;
   /** Slice/bar color (6-digit hex). */
   color: string;
 }
-interface VectorStyleStop {
+export interface VectorStyleStop {
   value: string | number;
   color: string;
   label?: string;
 }
 /** Attribute-driven labeling for a vector layer (rendered as a MapLibre symbol layer). */
-interface LabelStyle {
+export interface LabelStyle {
   /** Whether labels are shown for the layer. */
   enabled: boolean;
   /** Attribute field whose value becomes the label text. */
@@ -593,6 +822,22 @@ interface LabelStyle {
   maxWidth: number;
   /** Letter-case transform applied to the label text (MapLibre `text-transform`). */
   transform: LabelTransform;
+  /**
+   * Render a numeric {@link field} with the locale's thousands and decimal
+   * separators (issue #2336), so `1234567.5` labels as `1,234,567.5` instead
+   * of running together. Non-numeric values are unaffected, and it is not
+   * applied to {@link expression}, which formats its own output (MapLibre's
+   * `number-format`, offered in the Expression Builder).
+   */
+  numberFormatEnabled: boolean;
+  /** Decimal places kept while {@link numberFormatEnabled} is on (0-10). */
+  numberDecimals: number;
+  /**
+   * BCP 47 tag picking the separators for {@link numberFormatEnabled}, from
+   * {@link LABEL_NUMBER_LOCALES}. Empty (the default) follows the app's own
+   * language, the way popup number fields do.
+   */
+  numberLocale: string;
   /**
    * How to handle features that share a label.
    *
@@ -642,11 +887,11 @@ interface LabelStyle {
   priorityExpression: string;
 }
 /** MapLibre `text-anchor` positions offered for {@link LabelStyle.anchor}. */
-type LabelAnchor = "center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export type LabelAnchor = "center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
 /** Letter-case transform offered for {@link LabelStyle.transform}. */
-type LabelTransform = "none" | "uppercase" | "lowercase";
+export type LabelTransform = "none" | "uppercase" | "lowercase";
 /** Duplicate-label handling offered for {@link LabelStyle.dedupe}. */
-type LabelDedupe = "off" | "unique" | "concatenate";
+export type LabelDedupe = "off" | "unique" | "concatenate";
 /**
  * Cartographic blend modes offered for {@link LayerStyle.blendMode}.
  *
@@ -670,13 +915,13 @@ type LabelDedupe = "off" | "unique" | "concatenate";
  * Every mode here leaves the canvas opaque and leaves the map untouched
  * wherever the layer contributes nothing. See `docs/user-guide/layers.md`.
  */
-declare const BLEND_MODES: readonly ["normal", "multiply", "screen", "lighten", "add"];
+export declare const BLEND_MODES: readonly ["normal", "multiply", "screen", "lighten", "add"];
 /**
  * How a layer's pixels combine with the map beneath it. `"normal"` is ordinary
  * alpha compositing (the default, and what every layer did before blend modes
  * existed). See {@link BLEND_MODES}.
  */
-type BlendMode = (typeof BLEND_MODES)[number];
+export type BlendMode = (typeof BLEND_MODES)[number];
 /**
  * The mode a layer renders with unless it says otherwise. Declared separately
  * from {@link DEFAULT_LAYER_STYLE} so consumers get a non-optional
@@ -684,8 +929,8 @@ type BlendMode = (typeof BLEND_MODES)[number];
  * {@link LayerStyle}, so `DEFAULT_LAYER_STYLE.blendMode` is typed
  * `BlendMode | undefined` however it is initialized.
  */
-declare const DEFAULT_BLEND_MODE: BlendMode;
-interface LayerStyle {
+export declare const DEFAULT_BLEND_MODE: BlendMode;
+export interface LayerStyle {
   minZoom: number;
   maxZoom: number;
   fillColor: string;
@@ -814,6 +1059,10 @@ interface LayerStyle {
   pointRenderer: PointRenderer;
   heatmapRadius: number;
   heatmapIntensity: number;
+  /** Built-in color ramp used by the heatmap density renderer. */
+  heatmapColorRamp: string;
+  /** Numeric feature property used as heatmap weight; blank gives every point equal weight. */
+  heatmapWeightProperty: string;
   clusterRadius: number;
   clusterMaxZoom: number;
   /**
@@ -898,13 +1147,13 @@ interface LayerStyle {
    */
   blendMode?: BlendMode;
 }
-declare const DEFAULT_LAYER_STYLE: LayerStyle;
+export declare const DEFAULT_LAYER_STYLE: LayerStyle;
 /**
  * Read a layer style property, falling back to the shared default when the
  * layer does not define it. Shared by `@geolibre/map` and the desktop app so
  * the two consumers cannot drift.
  */
-declare function styleValue<K extends keyof LayerStyle>(style: LayerStyle, key: K): LayerStyle[K];
+export declare function styleValue<K extends keyof LayerStyle>(style: LayerStyle, key: K): LayerStyle[K];
 /**
  * Feature-count threshold above which a local vector (GeoJSON) layer is rendered
  * through client-side vector tiles (geojson-vt / supercluster served by a custom
@@ -912,7 +1161,7 @@ declare function styleValue<K extends keyof LayerStyle>(style: LayerStyle, key:
  * `setData`. Small layers stay on the simpler inline path. Mirrors the
  * `MAX_CEREUS_FEATURES` precedent in the desktop SQL engine.
  */
-declare const LARGE_VECTOR_FEATURE_THRESHOLD = 50000;
+export declare const LARGE_VECTOR_FEATURE_THRESHOLD = 50000;
 /**
  * Decide whether a GeoJSON layer should use the tiled rendering path.
  *
@@ -921,13 +1170,13 @@ declare const LARGE_VECTOR_FEATURE_THRESHOLD = 50000;
  * @returns `true` when the collection exceeds
  *   {@link LARGE_VECTOR_FEATURE_THRESHOLD} features.
  */
-declare function shouldUseTiledRendering(geojson: GeoJSON.FeatureCollection | undefined): boolean;
+export declare function shouldUseTiledRendering(geojson: GeoJSON.FeatureCollection | undefined): boolean;
 /**
  * Match statistics from the last time a {@link LayerJoin} was applied, shown in
  * the Joins UI so silent key mismatches are visible (mirrors QGIS's join
  * feedback). Recomputed on every apply; persisted harmlessly with the join.
  */
-interface LayerJoinStats {
+export interface LayerJoinStats {
   /** Target features whose key matched a join-table row. */
   matchedCount: number;
   /** Target features with no matching join-table row (their joined columns are null). */
@@ -945,7 +1194,7 @@ interface LayerJoinStats {
  * table's data changes. Definitions persist in `.geolibre.json` and re-resolve
  * on project load. See `joins.ts` for the engine.
  */
-interface LayerJoin {
+export interface LayerJoin {
   /** Stable id for list edits. */
   id: string;
   /** Id of the layer providing the joined columns (its geometry is ignored). */
@@ -975,9 +1224,9 @@ interface LayerJoin {
   stats?: LayerJoinStats;
 }
 /** Edit-widget kinds the Attribute Form designer can assign to a field. */
-type AttributeFormWidget = "text" | "number" | "range" | "checkbox" | "date" | "valueMap";
+export type AttributeFormWidget = "text" | "number" | "range" | "checkbox" | "date" | "valueMap";
 /** One selectable entry of a `valueMap` widget (stored value + display label). */
-interface AttributeFormValueMapEntry {
+export interface AttributeFormValueMapEntry {
   /** The value written to the feature property (compared as a string). */
   value: string;
   /** Human-readable label shown in the dropdown; defaults to {@link value}. */
@@ -991,7 +1240,7 @@ interface AttributeFormValueMapEntry {
  * inline editor and the Field Collection capture form; helpers live in
  * `attribute-form.ts`.
  */
-interface AttributeFormFieldConfig {
+export interface AttributeFormFieldConfig {
   /** Feature property key this configuration applies to. */
   field: string;
   widget: AttributeFormWidget;
@@ -1027,7 +1276,7 @@ interface AttributeFormFieldConfig {
   visibilityExpression?: string;
 }
 /** The Attribute Form designer's whole per-layer configuration. */
-interface AttributeFormConfig {
+export interface AttributeFormConfig {
   fields: AttributeFormFieldConfig[];
 }
 /**
@@ -1037,11 +1286,11 @@ interface AttributeFormConfig {
  * anything else stringified. The remaining kinds are explicit author choices
  * so a popup never has to guess from the value.
  */
-type PopupFieldKind = "auto" | "text" | "number" | "date" | "link" | "image";
+export type PopupFieldKind = "auto" | "text" | "number" | "date" | "link" | "image";
 /** How a `"date"` field's value is written out. */
-type PopupDateFormat = "date" | "datetime" | "time" | "iso" | "year";
+export type PopupDateFormat = "date" | "datetime" | "time" | "iso" | "year";
 /** Value formatting for one popup field. Every part is optional. */
-interface PopupFieldFormat {
+export interface PopupFieldFormat {
   /** Fixed number of decimals for a `"number"` field. */
   decimals?: number;
   /** Group thousands with the locale's separator (`"number"` fields). */
@@ -1056,7 +1305,7 @@ interface PopupFieldFormat {
   linkLabel?: string;
 }
 /** One field's entry in a layer's popup configuration. */
-interface PopupFieldConfig {
+export interface PopupFieldConfig {
   /** Feature property key. */
   field: string;
   /** Display label shown instead of the raw field name. */
@@ -1077,7 +1326,7 @@ interface PopupFieldConfig {
  * {@link GeoLibreLayer.fieldVisibility} stays authoritative — a `"hidden"` or
  * `"excluded"` field is dropped even when a popup config names it.
  */
-interface LayerPopupConfig {
+export interface LayerPopupConfig {
   /** `false` suppresses the Identify popup for this layer. Defaults to `true`. */
   click?: boolean;
   /** `true` shows a hover tooltip built from the `hover` fields. Defaults to `false`. */
@@ -1116,7 +1365,7 @@ interface LayerPopupConfig {
  * project load; the expression is a declarative MapLibre expression (never
  * arbitrary code), so re-evaluating it from a shared project file is safe.
  */
-interface LayerVirtualField {
+export interface LayerVirtualField {
   /** Stable id for list edits. */
   id: string;
   /** The output column name. A name already taken by a base column is skipped. */
@@ -1154,9 +1403,9 @@ interface LayerVirtualField {
  * and edited.
  */
 /** Which control a quick filter renders, and how it compiles. */
-type QuickFilterKind = "categorical" | "range" | "date" | "text";
+export type QuickFilterKind = "categorical" | "range" | "date" | "text";
 /** The comparison a `text` quick filter applies (always case-insensitive). */
-type QuickFilterTextOperator = "contains" | "startsWith" | "equals";
+export type QuickFilterTextOperator = "contains" | "startsWith" | "equals";
 /**
  * How a date field stores its values, deciding whether a `date` quick filter
  * compares ISO text or epoch numbers. `iso` covers both `YYYY-MM-DD` and full
@@ -1165,9 +1414,9 @@ type QuickFilterTextOperator = "contains" | "startsWith" | "equals";
  * a boundary. Mirrors (deliberately, in a smaller form) the value kinds the
  * Time Slider's `detectValueKind` reports.
  */
-type QuickFilterDateKind = "iso" | "epochMs" | "epochS";
+export type QuickFilterDateKind = "iso" | "epochMs" | "epochS";
 /** A single filter control persisted on a layer. */
-interface LayerQuickFilter {
+export interface LayerQuickFilter {
   /** Stable id, used as the React key and for edits/removal. */
   id: string;
   /** The feature property this control narrows. */
@@ -1201,7 +1450,7 @@ interface LayerQuickFilter {
   text?: string;
 }
 /** Persisted refresh policy and most recent synchronization result for a layer. */
-interface LayerConnection {
+export interface LayerConnection {
   /** Owning layer id. Repeated here so records remain self-describing when exported. */
   layerId: string;
   /** Automatic refresh cadence in seconds, or null for manual synchronization only. */
@@ -1218,7 +1467,7 @@ interface LayerConnection {
  * Maintains `created_by`, `created_at`, `edited_by`, `edited_at` fields
  * automatically when features are created or updated.
  */
-interface EditorTrackingConfig {
+export interface EditorTrackingConfig {
   /** `true` enables automatic creation/edit timestamp and author stamping. */
   enabled: boolean;
   /** Field name for creation author (default `"created_by"`). */
@@ -1235,12 +1484,12 @@ interface EditorTrackingConfig {
  * - "hidden": Not shown in the attribute table, identify popup, tooltips, or field pickers, but remains in the data.
  * - "excluded": Removed entirely from the data when the project is shared or exported.
  */
-type FieldVisibility = "hidden" | "excluded";
+export type FieldVisibility = "hidden" | "excluded";
 /**
  * Explicit capability flags defining what actions a user/session may perform on a layer.
  * Any omitted capability falls back to the inferred default behavior for that layer's source.
  */
-interface LayerCapabilities {
+export interface LayerCapabilities {
   /** Can the layer's features or attributes be queried / identified. */
   query?: boolean;
   /** Can new features be created/added to the layer. */
@@ -1255,16 +1504,16 @@ interface LayerCapabilities {
 /**
  * Application privilege identifiers defining discrete capabilities in GeoLibre.
  */
-type AppPrivilege = "layers:edit" | "layers:add-remote" | "layers:add-local" | "processing:run" | "processing:sidecar" | "project:save" | "project:share" | "project:share-public" | "plugins:install" | "assistant:use" | "connections:manage" | "export:data" | "export:image" | "settings:manage";
+export type AppPrivilege = "layers:edit" | "layers:add-remote" | "layers:add-local" | "processing:run" | "processing:sidecar" | "project:save" | "project:share" | "project:share-public" | "plugins:install" | "assistant:use" | "connections:manage" | "export:data" | "export:image" | "settings:manage";
 /**
  * Standard named roles bundling application privileges.
  */
-type AppRole = "viewer" | "editor" | "publisher" | "administrator" | "custom";
+export type AppRole = "viewer" | "editor" | "publisher" | "administrator" | "custom";
 /**
  * Ephemeral application capabilities state defining the active role, effective privileges,
  * and optional restriction reason for the current session/deployment.
  */
-interface AppCapabilities {
+export interface AppCapabilities {
   /**
    * The assigned application role. `custom` once an ad-hoc `grantAppPrivilege` /
    * `revokeAppPrivilege` has moved the set away from the bundle a named role
@@ -1287,7 +1536,7 @@ interface AppCapabilities {
    */
   privilegeReasons?: Partial<Record<AppPrivilege, string>>;
 }
-interface GeoLibreLayer {
+export interface GeoLibreLayer {
   id: string;
   name: string;
   type: LayerType;
@@ -1351,6 +1600,14 @@ interface GeoLibreLayer {
   timeFilter?: unknown[];
   /** Transient MapLibre expression applied by the iframe embed API. */
   embedFilter?: unknown[];
+  /**
+   * Project-persisted boolean MapLibre expression that narrows the features
+   * rendered for this layer. Unlike a selection, this leaves the source data
+   * intact and keeps non-matching features hidden until the filter is cleared.
+   * It is composed with transient filters, quick filters, and rule visibility
+   * by the map renderers.
+   */
+  filterExpression?: unknown[];
   /**
    * Data-driven filter controls authored in the layer's Quick Filters section
    * (issue #2114). Unlike {@link timeFilter} and {@link embedFilter} this is
@@ -1381,7 +1638,7 @@ interface GeoLibreLayer {
  * `source` fields MapLibre understands so an external plugin can register tile
  * layers without touching the map directly.
  */
-interface AddTileLayerOptions {
+export interface AddTileLayerOptions {
   /**
    * One or more XYZ tile URL templates (with `{x}`/`{y}`/`{z}` placeholders).
    * At least one non-empty template is required, or the layer renders nothing.
@@ -1428,7 +1685,7 @@ interface AddTileLayerOptions {
  * child layer's effective render state by `applyGroupEffects` before the map
  * syncs, so children keep their own stored `visible`/`opacity` values.
  */
-interface LayerGroup {
+export interface LayerGroup {
   id: string;
   name: string;
   /** Parent folder id, or undefined when this folder is at the panel root. */
@@ -1447,7 +1704,7 @@ interface LayerGroup {
  * (which owns the query/refresh logic) and `@geolibre/plugins` (which excludes
  * these layers from in-place geometry editing) share one value.
  */
-declare const SQL_QUERY_SOURCE_KIND = "sql-query";
+export declare const SQL_QUERY_SOURCE_KIND = "sql-query";
 /**
  * Metadata `sourceKind` marking a NetCDF/HDF grid baked into an `image` overlay,
  * as opposed to the KML ground overlays that otherwise use that layer type.
@@ -1456,14 +1713,14 @@ declare const SQL_QUERY_SOURCE_KIND = "sql-query";
  * on these) and the desktop app (which owns the symbology panel, the pixel
  * readout, and the spectral profile) share one value.
  */
-declare const NETCDF_IMAGE_SOURCE_KIND = "netcdf-image";
+export declare const NETCDF_IMAGE_SOURCE_KIND = "netcdf-image";
 /**
  * Detect a DuckDB query layer rendered through the plugin's external deck.gl
  * overlay. Shared by `@geolibre/map`, `@geolibre/plugins`, and the desktop
  * app so the detection criteria cannot drift.
  */
-declare function isDuckDBQueryLayer(layer: Pick<GeoLibreLayer, "metadata" | "type"> | undefined): boolean;
-interface MapViewState {
+export declare function isDuckDBQueryLayer(layer: Pick<GeoLibreLayer, "metadata" | "type"> | undefined): boolean;
+export interface MapViewState {
   center: [number, number];
   zoom: number;
   bearing: number;
@@ -1480,7 +1737,7 @@ interface MapViewState {
  * different panes can show different layers. When `syncView` is on,
  * panning/zooming any pane mirrors the camera to every other pane.
  */
-interface MapGridLayout {
+export interface MapGridLayout {
   /** Grid rows (>= 1). */
   rows: number;
   /** Grid columns (>= 1). `rows * cols` is the total number of panes. */
@@ -1488,11 +1745,30 @@ interface MapGridLayout {
   /** When true, all panes share a synchronized camera. */
   syncView: boolean;
 }
+/**
+ * Which engine draws a map pane.
+ *
+ * `"maplibre"` is the 2D MapLibre GL map that owns the app's plugin, styling,
+ * and deck.gl integrations. `"cesium"` is the 3D globe (see `CesiumCanvas`),
+ * which renders the same shared store state — camera, basemap, layers, group
+ * effects — through CesiumJS.
+ *
+ * Used both for secondary panes ({@link SecondaryMapView.viewKind}) and for the
+ * primary workspace ({@link GeoLibreProject.primaryRenderer}), so the two never
+ * drift apart.
+ */
+export type MapRendererKind = "maplibre" | "cesium";
+/**
+ * The engine that draws the primary map area when a project says nothing. The
+ * 2D map: it is the renderer every tool, plugin, and panel is wired to, so an
+ * existing project (and a new one) opens exactly as it always did.
+ */
+export declare const DEFAULT_PRIMARY_RENDERER: MapRendererKind;
 /**
  * A non-primary map pane: shares the primary map's basemap and layers, with its
  * own camera and per-layer visibility overrides.
  */
-interface SecondaryMapView {
+export interface SecondaryMapView {
   /** Stable id, used as the React key and the sync-group registration id. */
   id: string;
   view: MapViewState;
@@ -1503,7 +1779,7 @@ interface SecondaryMapView {
    * map) when absent, so existing projects and panes are unchanged. `"cesium"`
    * renders a 3D globe (see {@link CesiumCanvas}) over the same shared layers.
    */
-  viewKind?: "maplibre" | "cesium";
+  viewKind?: MapRendererKind;
   /**
    * Per-layer visibility overrides keyed by layer id. A layer absent from this
    * map inherits the primary map's visibility (`layer.visible`); an entry forces
@@ -1512,9 +1788,9 @@ interface SecondaryMapView {
   layerVisibility: Record<string, boolean>;
 }
 /** The default single-map grid (one pane, sync enabled so it turns on cleanly). */
-declare const DEFAULT_MAP_GRID_LAYOUT: MapGridLayout;
+export declare const DEFAULT_MAP_GRID_LAYOUT: MapGridLayout;
 /** Maximum rows or columns in the map grid (so at most a 4x4 = 16-pane grid). */
-declare const MAX_MAP_GRID_DIM = 4;
+export declare const MAX_MAP_GRID_DIM = 4;
 /**
  * Live multi-user collaboration (issue #307). These types describe the
  * *ephemeral* session state the store holds while a live session is active. It
@@ -1522,15 +1798,15 @@ declare const MAX_MAP_GRID_DIM = 4;
  * `project.ts` serializers never read it) and never tracked in undo history (the
  * store's `partialize` never lists it), so it resets cleanly on reload.
  */
-type CollaborationRole = "host" | "guest";
+export type CollaborationRole = "host" | "guest";
 /** Whether guests may edit (`co-edit`) or only watch (`view-only`). */
-type CollaborationMode = "view-only" | "co-edit";
-interface ParticipantIdentity {
+export type CollaborationMode = "view-only" | "co-edit";
+export interface ParticipantIdentity {
   provider: string;
   userId: string;
   username: string;
 }
-interface CollabInvite {
+export interface CollabInvite {
   token: string;
   role: CollaborationMode;
   createdAt: number;
@@ -1538,7 +1814,7 @@ interface CollabInvite {
   useCount: number;
   revoked: boolean;
 }
-interface CollaborationParticipant {
+export interface CollaborationParticipant {
   clientId: string;
   displayName: string;
   color: string;
@@ -1553,7 +1829,7 @@ interface CollaborationParticipant {
   identity?: ParticipantIdentity | null;
 }
 /** A remote participant's live cursor + viewport, used to render presence. */
-interface CollaborationPresence {
+export interface CollaborationPresence {
   displayName: string;
   color: string;
   cursor?: {
@@ -1563,7 +1839,7 @@ interface CollaborationPresence {
   view?: MapViewState | null;
 }
 /** One in-session chat message (#754). Ephemeral; never persisted to a project. */
-interface CollaborationChatMessage {
+export interface CollaborationChatMessage {
   /** Server-assigned id (stable React key / dedupe). */
   id: string;
   /** clientId of the author. */
@@ -1579,7 +1855,7 @@ interface CollaborationChatMessage {
   /** Server-assigned epoch-ms timestamp. */
   ts: number;
 }
-interface CollaborationState {
+export interface CollaborationState {
   /** True once connected and joined to a session. */
   isActive: boolean;
   /** True while connecting/reconnecting (UI shows a spinner). */
@@ -1614,13 +1890,13 @@ interface CollaborationState {
   error: string | null;
 }
 /** Map projection the renderer uses. Mirrors the GlobeControl toggle. */
-type MapProjection = "globe" | "mercator";
+export type MapProjection = "globe" | "mercator";
 /**
  * Unit system the scale bar reports distances in. `"metric"` uses m/km,
  * `"imperial"` uses ft/mi, and `"nautical"` uses nautical miles.
  */
-type MapScaleUnit = "metric" | "imperial" | "nautical";
-interface MapPreferences {
+export type MapScaleUnit = "metric" | "imperial" | "nautical";
+export interface MapPreferences {
   restrictBounds: boolean;
   bounds: [number, number, number, number];
   minZoom: number;
@@ -1649,6 +1925,8 @@ interface MapPreferences {
   showPointerElevation: boolean;
   /** Whether the built-in 3D terrain control and terrain surface are enabled. */
   terrainEnabled: boolean;
+  /** Cesium imagery override; absent follows the shared project basemap. */
+  cesiumBasemap?: CesiumBasemapId;
   /**
    * Notation the status bar reports the pointer coordinate in: `"dd"` decimal
    * degrees (default), `"dms"` degrees/minutes/seconds, `"ddm"` degrees and
@@ -1659,7 +1937,7 @@ interface MapPreferences {
    */
   coordinateFormat: string;
 }
-interface RuntimeEnvironmentVariable {
+export interface RuntimeEnvironmentVariable {
   key: string;
   value: string;
   enabled: boolean;
@@ -1675,7 +1953,7 @@ declare global {
  * provider so switching backends does not discard the others' keys. Empty
  * endpoint overrides fall back to the provider's default endpoints.
  */
-interface GeocodingPreferences {
+export interface GeocodingPreferences {
   providerId: string;
   /** Per-provider API key / access token, keyed by provider id. */
   apiKeys: Record<string, string>;
@@ -1686,34 +1964,34 @@ interface GeocodingPreferences {
   /** Contact email sent to identify the client (used by Nominatim). */
   email?: string;
 }
-interface ProjectPreferences {
+export interface ProjectPreferences {
   map: MapPreferences;
   environmentVariables: RuntimeEnvironmentVariable[];
   geocoding: GeocodingPreferences;
 }
-type ProjectPluginControlPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
-interface ProjectPluginState {
+export type ProjectPluginControlPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export interface ProjectPluginState {
   manifestUrls: string[];
   activePluginIds: string[];
   mapControlPositions: Record<string, ProjectPluginControlPosition>;
   settings: Record<string, unknown>;
 }
-declare const DEFAULT_PROJECT_PREFERENCES: ProjectPreferences;
+export declare const DEFAULT_PROJECT_PREFERENCES: ProjectPreferences;
 /**
  * A single user override for one legend item, keyed in {@link LegendConfig.overrides}
  * by a stable item key (a layer id for a whole entry, or `${layerId}::${index}`
  * for an individual class within a graduated/categorized entry).
  */
-interface LegendItemOverride {
+export interface LegendItemOverride {
   /** User-supplied label that replaces the auto-generated one. */
   label?: string;
   /** When true, the item is omitted from the rendered legend. */
   hidden?: boolean;
 }
 /** Swatch shape for a hand-authored legend item. */
-type LegendCustomShape = "square" | "circle" | "line";
+export type LegendCustomShape = "square" | "circle" | "line";
 /** One hand-authored legend item: a color swatch plus its label. */
-interface LegendCustomItem {
+export interface LegendCustomItem {
   /** Display label (e.g. an NLCD class name). */
   label: string;
   /** Swatch color as a CSS color (typically `#rrggbb`). */
@@ -1733,14 +2011,14 @@ interface LegendCustomItem {
  * impossible, e.g. a paletted land-cover raster like NLCD); keyed by a
  * `custom:` id it renders as a standalone section not tied to any layer.
  */
-interface LegendCustomEntry {
+export interface LegendCustomEntry {
   /** Optional heading; a layer-keyed entry falls back to the layer name. */
   title?: string;
   /** The items to render, top to bottom. */
   items: LegendCustomItem[];
 }
 /** Map corner the on-map legend panel docks to. */
-type LegendPanelPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export type LegendPanelPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
 /**
  * User customizations for the legend (the on-map Legend panel and the Print
  * Layout legend). The legend itself is always derived from the visible layers'
@@ -1748,7 +2026,7 @@ type LegendPanelPosition = "top-left" | "top-right" | "bottom-left" | "bottom-ri
  * per-item rename/hide, hand-authored entries), so it survives layer additions
  * and removals and is persisted in the `.geolibre.json` project.
  */
-interface LegendConfig {
+export interface LegendConfig {
   /** Heading drawn above the legend entries. */
   title: string;
   /** When true, classes are grouped under a per-layer heading. */
@@ -1780,20 +2058,20 @@ interface LegendConfig {
   /** User-resized panel height in px. See {@link LegendConfig.panelWidth}. */
   panelHeight?: number;
 }
-declare const DEFAULT_LEGEND_CONFIG: LegendConfig;
+export declare const DEFAULT_LEGEND_CONFIG: LegendConfig;
 /** Camera target captured for a story chapter. */
-interface StoryChapterLocation {
+export interface StoryChapterLocation {
   center: [number, number];
   zoom: number;
   pitch: number;
   bearing: number;
 }
 /** Where a chapter's text panel sits over the map. */
-type StoryChapterAlignment = "left" | "center" | "right" | "full";
+export type StoryChapterAlignment = "left" | "center" | "right" | "full";
 /** How the map transitions to a chapter's location. */
-type StoryChapterAnimation = "flyTo" | "easeTo" | "jumpTo";
+export type StoryChapterAnimation = "flyTo" | "easeTo" | "jumpTo";
 /** A layer opacity change triggered when a chapter is entered or exited. */
-interface StoryLayerOpacityChange {
+export interface StoryLayerOpacityChange {
   /** Stable identity for React list keys; optional for older project files. */
   id?: string;
   /** GeoLibre store layer id whose opacity should change. */
@@ -1803,7 +2081,7 @@ interface StoryLayerOpacityChange {
   duration?: number;
 }
 /** A single scene in a scroll-driven story map. */
-interface StoryChapter {
+export interface StoryChapter {
   id: string;
   title: string;
   description: string;
@@ -1819,7 +2097,7 @@ interface StoryChapter {
   onChapterEnter: StoryLayerOpacityChange[];
   onChapterExit: StoryLayerOpacityChange[];
 }
-type StoryInsetPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export type StoryInsetPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
 /**
  * A non-chapter intro/outro slide shown before the first or after the last
  * chapter (#998). `"none"` disables it. The remaining modes are:
@@ -1830,11 +2108,11 @@ type StoryInsetPosition = "top-left" | "top-right" | "bottom-left" | "bottom-rig
  *   the start slide, the last chapter for the closing slide) with all text and
  *   media hidden, so the presenter can zoom into the full content next.
  */
-type StorySlideMode = "none" | "blank" | "black" | "global" | "adjacent";
+export type StorySlideMode = "none" | "blank" | "black" | "global" | "adjacent";
 /** A start/closing slide that is actually shown (every mode except `"none"`). */
-type StoryActiveSlideMode = Exclude<StorySlideMode, "none">;
+export type StoryActiveSlideMode = Exclude<StorySlideMode, "none">;
 /** Scroll-driven story map authored on top of a GeoLibre project. */
-interface StoryMap {
+export interface StoryMap {
   title: string;
   subtitle: string;
   byline: string;
@@ -1856,7 +2134,7 @@ interface StoryMap {
   endSlide: StorySlideMode;
   chapters: StoryChapter[];
 }
-declare const DEFAULT_STORY_MAP: StoryMap;
+export declare const DEFAULT_STORY_MAP: StoryMap;
 /**
  * One step in a {@link ProcessingModel}: a processing tool invoked with a fixed
  * set of parameters. The runner chains steps by feeding each step's output layer
@@ -1864,7 +2142,7 @@ declare const DEFAULT_STORY_MAP: StoryMap;
  * so a step's stored `parameters` for that input is ignored for every step after
  * the first.
  */
-interface ProcessingModelStep {
+export interface ProcessingModelStep {
   /** Stable id, unique within the model (used as the React key and run label). */
   id: string;
   /** The processing tool's registry id (e.g. `"buffer"`). */
@@ -1882,9 +2160,9 @@ interface ProcessingModelStep {
  * raster nodes exchange GeoTIFF bytes. A port declaring `"any"` accepts either
  * and is resolved to a concrete kind at run time by whatever is wired into it.
  */
-type ModelPortKind = "vector" | "raster" | "any";
+export type ModelPortKind = "vector" | "raster" | "any";
 /** One connection point on a {@link ModelGraphNode}. */
-interface ModelGraphPort {
+export interface ModelGraphPort {
   /**
    * Port id, unique within its node and direction. For a tool node's inputs
    * this is the underlying tool parameter id, so wiring an edge and setting the
@@ -1900,9 +2178,9 @@ interface ModelGraphPort {
  * What a node does. `input` sources an existing project layer, `tool` runs a
  * processing algorithm, and `output` names a result to add back to the map.
  */
-type ModelGraphNodeKind = "input" | "tool" | "output";
+export type ModelGraphNodeKind = "input" | "tool" | "output";
 /** One node on the Model Builder canvas. */
-interface ModelGraphNode {
+export interface ModelGraphNode {
   /** Stable id, unique within the graph; referenced by {@link ModelGraphEdge}. */
   id: string;
   kind: ModelGraphNodeKind;
@@ -1928,7 +2206,7 @@ interface ModelGraphNode {
  * port. Ports are named, so a tool with several inputs (Clip's target and
  * overlay, say) wires each one unambiguously.
  */
-interface ModelGraphEdge {
+export interface ModelGraphEdge {
   id: string;
   from: string;
   fromPort: string;
@@ -1936,12 +2214,12 @@ interface ModelGraphEdge {
   toPort: string;
 }
 /** The node-and-edge graph authored on the Model Builder canvas. */
-interface ProcessingModelGraph {
+export interface ProcessingModelGraph {
   nodes: ModelGraphNode[];
   edges: ModelGraphEdge[];
 }
 /** Which registry a {@link ModelGraphNode.toolId} is resolved against. */
-type ModelToolProvider = "vector" | "whitebox";
+export type ModelToolProvider = "vector" | "whitebox";
 /**
  * A reusable processing pipeline ("model" in QGIS Graphical Modeler / ArcGIS
  * ModelBuilder terms), saved in the project file so it can be reloaded and
@@ -1954,7 +2232,7 @@ type ModelToolProvider = "vector" | "whitebox";
  * also writes a `steps` projection whenever its graph happens to be a single
  * chain, so older builds can still run it.
  */
-interface ProcessingModel {
+export interface ProcessingModel {
   id: string;
   name: string;
   steps: ProcessingModelStep[];
@@ -1965,10 +2243,10 @@ interface ProcessingModel {
  * panel's re-run routing: each kind maps to the dialog (and store open-flag)
  * that can be reopened pre-filled with the run's parameters.
  */
-type ProcessingRunKind = "vector" | "statistics" | "network" | "whitebox" | "raster" | "conversion" | "algorithm";
-type ProcessingRunStatus = "success" | "error";
+export type ProcessingRunKind = "vector" | "statistics" | "network" | "whitebox" | "raster" | "conversion" | "algorithm";
+export type ProcessingRunStatus = "success" | "error";
 /** Upper bound on persisted processing-history entries (oldest are dropped). */
-declare const MAX_PROCESSING_HISTORY = 100;
+export declare const MAX_PROCESSING_HISTORY = 100;
 /**
  * One recorded processing tool run (issue #1292). Appended by every processing
  * dialog when a run finishes and persisted in the project file, so a saved
@@ -1976,7 +2254,7 @@ declare const MAX_PROCESSING_HISTORY = 100;
  * stored exactly as the dialog dispatched them (layer parameters hold layer
  * ids), which is what re-run pre-fills and "Copy as Python" emit.
  */
-interface ProcessingRun {
+export interface ProcessingRun {
   /** Stable id, unique within the project (React key and update key). */
   id: string;
   kind: ProcessingRunKind;
@@ -2010,7 +2288,7 @@ interface ProcessingRun {
  * parameter form) and clears it. `autoRun` asks the dialog to start the run
  * immediately after pre-filling (plain Re-run vs Edit & re-run).
  */
-interface ProcessingRerunRequest {
+export interface ProcessingRerunRequest {
   kind: ProcessingRunKind;
   toolId: string;
   parameters: Record<string, unknown>;
@@ -2019,15 +2297,15 @@ interface ProcessingRerunRequest {
   autoRun?: boolean;
 }
 /** Column-count bounds for the Dashboard panel's widget grid. */
-declare const MIN_DASHBOARD_COLUMNS = 1;
-declare const MAX_DASHBOARD_COLUMNS = 6;
-declare const DEFAULT_DASHBOARD_COLUMNS = 2;
+export declare const MIN_DASHBOARD_COLUMNS = 1;
+export declare const MAX_DASHBOARD_COLUMNS = 6;
+export declare const DEFAULT_DASHBOARD_COLUMNS = 2;
 /** The chart a {@link DashboardWidget} draws. Mirrors the attribute Charts
  * panel's types so a widget reuses the same rendering. The `"indicator"` type
  * is a non-chart KPI tile (issue #1381). */
-type DashboardWidgetType = "histogram" | "scatter" | "bar" | "line" | "box" | "pie" | "indicator" | "selector" | "list";
+export type DashboardWidgetType = "histogram" | "scatter" | "bar" | "line" | "box" | "pie" | "indicator" | "selector" | "list";
 /** How a bar widget reduces its category groups. */
-type DashboardWidgetAggregation = "count" | "sum" | "mean";
+export type DashboardWidgetAggregation = "count" | "sum" | "mean";
 /**
  * One chart in the Dashboard panel: a chart type bound to a layer and the
  * field(s) it plots. Which `field*`/`category`/`aggregation` keys apply depends
@@ -2036,7 +2314,7 @@ type DashboardWidgetAggregation = "count" | "sum" | "mean";
  * keys are simply ignored, so the record stays flat and easy to hand-edit.
  * Saved in the project file so a dashboard reopens with its widgets intact.
  */
-interface DashboardWidget {
+export interface DashboardWidget {
   /** Stable id, unique within the project (React key and store key). */
   id: string;
   /** The layer whose features feed this widget. */
@@ -2083,7 +2361,7 @@ interface DashboardWidget {
 }
 /** Aggregation functions for indicator widgets (issue #1381). Extends the bar
  * widget aggregation with min, max, and median. */
-type IndicatorAggregation = "count" | "sum" | "mean" | "min" | "max" | "median";
+export type IndicatorAggregation = "count" | "sum" | "mean" | "min" | "max" | "median";
 /**
  * What slice of a layer's styling a Style Manager entry captures (issue #1294).
  *
@@ -2095,7 +2373,7 @@ type IndicatorAggregation = "count" | "sum" | "mean" | "min" | "max" | "median";
  *   count, classification scheme), independent of the attribute the target
  *   layer classifies on.
  */
-type StyleLibraryEntryKind = "style" | "symbol" | "labels" | "ramp";
+export type StyleLibraryEntryKind = "style" | "symbol" | "labels" | "ramp";
 /**
  * One saved, reusable style in the Style Manager library (issue #1294). The
  * payload is a {@link LayerStyle} subset chosen by {@link kind}; applying an
@@ -2103,7 +2381,7 @@ type StyleLibraryEntryKind = "style" | "symbol" | "labels" | "ramp";
  * in the app-level library (persisted across projects) or embedded in a
  * project file's `styleLibrary` array.
  */
-interface StyleLibraryEntry {
+export interface StyleLibraryEntry {
   /** Stable id, used as the IndexedDB/store key; upserts overwrite by id. */
   id: string;
   /** Display name shown in the Style Manager. */
@@ -2130,7 +2408,7 @@ interface StyleLibraryEntry {
  * their features are embedded in {@link geojson} behind a size cap. See
  * `layer-library.ts` for how an entry is captured and re-added.
  */
-interface LayerLibraryEntry {
+export interface LayerLibraryEntry {
   /** Stable id, used as the IndexedDB/store key; upserts overwrite by id. */
   id: string;
   /** Display name shown in the Browser panel's My Data section. */
@@ -2170,7 +2448,7 @@ interface LayerLibraryEntry {
   needsLocalFile?: boolean;
 }
 /** One saved template in the Template Library. */
-interface ProjectTemplateEntry {
+export interface ProjectTemplateEntry {
   id: string;
   name: string;
   description?: string;
@@ -2178,7 +2456,7 @@ interface ProjectTemplateEntry {
   createdAt: string;
   updatedAt: string;
 }
-interface GeoLibreProject {
+export interface GeoLibreProject {
   id?: string;
   version: string;
   name: string;
@@ -2229,6 +2507,17 @@ interface GeoLibreProject {
   secondaryMapViews?: SecondaryMapView[];
   /** User-entered label for the primary pane; omitted when empty. */
   primaryMapLabel?: string;
+  /**
+   * Which engine draws the primary map area (issue #2217). Omitted for the
+   * default 2D map, so every project written before this existed — and every
+   * project that never leaves MapLibre — is byte-identical to before. A project
+   * saved as `"cesium"` reopens directly on the 3D globe.
+   *
+   * This is independent of {@link mapLayout}: a 1x1 workspace can be either
+   * renderer, and a multi-pane grid can still mix the two through each pane's
+   * {@link SecondaryMapView.viewKind}.
+   */
+  primaryRenderer?: MapRendererKind;
   /**
    * Project-scoped Style Manager entries (issue #1294), so a project can carry
    * its reusable styles to teammates. Omitted when empty; the app-level
@@ -2239,7 +2528,7 @@ interface GeoLibreProject {
   comments?: ProjectComment[];
   metadata: Record<string, unknown>;
 }
-type CommentAnchor = {
+export type CommentAnchor = {
   type: "point";
   lngLat: [number, number];
 } | {
@@ -2248,17 +2537,17 @@ type CommentAnchor = {
   featureId: string | number;
   lngLat?: [number, number];
 };
-interface CommentAuthor {
+export interface CommentAuthor {
   name: string;
   color: string;
 }
-interface CommentReply {
+export interface CommentReply {
   id: string;
   author: CommentAuthor;
   body: string;
   createdAt: string;
 }
-interface ProjectComment {
+export interface ProjectComment {
   id: string;
   anchor: CommentAnchor;
   author: CommentAuthor;
@@ -2267,7 +2556,7 @@ interface ProjectComment {
   resolved: boolean;
   replies: CommentReply[];
 }
-interface RecentProjectEntry {
+export interface RecentProjectEntry {
   path: string;
   name: string;
   openedAt: string;
@@ -2285,10 +2574,10 @@ interface RecentProjectEntry {
  * same file behaved differently depending on how it was added, and no single
  * number could be documented.
  */
-declare const DUCKDB_VECTOR_ROUTE_BYTES: number;
-declare const DUCKDB_VECTOR_FEATURE_WARN_COUNT = 100000;
+export declare const DUCKDB_VECTOR_ROUTE_BYTES: number;
+export declare const DUCKDB_VECTOR_FEATURE_WARN_COUNT = 100000;
 /** A collection whose coordinates cannot be WGS84 longitude/latitude. */
-interface NonGeographicCoordinates {
+export interface NonGeographicCoordinates {
   /** How many coordinates were inspected. */
   sampled: number;
   /** The largest |x| seen — a longitude may not exceed 180. */
@@ -2314,7 +2603,7 @@ interface NonGeographicCoordinates {
  *
  * @returns Details when a coordinate is out of geographic range, else null.
  */
-declare function detectNonGeographicCoordinates(geojson: GeoJSON.FeatureCollection | undefined, sampleLimit?: number): NonGeographicCoordinates | null;
+export declare function detectNonGeographicCoordinates(geojson: GeoJSON.FeatureCollection | undefined, sampleLimit?: number): NonGeographicCoordinates | null;
 //#endregion
 //#region src/diagram.d.ts
 /**
@@ -2323,7 +2612,7 @@ declare function detectNonGeographicCoordinates(geojson: GeoJSON.FeatureCollecti
  * hang the UI; typical thematic layers (counties, districts) sit well below
  * this.
  */
-declare const MAX_DIAGRAM_FEATURES = 2000;
+export declare const MAX_DIAGRAM_FEATURES = 2000;
 /**
  * Hard cap on how many raw features {@link collectDiagramData} visits while
  * looking for drawable diagrams. Without it, a layer whose drawable ratio is
@@ -2331,11 +2620,11 @@ declare const MAX_DIAGRAM_FEATURES = 2000;
  * an arbitrarily large collection on every rebuild. Features past this bound
  * are treated as truncation, which the Style Panel surfaces.
  */
-declare const MAX_DIAGRAM_SCAN_FEATURES = 100000;
+export declare const MAX_DIAGRAM_SCAN_FEATURES = 100000;
 /** Smallest rendered diagram size in pixels under scaled sizing. */
-declare const MIN_DIAGRAM_SIZE = 8;
+export declare const MIN_DIAGRAM_SIZE = 8;
 /** One feature's chart, ready for drawing. */
-interface DiagramDatum {
+export interface DiagramDatum {
   /** Anchor position: the point location or polygon/line midpoint centroid. */
   position: [number, number];
   /** One value per configured diagram field (negatives clamped to 0). */
@@ -2346,7 +2635,7 @@ interface DiagramDatum {
   sizeValue: number;
 }
 /** The per-layer diagram dataset plus the maxima needed for scaling. */
-interface DiagramData {
+export interface DiagramData {
   data: DiagramDatum[];
   /** Largest {@link DiagramDatum.sizeValue} (0 when there is no data). */
   maxSizeValue: number;
@@ -2363,7 +2652,7 @@ interface DiagramData {
  *
  * @param style - The layer style to test.
  */
-declare function isDiagramStyleEnabled(style: LayerStyle): boolean;
+export declare function isDiagramStyleEnabled(style: LayerStyle): boolean;
 /**
  * Whether a heatmap/cluster point renderer suppresses the layer's diagrams.
  * The point renderer only applies (and is only user-editable) on point-only
@@ -2379,7 +2668,7 @@ declare function isDiagramStyleEnabled(style: LayerStyle): boolean;
  * @param geojson - The layer's feature collection (undefined suppresses nothing).
  * @param style - The layer style carrying `pointRenderer`.
  */
-declare function diagramsSuppressedByPointRenderer(geojson: FeatureCollection | undefined, style: LayerStyle): boolean;
+export declare function diagramsSuppressedByPointRenderer(geojson: FeatureCollection | undefined, style: LayerStyle): boolean;
 /**
  * Where a feature's diagram is anchored: the point itself, a line's middle
  * vertex, or the polygon centroid (largest part of a multi-polygon). Returns
@@ -2387,7 +2676,7 @@ declare function diagramsSuppressedByPointRenderer(geojson: FeatureCollection |
  *
  * @param geometry - The feature geometry (may be null for null-geometry rows).
  */
-declare function diagramAnchor(geometry: Geometry | null | undefined): [number, number] | null;
+export declare function diagramAnchor(geometry: Geometry | null | undefined): [number, number] | null;
 /**
  * Extract the per-feature diagram dataset from a layer's GeoJSON and style:
  * one {@link DiagramDatum} per feature that has an anchor and at least one
@@ -2397,7 +2686,7 @@ declare function diagramAnchor(geometry: Geometry | null | undefined): [number,
  * @param geojson - The layer's feature collection.
  * @param style - The layer style carrying the diagram configuration.
  */
-declare function collectDiagramData(geojson: FeatureCollection, style: LayerStyle): DiagramData;
+export declare function collectDiagramData(geojson: FeatureCollection, style: LayerStyle): DiagramData;
 /**
  * The rendered size (diameter for pie/donut, box height/width for bars) of one
  * diagram in pixels. Fixed sizing returns the configured size; scaled sizing
@@ -2410,7 +2699,7 @@ declare function collectDiagramData(geojson: FeatureCollection, style: LayerStyl
  * @param maxSizeValue - The dataset's largest size value (from
  *   {@link collectDiagramData}).
  */
-declare function diagramPixelSize(datum: DiagramDatum, style: LayerStyle, maxSizeValue: number): number;
+export declare function diagramPixelSize(datum: DiagramDatum, style: LayerStyle, maxSizeValue: number): number;
 //#endregion
 //#region src/marker-shape.d.ts
 /**
@@ -2430,7 +2719,7 @@ declare function diagramPixelSize(datum: DiagramDatum, style: LayerStyle, maxSiz
  * @param size - The box edge length in pixels; the shape is inset slightly so a
  *   stroke is not clipped at the edge.
  */
-declare function drawMarkerPath(ctx: CanvasRenderingContext2D, shape: MarkerShape, size: number): void;
+export declare function drawMarkerPath(ctx: CanvasRenderingContext2D, shape: MarkerShape, size: number): void;
 /**
  * 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):`
@@ -2453,7 +2742,7 @@ declare function drawMarkerPath(ctx: CanvasRenderingContext2D, shape: MarkerShap
  * @param markup - Raw SVG markup, a `data:` URL, or an `http(s)` URL.
  * @returns An `Image.src` value, or `null` when nothing loadable was given.
  */
-declare function resolveSvgSource(markup: string): string | null;
+export declare function resolveSvgSource(markup: string): string | null;
 //#endregion
 //#region src/hyperlink.d.ts
 /**
@@ -2463,7 +2752,7 @@ declare function resolveSvgSource(markup: string): string | null;
  * are accepted. Substrings in prose and schemes such as `javascript:` and
  * `file:` remain plain text.
  */
-declare function attributeLinkUrl(value: unknown): string | null;
+export declare function attributeLinkUrl(value: unknown): string | null;
 //#endregion
 //#region src/photo.d.ts
 /**
@@ -2473,7 +2762,7 @@ declare function attributeLinkUrl(value: unknown): string | null;
  * geotagged-photo or field-collection layer.
  */
 /** Property key under which a photo's downscaled thumbnail (data URL) is stored. */
-declare const PHOTO_PROPERTY = "photo";
+export declare const PHOTO_PROPERTY = "photo";
 /**
  * Property key under which a geotagged photo's full-resolution image (a data URL
  * of the original, un-re-encoded bytes) is stored. {@link PHOTO_PROPERTY} holds
@@ -2482,7 +2771,7 @@ declare const PHOTO_PROPERTY = "photo";
  * image". Absent when the source is already at or below the thumbnail cap, or a
  * format a browser cannot display at native size (TIFF/HEIC).
  */
-declare const PHOTO_FULL_PROPERTY = "photo_full";
+export declare const PHOTO_FULL_PROPERTY = "photo_full";
 //#endregion
 //#region src/ellipsoids.d.ts
 /**
@@ -2506,7 +2795,7 @@ declare const PHOTO_FULL_PROPERTY = "photo_full";
  * shortcut over a full CRS/context refactor.
  */
 /** A biaxial (rotational) ellipsoid describing a celestial body. */
-interface Ellipsoid {
+export interface Ellipsoid {
   /** Stable id persisted in the project (`map.ellipsoidId`). */
   id: string;
   /** Human-readable name shown in the UI. */
@@ -2526,7 +2815,7 @@ interface Ellipsoid {
  * products treat them and is well within the accuracy MapLibre's unit-sphere
  * rendering can represent anyway.
  */
-declare const ELLIPSOIDS: readonly [{
+export declare const ELLIPSOIDS: readonly [{
   readonly id: "earth";
   readonly name: "Earth (WGS 84)";
   readonly semiMajorAxisMeters: 6378137;
@@ -2587,29 +2876,29 @@ declare const ELLIPSOIDS: readonly [{
   readonly semiMajorAxisMeters: 606000;
   readonly inverseFlattening: 0;
 }];
-type EllipsoidId = (typeof ELLIPSOIDS)[number]["id"];
-declare const DEFAULT_ELLIPSOID_ID: EllipsoidId;
+export type EllipsoidId = (typeof ELLIPSOIDS)[number]["id"];
+export declare const DEFAULT_ELLIPSOID_ID: EllipsoidId;
 /** Look an ellipsoid up by id, falling back to Earth for unknown ids. */
-declare function getEllipsoid(id: string | undefined): Ellipsoid;
+export declare function getEllipsoid(id: string | undefined): Ellipsoid;
 /**
  * Mean radius `R = (2a + b) / 3` in metres, where `b` is the polar radius
  * derived from the inverse flattening. This is the radius used for spherical
  * (haversine) distance and area math.
  */
-declare function meanRadiusMeters(ellipsoid: Ellipsoid): number;
+export declare function meanRadiusMeters(ellipsoid: Ellipsoid): number;
 /** Earth's mean radius in metres — the radius Turf.js and MapLibre bake in. */
-declare const EARTH_MEAN_RADIUS_METERS: number;
+export declare const EARTH_MEAN_RADIUS_METERS: number;
 /**
  * Point the measurement helpers at a body. Unknown ids fall back to Earth so a
  * malformed project can never break measurements. Safe to call on every
  * preferences change; it is a cheap assignment.
  */
-declare function setActiveEllipsoidId(id: string | undefined): void;
-declare function getActiveEllipsoid(): Ellipsoid;
+export declare function setActiveEllipsoidId(id: string | undefined): void;
+export declare function getActiveEllipsoid(): Ellipsoid;
 /** Mean radius (metres) of the active body — for haversine distance/area. */
-declare function getActiveMeanRadiusMeters(): number;
+export declare function getActiveMeanRadiusMeters(): number;
 /** Semi-major axis (metres) of the active body — for its Web-Mercator scale. */
-declare function getActiveSemiMajorAxisMeters(): number;
+export declare function getActiveSemiMajorAxisMeters(): number;
 /**
  * The active body's mean radius as a fraction of Earth's — `R_body / R_earth`,
  * and exactly `1` on Earth.
@@ -2625,7 +2914,7 @@ declare function getActiveSemiMajorAxisMeters(): number;
  * Suggested by @thareUSGS (USGS Astrogeology) on GeoLibre#1128 as the practical
  * workaround planetary web maps have long used on Earth-locked engines.
  */
-declare function getActiveBodyRadiusRatio(): number;
+export declare function getActiveBodyRadiusRatio(): number;
 /**
  * Convert a length Turf.js measured on Earth into the active body's true ground
  * length. A no-op on Earth.
@@ -2636,7 +2925,7 @@ declare function getActiveBodyRadiusRatio(): number;
  * length in whatever unit Turf gave it back (metres, kilometres, miles) and the
  * result is in that same unit. There is no hidden unit conversion here.
  */
-declare function earthLengthToBody(length: number): number;
+export declare function earthLengthToBody(length: number): number;
 /**
  * Convert a true ground length on the active body into the Earth-equivalent
  * length to hand Turf.js. A no-op on Earth.
@@ -2648,7 +2937,7 @@ declare function earthLengthToBody(length: number): number;
  * Unit-agnostic like {@link earthLengthToBody}: pass the length in whatever
  * unit you are about to hand Turf alongside it, and the result is in that unit.
  */
-declare function bodyLengthToEarth(length: number): number;
+export declare function bodyLengthToEarth(length: number): number;
 /**
  * Convert an area Turf.js measured on Earth into the active body's true ground
  * area. A no-op on Earth.
@@ -2657,7 +2946,7 @@ declare function bodyLengthToEarth(length: number): number;
  * correction as {@link earthLengthToBody}. Unit-agnostic in the same way, for
  * whatever squared unit the area is expressed in.
  */
-declare function earthAreaToBody(area: number): number;
+export declare function earthAreaToBody(area: number): number;
 /**
  * A raster basemap for a celestial body — the Moon and Mars mosaics, plus the
  * Earth satellite imagery the planet switcher pairs with Earth. The tiles are
@@ -2666,7 +2955,7 @@ declare function earthAreaToBody(area: number): number;
  * sentinel; the map controller expands it into a raster style at apply time (it
  * is not a fetchable URL).
  */
-interface PlanetaryBasemap {
+export interface PlanetaryBasemap {
   id: string;
   name: string;
   /** Sentinel stored as the basemap style URL. */
@@ -2687,8 +2976,8 @@ interface PlanetaryBasemap {
   /** The body this basemap depicts, so selecting it can set the ellipsoid. */
   ellipsoidId: EllipsoidId;
 }
-declare const PLANETARY_BASEMAP_SENTINEL_PREFIX = "geolibre://basemap/";
-declare const PLANETARY_BASEMAPS: readonly PlanetaryBasemap[];
+export declare const PLANETARY_BASEMAP_SENTINEL_PREFIX = "geolibre://basemap/";
+export declare const PLANETARY_BASEMAPS: readonly PlanetaryBasemap[];
 /**
  * The section a planetary basemap is grouped under in the New Project and
  * Change Basemap pickers. The Moon and Mars keep dedicated sections (they are
@@ -2696,9 +2985,9 @@ declare const PLANETARY_BASEMAPS: readonly PlanetaryBasemap[];
  * collapsed into a single "other" section so the picker isn't a wall of
  * one-item headings.
  */
-type PlanetaryBasemapSectionId = "moon" | "mars" | "other";
+export type PlanetaryBasemapSectionId = "moon" | "mars" | "other";
 /** A picker section paired with the planetary basemaps it lists. */
-interface PlanetaryBasemapGroup {
+export interface PlanetaryBasemapGroup {
   id: PlanetaryBasemapSectionId;
   basemaps: readonly PlanetaryBasemap[];
 }
@@ -2708,11 +2997,11 @@ interface PlanetaryBasemapGroup {
  * in {@link PLANETARY_BASEMAPS} order (grouped by body). Empty sections are
  * dropped.
  */
-declare const PLANETARY_BASEMAP_GROUPS: readonly PlanetaryBasemapGroup[];
+export declare const PLANETARY_BASEMAP_GROUPS: readonly PlanetaryBasemapGroup[];
 /** Resolve a `geolibre://basemap/<id>` sentinel to its planetary basemap. */
-declare function getPlanetaryBasemapByStyleUrl(styleUrl: string | undefined): PlanetaryBasemap | undefined;
+export declare function getPlanetaryBasemapByStyleUrl(styleUrl: string | undefined): PlanetaryBasemap | undefined;
 /** Look a planetary basemap up by its stable id. */
-declare function getPlanetaryBasemapById(id: string): PlanetaryBasemap | undefined;
+export declare function getPlanetaryBasemapById(id: string): PlanetaryBasemap | undefined;
 /**
  * The celestial bodies offered by the Layers-panel planet switcher, in menu
  * order (like Google Earth's planet dropdown). Each body is paired with the
@@ -2720,7 +3009,7 @@ declare function getPlanetaryBasemapById(id: string): PlanetaryBasemap | undefin
  * OpenPlanetaryMap Hillshaded Albedo mosaic for the Moon, and the OpenPlanetaryMap
  * Viking mosaic for Mars.
  */
-declare const PLANET_SWITCHER_OPTIONS: readonly [{
+export declare const PLANET_SWITCHER_OPTIONS: readonly [{
   readonly ellipsoidId: "earth";
   readonly basemapId: "earth-usgs-imagery";
 }, {
@@ -2780,11 +3069,11 @@ declare const PLANET_SWITCHER_OPTIONS: readonly [{
  * heading and explanatory note inside the single "Regional" section, so a
  * future region slots in without the section itself becoming country-specific.
  */
-type RegionalBasemapRegionId = "china";
+export type RegionalBasemapRegionId = "china";
 /**
  * A raster basemap for a region, rendered from XYZ (or TMS) tiles.
  */
-interface RegionalBasemap {
+export interface RegionalBasemap {
   id: string;
   /** Which region heading this basemap sits under. */
   region: RegionalBasemapRegionId;
@@ -2824,7 +3113,7 @@ interface RegionalBasemap {
    */
   gcj02?: boolean;
 }
-declare const REGIONAL_BASEMAP_SENTINEL_PREFIX = "geolibre://regional-basemap/";
+export declare const REGIONAL_BASEMAP_SENTINEL_PREFIX = "geolibre://regional-basemap/";
 /**
  * Basemaps served from inside mainland China.
  *
@@ -2833,117 +3122,53 @@ declare const REGIONAL_BASEMAP_SENTINEL_PREFIX = "geolibre://regional-basemap/";
  * tile rather than a 404 past zoom 18, and Tencent 400s past 19 with zoom 19
  * already blank.
  */
-declare const CHINA_BASEMAPS: readonly RegionalBasemap[];
+export declare const CHINA_BASEMAPS: readonly RegionalBasemap[];
 /** Every regional basemap, across all regions. */
-declare const REGIONAL_BASEMAPS: readonly RegionalBasemap[];
+export declare const REGIONAL_BASEMAPS: readonly RegionalBasemap[];
 /**
  * The regional basemaps grouped for display, one entry per region. Both the New
  * Project and Change Basemap panels render this inside a single collapsible
  * "Regional" section, so adding a region is a change here rather than in two
  * dialogs.
  */
-declare const REGIONAL_BASEMAP_GROUPS: readonly {
+export declare const REGIONAL_BASEMAP_GROUPS: readonly {
   id: RegionalBasemapRegionId;
   basemaps: readonly RegionalBasemap[];
 }[];
 /** Look up a regional basemap by its `geolibre://regional-basemap/<id>` sentinel. */
-declare function getRegionalBasemapByStyleUrl(styleUrl: string | undefined): RegionalBasemap | undefined;
+export declare function getRegionalBasemapByStyleUrl(styleUrl: string | undefined): RegionalBasemap | undefined;
 /** Look up a regional basemap by id. */
-declare function getRegionalBasemapById(id: string | undefined): RegionalBasemap | undefined;
+export declare function getRegionalBasemapById(id: string | undefined): RegionalBasemap | undefined;
 /** Whether a style URL is a regional-basemap sentinel, resolvable or not. */
-declare function isRegionalBasemapSentinel(styleUrl: string | undefined): boolean;
+export declare function isRegionalBasemapSentinel(styleUrl: string | undefined): boolean;
 //#endregion
-//#region src/cesium-imagery.d.ts
-/**
- * Maps the project's basemap onto imagery the Cesium globe can render.
- *
- * The 2D panes render `basemapStyleUrl` through MapLibre, which understands
- * vector GL styles and GeoLibre's `geolibre://` sentinels. Cesium understands
- * neither: it draws imagery from tile providers only. So a globe pane that
- * simply mounted the store basemap would show nothing, which is why the pane
- * used to hardcode Ion World Imagery (with a token) or OpenStreetMap (without)
- * and ignore the user's choice entirely — leaving a bright globe beside dark 2D
- * panes and breaking the "same map, different projection" promise the multi-map
- * grid makes.
- *
- * This module is the translation. It is deliberately **engine-free** — it
- * returns a plain descriptor and never imports Cesium — so it lives in
- * `@geolibre/core` beside the basemap catalogs it reads, the 2D and 3D
- * renderers share one source of truth, and the Cesium chunk boundary in
- * `vite.config.ts` stays intact.
- *
- * Three outcomes are possible, and the caller has to handle all three (see
- * {@link CesiumBasemapImagery}): tiles to draw, nothing to draw, or "no raster
- * equivalent exists — pick your own default".
- */
-/**
- * What the globe should draw underneath the project's data layers.
- *
- * - `xyz` — a tile template to render, with the credit and zoom bounds that go
- *   with it.
- * - `none` — the user chose the blank basemap; draw a bare ellipsoid.
- * - `default` — this basemap has no raster equivalent (a custom style URL, a
- *   provider style, an offline archive). The renderer falls back to whatever it
- *   can offer, which is Ion World Imagery when a token is configured and
- *   OpenStreetMap otherwise.
- */
-type CesiumBasemapImagery = {
-  kind: "none";
-} | {
-  kind: "default";
-} | {
-  kind: "xyz";
-  /** Tile template with `{z}`/`{x}`/`{y}` placeholders. */
-  template: string;
-  /** Credit to show on the globe, as the HTML the 2D map already uses. */
-  attribution: string;
-  /** Max native zoom of the source, so the globe overzooms rather than 404s. */
-  maximumLevel?: number;
-  /**
-   * Tile row ordering. `"tms"` numbers rows from the bottom; absent means
-   * standard XYZ. Cesium has no `scheme` option, so a TMS template needs
-   * `{y}` swapped for its `{reverseY}` placeholder at render time.
-   */
-  scheme?: "tms";
-  /**
-   * A transparent overlay drawn directly above {@link template} — the
-   * roads-and-labels tiles a hybrid basemap (Amap Hybrid) bakes in, so one
-   * basemap selection still yields a labelled satellite globe.
-   */
-  overlayTemplate?: string;
-};
+//#region src/geojson-z.d.ts
 /**
- * Whether two descriptors would draw the same thing.
- *
- * Descriptors are built fresh on every call, so two basemaps resolving to the
- * same analogue — OpenFreeMap `liberty` and `bright` are both the streets
- * tone — yield equal but distinct objects. A renderer that remembers the
- * descriptor it drew (to skip redundant work) must compare by value: a
- * reference check would miss that case and tear down and re-add an identical
- * tile provider, costing a flash and a round of re-requested tiles for no
- * visible change.
+ * Helpers for vector data whose coordinates carry a Z value (elevation), e.g.
+ * GPX tracks with `<ele>` readings or LineStringZ/PointZ geometries. MapLibre's
+ * 2D style layers ignore the third coordinate, so layers that want to render
+ * their Z values use these helpers to detect and rescale elevations before
+ * handing the data to a deck.gl overlay. The same data can carry its elevation
+ * in a `bbox` member too, which `horizontalBbox` trims back to two dimensions.
  */
-declare function sameCesiumImagery(a: CesiumBasemapImagery, b: CesiumBasemapImagery): boolean;
 /**
- * Translate a basemap style URL into imagery for the Cesium globe.
+ * Reduces a bounding box to its horizontal extent, `[west, south, east, north]`.
  *
- * Planetary and regional basemaps are already raster tile sets, so they carry
- * straight over — the globe shows the same Mars/Moon/Amap tiles the 2D panes
- * do. GeoLibre's own vector styles map to a keyless raster basemap of matching
- * tone, so switching the project to a dark basemap darkens the globe too.
- * Everything else reports `default`, leaving the choice of fallback imagery to
- * the renderer (which knows whether an Ion token is configured).
+ * RFC 7946 §5 lets a `bbox` member carry elevation, in which case it holds six
+ * values — `[west, south, minAltitude, east, north, maxAltitude]` — and
+ * `@turf/bbox` returns a collection's own member verbatim rather than
+ * recomputing it. A consumer reading such a box as four values takes the
+ * altitude for a longitude and the east edge for a latitude; that is how a 3D
+ * feed reached MapLibre as an out-of-range latitude (#2358).
  *
- * A `geolibre://` sentinel that no longer resolves is treated as the default
- * basemap, mirroring what `resolveMapStyle` does for the 2D map rather than
- * handing the sentinel onward as if it were fetchable.
+ * Returns null when there is no usable horizontal extent: a box of any other
+ * length, or one carrying a non-finite value anywhere — an empty collection, or
+ * one whose features all have a null geometry, bboxes to ±Infinity, and a box
+ * whose altitudes are not finite is not one to trust the rest of.
  *
- * @param styleUrl - The project's `basemapStyleUrl`.
- * @returns What the globe should draw beneath the data layers.
+ * @param box - A GeoJSON or Turf bounding box, of four or six values.
  */
-declare function basemapToCesiumImagery(styleUrl: string | undefined): CesiumBasemapImagery;
-//#endregion
-//#region src/geojson-z.d.ts
+export declare function horizontalBbox(box: readonly number[] | null | undefined): [number, number, number, number] | null;
 /**
  * Returns true when any coordinate in the GeoJSON carries a finite, non-zero
  * Z value. All-zero Z arrays are treated as flat data because rendering them
@@ -2952,7 +3177,7 @@ declare function basemapToCesiumImagery(styleUrl: string | undefined): CesiumBas
  *
  * @param geojson - Any GeoJSON object (geometry, feature, or collection).
  */
-declare function geojsonHasZCoordinates(geojson: GeoJSON$1 | null | undefined): boolean;
+export declare function geojsonHasZCoordinates(geojson: GeoJSON$1 | null | undefined): boolean;
 /**
  * Returns a copy of the GeoJSON with every coordinate's Z value mapped to
  * `z * verticalScale + offset` (missing or non-finite Z treated as 0). Used
@@ -2965,7 +3190,7 @@ declare function geojsonHasZCoordinates(geojson: GeoJSON$1 | null | undefined):
  * @param verticalScale - Multiplier applied to each Z value.
  * @param offset - Constant altitude in meters added after scaling.
  */
-declare function transformGeojsonElevation(geojson: FeatureCollection, verticalScale: number, offset: number): FeatureCollection;
+export declare function transformGeojsonElevation(geojson: FeatureCollection, verticalScale: number, offset: number): FeatureCollection;
 //#endregion
 //#region src/color-ramp.d.ts
 /**
@@ -2977,13 +3202,13 @@ declare function transformGeojsonElevation(geojson: FeatureCollection, verticalS
  * (`COLORMAP_INDEX` keys) so a ramp choice maps 1:1 onto the raster render
  * path.
  */
-type ColorRamp = {
+export type ColorRamp = {
   value: string;
   label: string;
   colors: readonly string[];
 };
 /** The built-in color ramps offered by the style panels. */
-declare const VECTOR_COLOR_RAMPS: readonly ColorRamp[];
+export declare const VECTOR_COLOR_RAMPS: readonly ColorRamp[];
 /**
  * Resolves a ramp definition by name, falling back to the first ramp when the
  * name is unknown.
@@ -2991,7 +3216,7 @@ declare const VECTOR_COLOR_RAMPS: readonly ColorRamp[];
  * @param value - The ramp `value` (e.g. "viridis").
  * @returns The matching ramp, or the first ramp.
  */
-declare function getVectorColorRamp(value: string): ColorRamp;
+export declare function getVectorColorRamp(value: string): ColorRamp;
 /**
  * Samples a ramp into `count` evenly spaced hex colors by linearly
  * interpolating between the ramp's anchor colors.
@@ -3000,7 +3225,7 @@ declare function getVectorColorRamp(value: string): ColorRamp;
  * @param count - Number of colors to produce.
  * @returns An array of `count` hex colors (a single end color when count <= 1).
  */
-declare function interpolateRampColors(colorRamp: string, count: number): string[];
+export declare function interpolateRampColors(colorRamp: string, count: number): string[];
 /**
  * Samples an explicit list of anchor colors into `count` evenly spaced hex
  * colors by linear interpolation. Backs both the named ramps and user-defined
@@ -3010,7 +3235,7 @@ declare function interpolateRampColors(colorRamp: string, count: number): string
  * @param count - Number of colors to produce.
  * @returns An array of `count` hex colors (a single end color when count <= 1).
  */
-declare function interpolateColors(colors: readonly string[], count: number): string[];
+export declare function interpolateColors(colors: readonly string[], count: number): string[];
 /**
  * Normalizes a single user-entered color token into a canonical `#rrggbb`
  * lowercase hex string, or null when it is not a valid 3- or 6-digit hex
@@ -3020,7 +3245,7 @@ declare function interpolateColors(colors: readonly string[], count: number): st
  * @param token - A raw color token (e.g. "FF0000", "#f00", " #AaBbCc ").
  * @returns The canonical `#rrggbb` color, or null when invalid.
  */
-declare function normalizeHexColor(token: string): string | null;
+export declare function normalizeHexColor(token: string): string | null;
 /**
  * Parses a free-text list of hex color codes into canonical `#rrggbb` colors,
  * for the custom color-ramp inputs. Tokens may be separated by commas,
@@ -3030,7 +3255,7 @@ declare function normalizeHexColor(token: string): string | null;
  * @param input - The raw text the user entered.
  * @returns The valid, normalized colors in input order.
  */
-declare function parseHexColorList(input: string): string[];
+export declare function parseHexColorList(input: string): string[];
 /**
  * Linearly interpolates between two hex colors.
  *
@@ -3039,14 +3264,14 @@ declare function parseHexColorList(input: string): string[];
  * @param ratio - Blend factor in [0, 1].
  * @returns The interpolated hex color.
  */
-declare function interpolateHexColor(from: string, to: string, ratio: number): string;
+export declare function interpolateHexColor(from: string, to: string, ratio: number): string;
 /**
  * Parses a `#rrggbb` hex color into its RGB channels.
  *
  * @param value - A `#rrggbb` hex color.
  * @returns The red, green, and blue channels (0-255).
  */
-declare function parseHexColor(value: string): {
+export declare function parseHexColor(value: string): {
   b: number;
   g: number;
   r: number;
@@ -3057,7 +3282,7 @@ declare function parseHexColor(value: string): {
  * @param color - The red, green, and blue channels (0-255).
  * @returns A `#rrggbb` hex color.
  */
-declare function rgbToHex(color: {
+export declare function rgbToHex(color: {
   b: number;
   g: number;
   r: number;
@@ -3070,7 +3295,7 @@ declare function rgbToHex(color: {
  * @param count - Number of breaks to produce.
  * @returns The break values (min..max inclusive when count > 1).
  */
-declare function createEqualIntervalBreaks(min: number, max: number, count: number): number[];
+export declare function createEqualIntervalBreaks(min: number, max: number, count: number): number[];
 /**
  * Builds `count` quantile break values from a sample of numeric values.
  *
@@ -3083,9 +3308,9 @@ declare function createEqualIntervalBreaks(min: number, max: number, count: numb
  * @param count - Number of breaks to produce.
  * @returns The quantile break values.
  */
-declare function createQuantileBreaks(values: number[], count: number): number[];
+export declare function createQuantileBreaks(values: number[], count: number): number[];
 /** The classification schemes the graduated vector renderer offers. */
-type GraduatedClassificationScheme = "equal-interval" | "quantile" | "natural-breaks";
+export type GraduatedClassificationScheme = "equal-interval" | "quantile" | "natural-breaks";
 /**
  * Builds the class *lower bounds* for a graduated vector renderer.
  *
@@ -3109,7 +3334,7 @@ type GraduatedClassificationScheme = "equal-interval" | "quantile" | "natural-br
  * @param scheme - The classification scheme.
  * @returns Up to `count` strictly ascending class lower bounds.
  */
-declare function createGraduatedClassBreaks(values: number[], count: number, scheme: GraduatedClassificationScheme): number[];
+export declare function createGraduatedClassBreaks(values: number[], count: number, scheme: GraduatedClassificationScheme): number[];
 //#endregion
 //#region src/paths.d.ts
 /**
@@ -3119,7 +3344,7 @@ declare function createGraduatedClassBreaks(values: number[], count: number, sch
  * @param path - The path to check.
  * @returns True when the path contains a traversal segment.
  */
-declare function hasPathTraversal(path: string): boolean;
+export declare function hasPathTraversal(path: string): boolean;
 /**
  * Whether a path is an absolute local filesystem path a host could read.
  *
@@ -3137,7 +3362,7 @@ declare function hasPathTraversal(path: string): boolean;
  * @param path - The path to check.
  * @returns True when the path is an absolute POSIX or Windows path.
  */
-declare function isAbsoluteFilesystemPath(path: string): boolean;
+export declare function isAbsoluteFilesystemPath(path: string): boolean;
 //#endregion
 //#region src/routing.d.ts
 /**
@@ -3153,17 +3378,17 @@ declare function isAbsoluteFilesystemPath(path: string): boolean;
  * unit-tested without a browser or network.
  */
 /** Default public Valhalla server (FOSSGIS). CORS-enabled; usage limits apply. */
-declare const DEFAULT_ROUTING_ENDPOINT = "https://valhalla1.openstreetmap.de";
+export declare const DEFAULT_ROUTING_ENDPOINT = "https://valhalla1.openstreetmap.de";
 /** Valhalla costing models exposed in the UI. */
-type RoutingMode = "auto" | "pedestrian" | "bicycle";
+export type RoutingMode = "auto" | "pedestrian" | "bicycle";
 /** Isochrone contour metric: travel time (minutes) or distance (km). */
-type RoutingMetric = "time" | "distance";
-interface RoutingConfig {
+export type RoutingMetric = "time" | "distance";
+export interface RoutingConfig {
   /** Base URL of the Valhalla server (no trailing slash). */
   endpoint: string;
 }
 /** A point with a stable id, used as an isochrone origin or matrix source/target. */
-interface RoutingPoint {
+export interface RoutingPoint {
   id: string | number;
   lon: number;
   lat: number;
@@ -3174,7 +3399,7 @@ interface RoutingPoint {
  *
  * @returns The resolved routing configuration.
  */
-declare function getRoutingConfig(): RoutingConfig;
+export declare function getRoutingConfig(): RoutingConfig;
 /**
  * Parses a comma/space-separated contour string ("5, 10, 15") into a sorted,
  * de-duplicated list of positive numbers.
@@ -3182,8 +3407,8 @@ declare function getRoutingConfig(): RoutingConfig;
  * @param value - The raw contour string.
  * @returns Ascending unique positive contour values.
  */
-declare function parseContours(value: string): number[];
-interface IsochroneRequestBody {
+export declare function parseContours(value: string): number[];
+export interface IsochroneRequestBody {
   locations: {
     lon: number;
     lat: number;
@@ -3203,7 +3428,7 @@ interface IsochroneRequestBody {
  * @param opts - Travel mode, metric, and contour values (minutes for time, km for distance).
  * @returns The request body.
  */
-declare function buildIsochroneRequest(point: [number, number], opts: {
+export declare function buildIsochroneRequest(point: [number, number], opts: {
   mode: RoutingMode;
   metric: RoutingMetric;
   contours: number[];
@@ -3223,12 +3448,12 @@ type IsochroneFeatureProps = {
  * @param ctx - Origin id, travel mode, and metric to tag onto each polygon.
  * @returns The tagged polygon features.
  */
-declare function isochroneResponseToFeatures(response: unknown, ctx: {
+export declare function isochroneResponseToFeatures(response: unknown, ctx: {
   sourceId: string | number;
   mode: RoutingMode;
   metric: RoutingMetric;
 }): Feature<Polygon | MultiPolygon, IsochroneFeatureProps>[];
-interface MatrixRequestBody {
+export interface MatrixRequestBody {
   sources: {
     lon: number;
     lat: number;
@@ -3247,7 +3472,7 @@ interface MatrixRequestBody {
  * @param mode - The travel mode.
  * @returns The request body.
  */
-declare function buildMatrixRequest(origins: RoutingPoint[], targets: RoutingPoint[], mode: RoutingMode): MatrixRequestBody;
+export declare function buildMatrixRequest(origins: RoutingPoint[], targets: RoutingPoint[], mode: RoutingMode): MatrixRequestBody;
 type MatrixFeatureProps = {
   origin_id: string | number;
   dest_id: string | number;
@@ -3266,10 +3491,10 @@ type MatrixFeatureProps = {
  * @param ctx - The travel mode to tag onto each pair.
  * @returns The OD-pair LineString features.
  */
-declare function matrixResponseToFeatures(response: unknown, origins: RoutingPoint[], targets: RoutingPoint[], ctx: {
+export declare function matrixResponseToFeatures(response: unknown, origins: RoutingPoint[], targets: RoutingPoint[], ctx: {
   mode: RoutingMode;
 }): Feature<LineString, MatrixFeatureProps>[];
-interface RouteRequestBody {
+export interface RouteRequestBody {
   locations: {
     lon: number;
     lat: number;
@@ -3288,7 +3513,7 @@ interface RouteRequestBody {
  * @param mode - The travel mode (costing model).
  * @returns The request body.
  */
-declare function buildRouteRequest(points: RoutingPoint[], mode: RoutingMode): RouteRequestBody;
+export declare function buildRouteRequest(points: RoutingPoint[], mode: RoutingMode): RouteRequestBody;
 type RouteFeatureProps = {
   leg_index: number;
   from_id: string | number;
@@ -3307,7 +3532,7 @@ type RouteFeatureProps = {
  * @param ctx - The travel mode to tag onto each leg.
  * @returns One LineString feature per routed leg.
  */
-declare function routeResponseToFeatures(response: unknown, points: RoutingPoint[], ctx: {
+export declare function routeResponseToFeatures(response: unknown, points: RoutingPoint[], ctx: {
   mode: RoutingMode;
 }): Feature<LineString, RouteFeatureProps>[];
 /**
@@ -3327,13 +3552,13 @@ declare function routeResponseToFeatures(response: unknown, points: RoutingPoint
  * @param b - The second value.
  * @returns A negative, zero, or positive number for ascending order.
  */
-declare function compareSequenceValues(a: unknown, b: unknown): number;
+export declare function compareSequenceValues(a: unknown, b: unknown): number;
 /**
  * Error thrown when a Valhalla request returns a non-2xx response. Carries the
  * HTTP status so callers can branch on it (e.g. a 4xx rejection) without
  * pattern-matching the message string.
  */
-declare class RoutingRequestError extends Error {
+export declare class RoutingRequestError extends Error {
   readonly status: number;
   constructor(status: number, statusText: string);
 }
@@ -3345,7 +3570,7 @@ declare class RoutingRequestError extends Error {
  * @param signal - Optional abort signal.
  * @returns The Valhalla GeoJSON response.
  */
-declare function requestIsochrone(endpoint: string, body: IsochroneRequestBody, signal?: AbortSignal): Promise<unknown>;
+export declare function requestIsochrone(endpoint: string, body: IsochroneRequestBody, signal?: AbortSignal): Promise<unknown>;
 /**
  * Requests an OD cost matrix from the Valhalla server.
  *
@@ -3354,7 +3579,7 @@ declare function requestIsochrone(endpoint: string, body: IsochroneRequestBody,
  * @param signal - Optional abort signal.
  * @returns The Valhalla matrix response.
  */
-declare function requestMatrix(endpoint: string, body: MatrixRequestBody, signal?: AbortSignal): Promise<unknown>;
+export declare function requestMatrix(endpoint: string, body: MatrixRequestBody, signal?: AbortSignal): Promise<unknown>;
 /**
  * Requests a route through ordered waypoints from the Valhalla server.
  *
@@ -3363,7 +3588,7 @@ declare function requestMatrix(endpoint: string, body: MatrixRequestBody, signal
  * @param signal - Optional abort signal.
  * @returns The Valhalla `/route` response.
  */
-declare function requestRoute(endpoint: string, body: RouteRequestBody, signal?: AbortSignal): Promise<unknown>;
+export declare function requestRoute(endpoint: string, body: RouteRequestBody, signal?: AbortSignal): Promise<unknown>;
 //#endregion
 //#region src/polyline.d.ts
 /**
@@ -3384,8 +3609,8 @@ declare function requestRoute(endpoint: string, body: RouteRequestBody, signal?:
  * @param str - Input string with potentially escaped backslashes.
  * @returns Cleaned polyline string.
  */
-declare function unescapePolyline(str: string): string;
-interface PolylineDecodeResult {
+export declare function unescapePolyline(str: string): string;
+export interface PolylineDecodeResult {
   coordinates: [number, number][];
   complete: boolean;
 }
@@ -3399,7 +3624,7 @@ interface PolylineDecodeResult {
  * @param unescape - Whether to unescape double-escaped backslashes before decoding (default: false).
  * @returns Object with decoded `coordinates` and `complete` boolean status.
  */
-declare function decodePolylineDetailed(encoded: string, precision?: number, unescape?: boolean): PolylineDecodeResult;
+export declare function decodePolylineDetailed(encoded: string, precision?: number, unescape?: boolean): PolylineDecodeResult;
 /**
  * Decodes an encoded polyline string into an array of `[lon, lat]` coordinates.
  *
@@ -3408,7 +3633,7 @@ declare function decodePolylineDetailed(encoded: string, precision?: number, une
  * @param unescape - Whether to unescape double-escaped backslashes before decoding (default: false).
  * @returns Array of `[lon, lat]` coordinate pairs in GeoJSON order.
  */
-declare function decodePolyline(encoded: string, precision?: number, unescape?: boolean): [number, number][];
+export declare function decodePolyline(encoded: string, precision?: number, unescape?: boolean): [number, number][];
 /**
  * Encodes an array of `[lon, lat]` coordinates into a Google Encoded Polyline string.
  *
@@ -3416,7 +3641,7 @@ declare function decodePolyline(encoded: string, precision?: number, unescape?:
  * @param precision - Number of decimal digits (default: 5).
  * @returns The encoded polyline string.
  */
-declare function encodePolyline(coordinates: [number, number][], precision?: number): string;
+export declare function encodePolyline(coordinates: [number, number][], precision?: number): string;
 /**
  * Decodes an encoded polyline string into a GeoJSON `Feature<LineString>`.
  *
@@ -3425,7 +3650,7 @@ declare function encodePolyline(coordinates: [number, number][], precision?: num
  * @param properties - Optional feature properties.
  * @returns A GeoJSON LineString Feature.
  */
-declare function polylineStrToGeoJSON(encoded: string, precision?: number, properties?: GeoJsonProperties): Feature<LineString>;
+export declare function polylineStrToGeoJSON(encoded: string, precision?: number, properties?: GeoJsonProperties): Feature<LineString>;
 /**
  * Encodes a GeoJSON LineString, MultiLineString, Feature, or FeatureCollection into encoded polyline string(s).
  *
@@ -3433,8 +3658,8 @@ declare function polylineStrToGeoJSON(encoded: string, precision?: number, prope
  * @param precision - Coordinate precision (default: 5).
  * @returns An encoded polyline string for LineString, or an array of strings for MultiLineString / FeatureCollection.
  */
-declare function geoJSONToPolylineStr(geojson: LineString | MultiLineString | Feature<LineString | MultiLineString> | FeatureCollection<LineString | MultiLineString>, precision?: number): string | string[];
-interface PolylineBatchOptions {
+export declare function geoJSONToPolylineStr(geojson: LineString | MultiLineString | Feature<LineString | MultiLineString> | FeatureCollection<LineString | MultiLineString>, precision?: number): string | string[];
+export interface PolylineBatchOptions {
   /** Coordinate precision (default: 5) */
   precision?: number;
   /** Whether to unescape `\\` backslashes (default: true) */
@@ -3453,7 +3678,7 @@ interface PolylineBatchOptions {
  * @param options - Decoding and parsing configuration.
  * @returns A FeatureCollection containing LineString (or MultiLineString) features.
  */
-declare function batchDecodePolylines(input: string, options?: PolylineBatchOptions): FeatureCollection<LineString | MultiLineString>;
+export declare function batchDecodePolylines(input: string, options?: PolylineBatchOptions): FeatureCollection<LineString | MultiLineString>;
 //#endregion
 //#region src/vector-color.d.ts
 /**
@@ -3463,16 +3688,16 @@ declare function batchDecodePolylines(input: string, options?: PolylineBatchOpti
  * stays free of a maplibre-gl dependency; consumers cast to the concrete
  * `PropertyValueSpecification<string>` where the MapLibre types are in scope.
  */
-type VectorColorValue = string | unknown[];
+export type VectorColorValue = string | unknown[];
 /** Whether a color value is a data-driven expression rather than a flat color. */
-declare function isVectorColorExpression(value: VectorColorValue): value is unknown[];
+export declare function isVectorColorExpression(value: VectorColorValue): value is unknown[];
 /**
  * Whether a string is a 6-digit hex color (`#rrggbb`), the form the vector
  * renderer treats as valid. Exported so the symbology exporters can apply the
  * same validity check the live `match`/`case` expressions use rather than
  * re-deriving the regex.
  */
-declare function isHexColor(value: unknown): boolean;
+export declare function isHexColor(value: unknown): boolean;
 declare const SIMPLE_STYLE_NUMBER_KEYS: readonly ["fill-opacity", "stroke-width", "stroke-opacity", "marker-opacity"];
 /**
  * Apply a per-feature transform to a value, descending into the outputs of a
@@ -3483,7 +3708,7 @@ declare const SIMPLE_STYLE_NUMBER_KEYS: readonly ["fill-opacity", "stroke-width"
  * must be pushed inside the step's outputs rather than wrapped around it.
  * Non-step values are transformed directly.
  */
-declare function mapZoomStepOutputs(value: unknown, transform: (output: unknown) => unknown): unknown;
+export declare function mapZoomStepOutputs(value: unknown, transform: (output: unknown) => unknown): unknown;
 /**
  * Resolve a numeric paint value, letting a per-feature simplestyle property
  * override the layer value when {@link LayerStyle.simpleStyleEnabled} is set.
@@ -3502,7 +3727,7 @@ declare function mapZoomStepOutputs(value: unknown, transform: (output: unknown)
  * @param base - The layer-level fallback value.
  * @returns A `to-number` expression, or `base` when disabled.
  */
-declare function simpleStyleNumberValue(style: LayerStyle, property: (typeof SIMPLE_STYLE_NUMBER_KEYS)[number], base: number): number | unknown[];
+export declare function simpleStyleNumberValue(style: LayerStyle, property: (typeof SIMPLE_STYLE_NUMBER_KEYS)[number], base: number): number | unknown[];
 /**
  * Ground resolution (meters per pixel) at MapLibre zoom 0 on the equator, for
  * the Web Mercator projection: earth circumference (2*pi*6378137) over the
@@ -3510,7 +3735,7 @@ declare function simpleStyleNumberValue(style: LayerStyle, property: (typeof SIM
  * the Mapbox-style importer can reverse {@link metersWidthExpression} without a
  * second copy of the magic number.
  */
-declare const MERCATOR_METERS_PER_PIXEL_AT_ZOOM_0: number;
+export declare const MERCATOR_METERS_PER_PIXEL_AT_ZOOM_0: number;
 /**
  * Same ground resolution as {@link MERCATOR_METERS_PER_PIXEL_AT_ZOOM_0} but for
  * the project's active body: its circumference over the 512px zoom-0 world. On
@@ -3520,7 +3745,7 @@ declare const MERCATOR_METERS_PER_PIXEL_AT_ZOOM_0: number;
  * with the same ellipsoid-aware factor the exporter used (keeping the round trip
  * correct on non-Earth projects), rather than the Earth-only constant.
  */
-declare function mercatorMetersPerPixelAtZoom0(): number;
+export declare function mercatorMetersPerPixelAtZoom0(): number;
 /**
  * Build a zoom-driven width expression that keeps a stroke proportional to the
  * map scale, so a width given in ground meters renders thicker when zoomed in
@@ -3539,7 +3764,7 @@ declare function mercatorMetersPerPixelAtZoom0(): number;
  * @param meters - The stroke width in ground meters.
  * @returns A MapLibre `interpolate` expression array.
  */
-declare function metersWidthExpression(meters: number): unknown[];
+export declare function metersWidthExpression(meters: number): unknown[];
 /**
  * Resolve the `line-width` paint value for a layer style, honoring the
  * {@link LayerStyle.strokeWidthUnit}:
@@ -3557,7 +3782,7 @@ declare function metersWidthExpression(meters: number): unknown[];
  * @param style - The layer style.
  * @returns A number (constant pixels) or a MapLibre expression array.
  */
-declare function lineWidthValue(style: LayerStyle): number | unknown[];
+export declare function lineWidthValue(style: LayerStyle): number | unknown[];
 /**
  * Whether a FeatureCollection carries per-feature simplestyle-spec properties
  * worth honoring: at least one feature with a valid hex color in a color key
@@ -3568,7 +3793,7 @@ declare function lineWidthValue(style: LayerStyle): number | unknown[];
  * @param geojson - The collection to inspect (may be undefined).
  * @returns `true` when simplestyle rendering should be enabled for the layer.
  */
-declare function hasSimpleStyleProperties(geojson: {
+export declare function hasSimpleStyleProperties(geojson: {
   features?: {
     properties?: Record<string, unknown> | null;
   }[];
@@ -3578,7 +3803,7 @@ declare function hasSimpleStyleProperties(geojson: {
  * tolerating trailing commas. Returns null when the text is empty or not a
  * JSON array.
  */
-declare function parseJsonExpression(expression: string): unknown[] | null;
+export declare function parseJsonExpression(expression: string): unknown[] | null;
 /**
  * Builds the data-driven color value for a vector layer's current style mode.
  * `single` (or any mode that cannot produce a valid expression) returns the
@@ -3597,7 +3822,7 @@ declare function parseJsonExpression(expression: string): unknown[] | null;
  *   expression fallback.
  * @returns A flat color string or a MapLibre color expression.
  */
-declare function vectorColorExpression(style: LayerStyle, fallbackColor: string): VectorColorValue;
+export declare function vectorColorExpression(style: LayerStyle, fallbackColor: string): VectorColorValue;
 /**
  * A rule-based renderer rule resolved for rendering: the rule tree walked down
  * to a drawable leaf, with the ancestors' filters ANDed in and zoom ranges
@@ -3607,7 +3832,7 @@ declare function vectorColorExpression(style: LayerStyle, fallbackColor: string)
  * emitted. Shared by the paint compilers, the legend, and the symbology
  * exporters so all of them agree on which rules actually draw.
  */
-interface EffectiveVectorRule {
+export interface EffectiveVectorRule {
   id: string;
   /** The leaf rule's label (for the legend / exported rule titles). */
   label: string;
@@ -3635,7 +3860,7 @@ interface EffectiveVectorRule {
  * @param style - The layer style (reads {@link LayerStyle.vectorRules}).
  * @returns The ordered drawable rules and the enabled else rule, if any.
  */
-declare function effectiveVectorRules(style: LayerStyle): {
+export declare function effectiveVectorRules(style: LayerStyle): {
   rules: EffectiveVectorRule[];
   elseRule: VectorRule | null;
 };
@@ -3657,7 +3882,7 @@ declare function effectiveVectorRules(style: LayerStyle): {
  * @param style - The layer style (reads {@link LayerStyle.vectorRules}).
  * @returns The filter to `["all", …]`-combine into each sub-layer, or `null`.
  */
-declare function ruleBasedVisibilityFilter(style: LayerStyle): unknown[] | null;
+export declare function ruleBasedVisibilityFilter(style: LayerStyle): unknown[] | null;
 /**
  * Compiles the `"rule-based"` renderer's ordered rules into a MapLibre `case`
  * color expression: `["case", filter1, color1, filter2, color2, …, elseColor]`.
@@ -3674,27 +3899,40 @@ declare function ruleBasedVisibilityFilter(style: LayerStyle): unknown[] | null;
  * @param fallbackColor - The color used when no else rule defines one.
  * @returns A MapLibre expression, or a flat color when no rule applies.
  */
-declare function ruleBasedColorExpression(style: LayerStyle, fallbackColor: string): VectorColorValue;
+export declare function ruleBasedColorExpression(style: LayerStyle, fallbackColor: string): VectorColorValue;
 /**
  * The stroke/outline color for polygon outlines and circle strokes, honoring
  * per-rule {@link VectorRule.strokeColor} overrides in rule-based mode.
  * Falls back to the flat layer stroke color.
  */
-declare function vectorOutlineColorValue(style: LayerStyle): VectorColorValue;
+export declare function vectorOutlineColorValue(style: LayerStyle): VectorColorValue;
 /**
  * A stroke-width paint value honoring per-rule {@link VectorRule.strokeWidth}
  * overrides in rule-based mode; `fallback` is the layer-level width (a number
  * or an already-built expression such as the meters-based interpolation).
  */
-declare function vectorStrokeWidthValue(style: LayerStyle, fallback: number | unknown[]): number | unknown[];
+export declare function vectorStrokeWidthValue(style: LayerStyle, fallback: number | unknown[]): number | unknown[];
 /**
  * A fill/circle opacity paint value honoring per-rule
  * {@link VectorRule.fillOpacity} overrides in rule-based mode; `fallback` is
  * the layer-level opacity value (number or expression).
  */
-declare function vectorFillOpacityValue(style: LayerStyle, fallback: number | unknown[]): number | unknown[];
+export declare function vectorFillOpacityValue(style: LayerStyle, fallback: number | unknown[]): number | unknown[];
+/**
+ * The color-ramp colors a density heatmap paints with.
+ *
+ * {@link getVectorColorRamp} falls back to the *first* ramp ("viridis") for an
+ * unknown name, which is not the heatmap default ("turbo"). Both the map paint
+ * (`heatmapPaint` in `@geolibre/map`) and the auto-legend gradient resolve the
+ * ramp here so a stale or hand-edited `heatmapColorRamp` cannot make the legend
+ * and the rendered heatmap disagree about which ramp is in use.
+ *
+ * @param style - The layer style.
+ * @returns The ramp's colors, or the default ramp's colors for an unknown name.
+ */
+export declare function heatmapRampColors(style: LayerStyle): readonly string[];
 /** The validated proportional (graduated) size configuration of a layer. */
-interface ProportionalSizeRange {
+export interface ProportionalSizeRange {
   property: string;
   minValue: number;
   maxValue: number;
@@ -3712,7 +3950,7 @@ interface ProportionalSizeRange {
  * @param style - The layer style.
  * @returns The validated range, or `null` when proportional sizing is off.
  */
-declare function proportionalSizeRange(style: LayerStyle): ProportionalSizeRange | null;
+export declare function proportionalSizeRange(style: LayerStyle): ProportionalSizeRange | null;
 /**
  * The proportional `interpolate` expression mapping
  * `proportionalSizeMinValue..proportionalSizeMaxValue` onto
@@ -3722,7 +3960,7 @@ declare function proportionalSizeRange(style: LayerStyle): ProportionalSizeRange
  * @param style - The layer style.
  * @returns The `interpolate` expression, or `null`.
  */
-declare function proportionalRadiusExpression(style: LayerStyle): unknown[] | null;
+export declare function proportionalRadiusExpression(style: LayerStyle): unknown[] | null;
 /**
  * The geometry generator's centroid-size configuration, or `null` when the
  * generated points should all take the flat
@@ -3733,7 +3971,7 @@ declare function proportionalRadiusExpression(style: LayerStyle): unknown[] | nu
  * @param style - The layer style.
  * @returns The validated range, or `null` when field-driven sizing is off.
  */
-declare function generatorSizeRange(style: LayerStyle): ProportionalSizeRange | null;
+export declare function generatorSizeRange(style: LayerStyle): ProportionalSizeRange | null;
 /**
  * Builds the `circle-radius` paint value for the geometry generator's derived
  * centroid points: an `interpolate` over
@@ -3748,7 +3986,7 @@ declare function generatorSizeRange(style: LayerStyle): ProportionalSizeRange |
  * @param style - The layer style.
  * @returns A constant radius (pixels) or a MapLibre `interpolate` expression.
  */
-declare function generatorCircleRadiusValue(style: LayerStyle): number | unknown[];
+export declare function generatorCircleRadiusValue(style: LayerStyle): number | unknown[];
 /**
  * Builds the `circle-radius` paint value, honoring proportional (graduated)
  * symbol sizing. When {@link LayerStyle.proportionalSizeEnabled} is set with a
@@ -3760,9 +3998,9 @@ declare function generatorCircleRadiusValue(style: LayerStyle): number | unknown
  * @param style - The layer style.
  * @returns A constant radius (pixels) or a MapLibre `interpolate` expression.
  */
-declare function circleRadiusValue(style: LayerStyle): number | unknown[];
+export declare function circleRadiusValue(style: LayerStyle): number | unknown[];
 /** Fill color value for a polygon layer (fallback: the layer fill color). */
-declare function vectorFillColorValue(style: LayerStyle): VectorColorValue;
+export declare function vectorFillColorValue(style: LayerStyle): VectorColorValue;
 /**
  * Circle color value for a point layer. Intentionally identical to
  * `vectorFillColorValue`: GeoLibre has no separate point-fill color, so point
@@ -3770,7 +4008,7 @@ declare function vectorFillColorValue(style: LayerStyle): VectorColorValue;
  * package). Kept as its own function so the per-geometry callers read in
  * parallel and a future dedicated circle color stays a one-line change here.
  */
-declare function vectorCircleColorValue(style: LayerStyle): VectorColorValue;
+export declare function vectorCircleColorValue(style: LayerStyle): VectorColorValue;
 /**
  * Line color value for line geometry and polygon outlines (fallback: the
  * layer stroke color). For non-`expression` modes the data-driven color is
@@ -3778,7 +4016,7 @@ declare function vectorCircleColorValue(style: LayerStyle): VectorColorValue;
  * color, matching the polygon-fill-only behavior of categorized/graduated
  * styling.
  */
-declare function vectorLineColorValue(style: LayerStyle): VectorColorValue;
+export declare function vectorLineColorValue(style: LayerStyle): VectorColorValue;
 /**
  * Resolves the 3D-extrusion height for a layer style into a MapLibre value: a
  * plain meters number, or a data-driven expression. In advanced mode a valid
@@ -3791,7 +4029,7 @@ declare function vectorLineColorValue(style: LayerStyle): VectorColorValue;
  * @param style - The layer style.
  * @returns The extrusion height as a number or a MapLibre expression array.
  */
-declare function extrusionHeightValue(style: LayerStyle): number | unknown[];
+export declare function extrusionHeightValue(style: LayerStyle): number | unknown[];
 /**
  * Resolves the 3D-extrusion color for a layer style: a data-driven expression
  * when the layer's symbology mode produces one (categorized/graduated/rule/
@@ -3802,7 +4040,7 @@ declare function extrusionHeightValue(style: LayerStyle): number | unknown[];
  * @param style - The layer style.
  * @returns A flat color string or a MapLibre color expression array.
  */
-declare function extrusionColorValue(style: LayerStyle): VectorColorValue;
+export declare function extrusionColorValue(style: LayerStyle): VectorColorValue;
 //#endregion
 //#region src/expressions.d.ts
 /**
@@ -3815,7 +4053,7 @@ declare function extrusionColorValue(style: LayerStyle): VectorColorValue;
  * later the field calculator and atlas) share one implementation.
  */
 /** One documented function/operator the builder can insert. */
-interface ExpressionFunctionDoc {
+export interface ExpressionFunctionDoc {
   /** The MapLibre operator name, e.g. `get` or `==`. */
   name: string;
   /** The snippet inserted into the expression text (valid JSON). */
@@ -3828,7 +4066,7 @@ interface ExpressionFunctionDoc {
   docKey: string;
 }
 /** A group of related functions shown as one section of the reference tree. */
-interface ExpressionFunctionCategory {
+export interface ExpressionFunctionCategory {
   /** Stable key, also the i18n suffix under `style.expressionBuilder.categories`. */
   key: string;
   functions: ExpressionFunctionDoc[];
@@ -3838,17 +4076,17 @@ interface ExpressionFunctionCategory {
  * standalone-compilable MapLibre expressions (enforced by tests) so inserting
  * one into an empty editor always yields a working starting point.
  */
-declare const EXPRESSION_FUNCTION_CATEGORIES: ExpressionFunctionCategory[];
+export declare const EXPRESSION_FUNCTION_CATEGORIES: ExpressionFunctionCategory[];
 /**
  * Strips commas that directly precede a closing bracket/brace outside of
  * strings, so user-typed expressions with trailing commas still parse.
  * Shared by {@link parseJsonExpression} (vector-color) and the builder.
  */
-declare function removeTrailingJsonCommas(value: string): string;
+export declare function removeTrailingJsonCommas(value: string): string;
 /** Result types the builder can require of a whole expression. */
-type ExpressionExpectedType = "boolean" | "color" | "string" | "number";
+export type ExpressionExpectedType = "boolean" | "color" | "string" | "number";
 /** Options for {@link validateMapExpression}. */
-interface ValidateMapExpressionOptions {
+export interface ValidateMapExpressionOptions {
   /**
    * Variables substituted before compiling, so a numeric `@token` used in a
    * numeric slot type-checks against its value instead of the raw string.
@@ -3862,7 +4100,7 @@ interface ValidateMapExpressionOptions {
   expectedType?: ExpressionExpectedType;
 }
 /** Outcome of validating an expression source string. */
-interface ExpressionValidation {
+export interface ExpressionValidation {
   ok: boolean;
   /**
    * Failure class, for callers that want to localize the shape errors:
@@ -3885,9 +4123,9 @@ interface ExpressionValidation {
  * returned `parsed` array is the raw, unsubstituted parse. An empty/blank
  * source is valid (surfaces treat it as "no expression").
  */
-declare function validateMapExpression(source: string, options?: ValidateMapExpressionOptions): ExpressionValidation;
+export declare function validateMapExpression(source: string, options?: ValidateMapExpressionOptions): ExpressionValidation;
 /** A named `@` variable with its current value. */
-interface ExpressionVariable {
+export interface ExpressionVariable {
   /** Token including the `@` prefix, e.g. `@project_name`. */
   token: string;
   value: string | number | boolean;
@@ -3898,9 +4136,9 @@ interface ExpressionVariable {
  * Unknown `@` strings are left untouched so field values that happen to start
  * with `@` never get mangled.
  */
-declare function substituteExpressionVariables(node: unknown, variables: ExpressionVariable[]): unknown;
+export declare function substituteExpressionVariables(node: unknown, variables: ExpressionVariable[]): unknown;
 /** Result of a live preview evaluation. */
-interface ExpressionPreview {
+export interface ExpressionPreview {
   kind: "empty" | "error" | "value";
   /** Problems when `kind` is "error" (parse or runtime). */
   errors?: string[];
@@ -3908,7 +4146,7 @@ interface ExpressionPreview {
   value?: unknown;
 }
 /** Options for {@link evaluateMapExpression}. */
-interface EvaluateMapExpressionOptions {
+export interface EvaluateMapExpressionOptions {
   /** The sample feature the expression is evaluated against. */
   feature?: Feature | null;
   /** Map zoom used for `["zoom"]`; defaults to 0. */
@@ -3925,7 +4163,7 @@ interface EvaluateMapExpressionOptions {
  * Runtime failures (e.g. `to-color` on garbage) come back as errors instead
  * of throwing.
  */
-declare function evaluateMapExpression(source: string, options?: EvaluateMapExpressionOptions): ExpressionPreview;
+export declare function evaluateMapExpression(source: string, options?: EvaluateMapExpressionOptions): ExpressionPreview;
 /**
  * A compiled per-feature evaluator: the expression is parsed and compiled
  * once, then `evaluate` runs it against each feature. `evaluate` is absent
@@ -3933,11 +4171,16 @@ declare function evaluateMapExpression(source: string, options?: EvaluateMapExpr
  * failures (same rationale as {@link evaluateMapExpression}: throwing keeps
  * errors out of console.warn) so callers decide per-feature error handling.
  */
-interface CompiledFeatureExpression {
+export interface CompiledFeatureExpression {
   ok: boolean;
   /** Parse/compile problems when `ok` is false. */
   errors: string[];
-  evaluate?: (feature: Feature) => unknown;
+  /**
+   * Runs the expression against one feature. `zoom` overrides the zoom the
+   * expression was compiled with, for callers that re-evaluate a
+   * zoom-dependent expression as the camera moves.
+   */
+  evaluate?: (feature: Feature, zoom?: number) => unknown;
 }
 /**
  * Compiles an expression source once for bulk per-feature evaluation (virtual
@@ -3946,13 +4189,13 @@ interface CompiledFeatureExpression {
  * feature. An empty source is reported as a failure with no errors — there is
  * nothing to evaluate.
  */
-declare function compileFeatureExpression(source: string, options?: {
+export declare function compileFeatureExpression(source: string, options?: {
   zoom?: number;
   variables?: ExpressionVariable[];
   expectedType?: ExpressionExpectedType;
 }): CompiledFeatureExpression;
 /** Result of matching a feature array against a boolean expression. */
-interface FeatureExpressionMatches {
+export interface FeatureExpressionMatches {
   /** False when the expression failed to parse or compile. */
   ok: boolean;
   /** Parse/compile problems when `ok` is false. */
@@ -3974,7 +4217,7 @@ interface FeatureExpressionMatches {
  * layers. An empty source is reported as `ok: false` with no errors — there
  * is nothing to select by.
  */
-declare function matchFeaturesByExpression(features: readonly Feature[], source: string, options?: {
+export declare function matchFeaturesByExpression(features: readonly Feature[], source: string, options?: {
   zoom?: number;
   variables?: ExpressionVariable[];
 }): FeatureExpressionMatches;
@@ -3986,7 +4229,7 @@ declare function matchFeaturesByExpression(features: readonly Feature[], source:
  * attribute data that happens to carry numeric r/g/b/a fields (e.g. via
  * `["properties"]`) is never misclassified as a color.
  */
-declare function isStyleSpecColor(value: unknown): value is {
+export declare function isStyleSpecColor(value: unknown): value is {
   r: number;
   g: number;
   b: number;
@@ -3997,18 +4240,109 @@ declare function isStyleSpecColor(value: unknown): value is {
  * instances become rgba() strings, plain values render as JSON, and
  * `null`/`undefined` render as "null".
  */
-declare function formatExpressionPreviewValue(value: unknown): string;
+export declare function formatExpressionPreviewValue(value: unknown): string;
 /** Attribute field types the builder badges fields with. */
-type ExpressionFieldType = "string" | "number" | "boolean" | "mixed" | "unknown";
+export type ExpressionFieldType = "string" | "number" | "boolean" | "mixed" | "unknown";
 /**
  * Infers a display type for each named field by scanning feature properties:
  * a single consistent primitive type wins, disagreements become "mixed", and
  * fields with no non-null values are "unknown".
  */
-declare function inferFieldTypes(features: ReadonlyArray<{
+export declare function inferFieldTypes(features: ReadonlyArray<{
   properties?: Record<string, unknown> | null;
 }>, names: string[]): Record<string, ExpressionFieldType>;
 //#endregion
+//#region src/document-locale.d.ts
+/**
+ * The document language, so formatted numbers and dates follow the UI locale.
+ *
+ * Shared by the Identify popup's value formatting and by label number
+ * formatting, which both fall back to it when the author has not pinned an
+ * explicit locale. Returns `undefined` outside a browser (tests, the headless
+ * project authoring paths), which leaves `Intl` on its own default.
+ */
+export declare function documentLocale(): string | undefined;
+//#endregion
+//#region src/label-number-format.d.ts
+/**
+ * Locale-aware number formatting for map labels (issue #2336).
+ *
+ * A numeric attribute rendered straight into a label reads as `1234567.5`,
+ * which is hard to compare at a glance. QGIS solves this with
+ * `format_number(field, places, language)`; the equivalent here is three
+ * {@link LabelStyle} fields — {@link LabelStyle.numberFormatEnabled},
+ * {@link LabelStyle.numberDecimals} and {@link LabelStyle.numberLocale} —
+ * whose effect this module renders two ways:
+ *
+ * - {@link labelFieldTextField} builds the MapLibre `text-field` expression the
+ *   2D map and the Mapbox/MapLibre style export both use, so the map and the
+ *   exported style agree.
+ * - {@link formatLabelNumber} does the same in JavaScript for the paths that
+ *   resolve label text themselves: the Cesium globe and the duplicate-label
+ *   collapsing modes.
+ *
+ * Formatting applies to {@link LabelStyle.field} only. A label
+ * {@link LabelStyle.expression} formats its own output (with `number-format`,
+ * offered in the Expression Builder), so wrapping it here would fight the
+ * author.
+ */
+/**
+ * Locales offered for {@link LabelStyle.numberLocale}, alongside the default
+ * empty value that follows the app's own language.
+ *
+ * Deliberately short, and every entry groups with a character the map's glyph
+ * stack can draw: ASCII `,`/`.` or U+00A0. Locales whose CLDR grouping uses
+ * the narrow no-break space U+202F (`fr-FR`) or non-Latin digits (`ar-EG`)
+ * are left out because a missing glyph renders as a blank box on the map
+ * rather than as a separator. An author who needs one of those can still
+ * write `["number-format", …]` in the label expression.
+ */
+export declare const LABEL_NUMBER_LOCALES: readonly ["en-US", "de-DE", "ru-RU", "hi-IN"];
+/** Sample value used to preview a locale's separators in the Style panel. */
+export declare const LABEL_NUMBER_SAMPLE = 1234567.5;
+/** Clamp a decimal-places setting to the range the UI and `Intl` both accept. */
+export declare function clampLabelDecimals(decimals: number): number;
+/**
+ * The first locale tag that both `Intl` accepts and the map can draw, or
+ * `undefined` to leave `Intl` and MapLibre on the runtime default.
+ *
+ * Every path resolves its locale through here -- the JavaScript formatter, the
+ * MapLibre expression, and the dedup cache key -- so all three agree on which
+ * locale is actually in effect.
+ */
+export declare function resolveLabelNumberLocale(...tags: (string | undefined)[]): string | undefined;
+/**
+ * Format one label value as a number, or `null` when the setting is off or the
+ * value is not a finite number (a text attribute keeps its own rendering).
+ *
+ * @param value - The raw attribute value.
+ * @param labels - The layer's label configuration.
+ * @param fallbackLocale - Locale used when {@link LabelStyle.numberLocale} is
+ *   empty; the caller passes the app's language. Omitted means the runtime
+ *   default, matching how popups format their numbers.
+ */
+export declare function formatLabelNumber(value: unknown, labels: Pick<LabelStyle, "numberFormatEnabled" | "numberDecimals" | "numberLocale">, fallbackLocale?: string): string | null;
+/**
+ * The MapLibre expression that renders {@link LabelStyle.field} as text, with
+ * number formatting applied when it is on. Returns `""` when no field is set,
+ * which callers treat as "no label text".
+ *
+ * Number formatting is guarded by a `typeof` test rather than applied blindly
+ * so a mixed or text column still labels normally; only real numbers take the
+ * `number-format` branch.
+ */
+export declare function labelFieldTextField(labels: Pick<LabelStyle, "field" | "numberFormatEnabled" | "numberDecimals" | "numberLocale">, fallbackLocale?: string): unknown[] | "";
+/**
+ * Render {@link LABEL_NUMBER_SAMPLE} the way a locale/decimals pair would, so
+ * the Style panel can name each choice by the separators it actually produces
+ * ("1,234,567.50") instead of by an opaque language tag.
+ *
+ * A tag `Intl` rejects (or one the map cannot draw) falls back to the runtime
+ * locale's formatting rather than to an unformatted number, matching what
+ * {@link formatLabelNumber} and the emitted expression do with the same tag.
+ */
+export declare function formatLabelNumberSample(locale: string, decimals: number): string;
+//#endregion
 //#region src/external-native-paint.d.ts
 /**
  * Paint ownership for plugin-registered native layers.
@@ -4032,7 +4366,7 @@ declare function inferFieldTypes(features: ReadonlyArray<{
  * instead, keyed by layer id, and the layer record only carries the
  * serializable `paintMode` flag.
  */
-interface ExternalNativePaintBridge {
+export interface ExternalNativePaintBridge {
   /**
    * Apply an opacity in [0, 1] to the plugin's layer (e.g.
    * `zarrLayer.setOpacity(value)`). When supplied, GeoLibre keeps its Opacity
@@ -4047,7 +4381,7 @@ interface ExternalNativePaintBridge {
   setVisibility?: (visible: boolean) => void;
 }
 /** Serializable paint-ownership marker stored in `GeoLibreLayer.metadata`. */
-type ExternalNativePaintMode = "geolibre" | "plugin";
+export type ExternalNativePaintMode = "geolibre" | "plugin";
 /**
  * Whether a layer is drawn by a **custom render layer** its control created — a
  * deck.gl overlay, 3D Tiles, or Add Vector Layer's own MapLibre layers — rather
@@ -4066,33 +4400,33 @@ type ExternalNativePaintMode = "geolibre" | "plugin";
  * @param layer - A store layer (metadata only).
  * @returns True when only the owning control can create the layer's map output.
  */
-declare function controlRendersLayer(layer: {
+export declare function controlRendersLayer(layer: {
   metadata: Record<string, unknown>;
 }): boolean;
 /**
  * True when the plugin that registered this layer paints it itself, so GeoLibre
  * must not offer (or apply) MapLibre paint properties for it.
  */
-declare function pluginOwnsPaint(layer: {
+export declare function pluginOwnsPaint(layer: {
   metadata: Record<string, unknown>;
 }): boolean;
 /** Register (or replace) the paint bridge a plugin supplied for a layer. */
-declare function setExternalNativePaintBridge(layerId: string, bridge: ExternalNativePaintBridge | undefined): void;
+export declare function setExternalNativePaintBridge(layerId: string, bridge: ExternalNativePaintBridge | undefined): void;
 /** Drop a layer's paint bridge (on unregister, or when the layer is removed). */
-declare function clearExternalNativePaintBridge(layerId: string): void;
+export declare function clearExternalNativePaintBridge(layerId: string): void;
 /** The paint bridge for a layer, if its plugin supplied one. */
-declare function getExternalNativePaintBridge(layerId: string): ExternalNativePaintBridge | undefined;
+export declare function getExternalNativePaintBridge(layerId: string): ExternalNativePaintBridge | undefined;
 /**
  * True when a plugin-painted layer bridged `setOpacity`, so an Opacity slider
  * would actually reach the renderer. It says nothing about GeoLibre-painted
  * layers, which have no bridge: the Style and Layers panels combine it with
  * `!pluginOwnsPaint(layer)` to decide whether to show the slider at all.
  */
-declare function supportsBridgedOpacity(layerId: string): boolean;
+export declare function supportsBridgedOpacity(layerId: string): boolean;
 //#endregion
 //#region src/attribute-form.d.ts
 /** Options threaded to expression evaluation (constraints, visibility). */
-interface AttributeFormEvalOptions {
+export interface AttributeFormEvalOptions {
   /** Map zoom for `["zoom"]` in expressions; defaults to 0. */
   zoom?: number;
   /**
@@ -4104,7 +4438,7 @@ interface AttributeFormEvalOptions {
   feature?: Feature;
 }
 /** Why a field's value was rejected; codes map to localized messages. */
-interface AttributeFormFieldError {
+export interface AttributeFormFieldError {
   code: "required" | "number" | "range" | "valueMap" | "constraint";
   /**
    * For `constraint`: the author's `constraintDescription`, or the
@@ -4116,37 +4450,37 @@ interface AttributeFormFieldError {
   max?: number;
 }
 /** Outcome of validating a whole properties record against a form config. */
-interface AttributeFormValidation {
+export interface AttributeFormValidation {
   ok: boolean;
   /** Field name → error for every failing, visible, configured field. */
   errors: Record<string, AttributeFormFieldError>;
 }
 /** Look up the configuration for a field, if any. */
-declare function getAttributeFormField(form: AttributeFormConfig | undefined, field: string): AttributeFormFieldConfig | undefined;
+export declare function getAttributeFormField(form: AttributeFormConfig | undefined, field: string): AttributeFormFieldConfig | undefined;
 /** The label attribute forms should show for a configured field. */
-declare function attributeFormFieldLabel(config: AttributeFormFieldConfig): string;
+export declare function attributeFormFieldLabel(config: AttributeFormFieldConfig): string;
 /**
  * Parse the designer's value-map text — one entry per line, `value=label` or
  * just `value` — into entries. Blank lines and duplicate values are dropped.
  */
-declare function parseValueMapText(text: string): AttributeFormValueMapEntry[];
+export declare function parseValueMapText(text: string): AttributeFormValueMapEntry[];
 /** Serialize value-map entries back into the designer's editable text form. */
-declare function valueMapToText(entries: readonly AttributeFormValueMapEntry[] | undefined): string;
+export declare function valueMapToText(entries: readonly AttributeFormValueMapEntry[] | undefined): string;
 /** Display label for a stored value under a value-map widget. */
-declare function valueMapLabelFor(config: AttributeFormFieldConfig, value: unknown): string;
+export declare function valueMapLabelFor(config: AttributeFormFieldConfig, value: unknown): string;
 /**
  * Coerce a raw form string into the typed value the widget stores on the
  * feature. An empty/blank string means "no value" (`null`). A `number`/`range`
  * string that does not parse is returned verbatim so validation can flag it
  * instead of silently dropping the input.
  */
-declare function coerceAttributeFormValue(config: AttributeFormFieldConfig, raw: string): unknown;
+export declare function coerceAttributeFormValue(config: AttributeFormFieldConfig, raw: string): unknown;
 /**
  * Whether a configured field is currently shown, given the form's candidate
  * properties. An empty, invalid, or erroring visibility expression fails open
  * (visible) so a typo cannot hide data entry.
  */
-declare function isAttributeFormFieldVisible(config: AttributeFormFieldConfig, properties: Record<string, unknown>, options?: AttributeFormEvalOptions): boolean;
+export declare function isAttributeFormFieldVisible(config: AttributeFormFieldConfig, properties: Record<string, unknown>, options?: AttributeFormEvalOptions): boolean;
 /**
  * Validate one configured field against the candidate properties record (the
  * field's own candidate value lives at `properties[config.field]`). Returns
@@ -4154,17 +4488,17 @@ declare function isAttributeFormFieldVisible(config: AttributeFormFieldConfig, p
  * numeric bounds, value-map membership, then the constraint expression — the
  * constraint sees the whole record, so cross-field rules work.
  */
-declare function validateAttributeFormField(config: AttributeFormFieldConfig, properties: Record<string, unknown>, options?: AttributeFormEvalOptions): AttributeFormFieldError | null;
+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.
  */
-declare function validateAttributeFormValues(form: AttributeFormConfig | undefined, properties: Record<string, unknown>, options?: AttributeFormEvalOptions): AttributeFormValidation;
+export declare function validateAttributeFormValues(form: AttributeFormConfig | undefined, properties: Record<string, unknown>, options?: AttributeFormEvalOptions): AttributeFormValidation;
 //#endregion
 //#region src/popup.d.ts
 /** One resolved popup row, ready for the renderer. */
-interface PopupRow {
+export interface PopupRow {
   /** Feature property key. */
   field: string;
   /** Label to print in the key column. */
@@ -4179,25 +4513,25 @@ interface PopupRow {
   linkLabel?: string;
 }
 /** Whether the Identify popup should open for a layer. Default: yes. */
-declare function isPopupClickEnabled(popup: LayerPopupConfig | undefined): boolean;
+export declare function isPopupClickEnabled(popup: LayerPopupConfig | undefined): boolean;
 /** Whether a hover tooltip should follow the pointer. Default: no. */
-declare function isPopupHoverEnabled(popup: LayerPopupConfig | undefined): boolean;
+export declare function isPopupHoverEnabled(popup: LayerPopupConfig | undefined): boolean;
 /** The label a popup shows for a configured field. */
-declare function popupFieldLabel(config: PopupFieldConfig): string;
+export declare function popupFieldLabel(config: PopupFieldConfig): string;
 /**
  * Property keys that never belong in a popup: GeoLibre's own internal columns
  * and the full-resolution companion of a photo thumbnail (an internal twin of
  * a value already shown, and often multiple megabytes of data URL).
  */
-declare function isInternalPopupField(key: string): boolean;
+export declare function isInternalPopupField(key: string): boolean;
 /**
  * The property keys a popup may show, before any popup config narrows them:
  * the feature's own keys minus the internal ones and anything the author
  * marked `"hidden"` or `"excluded"`.
  */
-declare function visiblePopupFields(properties: Record<string, unknown>, fieldVisibility?: Record<string, FieldVisibility>): string[];
+export declare function visiblePopupFields(properties: Record<string, unknown>, fieldVisibility?: Record<string, FieldVisibility>): string[];
 /** Options for {@link formatPopupValue} and {@link resolvePopupRows}. */
-interface PopupFormatOptions {
+export interface PopupFormatOptions {
   /**
    * BCP 47 tag for number/date formatting. Omitted means the runtime default,
    * which is what the browser uses for every other locale-aware rendering.
@@ -4205,14 +4539,14 @@ interface PopupFormatOptions {
   locale?: string;
 }
 /** Stringify a value the way the untyped popup always has. */
-declare function stringifyPopupValue(value: unknown): string;
+export declare function stringifyPopupValue(value: unknown): string;
 /**
  * Render one value as text under a field's kind and format. `"auto"` and
  * `"image"` values are returned verbatim (the renderer draws them itself);
  * every other kind is stringified, formatted, then wrapped in the configured
  * prefix/suffix.
  */
-declare function formatPopupValue(value: unknown, config?: Pick<PopupFieldConfig, "kind" | "format">, options?: PopupFormatOptions): string;
+export declare function formatPopupValue(value: unknown, config?: Pick<PopupFieldConfig, "kind" | "format">, options?: PopupFormatOptions): string;
 /**
  * The properties a popup may read, with the author's hidden and excluded
  * fields and GeoLibre's internal columns removed.
@@ -4223,9 +4557,9 @@ declare function formatPopupValue(value: unknown, config?: Pick<PopupFieldConfig
  * this module already honors `fieldVisibility` field by field; an expression
  * has no field list to filter, so the filtering has to happen to its input.
  */
-declare function visiblePopupProperties(properties: Record<string, unknown>, fieldVisibility?: Record<string, FieldVisibility>): Record<string, unknown>;
+export declare function visiblePopupProperties(properties: Record<string, unknown>, fieldVisibility?: Record<string, FieldVisibility>): Record<string, unknown>;
 /** Options for {@link resolvePopupRows}. */
-interface ResolvePopupRowsOptions extends PopupFormatOptions {
+export interface ResolvePopupRowsOptions extends PopupFormatOptions {
   popup?: LayerPopupConfig;
   fieldVisibility?: Record<string, FieldVisibility>;
   /** Resolve the hover subset (fields flagged `hover`) instead of the full list. */
@@ -4247,9 +4581,9 @@ interface ResolvePopupRowsOptions extends PopupFormatOptions {
  * without choosing a field gets no tip rather than the whole table following
  * the pointer.
  */
-declare function resolvePopupRows(properties: Record<string, unknown>, options?: ResolvePopupRowsOptions): PopupRow[];
+export declare function resolvePopupRows(properties: Record<string, unknown>, options?: ResolvePopupRowsOptions): PopupRow[];
 /** Options for {@link resolvePopupTitle} and {@link resolvePopupBody}. */
-interface PopupExpressionOptions {
+export interface PopupExpressionOptions {
   /**
    * The author's field visibility, so an expression cannot read a hidden or
    * excluded column. Omitting it means nothing is hidden.
@@ -4266,7 +4600,7 @@ interface PopupExpressionOptions {
  * compile or evaluate, and a title field that is empty or hidden, both fall
  * back to the layer name rather than leaving the popup headless.
  */
-declare function resolvePopupTitle(layerName: string, properties: Record<string, unknown>, popup: LayerPopupConfig | undefined, options?: PopupExpressionOptions): string;
+export declare function resolvePopupTitle(layerName: string, properties: Record<string, unknown>, popup: LayerPopupConfig | undefined, options?: PopupExpressionOptions): string;
 /**
  * The title the author's own configuration produced, or `null` when there is
  * none — no title field or expression, or one that evaluated to nothing, or a
@@ -4279,23 +4613,23 @@ declare function resolvePopupTitle(layerName: string, properties: Record<string,
  * resolved text happens to equal the layer name. A city layer named "Olympia"
  * whose feature is also called "Olympia" is a real title, not a fallback.
  */
-declare function resolveConfiguredPopupTitle(properties: Record<string, unknown>, popup: LayerPopupConfig | undefined, options?: PopupExpressionOptions): string | null;
+export declare function resolveConfiguredPopupTitle(properties: Record<string, unknown>, popup: LayerPopupConfig | undefined, options?: PopupExpressionOptions): string | null;
 /**
  * The popup body text when the author supplied a body expression, or `null`
  * when there is none (or it failed) and the field rows should render instead.
  */
-declare function resolvePopupBody(properties: Record<string, unknown>, popup: LayerPopupConfig | undefined, options?: PopupExpressionOptions): string | null;
+export declare function resolvePopupBody(properties: Record<string, unknown>, popup: LayerPopupConfig | undefined, options?: PopupExpressionOptions): string | null;
 /**
  * Whether a value should render as an inline image thumbnail under `"auto"`.
  * Kept here so the renderer and the designer's preview agree on what counts.
  */
-declare function isInlineImageValue(value: unknown): value is string;
+export declare function isInlineImageValue(value: unknown): value is string;
 /**
  * Whether a URL is safe to put in a popup `href`/`src`. Only http(s) and
  * inline raster data URLs: a `javascript:` or `data:text/html` value coming
  * from an untrusted GeoJSON must never become a live link.
  */
-declare function isSafePopupUrl(value: unknown, allowDataImage?: boolean): value is string;
+export declare function isSafePopupUrl(value: unknown, allowDataImage?: boolean): value is string;
 //#endregion
 //#region src/joins.d.ts
 /**
@@ -4305,15 +4639,15 @@ declare function isSafePopupUrl(value: unknown, allowDataImage?: boolean): value
  * join while a zero-padded code like `"01001"` only matches another `"01001"`.
  * Kept in sync with the Processing attribute join's `attributeJoinKey`.
  */
-declare function layerJoinKey(value: unknown): string | null;
+export declare function layerJoinKey(value: unknown): string | null;
 /**
  * Remove every column previously added by `joins` (per their `addedFields`
  * bookkeeping) from a copy of `features`, restoring the pre-join properties.
  * Features without any tracked column are returned unchanged (same reference).
  */
-declare function stripJoinFields(features: Feature[], joins: LayerJoin[] | undefined): Feature[];
+export declare function stripJoinFields(features: Feature[], joins: LayerJoin[] | undefined): Feature[];
 /** Result of {@link applyLayerJoins}: joined features plus refreshed join records. */
-interface ApplyLayerJoinsResult {
+export interface ApplyLayerJoinsResult {
   features: Feature[];
   /** Input joins with `addedFields` and `stats` recomputed for this run. */
   joins: LayerJoin[];
@@ -4336,7 +4670,7 @@ interface ApplyLayerJoinsResult {
  *   feature collection, or `undefined` when the layer is gone (or is the
  *   target itself; self-joins are refused by the caller).
  */
-declare function applyLayerJoins(features: Feature[], joins: LayerJoin[] | undefined, resolveSource: (joinLayerId: string) => FeatureCollection | undefined): ApplyLayerJoinsResult;
+export declare function applyLayerJoins(features: Feature[], joins: LayerJoin[] | undefined, resolveSource: (joinLayerId: string) => FeatureCollection | undefined): ApplyLayerJoinsResult;
 /**
  * Strip-and-reapply this layer's derived columns — persistent joins, then
  * virtual fields (so an expression can read joined columns) — resolving join
@@ -4346,7 +4680,7 @@ declare function applyLayerJoins(features: Feature[], joins: LayerJoin[] | undef
  * existing definitions against current data. Layers without a feature
  * collection are returned unchanged.
  */
-declare function applyJoinsToLayer(layer: GeoLibreLayer, allLayers: GeoLibreLayer[], nextJoins?: LayerJoin[], nextVirtualFields?: LayerVirtualField[]): GeoLibreLayer;
+export declare function applyJoinsToLayer(layer: GeoLibreLayer, allLayers: GeoLibreLayer[], nextJoins?: LayerJoin[], nextVirtualFields?: LayerVirtualField[]): GeoLibreLayer;
 /**
  * Ids of every layer whose data (directly or transitively) feeds `layerId`'s
  * joins, following `joinLayerId` edges through each source's own joins.
@@ -4356,7 +4690,7 @@ declare function applyJoinsToLayer(layer: GeoLibreLayer, allLayers: GeoLibreLaye
  * authored (the refresh cascade still breaks them defensively for hand-edited
  * projects).
  */
-declare function collectTransitiveJoinSourceIds(layers: GeoLibreLayer[], layerId: string): Set<string>;
+export declare function collectTransitiveJoinSourceIds(layers: GeoLibreLayer[], layerId: string): Set<string>;
 /**
  * Refresh every layer whose joins (directly or transitively) consume the
  * layer identified by `seedId`, after that layer's data changed — or after it
@@ -4365,7 +4699,7 @@ declare function collectTransitiveJoinSourceIds(layers: GeoLibreLayer[], layerId
  * layer joining two other affected layers sees both of them fresh regardless
  * of their positions in the layer panel. The seed itself is not touched.
  */
-declare function cascadeLayerJoinRefresh(layers: GeoLibreLayer[], seedId: string): GeoLibreLayer[];
+export declare function cascadeLayerJoinRefresh(layers: GeoLibreLayer[], seedId: string): GeoLibreLayer[];
 /**
  * Re-resolve every layer's persistent joins against the freshly loaded layer
  * set (project open). Layers re-derive in topological order of their join
@@ -4376,7 +4710,7 @@ declare function cascadeLayerJoinRefresh(layers: GeoLibreLayer[], seedId: string
  * too (their expressions run against the freshly loaded features). Layer sets
  * without joins or virtual fields pass through by reference.
  */
-declare function reapplyLayerJoins(layers: GeoLibreLayer[]): GeoLibreLayer[];
+export declare function reapplyLayerJoins(layers: GeoLibreLayer[]): GeoLibreLayer[];
 //#endregion
 //#region src/virtual-fields.d.ts
 /**
@@ -4420,9 +4754,9 @@ declare function reapplyLayerJoins(layers: GeoLibreLayer[]): GeoLibreLayer[];
  * Features without any tracked column are returned unchanged (same
  * reference).
  */
-declare function stripVirtualFieldColumns(features: Feature[], fields: LayerVirtualField[] | undefined): Feature[];
+export declare function stripVirtualFieldColumns(features: Feature[], fields: LayerVirtualField[] | undefined): Feature[];
 /** Result of {@link applyLayerVirtualFields}: features plus refreshed bookkeeping. */
-interface ApplyVirtualFieldsResult {
+export interface ApplyVirtualFieldsResult {
   features: Feature[];
   /** Input fields with `addedField`/`error`/`errorCount` recomputed for this run. */
   fields: LayerVirtualField[];
@@ -4438,7 +4772,7 @@ interface ApplyVirtualFieldsResult {
  * the column. Fields evaluate sequentially, so a later field's expression
  * can `["get", ...]` an earlier field's column.
  */
-declare function applyLayerVirtualFields(features: Feature[], fields: LayerVirtualField[] | undefined): ApplyVirtualFieldsResult;
+export declare function applyLayerVirtualFields(features: Feature[], fields: LayerVirtualField[] | undefined): ApplyVirtualFieldsResult;
 //#endregion
 //#region src/quick-filters.d.ts
 /**
@@ -4449,7 +4783,7 @@ declare function applyLayerVirtualFields(features: Feature[], fields: LayerVirtu
  * @param filter - The persisted control state.
  * @returns A MapLibre filter expression, or `null`.
  */
-declare function compileQuickFilter(filter: LayerQuickFilter): unknown[] | null;
+export declare function compileQuickFilter(filter: LayerQuickFilter): unknown[] | null;
 /**
  * Compile a layer's quick filters into a single MapLibre filter expression.
  * Multiple controls narrow the data together (`["all", …]`), matching how a
@@ -4459,7 +4793,7 @@ declare function compileQuickFilter(filter: LayerQuickFilter): unknown[] | null;
  * @param filters - The layer's persisted quick filters.
  * @returns A MapLibre filter expression, or `null`.
  */
-declare function compileQuickFilters(filters: readonly LayerQuickFilter[] | undefined): unknown[] | null;
+export declare function compileQuickFilters(filters: readonly LayerQuickFilter[] | undefined): unknown[] | null;
 /**
  * The quick filters that actually constrain the layer right now. Drives the
  * "filtered" badge on the layer row and its count, so an active filter is
@@ -4468,14 +4802,14 @@ declare function compileQuickFilters(filters: readonly LayerQuickFilter[] | unde
  * @param layer - The layer to inspect.
  * @returns The constraining filters, in their configured order.
  */
-declare function activeQuickFilters(layer: GeoLibreLayer): LayerQuickFilter[];
+export declare function activeQuickFilters(layer: GeoLibreLayer): LayerQuickFilter[];
 /**
  * Whether the layer is currently narrowed by at least one quick filter.
  *
  * @param layer - The layer to inspect.
  * @returns `true` when a quick filter constrains the rendered features.
  */
-declare function hasActiveQuickFilter(layer: GeoLibreLayer): boolean;
+export declare function hasActiveQuickFilter(layer: GeoLibreLayer): boolean;
 /**
  * Clear every chosen value while keeping the controls themselves, so "Clear
  * filters" is one action that leaves the layer's configured controls in place
@@ -4484,7 +4818,36 @@ declare function hasActiveQuickFilter(layer: GeoLibreLayer): boolean;
  * @param filters - The layer's persisted quick filters.
  * @returns The same controls with their selections emptied.
  */
-declare function clearQuickFilterValues(filters: readonly LayerQuickFilter[] | undefined): LayerQuickFilter[];
+export declare function clearQuickFilterValues(filters: readonly LayerQuickFilter[] | undefined): LayerQuickFilter[];
+//#endregion
+//#region src/layer-filters.d.ts
+/** The layer fields needed to inspect project-authored feature filters. */
+type LayerFilterSource = Pick<GeoLibreLayer, "filterExpression" | "quickFilters">;
+/**
+ * Return a layer's persisted expression filter when it has a usable array
+ * shape, otherwise return null.
+ *
+ * @param layer - The layer whose expression filter should be read.
+ * @returns The active expression filter, or null when none is configured.
+ */
+export declare function activeLayerFilterExpression(layer: LayerFilterSource): unknown[] | null;
+/**
+ * Compile all project-authored filters for a layer into one MapLibre boolean
+ * expression. An explicit expression and Quick Filter controls narrow the
+ * layer together.
+ *
+ * @param layer - The layer whose authored filters should be composed.
+ * @returns A MapLibre filter expression, or null when no authored filter is active.
+ */
+export declare function compileLayerFilters(layer: LayerFilterSource): unknown[] | null;
+/**
+ * Whether a project-authored expression or Quick Filter currently narrows a
+ * layer. This drives the filtered indicator and clear action in the layer UI.
+ *
+ * @param layer - The layer to inspect.
+ * @returns True when at least one persisted filter is active.
+ */
+export declare function hasActiveLayerFilter(layer: LayerFilterSource): boolean;
 //#endregion
 //#region src/capabilities.d.ts
 /**
@@ -4496,37 +4859,37 @@ declare function clearQuickFilterValues(filters: readonly LayerQuickFilter[] | u
  *   false for derived queries (DuckDB/SQL), read-only vector tiles, and raster layers.
  * - `export`: true by default.
  */
-declare function inferLayerCapabilities(layer: GeoLibreLayer): Required<LayerCapabilities>;
+export declare function inferLayerCapabilities(layer: GeoLibreLayer): Required<LayerCapabilities>;
 /**
  * Resolves the effective capabilities for a layer by overlaying any explicit
  * capability overrides on top of inferred defaults.
  */
-declare function resolveLayerCapabilities(layer: GeoLibreLayer | undefined): Required<LayerCapabilities>;
+export declare function resolveLayerCapabilities(layer: GeoLibreLayer | undefined): Required<LayerCapabilities>;
 /**
  * Normalizes an untrusted capabilities value from JSON/project data.
  */
-declare function normalizeLayerCapabilities(raw: unknown): LayerCapabilities | undefined;
+export declare function normalizeLayerCapabilities(raw: unknown): LayerCapabilities | undefined;
 /**
  * All supported application privilege identifiers in GeoLibre.
  */
-declare const ALL_APP_PRIVILEGES: readonly AppPrivilege[];
+export declare const ALL_APP_PRIVILEGES: readonly AppPrivilege[];
 /**
  * Standard privilege bundles for named application roles.
  */
-declare const ROLE_PRIVILEGES: Record<Exclude<AppRole, "custom">, readonly AppPrivilege[]>;
+export declare const ROLE_PRIVILEGES: Record<Exclude<AppRole, "custom">, readonly AppPrivilege[]>;
 /**
  * Resolves the effective privilege list for a given role, applying custom overrides if specified.
  */
-declare function resolveRolePrivileges(role: AppRole, customPrivileges?: readonly AppPrivilege[]): AppPrivilege[];
+export declare function resolveRolePrivileges(role: AppRole, customPrivileges?: readonly AppPrivilege[]): AppPrivilege[];
 /**
  * Intersects multiple sets of privileges to derive the effective permissions when multiple
  * policies (e.g. deployment, organization, and share link) apply simultaneously.
  */
-declare function intersectPrivileges(...privilegeSets: (readonly AppPrivilege[])[]): AppPrivilege[];
+export declare function intersectPrivileges(...privilegeSets: (readonly AppPrivilege[])[]): AppPrivilege[];
 /**
  * Evaluates whether an application capability set grants a specific privilege.
  */
-declare function hasAppPrivilege(capabilities: AppCapabilities | undefined, privilege: AppPrivilege): boolean;
+export declare function hasAppPrivilege(capabilities: AppCapabilities | undefined, privilege: AppPrivilege): boolean;
 /**
  * Resolves why a privilege is withheld: its own reason if it has one, otherwise
  * the reason recorded for the capability set as a whole.
@@ -4535,19 +4898,19 @@ declare function hasAppPrivilege(capabilities: AppCapabilities | undefined, priv
  * @param privilege - The privilege being explained.
  * @returns The reason, or undefined when none was recorded.
  */
-declare function appPrivilegeReason(capabilities: AppCapabilities | undefined, privilege: AppPrivilege): string | undefined;
+export declare function appPrivilegeReason(capabilities: AppCapabilities | undefined, privilege: AppPrivilege): string | undefined;
 /**
  * Creates the default unconstrained application capabilities (Administrator role).
  */
-declare function createDefaultAppCapabilities(): AppCapabilities;
+export declare function createDefaultAppCapabilities(): AppCapabilities;
 /**
  * Normalizes an untrusted array of privilege strings.
  */
-declare function normalizeAppPrivileges(raw: unknown): AppPrivilege[] | undefined;
+export declare function normalizeAppPrivileges(raw: unknown): AppPrivilege[] | undefined;
 //#endregion
 //#region src/deployment-capabilities.d.ts
 /** A privileged action a deployment can grant or withhold. */
-type DeploymentCapability =
+export type DeploymentCapability =
 /** Create, save, or otherwise author the project itself. */
 "project:edit" |
 /** Bring new data into the map from files, URLs, or services. */
@@ -4561,14 +4924,14 @@ type DeploymentCapability =
 /** Reach the application settings. */
 "settings:manage";
 /** Every capability, in a stable order for docs and tests. */
-declare const DEPLOYMENT_CAPABILITIES: readonly DeploymentCapability[];
+export declare const DEPLOYMENT_CAPABILITIES: readonly DeploymentCapability[];
 /**
  * The default grant: everything. `full` must stay the default so an existing
  * deployment that configures nothing behaves exactly as it did before.
  */
-declare const ALL_DEPLOYMENT_CAPABILITIES: ReadonlySet<DeploymentCapability>;
+export declare const ALL_DEPLOYMENT_CAPABILITIES: ReadonlySet<DeploymentCapability>;
 /** Whether an arbitrary string names a capability we know how to enforce. */
-declare function isDeploymentCapability(value: string): value is DeploymentCapability;
+export declare function isDeploymentCapability(value: string): value is DeploymentCapability;
 /**
  * The reserved token that grants nothing, for a deployment that wants the map
  * and nothing else.
@@ -4578,7 +4941,7 @@ declare function isDeploymentCapability(value: string): value is DeploymentCapab
  * meaning "full" so existing deployments are unchanged. Without a spelling for
  * "none", the most locked-down configuration would be the one you cannot write.
  */
-declare const NO_DEPLOYMENT_CAPABILITIES = "none";
+export declare const NO_DEPLOYMENT_CAPABILITIES = "none";
 /**
  * Parse a comma-separated capability list from deployment configuration.
  *
@@ -4594,7 +4957,7 @@ declare const NO_DEPLOYMENT_CAPABILITIES = "none";
  * @param raw - The configured value, e.g. `"data:add, export:data"`.
  * @returns The granted capabilities, with duplicates and unknown names removed.
  */
-declare function parseDeploymentCapabilities(raw: string): ReadonlySet<DeploymentCapability>;
+export declare function parseDeploymentCapabilities(raw: string): ReadonlySet<DeploymentCapability>;
 //#endregion
 //#region src/selection.d.ts
 /**
@@ -4602,29 +4965,29 @@ declare function parseDeploymentCapabilities(raw: string): ReadonlySet<Deploymen
  * mirroring QGIS's four selection behaviors: replace the selection, add to
  * it, remove from it, or keep only features in both.
  */
-type SelectionMode = "new" | "add" | "remove" | "intersect";
+export type SelectionMode = "new" | "add" | "remove" | "intersect";
 /** Selection modes in display order. */
-declare const SELECTION_MODES: readonly SelectionMode[];
+export declare const SELECTION_MODES: readonly SelectionMode[];
 /**
  * The id under which a feature participates in the selection model. Mirrors
  * the convention shared by the attribute table and the map highlight
  * (`String(feature.id ?? index)`): the feature's own `id` when present,
  * otherwise its index in the layer's feature array.
  */
-declare function featureSelectionId(feature: Feature, index: number): string;
+export declare function featureSelectionId(feature: Feature, index: number): string;
 /**
  * Combines the current selection with a freshly matched id set according to
  * `mode`. The result is deduplicated and order-stable: "new" follows the
  * matched order, "add" appends unseen matches after the current ids, and
  * "remove"/"intersect" preserve the current selection's order.
  */
-declare function applySelectionMode(current: readonly string[], matched: readonly string[], mode: SelectionMode): string[];
+export declare function applySelectionMode(current: readonly string[], matched: readonly string[], mode: SelectionMode): string[];
 /**
  * The complement of `current` within `allIds` (QGIS "Invert selection"):
  * every feature id not currently selected, in layer order. With an empty
  * selection this selects everything.
  */
-declare function invertSelection(allIds: readonly string[], current: readonly string[]): string[];
+export declare function invertSelection(allIds: readonly string[], current: readonly string[]): string[];
 //#endregion
 //#region src/selection-actions.d.ts
 /**
@@ -4646,15 +5009,15 @@ declare function invertSelection(allIds: readonly string[], current: readonly st
  * the map's drawing gestures (`@geolibre/map`) share one copy of this rule
  * instead of two that can drift apart.
  */
-declare function applyMatchedSelection(targetLayerId: string, matchedIds: string[], mode: SelectionMode): number;
+export declare function applyMatchedSelection(targetLayerId: string, matchedIds: string[], mode: SelectionMode): number;
 //#endregion
 //#region src/scale-units.d.ts
 /** Conversion constants shared by every scale-bar denomination. */
-declare const FEET_PER_METER = 3.2808398950131235;
-declare const METERS_PER_FOOT = 0.3048;
-declare const FEET_PER_MILE = 5280;
-declare const METERS_PER_MILE = 1609.344;
-declare const METERS_PER_NAUTICAL_MILE = 1852;
+export declare const FEET_PER_METER = 3.2808398950131235;
+export declare const METERS_PER_FOOT = 0.3048;
+export declare const FEET_PER_MILE = 5280;
+export declare const METERS_PER_MILE = 1609.344;
+export declare const METERS_PER_NAUTICAL_MILE = 1852;
 /**
  * The largest `1 / 2 / 3 / 5 / 10 × 10ⁿ` number that does not exceed `num`, so
  * the bar lands on a readable round value. Uses log10 for the magnitude (unlike
@@ -4662,9 +5025,9 @@ declare const METERS_PER_NAUTICAL_MILE = 1852;
  * rounds *up* — producing a bar wider than the max width for sub-unit spans).
  * Returns 0 for a non-positive input so callers can clamp or fall back.
  */
-declare function getRoundNum(num: number): number;
+export declare function getRoundNum(num: number): number;
 /** Trim trailing-zero noise from a rounded value (e.g. 0.5, 2, 300). */
-declare function formatRoundNum(value: number): string;
+export declare function formatRoundNum(value: number): string;
 /**
  * The denomination a scale bar rounds and labels distances with for a ground
  * span of `maxMeters` in the requested unit system: km/m for metric, mi/ft for
@@ -4673,7 +5036,7 @@ declare function formatRoundNum(value: number): string;
  * one unit of that denomination in metres, so a caller can round the span in
  * unit space and convert the result back to metres (and thus pixels).
  */
-declare function scaleDenomination(maxMeters: number, unit: MapScaleUnit): {
+export declare function scaleDenomination(maxMeters: number, unit: MapScaleUnit): {
   metersPerUnit: number;
   label: string;
 };
@@ -4682,7 +5045,7 @@ declare function scaleDenomination(maxMeters: number, unit: MapScaleUnit): {
  * bar's denomination) and its label — the shape the on-screen control consumes.
  * Derived from {@link scaleDenomination} so the two never diverge.
  */
-declare function scaleSpan(maxMeters: number, unit: MapScaleUnit): {
+export declare function scaleSpan(maxMeters: number, unit: MapScaleUnit): {
   span: number;
   label: string;
 };
@@ -4713,17 +5076,17 @@ declare function scaleSpan(maxMeters: number, unit: MapScaleUnit): {
  * callers must not reach for it when the active body is not Earth.
  */
 /** A coordinate as `[longitude, latitude]` in degrees. */
-type LngLat = [number, number];
+export type LngLat = [number, number];
 /** Open-Meteo accepts at most 100 coordinates per elevation request. */
-declare const MAX_POINTS_PER_REQUEST = 100;
+export declare const MAX_POINTS_PER_REQUEST = 100;
 /** Abort an elevation request that has not responded within this window. */
-declare const ELEVATION_REQUEST_TIMEOUT_MS = 15000;
+export declare const ELEVATION_REQUEST_TIMEOUT_MS = 15000;
 /** Error thrown when an elevation request cannot be completed or parsed. */
-declare class ElevationFetchError extends Error {
+export declare class ElevationFetchError extends Error {
   constructor(message: string);
 }
 /** A `fetch`-compatible function, so tests can inject a stub. */
-type FetchLike = (url: string, init?: RequestInit) => Promise<Response>;
+export type FetchLike = (url: string, init?: RequestInit) => Promise<Response>;
 /**
  * Fetch elevations (in meters) for an ordered list of coordinates.
  *
@@ -4733,9 +5096,9 @@ type FetchLike = (url: string, init?: RequestInit) => Promise<Response>;
  * @throws {ElevationFetchError} On too many points, a network error, a non-2xx
  *   response, a malformed body, or a length mismatch
  */
-declare function fetchElevations(points: LngLat[], fetchImpl?: FetchLike): Promise<number[]>;
+export declare function fetchElevations(points: LngLat[], fetchImpl?: FetchLike): Promise<number[]>;
 /** The slice of the MapLibre map the terrain sampler needs (stubbed in tests). */
-interface TerrainMapLike {
+export interface TerrainMapLike {
   getTerrain?: () => {
     exaggeration?: number;
   } | null | undefined;
@@ -4746,24 +5109,24 @@ interface TerrainMapLike {
  * (MapLibre's `queryTerrainElevation` bakes the exaggeration in, so it is
  * divided back out). Returns null when terrain is not enabled.
  */
-declare function sampleMapTerrain(map: TerrainMapLike | null | undefined, points: LngLat[]): (number | null)[] | null;
+export declare function sampleMapTerrain(map: TerrainMapLike | null | undefined, points: LngLat[]): (number | null)[] | null;
 /**
  * Sample a single point's elevation from enabled 3D terrain, in true meters.
  * Returns null when terrain is off or the DEM tile under the point has not
  * loaded — the caller decides whether that is worth a network round-trip.
  */
-declare function sampleMapTerrainPoint(map: TerrainMapLike | null | undefined, point: LngLat): number | null;
+export declare function sampleMapTerrainPoint(map: TerrainMapLike | null | undefined, point: LngLat): number | null;
 /**
  * Sample elevations from the Open-Meteo API, chunked to its 100-point request
  * limit. A failed chunk yields nulls for its points rather than throwing, so a
  * flaky network degrades the readout instead of breaking the caller.
  */
-declare function sampleRemoteElevations(points: LngLat[], fetchImpl?: FetchLike): Promise<(number | null)[]>;
+export declare function sampleRemoteElevations(points: LngLat[], fetchImpl?: FetchLike): Promise<(number | null)[]>;
 /** How long the pointer must sit still before a remote lookup is worth it. */
-declare const POINTER_ELEVATION_DEBOUNCE_MS = 500;
+export declare const POINTER_ELEVATION_DEBOUNCE_MS = 500;
 /** Remote results kept per resolver; bounded so a long session cannot grow it without limit. */
-declare const POINTER_ELEVATION_CACHE_LIMIT = 500;
-interface PointerElevationResolverOptions {
+export declare const POINTER_ELEVATION_CACHE_LIMIT = 500;
+export interface PointerElevationResolverOptions {
   /** The live map, for the terrain sample. May return null before init. */
   getMap: () => TerrainMapLike | null | undefined;
   /**
@@ -4787,7 +5150,7 @@ interface PointerElevationResolverOptions {
   fetchImpl?: FetchLike;
   debounceMs?: number;
 }
-interface PointerElevationResolver {
+export interface PointerElevationResolver {
   /** Report a new pointer position, or null when the pointer leaves the map. */
   update: (point: LngLat | null) => void;
   /**
@@ -4817,7 +5180,7 @@ interface PointerElevationResolver {
  * previous point's value: showing a stale height next to fresh coordinates
  * would be worse than showing nothing.
  */
-declare function createPointerElevationResolver(options: PointerElevationResolverOptions): PointerElevationResolver;
+export declare function createPointerElevationResolver(options: PointerElevationResolverOptions): PointerElevationResolver;
 //#endregion
 //#region src/camera-altitude.d.ts
 /**
@@ -4828,7 +5191,7 @@ declare function createPointerElevationResolver(options: PointerElevationResolve
  * @returns Altitude in metres above the active body's datum, or null when the
  *   input is not a usable number (no map, degenerate transform, globe edge case)
  */
-declare function scaleAltitudeToActiveBody(earthAltitudeMeters: number | null): number | null;
+export declare function scaleAltitudeToActiveBody(earthAltitudeMeters: number | null): number | null;
 /**
  * Format a camera altitude for the status bar.
  *
@@ -4839,20 +5202,20 @@ declare function scaleAltitudeToActiveBody(earthAltitudeMeters: number | null):
  * the same thresholds {@link scaleDenomination} gives the scale bar, so the two
  * always agree about which unit this view is being described in.
  */
-declare function formatCameraAltitude(meters: number, unit: MapScaleUnit): string;
+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. */
-declare const DEFAULT_PROJECT_NAME = "Untitled Project";
-interface CreateProjectOptions {
+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;
 }
-declare function normalizeBlankBackgroundColor(value: unknown): string | null;
-declare function createDefaultMapView(): MapViewState;
-declare function createEmptyProject(name?: string, options?: CreateProjectOptions): GeoLibreProject;
+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
@@ -4861,8 +5224,8 @@ declare function createEmptyProject(name?: string, options?: CreateProjectOption
  * @param project Project to serialize.
  * @returns The file contents to write.
  */
-declare function serializeProject(project: GeoLibreProject): string;
-declare function parseProject(json: string): GeoLibreProject;
+export declare function serializeProject(project: GeoLibreProject): string;
+export declare function parseProject(json: string): GeoLibreProject;
 /**
  * Validate and coerce a story map loaded from an untrusted project file.
  *
@@ -4872,9 +5235,9 @@ declare function parseProject(json: string): GeoLibreProject;
  * @param storymap Raw value read from the project JSON.
  * @returns A normalized story map, or null when there is nothing to keep.
  */
-declare function normalizeStoryMap(storymap: unknown): StoryMap | null;
+export declare function normalizeStoryMap(storymap: unknown): StoryMap | null;
 /** Whether a story map carries chapters or any non-default setting. */
-declare function storyMapHasContent(story: StoryMap): boolean;
+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
@@ -4886,7 +5249,7 @@ declare function storyMapHasContent(story: StoryMap): boolean;
  * @param value Raw `models` value from the project JSON.
  * @returns Normalized models, or `null` when none survive.
  */
-declare function normalizeModels(value: unknown): ProcessingModel[] | null;
+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
@@ -4900,7 +5263,7 @@ declare function normalizeModels(value: unknown): ProcessingModel[] | null;
  * @param value Raw `graph` value from the project JSON.
  * @returns The normalized graph, or `null` when it has no usable nodes.
  */
-declare function normalizeModelGraph(value: unknown): ProcessingModelGraph | null;
+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
@@ -4912,31 +5275,41 @@ declare function normalizeModelGraph(value: unknown): ProcessingModelGraph | nul
  * @param value Raw `processingHistory` value from the project JSON.
  * @returns Normalized runs, or `null` when none survive.
  */
-declare function normalizeProcessingHistory(value: unknown): ProcessingRun[] | null;
+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.
  */
-declare function normalizeMapViewState(value: unknown): MapViewState;
+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).
  */
-declare function normalizeMapLayout(value: unknown): MapGridLayout | null;
+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" | null` rather than the full
+ * {@link MapRendererKind} for that reason: `"maplibre"` is never a result.
+ */
+export declare function normalizePrimaryRenderer(value: unknown): "cesium" | 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.
  */
-declare function normalizeSecondaryMapViews(value: unknown): SecondaryMapView[] | null;
+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.
  */
-declare function resolveMapGrid(layout: MapGridLayout | null, secondaryViews: SecondaryMapView[] | null, primary: {
+export declare function resolveMapGrid(layout: MapGridLayout | null, secondaryViews: SecondaryMapView[] | null, primary: {
   mapView: MapViewState;
 }): {
   mapLayout: MapGridLayout;
@@ -4953,7 +5326,7 @@ declare function resolveMapGrid(layout: MapGridLayout | null, secondaryViews: Se
  * @param value Raw `widgets` value from the project JSON.
  * @returns Normalized widgets, or `null` when none survive.
  */
-declare function normalizeWidgets(value: unknown): DashboardWidget[] | null;
+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.
@@ -4961,10 +5334,10 @@ declare function normalizeWidgets(value: unknown): DashboardWidget[] | null;
  * @param value Raw `dashboardColumns` value from the project JSON.
  * @returns An integer column count within [MIN, MAX].
  */
-declare function normalizeDashboardColumns(value: unknown): number;
-declare function isAllowedPluginManifestUrl(url: string): boolean;
-declare function normalizeProjectComments(rawComments: unknown): ProjectComment[];
-declare function projectFromStore(state: {
+export declare function normalizeDashboardColumns(value: unknown): number;
+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;
@@ -4986,12 +5359,13 @@ declare function projectFromStore(state: {
   mapLayout?: MapGridLayout;
   secondaryMapViews?: SecondaryMapView[];
   primaryMapLabel?: string;
+  primaryRenderer?: MapRendererKind;
   /** Project-scoped Style Manager entries (the store's `projectStyleLibrary`). */
   styleLibrary?: StyleLibraryEntry[] | null;
   comments?: ProjectComment[] | null;
   metadata: Record<string, unknown>;
 }): GeoLibreProject;
-declare function applyProjectToStore(project: GeoLibreProject): {
+export declare function applyProjectToStore(project: GeoLibreProject): {
   projectName: string;
   mapView: MapViewState;
   basemapStyleUrl: string;
@@ -5012,6 +5386,7 @@ declare function applyProjectToStore(project: GeoLibreProject): {
   mapLayout: MapGridLayout;
   secondaryMapViews: SecondaryMapView[];
   primaryMapLabel: string;
+  primaryRenderer: MapRendererKind;
   projectStyleLibrary: StyleLibraryEntry[];
   comments: ProjectComment[];
   metadata: Record<string, unknown>;
@@ -5020,7 +5395,7 @@ declare function applyProjectToStore(project: GeoLibreProject): {
  * Create an unlinked copy of a project, suffixed with "(copy)" by default and
  * stripped of share-specific metadata (shareId, shareUrl, etc.).
  */
-declare function detachProjectCopy(project: GeoLibreProject, options?: {
+export declare function detachProjectCopy(project: GeoLibreProject, options?: {
   nameSuffix?: string;
 }): GeoLibreProject;
 /**
@@ -5028,7 +5403,7 @@ declare function detachProjectCopy(project: GeoLibreProject, options?: {
  * keeping basemap, layer groups, styles, legend config, preferences, widgets, and
  * print layout.
  */
-declare function createProjectTemplate(project: GeoLibreProject, options?: {
+export declare function createProjectTemplate(project: GeoLibreProject, options?: {
   name?: string;
   stripDataLayers?: boolean;
 }): GeoLibreProject;
@@ -5042,11 +5417,11 @@ declare function createProjectTemplate(project: GeoLibreProject, options?: {
  * so a future vector-stylable type cannot be added to one gate and missed in
  * another, leaving a dead-end entry point.
  */
-declare function isStyleLibraryTargetLayer(type: LayerType): boolean;
+export declare function isStyleLibraryTargetLayer(type: LayerType): boolean;
 /** `type` discriminator of an exported Style Manager bundle file. */
-declare const STYLE_LIBRARY_BUNDLE_TYPE = "geolibre-style-library";
+export declare const STYLE_LIBRARY_BUNDLE_TYPE = "geolibre-style-library";
 /** Current bundle format version, for forward-compatible readers. */
-declare const STYLE_LIBRARY_BUNDLE_VERSION = 1;
+export declare const STYLE_LIBRARY_BUNDLE_VERSION = 1;
 /**
  * The {@link LayerStyle} keys a `"symbol"` entry captures: fill, stroke,
  * point/circle, marker, and fill-pattern symbology. Deliberately excludes the
@@ -5054,14 +5429,14 @@ declare const STYLE_LIBRARY_BUNDLE_VERSION = 1;
  * adjustments so a symbol preset restyles a layer without dismantling its
  * classification or labeling.
  */
-declare const SYMBOL_STYLE_KEYS: readonly ["fillColor", "strokeColor", "strokeWidth", "strokeWidthUnit", "fillOpacity", "circleRadius", "fillPattern", "fillPatternColor", "fillPatternSvg", "markerEnabled", "markerShape", "markerColor", "markerSize", "markerSvg"];
+export declare const SYMBOL_STYLE_KEYS: readonly ["fillColor", "strokeColor", "strokeWidth", "strokeWidthUnit", "fillOpacity", "circleRadius", "fillPattern", "fillPatternColor", "fillPatternSvg", "markerEnabled", "markerShape", "markerColor", "markerSize", "markerSvg"];
 /**
  * The {@link LayerStyle} keys a `"ramp"` entry captures. The classified
  * attribute (`vectorStyleProperty`) and the concrete stops are deliberately
  * excluded: they are data-specific, so a ramp preset stays reusable across
  * layers with different attributes and value ranges.
  */
-declare const RAMP_STYLE_KEYS: readonly ["vectorStyleColorRamp", "vectorStyleClassCount", "vectorStyleClassificationScheme"];
+export declare const RAMP_STYLE_KEYS: readonly ["vectorStyleColorRamp", "vectorStyleClassCount", "vectorStyleClassificationScheme"];
 /**
  * Extract the {@link LayerStyle} subset a Style Manager entry of `kind`
  * stores, deep-cloned so later edits to the live layer cannot mutate the
@@ -5071,7 +5446,7 @@ declare const RAMP_STYLE_KEYS: readonly ["vectorStyleColorRamp", "vectorStyleCla
  * @param kind - Which subset to capture.
  * @returns The cloned subset to store in a {@link StyleLibraryEntry}.
  */
-declare function extractStyleLibraryStyle(style: LayerStyle, kind: StyleLibraryEntryKind): Partial<LayerStyle>;
+export declare function extractStyleLibraryStyle(style: LayerStyle, kind: StyleLibraryEntryKind): Partial<LayerStyle>;
 /**
  * Coerce an untrusted style patch (from a hand-edited project file or an
  * imported bundle) into a safe {@link LayerStyle} subset: unknown keys are
@@ -5084,7 +5459,7 @@ declare function extractStyleLibraryStyle(style: LayerStyle, kind: StyleLibraryE
  * @param value - The raw `style` value from JSON.
  * @returns The sanitized subset (empty when nothing usable survives).
  */
-declare function sanitizeLayerStylePatch(value: unknown): Partial<LayerStyle>;
+export declare function sanitizeLayerStylePatch(value: unknown): Partial<LayerStyle>;
 /**
  * Coerce an untrusted (hand-edited project file or imported bundle) entries
  * array into valid {@link StyleLibraryEntry} records. Drops entries without a
@@ -5095,7 +5470,7 @@ declare function sanitizeLayerStylePatch(value: unknown): Partial<LayerStyle>;
  * @param value - The raw `styleLibrary` / bundle `entries` value.
  * @returns Normalized, de-duplicated entries (empty when none survive).
  */
-declare function normalizeStyleLibraryEntries(value: unknown): StyleLibraryEntry[];
+export declare function normalizeStyleLibraryEntries(value: unknown): StyleLibraryEntry[];
 /**
  * Serialize Style Manager entries into the shareable bundle JSON written by
  * the Export action and read back by {@link parseStyleLibrary}.
@@ -5103,7 +5478,7 @@ declare function normalizeStyleLibraryEntries(value: unknown): StyleLibraryEntry
  * @param entries - The entries to export.
  * @returns Pretty-printed bundle JSON.
  */
-declare function serializeStyleLibrary(entries: StyleLibraryEntry[]): string;
+export declare function serializeStyleLibrary(entries: StyleLibraryEntry[]): string;
 /**
  * Parse a Style Manager bundle produced by {@link serializeStyleLibrary} (a
  * bare entries array is also accepted, so hand-authored files work). Entries
@@ -5114,13 +5489,13 @@ declare function serializeStyleLibrary(entries: StyleLibraryEntry[]): string;
  * @throws Error when the JSON is not a style-library bundle or holds no
  *   usable entries.
  */
-declare function parseStyleLibrary(json: string): StyleLibraryEntry[];
+export declare function parseStyleLibrary(json: string): StyleLibraryEntry[];
 /**
  * Create a fresh unique id for a new library entry.
  *
  * @returns A random id (UUID when available).
  */
-declare function createStyleLibraryEntryId(): string;
+export declare function createStyleLibraryEntryId(): string;
 /**
  * Built-in presets shown in the Style Manager so the library is not empty on
  * first open (issue #1294). Read-only: they are not persisted, cannot be
@@ -5128,13 +5503,13 @@ declare function createStyleLibraryEntryId(): string;
  * collide. Names are plain English by the same convention as the ramp labels
  * in `color-ramp.ts`.
  */
-declare const BUILT_IN_STYLE_PRESETS: readonly StyleLibraryEntry[];
+export declare const BUILT_IN_STYLE_PRESETS: readonly StyleLibraryEntry[];
 //#endregion
 //#region src/layer-library.d.ts
 /** `type` discriminator of an exported Layer Library bundle file. */
-declare const LAYER_LIBRARY_BUNDLE_TYPE = "geolibre-layer-library";
+export declare const LAYER_LIBRARY_BUNDLE_TYPE = "geolibre-layer-library";
 /** Current bundle format version, for forward-compatible readers. */
-declare const LAYER_LIBRARY_BUNDLE_VERSION = 1;
+export declare const LAYER_LIBRARY_BUNDLE_VERSION = 1;
 /**
  * Size ceiling for one library entry's serialized JSON, in bytes. The library
  * lives in IndexedDB and is meant to be a small, shareable index of *sources*,
@@ -5144,7 +5519,7 @@ declare const LAYER_LIBRARY_BUNDLE_VERSION = 1;
  * Applied to the whole entry (not just `geojson`), because an Add Vector Layer
  * entry can also carry a `metadata.embeddedGeoJSON` copy of its features.
  */
-declare const MAX_LAYER_LIBRARY_ENTRY_BYTES: number;
+export declare const MAX_LAYER_LIBRARY_ENTRY_BYTES: number;
 /**
  * Cap on how many entries a single normalization pass keeps. Enforced on the way
  * *in* — an imported bundle or a hand-edited database is untrusted, and without
@@ -5152,7 +5527,7 @@ declare const MAX_LAYER_LIBRARY_ENTRY_BYTES: number;
  * synchronous pass and into IndexedDB. Mirrors `MAX_FAVORITES`, which caps the
  * Browser panel's other user-grown list on read as well as write.
  */
-declare const MAX_LAYER_LIBRARY_ENTRIES = 500;
+export declare const MAX_LAYER_LIBRARY_ENTRIES = 500;
 /**
  * Whether a layer's features can be re-fetched from its source specification
  * alone, so an entry need not embed them: a tile/service template, a remote
@@ -5163,7 +5538,7 @@ declare const MAX_LAYER_LIBRARY_ENTRIES = 500;
  * @param layer - The layer to inspect (source + metadata only).
  * @returns True when the source alone is enough to recreate the layer's data.
  */
-declare function hasRestorableLayerSource(layer: Pick<GeoLibreLayer, "source" | "metadata">): boolean;
+export declare function hasRestorableLayerSource(layer: Pick<GeoLibreLayer, "source" | "metadata">): boolean;
 /**
  * Whether "Save to library" applies to a layer at all — the cheap predicate the
  * layer actions menu gates on. Two things have to hold:
@@ -5194,12 +5569,12 @@ declare function hasRestorableLayerSource(layer: Pick<GeoLibreLayer, "source" |
  *   `isEmbeddableLocalVectorLayer`, the same predicate its save handler uses).
  * @returns Whether the layer can be offered to the library.
  */
-declare function canSaveLayerToLibrary(layer: GeoLibreLayer, options?: {
+export declare function canSaveLayerToLibrary(layer: GeoLibreLayer, options?: {
   canRestoreControlPainted?: (layer: GeoLibreLayer) => boolean;
   hasMaterializableFeatures?: (layer: GeoLibreLayer) => boolean;
 }): boolean;
 /** Why a layer could not be captured into the library. */
-type LayerLibraryCaptureFailure =
+export type LayerLibraryCaptureFailure =
 /** Nothing to re-add from: no source URL, no local path, no features. */
 "no-source" |
 /** Its features are the only copy, and they exceed the per-entry size cap. */
@@ -5211,7 +5586,7 @@ type LayerLibraryCaptureFailure =
  */
 "config-too-large";
 /** Outcome of {@link captureLayerLibraryEntry}. */
-type LayerLibraryCaptureResult = {
+export type LayerLibraryCaptureResult = {
   ok: true;
   entry: LayerLibraryEntry;
 } | {
@@ -5228,7 +5603,7 @@ type LayerLibraryCaptureResult = {
  * @param layer - The layer to test (metadata only).
  * @returns True when a plugin control owns the layer's rendering.
  */
-declare function isExternalNativeLayerRecord(layer: Pick<GeoLibreLayer, "metadata">): boolean;
+export declare function isExternalNativeLayerRecord(layer: Pick<GeoLibreLayer, "metadata">): boolean;
 /**
  * Capture a configured layer as a reusable Layer Library entry: its source
  * spec, layer type, full style (labels included), opacity, metadata, and the
@@ -5254,7 +5629,7 @@ declare function isExternalNativeLayerRecord(layer: Pick<GeoLibreLayer, "metadat
  *   current data from its control).
  * @returns The entry, or the reason it could not be captured.
  */
-declare function captureLayerLibraryEntry(layer: GeoLibreLayer, options: {
+export declare function captureLayerLibraryEntry(layer: GeoLibreLayer, options: {
   id: string;
   addedAt: string;
   name?: string;
@@ -5266,7 +5641,7 @@ declare function captureLayerLibraryEntry(layer: GeoLibreLayer, options: {
  * layer) and then applies this patch, so a degraded entry still comes back
  * "fully configured" rather than losing the styling the entry preserved.
  */
-interface LayerLibraryConfigPatch {
+export interface LayerLibraryConfigPatch {
   name: string;
   style: LayerStyle;
   opacity: number;
@@ -5276,7 +5651,7 @@ interface LayerLibraryConfigPatch {
   popup?: LayerPopupConfig;
 }
 /** How an entry should be re-added to the current project. */
-type LayerLibraryAddPlan =
+export type LayerLibraryAddPlan =
 /** Add this layer record to the store; the map sync renders it. */
 {
   kind: "layer";
@@ -5300,7 +5675,7 @@ type LayerLibraryAddPlan =
  * @param options - The fresh layer `id` to create it under.
  * @returns Either the layer record to add, or the local file to re-read.
  */
-declare function planLayerLibraryAdd(entry: LayerLibraryEntry, options: {
+export declare function planLayerLibraryAdd(entry: LayerLibraryEntry, options: {
   id: string;
 }): LayerLibraryAddPlan;
 /**
@@ -5310,7 +5685,7 @@ declare function planLayerLibraryAdd(entry: LayerLibraryEntry, options: {
  * @param entry - The entry being re-added.
  * @returns The patch to merge onto the imported layer.
  */
-declare function layerLibraryConfigPatch(entry: LayerLibraryEntry): LayerLibraryConfigPatch;
+export declare function layerLibraryConfigPatch(entry: LayerLibraryEntry): LayerLibraryConfigPatch;
 /**
  * The saved joins whose source layer is not present in the target project.
  *
@@ -5331,7 +5706,7 @@ declare function layerLibraryConfigPatch(entry: LayerLibraryEntry): LayerLibrary
  * @returns Ids of the join-target layers that cannot resolve ({@link LayerJoin}
  *   has no display name).
  */
-declare function unresolvedLayerLibraryJoins(entry: Pick<LayerLibraryEntry, "joins">, presentLayerIds: Iterable<string>): string[];
+export declare function unresolvedLayerLibraryJoins(entry: Pick<LayerLibraryEntry, "joins">, presentLayerIds: Iterable<string>): string[];
 /**
  * Whether re-adding an entry needs a host that can read local files — used to
  * badge the entry in the Browser panel and to explain the failure in the
@@ -5340,7 +5715,7 @@ declare function unresolvedLayerLibraryJoins(entry: Pick<LayerLibraryEntry, "joi
  * @param entry - The entry to test.
  * @returns True when only a filesystem-capable host can add it.
  */
-declare function layerLibraryEntryNeedsLocalFile(entry: LayerLibraryEntry): boolean;
+export declare function layerLibraryEntryNeedsLocalFile(entry: LayerLibraryEntry): boolean;
 /**
  * Coerce an untrusted entries array (an imported bundle, or a record written by
  * an older version) into valid {@link LayerLibraryEntry} records. Entries
@@ -5355,7 +5730,7 @@ declare function layerLibraryEntryNeedsLocalFile(entry: LayerLibraryEntry): bool
  * @param value - The raw entries value.
  * @returns Normalized, de-duplicated entries (empty when none survive).
  */
-declare function normalizeLayerLibraryEntries(value: unknown): LayerLibraryEntry[];
+export declare function normalizeLayerLibraryEntries(value: unknown): LayerLibraryEntry[];
 /**
  * Serialize Layer Library entries into the shareable bundle JSON written by the
  * Export action and read back by {@link parseLayerLibrary}. Per-user credentials
@@ -5364,7 +5739,7 @@ declare function normalizeLayerLibraryEntries(value: unknown): LayerLibraryEntry
  * @param entries - The entries to export.
  * @returns Pretty-printed bundle JSON.
  */
-declare function serializeLayerLibrary(entries: LayerLibraryEntry[]): string;
+export declare function serializeLayerLibrary(entries: LayerLibraryEntry[]): string;
 /**
  * Parse a Layer Library bundle produced by {@link serializeLayerLibrary} (a
  * bare entries array is also accepted, so hand-authored files work). Entries
@@ -5375,13 +5750,13 @@ declare function serializeLayerLibrary(entries: LayerLibraryEntry[]): string;
  * @throws Error when the JSON is not a layer-library bundle or holds no usable
  *   entries.
  */
-declare function parseLayerLibrary(json: string): LayerLibraryEntry[];
+export declare function parseLayerLibrary(json: string): LayerLibraryEntry[];
 /**
  * Create a fresh unique id for a new library entry.
  *
  * @returns A random id (UUID when available).
  */
-declare function createLayerLibraryEntryId(): string;
+export declare function createLayerLibraryEntryId(): string;
 //#endregion
 //#region src/layer-defaults.d.ts
 /**
@@ -5405,9 +5780,9 @@ declare function createLayerLibraryEntryId(): string;
  * *within* one layer: this one separates layers from each other, and the two
  * are free to diverge.
  */
-declare const LAYER_PALETTE: readonly ["#3b82f6", "#ef4444", "#22c55e", "#a855f7", "#f97316", "#06b6d4", "#ec4899", "#84cc16"];
+export declare const LAYER_PALETTE: readonly ["#3b82f6", "#ef4444", "#22c55e", "#a855f7", "#f97316", "#06b6d4", "#ec4899", "#84cc16"];
 /** Darken a `#rrggbb` color toward black by `factor`. */
-declare function darkenHex(hex: string, factor: number): string;
+export declare function darkenHex(hex: string, factor: number): string;
 /**
  * Pick the next layer color: the first palette entry no current layer is
  * already using, so deleting a layer frees its color back up rather than
@@ -5418,9 +5793,9 @@ declare function darkenHex(hex: string, factor: number): string;
  *   palette assignment count; see {@link wearsPaletteColor}.
  * @returns A `#rrggbb` color from {@link LAYER_PALETTE}.
  */
-declare function nextLayerPaletteColor(layers: readonly GeoLibreLayer[]): string;
+export declare function nextLayerPaletteColor(layers: readonly GeoLibreLayer[]): string;
 /** The geometry family a layer is mostly made of. */
-type DominantGeometry = "point" | "line" | "polygon" | "mixed";
+export type DominantGeometry = "point" | "line" | "polygon" | "mixed";
 /**
  * Classify a collection by the geometry family most of its features carry,
  * reading at most {@link GEOMETRY_SAMPLE_SIZE} features so a very large layer
@@ -5430,8 +5805,8 @@ type DominantGeometry = "point" | "line" | "polygon" | "mixed";
  * @returns The dominant family, or `"mixed"` when nothing has a clear majority
  *   (or the collection is empty).
  */
-declare function dominantGeometry(geojson: FeatureCollection | undefined): DominantGeometry;
-interface InitialLayerStyleOptions {
+export declare function dominantGeometry(geojson: FeatureCollection | undefined): DominantGeometry;
+export interface InitialLayerStyleOptions {
   /** The layer's data, used to pick geometry-appropriate sizes. */
   geojson?: FeatureCollection;
   /** Current project layers, so the new layer gets an unused palette color. */
@@ -5446,7 +5821,7 @@ interface InitialLayerStyleOptions {
  * @param options - Data and project context to derive the style from.
  * @returns A complete {@link LayerStyle}.
  */
-declare function initialLayerStyle(options?: InitialLayerStyleOptions): LayerStyle;
+export declare function initialLayerStyle(options?: InitialLayerStyleOptions): LayerStyle;
 /**
  * True when a layer still wears exactly what {@link initialLayerStyle} gave it.
  *
@@ -5464,7 +5839,7 @@ declare function initialLayerStyle(options?: InitialLayerStyleOptions): LayerSty
  * @param geojson - Its data, so the geometry-derived sizes can be recomputed.
  * @returns `true` when nothing about the as-added look has been changed.
  */
-declare function isInitialLayerStyle(style: LayerStyle, geojson?: FeatureCollection): boolean;
+export declare function isInitialLayerStyle(style: LayerStyle, geojson?: FeatureCollection): boolean;
 //#endregion
 //#region src/layer-style-clipboard.d.ts
 /**
@@ -5473,14 +5848,14 @@ declare function isInitialLayerStyle(style: LayerStyle, geojson?: FeatureCollect
  * LayerStyle} bag vs `metadata.rasterState`), so a paste only applies between
  * layers of the same family.
  */
-type LayerStyleClipboardKind = "vector" | "raster";
+export type LayerStyleClipboardKind = "vector" | "raster";
 /**
  * The `metadata.rasterState` keys a raster style paste carries over: the
  * appearance of the render (colormap, stretch range, gamma, nodata), but not
  * the data selection (`mode`/`bands`/`index`), which stays with the target so
  * pasting a style never points a raster at a band it does not have.
  */
-declare const RASTER_APPEARANCE_STATE_KEYS: readonly ["colormap", "reversed", "rescale", "nodata", "stretch", "gamma"];
+export declare const RASTER_APPEARANCE_STATE_KEYS: readonly ["colormap", "reversed", "rescale", "nodata", "stretch", "gamma"];
 /**
  * Fields every clipboard entry carries, regardless of style family. Layer
  * `opacity` is deliberately excluded: like QGIS "Paste Style" and GeoLibre's
@@ -5501,7 +5876,7 @@ interface CopiedLayerStyleBase {
   sourceName: string;
 }
 /** A copied vector layer style: the whole {@link LayerStyle} bag. */
-interface CopiedVectorStyle extends CopiedLayerStyleBase {
+export interface CopiedVectorStyle extends CopiedLayerStyleBase {
   kind: "vector";
   /** Deep-cloned full vector layer style. */
   style: LayerStyle;
@@ -5511,7 +5886,7 @@ interface CopiedVectorStyle extends CopiedLayerStyleBase {
  * classification symbology. There is no `style` field — the vector
  * {@link LayerStyle} bag holds nothing a deck.gl raster renders from.
  */
-interface CopiedRasterStyle extends CopiedLayerStyleBase {
+export interface CopiedRasterStyle extends CopiedLayerStyleBase {
   kind: "raster";
   /** Raster visualization state (`metadata.rasterState`). */
   rasterState?: Record<string, unknown>;
@@ -5526,7 +5901,7 @@ interface CopiedRasterStyle extends CopiedLayerStyleBase {
  * vector entry (or vice versa); a paste only applies between layers of the same
  * family.
  */
-type CopiedLayerStyle = CopiedVectorStyle | CopiedRasterStyle;
+export type CopiedLayerStyle = CopiedVectorStyle | CopiedRasterStyle;
 /**
  * The copy/paste style family of a layer, or `null` when the layer has no
  * copyable symbology. Deck.gl rasters are `"raster"`; the vector-styled layers
@@ -5535,7 +5910,7 @@ type CopiedLayerStyle = CopiedVectorStyle | CopiedRasterStyle;
  * @param layer - The layer to classify.
  * @returns The style family, or `null`.
  */
-declare function copyableLayerStyleKind(layer: GeoLibreLayer): LayerStyleClipboardKind | null;
+export declare function copyableLayerStyleKind(layer: GeoLibreLayer): LayerStyleClipboardKind | null;
 /**
  * Snapshot a layer's style for the clipboard, deep-cloned so later edits to the
  * live layer cannot mutate the copied entry.
@@ -5544,7 +5919,7 @@ declare function copyableLayerStyleKind(layer: GeoLibreLayer): LayerStyleClipboa
  * @returns The clipboard entry, or `null` when the layer has no copyable
  *   symbology.
  */
-declare function extractCopiedLayerStyle(layer: GeoLibreLayer): CopiedLayerStyle | null;
+export declare function extractCopiedLayerStyle(layer: GeoLibreLayer): CopiedLayerStyle | null;
 /**
  * Build the {@link GeoLibreLayer} patch that pastes a copied style onto a
  * target layer, or `null` when the target's style family does not match the
@@ -5554,16 +5929,16 @@ declare function extractCopiedLayerStyle(layer: GeoLibreLayer): CopiedLayerStyle
  * @param copied - The clipboard entry.
  * @returns A partial layer patch to merge, or `null` when incompatible.
  */
-declare function applyCopiedLayerStyle(target: GeoLibreLayer, copied: CopiedLayerStyle): Partial<GeoLibreLayer> | null;
+export declare function applyCopiedLayerStyle(target: GeoLibreLayer, copied: CopiedLayerStyle): Partial<GeoLibreLayer> | null;
 //#endregion
 //#region src/layer-groups.d.ts
 /** Opacity a freshly created {@link LayerGroup} starts at (fully opaque). */
-declare const DEFAULT_LAYER_GROUP_OPACITY = 1;
+export declare const DEFAULT_LAYER_GROUP_OPACITY = 1;
 /**
  * One row in the layer panel: either a top-level (ungrouped) layer or a group
  * header together with its child layers.
  */
-type LayerTreeItem = {
+export type LayerTreeItem = {
   kind: "layer";
   layer: GeoLibreLayer;
 } | {
@@ -5579,7 +5954,7 @@ type LayerTreeItem = {
  * empty `layers` array, so that empty folders have a position in the panel and
  * can be reordered like any other row.
  */
-type LayerPanelUnit = {
+export type LayerPanelUnit = {
   /** Group the block belongs to, or `null` for a lone ungrouped layer. */
   groupId: string | null;
   /** Member layers, top-first. Empty for a group with no layers under it. */
@@ -5617,12 +5992,12 @@ type LayerPanelUnit = {
  * @param groups Group definitions.
  * @returns Panel blocks in top-to-bottom display order.
  */
-declare function buildLayerPanelUnits(layers: GeoLibreLayer[], groups: LayerGroup[]): LayerPanelUnit[];
+export declare function buildLayerPanelUnits(layers: GeoLibreLayer[], groups: LayerGroup[]): LayerPanelUnit[];
 /**
  * Where the layer panel should draw every group header, expressed against the
  * layer rows the panel already renders.
  */
-type LayerPanelGroupHeaders = {
+export type LayerPanelGroupHeaders = {
   /** Headers drawn immediately above the keyed layer's row, in panel order. */
   aboveLayer: Map<string, LayerGroup[]>;
   /** Headers drawn below every layer row, in panel order. */
@@ -5647,7 +6022,7 @@ type LayerPanelGroupHeaders = {
  * @param groups Group definitions.
  * @returns The anchor layer (or the panel bottom) each header sits above.
  */
-declare function layerPanelGroupHeaders(layers: GeoLibreLayer[], groups: LayerGroup[]): LayerPanelGroupHeaders;
+export declare function layerPanelGroupHeaders(layers: GeoLibreLayer[], groups: LayerGroup[]): LayerPanelGroupHeaders;
 /**
  * Derive the layer-panel tree from the flat `layers` array and the group
  * definitions.
@@ -5667,7 +6042,7 @@ declare function layerPanelGroupHeaders(layers: GeoLibreLayer[], groups: LayerGr
  * @param groups Group definitions.
  * @returns Panel rows in top-to-bottom display order.
  */
-declare function buildLayerTree(layers: GeoLibreLayer[], groups: LayerGroup[]): LayerTreeItem[];
+export declare function buildLayerTree(layers: GeoLibreLayer[], groups: LayerGroup[]): LayerTreeItem[];
 /**
  * Fold each group's visibility and opacity into its child layers so the map
  * sync can keep treating every layer independently.
@@ -5682,7 +6057,7 @@ declare function buildLayerTree(layers: GeoLibreLayer[], groups: LayerGroup[]):
  * @param groups Group definitions.
  * @returns Layers with group effects applied.
  */
-declare function applyGroupEffects(layers: GeoLibreLayer[], groups: LayerGroup[]): GeoLibreLayer[];
+export declare function applyGroupEffects(layers: GeoLibreLayer[], groups: LayerGroup[]): GeoLibreLayer[];
 /**
  * The single layer form of {@link applyGroupEffects}: the visibility and
  * opacity a layer should actually render at once its (possibly nested) parent
@@ -5701,7 +6076,7 @@ declare function applyGroupEffects(layers: GeoLibreLayer[], groups: LayerGroup[]
  * @returns The effective render state (the layer's own values when it is
  *   ungrouped or its `groupId` is dangling).
  */
-declare function effectiveLayerRenderState(layer: GeoLibreLayer, groups: LayerGroup[] | ReadonlyMap<string, LayerGroup>): {
+export declare function effectiveLayerRenderState(layer: GeoLibreLayer, groups: LayerGroup[] | ReadonlyMap<string, LayerGroup>): {
   visible: boolean;
   opacity: number;
 };
@@ -5712,7 +6087,7 @@ declare function effectiveLayerRenderState(layer: GeoLibreLayer, groups: LayerGr
  * @param groupId Group whose members to locate.
  * @returns Ascending list of member indices (empty when the group has none).
  */
-declare function groupMemberIndices(layers: GeoLibreLayer[], groupId: string): number[];
+export declare function groupMemberIndices(layers: GeoLibreLayer[], groupId: string): number[];
 /**
  * Reorder `layers` so that every group's members form a single contiguous block,
  * preserving the relative order of layers within each group and of the
@@ -5726,7 +6101,7 @@ declare function groupMemberIndices(layers: GeoLibreLayer[], groupId: string): n
  * @param layers Flat layer list, possibly with interleaved group members.
  * @returns A new array with grouped layers made contiguous.
  */
-declare function normalizeGroupContiguity(layers: GeoLibreLayer[]): GeoLibreLayer[];
+export declare function normalizeGroupContiguity(layers: GeoLibreLayer[]): GeoLibreLayer[];
 /**
  * How deeply a group is nested: 0 for a top-level folder, 1 for a child of one,
  * and so on. Drives the layer panel's indentation and keeps a parent ahead of
@@ -5738,7 +6113,7 @@ declare function normalizeGroupContiguity(layers: GeoLibreLayer[]): GeoLibreLaye
  *   same set can pass a memoized map rather than rebuild one per call.
  * @returns The nesting depth.
  */
-declare function layerGroupDepth(group: LayerGroup, groupById: ReadonlyMap<string, LayerGroup>): number;
+export declare function layerGroupDepth(group: LayerGroup, groupById: ReadonlyMap<string, LayerGroup>): number;
 /**
  * Move a group — with everything nested inside it — one block up or down among
  * its siblings, the groups sharing its parent.
@@ -5778,7 +6153,7 @@ declare function layerGroupDepth(group: LayerGroup, groupById: ReadonlyMap<strin
  * @returns The new arrays, or `null` when the group is already at that end of
  *   the panel and nothing would change.
  */
-declare function reorderLayerGroupInPanel(layers: GeoLibreLayer[], groups: LayerGroup[], id: string, direction: "up" | "down"): {
+export declare function reorderLayerGroupInPanel(layers: GeoLibreLayer[], groups: LayerGroup[], id: string, direction: "up" | "down"): {
   layers: GeoLibreLayer[];
   groups: LayerGroup[];
 } | null;
@@ -5790,7 +6165,7 @@ declare function reorderLayerGroupInPanel(layers: GeoLibreLayer[], groups: Layer
  * @param groups Group definitions.
  * @returns Per-group flags, keyed by group id.
  */
-declare function layerGroupMoveability(layers: GeoLibreLayer[], groups: LayerGroup[]): Map<string, {
+export declare function layerGroupMoveability(layers: GeoLibreLayer[], groups: LayerGroup[]): Map<string, {
   up: boolean;
   down: boolean;
 }>;
@@ -5806,7 +6181,7 @@ declare function layerGroupMoveability(layers: GeoLibreLayer[], groups: LayerGro
  * @param value A decoded raster sample.
  * @returns The sample rendered for display.
  */
-declare function formatPixelValue(value: number): string;
+export declare function formatPixelValue(value: number): string;
 //#endregion
 //#region src/storymap-sample.d.ts
 /**
@@ -5818,20 +6193,65 @@ declare function formatPixelValue(value: number): string;
  *
  * @returns A populated {@link StoryMap} with five sample chapters.
  */
-declare function createSampleStoryMap(): StoryMap;
+export declare function createSampleStoryMap(): StoryMap;
+//#endregion
+//#region src/storymap-playback.d.ts
+/**
+ * The opacity a story presentation has applied to a layer.
+ *
+ * @param opacities The store's `ui.storymapLayerOpacity` record.
+ * @param layerId Store layer id.
+ * @returns The recorded opacity in `[0, 1]`, or `1` when the presentation has
+ *   not touched the layer (or nothing is presenting).
+ */
+export declare function storyLayerOpacityFactor(opacities: Record<string, number> | undefined, layerId: string): number;
+/**
+ * A layer whose opacity reflects the story presentation's fade.
+ *
+ * A chapter's opacity *replaces* the layer's own opacity rather than scaling
+ * it, matching `MapController.setStoryLayerOpacity`, which writes the chapter
+ * value as the absolute paint opacity; otherwise a layer set to 0.7 in the
+ * Layers panel and faded to 0.4 by a chapter would draw its diagrams at 0.28
+ * while its MapLibre layers draw at 0.4.
+ *
+ * Returns the same object when the presentation has not touched the layer (or
+ * recorded the opacity it already has), so identity-keyed caches downstream
+ * keep hitting.
+ *
+ * @param layer Store layer.
+ * @param opacities The store's `ui.storymapLayerOpacity` record.
+ */
+export declare function applyStoryLayerOpacity(layer: GeoLibreLayer, opacities: Record<string, number> | undefined): GeoLibreLayer;
+/**
+ * Whether a story presentation has faded a layer fully out.
+ *
+ * @param opacities The store's `ui.storymapLayerOpacity` record.
+ * @param layerId Store layer id.
+ */
+export declare function isStoryHiddenLayer(opacities: Record<string, number> | undefined, layerId: string): boolean;
+/**
+ * The layers a reader can currently see during a story presentation: the
+ * input minus those the active chapter has faded fully out. Outside a
+ * presentation the input is returned as-is (same array identity).
+ *
+ * @param layers Store layers in panel order.
+ * @param presenting The store's `ui.storymapPresenting` flag.
+ * @param opacities The store's `ui.storymapLayerOpacity` record.
+ */
+export declare function storyVisibleLayers(layers: GeoLibreLayer[], presenting: boolean, opacities: Record<string, number> | undefined): GeoLibreLayer[];
 //#endregion
 //#region src/layer-ref-scrub.d.ts
 /**
  * Filter out dashboard widgets whose `layerId` references a removed layer.
  * Returns the same array reference when nothing changes.
  */
-declare function scrubWidgetsForRemovedLayers(widgets: DashboardWidget[], layerIds: string | Iterable<string>): DashboardWidget[];
+export declare function scrubWidgetsForRemovedLayers(widgets: DashboardWidget[], layerIds: string | Iterable<string>): DashboardWidget[];
 /**
  * Drop comments whose anchor is a feature on a removed layer.
  * Point-anchored comments are always kept.
  * Returns the same array reference when nothing changes.
  */
-declare function scrubCommentsForRemovedLayers(comments: ProjectComment[], layerIds: string | Iterable<string>): ProjectComment[];
+export declare function scrubCommentsForRemovedLayers(comments: ProjectComment[], layerIds: string | Iterable<string>): ProjectComment[];
 /**
  * Scrub legend config of references to removed layers:
  * - `order`: filter out removed layer ids
@@ -5841,7 +6261,7 @@ declare function scrubCommentsForRemovedLayers(comments: ProjectComment[], layer
  *
  * Returns the same reference when nothing changes.
  */
-declare function scrubLegendForRemovedLayers(legend: LegendConfig, layerIds: string | Iterable<string>): LegendConfig;
+export declare function scrubLegendForRemovedLayers(legend: LegendConfig, layerIds: string | Iterable<string>): LegendConfig;
 //#endregion
 //#region src/storymap-io.d.ts
 /**
@@ -5850,7 +6270,7 @@ declare function scrubLegendForRemovedLayers(legend: LegendConfig, layerIds: str
  * @param storymap The story map to serialize.
  * @returns A JSON string (settings and chapters).
  */
-declare function serializeStoryMapJson(storymap: StoryMap): string;
+export declare function serializeStoryMapJson(storymap: StoryMap): string;
 /**
  * Parse a story map from JSON authored outside GeoLibre.
  *
@@ -5862,7 +6282,7 @@ declare function serializeStoryMapJson(storymap: StoryMap): string;
  * @returns A normalized story map.
  * @throws If the JSON is invalid or contains no usable chapters.
  */
-declare function parseStoryMapJson(text: string): StoryMap;
+export declare function parseStoryMapJson(text: string): StoryMap;
 /**
  * Serialize a story map's chapters to CSV (one row per chapter).
  *
@@ -5872,7 +6292,7 @@ declare function parseStoryMapJson(text: string): StoryMap;
  * @param storymap The story map whose chapters to serialize.
  * @returns A CSV string with a header row.
  */
-declare function serializeStoryMapCsv(storymap: StoryMap): string;
+export declare function serializeStoryMapCsv(storymap: StoryMap): string;
 /**
  * Parse chapters from a CSV authored outside GeoLibre.
  *
@@ -5886,7 +6306,7 @@ declare function serializeStoryMapCsv(storymap: StoryMap): string;
  * @returns A normalized story map.
  * @throws If the CSV has no data rows or no valid chapters.
  */
-declare function parseStoryMapCsv(text: string, base?: StoryMap | null): StoryMap;
+export declare function parseStoryMapCsv(text: string, base?: StoryMap | null): StoryMap;
 //#endregion
 //#region src/store.d.ts
 type ConversionToolKind = "vector-to-vector" | "vector-to-geoparquet" | "vector-to-flatgeobuf" | "vector-to-shapefile" | "vector-to-geopackage" | "csv-to-geoparquet" | "vector-to-pmtiles" | "raster-to-pmtiles" | "raster-to-cog";
@@ -5985,6 +6405,14 @@ interface AppState {
   secondaryMapViews: SecondaryMapView[];
   /** User-entered label for the primary pane (shown only in multi-map mode). */
   primaryMapLabel: string;
+  /**
+   * Which engine draws the primary map area (issue #2217): the 2D MapLibre map
+   * or the 3D Cesium globe. Both render the same store state, so switching
+   * keeps the camera, basemap, layers, groups, visibility, and opacity — it
+   * only changes what draws them. Independent of `mapLayout`: switching never
+   * adds or removes panes.
+   */
+  primaryRenderer: MapRendererKind;
   selectedLayerId: string | null;
   selectedFeatureId: string | null;
   /**
@@ -6072,6 +6500,15 @@ interface AppState {
     storymapPanelOpen: boolean;
     storymapPresenting: boolean;
     storymapReturnToEditor: boolean;
+    /**
+     * Layer opacities the active story presentation has applied so far, keyed
+     * by store layer id. Playback fades layers by writing MapLibre paint
+     * properties directly (never the persisted `layers[].opacity`), so this is
+     * how renderers outside MapLibre's paint model (deck.gl diagrams, 3D
+     * Z-value geometry) and the on-map Legend follow a chapter's fades. Empty
+     * while not presenting; never saved with the project.
+     */
+    storymapLayerOpacity: Record<string, number>;
     storymapComposingId: string | null;
     /** The Batch tools dialog (run one tool across many layers). */
     batchToolsOpen: boolean;
@@ -6127,6 +6564,12 @@ interface AppState {
   setSecondaryLayerVisibility: (id: string, layerId: string, visible: boolean) => void;
   /** Set the primary pane's custom label. */
   setPrimaryMapLabel: (label: string) => void;
+  /**
+   * Switch the primary map area between the 2D map and the 3D globe (no-op if
+   * unchanged). Touches nothing else in the store, so the shared camera, layer,
+   * and basemap state carries straight across the swap.
+   */
+  setPrimaryRenderer: (renderer: MapRendererKind) => void;
   /** Set one secondary pane's custom label (no-op if the id is unknown). */
   setSecondaryMapLabel: (id: string, label: string) => void;
   /**
@@ -6192,6 +6635,11 @@ interface AppState {
   setDashboardOpen: (open: boolean) => void;
   setStorymapPanelOpen: (open: boolean) => void;
   setStorymapPresenting: (presenting: boolean, returnToEditor?: boolean) => void;
+  /**
+   * Record the layer opacities a story chapter applied, merging into the
+   * presentation's running map (see `ui.storymapLayerOpacity`).
+   */
+  setStorymapLayerOpacity: (changes: Record<string, number>) => void;
   setStorymapComposing: (chapterId: string | null) => void;
   setBatchToolsOpen: (open: boolean) => void;
   setModelBuilderOpen: (open: boolean) => void;
@@ -6385,6 +6833,8 @@ interface AppState {
    * array to remove every control.
    */
   setLayerQuickFilters: (id: string, filters: LayerQuickFilter[]) => void;
+  /** Set or clear the project-persisted expression filter for a layer. */
+  setLayerFilterExpression: (id: string, expression: unknown[] | null) => void;
   reorderLayer: (id: string, direction: "up" | "down") => void;
   moveLayer: (id: string, targetIndex: number) => void;
   moveLayersRelative: (layerIds: string[], targetLayerId: string, position: "above" | "below") => void;
@@ -6448,27 +6898,27 @@ interface AppState {
   setComments: (comments: ProjectComment[]) => void;
 }
 /** Reserved Identify target for querying every visible queryable layer at once. */
-declare const IDENTIFY_ALL_LAYERS_ID = "__geolibre_identify_all_layers__";
+export declare const IDENTIFY_ALL_LAYERS_ID = "__geolibre_identify_all_layers__";
 /**
  * A fresh, inactive collaboration slice (no live session). Frozen (like
  * DEFAULT_LEGEND_CONFIG) to guard against accidental in-place mutation; store
  * actions always produce new objects via spread, so the frozen default is only
  * ever read.
  */
-declare const DEFAULT_COLLABORATION_STATE: CollaborationState;
+export declare const DEFAULT_COLLABORATION_STATE: CollaborationState;
 /** Derive a human-friendly display name from a file path or URL. */
-declare function projectPathLabel(path: string): string;
-declare function subscribeProjectRestoreHistory(listener: () => void): () => void;
-declare function canUndoProjectRestore(): boolean;
-declare function canRedoProjectRestore(): boolean;
+export declare function projectPathLabel(path: string): string;
+export declare function subscribeProjectRestoreHistory(listener: () => void): () => void;
+export declare function canUndoProjectRestore(): boolean;
+export declare function canRedoProjectRestore(): boolean;
 /**
  * Register a whole-project restore as one undoable operation. The regular
  * temporal history intentionally tracks only editing fields, while restoring a
  * history snapshot also changes project metadata, camera, plugins, and other
  * serialized state, so it needs a full canonical project pair.
  */
-declare function registerProjectRestoreHistory(before: GeoLibreProject, beforePath: string | null, after: GeoLibreProject, afterPath?: string | null): void;
-declare const useAppStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<AppState>, "temporal"> & {
+export declare function registerProjectRestoreHistory(before: GeoLibreProject, beforePath: string | null, after: GeoLibreProject, afterPath?: string | null): void;
+export declare const useAppStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<AppState>, "temporal"> & {
   temporal: import("zustand").StoreApi<import("zundo").TemporalState<{
     layers: GeoLibreLayer[];
     layerGroups: LayerGroup[];
@@ -6486,27 +6936,27 @@ declare const useAppStore: import("zustand").UseBoundStore<Omit<import("zustand"
  * `layers`/basemap refs drive MapCanvas's existing effects, so the map
  * reconciles through MapController.syncLayers (never mutated directly here).
  */
-declare function undo(): void;
+export declare function undo(): void;
 /** Step the history forward one entry and mark the project dirty. */
-declare function redo(): void;
+export declare function redo(): void;
 /** Empty both the undo and redo stacks (e.g. on new/loaded project). */
-declare function clearHistory(): void;
+export declare function clearHistory(): void;
 /**
  * React hook for consuming application capability state for a specific privilege.
  *
  * @param privilege - The privilege to check.
  * @returns `{ granted: boolean, reason?: string }`
  */
-declare function useAppCapability(privilege: AppPrivilege): {
+export declare function useAppCapability(privilege: AppPrivilege): {
   granted: boolean;
   reason?: string;
 };
 //#endregion
 //#region src/history.d.ts
-declare function setHistoryCoalesceMs(ms: number): void;
-declare function getHistoryCoalesceMs(): number;
-declare function setMaxHistoryFeatureCount(count: number): void;
-declare function getMaxHistoryFeatureCount(): number;
+export declare function setHistoryCoalesceMs(ms: number): void;
+export declare function getHistoryCoalesceMs(): number;
+export declare function setMaxHistoryFeatureCount(count: number): void;
+export declare function getMaxHistoryFeatureCount(): number;
 /** Structural shape of a partialized undo snapshot, for size accounting. */
 interface HistorySnapshot {
   layers?: {
@@ -6531,7 +6981,7 @@ interface HistorySnapshot {
  * Returns the original array when nothing needs trimming, or a trimmed slice
  * (oldest entries removed) otherwise. Pure: never mutates its input.
  */
-declare function trimHistoryBySize<T extends HistorySnapshot>(pastStates: T[], maxFeatures: number): T[];
+export declare function trimHistoryBySize<T extends HistorySnapshot>(pastStates: T[], maxFeatures: number): T[];
 //#endregion
 //#region src/geocoding.d.ts
 /**
@@ -6562,14 +7012,14 @@ declare function trimHistoryBySize<T extends HistorySnapshot>(pastStates: T[], m
  * via {@link setGeocodingFetch} — see the note there. See
  * docs/user-guide/data-integrations.md#geocoding.
  */
-declare const DEFAULT_FORWARD_GEOCODE_ENDPOINT = "https://nominatim.openstreetmap.org/search";
-declare const DEFAULT_REVERSE_GEOCODE_ENDPOINT = "https://nominatim.openstreetmap.org/reverse";
+export declare const DEFAULT_FORWARD_GEOCODE_ENDPOINT = "https://nominatim.openstreetmap.org/search";
+export declare const DEFAULT_REVERSE_GEOCODE_ENDPOINT = "https://nominatim.openstreetmap.org/reverse";
 /** Host whose public usage policy (1 req/sec, bulk limits) we must respect. */
-declare const NOMINATIM_PUBLIC_HOST = "nominatim.openstreetmap.org";
+export declare const NOMINATIM_PUBLIC_HOST = "nominatim.openstreetmap.org";
 /** Minimum spacing between requests to the public Nominatim endpoint. */
-declare const NOMINATIM_MIN_INTERVAL_MS = 1100;
+export declare const NOMINATIM_MIN_INTERVAL_MS = 1100;
 /** Host of the free, unkeyed public CartoCiudad geocoder (IGN/CNIG). */
-declare const CARTOCIUDAD_PUBLIC_HOST = "cartociudad.es";
+export declare const CARTOCIUDAD_PUBLIC_HOST = "cartociudad.es";
 /**
  * Courtesy spacing (~5 req/sec) between requests to the public CartoCiudad
  * endpoint. Unlike {@link NOMINATIM_MIN_INTERVAL_MS} this is not a published
@@ -6577,22 +7027,22 @@ declare const CARTOCIUDAD_PUBLIC_HOST = "cartociudad.es";
  * a large batch does not burst at a free public government service. See
  * {@link geocoderMinIntervalMs}.
  */
-declare const CARTOCIUDAD_MIN_INTERVAL_MS = 200;
+export declare const CARTOCIUDAD_MIN_INTERVAL_MS = 200;
 /** Max rows a single batch run will geocode against the public endpoint. */
-declare const PUBLIC_GEOCODE_ROW_CAP = 1000;
+export declare const PUBLIC_GEOCODE_ROW_CAP = 1000;
 /** Property keys added to each geocoded feature. */
-declare const GEOCODE_LAT_KEY = "geocode_lat";
-declare const GEOCODE_LON_KEY = "geocode_lon";
-declare const GEOCODE_DISPLAY_NAME_KEY = "geocode_display_name";
-declare const GEOCODE_SCORE_KEY = "geocode_importance";
+export declare const GEOCODE_LAT_KEY = "geocode_lat";
+export declare const GEOCODE_LON_KEY = "geocode_lon";
+export declare const GEOCODE_DISPLAY_NAME_KEY = "geocode_display_name";
+export declare const GEOCODE_SCORE_KEY = "geocode_importance";
 /** Provider id that produced (or failed to produce) a match, when stamped. */
-declare const GEOCODE_PROVIDER_KEY = "geocode_provider";
+export declare const GEOCODE_PROVIDER_KEY = "geocode_provider";
 /** Whether a row matched, when stamped. See {@link GeocodeStatus}. */
-declare const GEOCODE_STATUS_KEY = "geocode_status";
+export declare const GEOCODE_STATUS_KEY = "geocode_status";
 /** Identifier of a selectable geocoding backend. */
 type GeocodingProviderId = "nominatim" | "pelias" | "arcgis" | "mapbox" | "google" | "cartociudad";
 /** The provider used when none is configured. */
-declare const DEFAULT_GEOCODING_PROVIDER_ID: GeocodingProviderId;
+export declare const DEFAULT_GEOCODING_PROVIDER_ID: GeocodingProviderId;
 interface GeocoderConfig {
   /** Which backend to dispatch through. */
   providerId: GeocodingProviderId;
@@ -6703,12 +7153,12 @@ interface ReverseGeocodeDisplay {
 /** Whether a row matched during batch geocoding, stamped as {@link GEOCODE_STATUS_KEY}. */
 type GeocodeStatus = "matched" | "unmatched";
 /** Build a Nominatim forward-geocoding URL (jsonv2, address details on). */
-declare function buildForwardGeocodeUrl(endpoint: string, query: string, options?: {
+export declare function buildForwardGeocodeUrl(endpoint: string, query: string, options?: {
   email?: string;
   limit?: number;
 }): string;
 /** Build a Nominatim reverse-geocoding URL (jsonv2, address details on). */
-declare function buildReverseGeocodeUrl(endpoint: string, lon: number, lat: number, options?: {
+export declare function buildReverseGeocodeUrl(endpoint: string, lon: number, lat: number, options?: {
   email?: string;
   zoom?: number;
 }): string;
@@ -6724,7 +7174,7 @@ declare function buildReverseGeocodeUrl(endpoint: string, lon: number, lat: numb
  * `geocode_status: "matched"` (dropped when omitted, so the existing
  * `GeocodeDialog` call site keeps its current output unchanged).
  */
-declare function geocodeMatchToFeature(match: GeocodeMatch, originalRow?: Record<string, string>, extra?: {
+export declare function geocodeMatchToFeature(match: GeocodeMatch, originalRow?: Record<string, string>, extra?: {
   providerId?: GeocodingProviderId;
 }): Feature<Point> | null;
 /**
@@ -6735,25 +7185,25 @@ declare function geocodeMatchToFeature(match: GeocodeMatch, originalRow?: Record
  * `geocode_provider`, de-duplicated against the original columns the same way
  * {@link geocodeMatchToFeature} does.
  */
-declare function unmatchedGeocodeFeature(originalRow: Record<string, string>, providerId: GeocodingProviderId): Feature<null>;
+export declare function unmatchedGeocodeFeature(originalRow: Record<string, string>, providerId: GeocodingProviderId): Feature<null>;
 /**
  * Convert a Nominatim forward result into a point Feature. Retained as a thin
  * wrapper over {@link geocodeMatchToFeature} for callers and tests that work
  * directly with Nominatim results. Returns null when the result has no finite
  * coordinates.
  */
-declare function nominatimResultToFeature(result: NominatimForwardResult, originalRow?: Record<string, string>): Feature<Point> | null;
+export declare function nominatimResultToFeature(result: NominatimForwardResult, originalRow?: Record<string, string>): Feature<Point> | null;
 /**
  * Resolve a Nominatim reverse result to a display string and address parts, or
  * null when the point could not be reverse-geocoded.
  */
-declare function nominatimReverseResultToDisplay(result: NominatimReverseResult | null): ReverseGeocodeDisplay | null;
+export declare function nominatimReverseResultToDisplay(result: NominatimReverseResult | null): ReverseGeocodeDisplay | null;
 /** All selectable geocoding providers, Nominatim first (the default). */
-declare const GEOCODING_PROVIDERS: readonly GeocodingProvider[];
+export declare const GEOCODING_PROVIDERS: readonly GeocodingProvider[];
 /** Coerce an arbitrary string to a known provider id, defaulting to Nominatim. */
-declare function normalizeGeocodingProviderId(value: string | undefined | null): GeocodingProviderId;
+export declare function normalizeGeocodingProviderId(value: string | undefined | null): GeocodingProviderId;
 /** Look up a provider by id, falling back to Nominatim for unknown ids. */
-declare function getGeocodingProvider(id: string | undefined | null): GeocodingProvider;
+export declare function getGeocodingProvider(id: string | undefined | null): GeocodingProvider;
 /**
  * Resolve the geocoder configuration from runtime env, falling back to the
  * selected provider's default endpoints. `VITE_GEOCODER_PROVIDER` selects the
@@ -6761,7 +7211,7 @@ declare function getGeocodingProvider(id: string | undefined | null): GeocodingP
  * the endpoints; `VITE_GEOCODER_EMAIL` supplies the contact email; and
  * `VITE_GEOCODER_API_KEY` supplies the API key for keyed providers.
  */
-declare function getGeocoderConfig(): GeocoderConfig;
+export declare function getGeocoderConfig(): GeocoderConfig;
 /** Inputs to {@link resolveGeocoderConfig}, mirroring the project preference. */
 interface GeocodingPreferenceInput {
   providerId?: string;
@@ -6778,7 +7228,7 @@ interface GeocodingPreferenceInput {
  * the geocode dialog so a per-run provider choice resolves the right endpoints
  * and API key without round-tripping through runtime env.
  */
-declare function resolveGeocoderConfig(input: GeocodingPreferenceInput): GeocoderConfig;
+export declare function resolveGeocoderConfig(input: GeocodingPreferenceInput): GeocoderConfig;
 /**
  * Whether requests to `endpoint` must be throttled AND row-capped. True for the
  * public Nominatim host (its usage policy applies) and, defensively, for any
@@ -6789,7 +7239,7 @@ declare function resolveGeocoderConfig(input: GeocodingPreferenceInput): Geocode
  * see {@link geocoderMinIntervalMs}, which paces CartoCiudad more gently
  * without capping its row count.
  */
-declare function shouldThrottle(endpoint: string): boolean;
+export declare function shouldThrottle(endpoint: string): boolean;
 /**
  * The row cap to apply for `endpoint`: a finite cap for the public Nominatim
  * host, else Infinity. CartoCiudad is uncapped — IGN publishes no row limit and
@@ -6797,7 +7247,7 @@ declare function shouldThrottle(endpoint: string): boolean;
  * cap here would be an invented constraint. It is still paced; see
  * {@link geocoderMinIntervalMs}.
  */
-declare function rowCap(endpoint: string): number;
+export declare function rowCap(endpoint: string): number;
 /**
  * Minimum spacing (ms) between requests for `endpoint`. Gated on the hostname,
  * not the selected provider, so pointing any provider at the public Nominatim
@@ -6812,28 +7262,28 @@ declare function rowCap(endpoint: string): number;
  * not borrowed here. Keyed providers and self-hosted endpoints are paced by
  * their own quotas, not by us.
  */
-declare function geocoderMinIntervalMs(endpoint: string): number;
+export declare function geocoderMinIntervalMs(endpoint: string): number;
 /**
  * Whether `config` cannot geocode without an API key. True for the keyed
  * providers (ArcGIS, Mapbox, Google) and for Pelias only when it targets the
  * hosted geocode.earth endpoint (a self-hosted Pelias needs no key). Drives the
  * batch dialog's "missing key" warning and disabled run.
  */
-declare function geocoderNeedsApiKey(config: GeocoderConfig): boolean;
+export declare function geocoderNeedsApiKey(config: GeocoderConfig): boolean;
 /**
  * Milliseconds to wait before starting the next request so consecutive
  * requests are spaced at least `intervalMs` apart, measured from the previous
  * request's start time (not its completion) so a slow network does not double
  * the wait. Returns 0 for the first request or when enough time has elapsed.
  */
-declare function nextDelayMs(lastStartedAt: number | null, now: number, intervalMs: number): number;
+export declare function nextDelayMs(lastStartedAt: number | null, now: number, intervalMs: number): number;
 /**
  * Build geocoding requests from parsed CSV rows. The address for each row is
  * the selected columns trimmed and joined with ", " (so multi-part addresses
  * like street/city/country can be combined). Rows whose composed address is
  * empty are skipped.
  */
-declare function csvRowsToGeocodeRequests(rows: Record<string, string>[], addressColumns: string[]): GeocodeRequest[];
+export declare function csvRowsToGeocodeRequests(rows: Record<string, string>[], addressColumns: string[]): GeocodeRequest[];
 /**
  * Override the fetch used for geocoding requests, or pass null to restore the
  * global browser `fetch`.
@@ -6850,12 +7300,12 @@ declare function csvRowsToGeocodeRequests(rows: Record<string, string>[], addres
  *
  * Safe to call multiple times; only the most recent implementation is used.
  */
-declare function setGeocodingFetch(fetchImpl: typeof globalThis.fetch | null): void;
+export declare function setGeocodingFetch(fetchImpl: typeof globalThis.fetch | null): void;
 /**
  * Forward-geocode a single query through the configured provider, returning
  * normalized matches.
  */
-declare function geocodeForward(query: string, options?: {
+export declare function geocodeForward(query: string, options?: {
   signal?: AbortSignal;
   config?: GeocoderConfig;
   limit?: number;
@@ -6864,7 +7314,7 @@ declare function geocodeForward(query: string, options?: {
  * Reverse-geocode a single point ([lon, lat]) through the configured provider,
  * returning a normalized display result or null when no address was found.
  */
-declare function geocodeReverse(lon: number, lat: number, options?: {
+export declare function geocodeReverse(lon: number, lat: number, options?: {
   signal?: AbortSignal;
   config?: GeocoderConfig;
   zoom?: number;
@@ -6893,14 +7343,14 @@ declare function geocodeReverse(lon: number, lat: number, options?: {
  *
  * @returns The build-time environment record.
  */
-declare function getBuildEnvironment(): Record<string, string | undefined>;
+export declare function getBuildEnvironment(): Record<string, string | undefined>;
 /**
  * Merges build-time env with project runtime env (the latter wins). Falls back
  * to build-time env alone outside a browser (e.g. in tests).
  *
  * @returns The resolved environment variables.
  */
-declare function getRuntimeEnvironment(): Record<string, string | undefined>;
+export declare function getRuntimeEnvironment(): Record<string, string | undefined>;
 /**
  * Resolves a local DuckDB spatial extension path from the runtime environment.
  *
@@ -6915,7 +7365,7 @@ declare function getRuntimeEnvironment(): Record<string, string | undefined>;
  *   injectable for testing.
  * @returns The trimmed extension path, or undefined when unset.
  */
-declare function getSpatialExtensionPath(env?: Record<string, string | undefined>): string | undefined;
+export declare function getSpatialExtensionPath(env?: Record<string, string | undefined>): string | undefined;
 /**
  * Resolves the Protomaps API key from the runtime environment.
  *
@@ -6928,7 +7378,7 @@ declare function getSpatialExtensionPath(env?: Record<string, string | undefined
  *   injectable for testing.
  * @returns The trimmed API key, or undefined when unset.
  */
-declare function getProtomapsApiKey(env?: Record<string, string | undefined>): string | undefined;
+export declare function getProtomapsApiKey(env?: Record<string, string | undefined>): string | undefined;
 /**
  * Resolves the Google Maps API key from the runtime environment.
  *
@@ -6944,7 +7394,7 @@ declare function getProtomapsApiKey(env?: Record<string, string | undefined>): s
  *   injectable for testing.
  * @returns The trimmed API key, or undefined when unset.
  */
-declare function getGoogleMapsApiKey(env?: Record<string, string | undefined>): string | undefined;
+export declare function getGoogleMapsApiKey(env?: Record<string, string | undefined>): string | undefined;
 /**
  * Resolves the Mapbox access token from the runtime environment.
  *
@@ -6969,7 +7419,7 @@ declare function getGoogleMapsApiKey(env?: Record<string, string | undefined>):
  *   injectable for testing.
  * @returns The trimmed token, or undefined when unset.
  */
-declare function getMapboxAccessToken(env?: Record<string, string | undefined>): string | undefined;
+export declare function getMapboxAccessToken(env?: Record<string, string | undefined>): string | undefined;
 /**
  * Resolves the Cesium Ion access token from the runtime environment.
  *
@@ -6990,7 +7440,7 @@ declare function getMapboxAccessToken(env?: Record<string, string | undefined>):
  *   injectable for testing.
  * @returns The trimmed token, or undefined when unset.
  */
-declare function getCesiumIonToken(env?: Record<string, string | undefined>): string | undefined;
+export declare function getCesiumIonToken(env?: Record<string, string | undefined>): string | undefined;
 /**
  * Builds a full Protomaps v5 style URL for a flavor, injecting the API key.
  *
@@ -7000,7 +7450,7 @@ declare function getCesiumIonToken(env?: Record<string, string | undefined>): st
  *   injectable for testing.
  * @returns The resolved style URL, or undefined when no API key is configured.
  */
-declare function getProtomapsStyleUrl(flavor: string, env?: Record<string, string | undefined>): string | undefined;
+export declare function getProtomapsStyleUrl(flavor: string, env?: Record<string, string | undefined>): string | undefined;
 //#endregion
 //#region src/platform.d.ts
 /**
@@ -7025,22 +7475,128 @@ declare function getProtomapsStyleUrl(flavor: string, env?: Record<string, strin
  *   runtime does not provide it (Node exposes a `navigator` without it).
  * @returns True when the UA claims macOS but the device reports multi-touch.
  */
-declare function isIpadDesktopUserAgent(userAgent: string, maxTouchPoints: number | undefined): boolean;
+export declare function isIpadDesktopUserAgent(userAgent: string, maxTouchPoints: number | undefined): boolean;
+//#endregion
+//#region src/cesium-ion.d.ts
+/** `metadata.sourceKind` of a layer that references a Cesium Ion asset. */
+export declare const CESIUM_ION_SOURCE_KIND = "cesium-ion";
+/** What an Ion asset id resolves to on the globe. */
+type CesiumIonAssetKind = "3d-tiles" | "imagery";
+/** Cesium OSM Buildings, the one-click 3D Tiles asset every Ion account can use. */
+export declare const CESIUM_OSM_BUILDINGS_ASSET_ID = 96188;
+/** Bing Maps Aerial through Ion, the imagery asset every Ion account can use. */
+export declare const CESIUM_BING_AERIAL_ASSET_ID = 2;
+/** Ion assets offered as one-click picks in the Add Data dialog. */
+export declare const CESIUM_ION_QUICK_PICKS: ReadonlyArray<{
+  assetId: number;
+  kind: CesiumIonAssetKind;
+  name: string;
+}>;
+/** Parse an Ion asset id the way the Add Data form and the project file carry it. */
+export declare function parseCesiumIonAssetId(value: unknown): number | null;
+/**
+ * The Ion asset id a layer references, or null when the layer is not an Ion
+ * asset layer (or carries no usable id).
+ */
+export declare function cesiumIonAssetId(layer: Pick<GeoLibreLayer, "source" | "metadata">): number | null;
+/** Whether `layer` references a Cesium Ion asset. */
+export declare function isCesiumIonLayer(layer: Pick<GeoLibreLayer, "source" | "metadata">): boolean;
+/** What the Ion asset draws as: a tileset primitive or an imagery layer. */
+export declare function cesiumIonAssetKind(layer: Pick<GeoLibreLayer, "type">): CesiumIonAssetKind;
+/**
+ * Whether only the 3D globe can render `layer`: the mirror of the globe's
+ * `isCesiumSupportedLayerType`, for the Layers panel to badge on the 2D map.
+ */
+export declare function isCesiumOnlyLayer(layer: Pick<GeoLibreLayer, "source" | "metadata">): boolean;
+interface CesiumIonLayerOptions {
+  id?: string;
+  name: string;
+  assetId: number;
+  kind: CesiumIonAssetKind;
+  /** Metres to shift a tileset vertically; ignored for imagery. */
+  altitudeOffset?: number;
+}
+/**
+ * Build the store layer for a Cesium Ion asset. A tileset is a `3d-tiles`
+ * layer whose `sourceKind` keeps it out of the 2D deck.gl control; imagery is
+ * a `raster` layer with no tiles, marked external so the 2D sync leaves it
+ * alone. Both persist only the asset id: the token is runtime configuration.
+ */
+export declare function createCesiumIonLayer(options: CesiumIonLayerOptions): GeoLibreLayer;
+//#endregion
+//#region src/czml.d.ts
+/**
+ * CZML (Cesium Language) domain models and layer authoring (issue #2290).
+ *
+ * CZML is a JSON-based format for describing dynamic, time-varying 3D geospatial
+ * scenes on the Cesium globe (trajectories, satellites, vehicles, sensor
+ * networks, moving entities with orientations and paths). The globe loads CZML
+ * natively through `CzmlDataSource`; the 2D map has no equivalent, so CZML
+ * layers are badged "3D only" there.
+ */
+/** `metadata.sourceKind` of a layer that carries or references CZML data. */
+export declare const CZML_SOURCE_KIND = "czml";
+/** One CZML packet in a document stream. */
+type CzmlPacket = Record<string, unknown>;
+/** A CZML document represented as an array of packets. */
+type CzmlDocument = CzmlPacket[];
+/** One-click CZML samples offered in the Add Data dialog. */
+export declare const CZML_QUICK_PICKS: ReadonlyArray<{
+  name: string;
+  data: CzmlPacket[];
+}>;
+/**
+ * Parse and validate a CZML payload from a JSON string or raw object.
+ * Returns an array of CZML packets or null when the input is malformed.
+ */
+export declare function parseCzml(value: unknown): CzmlPacket[] | null;
+/**
+ * Whether `layer` represents a CZML dynamic 3D scene.
+ */
+export declare function isCzmlLayer(layer: Pick<GeoLibreLayer, "source" | "metadata">): boolean;
+/** Extracted CZML source definition for a layer. */
+interface CzmlSource {
+  url?: string;
+  data?: CzmlPacket[] | string;
+}
+/**
+ * Extract the CZML content and/or URL from a layer, or null if not a CZML layer.
+ */
+export declare function czmlSource(layer: Pick<GeoLibreLayer, "source" | "metadata">): CzmlSource | null;
+/**
+ * Options for constructing a CZML layer.
+ */
+interface CzmlLayerOptions {
+  /** Optional layer id; defaults to a new UUID. */
+  id?: string;
+  /** Display name of the layer in the Layers panel. */
+  name: string;
+  /** Inlined CZML packet array or serialized JSON string. */
+  data?: CzmlPacket[] | string;
+  /** Remote URL pointing to a .czml document. */
+  url?: string;
+  /** Local path when loaded from disk. */
+  sourcePath?: string;
+}
+/**
+ * Build a typed GeoLibreLayer representing a CZML dynamic scene on the Cesium globe.
+ */
+export declare function createCzmlLayer(options: CzmlLayerOptions): GeoLibreLayer;
 //#endregion
 //#region src/three-d-tiles.d.ts
 /** Header Google's tile server expects the Maps API key in. */
-declare const GOOGLE_MAPS_API_KEY_HEADER = "X-GOOG-API-KEY";
+export declare const GOOGLE_MAPS_API_KEY_HEADER = "X-GOOG-API-KEY";
 /** Whether `url` points at Google's Photorealistic 3D Tiles root tileset. */
-declare function isGooglePhotorealisticTilesetUrl(url: string): boolean;
+export declare function isGooglePhotorealisticTilesetUrl(url: string): boolean;
 /** Drop the `X-GOOG-API-KEY` header (case-insensitive), keeping the rest. */
-declare function stripGoogleMapsApiKeyHeader(headers: Record<string, string> | undefined): Record<string, string> | undefined;
+export declare function stripGoogleMapsApiKeyHeader(headers: Record<string, string> | undefined): Record<string, string> | undefined;
 /**
  * The real `X-GOOG-API-KEY` value from `headers`, or `undefined` when absent,
  * blank, or a masked placeholder.
  */
-declare function googleMapsApiKeyHeaderValue(headers: Record<string, string> | undefined): string | undefined;
+export declare function googleMapsApiKeyHeaderValue(headers: Record<string, string> | undefined): string | undefined;
 /** Collapse an empty record to `undefined`, otherwise pass it through. */
-declare function nonEmptyRecord(value: Record<string, string> | undefined): Record<string, string> | undefined;
+export declare function nonEmptyRecord(value: Record<string, string> | undefined): Record<string, string> | undefined;
 /**
  * Resolve the request headers a 3D Tiles layer should load with. For non-Google
  * tilesets the headers pass through unchanged. For Google Photorealistic tiles
@@ -7048,7 +7604,7 @@ declare function nonEmptyRecord(value: Record<string, string> | undefined): Reco
  * the given headers, the `googleMapsApiKey` argument, then `getGoogleMapsApiKey()`
  * (runtime env). Returns `undefined` when there is nothing to send.
  */
-declare function resolveThreeDTilesRequestHeaders(url: string, headers: Record<string, string> | undefined, googleMapsApiKey?: string): Record<string, string> | undefined;
+export declare function resolveThreeDTilesRequestHeaders(url: string, headers: Record<string, string> | undefined, googleMapsApiKey?: string): Record<string, string> | undefined;
 /**
  * The request headers to persist on a 3D Tiles layer record. Non-Google
  * tilesets keep their headers; Google Photorealistic tiles keep any non-key
@@ -7056,7 +7612,7 @@ declare function resolveThreeDTilesRequestHeaders(url: string, headers: Record<s
  * projects do not carry the key in plain text (it is re-injected at render
  * time by `resolveThreeDTilesRequestHeaders`).
  */
-declare function persistedThreeDTilesRequestHeaders(url: string, headers: Record<string, string> | undefined): Record<string, string> | undefined;
+export declare function persistedThreeDTilesRequestHeaders(url: string, headers: Record<string, string> | undefined): Record<string, string> | undefined;
 //#endregion
 //#region src/credentials.d.ts
 /**
@@ -7064,7 +7620,7 @@ declare function persistedThreeDTilesRequestHeaders(url: string, headers: Record
  * schema-level inventory. Keep the explicit preference/plugin handling in
  * redactProjectCredentials in sync when adding entries outside layer config.
  */
-declare const PROJECT_CREDENTIAL_FIELDS: {
+export declare const PROJECT_CREDENTIAL_FIELDS: {
   readonly preferences: readonly ["environmentVariables", "geocoding.apiKeys"];
   readonly layerConfiguration: readonly ["requestHeaders", "headers", "authorization", "apiKey", "apiKeys", "accessToken", "token", "password", "clientSecret", "connectionString", "secret", "bearer", "auth", "authKey", "sasToken", "subscriptionKey", "signature", "pwd"];
   readonly pluginState: readonly ["plugins.settings"];
@@ -7087,7 +7643,7 @@ declare const PROJECT_CREDENTIAL_FIELDS: {
  * like any unknown blob. Mirrored by `PUBLISHABLE_PLUGIN_SETTINGS` in
  * `python/src/geolibre/project.py`; the two must agree.
  */
-declare const PUBLISHABLE_PLUGIN_SETTINGS: Readonly<Record<string, readonly string[] | null>>;
+export declare const PUBLISHABLE_PLUGIN_SETTINGS: Readonly<Record<string, readonly string[] | null>>;
 interface CredentialRedactionResult {
   project: GeoLibreProject;
   /** Stable project paths removed or rewritten by the redaction pass. */
@@ -7118,14 +7674,14 @@ interface CredentialRedactionResult {
  * dialog's readiness check) scans exactly as deep as this pass does, instead of
  * keeping a second, shallower cap that would silently disagree.
  */
-declare const MAX_REDACT_DEPTH = 12;
+export declare const MAX_REDACT_DEPTH = 12;
 /** Whether an object key in layer/plugin configuration holds a credential. */
-declare function isCredentialFieldName(name: string): boolean;
+export declare function isCredentialFieldName(name: string): boolean;
 /**
  * Remove credentials from URL-shaped values without encoding tile-template
  * placeholders such as `{z}/{x}/{y}`.
  */
-declare function redactUrlCredentials(value: string): string;
+export declare function redactUrlCredentials(value: string): string;
 /**
  * Return a detached project safe for any external egress.
  *
@@ -7140,24 +7696,24 @@ declare function redactUrlCredentials(value: string): string;
  * positions stay intact so recipients can still load and configure the plugin
  * themselves.
  */
-declare function redactProjectCredentials(project: GeoLibreProject): CredentialRedactionResult;
+export declare function redactProjectCredentials(project: GeoLibreProject): CredentialRedactionResult;
 /** Convenience wrapper for callers that only need the safe project. */
-declare function redactCredentials(project: GeoLibreProject): GeoLibreProject;
+export declare function redactCredentials(project: GeoLibreProject): GeoLibreProject;
 //#endregion
 //#region src/visibility.d.ts
 /**
  * Returns a new FeatureCollection with properties marked as "excluded" removed.
  */
-declare function excludeHiddenFieldsFromGeojson(geojson: FeatureCollection, fieldVisibility?: Record<string, FieldVisibility>): FeatureCollection;
+export declare function excludeHiddenFieldsFromGeojson(geojson: FeatureCollection, fieldVisibility?: Record<string, FieldVisibility>): FeatureCollection;
 /**
  * Returns a new GeoLibreProject where all layers have their excluded fields
  * physically removed from their inline GeoJSON.
  */
-declare function excludeHiddenFieldsFromProject(project: GeoLibreProject): GeoLibreProject;
+export declare function excludeHiddenFieldsFromProject(project: GeoLibreProject): GeoLibreProject;
 //#endregion
 //#region src/editor-tracking.d.ts
 /** Default field names for maintained editor tracking columns. */
-declare const DEFAULT_EDITOR_TRACKING_CONFIG: Required<EditorTrackingConfig>;
+export declare const DEFAULT_EDITOR_TRACKING_CONFIG: Required<EditorTrackingConfig>;
 /**
  * Identity written to the author fields when nothing better is known.
  *
@@ -7165,7 +7721,7 @@ declare const DEFAULT_EDITOR_TRACKING_CONFIG: Required<EditorTrackingConfig>;
  * value that changes with the UI language would make the same editor appear as
  * several different people across a project's history.
  */
-declare const DEFAULT_EDITOR_IDENTITY = "local-user";
+export declare const DEFAULT_EDITOR_IDENTITY = "local-user";
 /**
  * `localStorage` key holding the display name this browser edits under.
  *
@@ -7173,7 +7729,7 @@ declare const DEFAULT_EDITOR_IDENTITY = "local-user";
  * here, so a user who has introduced themselves once is recognized by both
  * features instead of being prompted twice.
  */
-declare const EDITOR_IDENTITY_STORAGE_KEY = "geolibre_author_name";
+export declare const EDITOR_IDENTITY_STORAGE_KEY = "geolibre_author_name";
 /**
  * Choose the identity to stamp, most authoritative source first.
  *
@@ -7186,17 +7742,17 @@ declare const EDITOR_IDENTITY_STORAGE_KEY = "geolibre_author_name";
  * @param storedName Locally configured display name.
  * @returns A non-empty identity string.
  */
-declare function pickEditorIdentity(collabName?: string | null, storedName?: string | null): string;
+export declare function pickEditorIdentity(collabName?: string | null, storedName?: string | null): string;
 /**
  * The four maintained column names, or `null` when tracking is off or the
  * configuration is unusable. Ordered created-then-edited so callers that render
  * the columns get a stable, meaningful order.
  */
-declare function editorTrackingFieldNames(config?: EditorTrackingConfig): string[] | null;
+export declare function editorTrackingFieldNames(config?: EditorTrackingConfig): string[] | null;
 /**
  * Options for editor tracking stamping functions.
  */
-interface EditorTrackingStampOptions {
+export interface EditorTrackingStampOptions {
   /** Optional custom editor tracking field configuration. */
   config?: EditorTrackingConfig;
   /**
@@ -7210,20 +7766,20 @@ interface EditorTrackingStampOptions {
 /**
  * Fully resolve an {@link EditorTrackingConfig} with fallback default field names.
  */
-declare function resolveEditorTrackingConfig(config?: EditorTrackingConfig): Required<EditorTrackingConfig>;
+export declare function resolveEditorTrackingConfig(config?: EditorTrackingConfig): Required<EditorTrackingConfig>;
 /**
  * Check whether a field name corresponds to one of the maintained editor tracking columns.
  *
  * Returns `false` for an invalid config, so callers can use this as a plain predicate.
  */
-declare function isMaintainedEditorTrackingField(fieldName: string, config?: EditorTrackingConfig): boolean;
+export declare function isMaintainedEditorTrackingField(fieldName: string, config?: EditorTrackingConfig): boolean;
 /**
  * Ensure all configured editor tracking field names are included in a field list.
  *
  * Returns the list unchanged for an invalid config, matching
  * {@link isMaintainedEditorTrackingField}.
  */
-declare function ensureEditorTrackingFields(fields: string[], config?: EditorTrackingConfig): string[];
+export declare function ensureEditorTrackingFields(fields: string[], config?: EditorTrackingConfig): string[];
 /**
  * Stamp editor tracking metadata onto a feature's properties object.
  *
@@ -7239,15 +7795,15 @@ declare function ensureEditorTrackingFields(fields: string[], config?: EditorTra
  * On `"update"`: sets `edited_by`/`edited_at` and preserves `created_by` /
  * `created_at`, which record something this edit did not change.
  */
-declare function stampFeaturePropertiesEditorTracking(properties: Record<string, unknown> | null | undefined, action: "create" | "update", options?: EditorTrackingStampOptions): Record<string, unknown>;
+export declare function stampFeaturePropertiesEditorTracking(properties: Record<string, unknown> | null | undefined, action: "create" | "update", options?: EditorTrackingStampOptions): Record<string, unknown>;
 /**
  * Stamp editor tracking metadata onto a GeoJSON {@link Feature}.
  */
-declare function stampFeatureEditorTracking<T extends Feature>(feature: T, action: "create" | "update", options?: EditorTrackingStampOptions): T;
+export declare function stampFeatureEditorTracking<T extends Feature>(feature: T, action: "create" | "update", options?: EditorTrackingStampOptions): T;
 /**
  * Stamp editor tracking metadata onto all features in a {@link FeatureCollection}.
  */
-declare function stampFeatureCollectionEditorTracking(collection: FeatureCollection, action: "create" | "update", options?: EditorTrackingStampOptions): FeatureCollection;
+export declare function stampFeatureCollectionEditorTracking(collection: FeatureCollection, action: "create" | "update", options?: EditorTrackingStampOptions): FeatureCollection;
 //#endregion
 //#region src/editor-identity.d.ts
 /**
@@ -7266,12 +7822,12 @@ declare function stampFeatureCollectionEditorTracking(collection: FeatureCollect
  * iframe), so a failure here has to read as "no name set" — an editor whose
  * browser refuses storage must still be able to edit.
  */
-declare function readStoredAuthorName(): string;
+export declare function readStoredAuthorName(): string;
 /**
  * Persist the display name to edit under. A blank name clears it, so the user
  * can go back to the anonymous default rather than being stuck with a typo.
  */
-declare function setStoredAuthorName(name: string): void;
+export declare function setStoredAuthorName(name: string): void;
 /**
  * The identity to stamp on edits made right now: the collaboration session's
  * name when one is active, else the locally configured name, else the anonymous
@@ -7279,7 +7835,29 @@ declare function setStoredAuthorName(name: string): void;
  *
  * @returns A non-empty identity string.
  */
-declare function currentEditorIdentity(): string;
+export declare function currentEditorIdentity(): string;
+//#endregion
+//#region src/cesium-kml.d.ts
+/** Native KML/KMZ documents retain their own styling on the globe. */
+export declare const CESIUM_KML_SOURCE_KIND = "cesium-kml";
+export declare function isCesiumKmlLayer(layer: Pick<GeoLibreLayer, "metadata">): boolean;
+interface CesiumKmlLayerOptions {
+  id?: string;
+  name: string;
+  /** HTTP(S) KML or KMZ URL. Relative resources resolve against this URL. */
+  url?: string;
+  /** Inline XML, or a KMZ data URL so local archives survive project saves. */
+  data?: string;
+  sourcePath?: string;
+}
+export declare function cesiumKmlSource(layer: Pick<GeoLibreLayer, "source" | "metadata">): string | null;
+export declare function createCesiumKmlLayer(options: CesiumKmlLayerOptions): GeoLibreLayer;
+//#endregion
+//#region src/file-name.d.ts
+/** Extract a display filename without changing the source used for file access. */
+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 { ALL_APP_PRIVILEGES, ALL_DEPLOYMENT_CAPABILITIES, AddTileLayerOptions, AppCapabilities, AppPrivilege, AppRole, type AppState, ApplyLayerJoinsResult, ApplyVirtualFieldsResult, AttributeFormConfig, AttributeFormEvalOptions, AttributeFormFieldConfig, AttributeFormFieldError, AttributeFormValidation, AttributeFormValueMapEntry, AttributeFormWidget, BLANK_BASEMAP, BLEND_MODES, BUILT_IN_STYLE_PRESETS, BlendMode, CARTOCIUDAD_MIN_INTERVAL_MS, CARTOCIUDAD_PUBLIC_HOST, CHINA_BASEMAPS, CesiumBasemapImagery, CollabInvite, CollaborationChatMessage, CollaborationMode, CollaborationParticipant, CollaborationPresence, CollaborationRole, CollaborationState, ColorRamp, CommentAnchor, CommentAuthor, CommentReply, CompiledFeatureExpression, type ConversionToolKind, CopiedLayerStyle, CopiedRasterStyle, CopiedVectorStyle, CreateProjectOptions, type CredentialRedactionResult, DEFAULT_BASEMAP, DEFAULT_BLEND_MODE, DEFAULT_COLLABORATION_STATE, DEFAULT_DASHBOARD_COLUMNS, DEFAULT_EDITOR_IDENTITY, DEFAULT_EDITOR_TRACKING_CONFIG, DEFAULT_ELLIPSOID_ID, DEFAULT_FORWARD_GEOCODE_ENDPOINT, DEFAULT_GEOCODING_PROVIDER_ID, DEFAULT_LAYER_GROUP_OPACITY, DEFAULT_LAYER_STYLE, DEFAULT_LEGEND_CONFIG, DEFAULT_MAP_GRID_LAYOUT, DEFAULT_PRINT_LAYOUT, DEFAULT_PROJECT_NAME, DEFAULT_PROJECT_PREFERENCES, DEFAULT_REVERSE_GEOCODE_ENDPOINT, DEFAULT_ROUTING_ENDPOINT, DEFAULT_STORY_MAP, DEPLOYMENT_CAPABILITIES, DUCKDB_VECTOR_FEATURE_WARN_COUNT, DUCKDB_VECTOR_ROUTE_BYTES, DashboardWidget, DashboardWidgetAggregation, DashboardWidgetType, DeploymentCapability, DiagramData, DiagramDatum, DiagramField, DiagramSizeMode, DiagramType, DominantGeometry, EARTH_MEAN_RADIUS_METERS, EDITOR_IDENTITY_STORAGE_KEY, ELEVATION_REQUEST_TIMEOUT_MS, ELLIPSOIDS, EXPRESSION_FUNCTION_CATEGORIES, EditorTrackingConfig, EditorTrackingStampOptions, EffectiveVectorRule, ElevationFetchError, Ellipsoid, EllipsoidId, EvaluateMapExpressionOptions, ExpressionExpectedType, ExpressionFieldType, ExpressionFunctionCategory, ExpressionFunctionDoc, ExpressionPreview, ExpressionValidation, ExpressionVariable, ExternalNativePaintBridge, ExternalNativePaintMode, FEET_PER_METER, FEET_PER_MILE, FeatureExpressionMatches, FetchLike, FieldVisibility, FillPattern, GEOCODE_DISPLAY_NAME_KEY, GEOCODE_LAT_KEY, GEOCODE_LON_KEY, GEOCODE_PROVIDER_KEY, GEOCODE_SCORE_KEY, GEOCODE_STATUS_KEY, GEOCODING_PROVIDERS, GOOGLE_MAPS_API_KEY_HEADER, GeoLibreLayer, GeoLibreProject, type GeocodeMatch, type GeocodeRequest, type GeocodeStatus, type GeocoderConfig, type GeocodingPreferenceInput, GeocodingPreferences, type GeocodingProvider, type GeocodingProviderId, GeometryGeneratorType, type GpsStatusFix, GraduatedClassificationScheme, IDENTIFY_ALL_LAYERS_ID, IndicatorAggregation, InitialLayerStyleOptions, IsochroneRequestBody, LARGE_VECTOR_FEATURE_THRESHOLD, LAYER_LIBRARY_BUNDLE_TYPE, LAYER_LIBRARY_BUNDLE_VERSION, LAYER_PALETTE, LAYER_TYPES, LabelAnchor, LabelDedupe, LabelStyle, LabelTransform, LayerCapabilities, LayerConnection, LayerGroup, LayerJoin, LayerJoinStats, LayerLibraryAddPlan, LayerLibraryCaptureFailure, LayerLibraryCaptureResult, LayerLibraryConfigPatch, LayerLibraryEntry, LayerPanelGroupHeaders, LayerPanelUnit, LayerPopupConfig, LayerQuickFilter, LayerStyle, LayerStyleClipboardKind, LayerTreeItem, LayerType, LayerVirtualField, LegendConfig, LegendCustomEntry, LegendCustomItem, LegendCustomShape, LegendItemOverride, LegendPanelPosition, LineDecoration, LngLat, MAX_DASHBOARD_COLUMNS, MAX_DIAGRAM_FEATURES, MAX_DIAGRAM_SCAN_FEATURES, MAX_LAYER_LIBRARY_ENTRIES, MAX_LAYER_LIBRARY_ENTRY_BYTES, MAX_MAP_GRID_DIM, MAX_POINTS_PER_REQUEST, MAX_PROCESSING_HISTORY, MAX_REDACT_DEPTH, MERCATOR_METERS_PER_PIXEL_AT_ZOOM_0, METERS_PER_FOOT, METERS_PER_MILE, METERS_PER_NAUTICAL_MILE, MIN_DASHBOARD_COLUMNS, MIN_DIAGRAM_SIZE, MapGridLayout, MapPreferences, MapProjection, MapScaleUnit, MapViewState, MarkerShape, MatrixRequestBody, ModelGraphEdge, ModelGraphNode, ModelGraphNodeKind, ModelGraphPort, ModelPortKind, ModelToolProvider, NETCDF_IMAGE_SOURCE_KIND, NOMINATIM_MIN_INTERVAL_MS, NOMINATIM_PUBLIC_HOST, NO_DEPLOYMENT_CAPABILITIES, type NetworkToolKind, type NominatimForwardResult, type NominatimReverseResult, NonGeographicCoordinates, OPENFREEMAP_BASEMAPS, PHOTO_FULL_PROPERTY, PHOTO_PROPERTY, PLANETARY_BASEMAPS, PLANETARY_BASEMAP_GROUPS, PLANETARY_BASEMAP_SENTINEL_PREFIX, PLANET_SWITCHER_OPTIONS, POINTER_ELEVATION_CACHE_LIMIT, POINTER_ELEVATION_DEBOUNCE_MS, PROJECT_CREDENTIAL_FIELDS, PROJECT_VERSION, PROTOMAPS_BASEMAPS, PUBLIC_GEOCODE_ROW_CAP, PUBLISHABLE_PLUGIN_SETTINGS, ParticipantIdentity, PlanetaryBasemap, PlanetaryBasemapGroup, PlanetaryBasemapSectionId, PointRenderer, PointerElevationResolver, PointerElevationResolverOptions, PolylineBatchOptions, PolylineDecodeResult, PopupDateFormat, PopupExpressionOptions, PopupFieldConfig, PopupFieldFormat, PopupFieldKind, PopupFormatOptions, PopupRow, PrintLayoutConfig, PrintLayoutCorner, PrintLayoutLegendEntry, PrintLayoutPageFilter, ProcessingModel, ProcessingModelGraph, ProcessingModelStep, ProcessingRerunRequest, ProcessingRun, ProcessingRunKind, ProcessingRunStatus, ProjectComment, ProjectPluginControlPosition, ProjectPluginState, ProjectPreferences, ProjectTemplateEntry, ProportionalSizeRange, QuickFilterDateKind, QuickFilterKind, QuickFilterTextOperator, RAMP_STYLE_KEYS, RASTER_APPEARANCE_STATE_KEYS, REGIONAL_BASEMAPS, REGIONAL_BASEMAP_GROUPS, REGIONAL_BASEMAP_SENTINEL_PREFIX, ROLE_PRIVILEGES, type RasterToolKind, RecentProjectEntry, RegionalBasemap, RegionalBasemapRegionId, ResolvePopupRowsOptions, type ReverseGeocodeDisplay, RouteRequestBody, RoutingConfig, RoutingMetric, RoutingMode, RoutingPoint, RoutingRequestError, RuntimeEnvironmentVariable, SELECTION_MODES, SQL_QUERY_SOURCE_KIND, STYLE_LIBRARY_BUNDLE_TYPE, STYLE_LIBRARY_BUNDLE_VERSION, SYMBOL_STYLE_KEYS, SecondaryMapView, SelectionMode, type StatisticsToolKind, StoryActiveSlideMode, StoryChapter, StoryChapterAlignment, StoryChapterAnimation, StoryChapterLocation, StoryInsetPosition, StoryLayerOpacityChange, StoryMap, StorySlideMode, StrokeWidthUnit, StyleLibraryEntry, StyleLibraryEntryKind, TerrainMapLike, VECTOR_COLOR_RAMPS, ValidateMapExpressionOptions, VectorColorValue, VectorRule, VectorStyleMode, VectorStyleStop, type VectorToolKind, activeQuickFilters, appPrivilegeReason, applyCopiedLayerStyle, applyGroupEffects, applyJoinsToLayer, applyLayerJoins, applyLayerVirtualFields, applyMatchedSelection, applyProjectToStore, applySelectionMode, attributeFormFieldLabel, attributeLinkUrl, basemapToCesiumImagery, batchDecodePolylines, bodyLengthToEarth, buildForwardGeocodeUrl, buildIsochroneRequest, buildLayerPanelUnits, buildLayerTree, buildMatrixRequest, buildReverseGeocodeUrl, buildRouteRequest, canRedoProjectRestore, canSaveLayerToLibrary, canUndoProjectRestore, captureLayerLibraryEntry, cascadeLayerJoinRefresh, circleRadiusValue, clearExternalNativePaintBridge, clearHistory, clearQuickFilterValues, coerceAttributeFormValue, collectDiagramData, collectTransitiveJoinSourceIds, compareSequenceValues, compileFeatureExpression, compileQuickFilter, compileQuickFilters, controlRendersLayer, copyableLayerStyleKind, createDefaultAppCapabilities, createDefaultMapView, createDefaultPrintLayout, createEmptyProject, createEqualIntervalBreaks, createGraduatedClassBreaks, createLayerLibraryEntryId, createPointerElevationResolver, createProjectTemplate, createQuantileBreaks, createSampleStoryMap, createStyleLibraryEntryId, csvRowsToGeocodeRequests, currentEditorIdentity, darkenHex, decodePolyline, decodePolylineDetailed, detachProjectCopy, detectNonGeographicCoordinates, diagramAnchor, diagramPixelSize, diagramsSuppressedByPointRenderer, dominantGeometry, drawMarkerPath, earthAreaToBody, earthLengthToBody, editorTrackingFieldNames, effectiveLayerRenderState, effectiveVectorRules, encodePolyline, ensureEditorTrackingFields, evaluateMapExpression, excludeHiddenFieldsFromGeojson, excludeHiddenFieldsFromProject, extractCopiedLayerStyle, extractStyleLibraryStyle, extrusionColorValue, extrusionHeightValue, featureSelectionId, fetchElevations, formatCameraAltitude, formatExpressionPreviewValue, formatPixelValue, formatPopupValue, formatRoundNum, generatorCircleRadiusValue, generatorSizeRange, geoJSONToPolylineStr, geocodeForward, geocodeMatchToFeature, geocodeReverse, geocoderMinIntervalMs, geocoderNeedsApiKey, geojsonHasZCoordinates, getActiveBodyRadiusRatio, getActiveEllipsoid, getActiveMeanRadiusMeters, getActiveSemiMajorAxisMeters, getAttributeFormField, getBuildEnvironment, getCesiumIonToken, getEllipsoid, getExternalNativePaintBridge, getGeocoderConfig, getGeocodingProvider, getGoogleMapsApiKey, getHistoryCoalesceMs, getMapboxAccessToken, getMaxHistoryFeatureCount, getPlanetaryBasemapById, getPlanetaryBasemapByStyleUrl, getProtomapsApiKey, getProtomapsStyleUrl, getRegionalBasemapById, getRegionalBasemapByStyleUrl, getRoundNum, getRoutingConfig, getRuntimeEnvironment, getSpatialExtensionPath, getVectorColorRamp, googleMapsApiKeyHeaderValue, groupMemberIndices, hasActiveQuickFilter, hasAppPrivilege, hasPathTraversal, hasRestorableLayerSource, hasSimpleStyleProperties, inferFieldTypes, inferLayerCapabilities, initialLayerStyle, interpolateColors, interpolateHexColor, interpolateRampColors, intersectPrivileges, invertSelection, isAbsoluteFilesystemPath, isAllowedPluginManifestUrl, isAttributeFormFieldVisible, isCredentialFieldName, isDefaultPrintLayout, isDeploymentCapability, isDiagramStyleEnabled, isDuckDBQueryLayer, isExternalNativeLayerRecord, isGooglePhotorealisticTilesetUrl, isHexColor, isInitialLayerStyle, isInlineImageValue, isInternalPopupField, isIpadDesktopUserAgent, isMaintainedEditorTrackingField, isPopupClickEnabled, isPopupHoverEnabled, isRegionalBasemapSentinel, isSafePopupUrl, isStyleLibraryTargetLayer, isStyleSpecColor, isVectorColorExpression, isochroneResponseToFeatures, layerGroupDepth, layerGroupMoveability, layerJoinKey, layerLibraryConfigPatch, layerLibraryEntryNeedsLocalFile, layerPanelGroupHeaders, lineWidthValue, mapZoomStepOutputs, matchFeaturesByExpression, matrixResponseToFeatures, meanRadiusMeters, mercatorMetersPerPixelAtZoom0, metersWidthExpression, nextDelayMs, nextLayerPaletteColor, nominatimResultToFeature, nominatimReverseResultToDisplay, nonEmptyRecord, normalizeAppPrivileges, normalizeBlankBackgroundColor, normalizeDashboardColumns, normalizeGeocodingProviderId, normalizeGroupContiguity, normalizeHexColor, normalizeLayerCapabilities, normalizeLayerLibraryEntries, normalizeMapLayout, normalizeMapViewState, normalizeModelGraph, normalizeModels, normalizePrintLayoutConfig, normalizeProcessingHistory, normalizeProjectComments, normalizeSecondaryMapViews, normalizeStoryMap, normalizeStyleLibraryEntries, normalizeWidgets, parseContours, parseDeploymentCapabilities, parseHexColor, parseHexColorList, parseJsonExpression, parseLayerLibrary, parseProject, parseStoryMapCsv, parseStoryMapJson, parseStyleLibrary, parseValueMapText, persistedThreeDTilesRequestHeaders, pickEditorIdentity, planLayerLibraryAdd, pluginOwnsPaint, polylineStrToGeoJSON, popupFieldLabel, printLayoutConfigsEqual, projectFromStore, projectPathLabel, proportionalRadiusExpression, proportionalSizeRange, readStoredAuthorName, reapplyLayerJoins, redactCredentials, redactProjectCredentials, redactUrlCredentials, redo, registerProjectRestoreHistory, removeTrailingJsonCommas, reorderLayerGroupInPanel, requestIsochrone, requestMatrix, requestRoute, resolveConfiguredPopupTitle, resolveEditorTrackingConfig, resolveGeocoderConfig, resolveLayerCapabilities, resolveMapGrid, resolvePopupBody, resolvePopupRows, resolvePopupTitle, resolveRolePrivileges, resolveSvgSource, resolveThreeDTilesRequestHeaders, rgbToHex, routeResponseToFeatures, rowCap, ruleBasedColorExpression, ruleBasedVisibilityFilter, sameCesiumImagery, sampleMapTerrain, sampleMapTerrainPoint, sampleRemoteElevations, sanitizeLayerStylePatch, scaleAltitudeToActiveBody, scaleDenomination, scaleSpan, scrubCommentsForRemovedLayers, scrubLegendForRemovedLayers, scrubPrintLayoutForLayers, scrubPrintLayoutForRemovedLayers, scrubWidgetsForRemovedLayers, serializeLayerLibrary, serializeProject, serializeStoryMapCsv, serializeStoryMapJson, serializeStyleLibrary, setActiveEllipsoidId, setExternalNativePaintBridge, setGeocodingFetch, setHistoryCoalesceMs, setMaxHistoryFeatureCount, setStoredAuthorName, shouldThrottle, shouldUseTiledRendering, simpleStyleNumberValue, stampFeatureCollectionEditorTracking, stampFeatureEditorTracking, stampFeaturePropertiesEditorTracking, storyMapHasContent, stringifyPopupValue, stripGoogleMapsApiKeyHeader, stripJoinFields, stripVirtualFieldColumns, styleValue, subscribeProjectRestoreHistory, substituteExpressionVariables, supportsBridgedOpacity, transformGeojsonElevation, trimHistoryBySize, undo, unescapePolyline, unmatchedGeocodeFeature, unresolvedLayerLibraryJoins, useAppCapability, useAppStore, validateAttributeFormField, validateAttributeFormValues, validateMapExpression, valueMapLabelFor, valueMapToText, vectorCircleColorValue, vectorColorExpression, vectorFillColorValue, vectorFillOpacityValue, vectorLineColorValue, vectorOutlineColorValue, vectorStrokeWidthValue, visiblePopupFields, visiblePopupProperties };
+export type { AppState, CesiumIonAssetKind, CesiumIonLayerOptions, CesiumKmlLayerOptions, ConversionToolKind, CredentialRedactionResult, CzmlDocument, CzmlLayerOptions, CzmlPacket, CzmlSource, GeocodeMatch, GeocodeRequest, GeocodeStatus, GeocoderConfig, GeocodingPreferenceInput, GeocodingProvider, GeocodingProviderId, GpsStatusFix, NetworkToolKind, NominatimForwardResult, NominatimReverseResult, RasterToolKind, ReverseGeocodeDisplay, StatisticsToolKind, VectorToolKind };
 //# sourceMappingURL=index.d.mts.map