add more comments

lib/utils.ts

@@ -30,6 +30,10 @@ function isMergeableObject(value: unknown): value is Record<string, unknown> {
 function mergeObject<TObject extends Record<string, unknown>>(target: TObject | null, source: TObject, shouldRemoveNullObjectValues = true): TObject {
     const destination: Record<string, unknown> = {};
 
+    // First we want to copy over all keys from the target into the destination object,
+    // in case "target" is a mergable object.
+    // If "shouldRemoveNullObjectValues" is true, we want to remove null values from the merged object
+    // and therefore we need to omit keys where either the source or target value is null.
     if (isMergeableObject(target)) {
         const targetKeys = Object.keys(target);
         for (let i = 0; i < targetKeys.length; ++i) {
@@ -48,6 +52,7 @@ function mergeObject<TObject extends Record<string, unknown>>(target: TObject |
         }
     }
 
+    // After copying over all keys from the target object, we want to merge the source object into the destination object.
     const sourceKeys = Object.keys(source);
     for (let i = 0; i < sourceKeys.length; ++i) {
         const key = sourceKeys[i];