@sv443-network/userutils 6.1.0 → 6.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @sv443-network/userutils
 
+## 6.2.0
+
+### Minor Changes
+
+- 0173235: Add property to change the debounce edge in `SelectorObserver` instances
+
 ## 6.1.0
 
 ### Minor Changes

package/dist/index.global.js

@@ -8,7 +8,7 @@
 // ==UserLibrary==
 // @name         UserUtils
 // @description  Library with various utilities for userscripts - register listeners for when CSS selectors exist, intercept events, manage persistent user configurations, modify the DOM more easily and more
-// @version      6.1.0
+// @version      6.2.0
 // @license      MIT
 // @copyright    Sv443 (https://github.com/Sv443)
 
@@ -512,10 +512,12 @@ var UserUtils = (function (exports) {
       this.observer = new MutationObserver(() => this.checkAllSelectors());
       const _a = options, {
         defaultDebounce,
+        defaultDebounceEdge,
         disableOnNoListeners,
         enableOnAddListener
       } = _a, observerOptions = __objRest(_a, [
         "defaultDebounce",
+        "defaultDebounceEdge",
         "disableOnNoListeners",
         "enableOnAddListener"
       ]);
@@ -525,6 +527,7 @@ var UserUtils = (function (exports) {
       }, observerOptions);
       this.customOptions = {
         defaultDebounce: defaultDebounce != null ? defaultDebounce : 0,
+        defaultDebounceEdge: defaultDebounceEdge != null ? defaultDebounceEdge : "rising",
         disableOnNoListeners: disableOnNoListeners != null ? disableOnNoListeners : false,
         enableOnAddListener: enableOnAddListener != null ? enableOnAddListener : true
       };
@@ -564,12 +567,8 @@ var UserUtils = (function (exports) {
           this.disable();
       }
     }
-    debounce(func, time) {
-      let timeout;
-      return function(...args) {
-        clearTimeout(timeout);
-        timeout = setTimeout(() => func.apply(this, args), time);
-      };
+    debounce(func, time, edge = "falling") {
+      return debounce(func, time, edge);
     }
     /**
      * Starts observing the children of the base element for changes to the given {@linkcode selector} according to the set {@linkcode options}
@@ -585,7 +584,8 @@ var UserUtils = (function (exports) {
       if (options.debounce && options.debounce > 0 || this.customOptions.defaultDebounce && this.customOptions.defaultDebounce > 0) {
         options.listener = this.debounce(
           options.listener,
-          options.debounce || this.customOptions.defaultDebounce
+          options.debounce || this.customOptions.defaultDebounce,
+          options.debounceEdge || this.customOptions.defaultDebounceEdge
         );
       }
       if (this.listenerMap.has(selector))

package/dist/index.js

@@ -492,10 +492,12 @@ var SelectorObserver = class {
     this.observer = new MutationObserver(() => this.checkAllSelectors());
     const _a = options, {
       defaultDebounce,
+      defaultDebounceEdge,
       disableOnNoListeners,
       enableOnAddListener
     } = _a, observerOptions = __objRest(_a, [
       "defaultDebounce",
+      "defaultDebounceEdge",
       "disableOnNoListeners",
       "enableOnAddListener"
     ]);
@@ -505,6 +507,7 @@ var SelectorObserver = class {
     }, observerOptions);
     this.customOptions = {
       defaultDebounce: defaultDebounce != null ? defaultDebounce : 0,
+      defaultDebounceEdge: defaultDebounceEdge != null ? defaultDebounceEdge : "rising",
       disableOnNoListeners: disableOnNoListeners != null ? disableOnNoListeners : false,
       enableOnAddListener: enableOnAddListener != null ? enableOnAddListener : true
     };
@@ -544,12 +547,8 @@ var SelectorObserver = class {
         this.disable();
     }
   }
-  debounce(func, time) {
-    let timeout;
-    return function(...args) {
-      clearTimeout(timeout);
-      timeout = setTimeout(() => func.apply(this, args), time);
-    };
+  debounce(func, time, edge = "falling") {
+    return debounce(func, time, edge);
   }
   /**
    * Starts observing the children of the base element for changes to the given {@linkcode selector} according to the set {@linkcode options}
@@ -565,7 +564,8 @@ var SelectorObserver = class {
     if (options.debounce && options.debounce > 0 || this.customOptions.defaultDebounce && this.customOptions.defaultDebounce > 0) {
       options.listener = this.debounce(
         options.listener,
-        options.debounce || this.customOptions.defaultDebounce
+        options.debounce || this.customOptions.defaultDebounce,
+        options.debounceEdge || this.customOptions.defaultDebounceEdge
       );
     }
     if (this.listenerMap.has(selector))

package/dist/index.mjs

@@ -490,10 +490,12 @@ var SelectorObserver = class {
     this.observer = new MutationObserver(() => this.checkAllSelectors());
     const _a = options, {
       defaultDebounce,
+      defaultDebounceEdge,
       disableOnNoListeners,
       enableOnAddListener
     } = _a, observerOptions = __objRest(_a, [
       "defaultDebounce",
+      "defaultDebounceEdge",
       "disableOnNoListeners",
       "enableOnAddListener"
     ]);
@@ -503,6 +505,7 @@ var SelectorObserver = class {
     }, observerOptions);
     this.customOptions = {
       defaultDebounce: defaultDebounce != null ? defaultDebounce : 0,
+      defaultDebounceEdge: defaultDebounceEdge != null ? defaultDebounceEdge : "rising",
       disableOnNoListeners: disableOnNoListeners != null ? disableOnNoListeners : false,
       enableOnAddListener: enableOnAddListener != null ? enableOnAddListener : true
     };
@@ -542,12 +545,8 @@ var SelectorObserver = class {
         this.disable();
     }
   }
-  debounce(func, time) {
-    let timeout;
-    return function(...args) {
-      clearTimeout(timeout);
-      timeout = setTimeout(() => func.apply(this, args), time);
-    };
+  debounce(func, time, edge = "falling") {
+    return debounce(func, time, edge);
   }
   /**
    * Starts observing the children of the base element for changes to the given {@linkcode selector} according to the set {@linkcode options}
@@ -563,7 +562,8 @@ var SelectorObserver = class {
     if (options.debounce && options.debounce > 0 || this.customOptions.defaultDebounce && this.customOptions.defaultDebounce > 0) {
       options.listener = this.debounce(
         options.listener,
-        options.debounce || this.customOptions.defaultDebounce
+        options.debounce || this.customOptions.defaultDebounce,
+        options.debounceEdge || this.customOptions.defaultDebounceEdge
       );
     }
     if (this.listenerMap.has(selector))

package/dist/lib/SelectorObserver.d.ts

@@ -17,10 +17,17 @@ type SelectorOptionsCommon = {
     continuous?: boolean;
     /** Whether to debounce the listener to reduce calls to `querySelector` or `querySelectorAll` - set undefined or <=0 to disable (default) */
     debounce?: number;
+    /** Whether to call the function at the very first call ("rising" edge) or the very last call ("falling" edge, default) */
+    debounceEdge?: "rising" | "falling";
 };
 export type SelectorObserverOptions = {
     /** If set, applies this debounce in milliseconds to all listeners that don't have their own debounce set */
     defaultDebounce?: number;
+    /**
+     * If set, applies this debounce edge to all listeners that don't have their own set.
+     * Edge = Whether to call the function at the very first call ("rising" edge) or the very last call ("falling" edge, default)
+     */
+    defaultDebounceEdge?: "rising" | "falling";
     /** Whether to disable the observer when no listeners are present - default is true */
     disableOnNoListeners?: boolean;
     /** Whether to ensure the observer is enabled when a new listener is added - default is true */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sv443-network/userutils",
   "libName": "UserUtils",
-  "version": "6.1.0",
+  "version": "6.2.0",
   "description": "Library with various utilities for userscripts - register listeners for when CSS selectors exist, intercept events, manage persistent user configurations, modify the DOM more easily and more",
   "main": "dist/index.js",
   "module": "dist/index.mjs",