vis-data 7.1.3 → 7.1.5

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.3
- * @date    2022-03-02T13:02:54.265Z
+ * @version 7.1.5
+ * @date    2023-03-21T20:54:51.525Z
  *
  * @copyright (c) 2011-2017 Almende B.V, http://almende.com
  * @copyright (c) 2017-2019 visjs contributors, https://github.com/visjs
@@ -73,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.
      *
@@ -85,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() {
@@ -169,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.
@@ -177,11 +186,6 @@ 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.
@@ -248,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;
@@ -404,28 +412,18 @@ class Queue {
 }
 
 /**
- * [[DataSet]] code that can be reused in [[DataView]] or other similar implementations of [[DataInterface]].
+ * {@link DataSet} code that can be reused in {@link DataView} or other similar implementations of {@link DataInterface}.
  *
  * @typeParam Item - Item type that may or may not have an id.
  * @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
      *
@@ -464,18 +462,27 @@ class DataSetPart {
     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;
 }
 
 /**
  * Data stream
  *
  * @remarks
- * [[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).
+ * {@link DataStream} offers an always up to date stream of items from a {@link DataSet} or {@link DataView}.
+ * That means that the stream is evaluated at the time of iteration, conversion to another data type or when {@link cache} is called, not when the {@link DataStream} was created.
+ * Multiple invocations of for example {@link toItemArray} may yield different results (if the data source like for example {@link DataSet} gets modified).
  * @typeParam Item - The item type this stream is going to work with.
  */
 class DataStream {
+    _pairs;
     /**
      * Create a new data stream.
      *
@@ -589,7 +596,7 @@ class DataStream {
      *
      * @remarks
      * This method allows for items to be fetched immediatelly and used (possibly multiple times) later.
-     * It can also be used to optimize performance as [[DataStream]] would otherwise reevaluate everything upon each iteration.
+     * It can also be used to optimize performance as {@link DataStream} would otherwise reevaluate everything upon each iteration.
      *
      * ## Example
      * ```javascript
@@ -604,7 +611,7 @@ class DataStream {
      * ds.clear()
      * chachedStream // Still has all the items.
      * ```
-     * @returns A new [[DataStream]] with cached items (detached from the original [[DataSet]]).
+     * @returns A new {@link DataStream} with cached items (detached from the original {@link DataSet}).
      */
     cache() {
         return new DataStream([...this._pairs]);
@@ -822,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.
      *
@@ -830,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;
@@ -846,10 +864,6 @@ class DataSet extends DataSetPart {
         }
         this.setOptions(options);
     }
-    /** @inheritDoc */
-    get idProp() {
-        return this._idProp;
-    }
     /**
      * Set new options.
      *
@@ -1067,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);
@@ -1440,7 +1454,7 @@ class DataSet extends DataSetPart {
     /**
      * Clear the entire data set.
      *
-     * 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.
+     * After the items are removed, the {@link 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.
@@ -1632,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.
      *
@@ -1640,17 +1664,10 @@ 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
     /**