@geolibre/core 3.3.0 → 3.4.0

package/dist/{joins-CRZZcLqX.d.mts → project-diff-BD23T4xv.d.mts}

@@ -994,7 +994,11 @@ interface LayerStyle {
   markerShape: MarkerShape;
   markerColor: string;
   markerSize: number;
-  /** Raw SVG markup (or a data URL) used when {@link markerShape} is `"custom"`. */
+  /**
+   * The custom marker image used when {@link markerShape} is `"custom"`: raw
+   * SVG markup, a `data:` URL (SVG or a raster PNG/JPEG/GIF), or an `http(s)`
+   * URL. Only SVG sources take {@link markerColor}; raster images draw as-is.
+   */
   markerSvg: string;
   /**
    * When true, per-feature [simplestyle-spec](https://github.com/mapbox/simplestyle-spec)
@@ -1228,6 +1232,15 @@ interface AttributeFormFieldConfig {
   required?: boolean;
   /** Dropdown entries for the `valueMap` widget. */
   valueMap?: AttributeFormValueMapEntry[];
+  /**
+   * Declared storage type of the field. When set, coercion follows it instead
+   * of guessing from the value map (a text field whose codes are "1" and "2"
+   * still stores strings), and validation rejects values of another type or,
+   * for `integer`, fractional numbers. Service-derived configs (ArcGIS domains)
+   * set it from the field's declared type; designer-authored configs leave it
+   * unset.
+   */
+  valueType?: "string" | "number" | "integer";
   /** Lower bound for `number`/`range` widgets (inclusive). */
   min?: number;
   /** Upper bound for `number`/`range` widgets (inclusive). */
@@ -1973,6 +1986,11 @@ interface MapPreferences {
   showPointerElevation: boolean;
   /** Whether the built-in 3D terrain control and terrain surface are enabled. */
   terrainEnabled: boolean;
+  /**
+   * Optional Cesium Ion terrain asset used by the globe when terrain is enabled.
+   * Ignored by 2D renderers; absent means the renderer's normal global source.
+   */
+  terrainIonAssetId?: number;
   /** Mapbox-only style. New projects use Streets; absent follows the shared basemap. */
   mapboxStyleUrl?: string;
   /**
@@ -1983,6 +2001,14 @@ interface MapPreferences {
    * basemap styles service requires one.
    */
   arcgisBasemap?: string;
+  /**
+   * ArcGIS-only projection of the flat map, as a WKID the ArcGIS Maps SDK
+   * resolves (`54099` Spilhaus, `54030` Robinson, ...). Absent means Web
+   * Mercator. Vector layers are reprojected on the client; tiled layers and
+   * basemaps cannot be, so they do not draw in another projection. The globe
+   * (a `SceneView`) ignores it. See `arcgis-projection.ts`.
+   */
+  arcgisWkid?: number;
   /** Cesium imagery override; absent follows the shared project basemap. */
   cesiumBasemap?: CesiumBasemapId;
   /**
@@ -2401,6 +2427,40 @@ 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.
  */
+/**
+ * A saved map view in the Bookmarks panel. Mirrors `MapBookmark` from
+ * maplibre-gl-components so the panel can load it unchanged.
+ */
+interface ProjectBookmark {
+  /** Unique within the project. */
+  id: string;
+  name: string;
+  /** Camera center longitude, -180..180. */
+  lng: number;
+  /** Camera center latitude, -90..90. */
+  lat: number;
+  zoom: number;
+  /** Camera tilt in degrees, 0..85. */
+  pitch: number;
+  /** Camera rotation in degrees. */
+  bearing: number;
+  /** Creation time, milliseconds since the epoch. */
+  createdAt: number;
+  /** The {@link ProjectBookmarkGroup} it belongs to; absent when ungrouped. */
+  groupId?: string;
+  /**
+   * Host state captured with the view. GeoLibre stores `visibleLayerIds`
+   * (the layers to show when the bookmark is opened).
+   */
+  extra?: Record<string, unknown>;
+}
+/** A folder in the Bookmarks panel. Folders do not nest. */
+interface ProjectBookmarkGroup {
+  id: string;
+  name: string;
+  /** Whether the folder is collapsed in the panel. */
+  collapsed: boolean;
+}
 interface DashboardWidget {
   /** Stable id, unique within the project (React key and store key). */
   id: string;
@@ -2579,8 +2639,23 @@ interface GeoLibreProject {
   models?: ProcessingModel[];
   /** Recorded processing tool runs (Processing History; issue #1292). */
   processingHistory?: ProcessingRun[];
+  /**
+   * Object-Based Analysis workbench state and run provenance (issue #3053):
+   * settings, classes, and the tool calls, parameters, seeds and engine
+   * versions behind the last segmentation, measurement and classification.
+   * A versioned JSON object owned by the desktop app; omitted until the
+   * workbench is used.
+   */
+  obia?: Record<string, unknown>;
   /** Saved Dashboard panel chart widgets (issue #401). */
   widgets?: DashboardWidget[];
+  /**
+   * Saved map views (the Bookmarks panel), in panel order. Omitted when there
+   * are none. Before #2869 these lived only in the browser's localStorage.
+   */
+  bookmarks?: ProjectBookmark[];
+  /** Folders the {@link bookmarks} are organized into. Omitted when none. */
+  bookmarkGroups?: ProjectBookmarkGroup[];
   /** Number of columns in the Dashboard widget grid; omitted when default. */
   dashboardColumns?: number;
   /**
@@ -3214,5 +3289,515 @@ declare function cascadeLayerJoinRefresh(layers: GeoLibreLayer[], seedId: string
  */
 declare function reapplyLayerJoins(layers: GeoLibreLayer[]): GeoLibreLayer[];
 //#endregion
-export { BLANK_BASEMAP as $, QuickFilterKind as $n, LayerPopupConfig as $t, PlanetaryBasemap as A, OPENFREEMAP_BASEMAPS as An, isDefaultPrintLayout as Ar, FieldVisibility as At, getEllipsoid as B, ProcessingModelGraph as Bn, Point as Br, LabelDedupe as Bt, ELLIPSOIDS as C, ModelGraphNode as Cn, styleValue as Cr, DashboardWidget as Ct, PLANETARY_BASEMAP_GROUPS as D, ModelToolProvider as Dn, PrintLayoutLegendEntry as Dr, DiagramSizeMode as Dt, PLANETARY_BASEMAPS as E, ModelPortKind as En, PrintLayoutCorner as Er, DiagramField as Et, earthLengthToBody as F, PopupDateFormat as Fn, Feature as Fr, GeometryGeneratorType as Ft, AddTileLayerOptions as G, ProcessingRunStatus as Gn, availableCesiumBasemap as Gr, LayerDescriptiveMetadata as Gt, getPlanetaryBasemapByStyleUrl as H, ProcessingRerunRequest as Hn, CESIUM_BASEMAPS as Hr, LabelTransform as Ht, getActiveBodyRadiusRatio as I, PopupFieldConfig as In, FeatureCollection as Ir, IndicatorAggregation as It, AppRole as J, ProjectPluginControlPosition as Jn, sameCesiumImagery as Jr, LayerJoinStats as Jt, AppCapabilities as K, ProjectComment as Kn, basemapToCesiumImagery as Kr, LayerGroup as Kt, getActiveEllipsoid as L, PopupFieldFormat as Ln, Geometry as Lr, LARGE_VECTOR_FEATURE_THRESHOLD as Lt, PlanetaryBasemapSectionId as M, PROTOMAPS_BASEMAPS as Mn, printLayoutConfigsEqual as Mr, GeoLibreLayer as Mt, bodyLengthToEarth as N, ParticipantIdentity as Nn, scrubPrintLayoutForLayers as Nr, GeoLibreProject as Nt, PLANETARY_BASEMAP_SENTINEL_PREFIX as O, NETCDF_IMAGE_SOURCE_KIND as On, PrintLayoutPageFilter as Or, DiagramType as Ot, earthAreaToBody as P, PointRenderer as Pn, scrubPrintLayoutForRemovedLayers as Pr, GeocodingPreferences as Pt, AttributeFormWidget as Q, QuickFilterDateKind as Qn, LayerMetadataTemporalExtent as Qt, getActiveMeanRadiusMeters as R, PopupFieldKind as Rn, LineString as Rr, LAYER_TYPES as Rt, EARTH_MEAN_RADIUS_METERS as S, ModelGraphEdge as Sn, shouldUseTiledRendering as Sr, DUCKDB_VECTOR_ROUTE_BYTES as St, EllipsoidId as T, ModelGraphPort as Tn, PrintLayoutConfig as Tr, DashboardWidgetType as Tt, meanRadiusMeters as U, ProcessingRun as Un, CesiumBasemapId as Ur, LayerCapabilities as Ut, getPlanetaryBasemapById as V, ProcessingModelStep as Vn, Polygon as Vr, LabelStyle as Vt, setActiveEllipsoidId as W, ProcessingRunKind as Wn, CesiumBasemapImagery as Wr, LayerConnection as Wt, AttributeFormFieldConfig as X, ProjectPreferences as Xn, LayerMetadataContact as Xt, AttributeFormConfig as Y, ProjectPluginState as Yn, LayerLibraryEntry as Yt, AttributeFormValueMapEntry as Z, ProjectTemplateEntry as Zn, LayerMetadataLink as Zt, unescapePolyline as _, MapProjection as _n, VectorRule as _r, DEFAULT_MAP_GRID_LAYOUT as _t, collectTransitiveJoinSourceIds as a, LegendCustomEntry as an, StoryActiveSlideMode as ar, CollaborationParticipant as at, transformGeojsonElevation as b, MapViewState as bn, detectNonGeographicCoordinates as br, DEFAULT_STORY_MAP as bt, stripJoinFields as c, LegendItemOverride as cn, StoryChapterAnimation as cr, CollaborationState as ct, batchDecodePolylines as d, MAX_DASHBOARD_COLUMNS as dn, StoryLayerOpacityChange as dr, CommentReply as dt, LayerQuickFilter as en, QuickFilterTextOperator as er, BLEND_MODES as et, decodePolyline as f, MAX_MAP_GRID_DIM as fn, StoryMap as fr, DEFAULT_BASEMAP as ft, polylineStrToGeoJSON as g, MapPreferences as gn, StyleLibraryEntryKind as gr, DEFAULT_LEGEND_CONFIG as gt, geoJSONToPolylineStr as h, MapGridLayout as hn, StyleLibraryEntry as hr, DEFAULT_LAYER_STYLE as ht, cascadeLayerJoinRefresh as i, LegendConfig as in, SecondaryMapView as ir, CollaborationMode as it, PlanetaryBasemapGroup as j, PROJECT_VERSION as jn, normalizePrintLayoutConfig as jr, FillPattern as jt, PLANET_SWITCHER_OPTIONS as k, NonGeographicCoordinates as kn, createDefaultPrintLayout as kr, EditorTrackingConfig as kt, PolylineBatchOptions as l, LegendPanelPosition as ln, StoryChapterLocation as lr, CommentAnchor as lt, encodePolyline as m, MIN_DASHBOARD_COLUMNS as mn, StrokeWidthUnit as mr, DEFAULT_DASHBOARD_COLUMNS as mt, applyJoinsToLayer as n, LayerType as nn, RuntimeEnvironmentVariable as nr, CollabInvite as nt, layerJoinKey as o, LegendCustomItem as on, StoryChapter as or, CollaborationPresence as ot, decodePolylineDetailed as p, MAX_PROCESSING_HISTORY as pn, StorySlideMode as pr, DEFAULT_BLEND_MODE as pt, AppPrivilege as q, ProjectInteraction as qn, normalizeCesiumBasemap as qr, LayerJoin as qt, applyLayerJoins as r, LayerVirtualField as rn, SQL_QUERY_SOURCE_KIND as rr, CollaborationChatMessage as rt, reapplyLayerJoins as s, LegendCustomShape as sn, StoryChapterAlignment as sr, CollaborationRole as st, ApplyLayerJoinsResult as t, LayerStyle as tn, RecentProjectEntry as tr, BlendMode as tt, PolylineDecodeResult as u, LineDecoration as un, StoryInsetPosition as ur, CommentAuthor as ut, geojsonHasZCoordinates as v, MapRendererKind as vn, VectorStyleMode as vr, DEFAULT_PRIMARY_RENDERER as vt, Ellipsoid as w, ModelGraphNodeKind as wn, DEFAULT_PRINT_LAYOUT as wr, DashboardWidgetAggregation as wt, DEFAULT_ELLIPSOID_ID as x, MarkerShape as xn, isDuckDBQueryLayer as xr, DUCKDB_VECTOR_FEATURE_WARN_COUNT as xt, horizontalBbox as y, MapScaleUnit as yn, VectorStyleStop as yr, DEFAULT_PROJECT_PREFERENCES as yt, getActiveSemiMajorAxisMeters as z, ProcessingModel as zn, MultiPolygon as zr, LabelAnchor as zt };
-//# sourceMappingURL=joins-CRZZcLqX.d.mts.map
+//#region src/project.d.ts
+/** Placeholder name a project carries before the user names it. */
+declare const DEFAULT_PROJECT_NAME = "Untitled Project";
+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;
+/**
+ * Serialize a project to `.geolibre.json` text: indented project structure with
+ * compact (unindented) embedded GeoJSON. See {@link serializeProjectValue} for
+ * why the two halves are formatted differently.
+ *
+ * @param project Project to serialize.
+ * @returns The file contents to write.
+ */
+declare function serializeProject(project: GeoLibreProject): string;
+/**
+ * Per-layer serialized text kept across {@link serializeProjectWithLayerCache}
+ * calls, keyed by the layer record each entry was built from. A `WeakMap`, so a
+ * layer the store has replaced or removed drops its text with it.
+ */
+type ProjectLayerSerializationCache = WeakMap<object, {
+  index: number;
+  text: string;
+}>;
+/** Create an empty {@link ProjectLayerSerializationCache}. */
+declare function createProjectLayerSerializationCache(): ProjectLayerSerializationCache;
+/**
+ * Serialize a project exactly as {@link serializeProject} does, reusing the
+ * text of every layer whose source record is unchanged since an earlier call.
+ *
+ * Feature data lives inside layer records, so re-stringifying every layer on
+ * each autosave costs megabytes of main-thread work for a project with large
+ * GeoJSON layers — even when only the camera moved (GeoLibre#2633). The store
+ * replaces a layer object whenever it changes, so object identity is a sound
+ * cache key: a camera move reuses every layer, and an edit to one layer
+ * re-serializes only that one.
+ *
+ * `layerSources[i]` must be the record `project.layers[i]` was derived from
+ * (e.g. the store's `layers`, before `projectFromStore` prepared them), and that
+ * derivation must depend on the record alone — as `buildProjectSnapshot`'s does
+ * — or a cached entry could outlive a change it should have reflected. When the
+ * two arrays differ in length the cache is bypassed rather than trusted.
+ *
+ * @param project Project to serialize, as built from `layerSources`.
+ * @param layerSources Immutable source record for each entry of
+ *   `project.layers`, in the same order, used as the cache key.
+ * @param cache Cache shared between calls; see
+ *   {@link createProjectLayerSerializationCache}.
+ * @returns The same text {@link serializeProject} returns for `project`.
+ */
+declare function serializeProjectWithLayerCache(project: GeoLibreProject, layerSources: readonly object[], cache: ProjectLayerSerializationCache): string;
+/**
+ * {@link serializeProjectWithLayerCache} that hands the main thread back
+ * between layers, so autosave on a project with several large layers is many
+ * short tasks instead of one 300-400 ms freeze (GeoLibre#2869).
+ *
+ * The cache makes a camera move free, so the cost lands on the first autosave
+ * and on edits to a big layer: each layer that misses the cache is serialized
+ * in its own slice, and the thread is released once a slice has run longer than
+ * a few milliseconds. A single huge layer is still one slice. The result is
+ * identical to the synchronous call. `project` and `layerSources` must not be
+ * mutated while this runs; the store replaces records rather than editing them,
+ * so a snapshot taken from it stays valid.
+ *
+ * @param project Project to serialize, as built from `layerSources`.
+ * @param layerSources Immutable source record for each entry of
+ *   `project.layers`, in the same order, used as the cache key.
+ * @param cache Cache shared between calls.
+ * @param yieldFn Hands the thread back; replaced in tests.
+ * @returns The same text {@link serializeProject} returns for `project`.
+ */
+declare function serializeProjectWithLayerCacheAsync(project: GeoLibreProject, layerSources: readonly object[], cache: ProjectLayerSerializationCache, yieldFn?: () => Promise<void>): Promise<string>;
+declare function parseProject(json: string): GeoLibreProject;
+/**
+ * Coerce an untrusted (possibly hand-edited) legend config into a valid
+ * {@link LegendConfig}, dropping malformed entries. Returns undefined when no
+ * usable config is present so the default is applied downstream.
+ */
+declare function normalizeLegendConfig(legend: unknown): LegendConfig | undefined;
+/**
+ * Validate and coerce a story map loaded from an untrusted project file.
+ *
+ * Returns null when the value carries no chapters so empty story maps stay out
+ * of the saved project, mirroring how plugins are only persisted when present.
+ *
+ * @param storymap Raw value read from the project JSON.
+ * @returns A normalized story map, or null when there is nothing to keep.
+ */
+declare function normalizeStoryMap(storymap: unknown): StoryMap | null;
+/** Whether a story map carries chapters or any non-default setting. */
+declare function storyMapHasContent(story: StoryMap): boolean;
+/**
+ * Coerce an untrusted (possibly hand-edited) `models` array into valid
+ * {@link ProcessingModel} records. Drops models and steps without a usable id or
+ * tool id, de-duplicates models by id, and keeps step `parameters` as a plain
+ * object (the runner validates parameter values per tool at run time). Returns
+ * `null` when there is nothing worth persisting, so a model-less project stays
+ * free of the key.
+ *
+ * @param value Raw `models` value from the project JSON.
+ * @returns Normalized models, or `null` when none survive.
+ */
+declare function normalizeModels(value: unknown): ProcessingModel[] | null;
+/**
+ * Coerce an untrusted `graph` value into a {@link ProcessingModelGraph}. Drops
+ * nodes without a usable id or an unknown kind, de-duplicates node ids, and
+ * drops edges that do not connect two surviving nodes or that name an empty
+ * port. Self-edges are dropped too, since a node cannot feed itself.
+ *
+ * Structural validity beyond this (cycles, type mismatches, missing required
+ * inputs) is the runner's job — those depend on the tool registries, which the
+ * project layer deliberately does not import.
+ *
+ * @param value Raw `graph` value from the project JSON.
+ * @returns The normalized graph, or `null` when it has no usable nodes.
+ */
+declare function normalizeModelGraph(value: unknown): ProcessingModelGraph | null;
+/**
+ * Coerce an untrusted (possibly hand-edited) `processingHistory` array into
+ * valid {@link ProcessingRun} records. Drops entries without a usable id, tool
+ * id, or known kind, de-duplicates by id, keeps `parameters` as a plain object,
+ * and caps the list at {@link MAX_PROCESSING_HISTORY} (keeping the newest,
+ * i.e. last, entries). Returns `null` when nothing survives, so a history-less
+ * project stays free of the key.
+ *
+ * @param value Raw `processingHistory` value from the project JSON.
+ * @returns Normalized runs, or `null` when none survive.
+ */
+/**
+ * Accept the Object-Based Analysis workbench blob (`obia`) only as a plain,
+ * JSON-serializable object carrying a numeric `version`. Its fields are owned
+ * and validated by the desktop app, which treats anything it does not
+ * recognise as absent; core only guarantees the shape survives a round trip.
+ *
+ * @param value Raw `obia` value from the project JSON.
+ * @returns A detached copy, or `null` when absent or malformed.
+ */
+declare function normalizeObiaWorkbench(value: unknown): Record<string, unknown> | null;
+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;
+/**
+ * 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;
+/**
+ * Coerce an untrusted `primaryRenderer` into a known engine id (issue #2217).
+ *
+ * Returns null for the default 2D map — absent, unknown, or an explicit
+ * `"maplibre"` — because the field is only written when it is not the default,
+ * so a MapLibre project serializes byte-identically to before this existed.
+ * The return type is narrowed to `"cesium" | "mapbox" | "arcgis" | null` rather
+ * than the full {@link MapRendererKind} for that reason: `"maplibre"` is never a
+ * result.
+ */
+declare function normalizePrimaryRenderer(value: unknown): "cesium" | "mapbox" | "arcgis" | null;
+/**
+ * Coerce an untrusted `secondaryMapViews` array into valid
+ * {@link SecondaryMapView} records, dropping entries without a usable id and
+ * de-duplicating by id. Returns null when none are valid.
+ */
+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: {
+  mapView: MapViewState;
+}): {
+  mapLayout: MapGridLayout;
+  secondaryMapViews: SecondaryMapView[];
+};
+/** Bookmarks kept per project, as the panel's own default limit allows. */
+declare const MAX_PROJECT_BOOKMARKS = 500;
+/**
+ * Coerce an untrusted `bookmarkGroups` array into valid folders: drops entries
+ * without a string id and de-duplicates by id. A missing name becomes
+ * "Folder"; `collapsed` defaults to false.
+ *
+ * @param value Raw `bookmarkGroups` value from the project JSON.
+ * @returns The folders (possibly empty).
+ */
+declare function normalizeBookmarkGroups(value: unknown): ProjectBookmarkGroup[];
+/**
+ * Coerce an untrusted `bookmarks` array into valid saved views: drops entries
+ * without a string id or a finite, in-range camera, de-duplicates by id, wraps
+ * the bearing into 0-360, and drops a `groupId` that names no folder in
+ * `groups`. Keeps at most {@link MAX_PROJECT_BOOKMARKS}.
+ *
+ * @param value Raw `bookmarks` value from the project JSON.
+ * @param groups The project's (normalized) folders.
+ * @returns The bookmarks (possibly empty).
+ */
+declare function normalizeBookmarks(value: unknown, groups?: readonly ProjectBookmarkGroup[]): ProjectBookmark[];
+/**
+ * Coerce an untrusted (possibly hand-edited) `widgets` array into valid
+ * {@link DashboardWidget} records. Drops widgets without a usable id, layer id,
+ * or recognized chart type, de-duplicates by id, and keeps only the optional
+ * keys that are present and well-typed (the Dashboard panel falls back to
+ * sensible defaults for anything missing). Returns `null` when there is nothing
+ * worth persisting, so a widget-less project stays free of the key.
+ *
+ * @param value Raw `widgets` value from the project JSON.
+ * @returns Normalized widgets, or `null` when none survive.
+ */
+declare function normalizeWidgets(value: unknown): DashboardWidget[] | null;
+/**
+ * Clamp an untrusted dashboard column count into the supported range, falling
+ * back to the default for a missing or non-finite value.
+ *
+ * @param value Raw `dashboardColumns` value from the project JSON.
+ * @returns An integer column count within [MIN, MAX].
+ */
+declare function normalizeDashboardColumns(value: unknown): number;
+/**
+ * Coerce an untrusted `interaction` block into a {@link ProjectInteraction}.
+ *
+ * Layer ids are kept even when no such layer exists: the block is replayed
+ * against whatever layers the project has when it opens, and the loader drops
+ * the ones it cannot find. Control names are kept as written for the same
+ * reason; the app ignores names it does not know.
+ *
+ * @param value - Raw `interaction` value from the project JSON or the store.
+ * @returns The normalized block, or null when it carries nothing to apply.
+ */
+declare function normalizeProjectInteraction(value: unknown): ProjectInteraction | null;
+declare function isAllowedPluginManifestUrl(url: string): boolean;
+declare function normalizeProjectComments(rawComments: unknown): ProjectComment[];
+declare function projectFromStore(state: {
+  projectName: string;
+  mapView: MapViewState;
+  basemapStyleUrl: string;
+  basemapVisible: boolean;
+  basemapOpacity: number;
+  blankBackgroundColor?: string | null;
+  layers: GeoLibreLayer[];
+  selectedLayerId?: string | null;
+  layerGroups?: LayerGroup[];
+  preferences: ProjectPreferences;
+  plugins?: ProjectPluginState | null;
+  legend?: LegendConfig | null;
+  printLayout?: PrintLayoutConfig | null;
+  storymap?: StoryMap | null;
+  models?: ProcessingModel[] | null;
+  processingHistory?: ProcessingRun[] | null;
+  obia?: Record<string, unknown> | null;
+  widgets?: DashboardWidget[] | null;
+  bookmarks?: ProjectBookmark[] | null;
+  bookmarkGroups?: ProjectBookmarkGroup[] | null;
+  dashboardColumns?: number;
+  mapLayout?: MapGridLayout;
+  secondaryMapViews?: SecondaryMapView[];
+  primaryMapLabel?: string;
+  primaryRenderer?: MapRendererKind;
+  /** Project-scoped Style Manager entries (the store's `projectStyleLibrary`). */
+  styleLibrary?: StyleLibraryEntry[] | null;
+  comments?: ProjectComment[] | null;
+  /** Startup interaction state loaded with the project, written back as-is. */
+  interaction?: ProjectInteraction | null;
+  metadata: Record<string, unknown>;
+}): GeoLibreProject;
+/**
+ * Whether a layer lives only for the current session and is never written to a
+ * project file. A plugin sets `metadata.sessionOnly` on a store row that mirrors
+ * something it draws itself and cannot restore, such as a point cloud streamed
+ * from a short-lived signed URL, so the row shows in the Layers panel while the
+ * plugin runs but a reopened project carries no dead entry for it.
+ *
+ * @param layer - The layer to check.
+ * @returns `true` when the layer must be left out of saved projects.
+ */
+declare function isSessionOnlyLayer(layer: GeoLibreLayer): boolean;
+/**
+ * The plain HTTP(S) WMS template inside the desktop app's `geolibre-wms://`
+ * wrapper (its CORS-exempt native fetcher), or the tile unchanged when it is
+ * not wrapped or the wrapped URL is not HTTP(S). Shared by project export and
+ * the ArcGIS engine's story-export templates.
+ *
+ * @param tile - A tile template, wrapped or not.
+ * @returns The unwrapped template, or `tile` itself.
+ */
+declare function portableWmsTileUrl(tile: unknown): unknown;
+/**
+ * The store form of one project layer: its style completed from
+ * {@link DEFAULT_LAYER_STYLE} and the project's top-level `styles` entry.
+ *
+ * Legacy and externally-authored projects can carry a partial top-level style
+ * alongside newer fields on the layer itself. Those layer fields are kept,
+ * while the top-level copy stays authoritative where it explicitly supplies a
+ * value.
+ *
+ * @param project - The project the layer belongs to (for its `styles` map).
+ * @param layer - One of `project.layers`.
+ * @returns A new layer record ready for the store.
+ */
+declare function hydrateProjectLayer(project: Pick<GeoLibreProject, "styles">, layer: GeoLibreLayer): GeoLibreLayer;
+declare function applyProjectToStore(project: GeoLibreProject): {
+  projectName: string;
+  mapView: MapViewState;
+  basemapStyleUrl: string;
+  basemapVisible: boolean;
+  basemapOpacity: number;
+  blankBackgroundColor: string | null;
+  layers: GeoLibreLayer[];
+  layerGroups: LayerGroup[];
+  preferences: ProjectPreferences;
+  projectPlugins: ProjectPluginState | null;
+  legend: LegendConfig;
+  printLayout: PrintLayoutConfig;
+  storymap: StoryMap | null;
+  models: ProcessingModel[];
+  processingHistory: ProcessingRun[];
+  obiaWorkbench: Record<string, unknown> | null;
+  widgets: DashboardWidget[];
+  bookmarks: ProjectBookmark[];
+  bookmarkGroups: ProjectBookmarkGroup[];
+  dashboardColumns: number;
+  mapLayout: MapGridLayout;
+  secondaryMapViews: SecondaryMapView[];
+  primaryMapLabel: string;
+  primaryRenderer: MapRendererKind;
+  projectStyleLibrary: StyleLibraryEntry[];
+  comments: ProjectComment[];
+  projectInteraction: ProjectInteraction | null;
+  metadata: Record<string, unknown>;
+};
+/**
+ * Create an unlinked copy of a project, suffixed with "(copy)" by default and
+ * stripped of share-specific metadata (shareId, shareUrl, etc.).
+ */
+declare function detachProjectCopy(project: GeoLibreProject, options?: {
+  nameSuffix?: string;
+}): GeoLibreProject;
+/**
+ * Create a template snapshot of a project. Optionally strips data layers while
+ * keeping basemap, layer groups, styles, legend config, preferences, widgets, and
+ * print layout.
+ */
+declare function createProjectTemplate(project: GeoLibreProject, options?: {
+  name?: string;
+  stripDataLayers?: boolean;
+}): GeoLibreProject;
+//#endregion
+//#region src/project-diff.d.ts
+/** One changed value, with bounded human-readable previews of each side. */
+interface ProjectValueChange {
+  /** Dotted key path relative to the section, e.g. `fillColor` or `labels.field`. */
+  path: string;
+  /** Preview of the earlier value; `undefined` when the key was absent. */
+  before?: string;
+  /** Preview of the later value; `undefined` when the key is now absent. */
+  after?: string;
+}
+/** Counts of embedded GeoJSON feature changes in one layer. */
+interface FeatureChangeSummary {
+  added: number;
+  removed: number;
+  modified: number;
+  unchanged: number;
+  /**
+   * How features were matched: `"id"` when every feature carries a unique
+   * `id`, `"geometry"` when none does (matched by geometry hash), `"mixed"`
+   * otherwise.
+   */
+  matchedBy: "id" | "geometry" | "mixed";
+}
+/** Changes to one layer between the two projects. */
+interface LayerDiff {
+  id: string;
+  /** Layer name in the later project (or the earlier one when removed). */
+  name: string;
+  /** Layer type in the later project (or the earlier one when removed). */
+  type: string;
+  status: "added" | "removed" | "changed";
+  /** Set when the layer was renamed. */
+  renamed?: {
+    before: string;
+    after: string;
+  };
+  /**
+   * Set when the layer changed position relative to the layers present in
+   * both projects (bottom-to-top indexes in each project's `layers`).
+   */
+  moved?: {
+    before: number;
+    after: number;
+  };
+  visibility?: {
+    before: boolean;
+    after: boolean;
+  };
+  opacity?: {
+    before: number;
+    after: number;
+  };
+  /** Style keys other than labels. */
+  style: ProjectValueChange[];
+  /** Label style keys (`style.labels.*`), without the `labels.` prefix. */
+  labels: ProjectValueChange[];
+  /** `filterExpression` and `quickFilters`. */
+  filter: ProjectValueChange[];
+  /** `type`, `source.*` and `sourcePath`. */
+  source: ProjectValueChange[];
+  /** Any other persisted layer field (popup, joins, metadata.*, ...). */
+  other: ProjectValueChange[];
+  /** Embedded GeoJSON feature changes; absent when the data is unchanged. */
+  features?: FeatureChangeSummary;
+  /** Feature count for an added or removed layer with embedded GeoJSON. */
+  featureCount?: number;
+}
+/** Changes to one plugin's project state. */
+interface PluginDiff {
+  id: string;
+  /** `added`/`removed` mean the plugin was activated/deactivated. */
+  status: "added" | "removed" | "changed";
+  changes: ProjectValueChange[];
+}
+/** The full structured difference between two projects. */
+interface ProjectDiff {
+  layers: {
+    added: LayerDiff[];
+    removed: LayerDiff[];
+    changed: LayerDiff[];
+    /** True when any layer present in both projects changed position. */
+    reordered: boolean;
+  };
+  camera: ProjectValueChange[];
+  basemap: ProjectValueChange[];
+  /** Map projection (`preferences.map.projection`). */
+  projection: ProjectValueChange[];
+  /** Other project preferences (`preferences.*` minus the projection). */
+  preferences: ProjectValueChange[];
+  plugins: PluginDiff[];
+  /** Plugin manifest URLs added to or removed from the project. */
+  pluginManifests: {
+    added: string[];
+    removed: string[];
+  };
+  /** Project name (`name`), `metadata.description` and other metadata keys. */
+  metadata: ProjectValueChange[];
+  /** Other top-level sections that changed (`legend`, `storymap`, ...). */
+  sections: string[];
+  /** Total number of reported changes; 0 means the projects are equivalent. */
+  changeCount: number;
+}
+/** Options for {@link diffProjects}. */
+interface ProjectDiffOptions {
+  /** Maximum characters of a before/after preview (default 80). */
+  maxPreviewLength?: number;
+}
+/**
+ * Deep structural equality for JSON-like values. A key whose value is
+ * `undefined` is treated as absent, so an in-memory record compares equal to
+ * its JSON round trip.
+ *
+ * @param a - First value.
+ * @param b - Second value.
+ * @returns True when the two values are structurally equal.
+ */
+declare function jsonValuesEqual(a: unknown, b: unknown): boolean;
+/**
+ * Render a bounded JSON-ish preview of a value without serializing more of it
+ * than the preview can show, so a large array or object costs no more than
+ * `maxLength` characters of work.
+ *
+ * @param value - The value to preview.
+ * @param maxLength - Maximum preview length; longer output ends with `…`.
+ * @returns The preview, or `undefined` for `undefined`.
+ */
+declare function previewValue(value: unknown, maxLength?: number): string | undefined;
+/**
+ * Count the features added, removed and modified between two feature
+ * collections. Features are matched by `id` when they carry one; id-less
+ * features are matched by geometry hash, so a feature whose properties
+ * changed but whose geometry did not counts as modified, while a moved
+ * id-less feature counts as one removal plus one addition.
+ *
+ * @param before - Earlier collection (absent counts as empty).
+ * @param after - Later collection (absent counts as empty).
+ * @returns The change counts.
+ */
+declare function diffFeatureCollections(before: FeatureCollection | null | undefined, after: FeatureCollection | null | undefined): FeatureChangeSummary;
+/**
+ * Compute a structured summary of what changed from `before` to `after`.
+ *
+ * Layers are matched by id. Embedded GeoJSON is compared per feature (by id,
+ * falling back to geometry hash) and each feature is hashed once per object,
+ * so diffing the same parsed project against several others reuses its
+ * hashes; callers keep and pass the same parsed project objects to benefit.
+ *
+ * @param before - The earlier project (e.g. an autosave snapshot).
+ * @param after - The later project (e.g. the current project).
+ * @param options - Preview length and other tuning.
+ * @returns The grouped change summary.
+ */
+declare function diffProjects(before: GeoLibreProject, after: GeoLibreProject, options?: ProjectDiffOptions): ProjectDiff;
+//#endregion
+export { collectTransitiveJoinSourceIds as $, LegendCustomEntry as $n, SQL_QUERY_SOURCE_KIND as $r, CollaborationParticipant as $t, normalizeMapViewState as A, scrubPrintLayoutForRemovedLayers as Ai, IndicatorAggregation as An, PopupFieldConfig as Ar, getActiveBodyRadiusRatio as At, normalizeWidgets as B, CesiumBasemapImagery as Bi, LayerGroup as Bn, ProjectBookmark as Br, AppCapabilities as Bt, isSessionOnlyLayer as C, PrintLayoutLegendEntry as Ci, EditorTrackingConfig as Cn, NonGeographicCoordinates as Cr, PLANET_SWITCHER_OPTIONS as Ct, normalizeDashboardColumns as D, normalizePrintLayoutConfig as Di, GeoLibreProject as Dn, ParticipantIdentity as Dr, bodyLengthToEarth as Dt, normalizeBookmarks as E, isDefaultPrintLayout as Ei, GeoLibreLayer as En, PROTOMAPS_BASEMAPS as Er, PlanetaryBasemapSectionId as Et, normalizeProcessingHistory as F, MultiPolygon as Fi, LabelStyle as Fn, ProcessingModelStep as Fr, getPlanetaryBasemapById as Ft, serializeProject as G, LayerMetadataLink as Gn, ProjectPluginState as Gr, AttributeFormValueMapEntry as Gt, portableWmsTileUrl as H, basemapToCesiumImagery as Hi, LayerJoinStats as Hn, ProjectComment as Hr, AppRole as Ht, normalizeProjectComments as I, Point as Ii, LabelTransform as In, ProcessingRerunRequest as Ir, getPlanetaryBasemapByStyleUrl as It, storyMapHasContent as J, LayerQuickFilter as Jn, QuickFilterDateKind as Jr, BLEND_MODES as Jt, serializeProjectWithLayerCache as K, LayerMetadataTemporalExtent as Kn, ProjectPreferences as Kr, AttributeFormWidget as Kt, normalizeProjectInteraction as L, Polygon as Li, LayerCapabilities as Ln, ProcessingRun as Lr, meanRadiusMeters as Lt, normalizeModels as M, FeatureCollection as Mi, LAYER_TYPES as Mn, PopupFieldKind as Mr, getActiveMeanRadiusMeters as Mt, normalizeObiaWorkbench as N, Geometry as Ni, LabelAnchor as Nn, ProcessingModel as Nr, getActiveSemiMajorAxisMeters as Nt, normalizeLegendConfig as O, printLayoutConfigsEqual as Oi, GeocodingPreferences as On, PointRenderer as Or, earthAreaToBody as Ot, normalizePrimaryRenderer as P, LineString as Pi, LabelDedupe as Pn, ProcessingModelGraph as Pr, getEllipsoid as Pt, cascadeLayerJoinRefresh as Q, LegendConfig as Qn, RuntimeEnvironmentVariable as Qr, CollaborationMode as Qt, normalizeSecondaryMapViews as R, CESIUM_BASEMAPS as Ri, LayerConnection as Rn, ProcessingRunKind as Rr, setActiveEllipsoidId as Rt, isAllowedPluginManifestUrl as S, PrintLayoutCorner as Si, DiagramType as Sn, NETCDF_IMAGE_SOURCE_KIND as Sr, PLANETARY_BASEMAP_SENTINEL_PREFIX as St, normalizeBookmarkGroups as T, createDefaultPrintLayout as Ti, FillPattern as Tn, PROJECT_VERSION as Tr, PlanetaryBasemapGroup as Tt, projectFromStore as U, normalizeCesiumBasemap as Ui, LayerLibraryEntry as Un, ProjectInteraction as Ur, AttributeFormConfig as Ut, parseProject as V, availableCesiumBasemap as Vi, LayerJoin as Vn, ProjectBookmarkGroup as Vr, AppPrivilege as Vt, resolveMapGrid as W, sameCesiumImagery as Wi, LayerMetadataContact as Wn, ProjectPluginControlPosition as Wr, AttributeFormFieldConfig as Wt, applyJoinsToLayer as X, LayerType as Xn, QuickFilterTextOperator as Xr, CollabInvite as Xt, ApplyLayerJoinsResult as Y, LayerStyle as Yn, QuickFilterKind as Yr, BlendMode as Yt, applyLayerJoins as Z, LayerVirtualField as Zn, RecentProjectEntry as Zr, CollaborationChatMessage as Zt, createEmptyProject as _, isDuckDBQueryLayer as _i, DashboardWidget as _n, ModelGraphNode as _r, ELLIPSOIDS as _t, ProjectDiffOptions as a, StoryChapterLocation as ai, CommentReply as an, MAX_DASHBOARD_COLUMNS as ar, batchDecodePolylines as at, detachProjectCopy as b, DEFAULT_PRINT_LAYOUT as bi, DiagramField as bn, ModelPortKind as br, PLANETARY_BASEMAPS as bt, diffProjects as c, StoryMap as ci, DEFAULT_DASHBOARD_COLUMNS as cn, MIN_DASHBOARD_COLUMNS as cr, encodePolyline as ct, CreateProjectOptions as d, StyleLibraryEntry as di, DEFAULT_MAP_GRID_LAYOUT as dn, MapProjection as dr, unescapePolyline as dt, SecondaryMapView as ei, CollaborationPresence as en, LegendCustomItem as er, layerJoinKey as et, DEFAULT_PROJECT_NAME as f, StyleLibraryEntryKind as fi, DEFAULT_PRIMARY_RENDERER as fn, MapRendererKind as fr, geojsonHasZCoordinates as ft, createDefaultMapView as g, detectNonGeographicCoordinates as gi, DUCKDB_VECTOR_ROUTE_BYTES as gn, ModelGraphEdge as gr, EARTH_MEAN_RADIUS_METERS as gt, applyProjectToStore as h, VectorStyleStop as hi, DUCKDB_VECTOR_FEATURE_WARN_COUNT as hn, MarkerShape as hr, DEFAULT_ELLIPSOID_ID as ht, ProjectDiff as i, StoryChapterAnimation as ii, CommentAuthor as in, LineDecoration as ir, PolylineDecodeResult as it, normalizeModelGraph as j, Feature as ji, LARGE_VECTOR_FEATURE_THRESHOLD as jn, PopupFieldFormat as jr, getActiveEllipsoid as jt, normalizeMapLayout as k, scrubPrintLayoutForLayers as ki, GeometryGeneratorType as kn, PopupDateFormat as kr, earthLengthToBody as kt, jsonValuesEqual as l, StorySlideMode as li, DEFAULT_LAYER_STYLE as ln, MapGridLayout as lr, geoJSONToPolylineStr as lt, ProjectLayerSerializationCache as m, VectorStyleMode as mi, DEFAULT_STORY_MAP as mn, MapViewState as mr, transformGeojsonElevation as mt, LayerDiff as n, StoryChapter as ni, CollaborationState as nn, LegendItemOverride as nr, stripJoinFields as nt, ProjectValueChange as o, StoryInsetPosition as oi, DEFAULT_BASEMAP as on, MAX_MAP_GRID_DIM as or, decodePolyline as ot, MAX_PROJECT_BOOKMARKS as p, VectorRule as pi, DEFAULT_PROJECT_PREFERENCES as pn, MapScaleUnit as pr, horizontalBbox as pt, serializeProjectWithLayerCacheAsync as q, LayerPopupConfig as qn, ProjectTemplateEntry as qr, BLANK_BASEMAP as qt, PluginDiff as r, StoryChapterAlignment as ri, CommentAnchor as rn, LegendPanelPosition as rr, PolylineBatchOptions as rt, diffFeatureCollections as s, StoryLayerOpacityChange as si, DEFAULT_BLEND_MODE as sn, MAX_PROCESSING_HISTORY as sr, decodePolylineDetailed as st, FeatureChangeSummary as t, StoryActiveSlideMode as ti, CollaborationRole as tn, LegendCustomShape as tr, reapplyLayerJoins as tt, previewValue as u, StrokeWidthUnit as ui, DEFAULT_LEGEND_CONFIG as un, MapPreferences as ur, polylineStrToGeoJSON as ut, createProjectLayerSerializationCache as v, shouldUseTiledRendering as vi, DashboardWidgetAggregation as vn, ModelGraphNodeKind as vr, Ellipsoid as vt, normalizeBlankBackgroundColor as w, PrintLayoutPageFilter as wi, FieldVisibility as wn, OPENFREEMAP_BASEMAPS as wr, PlanetaryBasemap as wt, hydrateProjectLayer as x, PrintLayoutConfig as xi, DiagramSizeMode as xn, ModelToolProvider as xr, PLANETARY_BASEMAP_GROUPS as xt, createProjectTemplate as y, styleValue as yi, DashboardWidgetType as yn, ModelGraphPort as yr, EllipsoidId as yt, normalizeStoryMap as z, CesiumBasemapId as zi, LayerDescriptiveMetadata as zn, ProcessingRunStatus as zr, AddTileLayerOptions as zt };
+//# sourceMappingURL=project-diff-BD23T4xv.d.mts.map