@vcmap/core 5.0.0-rc.8 → 5.0.0

package/index.js

@@ -1,147 +0,0 @@
-import './src/ol/geom/circle.js';
-import './src/ol/geom/geometryCollection.js';
-import './src/ol/feature.js';
-import './src/cesium/wallpaperMaterial.js';
-import './src/cesium/cesium3DTilePointFeature.js';
-import './src/cesium/cesium3DTileFeature.js';
-import './src/cesium/cesiumVcsCameraPrimitive.js';
-
-export { default as AppBackedCategory } from './src/category/appBackedCategory.js';
-export { default as Category } from './src/category/category.js';
-export { default as CategoryCollection } from './src/category/categoryCollection.js';
-export { VcsClassRegistry, default as ClassRegistry } from './src/classRegistry.js';
-export { default as Context } from './src/context.js';
-export { default as AbstractFeatureProvider } from './src/featureProvider/abstractFeatureProvider.js';
-export { getGenericFeatureFromProvidedFeature } from './src/featureProvider/featureProviderHelpers.js';
-export { isProvidedFeature, showProvidedFeature } from './src/featureProvider/featureProviderSymbols.js';
-export { default as TileProviderFeatureProvider } from './src/featureProvider/tileProviderFeatureProvider.js';
-export { getFormat, default as WMSFeatureProvider } from './src/featureProvider/wmsFeatureProvider.js';
-export { styleCollection } from './src/globalCollections.js';
-export { default as AbstractInteraction } from './src/interaction/abstractInteraction.js';
-export { default as CoordinateAtPixel } from './src/interaction/coordinateAtPixel.js';
-export { default as EventHandler } from './src/interaction/eventHandler.js';
-export { default as FeatureAtPixelInteraction } from './src/interaction/featureAtPixelInteraction.js';
-export { default as FeatureProviderInteraction } from './src/interaction/featureProviderInteraction.js';
-export { default as InteractionChain } from './src/interaction/interactionChain.js';
-export { BitCounter, ModificationKeyType, EventType, PointerKeyType, PointerEventType } from './src/interaction/interactionType.js';
-export { cesiumTilesetLastUpdated, getExtentFromTileset, default as CesiumTilesetCesiumImpl } from './src/layer/cesium/cesiumTilesetCesiumImpl.js';
-export { default as ClusterContext } from './src/layer/cesium/clusterContext.js';
-export { default as DataSourceCesiumImpl } from './src/layer/cesium/dataSourceCesiumImpl.js';
-export { default as OpenStreetMapCesiumImpl } from './src/layer/cesium/openStreetMapCesiumImpl.js';
-export { default as PointCloudCesiumImpl } from './src/layer/cesium/pointCloudCesiumImpl.js';
-export { default as RasterLayerCesiumImpl } from './src/layer/cesium/rasterLayerCesiumImpl.js';
-export { default as SingleImageCesiumImpl } from './src/layer/cesium/singleImageCesiumImpl.js';
-export { default as TerrainCesiumImpl } from './src/layer/cesium/terrainCesiumImpl.js';
-export { default as TmsCesiumImpl } from './src/layer/cesium/tmsCesiumImpl.js';
-export { default as VectorCesiumImpl } from './src/layer/cesium/vectorCesiumImpl.js';
-export { setReferenceForPicking, removeArrayFromCollection, removeFeatureFromMap, addPrimitiveToContext, default as VectorContext } from './src/layer/cesium/vectorContext.js';
-export { default as VectorRasterTileCesiumImpl } from './src/layer/cesium/vectorRasterTileCesiumImpl.js';
-export { toContext, getCanvasFromFeatures, default as VectorTileImageryProvider } from './src/layer/cesium/vectorTileImageryProvider.js';
-export { default as WmsCesiumImpl } from './src/layer/cesium/wmsCesiumImpl.js';
-export { default as WmtsCesiumImpl } from './src/layer/cesium/wmtsCesiumImpl.js';
-export { default as getJSONObjectFromObject } from './src/layer/cesium/x3dmHelper.js';
-export { default as CesiumTilesetLayer } from './src/layer/cesiumTilesetLayer.js';
-export { default as CzmlLayer } from './src/layer/czmlLayer.js';
-export { default as DataSourceLayer } from './src/layer/dataSourceLayer.js';
-export { default as FeatureLayer } from './src/layer/featureLayer.js';
-export { isTiledFeature, default as FeatureStoreLayer } from './src/layer/featureStoreLayer.js';
-export { default as FeatureStoreLayerChanges } from './src/layer/featureStoreLayerChanges.js';
-export { featureStoreStateSymbol, FeatureStoreLayerState } from './src/layer/featureStoreLayerState.js';
-export { originalStyle, highlighted, hidden, globalHidden, featureExists, FeatureVisibilityAction, synchronizeFeatureVisibility, default as FeatureVisibility } from './src/layer/featureVisibility.js';
-export { getEPSGCodeFromGeojson, updateLegacyFeature, parseGeoJSON, writeGeoJSONFeature, writeGeoJSON } from './src/layer/geojsonHelpers.js';
-export { featureFromOptions, default as GeoJSONLayer } from './src/layer/geojsonLayer.js';
-export { getGlobalHider, default as GlobalHider } from './src/layer/globalHider.js';
-export { vcsMetaVersion, default as Layer } from './src/layer/layer.js';
-export { default as LayerImplementation } from './src/layer/layerImplementation.js';
-export { default as LayerState } from './src/layer/layerState.js';
-export { vcsLayerName } from './src/layer/layerSymbols.js';
-export { default as LayerObliqueImpl } from './src/layer/oblique/layerObliqueImpl.js';
-export { getLongestSide, getResolutionOptions, getZoom, mercatorGeometryToImageGeometry, imageGeometryToMercatorGeometry, getPolygonizedGeometry, setNewGeometry } from './src/layer/oblique/obliqueHelpers.js';
-export { default as VectorObliqueImpl } from './src/layer/oblique/vectorObliqueImpl.js';
-export { default as OpenStreetMapLayer } from './src/layer/openStreetMapLayer.js';
-export { default as LayerOpenlayersImpl } from './src/layer/openlayers/layerOpenlayersImpl.js';
-export { default as OpenStreetMapOpenlayersImpl } from './src/layer/openlayers/openStreetMapOpenlayersImpl.js';
-export { default as RasterLayerOpenlayersImpl } from './src/layer/openlayers/rasterLayerOpenlayersImpl.js';
-export { default as SingleImageOpenlayersImpl } from './src/layer/openlayers/singleImageOpenlayersImpl.js';
-export { default as TileDebugOpenlayersImpl } from './src/layer/openlayers/tileDebugOpenlayersImpl.js';
-export { default as TmsOpenlayersImpl } from './src/layer/openlayers/tmsOpenlayersImpl.js';
-export { default as VectorOpenlayersImpl } from './src/layer/openlayers/vectorOpenlayersImpl.js';
-export { default as VectorTileOpenlayersImpl } from './src/layer/openlayers/vectorTileOpenlayersImpl.js';
-export { default as WmsOpenlayersImpl } from './src/layer/openlayers/wmsOpenlayersImpl.js';
-export { default as WmtsOpenlayersImpl } from './src/layer/openlayers/wmtsOpenlayersImpl.js';
-export { defaultPointCloudStyle, default as PointCloudLayer } from './src/layer/pointCloudLayer.js';
-export { TilingScheme, getTilingScheme, calculateMinLevel, default as RasterLayer } from './src/layer/rasterLayer.js';
-export { default as SingleImageLayer } from './src/layer/singleImageLayer.js';
-export { getTerrainProviderForUrl, sampleCesiumTerrainMostDetailed, sampleCesiumTerrain, getHeightFromTerrainProvider, isTerrainTileAvailable } from './src/layer/terrainHelpers.js';
-export { default as TerrainLayer } from './src/layer/terrainLayer.js';
-export { tiledLayerLoaded, globeLoaded } from './src/layer/tileLoadedHelper.js';
-export { default as MVTTileProvider } from './src/layer/tileProvider/mvtTileProvider.js';
-export { default as StaticGeoJSONTileProvider } from './src/layer/tileProvider/staticGeojsonTileProvider.js';
-export { mercatorResolutionsToLevel, rectangleToExtent, default as TileProvider } from './src/layer/tileProvider/tileProvider.js';
-export { default as factory } from './src/layer/tileProvider/tileProviderFactory.js';
-export { getURL, default as URLTemplateTileProvider } from './src/layer/tileProvider/urlTemplateTileProvider.js';
-export { default as TMSLayer } from './src/layer/tmsLayer.js';
-export { fvLastUpdated, globalHiderLastUpdated, updateFeatureVisibility, updateGlobalHider, synchronizeFeatureVisibilityWithSource, getGenericFeatureFromClickedObject } from './src/layer/vectorHelpers.js';
-export { default as VectorLayer } from './src/layer/vectorLayer.js';
-export { AltitudeModeCesium, ClassificationTypeCesium, parseNearFarScalar, parseCartesian3, parseStoreyHeights, getAltitudeModeOptions, getClassificationTypeOptions, getNearFarValueOptions, getCartesian3Options, default as VectorProperties } from './src/layer/vectorProperties.js';
-export { alreadyTransformedToMercator, alreadyTransformedToImage, obliqueGeometry, doNotTransform, originalFeatureSymbol, actuallyIsCircle } from './src/layer/vectorSymbols.js';
-export { default as VectorTileLayer } from './src/layer/vectorTileLayer.js';
-export { default as WFSLayer } from './src/layer/wfsLayer.js';
-export { getWMSSource } from './src/layer/wmsHelpers.js';
-export { default as WMSLayer } from './src/layer/wmsLayer.js';
-export { default as WMTSLayer } from './src/layer/wmtsLayer.js';
-export { default as BaseOLMap } from './src/map/baseOLMap.js';
-export { CameraLimiterMode, default as CameraLimiter } from './src/map/cameraLimiter.js';
-export { default as CesiumMap } from './src/map/cesiumMap.js';
-export { default as MapState } from './src/map/mapState.js';
-export { getViewDirectionFromViewPoint, default as ObliqueMap } from './src/map/obliqueMap.js';
-export { default as OpenlayersMap } from './src/map/openlayersMap.js';
-export { default as VcsMap } from './src/map/vcsMap.js';
-export { default as DefaultObliqueCollection } from './src/oblique/defaultObliqueCollection.js';
-export { sortRealWordEdgeCoordinates, checkLineIntersection, transformCWIFC, transformToImage, transformFromImage, hasSameOrigin } from './src/oblique/helpers.js';
-export { default as ObliqueCollection } from './src/oblique/obliqueCollection.js';
-export { DataState, getStateFromStatesArray, default as ObliqueDataSet } from './src/oblique/obliqueDataSet.js';
-export { default as ObliqueImage } from './src/oblique/obliqueImage.js';
-export { default as ObliqueImageMeta } from './src/oblique/obliqueImageMeta.js';
-export { default as ObliqueProvider } from './src/oblique/obliqueProvider.js';
-export { default as ObliqueView } from './src/oblique/obliqueView.js';
-export { ObliqueViewDirection, obliqueViewDirectionNames, getDirectionName } from './src/oblique/obliqueViewDirection.js';
-export { getVersionFromImageJson, parseImageMeta, parseImageData, parseLegacyImageData } from './src/oblique/parseImageJson.js';
-export { defaultDeclarativeStyle, default as DeclarativeStyleItem } from './src/style/declarativeStyleItem.js';
-export { getShapeFromOptions, shapeCategory } from './src/style/shapesCategory.js';
-export { getStyleOrDefaultStyle } from './src/style/styleFactory.js';
-export { PatternType, hexToOlColor, cesiumColorToColor, olColorToCesiumColor, parseColor, getCesiumColor, getStringColor, createPattern, olColorToHex, validateHexColor, parseFont, combineFont, colorInCanvas, getFillOptions, getStrokeOptions, getTextOptions, getTextFromOptions, getCssStyleFromTextStyle, emptyStyle, emptyColor, whiteColor, blackColor, getDefaultVectorStyleItemOptions, getDefaultCondition, defaultExtrudedHeightCondition } from './src/style/styleHelpers.js';
-export { StyleType, referenceableStyleSymbol, default as StyleItem } from './src/style/styleItem.js';
-export { OlcsGeometryType, vectorStyleSymbol, defaultVectorStyle, fromCesiumColor, default as VectorStyleItem } from './src/style/vectorStyleItem.js';
-export { embedIconsInStyle, default as writeStyle } from './src/style/writeStyle.js';
-export { default as ClippingObject } from './src/util/clipping/clippingObject.js';
-export { default as ClippingObjectManager } from './src/util/clipping/clippingObjectManager.js';
-export { createClippingPlaneCollection, copyClippingPlanesToCollection, clearClippingPlanes, setClippingPlanes, createClippingFeature, getClippingOptions } from './src/util/clipping/clippingPlaneHelper.js';
-export { default as Collection } from './src/util/collection.js';
-export { getShortLocaleDate, getShortLocaleTime, getISODateString, getDayOfYear, isLeapYear } from './src/util/dateTime.js';
-export { default as ExclusiveManager } from './src/util/exclusiveManager.js';
-export { default as Extent } from './src/util/extent.js';
-export { validateCircle, default as circleToCesium } from './src/util/featureconverter/circleToCesium.js';
-export { getStylesArray, default as convert } from './src/util/featureconverter/convert.js';
-export { default as Extent3D } from './src/util/featureconverter/extent3D.js';
-export { getMaterialAppearance, createClassificationPrimitive, createPrimitive, createOutlinePrimitive, createLinePrimitive, getMinHeightOrGroundLevel, getStoreyHeights, validateStoreys, getHeightAboveGround, getHeightInfo, getStoreyOptions, addPrimitivesToContext } from './src/util/featureconverter/featureconverterHelper.js';
-export { validateLineString, default as lineStringToCesium } from './src/util/featureconverter/lineStringToCesium.js';
-export { getBillboardOptions, getLabelOptions, getModelOptions, validatePoint, getCartesian3AndWGS84FromCoordinates, default as pointToCesium } from './src/util/featureconverter/pointToCesium.js';
-export { validatePolygon, default as polygonToCesium } from './src/util/featureconverter/polygonToCesium.js';
-export { requestUrl, requestJson, requestArrayBuffer } from './src/util/fetch.js';
-export { getFlatCoordinatesFromSimpleGeometry, getFlatCoordinatesFromGeometry, circleFromCenterRadius, convertGeometryToPolygon, enforceEndingVertex, removeEndingVertex, removeEndingVertexFromGeometry, enforceRightHand } from './src/util/geometryHelpers.js';
-export { default as IndexedCollection } from './src/util/indexedCollection.js';
-export { isMobile } from './src/util/isMobile.js';
-export { default as LayerCollection } from './src/util/layerCollection.js';
-export { getLocaleChangedEvent, detectBrowserLocale, getCurrentLocale, setCurrentLocale } from './src/util/locale.js';
-export { default as MapCollection } from './src/util/mapCollection.js';
-export { coordinateAtDistance, initialBearingBetweenCoords, cartesian2DDistance, cartesian3DDistance } from './src/util/math.js';
-export { isOverrideCollection, default as makeOverrideCollection } from './src/util/overrideCollection.js';
-export { wgs84ToMercatorTransformer, mercatorToWgs84Transformer, setDefaultProjectionOptions, getDefaultProjection, wgs84Projection, mercatorProjection, default as Projection } from './src/util/projection.js';
-export { default as SplitScreen } from './src/util/splitScreen.js';
-export { isSameOrigin } from './src/util/urlHelpers.js';
-export { propertyEqualsEpsilon, angleEqualsEpsilon, coordinateEqualsEpsilon, default as ViewPoint } from './src/util/viewpoint.js';
-export { getVcsAppById, default as VcsApp } from './src/vcsApp.js';
-export { contextIdSymbol, getObjectFromOptions, deserializeMap, deserializeViewPoint, serializeLayer, getLayerIndex, destroyCollection } from './src/vcsAppContextHelpers.js';
-export { default as VcsEvent } from './src/vcsEvent.js';
-export { default as VcsObject } from './src/vcsObject.js';

package/src/category/appBackedCategory.js

@@ -1,41 +0,0 @@
-import Category from './category.js';
-import { VcsClassRegistry } from '../classRegistry.js';
-
-/**
- * @typedef {CategoryOptions} AppBackedCategoryOptions
- * @property {string} collectionName
- */
-
-/**
- * @class
- * @extends {Category<import("@vcmap/core").VcsObject>}
- */
-class AppBackedCategory extends Category {
-  static get className() { return 'AppBackedCategory'; }
-
-  /**
-   * @param {AppBackedCategoryOptions} options
-   */
-  constructor(options) {
-    options.typed = true;
-    super(options);
-    this._collectionName = options.collectionName;
-  }
-
-  setApp(app) {
-    super.setApp(app);
-    this.setCollection(this._app[this._collectionName]);
-  }
-
-  /**
-   * @param {string} contextId
-   * @returns {null}
-   */
-  // eslint-disable-next-line class-methods-use-this,no-unused-vars
-  serializeForContext(contextId) {
-    return null;
-  }
-}
-
-export default AppBackedCategory;
-VcsClassRegistry.registerClass(AppBackedCategory.className, AppBackedCategory);

package/src/category/category.js

@@ -1,374 +0,0 @@
-import { check } from '@vcsuite/check';
-import { v4 as uuidv4 } from 'uuid';
-import { parseBoolean } from '@vcsuite/parsers';
-import { Feature } from 'ol';
-import { contextIdSymbol, destroyCollection, getObjectFromOptions } from '../vcsAppContextHelpers.js';
-import makeOverrideCollection, { isOverrideCollection } from '../util/overrideCollection.js';
-import VcsObject from '../vcsObject.js';
-import VectorLayer from '../layer/vectorLayer.js';
-import IndexedCollection from '../util/indexedCollection.js';
-import { parseGeoJSON, writeGeoJSONFeature } from '../layer/geojsonHelpers.js';
-import Collection from '../util/collection.js';
-import { VcsClassRegistry } from '../classRegistry.js';
-import { getStyleOrDefaultStyle } from '../style/styleFactory.js';
-
-/**
- * @typedef {VcsObjectOptions} CategoryOptions
- * @property {string|Object<string, string>} [title]
- * @property {boolean} [typed=false]
- * @property {string|undefined} [featureProperty]
- * @property {VectorOptions} [layerOptions={}]
- * @property {Array<Object>} [items] - items are not evaluated by the constructor but passed to parseItem during deserialization.
- * @property {string} [keyProperty=name]
- */
-
-/**
- * @type {*|string}
- */
-const categoryContextId = uuidv4();
-
-/**
- * @param {import("@vcmap/core").VectorLayer} layer
- * @param {VectorOptions} options
- * @private
- */
-function assignLayerOptions(layer, options) {
-  if (options.style) {
-    layer.setStyle(getStyleOrDefaultStyle(options.style, layer.defaultStyle));
-  }
-
-  if (options.highlightStyle) {
-    const highlightStyle = getStyleOrDefaultStyle(options.highlightStyle, layer.highlightStyle);
-    layer.setHighlightStyle(/** @type {import("@vcmap/core").VectorStyleItem} */ (highlightStyle));
-  }
-
-  if (options.vectorProperties) {
-    layer.vectorProperties.setValues(options.vectorProperties);
-  }
-
-  if (options.zIndex != null) {
-    layer.zIndex = options.zIndex;
-  }
-}
-
-/**
- * @param {string} key
- * @param {T} value
- * @param {T} defaultOption
- * @param {T=} option
- * @template {number|boolean|string} T
- * @returns {void}
- */
-function checkMergeOptionOverride(key, value, defaultOption, option) {
-  const isOverride = option == null ? value !== defaultOption : option !== value;
-  if (isOverride) {
-    throw new Error(`Cannot merge options, values of ${key} do not match`);
-  }
-}
-
-/**
- * A category contains user based items and is a special container. The container should not be created directly, but via
- * the requestCategory API on the categories collection. Do not use toJSON to retrieve the state of a category, since
- * categories outlive contexts and may be changed with mergeOptions to no longer reflect your initial state. Requestors
- * should keep track of the requested options themselves.
- * @class
- * @extends {VcsObject}
- * @template {Object|VcsObject} T
- */
-class Category extends VcsObject {
-  static get className() { return 'Category'; }
-
-  /**
-   * @returns {CategoryOptions}
-   */
-  static getDefaultConfig() {
-    return {
-      title: '',
-      featureProperty: undefined,
-      typed: false,
-      layerOptions: {},
-      keyProperty: 'name',
-      items: [],
-    };
-  }
-
-  /**
-   * @param {CategoryOptions} options
-   */
-  constructor(options) {
-    super(options);
-    const defaultOptions = Category.getDefaultConfig();
-    /**
-     * @type {string|Object<string, string>}
-     */
-    this.title = options.title || this.name;
-    /**
-     * @type {import("@vcmap/core").VcsApp}
-     * @protected
-     */
-    this._app = null;
-    /**
-     * @type {string}
-     * @private
-     */
-    this._featureProperty = options.featureProperty || defaultOptions.featureProperty;
-    /**
-     * @type {boolean}
-     * @private
-     */
-    this._typed = parseBoolean(options.typed, defaultOptions.typed);
-    /**
-     * @type {VectorOptions}
-     * @private
-     */
-    this._layerOptions = options.layerOptions || defaultOptions.layerOptions;
-    /**
-     * @type {import("@vcmap/core").VectorLayer}
-     * @protected
-     */
-    this._layer = null;
-    if (this._featureProperty) {
-      this._layer = new VectorLayer(this._layerOptions);
-      this._layer[contextIdSymbol] = categoryContextId;
-    }
-    /**
-     * @type {string}
-     * @private
-     */
-    this._keyProperty = options.keyProperty || defaultOptions.keyProperty;
-    /**
-     * @type {Array<function():void>}
-     * @private
-     */
-    this._collectionListeners = [];
-    /**
-     * @type {OverrideCollection<T>}
-     * @private
-     */
-    this._collection = null;
-    this.setCollection(new IndexedCollection(this._keyProperty));
-    /**
-     * @type {function():void}
-     * @private
-     */
-    this._contextRemovedListener = () => {};
-  }
-
-  /**
-   * The collection of this category.
-   * @type {OverrideCollection<T>}
-   * @readonly
-   */
-  get collection() {
-    return this._collection;
-  }
-
-  /**
-   * Returns the layer of this collection. Caution, do not use the layer API to add or remove items.
-   * When adding items to the collection, the features are added to the layer async (timeout of 0), since there is weird behavior
-   * when removing and adding a feature with the same id in the same sync call.
-   * @type {import("@vcmap/core").VectorLayer|null}
-   */
-  get layer() {
-    return this._layer;
-  }
-
-  /**
-   * @param {T} item
-   * @protected
-   */
-  _itemAdded(item) {
-    if (this._featureProperty) {
-      const id = item[this._keyProperty];
-      this._layer.removeFeaturesById([id]); // this may be a replacement.
-
-      const geoJsonFeature = item[this._featureProperty];
-      let feature;
-      if (geoJsonFeature instanceof Feature) {
-        feature = geoJsonFeature;
-      } else if (typeof geoJsonFeature === 'object') {
-        const { features } = parseGeoJSON(geoJsonFeature);
-        if (features[0]) { // XXX do we warn on feature collection?
-          feature = features[0];
-        }
-      }
-
-      if (feature) {
-        feature.setId(id);
-        setTimeout(() => { this._layer.addFeatures([feature]); }, 0); // We need to set a timeout, since removing and adding the feature in the same sync call leads to undefined behavior in OL TODO recheck in ol 6.11
-      }
-    }
-  }
-
-  /**
-   * @param {T} item
-   * @protected
-   */
-  _itemRemoved(item) {
-    if (this._featureProperty) {
-      this._layer.removeFeaturesById([item[this._keyProperty]]);
-    }
-  }
-
-  /**
-   * @param {T} item
-   * @protected
-   */
-  // eslint-disable-next-line class-methods-use-this,no-unused-vars
-  _itemReplaced(item) {}
-
-  /**
-   * @param {T} item
-   * @protected
-   */
-  // eslint-disable-next-line class-methods-use-this,no-unused-vars
-  _itemMoved(item) {}
-
-  /**
-   * @returns {string}
-   * @private
-   */
-  _getDynamicContextId() {
-    if (!this._app) {
-      throw new Error('Cannot get dynamic context id, before setting the vcApp');
-    }
-    return this._app.dynamicContextId;
-  }
-
-  /**
-   * Throws if typed, featureProperty and keyProperty do not match. Merges other options.
-   * Only merges: style, highlightStyle, zIndex & vectorProperties from layerOptions.
-   * @param {CategoryOptions} options
-   */
-  mergeOptions(options) {
-    const defaultOptions = Category.getDefaultConfig();
-    checkMergeOptionOverride('typed', this._typed, defaultOptions.typed, options.typed);
-    checkMergeOptionOverride(
-      'featureProperty',
-      this._featureProperty,
-      defaultOptions.featureProperty,
-      options.featureProperty,
-    );
-    checkMergeOptionOverride('keyProperty', this._keyProperty, defaultOptions.keyProperty, options.keyProperty);
-    this.title = options.title || this.title;
-    if (options.layerOptions && this._layer) {
-      assignLayerOptions(this._layer, options.layerOptions);
-    }
-  }
-
-  /**
-   * When setting the category, it MUST use the same unqiueKey as the previous collection (default is "name").
-   * All items in the current collection _will be destroyed_ and the current collection will be destroyed. The category will take
-   * complete ownership of the collection and destroy it once the category is destroyed. The collection will
-   * be turned into an {@see OverrideCollection}.
-   * @param {import("@vcmap/core").Collection<T>} collection
-   */
-  setCollection(collection) {
-    check(collection, Collection);
-
-    if (this._keyProperty !== collection.uniqueKey) {
-      throw new Error('The collections key property does not match the categories key property');
-    }
-
-    this._collectionListeners.forEach((cb) => { cb(); });
-    if (this._collection) {
-      destroyCollection(this._collection);
-    }
-    if (this._layer) {
-      this._layer.removeAllFeatures(); // XXX should we call `itemRemoved` instead?
-    }
-
-    this._collection = collection[isOverrideCollection] ?
-      /** @type {OverrideCollection} */ (collection) :
-      makeOverrideCollection(
-        collection,
-        this._getDynamicContextId.bind(this),
-        this._serializeItem.bind(this),
-        this._typed ? getObjectFromOptions : null,
-      );
-
-    [...this.collection].forEach((item) => { this._itemAdded(item); });
-    /**
-     * @type {Array<function():void>}
-     * @private
-     */
-    this._collectionListeners = [
-      this._collection.added.addEventListener(this._itemAdded.bind(this)),
-      this._collection.removed.addEventListener(this._itemRemoved.bind(this)),
-      this._collection.replaced.addEventListener(this._itemReplaced.bind(this)),
-    ];
-
-    // @ts-ignore
-    if (this._collection.moved) {
-      // @ts-ignore
-      this._collectionListeners.push(this._collection.moved.addEventListener(this._itemMoved.bind(this)));
-    }
-  }
-
-  /**
-   * @param {import("@vcmap/core").VcsApp} app
-   */
-  setApp(app) {
-    if (this._app) {
-      throw new Error('Cannot switch apps');
-    }
-    this._app = app;
-    this._contextRemovedListener = this._app.contextRemoved.addEventListener((context) => {
-      this._collection.removeContext(context.id);
-    });
-    if (this._layer) {
-      this._app.layers.add(this._layer);
-    }
-  }
-
-  /**
-   * @protected
-   * @param {T} item
-   * @returns {Array<Object>}
-   */
-  _serializeItem(item) {
-    const config = JSON.parse(JSON.stringify(item));
-    if (this._featureProperty) {
-      const feature = this._layer.getFeatureById(item[this._keyProperty]);
-      if (feature) {
-        config[this._featureProperty] = writeGeoJSONFeature(feature);
-      }
-    }
-    return config;
-  }
-
-  /**
-   * @param {string} contextId
-   * @returns {CategoryOptions|null}
-   */
-  serializeForContext(contextId) {
-    if (this._collection.size === 0) {
-      return null;
-    }
-
-    return {
-      name: this.name,
-      items: this.collection.serializeContext(contextId),
-    };
-  }
-
-  destroy() {
-    super.destroy();
-    if (this._app && this._layer) {
-      this._app.layers.remove(this._layer);
-    }
-    if (this._layer) {
-      this._layer.destroy();
-    }
-
-    this._collectionListeners.forEach((cb) => { cb(); });
-    this._collectionListeners.splice(0);
-    this._contextRemovedListener();
-    this._contextRemovedListener = () => {};
-    destroyCollection(this._collection);
-    this._app = null;
-  }
-}
-
-export default Category;
-VcsClassRegistry.registerClass(Category.className, Category);