@ardium-pl/devkit 8.3.3 → 8.4.0

package/lib/signals/map/map-signal.d.ts

@@ -46,9 +46,24 @@ export interface WritableMapSignal<K, V> extends WritableSignal<Map<K, V>>, MapS
     setKey(key: K, value: V): void;
     /**
      * Deletes a key from the map.
-     * Returns true if a value was removed.
+     * @returns true if a value was removed.
      */
     delete(key: K): boolean;
+    /**
+     * Merges another map into the current map.
+     */
+    merge(value: Iterable<[K, V]>): void;
+    /**
+     * Toggles a value for a key. If the key exists, it will be deleted; if it doesn't exist, it will be added with the provided value.
+     * @returns true if the key was added, false if it was deleted.
+     */
+    toggleKey(key: K, value: V): boolean;
+    /**
+     * Toggles a value for a key. If the key exists, it will be deleted; if it doesn't exist, it will be added with the provided value.
+     * Alias of the method `toggleKey()`.
+     * @returns true if the key was added, false if it was deleted.
+     */
+    toggle(key: K, value: V): boolean;
     /**
      * Clears the map.
      */
@@ -56,11 +71,16 @@ export interface WritableMapSignal<K, V> extends WritableSignal<Map<K, V>>, MapS
     /**
      * Replaces the map with a new map.
      */
-    setMap(value: Map<K, V>): void;
+    setMap(value: Iterable<[K, V]>): void;
     /**
      * Replaces the map with a new map. Alias of the method `setMap()`.
+     * @deprecated Use `setMap()` instead for clarity.
+     */
+    set(value: Iterable<[K, V]>): void;
+    /**
+     * Sets a value for the key. Alias of the method `setKey()`.
      */
-    set(value: Map<K, V>): void;
+    set(key: K, value: V): void;
     /**
      * Updates the map using an update function.
      */

package/lib/signals/query-param/query-param-signal.d.ts

@@ -1,6 +1,12 @@
 import { Signal, WritableSignal } from '@angular/core';
 export interface QueryParamSignalNonNullable<T> extends Signal<T> {
+    /**
+     * The name of the query parameter used to store the signal value.
+     */
     readonly paramName: string;
+    /**
+     * Computed signal that returns the serialized value of the signal.
+     */
     readonly serialized: Signal<string | null>;
 }
 export interface QueryParamSignal<T> extends QueryParamSignalNonNullable<T | null> {

package/lib/signals/set/set-signal.d.ts

@@ -34,9 +34,14 @@ export interface WritableSetSignal<T> extends WritableSignal<Set<T>>, SetSignal<
     add(value: T): void;
     /**
      * Deletes a value from the set.
-     * Returns true if a value was removed.
+     * @returns true if a value was removed.
      */
     delete(value: T): boolean;
+    /**
+     * Toggles a value in the set. If the value exists, it will be removed; if it does not exist, it will be added.
+     * @returns true if the value was added, false if it was removed.
+     */
+    toggle(value: T): boolean;
     /**
      * Clears the set.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ardium-pl/devkit",
-  "version": "8.3.3",
+  "version": "8.4.0",
   "private": false,
   "peerDependencies": {
     "@angular/common": ">=19.0.0",