@helpers4/object 2.0.3 → 2.1.0

package/meta/examples.json

@@ -1,6 +1,16 @@
 {
   "category": "object",
   "functions": [
+    {
+      "name": "cloneDeep",
+      "examples": [
+        {
+          "title": "Clone a nested object",
+          "description": "Creates a deep copy — modifying the clone does not affect the original.",
+          "code": "const original = { a: { b: 1 } };\nconst cloned = cloneDeep(original);\ncloned.a.b = 2;\n// original.a.b is still 1"
+        }
+      ]
+    },
     {
       "name": "compact",
       "examples": [
@@ -16,26 +26,6 @@
         }
       ]
     },
-    {
-      "name": "deepClone",
-      "examples": [
-        {
-          "title": "Clone a nested object",
-          "description": "Creates a deep copy — modifying the clone does not affect the original.",
-          "code": "const original = { a: { b: 1 } };\nconst cloned = deepClone(original);\ncloned.a.b = 2;\n// original.a.b is still 1"
-        }
-      ]
-    },
-    {
-      "name": "deepMerge",
-      "examples": [
-        {
-          "title": "Merge two objects deeply",
-          "description": "Recursively merges source properties into the target object.",
-          "code": "deepMerge({ a: 1, b: { c: 2 } }, { b: { d: 3 }, e: 4 })\n// => { a: 1, b: { c: 2, d: 3 }, e: 4 }"
-        }
-      ]
-    },
     {
       "name": "diff",
       "examples": [
@@ -88,6 +78,11 @@
           "title": "Return default for missing path",
           "description": "Returns the default value when the path does not exist.",
           "code": "get({ a: 1 }, 'b.c', 'default')\n// => 'default'"
+        },
+        {
+          "title": "Get via key array (supports symbols)",
+          "description": "Pass an explicit PropertyKey[] to bypass parsing. Supports string, number, and symbol keys.",
+          "code": "const id = Symbol('id')\nget({ [id]: 'alice' }, [id])\n// => 'alice'"
         }
       ]
     },
@@ -171,6 +166,16 @@
         }
       ]
     },
+    {
+      "name": "mergeDeep",
+      "examples": [
+        {
+          "title": "Merge two objects deeply",
+          "description": "Returns a new object — neither input is mutated.",
+          "code": "mergeDeep({ a: 1, b: { c: 2 } }, { b: { d: 3 }, e: 4 })\n// => { a: 1, b: { c: 2, d: 3 }, e: 4 }"
+        }
+      ]
+    },
     {
       "name": "omit",
       "examples": [
@@ -235,9 +240,19 @@
       "name": "set",
       "examples": [
         {
-          "title": "Set a nested property",
-          "description": "Creates intermediate objects as needed along the dot-notated path.",
-          "code": "set({}, 'a.b.c', 42)\n// => { a: { b: { c: 42 } } }"
+          "title": "Set a nested property (dot notation)",
+          "description": "Creates intermediate objects as needed. All segments are string keys — including numeric-looking ones like \"1\".",
+          "code": "set({}, 'a.b.c', 42)\n// => { a: { b: { c: 42 } } }\n\nset({}, 'layers.1.name', 'bg')\n// => { layers: { '1': { name: 'bg' } } }   // '1' is a string key"
+        },
+        {
+          "title": "Set via bracket notation",
+          "description": "Square-bracket indices become numeric keys. Useful when the path targets an array element.",
+          "code": "const obj = { layers: [{}, { name: 'old' }] }\nset(obj, 'layers[1].name', 'new')\n// => { layers: [{}, { name: 'new' }] }"
+        },
+        {
+          "title": "Set via key array (supports symbols)",
+          "description": "Pass an explicit PropertyKey[] to bypass parsing. Supports string, number, and symbol keys.",
+          "code": "const id = Symbol('id')\nset({}, ['user', id], 'alice')\n// => { user: { [id]: 'alice' } }"
         }
       ]
     }

package/meta/native-alternatives.json

@@ -44,7 +44,7 @@
       "native": "{ ...a, ...b } or Object.assign({}, a, b)",
       "since": "ES2015",
       "example": "const merged = { ...defaults, ...options }",
-      "notes": "For deep merge, use deepMerge from helpers4"
+      "notes": "For deep merge, use mergeDeep from helpers4"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helpers4/object",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "A set of helpers in TS/JS, compatible with tree-shaking, for object.",
   "author": "baxyz <baxy@etik.com>",
   "license": "LGPL-3.0",
@@ -27,9 +27,8 @@
   "keywords": [
     "helpers",
     "object",
+    "cloneDeep",
     "compact",
-    "deepClone",
-    "deepMerge",
     "diff",
     "equalsDeep",
     "equalsShallow",
@@ -39,6 +38,7 @@
     "isEmpty",
     "isNonEmpty",
     "map",
+    "mergeDeep",
     "omit",
     "pick",
     "removeUndefinedNull",