@sv443-network/userutils 5.0.1 → 6.0.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @sv443-network/userutils
 
+## 6.0.1
+
+### Patch Changes
+
+- 08248c1: Fixed terminology in JSDoc comments of the `DataStore` class
+
+## 6.0.0
+
+### Major Changes
+
+- e921593: Renamed `ConfigManager` to `DataStore` to make its implied purpose as a generic JSON database more clear.
+  - the constructor property `defaultConfig` is now called `defaultData`
+  - `deleteConfig()` is now called `deleteData()`
+  - the internal GM storage keys will still have the prefix `_uucfg` for backwards compatibility
+
+### Minor Changes
+
+- da679c6: Added function `getSiblingsFrame()` that returns a frame of an element's siblings, with a given alignment and size
+
+### Patch Changes
+
+- 0c716a6: Lowered the `Error.stackTraceLimit` by a multiple of 10 to preserve memory
+
 ## 5.0.1
 
 ### Patch Changes

package/README.md

@@ -8,9 +8,12 @@ Contains builtin TypeScript declarations. Fully web compatible and supports ESM
 If you like using this library, please consider [supporting the development ❤️](https://github.com/sponsors/Sv443)
 
 <br>
+<sup>
+View the documentation of previous major releases:
+</sup>
 <sub>
 
-View the documentation of previous major releases: [4.2.1](https://github.com/Sv443-Network/UserUtils/blob/v4.2.1/README.md), [3.0.0](https://github.com/Sv443-Network/UserUtils/blob/v3.0.0/README.md), [2.0.1](https://github.com/Sv443-Network/UserUtils/blob/v2.0.1/README.md), [1.2.0](https://github.com/Sv443-Network/UserUtils/blob/v1.2.0/README.md), [0.5.3](https://github.com/Sv443-Network/UserUtils/blob/v0.5.3/README.md)
+<a href="https://github.com/Sv443-Network/UserUtils/blob/v5.0.1/README.md" rel="noopener noreferrer">5.0.1</a>, <a href="https://github.com/Sv443-Network/UserUtils/blob/v4.2.1/README.md" rel="noopener noreferrer">4.2.1</a>, <a href="https://github.com/Sv443-Network/UserUtils/blob/v3.0.0/README.md" rel="noopener noreferrer">3.0.0</a>, <a href="https://github.com/Sv443-Network/UserUtils/blob/v2.0.1/README.md" rel="noopener noreferrer">2.0.1</a>, <a href="https://github.com/Sv443-Network/UserUtils/blob/v1.2.0/README.md" rel="noopener noreferrer">1.2.0</a>, <a href="https://github.com/Sv443-Network/UserUtils/blob/v0.5.3/README.md" rel="noopener noreferrer">0.5.3</a>
 
 </sub>
 </div>
@@ -34,13 +37,14 @@ View the documentation of previous major releases: [4.2.1](https://github.com/Sv
     - [interceptWindowEvent()](#interceptwindowevent) - conditionally intercepts events registered by `addEventListener()` on the window object
     - [isScrollable()](#isscrollable) - check if an element has a horizontal or vertical scroll bar
     - [observeElementProp()](#observeelementprop) - observe changes to an element's property that can't be observed with MutationObserver
+    - [getSiblingsFrame()](#getsiblingsframe) - returns a frame of an element's siblings, with a given alignment and size
   - [**Math:**](#math)
     - [clamp()](#clamp) - constrain a number between a min and max value
     - [mapRange()](#maprange) - map a number from one range to the same spot in another range
     - [randRange()](#randrange) - generate a random number between a min and max boundary
     - [randomId()](#randomid) - generate a random ID of a given length and radix
   - [**Misc:**](#misc)
-    - [ConfigManager](#configmanager) - class that manages persistent userscript configurations, including data migration
+    - [DataStore](#datastore) - class that manages a sync & async persistent JSON database, including data migration
     - [autoPlural()](#autoplural) - automatically pluralize a string
     - [pauseFor()](#pausefor) - pause the execution of a function for a given amount of time
     - [debounce()](#debounce) - call a function only once, after a given amount of time
@@ -604,7 +608,7 @@ interceptEvent(
   
 Intercepts all events dispatched on the `eventObject` and prevents the listeners from being called as long as the predicate function returns a truthy value.  
 If no predicate is specified, all events will be discarded.  
-Calling this function will set the `Error.stackTraceLimit` to 1000 (if it's not already higher) to ensure the stack trace is preserved.  
+Calling this function will set the `Error.stackTraceLimit` to 100 (if it's not already higher) to ensure the stack trace is preserved.  
   
 ⚠️ This function should be called as soon as possible (I recommend using `@run-at document-start`), as it will only intercept events that are *attached* after this function is called.  
   
@@ -733,6 +737,129 @@ observeElementProp(myInput, "value", (oldValue, newValue) => {
 
 </details>
 
+<br>
+
+### getSiblingsFrame()
+Usage:  
+```ts
+getSiblingsFrame<
+  TSiblingType extends Element = HTMLElement
+>(
+  refElement: Element,
+  siblingAmount: number,
+  refElementAlignment: "center-top" | "center-bottom" | "top" | "bottom" = "center-top",
+  includeRef = true
+): TSiblingType[]
+```
+Returns a "frame" of the closest siblings of the reference element, based on the passed amount of siblings and element alignment.  
+The returned type is an array of `HTMLElement` by default but can be changed by specifying the `TSiblingType` generic in TypeScript.  
+  
+These are the parameters:
+- The `refElement` parameter is the reference element to return the relative closest siblings from.
+- The `siblingAmount` parameter is the amount of siblings to return in total (including or excluding the `refElement` based on the `includeRef` parameter).
+- The `refElementAlignment` parameter can be set to `center-top` (default), `center-bottom`, `top`, or `bottom`, which will determine where the relative location of the provided `refElement` is in the returned array.  
+  `center-top` (default) will try to keep the `refElement` in the center of the returned array, but can shift around by one element. In those cases it will prefer the top spot.  
+  Same goes for `center-bottom` in reverse.  
+  `top` will keep the `refElement` at the top of the returned array, and `bottom` will keep it at the bottom.
+- If `includeRef` is set to `true` (default), the provided `refElement` will be included in the returned array at its corresponding position.
+  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+import { getSiblingsFrame } from "@sv443-network/userutils";
+
+const refElement = document.querySelector("#ref");
+// ^ structure of the elements:
+// <div id="parent">
+//     <div>1</div>
+//     <div>2</div>
+//     <div id="ref">3</div>
+//     <div>4</div>
+//     <div>5</div>
+//     <div>6</div>
+// </div>
+
+// ref element aligned to the top of the frame's center positions and included in the result:
+const siblingsFoo = getSiblingsFrame(refElement, 4, "center-top", true);
+// <div>1</div>
+// <div>2</div>        ◄──┐
+// <div id="ref">3</div>  │ returned         <(ref is here because refElementAlignment = "center-top")
+// <div>4</div>           │ frame
+// <div>5</div>        ◄──┘
+// <div>6</div>
+
+// ref element aligned to the bottom of the frame's center positions and included in the result:
+const siblingsBar = getSiblingsFrame(refElement, 4, "center-bottom", true);
+// <div>1</div>        ◄──┐
+// <div>2</div>           │ returned
+// <div id="ref">3</div>  │ frame            <(ref is here because refElementAlignment = "center-bottom")
+// <div>4</div>        ◄──┘
+// <div>5</div>
+// <div>6</div>
+
+// ref element aligned to the bottom of the frame's center positions, but excluded from the result:
+const siblingsBaz = getSiblingsFrame(refElement, 3, "center-bottom", false);
+// <div>1</div>        ◄──┐
+// <div>2</div>        ◄──┘ returned...
+// <div id="ref">3</div>                     <(skipped because includeRef = false)
+// <div>4</div>        ◄─── ...frame
+// <div>5</div>
+// <div>6</div>
+
+// ref element aligned to the top of the frame, but excluded from the result:
+const siblingsQux = getSiblingsFrame(refElement, 3, "top", false);
+// <div>1</div>
+// <div>2</div>
+// <div id="ref">3</div>                     <(skipped because includeRef = false)
+// <div>4</div>        ◄──┐ returned
+// <div>5</div>           │ frame
+// <div>6</div>        ◄──┘
+
+// ref element aligned to the top of the frame, but this time included in the result:
+const siblingsQuux = getSiblingsFrame(refElement, 3, "top", true);
+// <div>1</div>
+// <div>2</div>
+// <div id="ref">3</div>  ◄──┐ returned      <(not skipped because includeRef = true)
+// <div>4</div>              │ frame
+// <div>5</div>           ◄──┘
+// <div>6</div>
+```
+
+More useful examples:
+
+```ts
+const refElement = document.querySelector("#ref");
+// ^ structure of the elements:
+// <div id="parent">
+//     <div>1</div>
+//     <div>2</div>
+//     <div id="ref">3</div>
+//     <div>4</div>
+//     <div>5</div>
+//     <div>6</div>
+// </div>
+
+// get all elements above and include the reference element:
+const allAbove = getSiblingsFrame(refElement, Infinity, "top", true);
+// <div>1</div>          ◄──┐ returned
+// <div>2</div>             │ frame
+// <div id="ref">3</div> ◄──┘
+// <div>4</div>
+// <div>5</div>
+// <div>6</div>
+
+// get all elements below and exclude the reference element:
+const allBelowExcl = getSiblingsFrame(refElement, Infinity, "bottom", false);
+// <div>1</div>
+// <div>2</div>
+// <div id="ref">3</div>
+// <div>4</div>          ◄──┐ returned
+// <div>5</div>             │ frame
+// <div>6</div>          ◄──┘
+```
+
+</details>
+
 <br><br>
 
 <!-- #SECTION Math -->
@@ -853,26 +980,26 @@ randomId(10, 36); // "z46jfpa37r"       (length 10, radix 36)
 <!-- #SECTION Misc -->
 ## Misc:
 
-### ConfigManager
+### DataStore
 Usage:  
 ```ts
-new ConfigManager(options: ConfigManagerOptions)
+new DataStore(options: DataStoreOptions)
 ```
   
-A class that manages a userscript's configuration that is persistently saved to and loaded from GM storage.  
+A class that manages a sync & async JSON database that is persistently saved to and loaded from GM storage.  
 Also supports automatic migration of outdated data formats via provided migration functions.  
 You may create as many instances as you like as long as they have different IDs.  
   
-⚠️ The configuration is stored as a JSON string, so only JSON-compatible data can be used. Circular structures and complex objects will throw an error on load and save.  
+⚠️ The data is stored as a JSON string, so only JSON-compatible data can be used. Circular structures and complex objects will throw an error on load and save.  
 ⚠️ The directives `@grant GM.getValue` and `@grant GM.setValue` are required for this to work.  
   
 The options object has the following properties:
 | Property | Description |
 | :-- | :-- |
-| `id` | A unique internal identification string for this configuration. If two ConfigManagers share the same ID, they will overwrite each other's data. Choose wisely because if it is changed, the previously saved data will not be able to be loaded anymore. |
-| `defaultConfig` | The default config data to use if no data is saved in persistent storage yet. Until the data is loaded from persistent storage, this will be the data returned by `getData()`. For TypeScript, the type of the data passed here is what will be used for all other methods of the instance. |
+| `id` | A unique internal identification string for this instance. If two DataStores share the same ID, they will overwrite each other's data. Choose wisely because if it is changed, the previously saved data will not be able to be loaded anymore. |
+| `defaultData` | The default data to use if no data is saved in persistent storage yet. Until the data is loaded from persistent storage, this will be the data returned by `getData()`. For TypeScript, the type of the data passed here is what will be used for all other methods of the instance. |
 | `formatVersion` | An incremental version of the data format. If the format of the data is changed in any way, this number should be incremented, in which case all necessary functions of the migrations dictionary will be run consecutively. Never decrement this number or skip numbers. |
-| `migrations?` | (Optional) A dictionary of functions that can be used to migrate data from older versions of the configuration to newer ones. The keys of the dictionary should be the format version that the functions can migrate to, from the previous whole integer value. The values should be functions that take the data in the old format and return the data in the new format. The functions will be run in order from the oldest to the newest version. If the current format version is not in the dictionary, no migrations will be run. |
+| `migrations?` | (Optional) A dictionary of functions that can be used to migrate data from older versions of the data to newer ones. The keys of the dictionary should be the format version that the functions can migrate to, from the previous whole integer value. The values should be functions that take the data in the old format and return the data in the new format. The functions will be run in order from the oldest to the newest version. If the current format version is not in the dictionary, no migrations will be run. |
 | `encodeData?` | (Optional, but required when decodeData is set) Function that encodes the data before saving - you can use [compress()](#compress) here to save space at the cost of a little bit of performance |
 | `decodeData?` | (Optional, but required when encodeData is set) Function that decodes the data when loading - you can use [decompress()](#decompress) here to decode data that was previously compressed with [compress()](#compress) |
 
@@ -880,24 +1007,24 @@ The options object has the following properties:
 
 #### Methods:
 `loadData(): Promise<TData>`  
-Asynchronously loads the configuration data from persistent storage and returns it.  
-If no data was saved in persistent storage before, the value of `options.defaultConfig` will be returned and written to persistent storage.  
+Asynchronously loads the data from persistent storage and returns it.  
+If no data was saved in persistent storage before, the value of `options.defaultData` will be returned and written to persistent storage.  
 If the formatVersion of the saved data is lower than the current one and the `options.migrations` property is present, the data will be migrated to the latest format before the Promise resolves.  
   
 `getData(): TData`  
 Synchronously returns the current data that is stored in the internal cache.  
-If no data was loaded from persistent storage yet using `loadData()`, the value of `options.defaultConfig` will be returned.  
+If no data was loaded from persistent storage yet using `loadData()`, the value of `options.defaultData` will be returned.  
   
 `setData(data: TData): Promise<void>`  
 Writes the given data synchronously to the internal cache and asynchronously to persistent storage.  
   
 `saveDefaultData(): Promise<void>`  
-Writes the default configuration given in `options.defaultConfig` synchronously to the internal cache and asynchronously to persistent storage.  
+Writes the default data given in `options.defaultData` synchronously to the internal cache and asynchronously to persistent storage.  
   
-`deleteConfig(): Promise<void>`  
-Fully deletes the configuration from persistent storage.  
+`deleteData(): Promise<void>`  
+Fully deletes the data from persistent storage.  
 The internal cache will be left untouched, so any subsequent calls to `getData()` will return the data that was last loaded.  
-If `loadData()` or `setData()` are called after this, the persistent storage will be populated with the value of `options.defaultConfig` again.  
+If `loadData()` or `setData()` are called after this, the persistent storage will be populated with the value of `options.defaultData` again.  
 ⚠️ If you want to use this method, the additional directive `@grant GM.deleteValue` is required.  
 
 <br>
@@ -905,8 +1032,9 @@ If `loadData()` or `setData()` are called after this, the persistent storage wil
 <details><summary><b>Example - click to view</b></summary>
 
 ```ts
-import { ConfigManager, compress, decompress } from "@sv443-network/userutils";
+import { DataStore, compress, decompress } from "@sv443-network/userutils";
 
+/** Example: Userscript configuration data */
 interface MyConfig {
   foo: string;
   bar: number;
@@ -914,8 +1042,8 @@ interface MyConfig {
   qux: string;
 }
 
-/** Default config data */
-const defaultConfig: MyConfig = {
+/** Default data */
+const defaultData: MyConfig = {
   foo: "hello",
   bar: 42,
   baz: "xyz",
@@ -946,12 +1074,12 @@ const migrations = {
   },
 };
 
-const manager = new ConfigManager({
-  /** A unique ID for this configuration - choose wisely as changing it is not supported yet! */
-  id: "my-userscript",
-  /** Default / fallback configuration data */
-  defaultConfig,
-  /** The current version of the script's config data format */
+const manager = new DataStore({
+  /** A unique ID for this instance - choose wisely as changing it is not supported yet! */
+  id: "my-userscript-config",
+  /** Default / fallback data */
+  defaultData,
+  /** The current version of the data format */
   formatVersion,
   /** Data format migration functions */
   migrations,
@@ -959,29 +1087,30 @@ const manager = new ConfigManager({
   // Compression example:
   // Adding this will save space at the cost of a little bit of performance while initially loading and saving the data
   // Only both of these properties or none of them should be set
-  // Everything else will be handled by the ConfigManager instance
-  /** Encode data using the "deflate-raw" algorithm and digests it as a base64 string */
+  // Everything else will be handled by the DataStore instance
+
+  /** Encodes data using the "deflate-raw" algorithm and digests it as a base64 string */
   encodeData: (data) => compress(data, "deflate-raw", "base64"),
-  /** Decode the "deflate-raw" encoded data as a base64 string */
+  /** Decodes the "deflate-raw" encoded data as a base64 string */
   decodeData: (data) => decompress(data, "deflate-raw", "base64"),
 });
 
 /** Entrypoint of the userscript */
 async function init() {
-  // wait for the config to be loaded from persistent storage
-  // if no data was saved in persistent storage before or getData() is called before loadData(), the value of options.defaultConfig will be returned
+  // wait for the data to be loaded from persistent storage
+  // if no data was saved in persistent storage before or getData() is called before loadData(), the value of options.defaultData will be returned
   // if the previously saved data needs to be migrated to a newer version, it will happen in this function call
   const configData = await manager.loadData();
 
   console.log(configData.foo); // "hello"
 
-  // update the config
+  // update the data
   configData.foo = "world";
   configData.bar = 123;
 
-  // save the updated config - synchronously to the cache and asynchronously to persistent storage
+  // save the updated data - synchronously to the cache and asynchronously to persistent storage
   manager.saveData(configData).then(() => {
-    console.log("Config saved to persistent storage!");
+    console.log("Data saved to persistent storage!");
   });
 
   // the internal cache is updated synchronously, so the updated data can be accessed before the Promise resolves:

package/dist/index.global.js

@@ -3,13 +3,12 @@
 // @exclude      *
 // @author       Sv443
 // @supportURL   https://github.com/Sv443-Network/UserUtils/issues
-// @homepageURL  https://github.com/Sv443-Network/UserUtils#readme
-// @supportURL   https://github.com/Sv443-Network/UserUtils/issues
+// @homepageURL  https://github.com/Sv443-Network/UserUtils
 
 // ==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      5.0.1
+// @version      6.0.1
 // @license      MIT
 // @copyright    Sv443 (https://github.com/Sv443)
 
@@ -137,30 +136,30 @@ var UserUtils = (function (exports) {
     return retArray;
   }
 
-  // lib/ConfigManager.ts
-  var ConfigManager = class {
+  // lib/DataStore.ts
+  var DataStore = class {
     /**
-     * Creates an instance of ConfigManager to manage a user configuration that is cached in memory and persistently saved across sessions.  
-     * Supports migrating data from older versions of the configuration to newer ones and populating the cache with default data if no persistent data is found.  
+     * Creates an instance of DataStore to manage a sync & async database that is cached in memory and persistently saved across sessions.  
+     * Supports migrating data from older versions to newer ones and populating the cache with default data if no persistent data is found.  
      *   
      * ⚠️ Requires the directives `@grant GM.getValue` and `@grant GM.setValue`  
-     * ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultConfig`
+     * ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultData`
      * 
-     * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `config.defaultConfig`) - this should also be the type of the data format associated with the current `options.formatVersion`
-     * @param options The options for this ConfigManager instance
+     * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `options.defaultData`) - this should also be the type of the data format associated with the current `options.formatVersion`
+     * @param options The options for this DataStore instance
     */
     constructor(options) {
       __publicField(this, "id");
       __publicField(this, "formatVersion");
-      __publicField(this, "defaultConfig");
+      __publicField(this, "defaultData");
       __publicField(this, "cachedData");
       __publicField(this, "migrations");
       __publicField(this, "encodeData");
       __publicField(this, "decodeData");
       this.id = options.id;
       this.formatVersion = options.formatVersion;
-      this.defaultConfig = options.defaultConfig;
-      this.cachedData = options.defaultConfig;
+      this.defaultData = options.defaultData;
+      this.cachedData = options.defaultData;
       this.migrations = options.migrations;
       this.encodeData = options.encodeData;
       this.decodeData = options.decodeData;
@@ -173,11 +172,11 @@ var UserUtils = (function (exports) {
     loadData() {
       return __async(this, null, function* () {
         try {
-          const gmData = yield GM.getValue(`_uucfg-${this.id}`, this.defaultConfig);
+          const gmData = yield GM.getValue(`_uucfg-${this.id}`, this.defaultData);
           let gmFmtVer = Number(yield GM.getValue(`_uucfgver-${this.id}`));
           if (typeof gmData !== "string") {
             yield this.saveDefaultData();
-            return __spreadValues({}, this.defaultConfig);
+            return __spreadValues({}, this.defaultData);
           }
           const isEncoded = yield GM.getValue(`_uucfgenc-${this.id}`, false);
           if (isNaN(gmFmtVer))
@@ -187,9 +186,9 @@ var UserUtils = (function (exports) {
             parsed = yield this.runMigrations(parsed, gmFmtVer);
           return __spreadValues({}, this.cachedData = parsed);
         } catch (err) {
-          console.warn("Error while loading config data, resetting it to the default value.", err);
+          console.warn("Error while parsing JSON data, resetting it to the default value.", err);
           yield this.saveDefaultData();
-          return this.defaultConfig;
+          return this.defaultData;
         }
       });
     }
@@ -213,14 +212,14 @@ var UserUtils = (function (exports) {
         resolve();
       }));
     }
-    /** Saves the default configuration data passed in the constructor synchronously to the in-memory cache and asynchronously to persistent storage */
+    /** Saves the default data passed in the constructor synchronously to the in-memory cache and asynchronously to persistent storage */
     saveDefaultData() {
       return __async(this, null, function* () {
-        this.cachedData = this.defaultConfig;
+        this.cachedData = this.defaultData;
         const useEncoding = Boolean(this.encodeData && this.decodeData);
         return new Promise((resolve) => __async(this, null, function* () {
           yield Promise.all([
-            GM.setValue(`_uucfg-${this.id}`, yield this.serializeData(this.defaultConfig, useEncoding)),
+            GM.setValue(`_uucfg-${this.id}`, yield this.serializeData(this.defaultData, useEncoding)),
             GM.setValue(`_uucfgver-${this.id}`, this.formatVersion),
             GM.setValue(`_uucfgenc-${this.id}`, useEncoding)
           ]);
@@ -229,13 +228,13 @@ var UserUtils = (function (exports) {
       });
     }
     /**
-     * Call this method to clear all persistently stored data associated with this ConfigManager instance.  
+     * Call this method to clear all persistently stored data associated with this DataStore instance.  
      * The in-memory cache will be left untouched, so you may still access the data with {@linkcode getData()}  
      * Calling {@linkcode loadData()} or {@linkcode setData()} after this method was called will recreate persistent storage with the cached or default data.  
      *   
      * ⚠️ This requires the additional directive `@grant GM.deleteValue`
      */
-    deleteConfig() {
+    deleteData() {
       return __async(this, null, function* () {
         yield Promise.all([
           GM.deleteValue(`_uucfg-${this.id}`),
@@ -351,9 +350,9 @@ var UserUtils = (function (exports) {
     setTimeout(openElem.remove, 50);
   }
   function interceptEvent(eventObject, eventName, predicate = () => true) {
-    if (typeof Error.stackTraceLimit === "number" && Error.stackTraceLimit < 1e3) {
-      Error.stackTraceLimit = 1e3;
-    }
+    Error.stackTraceLimit = Math.max(Error.stackTraceLimit, 100);
+    if (isNaN(Error.stackTraceLimit))
+      Error.stackTraceLimit = 100;
     (function(original) {
       eventObject.__proto__.addEventListener = function(...args) {
         var _a, _b;
@@ -400,6 +399,27 @@ var UserUtils = (function (exports) {
       });
     }
   }
+  function getSiblingsFrame(refElement, siblingAmount, refElementAlignment = "center-top", includeRef = true) {
+    var _a, _b;
+    const siblings = [...(_b = (_a = refElement.parentNode) == null ? void 0 : _a.childNodes) != null ? _b : []];
+    const elemSiblIdx = siblings.indexOf(refElement);
+    if (elemSiblIdx === -1)
+      throw new Error("Element doesn't have a parent node");
+    if (refElementAlignment === "top")
+      return [...siblings.slice(elemSiblIdx + Number(!includeRef), elemSiblIdx + siblingAmount + Number(!includeRef))];
+    else if (refElementAlignment.startsWith("center-")) {
+      const halfAmount = (refElementAlignment === "center-bottom" ? Math.ceil : Math.floor)(siblingAmount / 2);
+      const startIdx = Math.max(0, elemSiblIdx - halfAmount);
+      const topOffset = Number(refElementAlignment === "center-top" && siblingAmount % 2 === 0 && includeRef);
+      const btmOffset = Number(refElementAlignment === "center-bottom" && siblingAmount % 2 !== 0 && includeRef);
+      const startIdxWithOffset = startIdx + topOffset + btmOffset;
+      return [
+        ...siblings.filter((_, idx) => includeRef || idx !== elemSiblIdx).slice(startIdxWithOffset, startIdxWithOffset + siblingAmount)
+      ];
+    } else if (refElementAlignment === "bottom")
+      return [...siblings.slice(elemSiblIdx - siblingAmount + Number(includeRef), elemSiblIdx + Number(includeRef))];
+    return [];
+  }
 
   // lib/misc.ts
   function autoPlural(word, num) {
@@ -656,7 +676,7 @@ var UserUtils = (function (exports) {
     return curLang;
   };
 
-  exports.ConfigManager = ConfigManager;
+  exports.DataStore = DataStore;
   exports.SelectorObserver = SelectorObserver;
   exports.addGlobalStyle = addGlobalStyle;
   exports.addParent = addParent;
@@ -666,6 +686,7 @@ var UserUtils = (function (exports) {
   exports.debounce = debounce;
   exports.decompress = decompress;
   exports.fetchAdvanced = fetchAdvanced;
+  exports.getSiblingsFrame = getSiblingsFrame;
   exports.getUnsafeWindow = getUnsafeWindow;
   exports.insertAfter = insertAfter;
   exports.insertValues = insertValues;

package/dist/index.js

@@ -116,30 +116,30 @@ function randomizeArray(array) {
   return retArray;
 }
 
-// lib/ConfigManager.ts
-var ConfigManager = class {
+// lib/DataStore.ts
+var DataStore = class {
   /**
-   * Creates an instance of ConfigManager to manage a user configuration that is cached in memory and persistently saved across sessions.  
-   * Supports migrating data from older versions of the configuration to newer ones and populating the cache with default data if no persistent data is found.  
+   * Creates an instance of DataStore to manage a sync & async database that is cached in memory and persistently saved across sessions.  
+   * Supports migrating data from older versions to newer ones and populating the cache with default data if no persistent data is found.  
    *   
    * ⚠️ Requires the directives `@grant GM.getValue` and `@grant GM.setValue`  
-   * ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultConfig`
+   * ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultData`
    * 
-   * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `config.defaultConfig`) - this should also be the type of the data format associated with the current `options.formatVersion`
-   * @param options The options for this ConfigManager instance
+   * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `options.defaultData`) - this should also be the type of the data format associated with the current `options.formatVersion`
+   * @param options The options for this DataStore instance
   */
   constructor(options) {
     __publicField(this, "id");
     __publicField(this, "formatVersion");
-    __publicField(this, "defaultConfig");
+    __publicField(this, "defaultData");
     __publicField(this, "cachedData");
     __publicField(this, "migrations");
     __publicField(this, "encodeData");
     __publicField(this, "decodeData");
     this.id = options.id;
     this.formatVersion = options.formatVersion;
-    this.defaultConfig = options.defaultConfig;
-    this.cachedData = options.defaultConfig;
+    this.defaultData = options.defaultData;
+    this.cachedData = options.defaultData;
     this.migrations = options.migrations;
     this.encodeData = options.encodeData;
     this.decodeData = options.decodeData;
@@ -152,11 +152,11 @@ var ConfigManager = class {
   loadData() {
     return __async(this, null, function* () {
       try {
-        const gmData = yield GM.getValue(`_uucfg-${this.id}`, this.defaultConfig);
+        const gmData = yield GM.getValue(`_uucfg-${this.id}`, this.defaultData);
         let gmFmtVer = Number(yield GM.getValue(`_uucfgver-${this.id}`));
         if (typeof gmData !== "string") {
           yield this.saveDefaultData();
-          return __spreadValues({}, this.defaultConfig);
+          return __spreadValues({}, this.defaultData);
         }
         const isEncoded = yield GM.getValue(`_uucfgenc-${this.id}`, false);
         if (isNaN(gmFmtVer))
@@ -166,9 +166,9 @@ var ConfigManager = class {
           parsed = yield this.runMigrations(parsed, gmFmtVer);
         return __spreadValues({}, this.cachedData = parsed);
       } catch (err) {
-        console.warn("Error while loading config data, resetting it to the default value.", err);
+        console.warn("Error while parsing JSON data, resetting it to the default value.", err);
         yield this.saveDefaultData();
-        return this.defaultConfig;
+        return this.defaultData;
       }
     });
   }
@@ -192,14 +192,14 @@ var ConfigManager = class {
       resolve();
     }));
   }
-  /** Saves the default configuration data passed in the constructor synchronously to the in-memory cache and asynchronously to persistent storage */
+  /** Saves the default data passed in the constructor synchronously to the in-memory cache and asynchronously to persistent storage */
   saveDefaultData() {
     return __async(this, null, function* () {
-      this.cachedData = this.defaultConfig;
+      this.cachedData = this.defaultData;
       const useEncoding = Boolean(this.encodeData && this.decodeData);
       return new Promise((resolve) => __async(this, null, function* () {
         yield Promise.all([
-          GM.setValue(`_uucfg-${this.id}`, yield this.serializeData(this.defaultConfig, useEncoding)),
+          GM.setValue(`_uucfg-${this.id}`, yield this.serializeData(this.defaultData, useEncoding)),
           GM.setValue(`_uucfgver-${this.id}`, this.formatVersion),
           GM.setValue(`_uucfgenc-${this.id}`, useEncoding)
         ]);
@@ -208,13 +208,13 @@ var ConfigManager = class {
     });
   }
   /**
-   * Call this method to clear all persistently stored data associated with this ConfigManager instance.  
+   * Call this method to clear all persistently stored data associated with this DataStore instance.  
    * The in-memory cache will be left untouched, so you may still access the data with {@linkcode getData()}  
    * Calling {@linkcode loadData()} or {@linkcode setData()} after this method was called will recreate persistent storage with the cached or default data.  
    *   
    * ⚠️ This requires the additional directive `@grant GM.deleteValue`
    */
-  deleteConfig() {
+  deleteData() {
     return __async(this, null, function* () {
       yield Promise.all([
         GM.deleteValue(`_uucfg-${this.id}`),
@@ -330,9 +330,9 @@ function openInNewTab(href) {
   setTimeout(openElem.remove, 50);
 }
 function interceptEvent(eventObject, eventName, predicate = () => true) {
-  if (typeof Error.stackTraceLimit === "number" && Error.stackTraceLimit < 1e3) {
-    Error.stackTraceLimit = 1e3;
-  }
+  Error.stackTraceLimit = Math.max(Error.stackTraceLimit, 100);
+  if (isNaN(Error.stackTraceLimit))
+    Error.stackTraceLimit = 100;
   (function(original) {
     eventObject.__proto__.addEventListener = function(...args) {
       var _a, _b;
@@ -379,6 +379,27 @@ function observeElementProp(element, property, callback) {
     });
   }
 }
+function getSiblingsFrame(refElement, siblingAmount, refElementAlignment = "center-top", includeRef = true) {
+  var _a, _b;
+  const siblings = [...(_b = (_a = refElement.parentNode) == null ? void 0 : _a.childNodes) != null ? _b : []];
+  const elemSiblIdx = siblings.indexOf(refElement);
+  if (elemSiblIdx === -1)
+    throw new Error("Element doesn't have a parent node");
+  if (refElementAlignment === "top")
+    return [...siblings.slice(elemSiblIdx + Number(!includeRef), elemSiblIdx + siblingAmount + Number(!includeRef))];
+  else if (refElementAlignment.startsWith("center-")) {
+    const halfAmount = (refElementAlignment === "center-bottom" ? Math.ceil : Math.floor)(siblingAmount / 2);
+    const startIdx = Math.max(0, elemSiblIdx - halfAmount);
+    const topOffset = Number(refElementAlignment === "center-top" && siblingAmount % 2 === 0 && includeRef);
+    const btmOffset = Number(refElementAlignment === "center-bottom" && siblingAmount % 2 !== 0 && includeRef);
+    const startIdxWithOffset = startIdx + topOffset + btmOffset;
+    return [
+      ...siblings.filter((_, idx) => includeRef || idx !== elemSiblIdx).slice(startIdxWithOffset, startIdxWithOffset + siblingAmount)
+    ];
+  } else if (refElementAlignment === "bottom")
+    return [...siblings.slice(elemSiblIdx - siblingAmount + Number(includeRef), elemSiblIdx + Number(includeRef))];
+  return [];
+}
 
 // lib/misc.ts
 function autoPlural(word, num) {
@@ -635,7 +656,7 @@ tr.getLanguage = () => {
   return curLang;
 };
 
-exports.ConfigManager = ConfigManager;
+exports.DataStore = DataStore;
 exports.SelectorObserver = SelectorObserver;
 exports.addGlobalStyle = addGlobalStyle;
 exports.addParent = addParent;
@@ -645,6 +666,7 @@ exports.compress = compress;
 exports.debounce = debounce;
 exports.decompress = decompress;
 exports.fetchAdvanced = fetchAdvanced;
+exports.getSiblingsFrame = getSiblingsFrame;
 exports.getUnsafeWindow = getUnsafeWindow;
 exports.insertAfter = insertAfter;
 exports.insertValues = insertValues;

package/dist/index.mjs

@@ -114,30 +114,30 @@ function randomizeArray(array) {
   return retArray;
 }
 
-// lib/ConfigManager.ts
-var ConfigManager = class {
+// lib/DataStore.ts
+var DataStore = class {
   /**
-   * Creates an instance of ConfigManager to manage a user configuration that is cached in memory and persistently saved across sessions.  
-   * Supports migrating data from older versions of the configuration to newer ones and populating the cache with default data if no persistent data is found.  
+   * Creates an instance of DataStore to manage a sync & async database that is cached in memory and persistently saved across sessions.  
+   * Supports migrating data from older versions to newer ones and populating the cache with default data if no persistent data is found.  
    *   
    * ⚠️ Requires the directives `@grant GM.getValue` and `@grant GM.setValue`  
-   * ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultConfig`
+   * ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultData`
    * 
-   * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `config.defaultConfig`) - this should also be the type of the data format associated with the current `options.formatVersion`
-   * @param options The options for this ConfigManager instance
+   * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `options.defaultData`) - this should also be the type of the data format associated with the current `options.formatVersion`
+   * @param options The options for this DataStore instance
   */
   constructor(options) {
     __publicField(this, "id");
     __publicField(this, "formatVersion");
-    __publicField(this, "defaultConfig");
+    __publicField(this, "defaultData");
     __publicField(this, "cachedData");
     __publicField(this, "migrations");
     __publicField(this, "encodeData");
     __publicField(this, "decodeData");
     this.id = options.id;
     this.formatVersion = options.formatVersion;
-    this.defaultConfig = options.defaultConfig;
-    this.cachedData = options.defaultConfig;
+    this.defaultData = options.defaultData;
+    this.cachedData = options.defaultData;
     this.migrations = options.migrations;
     this.encodeData = options.encodeData;
     this.decodeData = options.decodeData;
@@ -150,11 +150,11 @@ var ConfigManager = class {
   loadData() {
     return __async(this, null, function* () {
       try {
-        const gmData = yield GM.getValue(`_uucfg-${this.id}`, this.defaultConfig);
+        const gmData = yield GM.getValue(`_uucfg-${this.id}`, this.defaultData);
         let gmFmtVer = Number(yield GM.getValue(`_uucfgver-${this.id}`));
         if (typeof gmData !== "string") {
           yield this.saveDefaultData();
-          return __spreadValues({}, this.defaultConfig);
+          return __spreadValues({}, this.defaultData);
         }
         const isEncoded = yield GM.getValue(`_uucfgenc-${this.id}`, false);
         if (isNaN(gmFmtVer))
@@ -164,9 +164,9 @@ var ConfigManager = class {
           parsed = yield this.runMigrations(parsed, gmFmtVer);
         return __spreadValues({}, this.cachedData = parsed);
       } catch (err) {
-        console.warn("Error while loading config data, resetting it to the default value.", err);
+        console.warn("Error while parsing JSON data, resetting it to the default value.", err);
         yield this.saveDefaultData();
-        return this.defaultConfig;
+        return this.defaultData;
       }
     });
   }
@@ -190,14 +190,14 @@ var ConfigManager = class {
       resolve();
     }));
   }
-  /** Saves the default configuration data passed in the constructor synchronously to the in-memory cache and asynchronously to persistent storage */
+  /** Saves the default data passed in the constructor synchronously to the in-memory cache and asynchronously to persistent storage */
   saveDefaultData() {
     return __async(this, null, function* () {
-      this.cachedData = this.defaultConfig;
+      this.cachedData = this.defaultData;
       const useEncoding = Boolean(this.encodeData && this.decodeData);
       return new Promise((resolve) => __async(this, null, function* () {
         yield Promise.all([
-          GM.setValue(`_uucfg-${this.id}`, yield this.serializeData(this.defaultConfig, useEncoding)),
+          GM.setValue(`_uucfg-${this.id}`, yield this.serializeData(this.defaultData, useEncoding)),
           GM.setValue(`_uucfgver-${this.id}`, this.formatVersion),
           GM.setValue(`_uucfgenc-${this.id}`, useEncoding)
         ]);
@@ -206,13 +206,13 @@ var ConfigManager = class {
     });
   }
   /**
-   * Call this method to clear all persistently stored data associated with this ConfigManager instance.  
+   * Call this method to clear all persistently stored data associated with this DataStore instance.  
    * The in-memory cache will be left untouched, so you may still access the data with {@linkcode getData()}  
    * Calling {@linkcode loadData()} or {@linkcode setData()} after this method was called will recreate persistent storage with the cached or default data.  
    *   
    * ⚠️ This requires the additional directive `@grant GM.deleteValue`
    */
-  deleteConfig() {
+  deleteData() {
     return __async(this, null, function* () {
       yield Promise.all([
         GM.deleteValue(`_uucfg-${this.id}`),
@@ -328,9 +328,9 @@ function openInNewTab(href) {
   setTimeout(openElem.remove, 50);
 }
 function interceptEvent(eventObject, eventName, predicate = () => true) {
-  if (typeof Error.stackTraceLimit === "number" && Error.stackTraceLimit < 1e3) {
-    Error.stackTraceLimit = 1e3;
-  }
+  Error.stackTraceLimit = Math.max(Error.stackTraceLimit, 100);
+  if (isNaN(Error.stackTraceLimit))
+    Error.stackTraceLimit = 100;
   (function(original) {
     eventObject.__proto__.addEventListener = function(...args) {
       var _a, _b;
@@ -377,6 +377,27 @@ function observeElementProp(element, property, callback) {
     });
   }
 }
+function getSiblingsFrame(refElement, siblingAmount, refElementAlignment = "center-top", includeRef = true) {
+  var _a, _b;
+  const siblings = [...(_b = (_a = refElement.parentNode) == null ? void 0 : _a.childNodes) != null ? _b : []];
+  const elemSiblIdx = siblings.indexOf(refElement);
+  if (elemSiblIdx === -1)
+    throw new Error("Element doesn't have a parent node");
+  if (refElementAlignment === "top")
+    return [...siblings.slice(elemSiblIdx + Number(!includeRef), elemSiblIdx + siblingAmount + Number(!includeRef))];
+  else if (refElementAlignment.startsWith("center-")) {
+    const halfAmount = (refElementAlignment === "center-bottom" ? Math.ceil : Math.floor)(siblingAmount / 2);
+    const startIdx = Math.max(0, elemSiblIdx - halfAmount);
+    const topOffset = Number(refElementAlignment === "center-top" && siblingAmount % 2 === 0 && includeRef);
+    const btmOffset = Number(refElementAlignment === "center-bottom" && siblingAmount % 2 !== 0 && includeRef);
+    const startIdxWithOffset = startIdx + topOffset + btmOffset;
+    return [
+      ...siblings.filter((_, idx) => includeRef || idx !== elemSiblIdx).slice(startIdxWithOffset, startIdxWithOffset + siblingAmount)
+    ];
+  } else if (refElementAlignment === "bottom")
+    return [...siblings.slice(elemSiblIdx - siblingAmount + Number(includeRef), elemSiblIdx + Number(includeRef))];
+  return [];
+}
 
 // lib/misc.ts
 function autoPlural(word, num) {
@@ -633,4 +654,4 @@ tr.getLanguage = () => {
   return curLang;
 };
 
-export { ConfigManager, SelectorObserver, addGlobalStyle, addParent, autoPlural, clamp, compress, debounce, decompress, fetchAdvanced, getUnsafeWindow, insertAfter, insertValues, interceptEvent, interceptWindowEvent, isScrollable, mapRange, observeElementProp, openInNewTab, pauseFor, preloadImages, randRange, randomId, randomItem, randomItemIndex, randomizeArray, takeRandomItem, tr };
+export { DataStore, SelectorObserver, addGlobalStyle, addParent, autoPlural, clamp, compress, debounce, decompress, fetchAdvanced, getSiblingsFrame, getUnsafeWindow, insertAfter, insertValues, interceptEvent, interceptWindowEvent, isScrollable, mapRange, observeElementProp, openInNewTab, pauseFor, preloadImages, randRange, randomId, randomItem, randomItemIndex, randomizeArray, takeRandomItem, tr };

package/dist/lib/{ConfigManager.d.ts → DataStore.d.ts}

@@ -1,33 +1,33 @@
 /** Function that takes the data in the old format and returns the data in the new format. Also supports an asynchronous migration. */
 type MigrationFunc = (oldData: any) => any | Promise<any>;
 /** Dictionary of format version numbers and the function that migrates to them from the previous whole integer */
-export type ConfigMigrationsDict = Record<number, MigrationFunc>;
-/** Options for the ConfigManager instance */
-export type ConfigManagerOptions<TData> = {
-    /** A unique internal ID for this configuration - choose wisely as changing it is not supported yet. */
+export type DataMigrationsDict = Record<number, MigrationFunc>;
+/** Options for the DataStore instance */
+export type DataStoreOptions<TData> = {
+    /** A unique internal ID for this data store - choose wisely as changing it is not supported yet. */
     id: string;
     /**
-     * The default config data object to use if no data is saved in persistent storage yet.
+     * The default data object to use if no data is saved in persistent storage yet.
      * Until the data is loaded from persistent storage with `loadData()`, this will be the data returned by `getData()`
      *
      * ⚠️ This has to be an object that can be serialized to JSON, so no functions or circular references are allowed, they will cause unexpected behavior.
      */
-    defaultConfig: TData;
+    defaultData: TData;
     /**
-     * An incremental, whole integer version number of the current format of config data.
+     * An incremental, whole integer version number of the current format of data.
      * If the format of the data is changed in any way, this number should be incremented, in which case all necessary functions of the migrations dictionary will be run consecutively.
      *
      * ⚠️ Never decrement this number and optimally don't skip any numbers either!
      */
     formatVersion: number;
     /**
-     * A dictionary of functions that can be used to migrate data from older versions of the configuration to newer ones.
+     * A dictionary of functions that can be used to migrate data from older versions to newer ones.
      * The keys of the dictionary should be the format version that the functions can migrate to, from the previous whole integer value.
      * The values should be functions that take the data in the old format and return the data in the new format.
      * The functions will be run in order from the oldest to the newest version.
      * If the current format version is not in the dictionary, no migrations will be run.
      */
-    migrations?: ConfigMigrationsDict;
+    migrations?: DataMigrationsDict;
 } & ({
     /**
      * Function to use to encode the data prior to saving it in persistent storage.
@@ -50,33 +50,33 @@ export type ConfigManagerOptions<TData> = {
     decodeData?: never;
 });
 /**
- * Manages a user configuration that is cached in memory and persistently saved across sessions.
- * Supports migrating data from older versions of the configuration to newer ones and populating the cache with default data if no persistent data is found.
+ * Manages a sync & async persistent JSON database that is cached in memory and persistently saved across sessions.
+ * Supports migrating data from older format versions to newer ones and populating the cache with default data if no persistent data is found.
  *
  * ⚠️ Requires the directives `@grant GM.getValue` and `@grant GM.setValue`
- * ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultConfig`
+ * ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultData`
  *
- * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `config.defaultConfig`) - this should also be the type of the data format associated with the current `options.formatVersion`
+ * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `defaultData`) - this should also be the type of the data format associated with the current `formatVersion`
  */
-export declare class ConfigManager<TData = any> {
+export declare class DataStore<TData = any> {
     readonly id: string;
     readonly formatVersion: number;
-    readonly defaultConfig: TData;
+    readonly defaultData: TData;
     private cachedData;
     private migrations?;
     private encodeData;
     private decodeData;
     /**
-     * Creates an instance of ConfigManager to manage a user configuration that is cached in memory and persistently saved across sessions.
-     * Supports migrating data from older versions of the configuration to newer ones and populating the cache with default data if no persistent data is found.
+     * Creates an instance of DataStore to manage a sync & async database that is cached in memory and persistently saved across sessions.
+     * Supports migrating data from older versions to newer ones and populating the cache with default data if no persistent data is found.
      *
      * ⚠️ Requires the directives `@grant GM.getValue` and `@grant GM.setValue`
-     * ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultConfig`
+     * ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultData`
      *
-     * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `config.defaultConfig`) - this should also be the type of the data format associated with the current `options.formatVersion`
-     * @param options The options for this ConfigManager instance
+     * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `options.defaultData`) - this should also be the type of the data format associated with the current `options.formatVersion`
+     * @param options The options for this DataStore instance
     */
-    constructor(options: ConfigManagerOptions<TData>);
+    constructor(options: DataStoreOptions<TData>);
     /**
      * Loads the data saved in persistent storage into the in-memory cache and also returns it.
      * Automatically populates persistent storage with default data if it doesn't contain any data yet.
@@ -90,16 +90,16 @@ export declare class ConfigManager<TData = any> {
     getData(): TData;
     /** Saves the data synchronously to the in-memory cache and asynchronously to the persistent storage */
     setData(data: TData): Promise<void>;
-    /** Saves the default configuration data passed in the constructor synchronously to the in-memory cache and asynchronously to persistent storage */
+    /** Saves the default data passed in the constructor synchronously to the in-memory cache and asynchronously to persistent storage */
     saveDefaultData(): Promise<void>;
     /**
-     * Call this method to clear all persistently stored data associated with this ConfigManager instance.
+     * Call this method to clear all persistently stored data associated with this DataStore instance.
      * The in-memory cache will be left untouched, so you may still access the data with {@linkcode getData()}
      * Calling {@linkcode loadData()} or {@linkcode setData()} after this method was called will recreate persistent storage with the cached or default data.
      *
      * ⚠️ This requires the additional directive `@grant GM.deleteValue`
      */
-    deleteConfig(): Promise<void>;
+    deleteData(): Promise<void>;
     /** Runs all necessary migration functions consecutively - may be overwritten in a subclass */
     protected runMigrations(oldData: any, oldFmtVer: number): Promise<TData>;
     /** Serializes the data using the optional this.encodeData() and returns it as a string */

package/dist/lib/dom.d.ts

@@ -36,14 +36,14 @@ export declare function openInNewTab(href: string): void;
  * Intercepts the specified event on the passed object and prevents it from being called if the called {@linkcode predicate} function returns a truthy value.
  * If no predicate is specified, all events will be discarded.
  * This function should be called as soon as possible (I recommend using `@run-at document-start`), as it will only intercept events that are added after this function is called.
- * Calling this function will set the `Error.stackTraceLimit` to 1000 to ensure the stack trace is preserved.
+ * Calling this function will set `Error.stackTraceLimit = 100` (if not already higher) to ensure the stack trace is preserved.
  */
 export declare function interceptEvent<TEvtObj extends EventTarget, TPredicateEvt extends Event>(eventObject: TEvtObj, eventName: Parameters<TEvtObj["addEventListener"]>[0], predicate?: (event: TPredicateEvt) => boolean): void;
 /**
  * Intercepts the specified event on the window object and prevents it from being called if the called {@linkcode predicate} function returns a truthy value.
  * If no predicate is specified, all events will be discarded.
  * This function should be called as soon as possible (I recommend using `@run-at document-start`), as it will only intercept events that are added after this function is called.
- * Calling this function will set the `Error.stackTraceLimit` to 1000 to ensure the stack trace is preserved.
+ * Calling this function will set `Error.stackTraceLimit = 100` (if not already higher) to ensure the stack trace is preserved.
  */
 export declare function interceptWindowEvent<TEvtKey extends keyof WindowEventMap>(eventName: TEvtKey, predicate?: (event: WindowEventMap[TEvtKey]) => boolean): void;
 /** Checks if an element is scrollable in the horizontal and vertical directions */
@@ -61,3 +61,13 @@ export declare function isScrollable(element: Element): {
  * @param callback Callback to execute when the value is changed
  */
 export declare function observeElementProp<TElem extends Element = HTMLElement, TPropKey extends keyof TElem = keyof TElem>(element: TElem, property: TPropKey, callback: (oldVal: TElem[TPropKey], newVal: TElem[TPropKey]) => void): void;
+/**
+ * Returns a "frame" of the closest siblings of the {@linkcode refElement}, based on the passed amount of siblings and {@linkcode refElementAlignment}
+ * @param refElement The reference element to return the relative closest siblings from
+ * @param siblingAmount The amount of siblings to return
+ * @param refElementAlignment Can be set to `center-top` (default), `center-bottom`, `top`, or `bottom`, which will determine where the relative location of the provided {@linkcode refElement} is in the returned array
+ * @param includeRef If set to `true` (default), the provided {@linkcode refElement} will be included in the returned array at the corresponding position
+ * @template TSibling The type of the sibling elements that are returned
+ * @returns An array of sibling elements
+ */
+export declare function getSiblingsFrame<TSibling extends Element = HTMLElement>(refElement: Element, siblingAmount: number, refElementAlignment?: "center-top" | "center-bottom" | "top" | "bottom", includeRef?: boolean): TSibling[];

package/dist/lib/index.d.ts

@@ -1,5 +1,5 @@
 export * from "./array";
-export * from "./ConfigManager";
+export * from "./DataStore";
 export * from "./dom";
 export * from "./math";
 export * from "./misc";

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@sv443-network/userutils",
-  "version": "5.0.1",
+  "libName": "UserUtils",
+  "version": "6.0.1",
   "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",
@@ -9,7 +10,7 @@
     "lint": "tsc --noEmit && eslint .",
     "build-types": "tsc --emitDeclarationOnly --declaration --outDir dist",
     "build-common": "tsup lib/index.ts --format cjs,esm --clean --treeshake",
-    "build-global": "tsup lib/index.ts --format cjs,esm,iife --treeshake --onSuccess \"npm run post-build-global && echo Finished building.\"",
+    "build-all": "tsup lib/index.ts --format cjs,esm,iife --treeshake --onSuccess \"npm run post-build-global && echo Finished building.\"",
     "build": "npm run build-common -- && npm run build-types",
     "post-build-global": "npm run node-ts -- ./tools/post-build-global.mts",
     "dev": "npm run build-common -- --sourcemap --watch --onSuccess \"npm run build-types && echo Finished building.\"",