docs changes

docs/core_state_mapping_and_merge.md

@@ -42,15 +42,20 @@ Examples:
 ```json
 {
   "input": [
-    {"target": "user.name", "path": "state.person.name"},
-    {"target": "user.email", "path": "state.digital.email"},
-    {"target": "job.title", "path": "state.job.title"},
-    {"target": "mode", "value": "fast"}
+    {
+      "target": {"root": "local", "parts": ["user", "name"]},
+      "path": {"root": "state", "parts": ["person", "name"]}
+    },
+    {
+      "target": {"root": "local", "parts": ["mode"]},
+      "value": "fast"
+    }
   ],
   "output": [
-    {"source": "job.wage", "target": "state.job.wage"},
-    {"source": "job.years", "target": "state.experience.years"},
-    {"source": "user.age", "target": "state.person.age"}
+    {
+      "source": {"root": "local", "parts": ["job", "wage"]},
+      "target": {"root": "state", "parts": ["job", "wage"]}
+    }
   ]
 }
 ```
@@ -59,8 +64,18 @@ Whole-object mapping remains valid:
 
 ```json
 {
-  "input": [{"target": "user", "path": "state.person"}],
-  "output": [{"source": "user", "target": "state.person"}]
+  "input": [
+    {
+      "target": {"root": "local", "parts": ["user"]},
+      "path": {"root": "state", "parts": ["person"]}
+    }
+  ],
+  "output": [
+    {
+      "source": {"root": "local", "parts": ["user"]},
+      "target": {"root": "state", "parts": ["person"]}
+    }
+  ]
 }
 ```
 
@@ -68,8 +83,18 @@ Whole-payload mapping uses the local root path `"."`:
 
 ```json
 {
-  "input": [{"target": ".", "path": "state.rates"}],
-  "output": [{"source": ".", "target": "state.rates"}]
+  "input": [
+    {
+      "target": {"root": "local", "parts": []},
+      "path": {"root": "state", "parts": ["rates"]}
+    }
+  ],
+  "output": [
+    {
+      "source": {"root": "local", "parts": []},
+      "target": {"root": "state", "parts": ["rates"]}
+    }
+  ]
 }
 ```
 
@@ -96,8 +121,14 @@ Valid:
 
 ```json
 [
-  {"target": "user.name", "path": "state.person.name"},
-  {"target": "user.email", "path": "state.person.email"}
+  {
+    "target": {"root": "local", "parts": ["user", "name"]},
+    "path": {"root": "state", "parts": ["person", "name"]}
+  },
+  {
+    "target": {"root": "local", "parts": ["user", "email"]},
+    "path": {"root": "state", "parts": ["person", "email"]}
+  }
 ]
 ```
 
@@ -105,8 +136,14 @@ Invalid:
 
 ```json
 [
-  {"target": "user", "path": "state.person"},
-  {"target": "user.name", "path": "state.person.name"}
+  {
+    "target": {"root": "local", "parts": ["user"]},
+    "path": {"root": "state", "parts": ["person"]}
+  },
+  {
+    "target": {"root": "local", "parts": ["user", "name"]},
+    "path": {"root": "state", "parts": ["person", "name"]}
+  }
 ]
 ```
 
@@ -122,8 +159,14 @@ Invalid:
 
 ```json
 [
-  {"source": "user", "target": "state.person"},
-  {"source": "user.name", "target": "state.person.name"}
+  {
+    "source": {"root": "local", "parts": ["user"]},
+    "target": {"root": "state", "parts": ["person"]}
+  },
+  {
+    "source": {"root": "local", "parts": ["user", "name"]},
+    "target": {"root": "state", "parts": ["person", "name"]}
+  }
 ]
 ```