wacom 20.0.3 → 20.0.6

package/fesm2022/wacom.mjs

@@ -805,14 +805,47 @@ class CoreService {
             this.linkIds[name].push(...reset());
         });
     }
-    // Angular Signals
+    // Angular Signals //
+    /**
+     * 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>} [signalFields={}] -
+     *        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, signalFields = {}) {
+        if (Object.keys(signalFields).length) {
+            const fields = {};
+            for (const key in signalFields) {
+                fields[key] = signal(signalFields[key](document));
+            }
+            return signal({ ...document, ...fields });
+        }
+        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={}] -
+     * @param {Record<string, (doc: Document) => unknown>} [signalFields={}] -
      *        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.
      *
@@ -825,43 +858,36 @@ class CoreService {
      *   score: (u) => u.score,
      * });
      */
-    toSignalsArray(arr, updatableFields = {}) {
-        return arr.map((obj) => {
-            if (Object.keys(updatableFields).length) {
-                const signalFields = {};
-                for (const key in updatableFields) {
-                    signalFields[key] = signal(updatableFields[key](obj));
-                }
-                return signal({ ...obj, ...signalFields });
-            }
-            else {
-                return signal(obj);
-            }
-        });
+    toSignalsArray(arr, signalFields = {}) {
+        return arr.map((obj) => this.toSignal(obj, signalFields));
     }
     /**
      * 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 {WritableSignal<Document>[]} signals - The signals array to append to.
-     * @param {Document} item - The object to wrap and push as a writable signal.
-     * @param {Record<string, (doc: Document) => unknown>} [updatableFields={}] -
+     * @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>} [signalFields={}] -
      *        Optional map of fields to be wrapped as signals within the object.
      *
      * @returns {void}
      */
-    pushSignal(signals, item, updatableFields = {}) {
-        if (Object.keys(updatableFields).length) {
-            const fieldSignals = {};
-            for (const key in updatableFields) {
-                fieldSignals[key] = signal(updatableFields[key](item));
-            }
-            signals.push(signal({ ...item, ...fieldSignals }));
-        }
-        else {
-            signals.push(signal(item));
-        }
+    pushSignal(signals, item, signalFields = {}) {
+        signals.push(this.toSignal(item, signalFields));
+    }
+    /**
+     * Removes the first signal from the array whose object's field matches the provided value.
+     * @template Document
+     * @param {WritableSignal<Document>[]} signals - The signals array to modify.
+     * @param {unknown} value - The value to match.
+     * @param {string} [field='_id'] - The object field to match against.
+     * @returns {void}
+     */
+    removeSignalByField(signals, value, field = '_id') {
+        const idx = signals.findIndex((sig) => sig()[field] === value);
+        if (idx > -1)
+            signals.splice(idx, 1);
     }
     /**
      * Returns a generic trackBy function for *ngFor, tracking by the specified object field.
@@ -897,19 +923,6 @@ class CoreService {
         if (sig)
             sig.update(updater);
     }
-    /**
-     * Removes the first signal from the array whose object's field matches the provided value.
-     * @template Document
-     * @param {WritableSignal<Document>[]} signals - The signals array to modify.
-     * @param {unknown} value - The value to match.
-     * @param {string} [field='_id'] - The object field to match against.
-     * @returns {void}
-     */
-    removeSignalByField(signals, value, field = '_id') {
-        const idx = signals.findIndex((sig) => sig()[field] === value);
-        if (idx > -1)
-            signals.splice(idx, 1);
-    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.0.0", ngImport: i0, type: CoreService, deps: [{ token: PLATFORM_ID }], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.0.0", ngImport: i0, type: CoreService, providedIn: 'root' });
 }
@@ -2375,6 +2388,7 @@ class CrudService extends BaseService {
     constructor(_config) {
         super();
         this._config = _config;
+        this._config.signalFields = this._config.signalFields || {};
         this._url += this._config.name;
         this.loaded = this.__core.onComplete(this._config.name + '_loaded');
         if (this._config.unauthorized) {