@vcmap/core 6.2.4 → 6.3.0-rc.2

package/dist/src/featureProvider/abstractAttributeProvider.js

@@ -0,0 +1,129 @@
+import Feature from 'ol/Feature.js';
+import { v4 as uuid } from 'uuid';
+import { is, oneOf } from '@vcsuite/check';
+import { Cesium3DTileFeature, Cesium3DTilePointFeature, Entity, } from '@vcmap-cesium/engine';
+import VcsObject from '../vcsObject.js';
+import { featureExists } from '../layer/featureVisibility.js';
+export const attributeProviderName = Symbol('attributeProvider');
+export default class AbstractAttributeProvider extends VcsObject {
+    static get className() {
+        return 'AbstractAttributeProvider';
+    }
+    static getDefaultOptions() {
+        return {
+            ...VcsObject.getDefaultOptions(),
+            keyProperty: undefined,
+        };
+    }
+    _id = uuid();
+    keyProperty;
+    constructor(options) {
+        super(options);
+        this.keyProperty = options.keyProperty;
+    }
+    _setAttributesOnFeature(feature, attributes) {
+        if (feature instanceof Feature) {
+            feature.setProperties(attributes, true);
+            feature.changed();
+        }
+        else if (feature instanceof Cesium3DTileFeature ||
+            feature instanceof Cesium3DTilePointFeature) {
+            if (featureExists(feature)) {
+                for (const key of Object.keys(attributes)) {
+                    feature.setAttribute(key, attributes[key]);
+                }
+            }
+            feature[attributeProviderName] = this._id;
+        }
+        else if (feature instanceof Entity) {
+            for (const key of Object.keys(attributes)) {
+                feature.properties?.addProperty(key, attributes[key]);
+            }
+            feature[attributeProviderName] = this._id;
+        }
+    }
+    _getKeyForFeature(feature) {
+        let key;
+        if (this.keyProperty) {
+            key = feature.getProperty(this.keyProperty);
+        }
+        else {
+            key = feature.getId();
+        }
+        if (is(key, oneOf(String, Number))) {
+            return String(key);
+        }
+        return undefined;
+    }
+    /**
+     * Optional bulk attribute retrieval for multiple keys.
+     * Can be implemented for optimal loading of data.
+     * Provides a webmercator extent to limit the lookup if needed.
+     * You MUST return a same length array as keys, with undefined for missing attributes.
+     * @param bulk - array of key and feature pairs to retrieve attributes for
+     * @param _extent - optional extent in webmercator to limit attribute lookup on certain providers.
+     * @protected
+     */
+    _getBulkAttributes(bulk, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _extent) {
+        return Promise.all(bulk.map(({ key, feature }) => this._getAttributes(key, feature)));
+    }
+    /**
+     * Augments a feature with attributes from the provider
+     * @param feature
+     */
+    async augmentFeature(feature) {
+        if (feature[attributeProviderName] !== this._id) {
+            const key = this._getKeyForFeature(feature);
+            if (key) {
+                const attributes = await this._getAttributes(key, feature);
+                if (attributes) {
+                    this._setAttributesOnFeature(feature, attributes);
+                }
+            }
+        }
+        feature[attributeProviderName] = this._id;
+    }
+    /**
+     * Augments multiple features with attributes from the provider
+     * @param features
+     * @param extent - optional extent in webmercator to limit attribute lookup on certain providers.
+     */
+    async augmentFeatures(features, extent) {
+        const bulk = features
+            .map((feature) => {
+            if (feature[attributeProviderName] !== this._id) {
+                const key = this._getKeyForFeature(feature);
+                if (key) {
+                    return { key, feature };
+                }
+            }
+            feature[attributeProviderName] = this._id;
+            return undefined;
+        })
+            .filter((i) => !!i);
+        if (bulk.length === 0) {
+            return;
+        }
+        const attributes = await this._getBulkAttributes(bulk, extent);
+        if (attributes.length !== bulk.length) {
+            this.getLogger().error(`Bulk attribute retrieval returned ${attributes.length} results for ${bulk.length} features.`);
+            return;
+        }
+        for (let i = 0; i < bulk.length; i++) {
+            const attr = attributes[i];
+            if (attr) {
+                this._setAttributesOnFeature(bulk[i].feature, attr);
+            }
+        }
+    }
+    toJSON(defaultOptions = AbstractAttributeProvider.getDefaultOptions()) {
+        const config = super.toJSON(defaultOptions);
+        if (this.keyProperty !== defaultOptions.keyProperty) {
+            config.keyProperty = this.keyProperty;
+        }
+        return config;
+    }
+}
+//# sourceMappingURL=abstractAttributeProvider.js.map

package/dist/src/featureProvider/abstractAttributeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractAttributeProvider.js","sourceRoot":"","sources":["../../../src/featureProvider/abstractAttributeProvider.ts"],"names":[],"mappings":"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"}

package/dist/src/featureProvider/abstractFeatureProvider.d.ts

@@ -1,23 +1,22 @@
 import type { Feature } from 'ol/index.js';
 import type { Coordinate } from 'ol/coordinate.js';
 import VcsObject, { type VcsObjectOptions } from '../vcsObject.js';
+import { type VectorStyleItemOptions } from '../style/vectorStyleItem.js';
 import VectorProperties, { type VectorPropertiesOptions } from '../layer/vectorProperties.js';
 import type StyleItem from '../style/styleItem.js';
 import { type StyleItemOptions } from '../style/styleItem.js';
 import type VcsMap from '../map/vcsMap.js';
+import type { DeclarativeStyleItemOptions } from '../style/declarativeStyleItem.js';
+import type Layer from '../layer/layer.js';
 export type AbstractFeatureProviderOptions = VcsObjectOptions & {
     /**
      * the style to apply to features created by this feature provider
      */
-    style?: StyleItemOptions | StyleItem;
+    style?: StyleItemOptions | VectorStyleItemOptions | DeclarativeStyleItemOptions | StyleItem;
     /**
      * the vector properties of the features. Allow picking is false by default.
      */
     vectorProperties?: VectorProperties | VectorPropertiesOptions;
-    /**
-     * show the resulting geometry in the map
-     */
-    showGeometry?: boolean;
     /**
      * can be used to constrict the featureProvider to specific mapTypes empty array means no restriction
      */
@@ -27,21 +26,13 @@ export type AbstractFeatureProviderOptions = VcsObjectOptions & {
  * An abstract class providing features for {@link Layer}s which cannot provide features directly, but can provide features for
  * a given location, e.g. WmsLayer with a getFeatureInfo configuration. In this case, a feature provider can be created for this layer.
  */
-declare class AbstractFeatureProvider extends VcsObject {
+declare abstract class AbstractFeatureProvider extends VcsObject {
     static get className(): string;
     static getDefaultOptions(): AbstractFeatureProviderOptions;
-    /**
-     * The layer name of the associated layer
-     */
-    layerName: string;
     /**
      * The style set on features created by this provider
      */
     style: StyleItem | undefined;
-    /**
-     * Whether to show the geometry on selection.
-     */
-    showGeometry: boolean;
     /**
      * The vector properties assigned to features created by this provider
      */
@@ -50,7 +41,7 @@ declare class AbstractFeatureProvider extends VcsObject {
      * Map ClassNames Can be used to only apply this featureProvider to the specified maps
      */
     mapTypes: string[];
-    constructor(layerName: string, options: AbstractFeatureProviderOptions);
+    constructor(options: AbstractFeatureProviderOptions);
     /**
      * checks if the featureProvider is supported for provided Map
      */
@@ -59,20 +50,20 @@ declare class AbstractFeatureProvider extends VcsObject {
      * Ensures the feature has an ID, applies all vectorProperties and adds style and the vcsLayerName
      * and isProvidedFeature symbols to the feature
      */
-    getProviderFeature(feature: Feature): Feature;
+    getProviderFeature(feature: Feature, layer: Layer): Feature;
     /**
      * This method must be overwritten by any implementations. Before returning the array of features, be sure to use the getProviderFeature
      * on each feature to ensure all properties and symbols required by the VCM architecture
      * to handle your feature is called: (e.g. <code>return features.map(f => this.getProviderFeature(f)</code>);
      * @param coordinate - in mercator
      * @param resolution - meters per pixel for the given location
-     * @param headers - headers optional request headers to be sent with the server request
+     * @param layer - the layer to request the features for
      */
-    getFeaturesByCoordinate(_coordinate: Coordinate, _resolution: number, _headers?: Record<string, string>): Promise<Feature[]>;
+    abstract getFeaturesByCoordinate(coordinate: Coordinate, resolution: number, layer: Layer): Promise<Feature[]>;
     /**
      * Returns the object required to configure this feature provider.
      */
-    toJSON(): AbstractFeatureProviderOptions;
+    toJSON(defaultOptions?: AbstractFeatureProviderOptions): AbstractFeatureProviderOptions;
     destroy(): void;
 }
 export default AbstractFeatureProvider;

package/dist/src/featureProvider/abstractFeatureProvider.js

@@ -1,9 +1,8 @@
 import { v4 as uuidv4 } from 'uuid';
-import { parseBoolean } from '@vcsuite/parsers';
 import { vcsLayerName } from '../layer/layerSymbols.js';
 import VcsObject from '../vcsObject.js';
 import { getStyleOrDefaultStyle } from '../style/styleFactory.js';
-import { defaultVectorStyle } from '../style/vectorStyleItem.js';
+import { defaultVectorStyle, } from '../style/vectorStyleItem.js';
 import VectorProperties from '../layer/vectorProperties.js';
 import { isProvidedFeature } from './featureProviderSymbols.js';
 /**
@@ -19,22 +18,13 @@ class AbstractFeatureProvider extends VcsObject {
             vectorProperties: {
                 allowPicking: false,
             },
-            showGeometry: false,
             mapTypes: [],
         };
     }
-    /**
-     * The layer name of the associated layer
-     */
-    layerName;
     /**
      * The style set on features created by this provider
      */
     style;
-    /**
-     * Whether to show the geometry on selection.
-     */
-    showGeometry;
     /**
      * The vector properties assigned to features created by this provider
      */
@@ -43,14 +33,12 @@ class AbstractFeatureProvider extends VcsObject {
      * Map ClassNames Can be used to only apply this featureProvider to the specified maps
      */
     mapTypes;
-    constructor(layerName, options) {
-        super(options);
+    constructor(options) {
         const defaultOptions = AbstractFeatureProvider.getDefaultOptions();
-        this.layerName = layerName;
+        super({ ...defaultOptions, ...options });
         this.style = options.style
             ? getStyleOrDefaultStyle(options.style, defaultVectorStyle.clone())
             : undefined;
-        this.showGeometry = parseBoolean(options.showGeometry, defaultOptions.showGeometry);
         this.vectorProperties =
             options.vectorProperties instanceof VectorProperties
                 ? options.vectorProperties
@@ -73,14 +61,14 @@ class AbstractFeatureProvider extends VcsObject {
      * Ensures the feature has an ID, applies all vectorProperties and adds style and the vcsLayerName
      * and isProvidedFeature symbols to the feature
      */
-    getProviderFeature(feature) {
+    getProviderFeature(feature, layer) {
         if (!feature.getId()) {
             feature.setId(uuidv4());
         }
         if (this.style) {
             feature.setStyle(this.style.style);
         }
-        feature[vcsLayerName] = this.layerName;
+        feature[vcsLayerName] = layer.name;
         feature[isProvidedFeature] = true;
         Object.entries(this.vectorProperties.getValues()).forEach(([key, value]) => {
             const olcsKey = `olcs_${key}`;
@@ -90,34 +78,11 @@ class AbstractFeatureProvider extends VcsObject {
         });
         return feature;
     }
-    /**
-     * This method must be overwritten by any implementations. Before returning the array of features, be sure to use the getProviderFeature
-     * on each feature to ensure all properties and symbols required by the VCM architecture
-     * to handle your feature is called: (e.g. <code>return features.map(f => this.getProviderFeature(f)</code>);
-     * @param coordinate - in mercator
-     * @param resolution - meters per pixel for the given location
-     * @param headers - headers optional request headers to be sent with the server request
-     */
-    // eslint-disable-next-line class-methods-use-this
-    getFeaturesByCoordinate(
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    _coordinate, 
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    _resolution, 
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    _headers) {
-        return Promise.resolve([]);
-    }
     /**
      * Returns the object required to configure this feature provider.
      */
-    toJSON() {
-        const config = super.toJSON();
-        const defaultOptions = AbstractFeatureProvider.getDefaultOptions();
-        delete config.name; // the name is irrelevant, since its the layers name
-        if (this.showGeometry !== defaultOptions.showGeometry) {
-            config.showGeometry = this.showGeometry;
-        }
+    toJSON(defaultOptions = AbstractFeatureProvider.getDefaultOptions()) {
+        const config = super.toJSON(defaultOptions);
         if (this.style) {
             config.style = this.style.toJSON();
         }
@@ -128,6 +93,9 @@ class AbstractFeatureProvider extends VcsObject {
         if (Object.keys(vectorPropertiesConfig).length > 0) {
             config.vectorProperties = vectorPropertiesConfig;
         }
+        if (this.mapTypes.length > 0) {
+            config.mapTypes = this.mapTypes.slice();
+        }
         return config;
     }
     destroy() {

package/dist/src/featureProvider/abstractFeatureProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"abstractFeatureProvider.js","sourceRoot":"","sources":["../../../src/featureProvider/abstractFeatureProvider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"abstractFeatureProvider.js","sourceRoot":"","sources":["../../../src/featureProvider/abstractFeatureProvider.ts"],"names":[],"mappings":"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"}

package/dist/src/featureProvider/compositeFeatureProvider.d.ts

@@ -0,0 +1,27 @@
+import type Feature from 'ol/Feature.js';
+import type { Extent } from 'ol/extent.js';
+import type { AbstractFeatureProviderOptions } from './abstractFeatureProvider.js';
+import AbstractFeatureProvider from './abstractFeatureProvider.js';
+import AbstractAttributeProvider, { type AbstractAttributeProviderOptions, type AttributeProvider } from './abstractAttributeProvider.js';
+import type { EventFeature } from '../interaction/abstractInteraction.js';
+import type Layer from '../layer/layer.js';
+export type CompositeFeatureProviderOptions = AbstractFeatureProviderOptions & {
+    featureProviders: (AbstractFeatureProviderOptions | AbstractFeatureProvider)[];
+    attributeProviders: (AbstractAttributeProviderOptions | AbstractAttributeProvider)[];
+};
+/**
+ * A feature provider that combines multiple feature providers and attribute providers.
+ * Used to combine multiple feature & attribute providers for a layer.
+ * The order of providers is important, as attributes are applied and
+ * features are returned in the order.
+ */
+export default class CompositeFeatureProvider extends AbstractFeatureProvider implements AttributeProvider {
+    static get className(): string;
+    private _attributeProviders;
+    private _featureProviders;
+    constructor(options: CompositeFeatureProviderOptions);
+    augmentFeatures(features: EventFeature[], extent?: Extent): Promise<void>;
+    getFeaturesByCoordinate(coordinate: [number, number], resolution: number, layer: Layer): Promise<Feature[]>;
+    augmentFeature(feature: EventFeature): Promise<void>;
+    toJSON(defaultOptions?: AbstractFeatureProviderOptions): CompositeFeatureProviderOptions;
+}

package/dist/src/featureProvider/compositeFeatureProvider.js

@@ -0,0 +1,53 @@
+import AbstractFeatureProvider from './abstractFeatureProvider.js';
+import AbstractAttributeProvider from './abstractAttributeProvider.js';
+import { getProviderForOption } from './featureProviderFactory.js';
+/**
+ * A feature provider that combines multiple feature providers and attribute providers.
+ * Used to combine multiple feature & attribute providers for a layer.
+ * The order of providers is important, as attributes are applied and
+ * features are returned in the order.
+ */
+export default class CompositeFeatureProvider extends AbstractFeatureProvider {
+    static get className() {
+        return 'CompositeFeatureProvider';
+    }
+    _attributeProviders;
+    _featureProviders;
+    constructor(options) {
+        super(options);
+        this._featureProviders = options.featureProviders
+            .map(getProviderForOption)
+            .filter((fp) => fp instanceof AbstractFeatureProvider);
+        this._featureProviders.forEach((fp) => {
+            fp.mapTypes = this.mapTypes;
+        });
+        this._attributeProviders = options.attributeProviders
+            .map(getProviderForOption)
+            .filter((ap) => ap instanceof AbstractAttributeProvider);
+    }
+    async augmentFeatures(features, extent) {
+        for (const provider of this._attributeProviders) {
+            // order is relevant. second provider can overwrite or use attributes of first provider.
+            // eslint-disable-next-line no-await-in-loop
+            await provider.augmentFeatures(features, extent);
+        }
+    }
+    async getFeaturesByCoordinate(coordinate, resolution, layer) {
+        const featureArray = await Promise.all(this._featureProviders.map((fp) => fp.getFeaturesByCoordinate(coordinate, resolution, layer)));
+        return featureArray.flat();
+    }
+    async augmentFeature(feature) {
+        for (const provider of this._attributeProviders) {
+            // order is relevant. second provider can overwrite or use attributes of first provider.
+            // eslint-disable-next-line no-await-in-loop
+            await provider.augmentFeature(feature);
+        }
+    }
+    toJSON(defaultOptions = AbstractFeatureProvider.getDefaultOptions()) {
+        const config = super.toJSON(defaultOptions);
+        config.featureProviders = this._featureProviders.map((fp) => fp.toJSON());
+        config.attributeProviders = this._attributeProviders.map((ap) => ap.toJSON());
+        return config;
+    }
+}
+//# sourceMappingURL=compositeFeatureProvider.js.map

package/dist/src/featureProvider/compositeFeatureProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compositeFeatureProvider.js","sourceRoot":"","sources":["../../../src/featureProvider/compositeFeatureProvider.ts"],"names":[],"mappings":"AAGA,OAAO,uBAAuB,MAAM,8BAA8B,CAAC;AACnE,OAAO,yBAGN,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAanE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,wBACnB,SAAQ,uBAAuB;IAG/B,MAAM,KAAK,SAAS;QAClB,OAAO,0BAA0B,CAAC;IACpC,CAAC;IAEO,mBAAmB,CAAsB;IAEzC,iBAAiB,CAA4B;IAErD,YAAY,OAAwC;QAClD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,gBAAgB;aAC9C,GAAG,CAAC,oBAAoB,CAAC;aACzB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,YAAY,uBAAuB,CAAC,CAAC;QAEzD,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YACpC,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,kBAAkB;aAClD,GAAG,CAAC,oBAAoB,CAAC;aACzB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,YAAY,yBAAyB,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,QAAwB,EACxB,MAAe;QAEf,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAChD,wFAAwF;YACxF,4CAA4C;YAC5C,MAAM,QAAQ,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,UAA4B,EAC5B,UAAkB,EAClB,KAAY;QAEZ,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAChC,EAAE,CAAC,uBAAuB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,CAC1D,CACF,CAAC;QAEF,OAAO,YAAY,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAqB;QACxC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAChD,wFAAwF;YACxF,4CAA4C;YAC5C,MAAM,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,CACJ,iBAAiD,uBAAuB,CAAC,iBAAiB,EAAE;QAE5F,MAAM,MAAM,GAA6C,KAAK,CAAC,MAAM,CACnE,cAAc,CACf,CAAC;QAEF,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAC9D,EAAE,CAAC,MAAM,EAAE,CACZ,CAAC;QACF,OAAO,MAAyC,CAAC;IACnD,CAAC;CACF"}

package/dist/src/featureProvider/csvAttributeProvider.d.ts

@@ -0,0 +1,41 @@
+import AbstractAttributeProvider, { type AbstractAttributeProviderOptions } from './abstractAttributeProvider.js';
+export type CsvAttributeProviderOptions = AbstractAttributeProviderOptions & {
+    /**
+     * CSV data as a string or URL to fetch the CSV data from
+     */
+    data: string;
+    /**
+     * Delimiter used in the CSV data (default: ",")
+     */
+    delimiter?: string;
+    /**
+     * Column name to use as the feature ID (default: "id")
+     */
+    idColumn?: string;
+    /**
+     * Optional array of headers, if the data does not contain a header row. If not provided, the first row of the CSV data will be used as headers.
+     */
+    headers?: string[] | null;
+    httpHeaders?: Record<string, string>;
+};
+export default class CsvAttributeProvider extends AbstractAttributeProvider {
+    static get className(): string;
+    static getDefaultOptions(): Required<CsvAttributeProviderOptions>;
+    private _urlOrData;
+    private _data?;
+    private _delimiter;
+    private _idColumn;
+    private _headers?;
+    private _httpHeaders?;
+    private _dataLoadingPromise?;
+    constructor(options: CsvAttributeProviderOptions);
+    private _readLine;
+    private _loadData;
+    private _ensureDataLoaded;
+    protected _getAttributes(key: string): Promise<Record<string, unknown> | undefined>;
+    protected _getBulkAttributes(bulk: {
+        key: string;
+    }[]): Promise<(Record<string, unknown> | undefined)[]>;
+    toJSON(defaultOptions?: Required<CsvAttributeProviderOptions>): CsvAttributeProviderOptions;
+    destroy(): void;
+}

package/dist/src/featureProvider/csvAttributeProvider.js

@@ -0,0 +1,126 @@
+import AbstractAttributeProvider from './abstractAttributeProvider.js';
+import { featureProviderClassRegistry } from '../classRegistry.js';
+import { getInitForUrl } from '../util/fetch.js';
+export default class CsvAttributeProvider extends AbstractAttributeProvider {
+    static get className() {
+        return 'CsvAttributeProvider';
+    }
+    static getDefaultOptions() {
+        return {
+            name: '',
+            keyProperty: '',
+            properties: {},
+            type: CsvAttributeProvider.className,
+            data: '',
+            delimiter: ',',
+            idColumn: 'id',
+            headers: null,
+            httpHeaders: {},
+        };
+    }
+    _urlOrData;
+    _data;
+    _delimiter;
+    _idColumn;
+    _headers;
+    _httpHeaders;
+    _dataLoadingPromise;
+    constructor(options) {
+        const defaultOptions = CsvAttributeProvider.getDefaultOptions();
+        super({ ...defaultOptions, ...options });
+        this._urlOrData = options.data;
+        this._delimiter = options.delimiter ?? defaultOptions.delimiter;
+        this._idColumn = options.idColumn ?? defaultOptions.idColumn;
+        if (Array.isArray(options.headers)) {
+            this._headers = options.headers.slice();
+        }
+        if (options.httpHeaders) {
+            this._httpHeaders = structuredClone(options.httpHeaders);
+        }
+    }
+    _readLine(line) {
+        return line.split(this._delimiter).map((v) => v.trim());
+    }
+    async _loadData() {
+        if (this._data) {
+            return;
+        }
+        let csvData;
+        // Check if URL contains newline - if so, it's the data itself
+        if (this._urlOrData.includes('\n')) {
+            csvData = this._urlOrData;
+        }
+        else {
+            const init = getInitForUrl(this._urlOrData, this._httpHeaders);
+            const response = await fetch(this._urlOrData, init);
+            if (!response.ok) {
+                throw new Error(`Failed to fetch CSV data from ${this._urlOrData}`);
+            }
+            csvData = await response.text();
+        }
+        // Split by both Windows (\r\n) and Unix (\n) line endings
+        const lines = csvData.split(/\r?\n/).filter((line) => line.trim() !== '');
+        if (lines.length === 0) {
+            this.getLogger().warning('No CSV data available to load.');
+            this._data = new Map();
+            return;
+        }
+        const dataMap = new Map();
+        let startIndex = 0;
+        if (!this._headers) {
+            this._headers = this._readLine(lines[0]);
+            startIndex = 1;
+        }
+        for (let i = startIndex; i < lines.length; i++) {
+            const values = this._readLine(lines[i]);
+            const attributes = {};
+            for (let j = 0; j < values.length; j++) {
+                const key = this._headers[j] ?? `column_${j}`;
+                attributes[key] = values[j];
+            }
+            const id = attributes[this._idColumn];
+            if (typeof id === 'string') {
+                dataMap.set(id, attributes);
+            }
+        }
+        this._data = dataMap;
+    }
+    _ensureDataLoaded() {
+        if (!this._dataLoadingPromise) {
+            this._dataLoadingPromise = this._loadData();
+        }
+        return this._dataLoadingPromise;
+    }
+    async _getAttributes(key) {
+        await this._ensureDataLoaded();
+        return this._data?.get(key);
+    }
+    async _getBulkAttributes(bulk) {
+        await this._ensureDataLoaded();
+        return bulk.map(({ key }) => this._data?.get(key));
+    }
+    toJSON(defaultOptions = CsvAttributeProvider.getDefaultOptions()) {
+        const config = super.toJSON(defaultOptions);
+        config.data = this._urlOrData;
+        if (this._delimiter !== defaultOptions.delimiter) {
+            config.delimiter = this._delimiter;
+        }
+        if (this._idColumn !== defaultOptions.idColumn) {
+            config.idColumn = this._idColumn;
+        }
+        if (this._headers && this._headers.length > 0) {
+            config.headers = this._headers.slice();
+        }
+        if (this._httpHeaders) {
+            config.httpHeaders = structuredClone(this._httpHeaders);
+        }
+        return config;
+    }
+    destroy() {
+        this._data?.clear();
+        this._data = undefined;
+        super.destroy();
+    }
+}
+featureProviderClassRegistry.registerClass(CsvAttributeProvider.className, CsvAttributeProvider);
+//# sourceMappingURL=csvAttributeProvider.js.map

package/dist/src/featureProvider/csvAttributeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csvAttributeProvider.js","sourceRoot":"","sources":["../../../src/featureProvider/csvAttributeProvider.ts"],"names":[],"mappings":"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"}

package/dist/src/featureProvider/featureProviderFactory.d.ts

@@ -0,0 +1,3 @@
+import AbstractFeatureProvider, { type AbstractFeatureProviderOptions } from './abstractFeatureProvider.js';
+import AbstractAttributeProvider, { type AbstractAttributeProviderOptions } from './abstractAttributeProvider.js';
+export declare function getProviderForOption(options?: AbstractFeatureProviderOptions | AbstractAttributeProviderOptions | AbstractAttributeProvider | AbstractFeatureProvider): AbstractFeatureProvider | AbstractAttributeProvider | undefined;

package/dist/src/featureProvider/featureProviderFactory.js

@@ -0,0 +1,17 @@
+import AbstractFeatureProvider from './abstractFeatureProvider.js';
+import AbstractAttributeProvider from './abstractAttributeProvider.js';
+import { featureProviderClassRegistry } from '../classRegistry.js';
+export function getProviderForOption(options) {
+    if (options instanceof AbstractFeatureProvider ||
+        options instanceof AbstractAttributeProvider) {
+        return options;
+    }
+    if (options?.type) {
+        const CTOR = featureProviderClassRegistry.getClass(options.type);
+        if (CTOR) {
+            return new CTOR(options);
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=featureProviderFactory.js.map

package/dist/src/featureProvider/featureProviderFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureProviderFactory.js","sourceRoot":"","sources":["../../../src/featureProvider/featureProviderFactory.ts"],"names":[],"mappings":"AAAA,OAAO,uBAEN,MAAM,8BAA8B,CAAC;AACtC,OAAO,yBAEN,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,UAAU,oBAAoB,CAClC,OAI2B;IAE3B,IACE,OAAO,YAAY,uBAAuB;QAC1C,OAAO,YAAY,yBAAyB,EAC5C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,4BAA4B,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}