geoai 1.0.4 → 1.0.5

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.5] - 2026-07-15
+
+### Added
+- WMS map provider with OGC GetMap support (EPSG:3857 bbox, WMS 1.1.1 / 1.3.0)
+- `examples/06-wms-quickstart` — NRW orthophotos (`nw_dop_rgb`), draw-to-detect, NRW geocoder
+- Interactive TMS and WMS providers in `live-examples-nextjs` task demos
+- WMS documentation (`wms.mdx`), map-providers table update, and 17 WMS tests (including pipeline inference)
+- Project roadmap (`_docs4devs/ROADMAP.md`) for use-case guides and quantization pipeline backlog
+
+### Changed
+- `live-examples-nextjs` pins `geoai` to local `build/` for WMS/TMS provider development
+
 ## [1.0.4] - 2026-07-11
 
 ### Added

package/README.md

@@ -40,12 +40,12 @@ You can also use GeoAI directly in the browser via CDN:
 
 #### Unpkg CDN
 ```html
-<script src="https://unpkg.com/geoai@1.0.3/geoai.js"></script>
+<script src="https://unpkg.com/geoai@1.0.5/geoai.js"></script>
 ```
 
 #### jsDelivr CDN
 ```html
-<script src="https://cdn.jsdelivr.net/npm/geoai@1.0.3/geoai.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/geoai@1.0.5/geoai.min.js"></script>
 ```
 
 When using CDN, the library is available globally as `geoai`.
@@ -235,6 +235,7 @@ const pipeline = await geoai.pipeline([{ task: "object-detection" }], {
 
 - **Documentation**: [docs.geobase.app/geoai](https://docs.geobase.app/geoai) - Comprehensive documentation, examples, and API reference
 - **Live Examples**: [docs.geobase.app/geoai-live](https://docs.geobase.app/geoai-live) - Interactive examples and demos
+- **Roadmap**: [_docs4devs/ROADMAP.md](_docs4devs/ROADMAP.md) - Planned docs, quantization pipeline, and related backlog
 - **Community**: [GitHub Discussions](https://github.com/decision-labs/geoai.js/discussions) - Ask questions, share ideas, and connect with other developers
 - **Code**: [GitHub Repository](https://github.com/decision-labs/geoai.js) - Source code and contributions
 - **Issues**: [GitHub Issues](https://github.com/decision-labs/geoai.js/issues) - Report bugs and request features

package/geoai.js

@@ -390,7 +390,7 @@ const postProcessYoloOutput = (model_outputs, pixel_values, rawImage, id2label)
   return model_output;
 };
 const parametersChanged = (instance, model_id, providerParams, modelParams) => {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
   if (instance.model_id !== model_id) {
     return true;
   }
@@ -419,6 +419,12 @@ const parametersChanged = (instance, model_id, providerParams, modelParams) => {
       if (((_h = instance.providerParams) == null ? void 0 : _h.baseUrl) !== (providerParams == null ? void 0 : providerParams.baseUrl)) {
         return true;
       }
+      break;
+    case "wms":
+      if (((_i = instance.providerParams) == null ? void 0 : _i.baseUrl) !== (providerParams == null ? void 0 : providerParams.baseUrl) || ((_j = instance.providerParams) == null ? void 0 : _j.layers) !== (providerParams == null ? void 0 : providerParams.layers) || ((_k = instance.providerParams) == null ? void 0 : _k.version) !== (providerParams == null ? void 0 : providerParams.version) || ((_l = instance.providerParams) == null ? void 0 : _l.crs) !== (providerParams == null ? void 0 : providerParams.crs)) {
+        return true;
+      }
+      break;
   }
   if (modelParams) {
     const instanceModelParams = instance.modelParams || {};
@@ -1283,6 +1289,97 @@ class Tms extends MapSource {
     return url;
   }
 }
+function formatWmsBbox(bbox2, crs, version) {
+  const [minX, minY, maxX, maxY] = bbox2;
+  if (version === "1.3.0" && crs === "EPSG:4326") {
+    return `${minY},${minX},${maxY},${maxX}`;
+  }
+  return `${minX},${minY},${maxX},${maxY}`;
+}
+function getTileBbox(tileCoords, crs, tileSize) {
+  const [x, y, z] = tileCoords;
+  if (crs === "EPSG:3857") {
+    const toMeters = pixelsToMeters;
+    const min = toMeters([x * tileSize, y * tileSize, z], tileSize);
+    const max = toMeters([(x + 1) * tileSize, (y + 1) * tileSize, z], tileSize);
+    return [
+      Math.min(min[0], max[0]),
+      Math.min(min[1], max[1]),
+      Math.max(min[0], max[0]),
+      Math.max(min[1], max[1])
+    ];
+  }
+  return tileToBBox(tileCoords);
+}
+function buildWmsGetMapUrl(config, tileCoords) {
+  const version = config.version ?? "1.1.1";
+  const crs = config.crs ?? "EPSG:3857";
+  const tileSize = config.tileSize ?? 256;
+  const bbox2 = getTileBbox(tileCoords, crs, tileSize);
+  const bboxParam = formatWmsBbox(bbox2, crs, version);
+  const params = {
+    SERVICE: "WMS",
+    REQUEST: "GetMap",
+    VERSION: version,
+    LAYERS: config.layers,
+    STYLES: config.styles ?? "",
+    FORMAT: config.format ?? "image/png",
+    WIDTH: tileSize.toString(),
+    HEIGHT: tileSize.toString(),
+    BBOX: bboxParam,
+    ...version === "1.3.0" ? { CRS: crs } : { SRS: crs },
+    ...config.transparent ? { TRANSPARENT: "TRUE" } : {},
+    ...config.extraParams ?? {}
+  };
+  const url = new URL(config.baseUrl);
+  for (const [key, value] of Object.entries(params)) {
+    url.searchParams.set(key, value);
+  }
+  return url.toString();
+}
+class Wms extends MapSource {
+  constructor(config) {
+    super();
+    __publicField(this, "baseUrl");
+    __publicField(this, "layers");
+    __publicField(this, "version");
+    __publicField(this, "crs");
+    __publicField(this, "format");
+    __publicField(this, "styles");
+    __publicField(this, "transparent");
+    __publicField(this, "attribution");
+    __publicField(this, "tileSize");
+    __publicField(this, "headers");
+    __publicField(this, "extraParams");
+    this.baseUrl = config.baseUrl;
+    this.layers = config.layers;
+    this.version = config.version ?? "1.1.1";
+    this.crs = config.crs ?? "EPSG:3857";
+    this.format = config.format ?? "image/png";
+    this.styles = config.styles ?? "";
+    this.transparent = config.transparent ?? false;
+    this.attribution = config.attribution ?? "WMS Provider";
+    this.tileSize = config.tileSize ?? 256;
+    this.headers = config.headers;
+    this.extraParams = config.extraParams;
+  }
+  getTileUrlFromTileCoords(tileCoords, instance) {
+    return buildWmsGetMapUrl(
+      {
+        baseUrl: instance.baseUrl,
+        layers: instance.layers,
+        version: instance.version,
+        crs: instance.crs,
+        format: instance.format,
+        styles: instance.styles,
+        transparent: instance.transparent,
+        tileSize: instance.tileSize,
+        extraParams: instance.extraParams
+      },
+      tileCoords
+    );
+  }
+}
 class BaseModel {
   constructor(model_id, providerParams, modelParams) {
     __publicField(this, "providerParams");
@@ -1337,6 +1434,21 @@ class BaseModel {
           scheme: this.providerParams.scheme
         });
         break;
+      case "wms":
+        this.dataProvider = new Wms({
+          baseUrl: this.providerParams.baseUrl,
+          layers: this.providerParams.layers,
+          version: this.providerParams.version,
+          crs: this.providerParams.crs,
+          format: this.providerParams.format,
+          styles: this.providerParams.styles,
+          transparent: this.providerParams.transparent,
+          attribution: this.providerParams.attribution,
+          tileSize: this.providerParams.tileSize,
+          headers: this.providerParams.headers,
+          extraParams: this.providerParams.extraParams
+        });
+        break;
       case "sentinel":
         throw new Error("Sentinel provider not implemented yet");
       default:

package/index.d.ts

@@ -162,10 +162,46 @@ declare class Tms extends MapSource {
 		number
 	], instance: Tms): string;
 }
+export type WmsVersion = "1.1.1" | "1.3.0";
+export type WmsCrs = "EPSG:3857" | "EPSG:4326";
+export interface WmsGetMapConfig {
+	baseUrl: string;
+	layers: string;
+	version?: WmsVersion;
+	crs?: WmsCrs;
+	format?: string;
+	styles?: string;
+	transparent?: boolean;
+	tileSize?: number;
+	attribution?: string;
+	headers?: Record<string, string>;
+	extraParams?: Record<string, string>;
+}
+export interface WmsConfig extends WmsGetMapConfig {
+}
+declare class Wms extends MapSource {
+	baseUrl: string;
+	layers: string;
+	version: WmsVersion;
+	crs: WmsCrs;
+	format: string;
+	styles: string;
+	transparent: boolean;
+	attribution: string;
+	tileSize: number;
+	headers?: Record<string, string>;
+	extraParams?: Record<string, string>;
+	constructor(config: WmsConfig);
+	protected getTileUrlFromTileCoords(tileCoords: [
+		number,
+		number,
+		number
+	], instance: Wms): string;
+}
 declare abstract class BaseModel {
 	protected static instance: BaseModel | null;
 	protected providerParams: ProviderParams;
-	protected dataProvider: Mapbox | Geobase | Esri | Tms | undefined;
+	protected dataProvider: Mapbox | Geobase | Esri | Tms | Wms | undefined;
 	protected model_id: string;
 	protected initialized: boolean;
 	protected modelParams?: PretrainedModelOptions;
@@ -470,6 +506,20 @@ export type TmsParams = {
 	headers?: Record<string, string>;
 	scheme?: "WebMercator" | "TMS";
 };
+export type WmsParams = {
+	provider: "wms";
+	baseUrl: string;
+	layers: string;
+	version?: "1.1.1" | "1.3.0";
+	crs?: "EPSG:3857" | "EPSG:4326";
+	format?: string;
+	styles?: string;
+	transparent?: boolean;
+	attribution?: string;
+	tileSize?: number;
+	headers?: Record<string, string>;
+	extraParams?: Record<string, string>;
+};
 export interface InferenceInputs {
 	polygon: GeoJSON.Feature;
 	classLabel?: string;
@@ -488,7 +538,7 @@ export interface InferenceParams {
 	postProcessingParams?: PostProcessingParams;
 	mapSourceParams?: MapSourceParams;
 }
-export type ProviderParams = MapboxParams | SentinelParams | GeobaseParams | EsriParams | TmsParams;
+export type ProviderParams = MapboxParams | SentinelParams | GeobaseParams | EsriParams | TmsParams | WmsParams;
 export type HuggingFaceModelTask = "mask-generation" | "zero-shot-object-detection" | "zero-shot-image-classification" | "object-detection" | "oriented-object-detection" | "image-feature-extraction";
 export type GeobaseAiModelTask = "damage-assessment" | "vegetation-classification" | "land-cover-classification" | "land-use-classification" | "land-cover-change-detection" | "land-use-change-detection" | "solar-panel-detection" | "ship-detection" | "car-detection" | "wetland-segmentation" | "building-detection" | "oil-storage-tank-detection" | "building-footprint-segmentation";
 export type ModelInstance = MaskGeneration | ZeroShotObjectDetection | ObjectDetection | OrientedObjectDetection | LandCoverClassification | SolarPanelDetection | ShipDetection | CarDetection | WetLandSegmentation | BuildingDetection | OilStorageTankDetection | BuildingFootPrintSegmentation | ImageFeatureExtraction;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geoai",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "A JavaScript library for running Geo AI models in frontend applications",
   "keywords": [
     "geoai",