@dereekb/rxjs 14.8.0 → 14.10.0

package/index.esm.js

@@ -1,5 +1,5 @@
-import { isWebsiteUrlWithPrefix, getValueFromGetter, isMaybeSo, filterMaybeArrayValues, areEqualPOJOValues, convertToArray, asGetter, performTaskLoop, isMaybeNot, forEachWithArray, pushArrayItemsIntoArray, asArray, pushItemOrArrayItemsIntoArray, filterAndMapFunction, expirationDetails, objectKeysEqualityComparatorFunction, objectKeyEqualityComparatorFunction, asPromise, randomNumberFactory, mapsHaveSameKeys, mapKeysIntersectionObjectToArray, incrementingNumberFactory, filterUniqueFunction, build, cachedGetter, allKeyValueTuples, keyValueMapFactory, multiKeyValueMapFactory, timePeriodCounter, hasSameValues, compareEqualityWithValueFromItemsFunction, setContainsAllValues, setContainsAnyValue, setContainsNoneOfValue, searchStringFilterFunction, reduceBooleansWithAnd, toReadableError, reduceBooleansWithOr, valuesAreBothNullishOrEquivalent, mergeObjects, objectHasKey, safeCompareEquality, hasNonNullValue, limitArray, mapFunctionOutputPair, lastValue, flattenArray, hasValueOrNotEmpty, filteredPage, invertMaybeBoolean, FIRST_PAGE, getNextPageNumber, reduceBooleansWithOrFn, MS_IN_SECOND } from '@dereekb/util';
-import { defer, from, isObservable, of, switchMap, combineLatest, map, delay, startWith, filter, skipWhile, EMPTY, distinctUntilChanged, mergeMap, BehaviorSubject, shareReplay, skip, defaultIfEmpty, first, finalize, merge, firstValueFrom, exhaustMap, scan, identity, throttleTime, takeWhile, timeout, tap, throwError, timer, delayWhen, asyncScheduler, catchError, Subject } from 'rxjs';
+import { isWebsiteUrlWithPrefix, getValueFromGetter, isMaybeSo, filterMaybeArrayValues, areEqualPOJOValues, convertToArray, mergeObjects, asGetter, performTaskLoop, isMaybeNot, forEachWithArray, pushArrayItemsIntoArray, asArray, pushItemOrArrayItemsIntoArray, filterAndMapFunction, expirationDetails, objectKeysEqualityComparatorFunction, objectKeyEqualityComparatorFunction, asPromise, randomNumberFactory, mapsHaveSameKeys, mapKeysIntersectionObjectToArray, incrementingNumberFactory, filterUniqueFunction, build, cachedGetter, allKeyValueTuples, keyValueMapFactory, multiKeyValueMapFactory, timePeriodCounter, hasSameValues, compareEqualityWithValueFromItemsFunction, setContainsAllValues, setContainsAnyValue, setContainsNoneOfValue, searchStringFilterFunction, reduceBooleansWithAnd, toReadableError, reduceBooleansWithOr, valuesAreBothNullishOrEquivalent, objectHasKey, safeCompareEquality, hasNonNullValue, limitArray, mapFunctionOutputPair, lastValue, flattenArray, hasValueOrNotEmpty, filteredPage, invertMaybeBoolean, FIRST_PAGE, getNextPageNumber, reduceBooleansWithOrFn, MS_IN_SECOND } from '@dereekb/util';
+import { defer, from, isObservable, of, switchMap, combineLatest, map, delay, startWith, filter, skipWhile, EMPTY, mergeMap, shareReplay, BehaviorSubject, finalize, Observable, distinctUntilChanged, skip, defaultIfEmpty, first, merge, concat, firstValueFrom, exhaustMap, scan, identity, throttleTime, takeWhile, timeout, tap, throwError, timer, delayWhen, asyncScheduler, catchError, Subject } from 'rxjs';
 
 function _class_call_check$9(instance, Constructor) {
     if (!(instance instanceof Constructor)) throw new TypeError("Cannot call a class as a function");
@@ -950,6 +950,157 @@ function switchMapOnBoolean(switchOnValue, obs, otherwise) {
     };
 }
 
+function _array_like_to_array$9(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;
+}
+function _array_with_holes$4(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _iterable_to_array_limit$4(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest$4() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array$4(arr, i) {
+    return _array_with_holes$4(arr) || _iterable_to_array_limit$4(arr, i) || _unsupported_iterable_to_array$9(arr, i) || _non_iterable_rest$4();
+}
+function _unsupported_iterable_to_array$9(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array$9(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$9(o, minLen);
+}
+/**
+ * Combines `startWith` and {@link tapFirst} to initialize an observable pipe with a side-effect on the first emission.
+ *
+ * Emits the `initial` value first, then taps on the first emitted value to run the provided callback.
+ *
+ * @param tap - Side-effect function called with the first value.
+ * @param initial - Optional starting value emitted before the source.
+ * @param skipFirst - If true, skips tapping the initial value.
+ * @returns An operator that initializes the pipe with a tap.
+ */ function initialize(tap, initial, skipFirst) {
+    return function(source) {
+        var subscriber = source.pipe(startWith(initial), tapFirst(function(x) {
+            return tap(x);
+        }, initial == null || skipFirst));
+        return subscriber;
+    };
+}
+/**
+ * Executes a side-effect on the first emission from the observable, then passes all values through.
+ *
+ * @param tap - The side-effect function to call once.
+ * @param skipFirst - If true, skips the very first emission before tapping.
+ * @returns An operator that taps the first value.
+ */ function tapFirst(tap) {
+    var skipFirst = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : false;
+    return skipWhile(function(value) {
+        var i = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 0;
+        tap(value);
+        return i === 0 && !skipFirst;
+    });
+}
+/**
+ * RxJS operator that ignores the values the source emits synchronously while it is being subscribed to, such as the
+ * current value of a BehaviorSubject or the latest value replayed by `shareReplay()`. Only values emitted afterwards pass through.
+ *
+ * @returns Operator that skips the values replayed on subscription.
+ *
+ * @example
+ * ```ts
+ * const value = new BehaviorSubject(1);
+ * value.pipe(skipReplayedValues()).subscribe(console.log);
+ * value.next(2);
+ * // Output: 2
+ * ```
+ */ function skipReplayedValues() {
+    return function(source) {
+        return new Observable(function(subscriber) {
+            var subscribing = true;
+            var subscription = source.subscribe({
+                next: function next(x) {
+                    if (!subscribing) {
+                        subscriber.next(x);
+                    }
+                },
+                error: function error(e) {
+                    return subscriber.error(e);
+                },
+                complete: function complete() {
+                    return subscriber.complete();
+                }
+            });
+            subscribing = false;
+            return subscription;
+        });
+    };
+}
+/**
+ * Wraps an observable so that it never emits `complete` until it is unsubscribed.
+ *
+ * The subscription will never have `complete()` called since it only triggers after unsubscription.
+ * Use `finalize()` for additional cleanup.
+ *
+ * @param obs - The source observable to wrap.
+ * @returns An observable that only completes on unsubscription.
+ */ function preventComplete(obs) {
+    var complete = new BehaviorSubject(0);
+    return combineLatest([
+        obs,
+        complete
+    ]).pipe(map(function(param) {
+        var _param = _sliced_to_array$4(param, 1), x = _param[0];
+        return x;
+    }), shareReplay(1), finalize(function() {
+        complete.complete();
+    }));
+}
+/**
+ * Creates a cold observable that defers execution of the getter until subscription, then shares the result.
+ *
+ * Unlike `from()`, the promise/observable is not created until the first subscriber connects.
+ *
+ * @param getter - Factory that returns a Promise or Observable.
+ * @returns A shared observable that defers execution until subscription.
+ *
+ * @example
+ * ```ts
+ * const data$ = lazyFrom(() => fetch('/api/data').then(r => r.json()));
+ * // The fetch is not called until data$ is subscribed to
+ * ```
+ */ function lazyFrom(getter) {
+    return of(undefined).pipe(mergeMap(function() {
+        return from(getter());
+    }), shareReplay(1));
+}
+
 /**
  * RxJS operator that suppresses consecutive emissions when the emitted POJO values are deeply equal.
  *
@@ -979,13 +1130,13 @@ function filterIfObjectValuesUnchanged(input) {
     return result;
 }
 
-function _array_like_to_array$9(arr, len) {
+function _array_like_to_array$8(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;
 }
 function _array_without_holes$4(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$9(arr);
+    if (Array.isArray(arr)) return _array_like_to_array$8(arr);
 }
 function _class_call_check$8(instance, Constructor) {
     if (!(instance instanceof Constructor)) throw new TypeError("Cannot call a class as a function");
@@ -1023,15 +1174,15 @@ function _non_iterable_spread$4() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _to_consumable_array$4(arr) {
-    return _array_without_holes$4(arr) || _iterable_to_array$4(arr) || _unsupported_iterable_to_array$9(arr) || _non_iterable_spread$4();
+    return _array_without_holes$4(arr) || _iterable_to_array$4(arr) || _unsupported_iterable_to_array$8(arr) || _non_iterable_spread$4();
 }
-function _unsupported_iterable_to_array$9(o, minLen) {
+function _unsupported_iterable_to_array$8(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$9(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$8(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$9(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$8(o, minLen);
 }
 /**
  * Manages a single RxJS subscription with automatic cleanup on reassignment.
@@ -1213,12 +1364,12 @@ function _unsupported_iterable_to_array$9(o, minLen) {
 } 
 ();
 
-function _array_like_to_array$8(arr, len) {
+function _array_like_to_array$7(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;
 }
-function _array_with_holes$4(arr) {
+function _array_with_holes$3(arr) {
     if (Array.isArray(arr)) return arr;
 }
 function _class_call_check$7(instance, Constructor) {
@@ -1248,7 +1399,7 @@ function _define_property$c(obj, key, value) {
     } else obj[key] = value;
     return obj;
 }
-function _iterable_to_array_limit$4(arr, i) {
+function _iterable_to_array_limit$3(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -1272,19 +1423,19 @@ function _iterable_to_array_limit$4(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest$4() {
+function _non_iterable_rest$3() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _sliced_to_array$4(arr, i) {
-    return _array_with_holes$4(arr) || _iterable_to_array_limit$4(arr, i) || _unsupported_iterable_to_array$8(arr, i) || _non_iterable_rest$4();
+function _sliced_to_array$3(arr, i) {
+    return _array_with_holes$3(arr) || _iterable_to_array_limit$3(arr, i) || _unsupported_iterable_to_array$7(arr, i) || _non_iterable_rest$3();
 }
-function _unsupported_iterable_to_array$8(o, minLen) {
+function _unsupported_iterable_to_array$7(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$8(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$7(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$8(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$7(o, minLen);
 }
 /**
  * Concrete implementation of {@link FilterSource} that manages reactive filter state with
@@ -1328,7 +1479,7 @@ function _unsupported_iterable_to_array$8(o, minLen) {
             this._initialFilter,
             this._defaultFilter
         ]).pipe(map(function(param) {
-            var _param = _sliced_to_array$4(param, 2), a = _param[0], b = _param[1];
+            var _param = _sliced_to_array$3(param, 2), a = _param[0], b = _param[1];
             return a !== null && a !== void 0 ? a : b;
         }), switchMapFilterMaybe(), distinctUntilChanged(), shareReplay(1)));
         /**
@@ -1445,13 +1596,56 @@ function _unsupported_iterable_to_array$8(o, minLen) {
 } 
 ();
 
-function _array_like_to_array$7(arr, len) {
+/**
+ * Merges several partial filters into a single filter.
+ *
+ * Filters are applied left-to-right, so the last filter wins when two filters set the same field.
+ * `undefined` values never overwrite a previously set value.
+ *
+ * The `preset` field is removed from the result, since a merged filter cannot represent more than one preset.
+ * Each source filter keeps its own preset, so any preset menu bound to a single source still shows its selection.
+ *
+ * @param filters - Partial filters (or null/undefined) to merge.
+ * @returns The merged filter, without a `preset` value.
+ *
+ * @example
+ * ```ts
+ * mergeFilters([{ date, preset: 'today' }, { minPrice: 100 }]);
+ * // { date, minPrice: 100 }
+ * ```
+ */ function mergeFilters(filters) {
+    var merged = mergeObjects(filters);
+    delete merged.preset;
+    return merged;
+}
+/**
+ * Combines the latest value of each filter observable into a single merged filter observable.
+ *
+ * Emits once every input has emitted, then again whenever any input emits a new value.
+ * Consecutive emissions with equal values are suppressed.
+ *
+ * @param filterObs - Filter observables to combine. Every observable must emit at least once for the result to emit.
+ * @param mergeFn - Function used to merge the latest filters. Defaults to {@link mergeFilters}.
+ * @returns Observable of the merged filter.
+ *
+ * @example
+ * ```ts
+ * const filter$ = combineFilters([dateFilter$, attributesFilter$]);
+ * ```
+ */ function combineFilters(filterObs) {
+    var mergeFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : mergeFilters;
+    return combineLatest(filterObs).pipe(map(function(filters) {
+        return mergeFn(filters);
+    }), distinctUntilObjectValuesChanged(), shareReplay(1));
+}
+
+function _array_like_to_array$6(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;
 }
 function _array_without_holes$3(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$7(arr);
+    if (Array.isArray(arr)) return _array_like_to_array$6(arr);
 }
 function _class_call_check$6(instance, Constructor) {
     if (!(instance instanceof Constructor)) throw new TypeError("Cannot call a class as a function");
@@ -1489,15 +1683,15 @@ function _non_iterable_spread$3() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _to_consumable_array$3(arr) {
-    return _array_without_holes$3(arr) || _iterable_to_array$3(arr) || _unsupported_iterable_to_array$7(arr) || _non_iterable_spread$3();
+    return _array_without_holes$3(arr) || _iterable_to_array$3(arr) || _unsupported_iterable_to_array$6(arr) || _non_iterable_spread$3();
 }
-function _unsupported_iterable_to_array$7(o, minLen) {
+function _unsupported_iterable_to_array$6(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$7(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$6(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$7(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$6(o, minLen);
 }
 /**
  * Manages a collection of reactive filters keyed by string identifiers.
@@ -1541,6 +1735,56 @@ function _unsupported_iterable_to_array$7(o, minLen) {
         },
         {
             /**
+     * Returns an observable of the filters for all the given keys merged into a single filter.
+     *
+     * Lets several filter controls each own a separate key, so one control saving its filter never overwrites the fields set by another.
+     * Keys later in the array win when two keys set the same field. The `preset` field is removed from the merged result.
+     *
+     * Every key must have a value (for example, a default added with {@link addDefaultFilterObs}) before the merged filter emits.
+     *
+     * @param keys - Filter map keys to merge, in priority order.
+     * @param mergeFn - Function used to merge the filters. Defaults to {@link mergeFilters}.
+     * @returns Observable that emits the merged filter whenever any of the keys' filters change.
+     *
+     * @example
+     * ```ts
+     * filterMap.addDefaultFilterObs('date', of({}));
+     * filterMap.addDefaultFilterObs('attributes', of({}));
+     *
+     * filterMap.mergedFilterForKeys(['date', 'attributes']).subscribe((filter) => console.log(filter));
+     * ```
+     */ key: "mergedFilterForKeys",
+            value: function mergedFilterForKeys(keys, mergeFn) {
+                var _this = this;
+                var filterObs = keys.map(function(key) {
+                    return _this.filterForKey(key);
+                });
+                return combineFilters(filterObs, mergeFn);
+            }
+        },
+        {
+            /**
+     * Sets the filter for the given key.
+     *
+     * The filter becomes the key's value the same way an emission from one of the key's filter observables would,
+     * and stays the key's value until one of those observables emits a new filter.
+     *
+     * Use to update a key from outside its filter controls, e.g. a "Clear" button that resets the key.
+     *
+     * @param key - Filter map key.
+     * @param filter - Filter to set.
+     *
+     * @example
+     * ```ts
+     * filterMap.setFilterForKey('users', { active: true });
+     * ```
+     */ key: "setFilterForKey",
+            value: function setFilterForKey(key, filter) {
+                this._itemForKey(key).setFilter(filter);
+            }
+        },
+        {
+            /**
      * Sets a default filter observable for the given key, used as a fallback when no explicit filter is set.
      *
      * @param key - Filter map key.
@@ -1670,18 +1914,28 @@ function _unsupported_iterable_to_array$7(o, minLen) {
 }();
 var FilterMapItem = /*#__PURE__*/ function() {
     function FilterMapItem(dbxFilterMap, key) {
+        var _this = this;
         _class_call_check$6(this, FilterMapItem);
         _define_property$b(this, "_dbxFilterMap", void 0);
         _define_property$b(this, "_key", void 0);
         _define_property$b(this, "_i", 0);
         _define_property$b(this, "_source", new FilterSourceInstance());
         _define_property$b(this, "_obs", new BehaviorSubject([]));
+        _define_property$b(this, "_setFilter", new BehaviorSubject(undefined));
         _define_property$b(this, "_obs$", this._obs.pipe(switchMap(function(x) {
             return merge.apply(void 0, _to_consumable_array$3(x.map(function(y) {
                 return y.obs;
             })));
         }), distinctUntilChanged()));
-        _define_property$b(this, "filter$", this._source.initialFilter$);
+        /**
+     * The source's filter, or the filter from setFilter() until the source emits a new filter after it was set.
+     *
+     * The set filter is held rather than added as another filter observable, so it is not lost if nothing is subscribed yet,
+     * and does not replay over newer values when the key's filter observables change.
+     */ _define_property$b(this, "filter$", this._setFilter.pipe(// the source's current value is older than the set filter, so only values the source emits afterwards replace it
+        switchMap(function(setFilter) {
+            return setFilter == null ? _this._source.initialFilter$ : concat(of(setFilter), _this._source.initialFilter$.pipe(skipReplayedValues()));
+        }), distinctUntilChanged(), shareReplay(1)));
         this._dbxFilterMap = dbxFilterMap;
         this._key = key;
     }
@@ -1704,6 +1958,12 @@ var FilterMapItem = /*#__PURE__*/ function() {
                 this._source.setDefaultFilter(obs);
             }
         },
+        {
+            key: "setFilter",
+            value: function setFilter(filter) {
+                this._setFilter.next(filter);
+            }
+        },
         {
             key: "addFilterObs",
             value: function addFilterObs(obs) {
@@ -1754,6 +2014,7 @@ var FilterMapItem = /*#__PURE__*/ function() {
                 });
                 this._source.destroy();
                 this._obs.complete();
+                this._setFilter.complete();
             }
         }
     ]);
@@ -2101,13 +2362,13 @@ function _ts_generator$1(thisArg, body) {
     });
 }
 
-function _array_like_to_array$6(arr, len) {
+function _array_like_to_array$5(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;
 }
 function _array_without_holes$2(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$6(arr);
+    if (Array.isArray(arr)) return _array_like_to_array$5(arr);
 }
 function _iterable_to_array$2(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) {
@@ -2118,15 +2379,15 @@ function _non_iterable_spread$2() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _to_consumable_array$2(arr) {
-    return _array_without_holes$2(arr) || _iterable_to_array$2(arr) || _unsupported_iterable_to_array$6(arr) || _non_iterable_spread$2();
+    return _array_without_holes$2(arr) || _iterable_to_array$2(arr) || _unsupported_iterable_to_array$5(arr) || _non_iterable_spread$2();
 }
-function _unsupported_iterable_to_array$6(o, minLen) {
+function _unsupported_iterable_to_array$5(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$6(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$5(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$6(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$5(o, minLen);
 }
 function distinctUntilArrayLengthChanges(inputGetArray) {
     var getArray = inputGetArray !== null && inputGetArray !== void 0 ? inputGetArray : function(value) {
@@ -2806,122 +3067,6 @@ function _object_spread_props$8(target, source) {
     }));
 }
 
-function _array_like_to_array$5(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;
-}
-function _array_with_holes$3(arr) {
-    if (Array.isArray(arr)) return arr;
-}
-function _iterable_to_array_limit$3(arr, i) {
-    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
-    if (_i == null) return;
-    var _arr = [];
-    var _n = true;
-    var _d = false;
-    var _s, _e;
-    try {
-        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
-            _arr.push(_s.value);
-            if (i && _arr.length === i) break;
-        }
-    } catch (err) {
-        _d = true;
-        _e = err;
-    } finally{
-        try {
-            if (!_n && _i["return"] != null) _i["return"]();
-        } finally{
-            if (_d) throw _e;
-        }
-    }
-    return _arr;
-}
-function _non_iterable_rest$3() {
-    throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-function _sliced_to_array$3(arr, i) {
-    return _array_with_holes$3(arr) || _iterable_to_array_limit$3(arr, i) || _unsupported_iterable_to_array$5(arr, i) || _non_iterable_rest$3();
-}
-function _unsupported_iterable_to_array$5(o, minLen) {
-    if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$5(o, minLen);
-    var n = Object.prototype.toString.call(o).slice(8, -1);
-    if (n === "Object" && o.constructor) n = o.constructor.name;
-    if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$5(o, minLen);
-}
-/**
- * Combines `startWith` and {@link tapFirst} to initialize an observable pipe with a side-effect on the first emission.
- *
- * Emits the `initial` value first, then taps on the first emitted value to run the provided callback.
- *
- * @param tap - Side-effect function called with the first value.
- * @param initial - Optional starting value emitted before the source.
- * @param skipFirst - If true, skips tapping the initial value.
- * @returns An operator that initializes the pipe with a tap.
- */ function initialize(tap, initial, skipFirst) {
-    return function(source) {
-        var subscriber = source.pipe(startWith(initial), tapFirst(function(x) {
-            return tap(x);
-        }, initial == null || skipFirst));
-        return subscriber;
-    };
-}
-/**
- * Executes a side-effect on the first emission from the observable, then passes all values through.
- *
- * @param tap - The side-effect function to call once.
- * @param skipFirst - If true, skips the very first emission before tapping.
- * @returns An operator that taps the first value.
- */ function tapFirst(tap) {
-    var skipFirst = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : false;
-    return skipWhile(function(value) {
-        var i = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 0;
-        tap(value);
-        return i === 0 && !skipFirst;
-    });
-}
-/**
- * Wraps an observable so that it never emits `complete` until it is unsubscribed.
- *
- * The subscription will never have `complete()` called since it only triggers after unsubscription.
- * Use `finalize()` for additional cleanup.
- *
- * @param obs - The source observable to wrap.
- * @returns An observable that only completes on unsubscription.
- */ function preventComplete(obs) {
-    var complete = new BehaviorSubject(0);
-    return combineLatest([
-        obs,
-        complete
-    ]).pipe(map(function(param) {
-        var _param = _sliced_to_array$3(param, 1), x = _param[0];
-        return x;
-    }), shareReplay(1), finalize(function() {
-        complete.complete();
-    }));
-}
-/**
- * Creates a cold observable that defers execution of the getter until subscription, then shares the result.
- *
- * Unlike `from()`, the promise/observable is not created until the first subscriber connects.
- *
- * @param getter - Factory that returns a Promise or Observable.
- * @returns A shared observable that defers execution until subscription.
- *
- * @example
- * ```ts
- * const data$ = lazyFrom(() => fetch('/api/data').then(r => r.json()));
- * // The fetch is not called until data$ is subscribed to
- * ```
- */ function lazyFrom(getter) {
-    return of(undefined).pipe(mergeMap(function() {
-        return from(getter());
-    }), shareReplay(1));
-}
-
 /**
  * RxJS operator that filters an array to unique items based on a key reader function.
  *
@@ -6982,4 +7127,4 @@ function _define_property(obj, key, value) {
     };
 }
 
-export { AssetLoader, DEFAULT_ASYNC_PUSHER_THROTTLE, DEFAULT_FACTORY_TIMER_INTERVAL, DEFAULT_ITEM_PAGE_ITERATOR_MAX, DEFAULT_LOADING_EVENT_FOR_LOADING_PAIR_FUNCTION, DEFAULT_LOCK_SET_TIME_LOCK_KEY, FilterMap, FilterMapKeyInstance, FilterSource, FilterSourceConnector, FilterSourceInstance, ItemPageIterationInstance, ItemPageIterator, LoadingStateType, LockSet, MultiSubscriptionObject, PresetFilterSource, SimpleLoadingContext, SubscriptionObject, ValuesLoadingContext, WorkInstance, accumulatorCurrentPageListLoadingState, accumulatorFlattenPageListLoadingState, areAllLoadingStatesFinishedLoading, arrayValueFromFinishedLoadingState, asObservable, asObservableFromGetter, assetFolder, assetLoaderAssetInstance, assetLoaderFromGetFn, asyncPusher, asyncPusherCache, beginLoading, beginLoadingPage, catchLoadingStateErrorWithOperator, checkIs, cleanup, cleanupDestroyable, combineLatestFromArrayObsFn, combineLatestFromMapValuesObsFn, combineLatestFromObject, combineLatestMapFrom, combineLoadingStates, combineLoadingStatesStatus, currentValueFromLoadingState, delegatedAssetLoader, distinctLoadingState, distinctUntilArrayLengthChanges, distinctUntilHasDifferentValues, distinctUntilItemsHaveDifferentValues, distinctUntilItemsValueChanges, distinctUntilKeysChange, distinctUntilMapHasDifferentKeys, distinctUntilModelIdChange, distinctUntilModelKeyChange, distinctUntilObjectKeyChange, distinctUntilObjectValuesChanged, emitAfterDelay, emitDelayObs, errorFromLoadingState, errorOnEmissionsInPeriod, errorPageResult, errorResult, factoryTimer, fetchAssetLoader, filterIfObjectValuesUnchanged, filterItemsWithObservableDecision, filterMaybe, filterMaybeArray, filterMaybeStrict, filterUnique, filterWithSearchString, flattenAccumulatorResultItemArray, idleLoadingState, incrementingNumberTimer, initialize, invertObservableDecision, isAnyLoadingStateInLoadingState, isItemPageIteratorResultEndResult, isListLoadingStateWithEmptyValue, isLoading, isLoadingStateEqual, isLoadingStateFinishedLoading, isLoadingStateFinishedLoadingWithDefinedValue, isLoadingStateFinishedLoadingWithError, isLoadingStateInErrorState, isLoadingStateInIdleState, isLoadingStateInLoadingState, isLoadingStateInSuccessState, isLoadingStateLoading, isLoadingStateMetadataEqual, isLoadingStateWithDefinedValue, isLoadingStateWithError, isLoadingStateWithStateType, isNot, isPageLoadingState, isPageLoadingStateMetadataEqual, itemAccumulator, itemAccumulatorNextPageUntilResultsCount, iterationHasNextAndCanLoadMore, iteratorNextPageUntilMaxPageLoadLimit, iteratorNextPageUntilPage, keyValueMap, lazyFrom, listLoadingStateContext, loadingStateContext, loadingStateFromObs, loadingStateHasNextPage, loadingStateType, loadingStateValue, loadingStateWithValueType, localAsset, makeCheckIsFunction, makeIsModifiedFunction, makeIsModifiedFunctionObservable, makeMapFilterWithPresetFn, makeReturnIfIsFunction, mapEachAsync, mapFilterWithPreset, mapForEach, mapIf, mapIsListLoadingStateWithEmptyValue, mapItemIteration, mapKeysIntersectionToArray, mapLoadingState, mapLoadingStateResults, mapLoadingStateValueFunction, mapLoadingStateValueWithOperator, mapMaybe, mappedPageItemIteration, maybeValueFromObservableOrValue, maybeValueFromObservableOrValueGetter, memoryAssetLoader, mergeLoadingStateWithError, mergeLoadingStateWithLoading, mergeLoadingStateWithValue, mergeLoadingStates, mergeLoadingStatesArray, multiKeyValueMap, onFalseToTrue, onLockSetNextUnlock, onMatchDelta, onTrueToFalse, pageItemAccumulatorCurrentPage, pageLoadingStateFromObs, pipeIf, preventComplete, promiseFromLoadingState, randomDelay, randomDelayWithRandomFunction, remoteAsset, remoteAssetBaseUrl, returnIfIs, scanBuildArray, scanCount, scanIntoArray, setContainsAllValuesFrom, setContainsAnyValueFrom, setContainsNoValueFrom, skipAfterExpiration, skipAllInitialMaybe, skipExpired, skipInitialMaybe, skipMaybes, skipUntilExpiration, skipUntilTimeElapsedAfterLastEmission, startWithBeginLoading, successPageResult, successResult, switchMapFilterMaybe, switchMapMaybe, switchMapMaybeDefault, switchMapMaybeLoadingContextStream, switchMapObject, switchMapOnBoolean, switchMapToDefault, switchMapWhileFalse, switchMapWhileTrue, takeAfterTimeElapsedSinceLastEmission, tapAfterTimeout, tapFirst, tapLog, tapOnLoadingStateSuccess, tapOnLoadingStateType, throwErrorAfterTimeout, throwErrorFromLoadingStateError, timeoutStartWith, toExpiration, useAsObservable, useFirst, valueFromFinishedLoadingState, valueFromLoadingState, valueFromObservableOrValue, valueFromObservableOrValueGetter, workFactory, workFactoryForConfigFactory };
+export { AssetLoader, DEFAULT_ASYNC_PUSHER_THROTTLE, DEFAULT_FACTORY_TIMER_INTERVAL, DEFAULT_ITEM_PAGE_ITERATOR_MAX, DEFAULT_LOADING_EVENT_FOR_LOADING_PAIR_FUNCTION, DEFAULT_LOCK_SET_TIME_LOCK_KEY, FilterMap, FilterMapKeyInstance, FilterSource, FilterSourceConnector, FilterSourceInstance, ItemPageIterationInstance, ItemPageIterator, LoadingStateType, LockSet, MultiSubscriptionObject, PresetFilterSource, SimpleLoadingContext, SubscriptionObject, ValuesLoadingContext, WorkInstance, accumulatorCurrentPageListLoadingState, accumulatorFlattenPageListLoadingState, areAllLoadingStatesFinishedLoading, arrayValueFromFinishedLoadingState, asObservable, asObservableFromGetter, assetFolder, assetLoaderAssetInstance, assetLoaderFromGetFn, asyncPusher, asyncPusherCache, beginLoading, beginLoadingPage, catchLoadingStateErrorWithOperator, checkIs, cleanup, cleanupDestroyable, combineFilters, combineLatestFromArrayObsFn, combineLatestFromMapValuesObsFn, combineLatestFromObject, combineLatestMapFrom, combineLoadingStates, combineLoadingStatesStatus, currentValueFromLoadingState, delegatedAssetLoader, distinctLoadingState, distinctUntilArrayLengthChanges, distinctUntilHasDifferentValues, distinctUntilItemsHaveDifferentValues, distinctUntilItemsValueChanges, distinctUntilKeysChange, distinctUntilMapHasDifferentKeys, distinctUntilModelIdChange, distinctUntilModelKeyChange, distinctUntilObjectKeyChange, distinctUntilObjectValuesChanged, emitAfterDelay, emitDelayObs, errorFromLoadingState, errorOnEmissionsInPeriod, errorPageResult, errorResult, factoryTimer, fetchAssetLoader, filterIfObjectValuesUnchanged, filterItemsWithObservableDecision, filterMaybe, filterMaybeArray, filterMaybeStrict, filterUnique, filterWithSearchString, flattenAccumulatorResultItemArray, idleLoadingState, incrementingNumberTimer, initialize, invertObservableDecision, isAnyLoadingStateInLoadingState, isItemPageIteratorResultEndResult, isListLoadingStateWithEmptyValue, isLoading, isLoadingStateEqual, isLoadingStateFinishedLoading, isLoadingStateFinishedLoadingWithDefinedValue, isLoadingStateFinishedLoadingWithError, isLoadingStateInErrorState, isLoadingStateInIdleState, isLoadingStateInLoadingState, isLoadingStateInSuccessState, isLoadingStateLoading, isLoadingStateMetadataEqual, isLoadingStateWithDefinedValue, isLoadingStateWithError, isLoadingStateWithStateType, isNot, isPageLoadingState, isPageLoadingStateMetadataEqual, itemAccumulator, itemAccumulatorNextPageUntilResultsCount, iterationHasNextAndCanLoadMore, iteratorNextPageUntilMaxPageLoadLimit, iteratorNextPageUntilPage, keyValueMap, lazyFrom, listLoadingStateContext, loadingStateContext, loadingStateFromObs, loadingStateHasNextPage, loadingStateType, loadingStateValue, loadingStateWithValueType, localAsset, makeCheckIsFunction, makeIsModifiedFunction, makeIsModifiedFunctionObservable, makeMapFilterWithPresetFn, makeReturnIfIsFunction, mapEachAsync, mapFilterWithPreset, mapForEach, mapIf, mapIsListLoadingStateWithEmptyValue, mapItemIteration, mapKeysIntersectionToArray, mapLoadingState, mapLoadingStateResults, mapLoadingStateValueFunction, mapLoadingStateValueWithOperator, mapMaybe, mappedPageItemIteration, maybeValueFromObservableOrValue, maybeValueFromObservableOrValueGetter, memoryAssetLoader, mergeFilters, mergeLoadingStateWithError, mergeLoadingStateWithLoading, mergeLoadingStateWithValue, mergeLoadingStates, mergeLoadingStatesArray, multiKeyValueMap, onFalseToTrue, onLockSetNextUnlock, onMatchDelta, onTrueToFalse, pageItemAccumulatorCurrentPage, pageLoadingStateFromObs, pipeIf, preventComplete, promiseFromLoadingState, randomDelay, randomDelayWithRandomFunction, remoteAsset, remoteAssetBaseUrl, returnIfIs, scanBuildArray, scanCount, scanIntoArray, setContainsAllValuesFrom, setContainsAnyValueFrom, setContainsNoValueFrom, skipAfterExpiration, skipAllInitialMaybe, skipExpired, skipInitialMaybe, skipMaybes, skipReplayedValues, skipUntilExpiration, skipUntilTimeElapsedAfterLastEmission, startWithBeginLoading, successPageResult, successResult, switchMapFilterMaybe, switchMapMaybe, switchMapMaybeDefault, switchMapMaybeLoadingContextStream, switchMapObject, switchMapOnBoolean, switchMapToDefault, switchMapWhileFalse, switchMapWhileTrue, takeAfterTimeElapsedSinceLastEmission, tapAfterTimeout, tapFirst, tapLog, tapOnLoadingStateSuccess, tapOnLoadingStateType, throwErrorAfterTimeout, throwErrorFromLoadingStateError, timeoutStartWith, toExpiration, useAsObservable, useFirst, valueFromFinishedLoadingState, valueFromLoadingState, valueFromObservableOrValue, valueFromObservableOrValueGetter, workFactory, workFactoryForConfigFactory };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dereekb/rxjs",
-  "version": "14.8.0",
+  "version": "14.10.0",
   "type": "module",
   "sideEffects": false,
   "peerDependencies": {
     "rxjs": "^7.8.2",
-    "@dereekb/util": "14.8.0"
+    "@dereekb/util": "14.10.0"
   },
   "exports": {
     "./package.json": "./package.json",

package/src/lib/filter/filter.d.ts

@@ -1,3 +1,4 @@
+import { type Maybe } from '@dereekb/util';
 import { type Observable } from 'rxjs';
 /**
  * Abstract base class for providing reactive filter state.
@@ -68,3 +69,29 @@ export declare abstract class FilterSourceConnector<F = unknown> {
      */
     abstract connectWithSource(filterSource: FilterSource<F>): void;
 }
+/**
+ * Converts a filter to and from a JSON-safe value, e.g. to save it to storage.
+ *
+ * Declare one alongside a filter type that has fields JSON cannot represent, such as Date or Set fields.
+ *
+ * @typeParam F - The filter type.
+ * @typeParam J - The JSON-safe value the filter is converted to.
+ *
+ * @example
+ * ```ts
+ * const MY_FILTER_JSON_CONVERTER: FilterJsonConverter<MyFilter, MyFilterJson> = {
+ *   toJson: (filter) => ({ ...filter, date: filter.date?.toISOString() }),
+ *   fromJson: (json) => ({ ...json, date: json.date ? new Date(json.date) : undefined })
+ * };
+ * ```
+ */
+export interface FilterJsonConverter<F, J = unknown> {
+    /**
+     * Converts the filter to a JSON-safe value.
+     */
+    readonly toJson: (filter: F) => J;
+    /**
+     * Converts a JSON value back to the filter. Returns null/undefined if the value is not a valid filter.
+     */
+    readonly fromJson: (json: J) => Maybe<F>;
+}

package/src/lib/filter/filter.map.d.ts

@@ -1,6 +1,7 @@
 import { type ObservableOrValue } from '../rxjs/getter';
 import { type Observable } from 'rxjs';
 import { type FilterSource, type FilterSourceConnector } from './filter';
+import { type MergeFiltersFunction } from './filter.merge';
 import { type Destroyable, type Maybe } from '@dereekb/util';
 /**
  * String key used to identify a specific filter entry within a {@link FilterMap}.
@@ -35,6 +36,44 @@ export declare class FilterMap<F> implements Destroyable {
      * @returns Observable that emits the current filter value for the key.
      */
     filterForKey(key: FilterMapKey): Observable<F>;
+    /**
+     * Returns an observable of the filters for all the given keys merged into a single filter.
+     *
+     * Lets several filter controls each own a separate key, so one control saving its filter never overwrites the fields set by another.
+     * Keys later in the array win when two keys set the same field. The `preset` field is removed from the merged result.
+     *
+     * Every key must have a value (for example, a default added with {@link addDefaultFilterObs}) before the merged filter emits.
+     *
+     * @param keys - Filter map keys to merge, in priority order.
+     * @param mergeFn - Function used to merge the filters. Defaults to {@link mergeFilters}.
+     * @returns Observable that emits the merged filter whenever any of the keys' filters change.
+     *
+     * @example
+     * ```ts
+     * filterMap.addDefaultFilterObs('date', of({}));
+     * filterMap.addDefaultFilterObs('attributes', of({}));
+     *
+     * filterMap.mergedFilterForKeys(['date', 'attributes']).subscribe((filter) => console.log(filter));
+     * ```
+     */
+    mergedFilterForKeys(keys: FilterMapKey[], mergeFn?: MergeFiltersFunction<F>): Observable<F>;
+    /**
+     * Sets the filter for the given key.
+     *
+     * The filter becomes the key's value the same way an emission from one of the key's filter observables would,
+     * and stays the key's value until one of those observables emits a new filter.
+     *
+     * Use to update a key from outside its filter controls, e.g. a "Clear" button that resets the key.
+     *
+     * @param key - Filter map key.
+     * @param filter - Filter to set.
+     *
+     * @example
+     * ```ts
+     * filterMap.setFilterForKey('users', { active: true });
+     * ```
+     */
+    setFilterForKey(key: FilterMapKey, filter: F): void;
     /**
      * Sets a default filter observable for the given key, used as a fallback when no explicit filter is set.
      *

package/src/lib/filter/filter.merge.d.ts

@@ -0,0 +1,43 @@
+import { type Maybe } from '@dereekb/util';
+import { type Observable } from 'rxjs';
+/**
+ * Function that merges several partial filters into a single filter.
+ *
+ * Filters are applied left-to-right, so the last filter in the array has the highest priority.
+ */
+export type MergeFiltersFunction<F> = (filters: Maybe<Partial<F>>[]) => F;
+/**
+ * Merges several partial filters into a single filter.
+ *
+ * Filters are applied left-to-right, so the last filter wins when two filters set the same field.
+ * `undefined` values never overwrite a previously set value.
+ *
+ * The `preset` field is removed from the result, since a merged filter cannot represent more than one preset.
+ * Each source filter keeps its own preset, so any preset menu bound to a single source still shows its selection.
+ *
+ * @param filters - Partial filters (or null/undefined) to merge.
+ * @returns The merged filter, without a `preset` value.
+ *
+ * @example
+ * ```ts
+ * mergeFilters([{ date, preset: 'today' }, { minPrice: 100 }]);
+ * // { date, minPrice: 100 }
+ * ```
+ */
+export declare function mergeFilters<F extends object>(filters: Maybe<Partial<F>>[]): F;
+/**
+ * Combines the latest value of each filter observable into a single merged filter observable.
+ *
+ * Emits once every input has emitted, then again whenever any input emits a new value.
+ * Consecutive emissions with equal values are suppressed.
+ *
+ * @param filterObs - Filter observables to combine. Every observable must emit at least once for the result to emit.
+ * @param mergeFn - Function used to merge the latest filters. Defaults to {@link mergeFilters}.
+ * @returns Observable of the merged filter.
+ *
+ * @example
+ * ```ts
+ * const filter$ = combineFilters([dateFilter$, attributesFilter$]);
+ * ```
+ */
+export declare function combineFilters<F extends object>(filterObs: Observable<Maybe<Partial<F>>>[], mergeFn?: MergeFiltersFunction<F>): Observable<F>;

package/src/lib/filter/index.d.ts

@@ -1,4 +1,5 @@
 export * from './filter.map';
+export * from './filter.merge';
 export * from './filter.preset';
 export * from './filter.source';
 export * from './filter';

package/src/lib/rxjs/rxjs.d.ts

@@ -1,5 +1,5 @@
 import { type Getter, type Maybe } from '@dereekb/util';
-import { type Observable, type MonoTypeOperatorFunction } from 'rxjs';
+import { Observable, type MonoTypeOperatorFunction } from 'rxjs';
 /**
  * Combines `startWith` and {@link tapFirst} to initialize an observable pipe with a side-effect on the first emission.
  *
@@ -19,6 +19,21 @@ export declare function initialize<T>(tap: (value: Maybe<T>) => void, initial?:
  * @returns An operator that taps the first value.
  */
 export declare function tapFirst<T>(tap: (value: T) => void, skipFirst?: boolean): MonoTypeOperatorFunction<T>;
+/**
+ * RxJS operator that ignores the values the source emits synchronously while it is being subscribed to, such as the
+ * current value of a BehaviorSubject or the latest value replayed by `shareReplay()`. Only values emitted afterwards pass through.
+ *
+ * @returns Operator that skips the values replayed on subscription.
+ *
+ * @example
+ * ```ts
+ * const value = new BehaviorSubject(1);
+ * value.pipe(skipReplayedValues()).subscribe(console.log);
+ * value.next(2);
+ * // Output: 2
+ * ```
+ */
+export declare function skipReplayedValues<T>(): MonoTypeOperatorFunction<T>;
 /**
  * Wraps an observable so that it never emits `complete` until it is unsubscribed.
  *