@loaders.gl/wms 3.3.0-alpha.8 → 3.3.0

package/dist/lib/data-sources/image-services/wms-service.d.ts

@@ -0,0 +1,188 @@
+import type { ImageType } from '@loaders.gl/images';
+import type { ImageSourceMetadata, GetImageParameters } from '../image-source';
+import { ImageSource } from '../image-source';
+import { ImageServiceProps } from './image-service';
+import type { WMSCapabilities, WMSFeatureInfo, WMSLayerDescription } from '../../wms/wms-types';
+type WMSCommonParameters = {
+    /** In case the endpoint supports multiple services */
+    service?: 'WMS';
+    /** In case the endpoint supports multiple WMS versions */
+    version?: '1.1.1' | '1.3.0';
+};
+export type WMSGetCapabilitiesParameters = WMSCommonParameters & {
+    /** Request type */
+    request?: 'GetCapabilities';
+};
+export type WMSGetMapParameters = WMSCommonParameters & {
+    /** Request type */
+    request?: 'GetMap';
+    /** Layers to render */
+    layers: string | string[];
+    /** Styling */
+    styles?: unknown;
+    /** bounding box of the requested map image */
+    bbox: [number, number, number, number];
+    /** pixel width of returned image */
+    width: number;
+    /** pixels */
+    height: number;
+    /** srs for the image (not the bounding box) */
+    srs?: string;
+    /** requested format for the return image */
+    format?: 'image/png';
+};
+export type WMSGetFeatureInfoParameters = WMSCommonParameters & {
+    /** Request type */
+    request?: 'GetFeatureInfo';
+    /** x coordinate for the feature info request */
+    x: number;
+    /** y coordinate for the feature info request */
+    y: number;
+    /** list of layers to query (could be different from rendered layers) */
+    query_layers: string[];
+    /** MIME type of returned feature info */
+    info_format?: 'text/plain' | 'application/vnd.ogc.gml';
+    /** Layers to render */
+    layers: string[];
+    /** Styling */
+    styles?: unknown;
+    /** bounding box of the requested map image */
+    bbox: [number, number, number, number];
+    /** pixel width of returned image */
+    width: number;
+    /** pixels */
+    height: number;
+    /** srs for the image (not the bounding box) */
+    srs?: string;
+    /** requested format for the return image */
+    format?: 'image/png';
+};
+export type WMSDescribeLayerParameters = WMSCommonParameters & {
+    /** Request type */
+    request?: 'DescribeLayer';
+};
+export type WMSGetLegendGraphicParameters = WMSCommonParameters & {
+    /** Request type */
+    request?: 'GetLegendGraphic';
+};
+/**
+ * The WMSService class provides
+ * - provides type safe methods to form URLs to a WMS service
+ * - provides type safe methods to query and parse results (and errors) from a WMS service
+ * - implements the ImageService interface
+ * @note Only the URL parameter conversion is supported. XML posts are not supported.
+ */
+export declare class WMSService extends ImageSource {
+    static type: 'wms';
+    static testURL: (url: string) => boolean;
+    props: Required<ImageServiceProps>;
+    fetch: (url: string, options?: RequestInit) => Promise<Response>;
+    capabilities: WMSCapabilities | null;
+    /** A list of loaders used by the WMSService methods */
+    readonly loaders: ({
+        id: string;
+        name: string;
+        module: string;
+        version: any;
+        worker: boolean;
+        extensions: string[];
+        mimeTypes: string[];
+        testText: (text: string) => boolean;
+        options: {
+            wms: {
+                throwOnError: boolean;
+            };
+        };
+        parse: (arrayBuffer: ArrayBuffer, options?: import("../../../wms-error-loader").WMSLoaderOptions | undefined) => Promise<string>;
+        parseSync: (arrayBuffer: ArrayBuffer, options?: import("../../../wms-error-loader").WMSLoaderOptions | undefined) => string;
+        parseTextSync: (text: string, options?: import("../../../wms-error-loader").WMSLoaderOptions | undefined) => string;
+    } | {
+        id: string;
+        name: string;
+        module: string;
+        version: any;
+        worker: boolean;
+        extensions: string[];
+        mimeTypes: string[];
+        testText: (text: string) => boolean;
+        options: {
+            wms: {};
+        };
+        /** In case the endpoint supports multiple services */
+        parse: (arrayBuffer: ArrayBuffer, options?: import("../../../wms-capabilities-loader").WMSLoaderOptions | undefined) => Promise<WMSCapabilities>;
+        parseTextSync: (text: string, options?: import("../../../wms-capabilities-loader").WMSLoaderOptions | undefined) => WMSCapabilities;
+    } | {
+        id: string;
+        module: string;
+        name: string;
+        version: any;
+        mimeTypes: string[];
+        extensions: string[];
+        parse: typeof import("modules/images/src/lib/parsers/parse-image").default;
+        tests: ((arrayBuffer: any) => boolean)[];
+        options: import("@loaders.gl/images").ImageLoaderOptions;
+    } | {
+        id: string;
+        name: string;
+        parse: (arrayBuffer: ArrayBuffer, options?: import("../../../wms-capabilities-loader").WMSLoaderOptions | undefined) => Promise<WMSFeatureInfo>;
+        parseTextSync: (text: string, options?: import("../../../wms-capabilities-loader").WMSLoaderOptions | undefined) => WMSFeatureInfo;
+        module: string;
+        version: any;
+        worker: boolean;
+        extensions: string[];
+        mimeTypes: string[];
+        testText: (text: string) => boolean;
+        options: {
+            wms: {};
+        };
+    } | {
+        id: string;
+        name: string;
+        parse: (arrayBuffer: ArrayBuffer, options?: import("../../../wms-capabilities-loader").WMSLoaderOptions | undefined) => Promise<WMSLayerDescription>;
+        parseTextSync: (text: string, options?: import("../../../wms-capabilities-loader").WMSLoaderOptions | undefined) => WMSLayerDescription;
+        module: string;
+        version: any;
+        worker: boolean;
+        extensions: string[];
+        mimeTypes: string[];
+        testText: (text: string) => boolean;
+        options: {
+            wms: {};
+        };
+    })[];
+    /** Create a WMSService */
+    constructor(props: ImageServiceProps);
+    getMetadata(): Promise<ImageSourceMetadata>;
+    getImage(parameters: GetImageParameters): Promise<ImageType>;
+    /** Get Capabilities */
+    getCapabilities(wmsParameters?: WMSGetCapabilitiesParameters, vendorParameters?: Record<string, unknown>): Promise<WMSCapabilities>;
+    /** Get a map image */
+    getMap(options: WMSGetMapParameters, vendorParameters?: Record<string, unknown>): Promise<ImageType>;
+    /** Get Feature Info for a coordinate */
+    getFeatureInfo(options: WMSGetFeatureInfoParameters, vendorParameters?: Record<string, unknown>): Promise<WMSFeatureInfo>;
+    /** Get Feature Info for a coordinate */
+    getFeatureInfoText(options: WMSGetFeatureInfoParameters, vendorParameters?: Record<string, unknown>): Promise<string>;
+    /** Get more information about a layer */
+    describeLayer(options: WMSDescribeLayerParameters, vendorParameters?: Record<string, unknown>): Promise<WMSLayerDescription>;
+    /** Get an image with a semantic legend */
+    getLegendGraphic(options: WMSGetLegendGraphicParameters, vendorParameters?: Record<string, unknown>): Promise<ImageType>;
+    /** Generate a URL for the GetCapabilities request */
+    getCapabilitiesURL(wmsParameters?: WMSGetCapabilitiesParameters, vendorParameters?: Record<string, unknown>): string;
+    /** Generate a URL for the GetMap request */
+    getMapURL(wmsParameters: WMSGetMapParameters, vendorParameters?: Record<string, unknown>): string;
+    /** Generate a URL for the GetFeatureInfo request */
+    getFeatureInfoURL(wmsParameters: WMSGetFeatureInfoParameters, vendorParameters?: Record<string, unknown>): string;
+    /** Generate a URL for the GetFeatureInfo request */
+    describeLayerURL(wmsParameters: WMSDescribeLayerParameters, vendorParameters?: Record<string, unknown>): string;
+    getLegendGraphicURL(wmsParameters: WMSGetLegendGraphicParameters, vendorParameters?: Record<string, unknown>): string;
+    /**
+     * @note case _getWMSUrl may need to be overridden to handle certain backends?
+     * */
+    protected _getWMSUrl(options: Record<string, unknown>, vendorParameters?: Record<string, unknown>): string;
+    /** Checks for and parses a WMS XML formatted ServiceError and throws an exception */
+    protected _checkResponse(response: Response, arrayBuffer: ArrayBuffer): void;
+    /** Error situation detected */
+    protected _parseError(arrayBuffer: ArrayBuffer): Error;
+}
+export {};
+//# sourceMappingURL=wms-service.d.ts.map

package/dist/lib/data-sources/image-services/wms-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wms-service.d.ts","sourceRoot":"","sources":["../../../../src/lib/data-sources/image-services/wms-service.ts"],"names":[],"mappings":"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"}

package/dist/lib/data-sources/image-services/wms-service.js

@@ -0,0 +1,218 @@
+"use strict";
+// loaders.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WMSService = void 0;
+const images_1 = require("@loaders.gl/images");
+const image_source_1 = require("../image-source");
+const image_service_1 = require("./image-service");
+const wms_capabilities_loader_1 = require("../../../wms-capabilities-loader");
+const wms_feature_info_loader_1 = require("../../../wip/wms-feature-info-loader");
+const wms_layer_description_loader_1 = require("../../../wip/wms-layer-description-loader");
+const wms_error_loader_1 = require("../../../wms-error-loader");
+/**
+ * The WMSService class provides
+ * - provides type safe methods to form URLs to a WMS service
+ * - provides type safe methods to query and parse results (and errors) from a WMS service
+ * - implements the ImageService interface
+ * @note Only the URL parameter conversion is supported. XML posts are not supported.
+ */
+class WMSService extends image_source_1.ImageSource {
+    /** Create a WMSService */
+    constructor(props) {
+        super();
+        this.capabilities = null;
+        /** A list of loaders used by the WMSService methods */
+        this.loaders = [
+            images_1.ImageLoader,
+            wms_error_loader_1.WMSErrorLoader,
+            wms_capabilities_loader_1.WMSCapabilitiesLoader,
+            wms_feature_info_loader_1.WMSFeatureInfoLoader,
+            wms_layer_description_loader_1.WMSLayerDescriptionLoader
+        ];
+        this.props = (0, image_service_1.mergeImageServiceProps)(props);
+        this.fetch = (0, image_service_1.getFetchFunction)(this.props);
+        this.props.loadOptions = {
+            ...this.props.loadOptions,
+            // We want error responses to throw exceptions, the WMSErrorLoader can do this
+            wms: { ...this.props.loadOptions?.wms, throwOnError: true }
+        };
+    }
+    // ImageSource implementation
+    getMetadata() {
+        return this.getCapabilities();
+    }
+    getImage(parameters) {
+        return this.getMap(parameters);
+    }
+    // WMS Service API Stubs
+    /** Get Capabilities */
+    async getCapabilities(wmsParameters, vendorParameters) {
+        const url = this.getCapabilitiesURL(wmsParameters, vendorParameters);
+        const response = await this.fetch(url);
+        const arrayBuffer = await response.arrayBuffer();
+        this._checkResponse(response, arrayBuffer);
+        const capabilities = await wms_capabilities_loader_1.WMSCapabilitiesLoader.parse(arrayBuffer, this.props.loadOptions);
+        this.capabilities = capabilities;
+        return capabilities;
+    }
+    /** Get a map image */
+    async getMap(options, vendorParameters) {
+        const url = this.getMapURL(options, vendorParameters);
+        const response = await this.fetch(url);
+        const arrayBuffer = await response.arrayBuffer();
+        this._checkResponse(response, arrayBuffer);
+        try {
+            return await images_1.ImageLoader.parse(arrayBuffer, this.props.loadOptions);
+        }
+        catch {
+            throw this._parseError(arrayBuffer);
+        }
+    }
+    /** Get Feature Info for a coordinate */
+    async getFeatureInfo(options, vendorParameters) {
+        const url = this.getFeatureInfoURL(options, vendorParameters);
+        const response = await this.fetch(url);
+        const arrayBuffer = await response.arrayBuffer();
+        this._checkResponse(response, arrayBuffer);
+        return await wms_feature_info_loader_1.WMSFeatureInfoLoader.parse(arrayBuffer, this.props.loadOptions);
+    }
+    /** Get Feature Info for a coordinate */
+    async getFeatureInfoText(options, vendorParameters) {
+        options = { ...options, info_format: 'text/plain' };
+        const url = this.getFeatureInfoURL(options, vendorParameters);
+        const response = await this.fetch(url);
+        const arrayBuffer = await response.arrayBuffer();
+        this._checkResponse(response, arrayBuffer);
+        return new TextDecoder().decode(arrayBuffer);
+    }
+    /** Get more information about a layer */
+    async describeLayer(options, vendorParameters) {
+        const url = this.describeLayerURL(options, vendorParameters);
+        const response = await this.fetch(url);
+        const arrayBuffer = await response.arrayBuffer();
+        this._checkResponse(response, arrayBuffer);
+        return await wms_layer_description_loader_1.WMSLayerDescriptionLoader.parse(arrayBuffer, this.props.loadOptions);
+    }
+    /** Get an image with a semantic legend */
+    async getLegendGraphic(options, vendorParameters) {
+        const url = this.getLegendGraphicURL(options, vendorParameters);
+        const response = await this.fetch(url);
+        const arrayBuffer = await response.arrayBuffer();
+        this._checkResponse(response, arrayBuffer);
+        try {
+            return await images_1.ImageLoader.parse(arrayBuffer, this.props.loadOptions);
+        }
+        catch {
+            throw this._parseError(arrayBuffer);
+        }
+    }
+    // Typed URL creators
+    // For applications that want full control of fetching and parsing
+    /** Generate a URL for the GetCapabilities request */
+    getCapabilitiesURL(wmsParameters, vendorParameters) {
+        const options = {
+            service: 'WMS',
+            version: '1.1.1',
+            request: 'GetCapabilities',
+            ...wmsParameters,
+            ...vendorParameters
+        };
+        return this._getWMSUrl(options, vendorParameters);
+    }
+    /** Generate a URL for the GetMap request */
+    getMapURL(wmsParameters, vendorParameters) {
+        const options = {
+            service: 'WMS',
+            version: '1.1.1',
+            request: 'GetMap',
+            // layers: [],
+            // bbox: [-77.87304, 40.78975, -77.85828, 40.80228],
+            // width: 1200,
+            // height: 900,
+            styles: undefined,
+            srs: 'EPSG:4326',
+            format: 'image/png',
+            ...wmsParameters,
+            ...vendorParameters
+        };
+        return this._getWMSUrl(options, vendorParameters);
+    }
+    /** Generate a URL for the GetFeatureInfo request */
+    getFeatureInfoURL(wmsParameters, vendorParameters) {
+        const options = {
+            service: 'WMS',
+            version: '1.1.1',
+            request: 'GetFeatureInfo',
+            // layers: [],
+            // bbox: [-77.87304, 40.78975, -77.85828, 40.80228],
+            // width: 1200,
+            // height: 900,
+            // x: undefined!,
+            // y: undefined!,
+            // query_layers: [],
+            srs: 'EPSG:4326',
+            format: 'image/png',
+            info_format: 'text/plain',
+            styles: undefined,
+            ...wmsParameters,
+            ...vendorParameters
+        };
+        return this._getWMSUrl(options, vendorParameters);
+    }
+    /** Generate a URL for the GetFeatureInfo request */
+    describeLayerURL(wmsParameters, vendorParameters) {
+        const options = {
+            service: 'WMS',
+            version: '1.1.1',
+            request: 'DescribeLayer',
+            ...wmsParameters,
+            ...vendorParameters
+        };
+        return this._getWMSUrl(options, vendorParameters);
+    }
+    getLegendGraphicURL(wmsParameters, vendorParameters) {
+        const options = {
+            service: 'WMS',
+            version: '1.1.1',
+            request: 'GetLegendGraphic',
+            ...wmsParameters,
+            ...vendorParameters
+        };
+        return this._getWMSUrl(options, vendorParameters);
+    }
+    // INTERNAL METHODS
+    /**
+     * @note case _getWMSUrl may need to be overridden to handle certain backends?
+     * */
+    _getWMSUrl(options, vendorParameters) {
+        let url = this.props.url;
+        let first = true;
+        for (const [key, value] of Object.entries(options)) {
+            url += first ? '?' : '&';
+            first = false;
+            if (Array.isArray(value)) {
+                url += `${key.toUpperCase()}=${value.join(',')}`;
+            }
+            else {
+                url += `${key.toUpperCase()}=${value ? String(value) : ''}`;
+            }
+        }
+        return encodeURI(url);
+    }
+    /** Checks for and parses a WMS XML formatted ServiceError and throws an exception */
+    _checkResponse(response, arrayBuffer) {
+        const contentType = response.headers['content-type'];
+        if (!response.ok || wms_error_loader_1.WMSErrorLoader.mimeTypes.includes(contentType)) {
+            const error = wms_error_loader_1.WMSErrorLoader.parseSync(arrayBuffer, this.props.loadOptions);
+            throw new Error(error);
+        }
+    }
+    /** Error situation detected */
+    _parseError(arrayBuffer) {
+        const error = wms_error_loader_1.WMSErrorLoader.parseSync(arrayBuffer, this.props.loadOptions);
+        return new Error(error);
+    }
+}
+exports.WMSService = WMSService;
+WMSService.type = 'wms';
+WMSService.testURL = (url) => url.toLowerCase().includes('wms');

package/dist/lib/data-sources/image-source.d.ts

@@ -0,0 +1,73 @@
+import type { ImageType } from '@loaders.gl/images';
+/**
+ * Normalized capabilities of an Image service
+ * @example
+ *  The WMSService will normalize the response to the WMS `GetCapabilities` data structure extracted from WMS XML response
+ *  into an ImageSourceMetadata.
+ */
+export type ImageSourceMetadata = {
+    name: string;
+    title?: string;
+    abstract?: string;
+    keywords: string[];
+    layer: {
+        name: string;
+        title?: string;
+        srs?: string[];
+        boundingBox?: [number, number, number, number];
+        layers: ImageSourceLayer[];
+    };
+};
+export type ImageSourceLayer = {
+    name: string;
+    title?: string;
+    srs?: string[];
+    boundingBox?: [number, number, number, number];
+    layers: ImageSourceLayer[];
+};
+export type GetImageParameters = {
+    /** Layers to render */
+    layers: string | string[];
+    /** Styling */
+    styles?: unknown;
+    /** bounding box of the requested map image */
+    bbox: [number, number, number, number];
+    /** pixel width of returned image */
+    width: number;
+    /** pixels */
+    height: number;
+    /** srs for the image (not the bounding box) */
+    srs?: string;
+    /** requested format for the return image */
+    format?: 'image/png';
+};
+export type ImageFilters = {
+    /** Layers to render */
+    layers: string | string[];
+    /** Styling */
+    styles?: unknown;
+};
+export type ImageRegion = {
+    /** bounding box of the requested map image */
+    bbox: [number, number, number, number];
+};
+export type ImageFormat = {
+    /** pixel width of returned image */
+    width: number;
+    /** pixels */
+    height: number;
+    /** srs for the image (not the bounding box) */
+    srs?: string;
+    /** requested format for the return image */
+    format?: 'image/png';
+};
+/**
+ * MapImageSource - data sources that allow data to be queried by (geospatial) extents
+ * @note
+ * - If geospatial, bounding box is expected to be in web mercator coordinates
+ */
+export declare abstract class ImageSource {
+    abstract getMetadata(): Promise<ImageSourceMetadata>;
+    abstract getImage(parameters: GetImageParameters): Promise<ImageType>;
+}
+//# sourceMappingURL=image-source.d.ts.map

package/dist/lib/data-sources/image-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-source.d.ts","sourceRoot":"","sources":["../../../src/lib/data-sources/image-source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,EAAE,gBAAgB,EAAE,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uBAAuB;IACvB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,cAAc;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAGF,MAAM,MAAM,YAAY,GAAG;IACzB,uBAAuB;IACvB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,cAAc;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,8CAA8C;IAC9C,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,8BAAsB,WAAW;IAC/B,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;CACtE"}

package/dist/lib/data-sources/image-source.js

@@ -0,0 +1,12 @@
+"use strict";
+// loaders.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImageSource = void 0;
+/**
+ * MapImageSource - data sources that allow data to be queried by (geospatial) extents
+ * @note
+ * - If geospatial, bounding box is expected to be in web mercator coordinates
+ */
+class ImageSource {
+}
+exports.ImageSource = ImageSource;

package/dist/lib/gml/deep-strict-equal.d.ts

@@ -0,0 +1,3 @@
+/** @todo replace this ridiculous choice of deepStrictEqual */
+export declare function deepStrictEqual(actual: unknown, expected: unknown, strict?: boolean): any;
+//# sourceMappingURL=deep-strict-equal.d.ts.map

package/dist/lib/gml/deep-strict-equal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-strict-equal.d.ts","sourceRoot":"","sources":["../../../src/lib/gml/deep-strict-equal.ts"],"names":[],"mappings":"AA0BA,8DAA8D;AAE9D,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,OAyCnF"}

package/dist/lib/gml/deep-strict-equal.js

@@ -0,0 +1,119 @@
+"use strict";
+// https://github.com/nodejs/node/commit/c1d82ac2ff15594840e2a1b9531b506ae067ed27;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepStrictEqual = void 0;
+// http://wiki.commonjs.org/wiki/Unit_Testing/1.0
+//
+// THIS IS NOT TESTED NOR LIKELY TO WORK OUTSIDE V8!
+//
+// Originally from narwhal.js (http://narwhaljs.org)
+// Copyright (c) 2009 Thomas Robinson <280north.com>
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the 'Software'), to
+// deal in the Software without restriction, including without limitation the
+// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+// sell copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+/** @todo replace this ridiculous choice of deepStrictEqual */
+// eslint-disable-next-line complexity
+function deepStrictEqual(actual, expected, strict) {
+    // 7.1. All identical values are equivalent, as determined by ===.
+    if (actual === expected) {
+        return true;
+        // } else if (actual instanceof Buffer && expected instanceof Buffer) {
+        //   return compare(actual, expected) === 0;
+        // // 7.2. If the expected value is a Date object, the actual value is
+        // // equivalent if it is also a Date object that refers to the same time.
+    }
+    else if (actual instanceof Date && expected instanceof Date) {
+        return actual.getTime() === expected.getTime();
+        // 7.3 If the expected value is a RegExp object, the actual value is
+        // equivalent if it is also a RegExp object with the same source and
+        // properties (`global`, `multiline`, `lastIndex`, `ignoreCase`).
+    }
+    else if (actual instanceof RegExp && expected instanceof RegExp) {
+        return (actual.source === expected.source &&
+            actual.global === expected.global &&
+            actual.multiline === expected.multiline &&
+            actual.lastIndex === expected.lastIndex &&
+            actual.ignoreCase === expected.ignoreCase);
+        // 7.4. Other pairs that do not both pass typeof value == 'object',
+        // equivalence is determined by ==.
+    }
+    else if ((actual === null || typeof actual !== 'object') &&
+        (expected === null || typeof expected !== 'object')) {
+        // eslint-disable-next-line eqeqeq
+        return strict ? actual === expected : actual == expected;
+        // 7.5 For all other Object pairs, including Array objects, equivalence is
+        // determined by having the same number of owned properties (as verified
+        // with Object.prototype.hasOwnProperty.call), the same set of keys
+        // (although not necessarily the same order), equivalent values for every
+        // corresponding key, and an identical 'prototype' property. Note: this
+        // accounts for both named and indexed properties on Arrays.
+    }
+    return objEquiv(actual, expected, strict);
+}
+exports.deepStrictEqual = deepStrictEqual;
+// eslint-disable-next-line @typescript-eslint/unbound-method
+const pSlice = Array.prototype.slice;
+function isPrimitive(arg) {
+    return arg === null || (typeof arg !== 'object' && typeof arg !== 'function');
+}
+function isArguments(object) {
+    // eslint-disable-next-line eqeqeq
+    return Object.prototype.toString.call(object) == '[object Arguments]';
+}
+// eslint-disable-next-line complexity
+function objEquiv(a, b, strict) {
+    if (a === null || a === undefined || b === null || b === undefined)
+        return false;
+    // if one is a primitive, the other must be same
+    if (isPrimitive(a) || isPrimitive(b))
+        return a === b;
+    if (strict && Object.getPrototypeOf(a) !== Object.getPrototypeOf(b))
+        return false;
+    const aIsArgs = isArguments(a);
+    const bIsArgs = isArguments(b);
+    if ((aIsArgs && !bIsArgs) || (!aIsArgs && bIsArgs))
+        return false;
+    if (aIsArgs) {
+        a = pSlice.call(a);
+        b = pSlice.call(b);
+        return deepStrictEqual(a, b, strict);
+    }
+    const ka = Object.keys(a);
+    const kb = Object.keys(b);
+    let key;
+    let i;
+    // having the same number of owned properties (keys incorporates
+    // hasOwnProperty)
+    if (ka.length !== kb.length)
+        return false;
+    // the same set of keys (although not necessarily the same order),
+    ka.sort();
+    kb.sort();
+    // ~~~cheap key test
+    for (i = ka.length - 1; i >= 0; i--) {
+        if (ka[i] !== kb[i])
+            return false;
+    }
+    // equivalent values for every corresponding key, and
+    // ~~~possibly expensive deep test
+    for (i = ka.length - 1; i >= 0; i--) {
+        key = ka[i];
+        if (!deepStrictEqual(a[key], b[key], strict))
+            return false;
+    }
+    return true;
+}

package/dist/lib/gml/parse-gml.d.ts

@@ -0,0 +1,28 @@
+import type { Geometry, Position } from '@loaders.gl/schema';
+export type ParseGMLOptions = {
+    transformCoords?: Function;
+    stride?: 2 | 3 | 4;
+};
+export type ParseGMLContext = {
+    srsDimension?: number;
+    [key: string]: any;
+};
+/**
+ * Parses a typed data structure from raw XML for GML features
+ * @note Error handlings is fairly weak
+ */
+export declare function parseGML(text: string, options: any): Geometry | null;
+/** Parse a GeoJSON geometry from GML XML */
+export declare function parseGMLToGeometry(inputXML: any, options: ParseGMLOptions, context: ParseGMLContext): Geometry | null;
+export declare function parsePosList(xml: any, options: ParseGMLOptions, context: ParseGMLContext): Position[];
+export declare function parsePos(xml: any, options: ParseGMLOptions, context: ParseGMLContext): Position;
+export declare function parsePoint(xml: any, options: ParseGMLOptions, context: ParseGMLContext): number[];
+export declare function parseLinearRingOrLineString(xml: any, options: ParseGMLOptions, context: ParseGMLContext): Position[];
+export declare function parseCurveSegments(xml: any, options: ParseGMLOptions, context: ParseGMLContext): Position[];
+export declare function parseRing(xml: any, options: ParseGMLOptions, context: ParseGMLContext): Position[];
+export declare function parseExteriorOrInterior(xml: any, options: ParseGMLOptions, context: ParseGMLContext): Position[];
+export declare function parsePolygonOrRectangle(xml: any, options: ParseGMLOptions, context: ParseGMLContext): Position[][];
+export declare function parseSurface(xml: any, options: ParseGMLOptions, context: ParseGMLContext): Position[][][];
+export declare function parseCompositeSurface(xml: any, options: ParseGMLOptions, context: ParseGMLContext): Position[][][];
+export declare function parseMultiSurface(xml: any, options: ParseGMLOptions, context: ParseGMLContext): Position[][][];
+//# sourceMappingURL=parse-gml.d.ts.map