@vcmap/ui 5.0.2 → 5.1.0-rc.2

package/src/featureInfo/abstractFeatureInfoView.js

@@ -1,5 +1,6 @@
 import { VcsObject } from '@vcmap/core';
 import { WindowSlot } from '../manager/window/windowManager.js';
+import { defaultTagOptions } from '../components/tables/VcsTable.vue';
 
 /**
  * @typedef {Object} FeatureInfoProps
@@ -7,14 +8,28 @@ import { WindowSlot } from '../manager/window/windowManager.js';
  * @property {string} layerName
  * @property {Object} layerProperties
  * @property {Object} attributes
+ * @property {Object} tags
  */
 
 /**
- * @typedef {import("@vcmap/core").VcsObjectOptions} FeatureInfoViewOptions
+ * @typedef {Object} HTMLTagOptions
+ * @property {string} tag - the html element type
+ * ... further html options, which can contain template string $value for reusing the attribute's value
+ */
+
+/**
+ * @typedef {import("@vcmap/core").VcsObjectOptions & {
+ *   attributeKeys?: string[],
+ *   keyMapping?: Record<string,string>,
+ *   valueMapping?: Record<string, string|Record<string,string>>,
+ *   tags?: Record<string, HTMLTagOptions>,
+ *   window?: import("../manager/window/windowManager.js").WindowComponentOptions
+ * }} FeatureInfoViewOptions
  * @property {Array<string>} [attributeKeys] - list of keys to filter attributes of selected feature
  * @property {Object<string,string>} [keyMapping] - object providing text replacements or i18n strings for attribute keys
  * @property {Object<string, string|Object<string,string>>} [valueMapping] - object providing text replacements or i18n strings for attribute values
- * @property {WindowComponentOptions} [window] - state, slot, position can be set. Other options are predefined.
+ * @property {Object<string,HTMLTagOptions>} [tags] - object with keys rendered as special html element. Value contains html options
+ * @property {import("../manager/window/windowManager.js").WindowComponentOptions} [window] - state, slot, position can be set. Other options are predefined.
  */
 
 /**
@@ -31,7 +46,7 @@ function getMappedValue(mappedValue, value) {
 
 /**
  * Replaces values by new values according to mapping table. Nested keys are represented by a "."
- * @param {Object<string, *>} attributes
+ * @param {Record<string, unknown>} attributes
  * @param {Object<string, string|Object<string,string>>} mapping - value mapping
  */
 export function applyValueMapping(attributes, mapping) {
@@ -93,7 +108,7 @@ export function applyValueMapping(attributes, mapping) {
  * // apply flat mapping of a key with a period. this will overwrite an existing _other_ key
  * const periodAttrs = applyKeyMapping(getAttrs(), periodMapping);
  * assert(periodAttrs.foo === true);
- * @param {Object<string, *>} attributes
+ * @param {Object<string, unknown>} attributes
  * @param {Object<string,string>} mapping - key mapping
  */
 export function applyKeyMapping(attributes, mapping) {
@@ -130,6 +145,22 @@ export function applyKeyMapping(attributes, mapping) {
     });
 }
 
+/**
+ * Applies value mapping on tag options
+ * @param {Object<string, unknown>} attributes
+ * @param {Object<string,HTMLTagOptions>} tags
+ */
+function applyTagMapping(attributes, tags) {
+  Object.keys(tags).forEach((key) => {
+    Object.keys(tags[key]).forEach((option) => {
+      const mappedValue = tags[key][option];
+      if (typeof mappedValue === 'string') {
+        tags[key][option] = getMappedValue(tags[key][option], attributes[key]);
+      }
+    });
+  });
+}
+
 /**
  * Applies an attribute filtering. Nested attributes are represented by a ".".
  * @example
@@ -144,10 +175,10 @@ export function applyKeyMapping(attributes, mapping) {
  * assert(filtered.baz === true);
  * // if filtering parent top level keys, will pass on a reference of the actual value and its children.
  * assert(deepEquals(filtered.foobar, attrs.foobar));
- * @param {Object<string, *>} attributes
+ * @param {Object<string, unknown>} attributes
  * @param {Array<string>} keys
- * @param {Object<string, *>=} result
- * @returns {Object<string, *>}
+ * @param {Object<string, unknown>=} result
+ * @returns {Object<string, unknown>}
  */
 export function applyAttributeFilter(attributes, keys, result = {}) {
   const nestedKeys = {};
@@ -174,7 +205,7 @@ export function applyAttributeFilter(attributes, keys, result = {}) {
 
 /**
  * Filters all olcs attributes, not provided as keys
- * @param {Object<string, *>} attributes
+ * @param {Object<string, unknown>} attributes
  * @param {Array<string>} keys
  * @returns {Object}
  */
@@ -208,6 +239,7 @@ class AbstractFeatureInfoView extends VcsObject {
       attributeKeys: [],
       keyMapping: undefined,
       valueMapping: undefined,
+      tags: undefined,
       window: {},
     };
   }
@@ -232,7 +264,11 @@ class AbstractFeatureInfoView extends VcsObject {
      */
     this.valueMapping = options.valueMapping || defaultOptions.valueMapping;
     /**
-     * @type {WindowComponentOptions|Object}
+     * @type {null|Object<string,HTMLTagOptions>}
+     */
+    this.tags = options.tags || defaultOptions.tags;
+    /**
+     * @type {import("../manager/window/windowManager.js").WindowComponentOptions|Object}
      * @private
      */
     this._window = options.window || defaultOptions.window;
@@ -245,8 +281,7 @@ class AbstractFeatureInfoView extends VcsObject {
 
   /**
    * window options, configured in a module, used only internally by AbstractFeatureInfoView or subclass
-   * @type {WindowComponentOptions|Object}
-   * @readonly
+   * @type {import("../manager/window/windowManager.js").WindowComponentOptions|Object}
    */
   get window() {
     return this._window;
@@ -255,7 +290,6 @@ class AbstractFeatureInfoView extends VcsObject {
   /**
    * component provided by a FeatureInfoView class, passed to featureInfo via `getWindowComponentOptions()`
    * @type {import("vue").Component|undefined}
-   * @readonly
    */
   get component() {
     return this._component;
@@ -266,7 +300,7 @@ class AbstractFeatureInfoView extends VcsObject {
    * Called by `getProperties()` to pass attributes as props object to the VueComponent of this view.
    * May be overwritten by classes extending AbstractFeatureInfoView.
    * It filters attributes of the feature by keys, performs value and key mapping, if provided.
-   * @param {undefined|import("ol").Feature<import("ol/geom/Geometry").default>|import("@vcmap-cesium/engine").Cesium3DTileFeature|import("@vcmap-cesium/engine").Cesium3DTilePointFeature} feature
+   * @param {undefined|import("ol").Feature|import("@vcmap-cesium/engine").Cesium3DTileFeature|import("@vcmap-cesium/engine").Cesium3DTilePointFeature} feature
    * @returns {Object}
    */
   getAttributes(feature) {
@@ -283,11 +317,40 @@ class AbstractFeatureInfoView extends VcsObject {
     return applyOlcsAttributeFilter(attributes, this.attributeKeys);
   }
 
+  /**
+   * This method returns an object with keys rendered as special html elements.
+   * Applies value mapping, when using $value html option.
+   * Ensures key mapping on defined anchor keys.
+   * @param {undefined|import("ol").Feature|import("@vcmap-cesium/engine").Cesium3DTileFeature|import("@vcmap-cesium/engine").Cesium3DTilePointFeature} feature
+   * @returns {Object|undefined}
+   */
+  getTags(feature) {
+    if (this.tags) {
+      const attributes = feature.getProperty('attributes') || {};
+      const tags = Object.keys(this.tags)
+        .filter(
+          (key) =>
+            Object.keys(attributes).includes(key) &&
+            Object.keys(defaultTagOptions).includes(this.tags[key].tag),
+        )
+        .reduce((obj, key) => {
+          obj[key] = { ...this.tags[key] };
+          return obj;
+        }, {});
+      applyTagMapping(attributes, tags);
+      if (this.keyMapping) {
+        applyKeyMapping(tags, this.keyMapping);
+      }
+      return tags;
+    }
+    return undefined;
+  }
+
   /**
    * This method returns all relevant properties passed to the VueComponent of this view.
    * May be overwritten by classes extending AbstractFeatureInfoView.
    * Called by `getWindowComponentOptions()`.
-   * @param {FeatureInfoEvent} featureInfo
+   * @param {import("./featureInfo.js").FeatureInfoEvent} featureInfo
    * @param {import("@vcmap/core").Layer} layer
    * @returns {FeatureInfoProps}
    */
@@ -297,16 +360,17 @@ class AbstractFeatureInfoView extends VcsObject {
       layerName: layer.name,
       layerProperties: layer.properties,
       attributes: this.getAttributes(feature),
+      tags: this.getTags(feature),
     };
   }
 
   /**
    * This method is being called by featureInfo, whenever a new window is created (added to the windowManager).
    * May be overwritten by classes extending AbstractFeatureInfoView.
-   * @param {VcsUiApp} app
-   * @param {FeatureInfoEvent} featureInfo
+   * @param {import("../vcsUiApp.js").default} app
+   * @param {import("./featureInfo.js").FeatureInfoEvent} featureInfo
    * @param {import("@vcmap/core").Layer} layer
-   * @returns {WindowComponentOptions}
+   * @returns {import("../manager/window/windowManager.js").WindowComponentOptions}
    */
   getWindowComponentOptions(app, featureInfo, layer) {
     return {
@@ -315,7 +379,7 @@ class AbstractFeatureInfoView extends VcsObject {
         headerIcon: '$vcsInfo',
         infoUrl: app.getHelpUrlCallback('/tools/infoTool.html'),
       },
-      slot: this.window.slot ?? WindowSlot.DYNAMIC_LEFT,
+      slot: this.window.slot ?? WindowSlot.DYNAMIC_RIGHT,
       component: this.component,
       position: this.window.position,
       props: this.getProperties(featureInfo, layer),

package/src/featureInfo/addressBalloonFeatureInfoView.d.ts

@@ -0,0 +1,67 @@
+export default AddressBalloonFeatureInfoView;
+export type AddressBalloonFeatureInfoViewOptions = import("./abstractFeatureInfoView.js").FeatureInfoViewOptions & {
+    addressName?: string | null;
+    street?: string | null;
+    number?: string | null;
+    city?: string | null;
+    zip?: string | null;
+    country?: string | null;
+};
+/**
+ * @typedef {import("./abstractFeatureInfoView.js").FeatureInfoViewOptions &{
+ *   addressName?: string|null,
+ *   street?: string|null,
+ *   number?: string|null,
+ *   city?: string|null,
+ *   zip?: string|null,
+ *   country?: string|null,
+ * }} AddressBalloonFeatureInfoViewOptions
+ * @property {string|null} [addressName='gml:name'] key to evaluate for name. Use null to suppress
+ * @property {string|null} [street='Address.Street'] key to evaluate for street. Use null to suppress
+ * @property {string|null} [number='Address.HouseNumber'] key to evaluate for house number. Use null to suppress
+ * @property {string|null} [city='Address.City'] key to evaluate for city. Use null to suppress
+ * @property {string|null} [zip='Address.ZipCode'] key to evaluate for zip code. Use null to suppress
+ * @property {string|null} [country='Address.Country'] key to evaluate for country. Use null to suppress
+ */
+/**
+ * @class
+ * @description An balloon view.
+ * @extends {BalloonFeatureInfoView}
+ */
+declare class AddressBalloonFeatureInfoView extends BalloonFeatureInfoView {
+    /** @returns {AddressBalloonFeatureInfoViewOptions} */
+    static getDefaultOptions(): AddressBalloonFeatureInfoViewOptions;
+    /**
+     * @param {AddressBalloonFeatureInfoViewOptions} options
+     */
+    constructor(options: AddressBalloonFeatureInfoViewOptions);
+    /**
+     * @type {string|null}
+     */
+    addressName: string | null;
+    /**
+     * @type {string|null}
+     */
+    street: string | null;
+    /**
+     * @type {string|null}
+     */
+    number: string | null;
+    /**
+     * @type {string|null}
+     */
+    city: string | null;
+    /**
+     * @type {string|null}
+     */
+    zip: string | null;
+    /**
+     * @type {string|null}
+     */
+    country: string | null;
+    /**
+     * @returns {AddressBalloonFeatureInfoViewOptions}
+     */
+    toJSON(): AddressBalloonFeatureInfoViewOptions;
+}
+import BalloonFeatureInfoView from './balloonFeatureInfoView.js';

package/src/featureInfo/addressBalloonFeatureInfoView.js

@@ -4,7 +4,14 @@ import BalloonFeatureInfoView, {
 import AddressBalloonComponent from './AddressBalloonComponent.vue';
 
 /**
- * @typedef {FeatureInfoViewOptions} AddressBalloonFeatureInfoViewOptions
+ * @typedef {import("./abstractFeatureInfoView.js").FeatureInfoViewOptions &{
+ *   addressName?: string|null,
+ *   street?: string|null,
+ *   number?: string|null,
+ *   city?: string|null,
+ *   zip?: string|null,
+ *   country?: string|null,
+ * }} AddressBalloonFeatureInfoViewOptions
  * @property {string|null} [addressName='gml:name'] key to evaluate for name. Use null to suppress
  * @property {string|null} [street='Address.Street'] key to evaluate for street. Use null to suppress
  * @property {string|null} [number='Address.HouseNumber'] key to evaluate for house number. Use null to suppress
@@ -79,7 +86,7 @@ class AddressBalloonFeatureInfoView extends BalloonFeatureInfoView {
 
   /**
    * derives address attributes from addressKeys
-   * @param {undefined|import("ol").Feature<import("ol/geom/Geometry").default>|import("@vcmap-cesium/engine").Cesium3DTileFeature|import("@vcmap-cesium/engine").Cesium3DTilePointFeature} feature
+   * @param {undefined|import("ol").Feature|import("@vcmap-cesium/engine").Cesium3DTileFeature|import("@vcmap-cesium/engine").Cesium3DTilePointFeature} feature
    * @returns {Object}
    */
   getAttributes(feature) {

package/src/featureInfo/balloonFeatureInfoView.d.ts

@@ -0,0 +1,49 @@
+/**
+ * derive value from attributes
+ * @param {string} key - key or nested key
+ * @param {Object} attrs
+ * @param {string|null} [defaultValue]
+ * @returns {string|null}
+ */
+export function extractNestedKey(key: string, attrs: Object, defaultValue?: string | null | undefined): string | null;
+export default BalloonFeatureInfoView;
+export type BalloonFeatureInfoViewOptions = import("./abstractFeatureInfoView.js").FeatureInfoViewOptions & {
+    balloonTitle?: string;
+    balloonSubtitle?: string;
+};
+export type BalloonFeatureInfoViewProps = import("./abstractFeatureInfoView.js").FeatureInfoProps & {
+    balloonTitle: string;
+    balloonSubtitle: string;
+    position: import("ol/coordinate.js").Coordinate;
+};
+/**
+ * @class
+ * @description An balloon view.
+ * @extends {AbstractFeatureInfoView}
+ */
+declare class BalloonFeatureInfoView extends AbstractFeatureInfoView {
+    /**
+     * @param {BalloonFeatureInfoViewOptions} options
+     * @param {import("vue").Component} [component=BalloonComponent]
+     */
+    constructor(options: BalloonFeatureInfoViewOptions, component?: import("vue").Component<import("vue/types/options.js").DefaultData<never>, import("vue/types/options.js").DefaultMethods<never>, import("vue/types/options.js").DefaultComputed, import("vue/types/options.js").DefaultProps, {}> | undefined);
+    /**
+     * @type {string}
+     */
+    balloonTitle: string;
+    /**
+     * @type {string}
+     */
+    balloonSubtitle: string;
+    /**
+     * @param {import("./featureInfo.js").FeatureInfoEvent} featureInfo
+     * @param {import("@vcmap/core").Layer} layer
+     * @returns {BalloonFeatureInfoViewProps}
+     */
+    getProperties(featureInfo: import("./featureInfo.js").FeatureInfoEvent, layer: import("@vcmap/core").Layer): BalloonFeatureInfoViewProps;
+    /**
+     * @returns {BalloonFeatureInfoViewOptions}
+     */
+    toJSON(): BalloonFeatureInfoViewOptions;
+}
+import AbstractFeatureInfoView from './abstractFeatureInfoView.js';

package/src/featureInfo/balloonFeatureInfoView.js

@@ -24,21 +24,22 @@ export function extractNestedKey(key, attrs, defaultValue = null) {
 }
 
 /**
- * @typedef {FeatureInfoViewOptions} BalloonFeatureInfoViewOptions
+ * @typedef {import("./abstractFeatureInfoView.js").FeatureInfoViewOptions & { balloonTitle?: string, balloonSubtitle?: string }} BalloonFeatureInfoViewOptions
  * @property {string} [balloonTitle] - optional title to overwrite default (layerName). Can be attribute key (nested key using '.'), i18n key or text
  * @property {string} [balloonSubtitle] - optional window title to overwrite default (featureId). Can be attribute key (nested key using '.'), i18n key or text
  */
 
 /**
- * @typedef {FeatureInfoProps} BalloonFeatureInfoViewProps
- * @property {string} balloonTitle
- * @property {string} balloonSubtitle
- * @property {import("ol/coordinate").Coordinate} position
+ * @typedef {import("./abstractFeatureInfoView.js").FeatureInfoProps & {
+ *   balloonTitle: string,
+ *   balloonSubtitle: string,
+ *   position: import("ol/coordinate.js").Coordinate
+ * }} BalloonFeatureInfoViewProps
  */
 
 /**
  * @param {import("@vcmap/core").Cartesian3} cartesian
- * @returns {import("ol/coordinate").Coordinate}
+ * @returns {import("ol/coordinate.js").Coordinate}
  */
 function cartesian3ToCoordinate(cartesian) {
   const cartographic = Cartographic.fromCartesian(cartesian);
@@ -52,7 +53,7 @@ function cartesian3ToCoordinate(cartesian) {
 
 /**
  * @param {FeatureType} feature
- * @returns {import("ol/coordinate").Coordinate|null}
+ * @returns {import("ol/coordinate.js").Coordinate|null}
  */
 function getPositionFromFeature(feature) {
   if (feature instanceof Feature && feature.getGeometry()) {
@@ -97,7 +98,7 @@ class BalloonFeatureInfoView extends AbstractFeatureInfoView {
   }
 
   /**
-   * @param {FeatureInfoEvent} featureInfo
+   * @param {import("./featureInfo.js").FeatureInfoEvent} featureInfo
    * @param {import("@vcmap/core").Layer} layer
    * @returns {BalloonFeatureInfoViewProps}
    */
@@ -127,10 +128,10 @@ class BalloonFeatureInfoView extends AbstractFeatureInfoView {
   }
 
   /**
-   * @param {VcsUiApp} app
-   * @param {FeatureInfoEvent} featureInfo
+   * @param {import("@src/vcsUiApp.js").default} app
+   * @param {import("./featureInfo.js").FeatureInfoEvent} featureInfo
    * @param {import("@vcmap/core").Layer} layer
-   * @returns {WindowComponentOptions}
+   * @returns {import("../manager/window/windowManager.js").WindowComponentOptions}
    */
   getWindowComponentOptions(app, featureInfo, layer) {
     const options = super.getWindowComponentOptions(app, featureInfo, layer);

package/src/featureInfo/balloonHelper.d.ts

@@ -0,0 +1,31 @@
+/**
+ * returns the windowPosition of a balloon from a map position
+ * @param {import("@vcmap/core").VcsApp} app
+ * @param {import("ol/coordinate.js").Coordinate} position - position in mercator
+ * @returns {Promise<undefined|Cartesian2>}
+ */
+export function getBalloonPosition(app: import("@vcmap/core").VcsApp, position: import("ol/coordinate.js").Coordinate): Promise<undefined | Cartesian2>;
+/**
+ * sets the windowPosition of a balloon
+ * @param {import("../manager/window/windowManager.js").default} windowManager
+ * @param {string} id - windowId of balloon
+ * @param {import("@vcmap-cesium/engine").Cartesian2|undefined} windowPosition
+ * @param {HTMLElement} target - the map's target { @link @import("@vcmap/core").MapCollection }
+ */
+export function setBalloonPosition(windowManager: import("../manager/window/windowManager.js").default, id: string, windowPosition: import("@vcmap-cesium/engine").Cartesian2 | undefined, target: HTMLElement): void;
+/**
+ * @param {import("@vcmap/core").VcsApp} vcsApp
+ * @param {string} windowId
+ * @param {import("ol/coordinate.js").Coordinate} clickedPosition - position in mercator
+ * @returns {Promise<(() => void)>}
+ */
+export function setupBalloonPositionListener(vcsApp: import("@vcmap/core").VcsApp, windowId: string, clickedPosition: import("ol/coordinate.js").Coordinate): Promise<(() => void)>;
+/**
+ * balloon offset from location or click position in pixel
+ * @type {{x: number, y: number}}
+ */
+export const balloonOffset: {
+    x: number;
+    y: number;
+};
+import { Cartesian2 } from '@vcmap-cesium/engine';

package/src/featureInfo/balloonHelper.js

@@ -33,7 +33,7 @@ function getBalloonPositionCesium(scene, cartesian) {
 
 /**
  * @param {import("@vcmap/core").OpenlayersMap} olMap
- * @param {import("ol/coordinate").Coordinate} position
+ * @param {import("ol/coordinate.js").Coordinate} position
  * @returns {undefined|import("@vcmap-cesium/engine").Cartesian2}
  */
 function getBalloonPositionOL(olMap, position) {
@@ -46,8 +46,8 @@ function getBalloonPositionOL(olMap, position) {
 
 /**
  * returns the windowPosition of a balloon from a map position
- * @param {VcsApp} app
- * @param {import("ol/coordinate").Coordinate} position - position in mercator
+ * @param {import("@vcmap/core").VcsApp} app
+ * @param {import("ol/coordinate.js").Coordinate} position - position in mercator
  * @returns {Promise<undefined|Cartesian2>}
  */
 export async function getBalloonPosition(app, position) {
@@ -69,7 +69,7 @@ export async function getBalloonPosition(app, position) {
 
 /**
  * sets the windowPosition of a balloon
- * @param {WindowManager} windowManager
+ * @param {import("../manager/window/windowManager.js").default} windowManager
  * @param {string} id - windowId of balloon
  * @param {import("@vcmap-cesium/engine").Cartesian2|undefined} windowPosition
  * @param {HTMLElement} target - the map's target { @link @import("@vcmap/core").MapCollection }
@@ -92,9 +92,9 @@ export function setBalloonPosition(windowManager, id, windowPosition, target) {
 }
 
 /**
- * @param {VcsApp} vcsApp
+ * @param {import("@vcmap/core").VcsApp} vcsApp
  * @param {string} windowId
- * @param {import("ol/coordinate").Coordinate} clickedPosition - position in mercator
+ * @param {import("ol/coordinate.js").Coordinate} clickedPosition - position in mercator
  * @returns {Promise<(() => void)>}
  */
 export async function setupBalloonPositionListener(

package/src/featureInfo/featureInfo.d.ts

@@ -0,0 +1,146 @@
+/**
+ * @param {FeatureType} feature
+ * @param {import("@vcmap/core").Layer} layer
+ * @param {string} defaultFillColor
+ * @returns {import("ol/style/Style.js").default|import("@vcmap/core").VectorStyleItem}
+ */
+export function getHighlightStyle(feature: FeatureType, layer: import("@vcmap/core").Layer, defaultFillColor: string): import("ol/style/Style.js").default | import("@vcmap/core").VectorStyleItem;
+/**
+ * @param {import("../vcsUiApp.js").default} app
+ * @returns {FeatureInfoSession}
+ */
+export function createFeatureInfoSession(app: import("../vcsUiApp.js").default): FeatureInfoSession;
+/**
+ * @typedef {Object} FeatureInfoSession
+ * @property {VcsEvent<void>} stopped
+ * @property {function():void} stop
+ */
+/**
+ * @type {ClassRegistry<import("@vcmap/core").Ctor<typeof AbstractFeatureInfoView>>}
+ */
+export const featureInfoClassRegistry: ClassRegistry<import("@vcmap/core").Ctor<typeof AbstractFeatureInfoView>>;
+/**
+ * Symbol added to features to overwrite the layers predefined feature info
+ * @type {symbol}
+ */
+export const featureInfoViewSymbol: symbol;
+export default FeatureInfo;
+export type FeatureType = import("ol").Feature | import("@vcmap-cesium/engine").Cesium3DTileFeature | import("@vcmap-cesium/engine").Cesium3DTilePointFeature | import("@vcmap-cesium/engine").Entity;
+export type FeatureInfoEvent = {
+    feature: FeatureType;
+    /**
+     * - potential position to place the balloon at
+     */
+    position?: import("ol/coordinate.js").Coordinate | undefined;
+    /**
+     * - potential window position to initially place the balloon at
+     */
+    windowPosition?: import("ol/coordinate.js").Coordinate | undefined;
+};
+export type FeatureInfoSession = {
+    stopped: VcsEvent<void>;
+    stop: () => void;
+};
+import { ClassRegistry } from '@vcmap/core';
+import AbstractFeatureInfoView from './abstractFeatureInfoView.js';
+/**
+ * @class FeatureInfo
+ * @description Provides registration of featureInfoClasses and stores featureInfoView instances.
+ * @extends {Collection<AbstractFeatureInfoView>}
+ */
+declare class FeatureInfo extends Collection<AbstractFeatureInfoView> {
+    /**
+     * @param {import("@src/vcsUiApp.js").default} app
+     */
+    constructor(app: import("@src/vcsUiApp.js").default);
+    /**
+     * @type {import("@src/vcsUiApp.js").default}
+     * @private
+     */
+    private _app;
+    /**
+     * @type {function():void|null}
+     * @private
+     */
+    private _clearHighlightingCb;
+    /**
+     * @type {string|null}
+     * @private
+     */
+    private _windowId;
+    /**
+     * @type {VcsEvent<FeatureType>}
+     * @private
+     */
+    private _featureChanged;
+    /**
+     * @type {FeatureType|null}
+     * @private
+     */
+    private _selectedFeature;
+    /**
+     * @type {string|null}
+     * @private
+     */
+    private _selectedFeatureId;
+    /**
+     * @type {Array<function():void>}
+     * @private
+     */
+    private _listeners;
+    _destroyFeatureInfoTool: () => void;
+    /**
+     * A vector layer to render provided features on
+     * @type {VectorLayer|null}
+     * @private
+     */
+    private _scratchLayer;
+    /**
+     * @type {VcsEvent<null|FeatureType>}
+     */
+    get featureChanged(): VcsEvent<FeatureType | null>;
+    /**
+     * @type {null|FeatureType}
+     */
+    get selectedFeature(): FeatureType | null;
+    /**
+     * @type {null|string}
+     */
+    get selectedFeatureId(): string | null;
+    /**
+     * The window id of the current features FeatureInfoView window
+     * @type {string|null}
+     */
+    get windowId(): string | null;
+    /**
+     * @private
+     */
+    private _ensureScratchLayer;
+    /**
+     * @param {FeatureType} feature
+     * @returns {null|AbstractFeatureInfoView}
+     * @private
+     */
+    private _getFeatureInfoViewForFeature;
+    /**
+     * Selecting a feature highlights said feature and opens a FeatureInfoView, if configured on the layer. For a successful selection,
+     * the feature must meet the following criteria: a) the feature must be part of a layer, b) said layer must be managed in
+     * the same VcsApp as provided to the FeatureInfo on construction. if not providing a feature info view, then c) said layer must have a featureInfo property set on
+     * its properties bag and d) said featureInfo property must provide the name of a FeatureInfoView present on this FeatureInfos
+     * collection.
+     * If passing a feature create by a FeatureProvider, the feature will be highlighted on an internal scratch layer.
+     * @param {FeatureType} feature
+     * @param {import("ol/coordinate.js").Coordinate=} [position] - optional clicked position. If not given feature's center point is used to place balloons
+     * @param {import("ol/coordinate.js").Coordinate=} [windowPosition] - optional clicked window position. If not given derived from position for balloons
+     * @param {AbstractFeatureInfoView=} featureInfoView
+     * @returns {Promise<void>}
+     */
+    selectFeature(feature: FeatureType, position?: import("ol/coordinate.js").Coordinate | undefined, windowPosition?: import("ol/coordinate.js").Coordinate | undefined, featureInfoView?: AbstractFeatureInfoView | undefined): Promise<void>;
+    /**
+     * Clears the current feature. remove window, highlighting and provided feature.
+     * @private
+     */
+    private _clearInternal;
+}
+import { VcsEvent } from '@vcmap/core';
+import { Collection } from '@vcmap/core';