maplibre-gl-raster 0.2.0 → 0.2.2

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { _ as colormaps_default, a as debounce, c as throttle, d as percentileFromHistogram, f as readBandNames, g as COLORMAP_ROW_COUNT, h as COLORMAP_OPTIONS, i as classNames, l as MAX_SAMPLE_TILES, m as COLORMAP_NAMES, n as PALETTE_COLORMAP, o as formatNumericValue, p as loadGeoTIFF, r as clamp, s as generateId, t as RasterControl, u as computeAutoStats } from "./RasterControl-Dsq7VIl7.js";
+import { _ as colormaps_default, a as debounce, c as throttle, d as percentileFromHistogram, f as readBandNames, g as COLORMAP_ROW_COUNT, h as COLORMAP_OPTIONS, i as classNames, l as MAX_SAMPLE_TILES, m as COLORMAP_NAMES, n as PALETTE_COLORMAP, o as formatNumericValue, p as loadGeoTIFF, r as clamp, s as generateId, t as RasterControl, u as computeAutoStats, v as createResilientEpsgResolver } from "./RasterControl-BxGg08KC.js";
 import { a as Photometric, d as TiffTag, i as Compression, l as SampleFormat, o as PlanarConfiguration, s as Predictor } from "./decode-BL-qbDOV.js";
 //#region src/lib/raster/metadata.ts
 var SAMPLE_FORMAT_LABELS = {
@@ -218,6 +218,6 @@ function summarizeGeoTIFF(tiff) {
 	};
 }
 //#endregion
-export { COLORMAP_NAMES, COLORMAP_OPTIONS, COLORMAP_ROW_COUNT, MAX_SAMPLE_TILES, PALETTE_COLORMAP, RasterControl, clamp, classNames, colormaps_default as colormapsPngUrl, computeAutoStats, debounce, formatNumericValue, generateId, loadGeoTIFF, percentileFromHistogram, readBandNames, summarizeGeoTIFF, throttle };
+export { COLORMAP_NAMES, COLORMAP_OPTIONS, COLORMAP_ROW_COUNT, MAX_SAMPLE_TILES, PALETTE_COLORMAP, RasterControl, clamp, classNames, colormaps_default as colormapsPngUrl, computeAutoStats, createResilientEpsgResolver, debounce, formatNumericValue, generateId, loadGeoTIFF, percentileFromHistogram, readBandNames, summarizeGeoTIFF, throttle };
 
 //# sourceMappingURL=index.mjs.map

package/dist/react.mjs

@@ -1,4 +1,4 @@
-import { t as RasterControl } from "./RasterControl-Dsq7VIl7.js";
+import { t as RasterControl } from "./RasterControl-BxGg08KC.js";
 import { useCallback, useEffect, useRef, useState } from "react";
 //#region src/lib/core/RasterControlReact.tsx
 /**

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 import { default as colormapsPngUrl } from '@developmentseed/deck.gl-raster/gpu-modules/colormaps.png';
+import { EpsgResolver } from '@developmentseed/proj';
 import { GeoTIFF } from '@developmentseed/geotiff';
 import { IControl } from 'maplibre-gl';
 import { Map as Map_2 } from 'maplibre-gl';
@@ -125,6 +126,16 @@ export { colormapsPngUrl }
  * Promise. Caller guards against stale results. */
 export declare function computeAutoStats(tiff: GeoTIFF, signal: AbortSignal, onProgress?: (partial: AutoStats) => void): Promise<AutoStats>;
 
+/**
+ * Builds an {@link EpsgResolver} that resolves common CRS offline, delegates
+ * the rest to {@link ResilientEpsgResolverOptions.fallback} (epsg.io by
+ * default), and rethrows failures with a clear, actionable message.
+ *
+ * @param options - Optional fallback resolver override.
+ * @returns A resolver suitable for the COGLayer `epsgResolver` prop.
+ */
+export declare function createResilientEpsgResolver(options?: ResilientEpsgResolverOptions): EpsgResolver;
+
 export declare type CrsSummary = {
     /** EPSG code when the COG declares one; null for user-defined CRSes. */
     code: number | null;
@@ -153,6 +164,8 @@ export declare type CrsSummary = {
  */
 export declare function debounce<T extends (...args: unknown[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
 
+export { EpsgResolver }
+
 /**
  * Formats a numeric value with appropriate decimal places based on step size.
  *
@@ -539,6 +552,14 @@ export declare interface RasterControlOptions {
      * @default false
      */
     autoLoad?: boolean;
+    /**
+     * Resolves a GeoTIFF's numeric EPSG code to a projection definition used for
+     * reprojection. Defaults to {@link createResilientEpsgResolver}, which
+     * answers common CRS offline and looks the rest up from epsg.io. Supply a
+     * fully offline resolver (e.g. backed by a local EPSG database) to remove the
+     * network dependency entirely. Resolution failures surface as a layer error.
+     */
+    epsgResolver?: EpsgResolver;
 }
 
 /**
@@ -644,6 +665,16 @@ export declare type RasterStretch = 'linear' | 'log' | 'sqrt';
  */
 export declare function readBandNames(tiff: GeoTIFF): Map<number, string> | null;
 
+export declare interface ResilientEpsgResolverOptions {
+    /**
+     * Resolver used for EPSG codes without a built-in offline definition.
+     * Defaults to the upstream epsg.io-backed resolver. Supply a fully offline
+     * resolver (e.g. one backed by a local EPSG database) to remove the network
+     * dependency entirely.
+     */
+    fallback?: EpsgResolver;
+}
+
 /** Pure derivation from an already-loaded GeoTIFF: no fetches, no I/O. */
 export declare function summarizeGeoTIFF(tiff: MetadataInput): MetadataSummary;
 

package/dist/types/react.d.ts

@@ -1,4 +1,5 @@
 import { Dispatch } from 'react';
+import { EpsgResolver } from '@developmentseed/proj';
 import { IControl } from 'maplibre-gl';
 import { Map as Map_2 } from 'maplibre-gl';
 import { SetStateAction } from 'react';
@@ -302,6 +303,14 @@ export declare interface RasterControlOptions {
      * @default false
      */
     autoLoad?: boolean;
+    /**
+     * Resolves a GeoTIFF's numeric EPSG code to a projection definition used for
+     * reprojection. Defaults to {@link createResilientEpsgResolver}, which
+     * answers common CRS offline and looks the rest up from epsg.io. Supply a
+     * fully offline resolver (e.g. backed by a local EPSG database) to remove the
+     * network dependency entirely. Resolution failures surface as a layer error.
+     */
+    epsgResolver?: EpsgResolver;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maplibre-gl-raster",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "A MapLibre GL JS plugin for visualizing local and remote raster datasets (GeoTIFF/COG)",
   "type": "module",
   "main": "./dist/index.mjs",