esri-gl 0.9.0-alpha.11 → 0.9.0-alpha.7

package/README.md

@@ -2,19 +2,10 @@
 
 A TypeScript library that bridges Esri ArcGIS REST services with MapLibre GL JS and Mapbox GL JS. It replicates Esri Leaflet's architecture patterns while being compatible with modern WebGL mapping libraries.
 
-> **🚧 Development Notice**
-> 
-> This project is currently under active development. APIs may change between releases and some features may not be fully stable. Please use with caution in production environments and check the [changelog](CHANGES.md) for breaking changes between versions.
-
 [![npm version](https://badge.fury.io/js/esri-gl.svg)](https://badge.fury.io/js/esri-gl)
 [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## 🔗 Links
-
-- **📚 [Documentation](https://esri-gl.netlify.app/)** - Complete API reference and guides
-- **🎮 [Live Demos](https://esri-gl-demo.netlify.app/)** - Interactive examples and code samples
-
 **Note**: This library is compatible with both **MapLibre GL JS** and **Mapbox GL JS**.
 
 ## Features

package/dist/esri-gl.esm.js

@@ -428,13 +428,6 @@ class DynamicMapService {
             writable: true,
             value: void 0
         });
-        // Transaction-like updates
-        Object.defineProperty(this, "_pendingUpdates", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
         if (!esriServiceOptions.url) {
             throw new Error('A url must be supplied as part of the esriServiceOptions object.');
         }
@@ -444,7 +437,6 @@ class DynamicMapService {
         this._defaultEsriOptions = {
             layers: false,
             layerDefs: false,
-            dynamicLayers: false,
             format: 'png24',
             dpi: 96,
             transparent: true,
@@ -486,31 +478,6 @@ class DynamicMapService {
             to = to.valueOf();
         return `${from},${to}`;
     }
-    // ArcGIS Dynamic Layer styling parameter (JSON string)
-    get _dynamicLayers() {
-        const dl = this.options.dynamicLayers;
-        if (!dl)
-            return false;
-        try {
-            const normalized = dl.map(l => {
-                const { visible, ...rest } = l;
-                const withSource = {
-                    ...rest,
-                    // ensure required source exists
-                    source: l.source ?? { type: 'mapLayer', mapLayerId: l.id },
-                };
-                // Convert client-friendly 'visible' to ArcGIS 'visibility'
-                if (typeof visible === 'boolean') {
-                    withSource.visibility = visible;
-                }
-                return withSource;
-            });
-            return JSON.stringify(normalized);
-        }
-        catch {
-            return false;
-        }
-    }
     get _source() {
         const tileSize = this.rasterSrcOptions?.tileSize ?? 256;
         // These are the bare minimum parameters
@@ -528,8 +495,6 @@ class DynamicMapService {
             params.append('time', this._time);
         if (this._layerDefs)
             params.append('layerDefs', this._layerDefs);
-        if (this._dynamicLayers)
-            params.append('dynamicLayers', this._dynamicLayers);
         return {
             type: 'raster',
             tiles: [`${this.options.url}/export?bbox={bbox-epsg-3857}&${params.toString()}`],
@@ -542,27 +507,20 @@ class DynamicMapService {
     }
     // This requires hooking into some undocumented methods
     _updateSource() {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const src = this._map.getSource(this._sourceId);
         src.tiles[0] = this._source.tiles[0];
         src._options = this._source;
         if (src.setTiles) {
             // New MapboxGL >= 2.13.0
             src.setTiles(this._source.tiles);
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
         }
         else if (this._map.style.sourceCaches) {
             // Old MapboxGL and MaplibreGL
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             this._map.style.sourceCaches[this._sourceId].clearTiles();
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             this._map.style.sourceCaches[this._sourceId].update(this._map.transform);
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
         }
         else if (this._map.style._otherSourceCaches) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             this._map.style.sourceCaches[this._sourceId].clearTiles();
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             this._map.style.sourceCaches[this._sourceId].update(this._map.transform);
         }
     }
@@ -570,174 +528,6 @@ class DynamicMapService {
         this.esriServiceOptions.layerDefs = obj;
         this._updateSource();
     }
-    /**
-     * Replace the entire dynamicLayers array. Server applies these drawing rules.
-     * Note: dynamicLayers overrides default drawing for listed sublayers.
-     */
-    setDynamicLayers(layers) {
-        this.esriServiceOptions.dynamicLayers = layers || false;
-        this._updateSource();
-    }
-    /** Helper to ensure all visible layers are included when using dynamicLayers */
-    _ensureAllVisibleLayers(dynamicLayers) {
-        const visibleLayerIds = this._getVisibleLayerIds();
-        const existingIds = new Set(dynamicLayers.map(dl => dl.id));
-        // Add entries for visible layers that aren't already in dynamicLayers
-        const additional = visibleLayerIds
-            .filter(id => !existingIds.has(id))
-            .map(id => ({ id, visible: true }));
-        return [...dynamicLayers, ...additional];
-    }
-    /** Get the list of currently visible layer IDs */
-    _getVisibleLayerIds() {
-        const lyrs = this.options.layers;
-        if (!lyrs)
-            return [];
-        if (!Array.isArray(lyrs))
-            return [lyrs];
-        return lyrs;
-    }
-    /** Merge/update a sublayer's drawingInfo with provided fields. */
-    setLayerDrawingInfo(layerId, drawingInfo) {
-        const current = this.esriServiceOptions.dynamicLayers || [];
-        const next = Array.isArray(current) ? [...current] : [];
-        const idx = next.findIndex(l => l.id === layerId);
-        if (idx >= 0) {
-            next[idx] = { ...next[idx], drawingInfo: { ...next[idx].drawingInfo, ...drawingInfo } };
-        }
-        else {
-            next.push({ id: layerId, drawingInfo });
-        }
-        // Ensure all visible layers are included
-        this.esriServiceOptions.dynamicLayers = this._ensureAllVisibleLayers(next);
-        this._updateSource();
-    }
-    /** Convenience to set a renderer on a sublayer */
-    setLayerRenderer(layerId, renderer) {
-        this.setLayerDrawingInfo(layerId, { renderer });
-    }
-    /** Show/hide a sublayer via dynamicLayers */
-    setLayerVisibility(layerId, visible) {
-        const current = this.esriServiceOptions.dynamicLayers || [];
-        const next = Array.isArray(current) ? [...current] : [];
-        const idx = next.findIndex(l => l.id === layerId);
-        if (idx >= 0) {
-            next[idx] = { ...next[idx], visible };
-        }
-        else {
-            next.push({ id: layerId, visible });
-        }
-        // Ensure all visible layers are included
-        this.esriServiceOptions.dynamicLayers = this._ensureAllVisibleLayers(next);
-        this._updateSource();
-    }
-    /** Set a definitionExpression for a sublayer, applied server-side */
-    setLayerDefinition(layerId, definitionExpression) {
-        const current = this.esriServiceOptions.dynamicLayers || [];
-        const next = Array.isArray(current) ? [...current] : [];
-        const idx = next.findIndex(l => l.id === layerId);
-        if (idx >= 0) {
-            next[idx] = { ...next[idx], definitionExpression };
-        }
-        else {
-            next.push({ id: layerId, definitionExpression });
-        }
-        // Ensure all visible layers are included
-        this.esriServiceOptions.dynamicLayers = this._ensureAllVisibleLayers(next);
-        this._updateSource();
-    }
-    // Build a SQL where clause and apply as definitionExpression
-    setLayerFilter(layerId, filter) {
-        const where = this._buildWhere(filter);
-        if (where)
-            this.setLayerDefinition(layerId, where);
-    }
-    _escapeValue(val) {
-        if (val === null)
-            return 'NULL';
-        if (val instanceof Date)
-            return `${val.valueOf()}`; // epoch ms for time-enabled services
-        if (typeof val === 'number')
-            return `${val}`;
-        if (typeof val === 'boolean')
-            return val ? '1' : '0';
-        const s = String(val).replace(/'/g, "''");
-        return `'${s}'`;
-    }
-    // Very small, pragmatic builder that covers common cases in types.ts
-    _isGroupFilter(f) {
-        return (typeof f !== 'string' &&
-            'op' in f &&
-            (f.op === 'AND' || f.op === 'OR') &&
-            'filters' in f &&
-            Array.isArray(f.filters));
-    }
-    _isBetweenFilter(f) {
-        return (typeof f !== 'string' &&
-            'op' in f &&
-            f.op === 'BETWEEN' &&
-            'field' in f &&
-            typeof f.field === 'string' &&
-            'from' in f &&
-            f.from !== undefined &&
-            'to' in f &&
-            f.to !== undefined);
-    }
-    _isInFilter(f) {
-        return (typeof f !== 'string' &&
-            'op' in f &&
-            f.op === 'IN' &&
-            'field' in f &&
-            typeof f.field === 'string' &&
-            'values' in f &&
-            Array.isArray(f.values));
-    }
-    _isNullFilter(f) {
-        return (typeof f !== 'string' &&
-            'op' in f &&
-            (f.op === 'IS NULL' || f.op === 'IS NOT NULL') &&
-            'field' in f &&
-            typeof f.field === 'string');
-    }
-    _isComparisonFilter(f) {
-        return (typeof f !== 'string' &&
-            'field' in f &&
-            typeof f.field === 'string' &&
-            'op' in f &&
-            typeof f.op === 'string' &&
-            'value' in f &&
-            f.value !== undefined);
-    }
-    _buildWhere(filter) {
-        if (!filter)
-            return undefined;
-        if (typeof filter === 'string')
-            return filter.trim();
-        if (this._isBetweenFilter(filter)) {
-            return `${filter.field} BETWEEN ${this._escapeValue(filter.from)} AND ${this._escapeValue(filter.to)}`;
-        }
-        if (this._isInFilter(filter)) {
-            const vals = filter.values.map(v => this._escapeValue(v)).join(', ');
-            return `${filter.field} IN (${vals})`;
-        }
-        if (this._isNullFilter(filter)) {
-            return `${filter.field} ${filter.op}`;
-        }
-        if (this._isGroupFilter(filter)) {
-            const built = filter.filters
-                .map((f) => this._buildWhere(f))
-                .filter((s) => Boolean(s));
-            if (!built.length)
-                return undefined;
-            if (built.length === 1)
-                return built[0];
-            return `(${built.join(` ${filter.op} `)})`;
-        }
-        if (this._isComparisonFilter(filter)) {
-            return `${filter.field} ${filter.op} ${this._escapeValue(filter.value)}`;
-        }
-        return undefined;
-    }
     setLayers(arr) {
         this.esriServiceOptions.layers = arr;
         this._updateSource();
@@ -775,9 +565,7 @@ class DynamicMapService {
         return layersStr ? layersStr.replace('show', 'visible') : false;
     }
     identify(lnglat, returnGeometry = false) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const canvas = this._map.getCanvas();
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const bounds = this._map.getBounds().toArray();
         const params = new URLSearchParams({
             sr: '4326',
@@ -798,8 +586,6 @@ class DynamicMapService {
         });
         if (this._layerDefs)
             params.append('layerDefs', this._layerDefs);
-        if (this._dynamicLayers)
-            params.append('dynamicLayers', this._dynamicLayers);
         if (this._time)
             params.append('time', this._time);
         return new Promise((resolve, reject) => {
@@ -809,313 +595,6 @@ class DynamicMapService {
                 .catch(error => reject(error));
         });
     }
-    // ========================================
-    // Advanced Features
-    // ========================================
-    /** Set labeling configuration for a sublayer */
-    setLayerLabels(layerId, labelingInfo) {
-        const current = this.esriServiceOptions.dynamicLayers || [];
-        const next = Array.isArray(current) ? [...current] : [];
-        const idx = next.findIndex(l => l.id === layerId);
-        if (idx >= 0) {
-            next[idx] = {
-                ...next[idx],
-                drawingInfo: {
-                    ...next[idx].drawingInfo,
-                    labelingInfo: [labelingInfo],
-                },
-            };
-        }
-        else {
-            next.push({
-                id: layerId,
-                drawingInfo: { labelingInfo: [labelingInfo] },
-            });
-        }
-        // Ensure all visible layers are included
-        this.esriServiceOptions.dynamicLayers = this._ensureAllVisibleLayers(next);
-        this._updateSource();
-    }
-    /** Toggle label visibility for a sublayer */
-    setLayerLabelsVisible(layerId, visible) {
-        if (visible) {
-            // If enabling labels but no labeling info exists, set a default
-            const current = this.esriServiceOptions.dynamicLayers || [];
-            const layer = Array.isArray(current) ? current.find(l => l.id === layerId) : null;
-            if (!layer?.drawingInfo?.labelingInfo) {
-                // Set a basic label configuration
-                this.setLayerLabels(layerId, {
-                    labelExpression: '[OBJECTID]', // Default to object ID
-                    symbol: {
-                        type: 'esriTS',
-                        color: [0, 0, 0, 255],
-                        font: { family: 'Arial', size: 8 },
-                    },
-                });
-            }
-        }
-        else {
-            // Remove labeling info to disable labels
-            const current = this.esriServiceOptions.dynamicLayers || [];
-            const next = Array.isArray(current) ? [...current] : [];
-            const idx = next.findIndex(l => l.id === layerId);
-            if (idx >= 0) {
-                const drawingInfo = { ...next[idx].drawingInfo };
-                delete drawingInfo.labelingInfo;
-                next[idx] = { ...next[idx], drawingInfo };
-                // Ensure all visible layers are included
-                this.esriServiceOptions.dynamicLayers = this._ensureAllVisibleLayers(next);
-                this._updateSource();
-            }
-        }
-    }
-    /** Set time options for a time-enabled sublayer */
-    setLayerTimeOptions(layerId, timeOptions) {
-        const current = this.esriServiceOptions.dynamicLayers || [];
-        const next = Array.isArray(current) ? [...current] : [];
-        const idx = next.findIndex(l => l.id === layerId);
-        if (idx >= 0) {
-            next[idx] = { ...next[idx], layerTimeOptions: timeOptions };
-        }
-        else {
-            next.push({ id: layerId, layerTimeOptions: timeOptions });
-        }
-        // Ensure all visible layers are included
-        this.esriServiceOptions.dynamicLayers = this._ensureAllVisibleLayers(next);
-        this._updateSource();
-    }
-    /** Animate through time periods for time-enabled layers */
-    async animateTime(options) {
-        const { from, to, intervalMs, loop = false, onFrame, onComplete } = options;
-        const totalDuration = to.getTime() - from.getTime();
-        const steps = Math.ceil(totalDuration / intervalMs);
-        return new Promise(resolve => {
-            let currentStep = 0;
-            const animate = () => {
-                if (currentStep >= steps && !loop) {
-                    onComplete?.();
-                    resolve();
-                    return;
-                }
-                const progress = (currentStep % steps) / steps;
-                const currentTime = new Date(from.getTime() + progress * totalDuration);
-                // Update service time extent
-                this.esriServiceOptions.from = currentTime;
-                this.esriServiceOptions.to = currentTime;
-                this._updateSource();
-                onFrame?.(currentTime, progress);
-                currentStep++;
-                setTimeout(animate, intervalMs);
-            };
-            animate();
-        });
-    }
-    /** Get statistics for a sublayer */
-    async getLayerStatistics(layerId, statisticFields, options = {}) {
-        const queryUrl = `${this.esriServiceOptions.url}/${layerId}/query`;
-        const params = new URLSearchParams({
-            f: 'json',
-            where: options.where || '1=1',
-            outStatistics: JSON.stringify(statisticFields),
-            returnGeometry: 'false',
-        });
-        if (options.groupByFieldsForStatistics) {
-            params.append('groupByFieldsForStatistics', options.groupByFieldsForStatistics);
-        }
-        const response = await fetch(`${queryUrl}?${params.toString()}`);
-        const data = await response.json();
-        if (data.error) {
-            throw new Error(`Statistics query failed: ${data.error.message}`);
-        }
-        return data.features || [];
-    }
-    /** Query features from a specific sublayer */
-    async queryLayerFeatures(layerId, options = {}) {
-        const queryUrl = `${this.esriServiceOptions.url}/${layerId}/query`;
-        const params = new URLSearchParams({
-            f: 'json',
-            where: options.where || '1=1',
-            returnGeometry: options.returnGeometry !== false ? 'true' : 'false',
-            outFields: Array.isArray(options.outFields)
-                ? options.outFields.join(',')
-                : options.outFields || '*',
-        });
-        if (options.geometry) {
-            params.append('geometry', JSON.stringify(options.geometry));
-            params.append('geometryType', options.geometryType || 'esriGeometryEnvelope');
-            params.append('spatialRel', options.spatialRel || 'esriSpatialRelIntersects');
-        }
-        if (options.orderByFields) {
-            params.append('orderByFields', options.orderByFields);
-        }
-        if (options.resultOffset) {
-            params.append('resultOffset', options.resultOffset.toString());
-        }
-        if (options.resultRecordCount) {
-            params.append('resultRecordCount', options.resultRecordCount.toString());
-        }
-        if (options.returnCountOnly) {
-            params.append('returnCountOnly', 'true');
-        }
-        if (options.returnIdsOnly) {
-            params.append('returnIdsOnly', 'true');
-        }
-        const response = await fetch(`${queryUrl}?${params.toString()}`);
-        const data = await response.json();
-        if (data.error) {
-            throw new Error(`Layer query failed: ${data.error.message}`);
-        }
-        return data;
-    }
-    /** Export high-resolution map image */
-    async exportMapImage(options) {
-        const exportUrl = `${this.esriServiceOptions.url}/export`;
-        const params = new URLSearchParams({
-            f: 'image',
-            bbox: options.bbox.join(','),
-            size: options.size.join(','),
-            format: options.format || 'png24',
-            transparent: options.transparent !== false ? 'true' : 'false',
-            dpi: (options.dpi || 96).toString(),
-            bboxSR: (options.bboxSR || 3857).toString(),
-            imageSR: (options.imageSR || 3857).toString(),
-        });
-        if (options.layerDefs) {
-            params.append('layerDefs', JSON.stringify(options.layerDefs));
-        }
-        if (options.dynamicLayers) {
-            const normalized = this._ensureAllVisibleLayers(options.dynamicLayers);
-            params.append('dynamicLayers', JSON.stringify(normalized));
-        }
-        if (options.gdbVersion) {
-            params.append('gdbVersion', options.gdbVersion);
-        }
-        if (options.historicMoment) {
-            params.append('historicMoment', options.historicMoment.toString());
-        }
-        const response = await fetch(`${exportUrl}?${params.toString()}`);
-        if (!response.ok) {
-            throw new Error(`Export failed: ${response.statusText}`);
-        }
-        return response.blob();
-    }
-    /** Generate legend information for layers */
-    async generateLegend(layerIds) {
-        const legendUrl = `${this.esriServiceOptions.url}/legend`;
-        const params = new URLSearchParams({
-            f: 'json',
-        });
-        if (layerIds?.length) {
-            params.append('layers', layerIds.join(','));
-        }
-        const response = await fetch(`${legendUrl}?${params.toString()}`);
-        const data = await response.json();
-        if (data.error) {
-            throw new Error(`Legend generation failed: ${data.error.message}`);
-        }
-        return data.layers || [];
-    }
-    /** Get detailed information about a specific layer */
-    async getLayerInfo(layerId) {
-        const layerUrl = `${this.esriServiceOptions.url}/${layerId}`;
-        const params = new URLSearchParams({ f: 'json' });
-        const response = await fetch(`${layerUrl}?${params.toString()}`);
-        const data = await response.json();
-        if (data.error) {
-            throw new Error(`Layer info request failed: ${data.error.message}`);
-        }
-        return data;
-    }
-    /** Get field information for a layer */
-    async getLayerFields(layerId) {
-        const layerInfo = await this.getLayerInfo(layerId);
-        return layerInfo.fields || [];
-    }
-    /** Get spatial extent of a layer */
-    async getLayerExtent(layerId) {
-        const layerInfo = await this.getLayerInfo(layerId);
-        if (!layerInfo.extent) {
-            throw new Error(`No extent available for layer ${layerId}`);
-        }
-        return layerInfo.extent;
-    }
-    /** Discover all layers in the service */
-    async discoverLayers() {
-        const serviceUrl = this.esriServiceOptions.url;
-        const params = new URLSearchParams({ f: 'json' });
-        const response = await fetch(`${serviceUrl}?${params.toString()}`);
-        const data = await response.json();
-        if (data.error) {
-            throw new Error(`Service discovery failed: ${data.error.message}`);
-        }
-        return data.layers || [];
-    }
-    /** Apply multiple layer operations in a single update */
-    setBulkLayerProperties(operations) {
-        const current = this.esriServiceOptions.dynamicLayers || [];
-        const next = Array.isArray(current) ? [...current] : [];
-        // Process all operations
-        for (const op of operations) {
-            const idx = next.findIndex(l => l.id === op.layerId);
-            const layer = idx >= 0 ? { ...next[idx] } : { id: op.layerId };
-            switch (op.operation) {
-                case 'visibility':
-                    layer.visible = op.value;
-                    break;
-                case 'renderer':
-                    layer.drawingInfo = { ...layer.drawingInfo, renderer: op.value };
-                    break;
-                case 'definition':
-                    layer.definitionExpression = op.value;
-                    break;
-                case 'filter': {
-                    const where = this._buildWhere(op.value);
-                    if (where)
-                        layer.definitionExpression = where;
-                    break;
-                }
-                case 'labels':
-                    layer.drawingInfo = {
-                        ...layer.drawingInfo,
-                        labelingInfo: op.value,
-                    };
-                    break;
-                case 'time':
-                    layer.layerTimeOptions = op.value;
-                    break;
-            }
-            if (idx >= 0) {
-                next[idx] = layer;
-            }
-            else {
-                next.push(layer);
-            }
-        }
-        // Ensure all visible layers are included
-        this.esriServiceOptions.dynamicLayers = this._ensureAllVisibleLayers(next);
-        this._updateSource();
-    }
-    /** Begin a batch update transaction */
-    beginUpdate() {
-        const current = this.esriServiceOptions.dynamicLayers || [];
-        this._pendingUpdates = Array.isArray(current) ? [...current] : [];
-    }
-    /** Commit all pending updates */
-    commitUpdate() {
-        if (this._pendingUpdates) {
-            this.esriServiceOptions.dynamicLayers = this._ensureAllVisibleLayers(this._pendingUpdates);
-            this._pendingUpdates = null;
-            this._updateSource();
-        }
-    }
-    /** Rollback pending updates */
-    rollbackUpdate() {
-        this._pendingUpdates = null;
-    }
-    /** Check if currently in a transaction */
-    get isInTransaction() {
-        return this._pendingUpdates !== null;
-    }
     update() {
         this._updateSource();
     }
@@ -1262,7 +741,6 @@ class ImageService {
         this._defaultEsriOptions = {
             layers: false,
             layerDefs: false,
-            dynamicLayers: false,
             format: 'jpgpng',
             dpi: 96,
             transparent: true,