vis-data 7.1.9 → 7.1.10

package/dist/esm.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.9
- * @date    2023-11-24T17:54:21.708Z
+ * @version 7.1.10
+ * @date    2025-07-06T08:43:01.753Z
  *
  * @copyright (c) 2011-2017 Almende B.V, http://almende.com
  * @copyright (c) 2017-2019 visjs contributors, https://github.com/visjs
@@ -3174,7 +3174,6 @@ var _flatMapInstanceProperty = /*@__PURE__*/getDefaultExportFromCjs(flatMap);
 
 /**
  * Create new data pipe.
- *
  * @param from - The source data set or data view.
  * @remarks
  * Example usage:
@@ -3210,7 +3209,6 @@ function createNewDataPipeFrom(from) {
 /**
  * Internal implementation of the pipe. This should be accessible only through
  * `createNewDataPipeFrom` from the outside.
- *
  * @typeParam SI - Source item type.
  * @typeParam SP - Source item type's id property name.
  * @typeParam TI - Target item type.
@@ -3219,7 +3217,6 @@ function createNewDataPipeFrom(from) {
 var SimpleDataPipe = /*#__PURE__*/function () {
   /**
    * Create a new data pipe.
-   *
    * @param _source - The data set or data view that will be observed.
    * @param _transformers - An array of transforming functions to be used to
    * filter or transform the items in the pipe.
@@ -3267,7 +3264,6 @@ var SimpleDataPipe = /*#__PURE__*/function () {
     }
     /**
      * Apply the transformers to the items.
-     *
      * @param items - The items to be transformed.
      * @returns The transformed items.
      */
@@ -3281,7 +3277,6 @@ var SimpleDataPipe = /*#__PURE__*/function () {
     }
     /**
      * Handle an add event.
-     *
      * @param _name - Ignored.
      * @param payload - The payload containing the ids of the added items.
      */
@@ -3295,7 +3290,6 @@ var SimpleDataPipe = /*#__PURE__*/function () {
     }
     /**
      * Handle an update event.
-     *
      * @param _name - Ignored.
      * @param payload - The payload containing the ids of the updated items.
      */
@@ -3309,7 +3303,6 @@ var SimpleDataPipe = /*#__PURE__*/function () {
     }
     /**
      * Handle a remove event.
-     *
      * @param _name - Ignored.
      * @param payload - The payload containing the data of the removed items.
      */
@@ -3327,7 +3320,6 @@ var SimpleDataPipe = /*#__PURE__*/function () {
 /**
  * Internal implementation of the pipe factory. This should be accessible
  * only through `createNewDataPipeFrom` from the outside.
- *
  * @typeParam TI - Target item type.
  * @typeParam TP - Target item type's id property name.
  */
@@ -3335,7 +3327,6 @@ var DataPipeUnderConstruction = /*#__PURE__*/function () {
   /**
    * Create a new data pipe factory. This is an internal constructor that
    * should never be called from outside of this file.
-   *
    * @param _source - The source data set or data view for this pipe.
    */
   function DataPipeUnderConstruction(_source) {
@@ -3349,7 +3340,6 @@ var DataPipeUnderConstruction = /*#__PURE__*/function () {
   }
   /**
    * 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.
@@ -3364,7 +3354,6 @@ var DataPipeUnderConstruction = /*#__PURE__*/function () {
     }
     /**
      * Map each source item to a new type.
-     *
      * @param callback - A mapping function that takes a source item and returns
      * corresponding mapped item.
      * @typeParam TI - Target item type.
@@ -3381,7 +3370,6 @@ var DataPipeUnderConstruction = /*#__PURE__*/function () {
     }
     /**
      * Map each source item to zero or more items of a new type.
-     *
      * @param callback - A mapping function that takes a source item and returns
      * an array of corresponding mapped items.
      * @typeParam TI - Target item type.
@@ -3398,7 +3386,6 @@ var DataPipeUnderConstruction = /*#__PURE__*/function () {
     }
     /**
      * 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.
@@ -10305,7 +10292,6 @@ function v4(options, buf, offset) {
 
 /**
  * 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.
  */
@@ -10470,13 +10456,11 @@ var _spliceInstanceProperty = /*@__PURE__*/getDefaultExportFromCjs(splice);
 
 /**
  * A queue.
- *
  * @typeParam T - The type of method names to be replaced by queued versions.
  */
 var Queue = /*#__PURE__*/function () {
   /**
    * Construct a new Queue.
-   *
    * @param options - Queue configuration.
    */
   function Queue(options) {
@@ -10493,7 +10477,6 @@ var Queue = /*#__PURE__*/function () {
   }
   /**
    * Update the configuration of the queue.
-   *
    * @param options - Queue configuration.
    */
   _createClass(Queue, [{
@@ -10510,7 +10493,6 @@ var Queue = /*#__PURE__*/function () {
     /**
      * Extend an object with queuing functionality.
      * The object will be extended with a function flush, and the methods provided in options.replace will be replaced with queued ones.
-     *
      * @param object - The object to be extended.
      * @param options - Additional options.
      * @returns The created queue.
@@ -10541,7 +10523,6 @@ var Queue = /*#__PURE__*/function () {
     }
     /**
      * Replace a method on an object with a queued version.
-     *
      * @param object - Object having the method.
      * @param method - The method name.
      */
@@ -10568,7 +10549,6 @@ var Queue = /*#__PURE__*/function () {
     }
     /**
      * Queue a call.
-     *
      * @param entry - The function or entry to be queued.
      */
   }, {
@@ -10654,7 +10634,6 @@ var Queue = /*#__PURE__*/function () {
 
 /**
  * {@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.
  */
@@ -10681,7 +10660,6 @@ var DataSetPart = /*#__PURE__*/function () {
     value:
     /**
      * Trigger an event
-     *
      * @param event - Event name.
      * @param payload - Event payload.
      * @param senderId - Id of the sender.
@@ -10697,7 +10675,6 @@ var DataSetPart = /*#__PURE__*/function () {
     }
     /**
      * Subscribe to an event, add an event listener.
-     *
      * @remarks Non-function callbacks are ignored.
      * @param event - Event name.
      * @param callback - Callback method.
@@ -10712,7 +10689,6 @@ var DataSetPart = /*#__PURE__*/function () {
     }
     /**
      * 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.
@@ -10829,7 +10805,6 @@ function _unsupportedIterableToArray$2(o, minLen) { var _context10; if (!o) retu
 function _arrayLikeToArray$2(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 /**
  * Data stream
- *
  * @remarks
  * {@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.
@@ -10839,7 +10814,6 @@ function _arrayLikeToArray$2(arr, len) { if (len == null || len > arr.length) le
 var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
   /**
    * Create a new data stream.
-   *
    * @param pairs - The id, item pairs.
    */
   function DataStream(pairs) {
@@ -11020,7 +10994,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     })
     /**
      * Return an array containing all the ids in this stream.
-     *
      * @remarks
      * The array may contain duplicities.
      * @returns The array with all ids from this stream.
@@ -11035,7 +11008,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * Return an array containing all the items in this stream.
-     *
      * @remarks
      * The array may contain duplicities.
      * @returns The array with all items from this stream.
@@ -11050,7 +11022,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * Return an array containing all the entries in this stream.
-     *
      * @remarks
      * The array may contain duplicities.
      * @returns The array with all entries from this stream.
@@ -11062,7 +11033,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * Return an object map containing all the items in this stream accessible by ids.
-     *
      * @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.
@@ -11089,7 +11059,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * Return a map containing all the items in this stream accessible by ids.
-     *
      * @returns The map of all id → item pairs from this stream.
      */
   }, {
@@ -11099,7 +11068,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * Return a set containing all the (unique) ids in this stream.
-     *
      * @returns The set of all ids from this stream.
      */
   }, {
@@ -11109,7 +11077,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * Return a set containing all the (unique) items in this stream.
-     *
      * @returns The set of all items from this stream.
      */
   }, {
@@ -11119,7 +11086,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * Cache the items from this stream.
-     *
      * @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 {@link DataStream} would otherwise reevaluate everything upon each iteration.
@@ -11146,7 +11112,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * 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.
@@ -11173,7 +11138,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * 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.
      */
@@ -11228,7 +11192,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * Execute a callback for each item of the stream.
-     *
      * @param callback - The function that will be invoked for each item.
      */
   }, {
@@ -11251,7 +11214,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * 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.
@@ -11303,7 +11265,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * 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.
      */
@@ -11331,7 +11292,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * 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.
      */
@@ -11359,7 +11319,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * Reduce the items into a single value.
-     *
      * @param callback - The function that does the reduction.
      * @param accumulator - The initial value of the accumulator.
      * @typeParam T - The type of the accumulated value.
@@ -11386,7 +11345,6 @@ var DataStream = /*#__PURE__*/function (_Symbol$iterator$1) {
     }
     /**
      * Sort the items.
-     *
      * @param callback - Item comparator.
      * @returns A new stream with sorted items.
      */
@@ -11422,7 +11380,6 @@ function _createSuper$1(Derived) { var hasNativeReflectConstruct = _isNativeRefl
 function _isNativeReflectConstruct$1() { if (typeof Reflect === "undefined" || !_Reflect$construct) return false; if (_Reflect$construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
 /**
  * Add an id to given item if it doesn't have one already.
- *
  * @remarks
  * The item will be modified.
  * @param item - The item that will have an id after a call to this function.
@@ -11460,15 +11417,15 @@ function ensureFullItem(item, idProp) {
  * // add items
  * // note that the data items can contain different properties and data formats
  * data.add([
- *   {id: 1, text: 'item 1', date: new Date(2013, 6, 20), group: 1, first: true},
- *   {id: 2, text: 'item 2', date: '2013-06-23', group: 2},
- *   {id: 3, text: 'item 3', date: '2013-06-25', group: 2},
- *   {id: 4, text: 'item 4'}
+ * {id: 1, text: 'item 1', date: new Date(2013, 6, 20), group: 1, first: true},
+ * {id: 2, text: 'item 2', date: '2013-06-23', group: 2},
+ * {id: 3, text: 'item 3', date: '2013-06-25', group: 2},
+ * {id: 4, text: 'item 4'}
  * ]);
  *
  * // subscribe to any change in the DataSet
  * data.on('*', function (event, properties, senderId) {
- *   console.log('event', event, properties);
+ * console.log('event', event, properties);
  * });
  *
  * // update an existing item
@@ -11487,13 +11444,12 @@ function ensureFullItem(item, idProp) {
  *
  * // retrieve a filtered subset of the data
  * var items = data.get({
- *   filter: function (item) {
- *     return item.group == 1;
- *   }
+ * filter: function (item) {
+ * return item.group == 1;
+ * }
  * });
  * console.log('filtered items', items);
  * ```
- *
  * @typeParam Item - Item type that may or may not have an id.
  * @typeParam IdProp - Name of the property that contains the id.
  */
@@ -11502,7 +11458,6 @@ var DataSet = /*#__PURE__*/function (_DataSetPart) {
   var _super = _createSuper$1(DataSet);
   /**
    * Construct a new DataSet.
-   *
    * @param data - Initial data or options.
    * @param options - Options (type error if data is also options).
    */
@@ -11529,7 +11484,6 @@ var DataSet = /*#__PURE__*/function (_DataSetPart) {
   }
   /**
    * Set new options.
-   *
    * @param options - The new options.
    */
   _createClass(DataSet, [{
@@ -11578,14 +11532,13 @@ var DataSet = /*#__PURE__*/function (_DataSetPart) {
      *
      * // add items
      * const ids = data.add([
-     *   { id: 1, text: 'item 1' },
-     *   { id: 2, text: 'item 2' },
-     *   { text: 'item without an id' }
+     * { id: 1, text: 'item 1' },
+     * { id: 2, text: 'item 2' },
+     * { text: 'item without an id' }
      * ])
      *
      * console.log(ids) // [1, 2, '<UUIDv4>']
      * ```
-     *
      * @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.
@@ -11627,7 +11580,6 @@ var DataSet = /*#__PURE__*/function (_DataSetPart) {
     }
     /**
      * Update existing items. When an item does not exist, it will be created.
-     *
      * @remarks
      * The provided properties will be merged in the existing item. When an item does not exist, it will be created.
      *
@@ -11723,7 +11675,6 @@ var DataSet = /*#__PURE__*/function (_DataSetPart) {
     }
     /**
      * Update existing items. When an item does not exist, an error will be thrown.
-     *
      * @remarks
      * The provided properties will be deeply merged into the existing item.
      * When an item does not exist (id not present in the data set or absent), an error will be thrown and nothing will be changed.
@@ -12030,7 +11981,6 @@ var DataSet = /*#__PURE__*/function (_DataSetPart) {
     }
     /**
      * Filter the fields of an item.
-     *
      * @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.
@@ -12055,7 +12005,6 @@ var DataSet = /*#__PURE__*/function (_DataSetPart) {
     }
     /**
      * Sort the provided array with items.
-     *
      * @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.
@@ -12092,9 +12041,9 @@ var DataSet = /*#__PURE__*/function (_DataSetPart) {
      * ```javascript
      * // create a DataSet
      * const data = new vis.DataSet([
-     *   { id: 1, text: 'item 1' },
-     *   { id: 2, text: 'item 2' },
-     *   { id: 3, text: 'item 3' }
+     * { id: 1, text: 'item 1' },
+     * { id: 2, text: 'item 2' },
+     * { id: 3, text: 'item 3' }
      * ])
      *
      * // remove items
@@ -12102,7 +12051,6 @@ var DataSet = /*#__PURE__*/function (_DataSetPart) {
      *
      * console.log(ids) // [2, 3]
      * ```
-     *
      * @param id - One or more items or ids of items to be removed.
      * @param senderId - Sender id.
      * @returns The ids of the removed items.
@@ -12134,7 +12082,6 @@ var DataSet = /*#__PURE__*/function (_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.
      */
@@ -12163,7 +12110,6 @@ var DataSet = /*#__PURE__*/function (_DataSetPart) {
      * Clear the entire data set.
      *
      * 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.
      */
@@ -12186,7 +12132,6 @@ var DataSet = /*#__PURE__*/function (_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.
      */
@@ -12216,7 +12161,6 @@ var DataSet = /*#__PURE__*/function (_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.
      */
@@ -12246,7 +12190,6 @@ var DataSet = /*#__PURE__*/function (_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.
      */
@@ -12277,7 +12220,6 @@ var DataSet = /*#__PURE__*/function (_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.
      */
@@ -12298,7 +12240,6 @@ var DataSet = /*#__PURE__*/function (_DataSetPart) {
     /**
      * Update a single item: merge with existing item.
      * 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.
      */
@@ -12439,25 +12380,25 @@ function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_R
  * // create a DataSet
  * var data = new vis.DataSet();
  * data.add([
- *   {id: 1, text: 'item 1', date: new Date(2013, 6, 20), group: 1, first: true},
- *   {id: 2, text: 'item 2', date: '2013-06-23', group: 2},
- *   {id: 3, text: 'item 3', date: '2013-06-25', group: 2},
- *   {id: 4, text: 'item 4'}
+ * {id: 1, text: 'item 1', date: new Date(2013, 6, 20), group: 1, first: true},
+ * {id: 2, text: 'item 2', date: '2013-06-23', group: 2},
+ * {id: 3, text: 'item 3', date: '2013-06-25', group: 2},
+ * {id: 4, text: 'item 4'}
  * ]);
  *
  * // create a DataView
  * // the view will only contain items having a property group with value 1,
  * // and will only output fields id, text, and date.
  * var view = new vis.DataView(data, {
- *   filter: function (item) {
- *     return (item.group == 1);
- *   },
- *   fields: ['id', 'text', 'date']
+ * filter: function (item) {
+ * return (item.group == 1);
+ * },
+ * fields: ['id', 'text', 'date']
  * });
  *
  * // subscribe to any change in the DataView
  * view.on('*', function (event, properties, senderId) {
- *   console.log('event', event, properties);
+ * console.log('event', event, properties);
  * });
  *
  * // update an item in the data set
@@ -12470,7 +12411,6 @@ function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_R
  * // get all items in the view
  * var items = view.get();
  * ```
- *
  * @typeParam Item - Item type that may or may not have an id.
  * @typeParam IdProp - Name of the property that contains the id.
  */
@@ -12481,7 +12421,6 @@ var DataView = /*#__PURE__*/function (_DataSetPart) {
 
   /**
    * Create a DataView.
-   *
    * @param data - The instance containing data (directly or indirectly).
    * @param options - Options to configure this data view.
    */
@@ -12503,7 +12442,6 @@ var DataView = /*#__PURE__*/function (_DataSetPart) {
   // 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
@@ -12743,7 +12681,6 @@ var DataView = /*#__PURE__*/function (_DataSetPart) {
     }
     /**
      * Render the instance unusable prior to garbage collection.
-     *
      * @remarks
      * The intention of this method is to help discover scenarios where the data
      * view is being used when the programmer thinks it has been garbage collected
@@ -12781,7 +12718,6 @@ var DataView = /*#__PURE__*/function (_DataSetPart) {
     }
     /**
      * Event listener. Will propagate all events from the connected data set to the subscribers of the DataView, but will filter the items and only trigger when there are changes in the filtered data set.
-     *
      * @param event - The name of the event.
      * @param params - Parameters of the event.
      * @param senderId - Id supplied by the sender.
@@ -12873,7 +12809,6 @@ var DataView = /*#__PURE__*/function (_DataSetPart) {
 
 /**
  * Check that given value is compatible with Vis Data Set interface.
- *
  * @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.
@@ -12884,7 +12819,6 @@ function isDataSetLike(idProp, v) {
 
 /**
  * Check that given value is compatible with Vis Data View interface.
- *
  * @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.