wacom 20.0.2 → 20.0.5

package/fesm2022/wacom.mjs

@@ -807,13 +807,74 @@ class CoreService {
     }
     // Angular Signals
     /**
-     * Converts an array of objects to an array of Angular signals.
-     * @template Document
-     * @param {Document[]} arr - Array of objects to convert.
-     * @returns {Signal<Document>[]} Array of signals wrapping each object.
+     * Converts a plain object into a signal-wrapped object.
+     * Optionally wraps specific fields of the object as individual signals,
+     * and merges them into the returned signal for fine-grained reactivity.
+     *
+     * @template Document - The type of the object being wrapped.
+     * @param {Document} document - The plain object to wrap into a signal.
+     * @param {Record<string, (doc: Document) => unknown>} [updatableFields={}] -
+     *        Optional map where each key is a field name and the value is a function
+     *        to extract the initial value for that field. These fields will be wrapped
+     *        as separate signals and embedded in the returned object.
+     *
+     * @returns {Signal<Document>} A signal-wrapped object, possibly containing
+     *          nested field signals for more granular control.
+     *
+     * @example
+     * const user = { _id: '1', name: 'Alice', score: 42 };
+     * const sig = toSignal(user, { score: (u) => u.score });
+     * console.log(sig().name); // 'Alice'
+     * console.log(sig().score()); // 42 — field is now a signal
+     */
+    toSignal(document, updatableFields = {}) {
+        if (Object.keys(updatableFields).length) {
+            const signalFields = {};
+            for (const key in updatableFields) {
+                signalFields[key] = signal(updatableFields[key](document));
+            }
+            return signal({ ...document, ...signalFields });
+        }
+        else {
+            return signal(document);
+        }
+    }
+    /**
+     * Converts an array of objects into an array of Angular signals.
+     * Optionally wraps specific fields of each object as individual signals.
+     *
+     * @template Document - The type of each object in the array.
+     * @param {Document[]} arr - Array of plain objects to convert into signals.
+     * @param {Record<string, (doc: Document) => unknown>} [updatableFields={}] -
+     *        Optional map where keys are field names and values are functions that extract the initial value
+     *        from the object. These fields will be turned into separate signals.
+     *
+     * @returns {Signal<Document>[]} An array where each item is a signal-wrapped object,
+     *          optionally with individual fields also wrapped in signals.
+     *
+     * @example
+     * toSignalsArray(users, {
+     *   name: (u) => u.name,
+     *   score: (u) => u.score,
+     * });
+     */
+    toSignalsArray(arr, updatableFields = {}) {
+        return arr.map((obj) => this.toSignal(obj, updatableFields));
+    }
+    /**
+     * Adds a new object to the signals array.
+     * Optionally wraps specific fields of the object as individual signals before wrapping the whole object.
+     *
+     * @template Document - The type of the object being added.
+     * @param {Signal<Document>[]} signals - The signals array to append to.
+     * @param {Document} item - The object to wrap and push as a signal.
+     * @param {Record<string, (doc: Document) => unknown>} [updatableFields={}] -
+     *        Optional map of fields to be wrapped as signals within the object.
+     *
+     * @returns {void}
      */
-    toSignalsArray(arr) {
-        return arr.map((obj) => signal(obj));
+    pushSignal(signals, item, updatableFields = {}) {
+        signals.push(this.toSignal(item, updatableFields));
     }
     /**
      * Returns a generic trackBy function for *ngFor, tracking by the specified object field.
@@ -849,16 +910,6 @@ class CoreService {
         if (sig)
             sig.update(updater);
     }
-    /**
-     * Adds a new object as a writable signal to the signals array.
-     * @template Document
-     * @param {WritableSignal<Document>[]} signals - The signals array to modify.
-     * @param {Document} item - The object to wrap and push as a writable signal.
-     * @returns {void}
-     */
-    pushSignal(signals, item) {
-        signals.push(signal(item));
-    }
     /**
      * Removes the first signal from the array whose object's field matches the provided value.
      * @template Document