vis-data 7.1.1 → 7.1.4

package/esnext/esm/vis-data.js

@@ -4,8 +4,8 @@
  *
  * Manage unstructured data using DataSet. Add, update, and remove data, and listen for changes in the data.
  *
- * @version 7.1.1
- * @date    2020-11-15T19:08:22.864Z
+ * @version 7.1.4
+ * @date    2022-03-15T15:23:59.245Z
  *
  * @copyright (c) 2011-2017 Almende B.V, http://almende.com
  * @copyright (c) 2017-2019 visjs contributors, https://github.com/visjs
@@ -32,7 +32,6 @@ import { v4 } from 'uuid';
  * Create new data pipe.
  *
  * @param from - The source data set or data view.
- *
  * @remarks
  * Example usage:
  * ```typescript
@@ -59,7 +58,6 @@ import { v4 } from 'uuid';
  *
  * pipe.start();
  * ```
- *
  * @returns A factory whose methods can be used to configure the pipe.
  */
 function createNewDataPipeFrom(from) {
@@ -75,6 +73,17 @@ function createNewDataPipeFrom(from) {
  * @typeParam TP - Target item type's id property name.
  */
 class SimpleDataPipe {
+    _source;
+    _transformers;
+    _target;
+    /**
+     * Bound listeners for use with `DataInterface['on' | 'off']`.
+     */
+    _listeners = {
+        add: this._add.bind(this),
+        remove: this._remove.bind(this),
+        update: this._update.bind(this),
+    };
     /**
      * Create a new data pipe.
      *
@@ -87,14 +96,6 @@ class SimpleDataPipe {
         this._source = _source;
         this._transformers = _transformers;
         this._target = _target;
-        /**
-         * Bound listeners for use with `DataInterface['on' | 'off']`.
-         */
-        this._listeners = {
-            add: this._add.bind(this),
-            remove: this._remove.bind(this),
-            update: this._update.bind(this),
-        };
     }
     /** @inheritDoc */
     all() {
@@ -119,7 +120,6 @@ class SimpleDataPipe {
      * Apply the transformers to the items.
      *
      * @param items - The items to be transformed.
-     *
      * @returns The transformed items.
      */
     _transformItems(items) {
@@ -172,6 +172,12 @@ class SimpleDataPipe {
  * @typeParam TP - Target item type's id property name.
  */
 class DataPipeUnderConstruction {
+    _source;
+    /**
+     * Array transformers used to transform items within the pipe. This is typed
+     * as any for the sake of simplicity.
+     */
+    _transformers = [];
     /**
      * Create a new data pipe factory. This is an internal constructor that
      * should never be called from outside of this file.
@@ -180,18 +186,12 @@ class DataPipeUnderConstruction {
      */
     constructor(_source) {
         this._source = _source;
-        /**
-         * Array transformers used to transform items within the pipe. This is typed
-         * as any for the sake of simplicity.
-         */
-        this._transformers = [];
     }
     /**
      * Filter the items.
      *
      * @param callback - A filtering function that returns true if given item
      * should be piped and false if not.
-     *
      * @returns This factory for further configuration.
      */
     filter(callback) {
@@ -203,10 +203,8 @@ class DataPipeUnderConstruction {
      *
      * @param callback - A mapping function that takes a source item and returns
      * corresponding mapped item.
-     *
      * @typeParam TI - Target item type.
      * @typeParam TP - Target item type's id property name.
-     *
      * @returns This factory for further configuration.
      */
     map(callback) {
@@ -218,10 +216,8 @@ class DataPipeUnderConstruction {
      *
      * @param callback - A mapping function that takes a source item and returns
      * an array of corresponding mapped items.
-     *
      * @typeParam TI - Target item type.
      * @typeParam TP - Target item type's id property name.
-     *
      * @returns This factory for further configuration.
      */
     flatMap(callback) {
@@ -232,7 +228,6 @@ class DataPipeUnderConstruction {
      * Connect this pipe to given data set.
      *
      * @param target - The data set that will receive the items from this pipe.
-     *
      * @returns The pipe connected between given data sets and performing
      * configured transformation on the processed items.
      */
@@ -245,7 +240,6 @@ class DataPipeUnderConstruction {
  * Determine whether a value can be used as an id.
  *
  * @param value - Input value of unknown type.
- *
  * @returns True if the value is valid id, false otherwise.
  */
 function isId(value) {
@@ -258,15 +252,19 @@ function isId(value) {
  * @typeParam T - The type of method names to be replaced by queued versions.
  */
 class Queue {
+    /** Delay in milliseconds. If defined the queue will be periodically flushed. */
+    delay;
+    /** Maximum number of entries in the queue before it will be flushed. */
+    max;
+    _queue = [];
+    _timeout = null;
+    _extended = null;
     /**
      * Construct a new Queue.
      *
      * @param options - Queue configuration.
      */
     constructor(options) {
-        this._queue = [];
-        this._timeout = null;
-        this._extended = null;
         // options
         this.delay = null;
         this.max = Infinity;
@@ -292,7 +290,6 @@ class Queue {
      *
      * @param object - The object to be extended.
      * @param options - Additional options.
-     *
      * @returns The created queue.
      */
     static extend(object, options) {
@@ -421,22 +418,12 @@ class Queue {
  * @typeParam IdProp - Name of the property that contains the id.
  */
 class DataSetPart {
-    constructor() {
-        this._subscribers = {
-            "*": [],
-            add: [],
-            remove: [],
-            update: [],
-        };
-        /**
-         * @deprecated Use on instead (PS: DataView.subscribe === DataView.on).
-         */
-        this.subscribe = DataSetPart.prototype.on;
-        /**
-         * @deprecated Use off instead (PS: DataView.unsubscribe === DataView.off).
-         */
-        this.unsubscribe = DataSetPart.prototype.off;
-    }
+    _subscribers = {
+        "*": [],
+        add: [],
+        remove: [],
+        update: [],
+    };
     /**
      * Trigger an event
      *
@@ -456,7 +443,6 @@ class DataSetPart {
      * Subscribe to an event, add an event listener.
      *
      * @remarks Non-function callbacks are ignored.
-     *
      * @param event - Event name.
      * @param callback - Callback method.
      */
@@ -470,13 +456,20 @@ class DataSetPart {
      * Unsubscribe from an event, remove an event listener.
      *
      * @remarks If the same callback was subscribed more than once **all** occurences will be removed.
-     *
      * @param event - Event name.
      * @param callback - Callback method.
      */
     off(event, callback) {
         this._subscribers[event] = this._subscribers[event].filter((subscriber) => subscriber !== callback);
     }
+    /**
+     * @deprecated Use on instead (PS: DataView.subscribe === DataView.on).
+     */
+    subscribe = DataSetPart.prototype.on;
+    /**
+     * @deprecated Use off instead (PS: DataView.unsubscribe === DataView.off).
+     */
+    unsubscribe = DataSetPart.prototype.off;
 }
 
 /**
@@ -486,10 +479,10 @@ class DataSetPart {
  * [[DataStream]] offers an always up to date stream of items from a [[DataSet]] or [[DataView]].
  * That means that the stream is evaluated at the time of iteration, conversion to another data type or when [[cache]] is called, not when the [[DataStream]] was created.
  * Multiple invocations of for example [[toItemArray]] may yield different results (if the data source like for example [[DataSet]] gets modified).
- *
  * @typeParam Item - The item type this stream is going to work with.
  */
 class DataStream {
+    _pairs;
     /**
      * Create a new data stream.
      *
@@ -535,7 +528,6 @@ class DataStream {
      *
      * @remarks
      * The array may contain duplicities.
-     *
      * @returns The array with all ids from this stream.
      */
     toIdArray() {
@@ -546,7 +538,6 @@ class DataStream {
      *
      * @remarks
      * The array may contain duplicities.
-     *
      * @returns The array with all items from this stream.
      */
     toItemArray() {
@@ -557,7 +548,6 @@ class DataStream {
      *
      * @remarks
      * The array may contain duplicities.
-     *
      * @returns The array with all entries from this stream.
      */
     toEntryArray() {
@@ -568,7 +558,6 @@ class DataStream {
      *
      * @remarks
      * In case of duplicate ids (coerced to string so `7 == '7'`) the last encoutered appears in the returned object.
-     *
      * @returns The object map of all id → item pairs from this stream.
      */
     toObjectMap() {
@@ -622,7 +611,6 @@ class DataStream {
      * ds.clear()
      * chachedStream // Still has all the items.
      * ```
-     *
      * @returns A new [[DataStream]] with cached items (detached from the original [[DataSet]]).
      */
     cache() {
@@ -632,9 +620,7 @@ class DataStream {
      * Get the distinct values of given property.
      *
      * @param callback - The function that picks and possibly converts the property.
-     *
      * @typeParam T - The type of the distinct value.
-     *
      * @returns A set of all distinct properties.
      */
     distinct(callback) {
@@ -648,7 +634,6 @@ class DataStream {
      * Filter the items of the stream.
      *
      * @param callback - The function that decides whether an item will be included.
-     *
      * @returns A new data stream with the filtered items.
      */
     filter(callback) {
@@ -677,9 +662,7 @@ class DataStream {
      * Map the items into a different type.
      *
      * @param callback - The function that does the conversion.
-     *
      * @typeParam Mapped - The type of the item after mapping.
-     *
      * @returns A new data stream with the mapped items.
      */
     map(callback) {
@@ -696,7 +679,6 @@ class DataStream {
      * Get the item with the maximum value of given property.
      *
      * @param callback - The function that picks and possibly converts the property.
-     *
      * @returns The item with the maximum if found otherwise null.
      */
     max(callback) {
@@ -721,7 +703,6 @@ class DataStream {
      * Get the item with the minimum value of given property.
      *
      * @param callback - The function that picks and possibly converts the property.
-     *
      * @returns The item with the minimum if found otherwise null.
      */
     min(callback) {
@@ -747,9 +728,7 @@ class DataStream {
      *
      * @param callback - The function that does the reduction.
      * @param accumulator - The initial value of the accumulator.
-     *
      * @typeParam T - The type of the accumulated value.
-     *
      * @returns The reduced value.
      */
     reduce(callback, accumulator) {
@@ -762,7 +741,6 @@ class DataStream {
      * Sort the items.
      *
      * @param callback - Item comparator.
-     *
      * @returns A new stream with sorted items.
      */
     sort(callback) {
@@ -778,13 +756,10 @@ class DataStream {
  *
  * @remarks
  * The item will be modified.
- *
  * @param item - The item that will have an id after a call to this function.
  * @param idProp - The key of the id property.
- *
  * @typeParam Item - Item type that may or may not have an id.
  * @typeParam IdProp - Name of the property that contains the id.
- *
  * @returns true
  */
 function ensureFullItem(item, idProp) {
@@ -854,6 +829,18 @@ function ensureFullItem(item, idProp) {
  * @typeParam IdProp - Name of the property that contains the id.
  */
 class DataSet extends DataSetPart {
+    /** Flush all queued calls. */
+    flush;
+    /** @inheritDoc */
+    length;
+    /** @inheritDoc */
+    get idProp() {
+        return this._idProp;
+    }
+    _options;
+    _data;
+    _idProp;
+    _queue = null;
     /**
      * Construct a new DataSet.
      *
@@ -862,7 +849,6 @@ class DataSet extends DataSetPart {
      */
     constructor(data, options) {
         super();
-        this._queue = null;
         // correctly read optional arguments
         if (data && !Array.isArray(data)) {
             options = data;
@@ -878,10 +864,6 @@ class DataSet extends DataSetPart {
         }
         this.setOptions(options);
     }
-    /** @inheritDoc */
-    get idProp() {
-        return this._idProp;
-    }
     /**
      * Set new options.
      *
@@ -932,9 +914,7 @@ class DataSet extends DataSetPart {
      *
      * @param data - Items to be added (ids will be generated if missing).
      * @param senderId - Sender id.
-     *
      * @returns addedIds - Array with the ids (generated if not present) of the added items.
-     *
      * @throws When an item with the same id as any of the added items already exists.
      */
     add(data, senderId) {
@@ -993,12 +973,9 @@ class DataSet extends DataSetPart {
      *
      * ## Warning for TypeScript users
      * This method may introduce partial items into the data set. Use add or updateOnly instead for better type safety.
-     *
      * @param data - Items to be updated (if the id is already present) or added (if the id is missing).
      * @param senderId - Sender id.
-     *
      * @returns updatedIds - The ids of the added (these may be newly generated if there was no id in the item from the data) or updated items.
-     *
      * @throws When the supplied data is neither an item nor an array of items.
      */
     update(data, senderId) {
@@ -1087,12 +1064,9 @@ class DataSet extends DataSetPart {
      *
      * console.log(ids) // [2]
      * ```
-     *
      * @param data - Updates (the id and optionally other props) to the items in this data set.
      * @param senderId - Sender id.
-     *
      * @returns updatedIds - The ids of the updated items.
-     *
      * @throws When the supplied data is neither an item nor an array of items, when the ids are missing.
      */
     updateOnly(data, senderId) {
@@ -1107,7 +1081,7 @@ class DataSet extends DataSetPart {
             }
             return { oldData, update };
         })
-            .map(({ oldData, update }) => {
+            .map(({ oldData, update, }) => {
             const id = oldData[this._idProp];
             const updatedData = pureDeepObjectAssign(oldData, update);
             this._data.set(id, updatedData);
@@ -1360,9 +1334,7 @@ class DataSet extends DataSetPart {
      *
      * @param item - The item whose fields should be filtered.
      * @param fields - The names of the fields that will be kept.
-     *
      * @typeParam K - Field name type.
-     *
      * @returns The item without any additional fields.
      */
     _filterFields(item, fields) {
@@ -1384,7 +1356,6 @@ class DataSet extends DataSetPart {
      *
      * @param items - Items to be sorted in place.
      * @param order - A field name or custom sort function.
-     *
      * @typeParam T - The type of the items in the items array.
      */
     _sort(items, order) {
@@ -1432,7 +1403,6 @@ class DataSet extends DataSetPart {
      *
      * @param id - One or more items or ids of items to be removed.
      * @param senderId - Sender id.
-     *
      * @returns The ids of the removed items.
      */
     remove(id, senderId) {
@@ -1459,7 +1429,6 @@ class DataSet extends DataSetPart {
      * Remove an item by its id or reference.
      *
      * @param id - Id of an item or the item itself.
-     *
      * @returns The removed item if removed, null otherwise.
      */
     _remove(id) {
@@ -1488,7 +1457,6 @@ class DataSet extends DataSetPart {
      * After the items are removed, the [[DataSet]] will trigger an event `remove` for all removed items. When a `senderId` is provided, this id will be passed with the triggered event to all subscribers.
      *
      * @param senderId - Sender id.
-     *
      * @returns removedIds - The ids of all removed items.
      */
     clear(senderId) {
@@ -1506,7 +1474,6 @@ class DataSet extends DataSetPart {
      * Find the item with maximum value of a specified field.
      *
      * @param field - Name of the property that should be searched for max value.
-     *
      * @returns Item containing max value, or null if no items.
      */
     max(field) {
@@ -1526,7 +1493,6 @@ class DataSet extends DataSetPart {
      * Find the item with minimum value of a specified field.
      *
      * @param field - Name of the property that should be searched for min value.
-     *
      * @returns Item containing min value, or null if no items.
      */
     min(field) {
@@ -1546,7 +1512,6 @@ class DataSet extends DataSetPart {
      * Find all distinct values of a specified field
      *
      * @param prop - The property name whose distinct values should be returned.
-     *
      * @returns Unordered array containing all distinct values. Items without specified property are ignored.
      */
     distinct(prop) {
@@ -1576,7 +1541,6 @@ class DataSet extends DataSetPart {
      * Add a single item. Will fail when an item with the same id already exists.
      *
      * @param item - A new item to be added.
-     *
      * @returns Added item's id. An id is generated when it is not present in the item.
      */
     _addItem(item) {
@@ -1596,7 +1560,6 @@ class DataSet extends DataSetPart {
      * Will fail when the item has no id, or when there does not exist an item with the same id.
      *
      * @param update - The new item
-     *
      * @returns The id of the updated item.
      */
     _updateItem(update) {
@@ -1683,6 +1646,16 @@ class DataSet extends DataSetPart {
  * @typeParam IdProp - Name of the property that contains the id.
  */
 class DataView extends DataSetPart {
+    /** @inheritDoc */
+    length = 0;
+    /** @inheritDoc */
+    get idProp() {
+        return this.getDataSet().idProp;
+    }
+    _listener;
+    _data; // constructor → setData
+    _ids = new Set(); // ids of the items currently in memory (just contains a boolean true)
+    _options;
     /**
      * Create a DataView.
      *
@@ -1691,24 +1664,16 @@ class DataView extends DataSetPart {
      */
     constructor(data, options) {
         super();
-        /** @inheritDoc */
-        this.length = 0;
-        this._ids = new Set(); // ids of the items currently in memory (just contains a boolean true)
         this._options = options || {};
         this._listener = this._onEvent.bind(this);
         this.setData(data);
     }
-    /** @inheritDoc */
-    get idProp() {
-        return this.getDataSet().idProp;
-    }
     // TODO: implement a function .config() to dynamically update things like configured filter
     // and trigger changes accordingly
     /**
      * Set a data source for the view.
      *
      * @param data - The instance containing data (directly or indirectly).
-     *
      * @remarks
      * Note that when the data view is bound to a data set it won't be garbage
      * collected unless the data set is too. Use `dataView.setData(null)` or
@@ -2030,7 +1995,6 @@ class DataView extends DataSetPart {
  *
  * @param idProp - The expected property to contain item id.
  * @param v - The value to be tested.
- *
  * @returns True if all expected values and methods match, false otherwise.
  */
 function isDataSetLike(idProp, v) {
@@ -2062,7 +2026,6 @@ function isDataSetLike(idProp, v) {
  *
  * @param idProp - The expected property to contain item id.
  * @param v - The value to be tested.
- *
  * @returns True if all expected values and methods match, false otherwise.
  */
 function isDataViewLike(idProp, v) {