@goplasmatic/datalogic-ui 5.5.0 → 5.6.0

package/dist/index.cjs

@@ -2217,18 +2217,17 @@ var variableOperators = {
 					note: "[[1]] jumps out of the map frame to the data holding multiplier"
 				},
 				{
-					title: "Grandparent scope",
-					rule: { map: [{ var: "rows" }, { map: [{ var: "cols" }, { val: [
-						[2],
-						"config",
-						"limit"
-					] }] }] },
-					data: {
-						rows: [{ cols: [1, 2] }, { cols: [3] }],
-						config: { limit: 5 }
-					},
-					result: [[5, 5], [5]],
-					note: "Two nested iterators: [[2]] reaches the root data"
+					title: "Enclosing element from a nested iterator",
+					rule: { map: [{ var: "rows" }, { map: [{ var: "cols" }, { "*": [{ var: "" }, { val: [[2], "rate"] }] }] }] },
+					data: { rows: [{
+						rate: 10,
+						cols: [1, 2]
+					}, {
+						rate: 100,
+						cols: [3]
+					}] },
+					result: [[10, 20], [300]],
+					note: "[[2]] leaves the inner map for the row; [[4]] would reach the root"
 				},
 				{
 					title: "Get iteration index",
@@ -2268,10 +2267,13 @@ var variableOperators = {
 			],
 			notes: [
 				"Path is array of components: [\"a\", \"b\", \"c\"]",
-				"Scope jump: [[N], ...] goes up N context levels",
+				"Scope jump: levels come in pairs, so [[1]] and [[2]] both name the frame one iterator out, [[3]] and [[4]] the next",
 				"Sign is ignored: [1] and [-1] are equivalent",
-				"If level exceeds depth, returns root data",
+				"A level past the outermost frame returns root data",
 				"Iteration metadata: {\"val\": [[1], \"index\"]} and {\"val\": [[1], \"key\"]} (the string form {\"val\": \"index\"} looks up a key named \"index\")",
+				"Outer metadata is odd-numbered: [[3], \"index\"] is the enclosing iterator's index; an even level reads a field of that name instead",
+				"A bare {\"val\": [[N]]} is the frame itself, not a lookup of the key \"N\"",
+				"A marker holds exactly one number: {\"val\": [[0, 1]]} is a path chain, not level 0",
 				"No default argument: use var's second argument or ?? for fallbacks"
 			],
 			seeAlso: ["var", "exists"]
@@ -5435,7 +5437,7 @@ var arrayIterationOperators = {
 		},
 		help: {
 			summary: "Apply an expression to each element of an array",
-			details: "Iterates over an array and applies the given expression to each element. Use {\"var\": \"\"} to access the current element, {\"val\": [[1], \"index\"]} for the current index and {\"val\": [[1], \"field\"]} to read a field from the parent scope.",
+			details: "Iterates over an array and applies the given expression to each element. Use {\"var\": \"\"} to access the current element, {\"val\": [[1], \"index\"]} for the current index and {\"val\": [[1], \"field\"]} to read a field from the enclosing scope.",
 			returnType: "array",
 			examples: [
 				{
@@ -5513,7 +5515,7 @@ var arrayIterationOperators = {
 				"{\"var\": \"\"} = current element",
 				"{\"val\": [[1], \"index\"]} = current index (0, 1, 2...); {\"val\": [[1], \"key\"]} = current key when mapping an object",
 				"{\"val\": \"index\"} (plain string) is a normal key lookup and returns null",
-				"{\"val\": [[1], \"field\"]} = parent scope field",
+				"{\"val\": [[1], \"field\"]} = enclosing scope field (the root, from a single iterator; the outer element from a nested one)",
 				"Returns a new array; original unchanged"
 			],
 			seeAlso: [
@@ -18316,7 +18318,7 @@ function useWasmEvaluator(options = {}) {
 			try {
 				setLoading(true);
 				setError(null);
-				const wasm = await Promise.resolve().then(() => require("./datalogic_wasm-Bckz7njC.cjs"));
+				const wasm = await Promise.resolve().then(() => require("./datalogic_wasm-cDq50xCD.cjs"));
 				await wasm.default();
 				if (!cancelled) {
 					moduleRef.current = { Engine: wasm.Engine };

package/dist/index.js

@@ -2193,18 +2193,17 @@ var variableOperators = {
 					note: "[[1]] jumps out of the map frame to the data holding multiplier"
 				},
 				{
-					title: "Grandparent scope",
-					rule: { map: [{ var: "rows" }, { map: [{ var: "cols" }, { val: [
-						[2],
-						"config",
-						"limit"
-					] }] }] },
-					data: {
-						rows: [{ cols: [1, 2] }, { cols: [3] }],
-						config: { limit: 5 }
-					},
-					result: [[5, 5], [5]],
-					note: "Two nested iterators: [[2]] reaches the root data"
+					title: "Enclosing element from a nested iterator",
+					rule: { map: [{ var: "rows" }, { map: [{ var: "cols" }, { "*": [{ var: "" }, { val: [[2], "rate"] }] }] }] },
+					data: { rows: [{
+						rate: 10,
+						cols: [1, 2]
+					}, {
+						rate: 100,
+						cols: [3]
+					}] },
+					result: [[10, 20], [300]],
+					note: "[[2]] leaves the inner map for the row; [[4]] would reach the root"
 				},
 				{
 					title: "Get iteration index",
@@ -2244,10 +2243,13 @@ var variableOperators = {
 			],
 			notes: [
 				"Path is array of components: [\"a\", \"b\", \"c\"]",
-				"Scope jump: [[N], ...] goes up N context levels",
+				"Scope jump: levels come in pairs, so [[1]] and [[2]] both name the frame one iterator out, [[3]] and [[4]] the next",
 				"Sign is ignored: [1] and [-1] are equivalent",
-				"If level exceeds depth, returns root data",
+				"A level past the outermost frame returns root data",
 				"Iteration metadata: {\"val\": [[1], \"index\"]} and {\"val\": [[1], \"key\"]} (the string form {\"val\": \"index\"} looks up a key named \"index\")",
+				"Outer metadata is odd-numbered: [[3], \"index\"] is the enclosing iterator's index; an even level reads a field of that name instead",
+				"A bare {\"val\": [[N]]} is the frame itself, not a lookup of the key \"N\"",
+				"A marker holds exactly one number: {\"val\": [[0, 1]]} is a path chain, not level 0",
 				"No default argument: use var's second argument or ?? for fallbacks"
 			],
 			seeAlso: ["var", "exists"]
@@ -5411,7 +5413,7 @@ var arrayIterationOperators = {
 		},
 		help: {
 			summary: "Apply an expression to each element of an array",
-			details: "Iterates over an array and applies the given expression to each element. Use {\"var\": \"\"} to access the current element, {\"val\": [[1], \"index\"]} for the current index and {\"val\": [[1], \"field\"]} to read a field from the parent scope.",
+			details: "Iterates over an array and applies the given expression to each element. Use {\"var\": \"\"} to access the current element, {\"val\": [[1], \"index\"]} for the current index and {\"val\": [[1], \"field\"]} to read a field from the enclosing scope.",
 			returnType: "array",
 			examples: [
 				{
@@ -5489,7 +5491,7 @@ var arrayIterationOperators = {
 				"{\"var\": \"\"} = current element",
 				"{\"val\": [[1], \"index\"]} = current index (0, 1, 2...); {\"val\": [[1], \"key\"]} = current key when mapping an object",
 				"{\"val\": \"index\"} (plain string) is a normal key lookup and returns null",
-				"{\"val\": [[1], \"field\"]} = parent scope field",
+				"{\"val\": [[1], \"field\"]} = enclosing scope field (the root, from a single iterator; the outer element from a nested one)",
 				"Returns a new array; original unchanged"
 			],
 			seeAlso: [
@@ -18280,7 +18282,7 @@ function useWasmEvaluator(options = {}) {
 			try {
 				setLoading(true);
 				setError(null);
-				const wasm = await import("./datalogic_wasm-CPBxmvK8.js");
+				const wasm = await import("./datalogic_wasm-DLPe7qGz.js");
 				await wasm.default();
 				if (!cancelled) {
 					moduleRef.current = { Engine: wasm.Engine };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goplasmatic/datalogic-ui",
   "private": false,
-  "version": "5.5.0",
+  "version": "5.6.0",
   "type": "module",
   "description": "React rule builder, visual debugger, and editor for JSONLogic (json-logic) — flow-diagram view and live execution tracing, powered by the datalogic-rs WASM engine.",
   "keywords": [
@@ -86,7 +86,7 @@
     "@eslint/js": "^10.0.1",
     "@fontsource/jetbrains-mono": "^5.3.0",
     "@fontsource/space-grotesk": "^5.3.0",
-    "@goplasmatic/datalogic-wasm": "5.5.0",
+    "@goplasmatic/datalogic-wasm": "5.6.0",
     "@msgpack/msgpack": "^3.1.3",
     "@types/node": "^26.5.1",
     "@types/react": "^19.3.0",