maplibre-gl-raster 0.6.0 → 0.6.2

package/README.md

@@ -114,6 +114,9 @@ The main control class implementing MapLibre's `IControl` interface.
 | `interleaved` | `boolean` | `true`        | Render the deck.gl overlay interleaved with the basemap layers            |
 | `defaultUrl`  | `string`  | `''`          | Prefills the Add data URL input (not loaded until the user clicks Load)  |
 | `autoLoad`    | `boolean` | `false`       | Load `defaultUrl` automatically when the control is added to the map     |
+| `sampleData`  | `RasterSampleDataset[]` | - | Sample COGs offered as a "Load sample data" dropdown above the URL input; picking one fills the input (hidden when empty) |
+| `sampleDataLabel` | `string` | `'Load sample data...'` | Placeholder shown in the sample-data dropdown |
+| `closeOnOutsideClick` | `boolean` | `true` | Collapse the panel when clicking outside it; set `false` to close only via the header button |
 | `engine`      | `RenderEngine` | `'maplibre-gl-raster'` | Initial rendering backend; switchable at runtime from the panel    |
 
 #### Raster Methods

package/dist/{RasterControl-BRFVTd2x.js → RasterControl-CjnDWQDU.js}

@@ -2646,7 +2646,7 @@ var SourceMemory = class SourceMemory {
 //#region node_modules/@developmentseed/geotiff/dist/crs.js
 var PROJJSON_SCHEMA = "https://proj.org/schemas/v0.7/projjson.schema.json";
 var MODEL_TYPE_PROJECTED$1 = 1;
-var MODEL_TYPE_GEOGRAPHIC = 2;
+var MODEL_TYPE_GEOGRAPHIC$1 = 2;
 var USER_DEFINED$1 = 32767;
 var CT_TRANSVERSE_MERCATOR = 1;
 var CT_TRANSVERSE_MERCATOR_SOUTH = 2;
@@ -2701,7 +2701,7 @@ var LINEAR_UNIT = {
 function crsFromGeoKeys(gkd) {
 	const modelType = gkd.modelType;
 	if (modelType === MODEL_TYPE_PROJECTED$1) return _projectedCrs(gkd);
-	if (modelType === MODEL_TYPE_GEOGRAPHIC) return _geographicCrs(gkd);
+	if (modelType === MODEL_TYPE_GEOGRAPHIC$1) return _geographicCrs(gkd);
 	throw new Error(`Unsupported GeoTIFF model type: ${modelType}`);
 }
 function _geographicCrs(gkd) {
@@ -4555,8 +4555,10 @@ var COLORMAP_OPTIONS = COLORMAP_NAMES.map((name) => ({
 //#endregion
 //#region src/lib/raster/repair-geokeys.ts
 var MODEL_TYPE_PROJECTED = 1;
+var MODEL_TYPE_GEOGRAPHIC = 2;
 var USER_DEFINED = 32767;
 var EPSG_WEB_MERCATOR = 3857;
+var WKT_ROOT = /\b(?:PROJCS|PROJCRS|GEOGCS|GEOGCRS|GEOCCS|GEODCRS|BOUNDCRS|COMPD_CS|COMPOUNDCRS|VERT_CS|VERTCRS|LOCAL_CS|FITTED_CS)\s*\[/i;
 var WEB_MERCATOR_ALIASES = new Set([
 	3785,
 	900913,
@@ -4572,6 +4574,26 @@ function citationText(gkd) {
 	].filter((value) => typeof value === "string").join(" ");
 }
 /**
+* Pull an embedded WKT (or ESRI PE string) definition out of a citation geo
+* key, if one is present. The projected citation is preferred because that is
+* where ArcGIS writes the full `PROJCS[...]` for an exotic projection; the
+* generic and geodetic citations are checked as fallbacks. Returns the WKT from
+* the first matching root keyword onward (dropping any `ESRI PE String = `
+* prefix), or `null` when no citation carries one.
+*/
+function wktFromCitation(gkd) {
+	for (const citation of [
+		gkd.projectedCitation,
+		gkd.citation,
+		gkd.geodeticCitation
+	]) {
+		if (typeof citation !== "string") continue;
+		const match = WKT_ROOT.exec(citation);
+		if (match) return citation.slice(match.index);
+	}
+	return null;
+}
+/**
 * Repair GeoTIFF CRS geo keys so {@link import('@developmentseed/geotiff').Overview.crs}
 * resolves them to the right projection, in place. Two problems are fixed:
 *
@@ -4598,6 +4620,15 @@ function citationText(gkd) {
 * untouched. Must run before any `Overview.crs` access (which caches its
 * result), so callers invoke it immediately after opening the GeoTIFF.
 *
+* 3. **A projection the geo keys cannot express.** Some projections have no
+*    `ProjCoordTransGeoKey` (e.g. equal-area world CRSes such as ESRI:54009
+*    World Mollweide), so ArcGIS/GDAL leave the model type user-defined and the
+*    full definition only in the citation as an `ESRI PE String = PROJCS[...]`
+*    WKT. `crsFromGeoKeys` then throws `Unsupported GeoTIFF model type: 32767`.
+*    {@link recoverCrsFromWktCitation} seeds the cached CRS from that WKT so the
+*    consuming layer (which calls `parseWkt`/proj4) builds the projection from
+*    it. This is projection-agnostic: proj4 understands the ESRI/OGC names.
+*
 * @param tiff - The opened GeoTIFF to repair in place.
 */
 function repairUserDefinedProjectedCrs(tiff) {
@@ -4608,6 +4639,30 @@ function repairUserDefinedProjectedCrs(tiff) {
 		else if (projectedIsUserDefined && gkd.projMethod !== null && WEB_MERCATOR_CITATION.test(citationText(gkd))) gkd.projectedCRS = EPSG_WEB_MERCATOR;
 		if ((gkd.modelType === null || gkd.modelType === USER_DEFINED) && gkd.projMethod !== null) gkd.modelType = MODEL_TYPE_PROJECTED;
 	}
+	recoverCrsFromWktCitation(tiff);
+}
+/**
+* Seed the GeoTIFF's cached CRS from an embedded WKT citation when the geo keys
+* still cannot describe the projection after {@link repairUserDefinedProjectedCrs}
+* has run. `crsFromGeoKeys` only accepts model type 1 (projected) or 2
+* (geographic) and throws otherwise; when the model type is still user-defined
+* (no `ProjMethodGeoKey` to promote it) the only definition is the WKT in the
+* citation. Setting the (lazily computed, single-shot) `_crs` cache to that WKT
+* string makes the getter return it instead of throwing, and the consuming layer
+* resolves it through `parseWkt` (wkt-parser + proj4).
+*
+* No-ops when the model type is resolvable, when the CRS is already cached, or
+* when no citation carries a WKT (so the original, descriptive error still
+* surfaces).
+*/
+function recoverCrsFromWktCitation(tiff) {
+	const gkd = tiff.overviews[0]?.gkd;
+	if (!gkd) return;
+	if (gkd.modelType === MODEL_TYPE_PROJECTED || gkd.modelType === MODEL_TYPE_GEOGRAPHIC) return;
+	const wkt = wktFromCitation(gkd);
+	if (!wkt) return;
+	const cache = tiff;
+	if (cache._crs === void 0) cache._crs = wkt;
 }
 //#endregion
 //#region src/lib/raster/load-geotiff.ts
@@ -19036,6 +19091,68 @@ var AddDataSection = class {
 			if (e.key === "Enter") submitUrl();
 		});
 		const urlRow = el("div", { className: "mlr-row" }, input, loadBtn);
+		const samples = options.sampleData ?? [];
+		let sampleRow;
+		if (samples.length > 0) {
+			const placeholder = options.sampleDataLabel ?? "Load sample data...";
+			const triggerLabel = el("span", {
+				className: "mlr-sample-trigger-label",
+				text: placeholder
+			});
+			const trigger = el("button", {
+				className: "mlr-sample-trigger",
+				type: "button",
+				ariaLabel: placeholder,
+				attrs: {
+					"aria-haspopup": "listbox",
+					"aria-expanded": "false"
+				}
+			}, triggerLabel, el("span", {
+				className: "mlr-sample-caret",
+				text: "▾"
+			}));
+			const menu = el("div", {
+				className: "mlr-sample-menu",
+				attrs: { role: "listbox" }
+			});
+			menu.hidden = true;
+			let menuOpen = false;
+			const setMenuOpen = (open) => {
+				menuOpen = open;
+				menu.hidden = !open;
+				trigger.setAttribute("aria-expanded", String(open));
+				trigger.classList.toggle("open", open);
+				if (open) menu.firstElementChild?.focus();
+			};
+			for (const sample of samples) {
+				const option = el("button", {
+					className: "mlr-sample-option",
+					type: "button",
+					text: sample.label,
+					title: sample.url,
+					attrs: { role: "option" }
+				});
+				option.addEventListener("click", () => {
+					setMenuOpen(false);
+					trigger.focus();
+					input.value = sample.url;
+					loadBtn.disabled = input.value.trim().length === 0;
+				});
+				menu.appendChild(option);
+			}
+			trigger.addEventListener("click", () => setMenuOpen(!menuOpen));
+			sampleRow = el("div", { className: "mlr-sample-row" }, trigger, menu);
+			sampleRow.addEventListener("keydown", (e) => {
+				if (e.key === "Escape" && menuOpen) {
+					setMenuOpen(false);
+					trigger.focus();
+				}
+			});
+			sampleRow.addEventListener("focusout", (e) => {
+				const next = e.relatedTarget;
+				if (!next || !sampleRow.contains(next)) setMenuOpen(false);
+			});
+		}
 		const fileInput = el("input", {
 			type: "file",
 			ariaLabel: "raster-file",
@@ -19078,7 +19195,7 @@ var AddDataSection = class {
 		this.el = el("div", { className: "mlr-section mlr-add-data" }, el("div", {
 			className: "mlr-section-title",
 			text: "Add data"
-		}), urlRow, dropZone, beforeIdInput);
+		}), ...sampleRow ? [sampleRow] : [], urlRow, dropZone, beforeIdInput);
 	}
 };
 //#endregion
@@ -20030,6 +20147,8 @@ var PanelUI = class {
 		this._engine = engine;
 		const addData = new AddDataSection({
 			initialUrl: options?.defaultUrl,
+			sampleData: options?.sampleData,
+			sampleDataLabel: options?.sampleDataLabel,
 			onAddUrl: (url, beforeId) => {
 				this._manager.addRaster(url, { beforeId }).catch(() => {});
 			},
@@ -20307,6 +20426,9 @@ var DEFAULT_OPTIONS = {
 	interleaved: true,
 	defaultUrl: "",
 	autoLoad: false,
+	sampleData: [],
+	sampleDataLabel: "Load sample data...",
+	closeOnOutsideClick: true,
 	engine: "maplibre-gl-raster",
 	epsgResolver: createResilientEpsgResolver()
 };
@@ -20394,6 +20516,8 @@ var RasterControl = class {
 		const autoLoading = this._options.autoLoad && !!this._options.defaultUrl;
 		if (content) this._panelUI = new PanelUI(content, this._layerManager, {
 			defaultUrl: autoLoading ? "" : this._options.defaultUrl,
+			sampleData: this._options.sampleData,
+			sampleDataLabel: this._options.sampleDataLabel,
 			inspect: {
 				onToggle: () => this._inspector?.toggle(),
 				isActive: () => this._inspector?.enabled ?? false
@@ -20912,13 +21036,15 @@ var RasterControl = class {
 	* Setup event listeners for panel positioning and click-outside behavior.
 	*/
 	_setupEventListeners() {
-		this._clickOutsideHandler = (e) => {
-			const target = e.target;
-			if (!target.isConnected) return;
-			if (this._inspector?.enabled) return;
-			if (this._container && this._panel && !this._container.contains(target) && !this._panel.contains(target)) this.collapse();
-		};
-		document.addEventListener("click", this._clickOutsideHandler);
+		if (this._options.closeOnOutsideClick !== false) {
+			this._clickOutsideHandler = (e) => {
+				const target = e.target;
+				if (!target.isConnected) return;
+				if (this._inspector?.enabled) return;
+				if (this._container && this._panel && !this._container.contains(target) && !this._panel.contains(target)) this.collapse();
+			};
+			document.addEventListener("click", this._clickOutsideHandler);
+		}
 		this._resizeHandler = () => {
 			if (!this._state.collapsed) this._updatePanelPosition();
 		};
@@ -20991,4 +21117,4 @@ var RasterControl = class {
 //#endregion
 export { MAX_SAMPLE_TILES as C, createResilientEpsgResolver as D, readBandNames as E, statsForBand as S, percentileFromHistogram as T, COLORMAP_OPTIONS as _, isKnownColormap as a, colormaps_default as b, clamp as c, formatNumericValue as d, generateId as f, COLORMAP_NAMES as g, COLORMAP_DISPLAY_NAMES as h, PALETTE_COLORMAP as i, classNames as l, loadGeoTIFF as m, Colorbar as n, loadColormapSprite as o, throttle as p, readPixelValues as r, sampleColormapStops as s, RasterControl as t, debounce as u, COLORMAP_ROW_COUNT as v, computeAutoStats as w, autoRangeFor as x, colormapDisplayName as y };
 
-//# sourceMappingURL=RasterControl-BRFVTd2x.js.map
+//# sourceMappingURL=RasterControl-CjnDWQDU.js.map