assign-gingerly 0.0.44 → 0.0.45

package/README.md

@@ -751,7 +751,31 @@ console.log(obj);
 // }
 ```
 
-The `+=` command syntax is `<path> +=` where the path uses the `?.` nested notation for nested properties, or a plain key for direct properties. The right-hand side value is added to the existing value using `+=`. If the path doesn't exist, it's created and set directly to the value.  If the expression is a string, string concatenation is used.  If the expression can't be "added to", it allows JavaScript to throw its natural error.
+The `+=` command syntax is `<path> +=` where the path uses the `?.` nested notation for nested properties, or a plain key for direct properties. The right-hand side value is added to the existing value using `+=`. If the path doesn't exist, it's created and set directly to the value.
+
+**Behavior by type:**
+
+| LHS type | RHS type | Result |
+|----------|----------|--------|
+| number | number | addition (`2 += 3` → `5`) |
+| string | any | string concatenation (`"hello" += 3` → `"hello3"`) |
+| array | array | array concatenation (`[1,2] += [3,4]` → `[1,2,3,4]`) |
+| array | non-array | push single item (`[1,2] += 3` → `[1,2,3]`) |
+| undefined/missing | any | direct assignment |
+
+```TypeScript
+const obj = {
+    tags: ['a', 'b'],
+    name: 'hello'
+};
+assignGingerly(obj, {
+    '?.tags +=': ['c', 'd'],   // array concat: ['a', 'b', 'c', 'd']
+    '?.name +=': ' world'      // string concat: 'hello world'
+});
+
+// Push a single item
+assignGingerly(obj, { '?.tags +=': 'e' }); // ['a', 'b', 'c', 'd', 'e']
+```
 
 ## Example 5 - Toggling boolean values and negating
 

package/assignGingerly.js

@@ -616,6 +616,11 @@ export function assignGingerly(target, source, options) {
                     if (!(lastKey in parent)) {
                         parent[lastKey] = value;
                     }
+                    else if (Array.isArray(parent[lastKey])) {
+                        parent[lastKey] = Array.isArray(value)
+                            ? [...parent[lastKey], ...value]
+                            : [...parent[lastKey], value];
+                    }
                     else {
                         parent[lastKey] += value;
                     }
@@ -625,6 +630,11 @@ export function assignGingerly(target, source, options) {
                     if (!(path in target)) {
                         target[path] = value;
                     }
+                    else if (Array.isArray(target[path])) {
+                        target[path] = Array.isArray(value)
+                            ? [...target[path], ...value]
+                            : [...target[path], value];
+                    }
                     else {
                         target[path] += value;
                     }

package/assignGingerly.ts

@@ -801,6 +801,10 @@ export function assignGingerly(
           const parent = ensureNestedPath(target, pathParts);
           if (!(lastKey in parent)) {
             parent[lastKey] = value;
+          } else if (Array.isArray(parent[lastKey])) {
+            parent[lastKey] = Array.isArray(value)
+              ? [...parent[lastKey], ...value]
+              : [...parent[lastKey], value];
           } else {
             parent[lastKey] += value;
           }
@@ -808,6 +812,10 @@ export function assignGingerly(
           // Plain key - direct operation on target
           if (!(path in target)) {
             target[path] = value;
+          } else if (Array.isArray(target[path])) {
+            target[path] = Array.isArray(value)
+              ? [...target[path], ...value]
+              : [...target[path], value];
           } else {
             target[path] += value;
           }

package/assignTentatively.js

@@ -124,7 +124,14 @@ export function assignTentatively(target, source, options) {
                         if (!(fullPath in reversal)) {
                             reversal[fullPath] = parent[lastKey];
                         }
-                        parent[lastKey] += value;
+                        if (Array.isArray(parent[lastKey])) {
+                            parent[lastKey] = Array.isArray(value)
+                                ? [...parent[lastKey], ...value]
+                                : [...parent[lastKey], value];
+                        }
+                        else {
+                            parent[lastKey] += value;
+                        }
                     }
                     else {
                         // Property doesn't exist, create it with the value
@@ -137,7 +144,14 @@ export function assignTentatively(target, source, options) {
                         if (!(path in reversal)) {
                             reversal[path] = target[path];
                         }
-                        target[path] += value;
+                        if (Array.isArray(target[path])) {
+                            target[path] = Array.isArray(value)
+                                ? [...target[path], ...value]
+                                : [...target[path], value];
+                        }
+                        else {
+                            target[path] += value;
+                        }
                     }
                     else {
                         target[path] = value;

package/assignTentatively.ts

@@ -152,7 +152,13 @@ export function assignTentatively(
             if (!(fullPath in reversal)) {
               reversal[fullPath] = parent[lastKey];
             }
-            parent[lastKey] += value;
+            if (Array.isArray(parent[lastKey])) {
+              parent[lastKey] = Array.isArray(value)
+                ? [...parent[lastKey], ...value]
+                : [...parent[lastKey], value];
+            } else {
+              parent[lastKey] += value;
+            }
           } else {
             // Property doesn't exist, create it with the value
             parent[lastKey] = value;
@@ -163,7 +169,13 @@ export function assignTentatively(
             if (!(path in reversal)) {
               reversal[path] = target[path];
             }
-            target[path] += value;
+            if (Array.isArray(target[path])) {
+              target[path] = Array.isArray(value)
+                ? [...target[path], ...value]
+                : [...target[path], value];
+            } else {
+              target[path] += value;
+            }
           } else {
             target[path] = value;
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assign-gingerly",
-  "version": "0.0.44",
+  "version": "0.0.45",
   "description": "This package provides a utility function for carefully merging one object into another.",
   "homepage": "https://github.com/bahrus/assign-gingerly#readme",
   "bugs": {