v9.0.0

.changeset/beige-dots-refuse.md

@@ -0,0 +1,21 @@
+---
+"@sv443-network/userutils": major
+---
+
+**BREAKING** - Reworked translation system:
+- Removed `tr()`, `tr.setLanguage()` and `tr.getLanguage()`
+- Renamed function `tr.addLanguage()` to `tr.addTranslations()`
+- Removed `%n`-based argument insertion by default (re-enable explicitly with `tr.addTransform(tr.transforms.percent)`).
+- Added ability for nested translation objects and object traversal via dot notation.
+- Added functions:
+  - `tr.for()` - translates a key for the specified language.
+  - `tr.use()` - creates a translation function for the specified language for much easier usage.
+  - `tr.hasKey()` - checks if a key exists in the given language.
+  - `tr.setFallbackLanguage()` - sets the fallback language used when a key is not found in the given language.
+  - `tr.getFallbackLanguage()` - returns the fallback language.
+  - `tr.addTransform()` - adds a transform function to the translation system, allowing for custom argument insertion and much more.
+  - `tr.deleteTransform()` - removes a transform function.
+- Added ability to specify transform patterns and functions for arbitrary modification of the translation string.
+  - Added transform for template literal syntax (e.g. `${keyName}`) with `tr.addTransform(tr.transforms.templateLiteral)`. This transform supports positional argument injection, as well as named arguments via an object with the same keys as in the template literal pattern. See the documentation for more information and a code example.
+- Added TS type `TrKeys<T>` for extracting the keys of a translation object (both flat and nested).
+- Fixed bug with resolving translations for flat objects.

.changeset/eighty-cooks-joke.md

@@ -0,0 +1,5 @@
+---
+"@sv443-network/userutils": patch
+---
+
+Fixed newlines being collapsed in TSDoc comments.

.changeset/great-donuts-roll.md

@@ -0,0 +1,5 @@
+---
+"@sv443-network/userutils": minor
+---
+
+Added `additionalProps` parameter to `openInNewTab()` to add or overwrite anchor element props (only if `GM.openInTab()` is unavailable)

.changeset/grumpy-toys-fry.md

@@ -0,0 +1,15 @@
+---
+"@sv443-network/userutils": major
+---
+
+**BREAKING** - Reworked debounce system:  
+- Edge types `rising` and `falling` have been removed.
+- Added new edge types `immediate` and `idle` with new behavior.
+  - `immediate` (default & recommended) will trigger immediately, then queue all subsequent calls until the timeout has passed.
+  - `idle` will trigger the last queued call only after there haven't been any subsequent calls for the specified timeout.
+- Added `Debouncer` class for more advanced control over debouncing, and with that the following changes:
+  - Ability to attach and manage multiple listeners.
+  - Inherits from NanoEmitter, allowing event-based debouncing.
+  - Can be inherited by your own classes for built-in debouncing.
+- `debounce()` function can still be called as usual (after replacing the edge type names with the new ones). Internally, it will instantiate a `Debouncer` instance, which is available via the `debouncer` property on the returned function.
+- Reduced default timeout from 300ms to 200ms.

.changeset/rude-trains-leave.md

@@ -0,0 +1,5 @@
+---
+"@sv443-network/userutils": patch
+---
+
+Fixed `randRange()` with `enhancedEntropy = true` only returning the first digit.

.changeset/shiny-icons-provide.md

@@ -0,0 +1,5 @@
+---
+"@sv443-network/userutils": minor
+---
+
+Moved documentation to separate file `docs.md` to speed up `README.md` load time.

.vscode/launch.json

@@ -0,0 +1,31 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "fix-dts",
+      "type": "node",
+      "request": "launch",
+      "program": "${workspaceFolder}/tools/fix-dts.mts",
+      "runtimeExecutable": "tsx",
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+      "skipFiles": [
+        "<node_internals>/**",
+        "${workspaceFolder}/node_modules/**"
+      ]
+    },
+    {
+      "name": "test.ts",
+      "type": "node",
+      "request": "launch",
+      "program": "${workspaceFolder}/test.ts",
+      "runtimeExecutable": "tsx",
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+      "skipFiles": [
+        "<node_internals>/**",
+        "${workspaceFolder}/node_modules/**"
+      ]
+    },
+  ]
+}

CHANGELOG.md

@@ -245,11 +245,11 @@
   - separate instances can have different MutationObserver options set to further reduce performance impact
   - the separation into instances allows for a new "chaining" paradigm where selector listeners are only added and checked for once they are actually needed (see examples in the documentation)
   - when using chaining, separate instances can be created and have listeners added to them before their base element is available in the DOM tree
-  - every listener can have a set debounce time, so that it doesn't get called too often (works the same as the [`debounce()` function](https://github.com/Sv443-Network/UserUtils/blob/main/README.md#debounce), but is disabled by default)
+  - every listener can have a set debounce time, so that it doesn't get called too often (works the same as the [`debounce()` function](https://github.com/Sv443-Network/UserUtils/blob/v3.0.0/README.md#debounce), but is disabled by default)
   - there are now multiple methods to get and delete specific listeners
 
   The `SelectorObserver.addListener()` method is backwards compatible with the old `onSelector()` function, so you can just add the class instance in front (for full backwards compat use `document.body` for the `baseElement` parameter of the constructor), then change the old function's name and it should work as before.
-  For more info and examples, please view the [SelectorObserver documentation](https://github.com/Sv443-Network/UserUtils/blob/main/README.md#selectorobserver)
+  For more info and examples, please view the [SelectorObserver documentation](https://github.com/Sv443-Network/UserUtils/blob/v3.0.0/README.md#selectorobserver)
 
 ### Minor Changes