@ea-lab/reactive-json 2.1.0 → 2.3.0

package/dist/engine/ReactiveJsonRoot.js

@@ -1,317 +1,328 @@
-import { jsx as p, jsxs as H, Fragment as st } from "react/jsx-runtime";
-import { a as J } from "../index-BUPRVmV-.js";
-import { useRef as K, useState as Q, useEffect as V, useMemo as it } from "react";
-import { r as ct } from "../dnd-kit-sortable-tree.esm-Cz1RJyIg.js";
-import { coreComponentsPlugin as X } from "../coreComponentsPlugin.js";
-import { mergeComponentCollections as pt } from "./ComponentCollector.js";
-import { DataStore as lt } from "./DataStore.js";
-import { EventDispatcherProvider as dt } from "./EventDispatcherProvider.js";
-import { GlobalDataContext as ut } from "./GlobalDataContext.js";
-import mt from "./ParsingDebugDisplay/ParsingDebugDisplay.js";
-import { StoreContext as ft } from "./StoreContext.js";
-import { TemplateContext as gt } from "./TemplateContext.js";
-import { dataLocationToPath as ht } from "./TemplateSystem.js";
-import { useReactiveData as Pt } from "./hook/useReactiveData.js";
-import { alterData as yt } from "./utility/alterData.js";
-import { applyDataMapping as Dt } from "./utility/dataMappingSystem.js";
-import { parseRjBuild as wt } from "./utility/parseRjBuild.js";
-import { stringToBoolean as bt } from "./utility/stringToBoolean.js";
-import { View as Ct } from "./View.js";
-const St = ({ Wrapper: m }) => {
-  const E = Pt("");
-  return /* @__PURE__ */ p(m, { children: JSON.stringify(E, null, "  ") });
-}, xt = ({
-  dataOverride: m,
-  dataFetchMethod: E,
-  dataUrl: G,
-  debugMode: Y,
-  DebugModeContentWrapper: L,
-  DebugModeDataWrapper: O,
-  DebugModeRootWrapper: Z,
-  headersForData: z,
+import { jsx as u, jsxs as Y, Fragment as lt } from "react/jsx-runtime";
+import { a as L } from "../index-BUPRVmV-.js";
+import { useRef as Z, useState as U, useEffect as N, useMemo as pt } from "react";
+import { r as dt } from "../dnd-kit-sortable-tree.esm-Cz1RJyIg.js";
+import { coreComponentsPlugin as F } from "../coreComponentsPlugin.js";
+import { mergeComponentCollections as ut } from "./ComponentCollector.js";
+import { DataStore as mt } from "./DataStore.js";
+import { EventDispatcherProvider as ft } from "./EventDispatcherProvider.js";
+import { GlobalDataContext as gt } from "./GlobalDataContext.js";
+import ht from "./ParsingDebugDisplay/ParsingDebugDisplay.js";
+import { StoreContext as yt } from "./StoreContext.js";
+import { TemplateContext as Pt } from "./TemplateContext.js";
+import { dataLocationToPath as Dt } from "./TemplateSystem.js";
+import { useReactiveData as wt } from "./hook/useReactiveData.js";
+import { alterData as bt } from "./utility/alterData.js";
+import { applyDataMapping as St } from "./utility/dataMappingSystem.js";
+import { parseRjBuild as Ct } from "./utility/parseRjBuild.js";
+import { interpolateSegments as vt } from "./utility/interpolateSegments.js";
+import { stringToBoolean as Et } from "./utility/stringToBoolean.js";
+import { View as xt } from "./View.js";
+const kt = ({ Wrapper: g }) => {
+  const T = wt("");
+  return /* @__PURE__ */ u(g, { children: JSON.stringify(T, null, "  ") });
+}, At = ({
+  dataOverride: g,
+  dataFetchMethod: T,
+  dataUrl: O,
+  debugMode: tt,
+  DebugModeContentWrapper: q,
+  DebugModeDataWrapper: z,
+  DebugModeRootWrapper: et,
+  headersForData: I,
   headersForRjBuild: s,
-  maybeRawAppData: I,
-  maybeRawAppRjBuild: w,
-  plugins: N,
-  rjBuildFetchMethod: b,
-  rjBuildUrl: f,
-  upstreamUpdateCallbacks: R
+  maybeRawAppData: M,
+  maybeRawAppRjBuild: S,
+  plugins: R,
+  rjBuildFetchMethod: C,
+  rjBuildUrl: h,
+  upstreamUpdateCallbacks: $
 }) => {
-  const g = [];
-  E && (g.push({
+  const y = [];
+  T && (y.push({
     deprecatedProperty: "dataFetchMethod",
     newProperty: "rjBuildFetchMethod"
-  }), b = E), G && (g.push({
+  }), C = T), O && (y.push({
     deprecatedProperty: "dataUrl",
     newProperty: "rjBuildUrl"
-  }), f = G), z && (g.push({
+  }), h = O), I && (y.push({
     deprecatedProperty: "headersForData",
     newProperty: "headersForRjBuild"
-  }), s = z), I && (g.push({
+  }), s = I), M && (y.push({
     deprecatedProperty: "maybeRawAppData",
     newProperty: "maybeRawAppRjBuild"
-  }), w = I), g.length > 0 && console.warn(
-    "A ReactiveJsonRoot component got the following deprecated properties that must be replaced: " + g.map((t) => t.deprecatedProperty + " -> " + t.newProperty).join(", ")
+  }), S = M), y.length > 0 && console.warn(
+    "A ReactiveJsonRoot component got the following deprecated properties that must be replaced: " + y.map((t) => t.deprecatedProperty + " -> " + t.newProperty).join(", ")
   );
-  const a = K(new lt({})).current, [d, C] = Q({
+  const o = Z(new mt({})).current, [m, v] = U({
     templates: {},
     renderView: {},
     items: [],
     rawAppRjBuild: null
-  }), [T, M] = Q(null), o = K(null);
-  V(() => () => {
-    typeof document < "u" && o.current && o.current.parentNode && (o.current.parentNode.removeChild(o.current), o.current = null);
+  }), [j, W] = U(null), a = Z(null);
+  N(() => () => {
+    typeof document < "u" && a.current && a.current.parentNode && (a.current.parentNode.removeChild(a.current), a.current = null);
   }, []);
-  const S = it(
-    () => N ? pt([X, N]) : X,
-    [N]
+  const E = pt(
+    () => R ? ut([F, R]) : F,
+    [R]
   );
-  V(() => {
-    let t = w;
-    typeof t == "string" || t && (t = JSON.stringify(t)), t && C((r) => ({ ...r, rawAppRjBuild: t }));
-  }, [w]), V(() => {
-    if (!f) return;
+  N(() => {
+    let t = S;
+    typeof t == "string" || t && (t = JSON.stringify(t)), t && v((r) => ({ ...r, rawAppRjBuild: t }));
+  }, [S]), N(() => {
+    if (!h) return;
     const t = {
-      method: b || "GET",
-      url: f,
+      method: C || "GET",
+      url: h,
       headers: s
     };
-    t.method.toLowerCase() === "post" ? J.post(t.url, {}, { headers: t.headers }).then((r) => {
-      C((i) => ({ ...i, rawAppRjBuild: r.data }));
-    }) : J.get(t.url, { headers: t.headers }).then((r) => {
-      C((i) => ({ ...i, rawAppRjBuild: r.data }));
+    t.method.toLowerCase() === "post" ? L.post(t.url, {}, { headers: t.headers }).then((r) => {
+      v((c) => ({ ...c, rawAppRjBuild: r.data }));
+    }) : L.get(t.url, { headers: t.headers }).then((r) => {
+      v((c) => ({ ...c, rawAppRjBuild: r.data }));
     });
-  }, [f, s, b]), V(() => {
-    if (!d.rawAppRjBuild) return;
-    const t = wt(d.rawAppRjBuild);
+  }, [h, s, C]), N(() => {
+    if (!m.rawAppRjBuild) return;
+    const t = Ct(m.rawAppRjBuild);
     if (!t.success) {
       if (console.group(
         `Tried to load the app's RjBuild but the ${t.format} content could not be parsed.`
       ), console.error(t.error.message), console.debug("Context:", {
-        rjBuildUrl: f,
-        rjBuildFetchMethod: b,
+        rjBuildUrl: h,
+        rjBuildFetchMethod: C,
         headersForRjBuild: s,
-        maybeRawAppRjBuild: w,
-        dataOverride: m
+        maybeRawAppRjBuild: S,
+        dataOverride: g
       }), console.debug("Error details:", t.error), console.groupEnd(), typeof document < "u") {
         let e = document.getElementById("rj-parsing-error-root");
-        if (e || (e = document.createElement("div"), e.id = "rj-parsing-error-root", document.body.appendChild(e)), !o.current) {
-          const l = document.createElement("div");
-          e.appendChild(l), o.current = l;
+        if (e || (e = document.createElement("div"), e.id = "rj-parsing-error-root", document.body.appendChild(e)), !a.current) {
+          const i = document.createElement("div");
+          e.appendChild(i), a.current = i;
         }
-        M(
-          ct.createPortal(
-            /* @__PURE__ */ p(
-              mt,
+        W(
+          dt.createPortal(
+            /* @__PURE__ */ u(
+              ht,
               {
                 processedRjBuild: t,
                 errorContext: {
-                  rjBuildUrl: f,
-                  rjBuildFetchMethod: b,
+                  rjBuildUrl: h,
+                  rjBuildFetchMethod: C,
                   headersForRjBuild: s,
-                  maybeRawAppRjBuild: w
+                  maybeRawAppRjBuild: S
                 }
               }
             ),
-            o.current,
+            a.current,
             () => {
-              o.current && (o.current.parentNode.removeChild(o.current), o.current = null);
+              a.current && (a.current.parentNode.removeChild(a.current), a.current = null);
             }
           )
         );
       }
       return;
     }
-    T && (M(null), typeof document < "u" && o.current && o.current.parentNode && (o.current.parentNode.removeChild(o.current), o.current = null));
-    const r = t.data, i = m !== void 0 ? m : r.data;
-    a.set("", i);
+    j && (W(null), typeof document < "u" && a.current && a.current.parentNode && (a.current.parentNode.removeChild(a.current), a.current = null));
+    const r = t.data, c = g !== void 0 ? g : r.data;
+    o.set("", c);
     const n = {
       templates: r.templates ?? r.listForms ?? {},
       renderView: r.renderView ?? {},
       items: Object.keys(r.renderView ?? {}),
-      rawAppRjBuild: d.rawAppRjBuild
-    }, h = r.additionalDataSource;
-    if (!Array.isArray(h) || h.length === 0) {
-      C((e) => ({ ...e, ...n }));
+      rawAppRjBuild: m.rawAppRjBuild
+    }, P = r.additionalDataSource;
+    if (!Array.isArray(P) || P.length === 0) {
+      v((e) => ({ ...e, ...n }));
       return;
     }
-    const x = h.filter((e) => e.blocking === !0), A = h.filter((e) => e.blocking !== !0), B = (e) => !e || e === "data" ? "" : e.startsWith("data.") ? e.substring(5) : e, _ = async (e, l) => {
-      var P;
+    const x = P.filter((e) => e.blocking === !0), V = P.filter((e) => e.blocking !== !0), _ = (e) => !e || e === "data" ? "" : e.startsWith("data.") ? e.substring(5) : e, J = async (e, i) => {
+      var X;
+      const { fallbackDataSource: D, ...l } = e, K = async (p) => {
+        D ? (console.warn(`additionalDataSource item ${i}: ${p} — trying fallbackDataSource.`), await J(D, i)) : console.warn(`additionalDataSource item ${i}: ${p}.`, l);
+      }, Q = vt(l.src, (p) => o.get(p));
+      if (!Q) {
+        await K("could not resolve 'src'");
+        return;
+      }
+      const w = {
+        method: ((X = l.method) == null ? void 0 : X.toUpperCase()) || "GET",
+        url: Q
+      };
+      s && Object.keys(s).length > 0 && (w.headers = s);
+      let k;
       try {
-        if (!e.src) {
-          console.warn("additionalDataSource item number " + l + " missing 'src' property.", e);
-          return;
-        }
-        const y = {
-          method: ((P = e.method) == null ? void 0 : P.toUpperCase()) || "GET",
-          url: e.src
-        };
-        s && Object.keys(s).length > 0 && (y.headers = s);
-        const k = await J(y), rt = {
-          url: y.url,
-          method: y.method,
-          headers: y.headers || {},
-          body: y.data
-        }, ot = {
+        k = await L(w);
+      } catch (p) {
+        await K(`HTTP request failed (${p.message})`);
+        return;
+      }
+      try {
+        const p = {
+          url: w.url,
+          method: w.method,
+          headers: w.headers || {},
+          body: w.data
+        }, st = {
           headers: k.headers || {},
           status: k.status,
           data: k.data
-        }, D = yt({
-          requestContext: rt,
-          responseContext: ot,
+        }, b = bt({
+          requestContext: p,
+          responseContext: st,
           responseBody: k.data,
           // additionalDataSource always processes raw data, not RjBuild.
           isRjBuild: !1,
-          dataProcessors: (S == null ? void 0 : S.dataProcessor) || {}
+          dataProcessors: (E == null ? void 0 : E.dataProcessor) || {}
         });
-        if (e.dataMapping) {
-          const u = {
+        if (l.dataMapping) {
+          const f = {
             headersForRjBuild: s,
-            plugins: S,
+            plugins: E,
             get templateData() {
-              return a.get("");
+              return o.get("");
             },
             templatePath: "data",
-            setData: (c) => a.set("", c),
-            updateData: (c, j, at) => {
-              const nt = B(j);
-              a.set(nt, c, at);
+            setData: (d) => o.set("", d),
+            updateData: (d, G, ct) => {
+              const it = _(G);
+              o.set(it, d, ct);
             }
-          }, v = {
+          }, A = {
             get templateData() {
-              return a.get("");
+              return o.get("");
             },
             templatePath: "data"
           };
           try {
-            Dt({
-              dataMapping: e.dataMapping,
-              responseData: D,
-              globalDataContext: u,
-              templateContext: v
+            St({
+              dataMapping: l.dataMapping,
+              responseData: b,
+              globalDataContext: f,
+              templateContext: A
             });
             return;
-          } catch (c) {
-            console.error("Error applying dataMapping for additionalDataSource:", c);
+          } catch (d) {
+            console.error("Error applying dataMapping for additionalDataSource:", d);
           }
         }
-        if (!e.path) {
-          if (typeof D != "object" || Array.isArray(D)) {
+        if (!l.path) {
+          if (typeof b != "object" || Array.isArray(b)) {
             console.warn(
               "additionalDataSource data cannot be merged at root - must be an object:",
-              D
+              b
             );
             return;
           }
-          Object.entries(D).forEach(([u, v]) => {
-            a.set(u, v);
+          Object.entries(b).forEach(([f, A]) => {
+            o.set(f, A);
           });
           return;
         }
         try {
-          const u = {
-            templateData: a.get(""),
+          const f = {
+            templateData: o.get(""),
             // use current snapshot
             templatePath: "data"
-          }, v = {
-            templateData: a.get(""),
+          }, A = {
+            templateData: o.get(""),
             // use current snapshot
             templatePath: "data"
-          }, c = ht({
-            dataLocation: e.path,
+          }, d = Dt({
+            dataLocation: l.path,
             currentPath: "data",
-            globalDataContext: u,
-            templateContext: v
+            globalDataContext: f,
+            templateContext: A
           });
-          if (typeof c != "string") {
+          if (typeof d != "string") {
             console.warn(
               "additionalDataSource path evaluation did not result in a string:",
-              e.path,
+              l.path,
               "->",
-              c
+              d
             );
             return;
           }
-          const j = B(c);
-          a.set(j, D);
-        } catch (u) {
-          console.error("Error evaluating additionalDataSource path:", e.path, u);
+          const G = _(d);
+          o.set(G, b);
+        } catch (f) {
+          console.error("Error evaluating additionalDataSource path:", l.path, f);
         }
-      } catch ($) {
-        console.error("Error fetching additional data source:", e.src, $);
+      } catch (p) {
+        console.error("Error processing additionalDataSource response:", l.src, p);
       }
     };
     (async () => {
       if (x.length > 0) {
-        const e = x.map((l, P) => _(l, P));
+        const e = x.map((i, D) => J(i, D));
         await Promise.allSettled(e);
       }
-      if (C((e) => ({ ...e, ...n })), A.length > 0) {
-        const e = A.map(
-          (l, P) => _(l, x.length + P)
+      if (v((e) => ({ ...e, ...n })), V.length > 0) {
+        const e = V.map(
+          (i, D) => J(i, x.length + D)
         );
         Promise.allSettled(e);
       }
     })();
-  }, [d.rawAppRjBuild, m, a]);
-  function W(t, r, i) {
-    if (!R || R.size === 0)
+  }, [m.rawAppRjBuild, g, o]);
+  function B(t, r, c) {
+    if (!$ || $.size === 0)
       return !1;
-    for (const [n, h] of R)
+    for (const [n, P] of $)
       if (t === n || t.startsWith(n + ".") || n === "") {
         const x = n === "" ? t : t.substring(n.length + 1);
         try {
-          return h(r, x, i), !0;
-        } catch (A) {
-          console.warn("Error during upstream update:", A);
+          return P(r, x, c), !0;
+        } catch (V) {
+          console.warn("Error during upstream update:", V);
           break;
         }
       }
     return !1;
   }
-  const U = (t) => {
-    W("", t, void 0) || a.set("", t);
-  }, F = (t, r, i) => {
+  const rt = (t) => {
+    B("", t, void 0) || o.set("", t);
+  }, ot = (t, r, c) => {
     const n = r.startsWith("data.") ? r.substring(5) : r === "data" ? "" : r;
-    W(n, t, i) || a.set(n, t, i);
-  }, tt = {
-    element: d.templates,
+    B(n, t, c) || o.set(n, t, c);
+  }, at = {
+    element: m.templates,
     headersForRjBuild: s,
-    plugins: S,
-    ReactiveJsonRoot: xt,
-    setData: U,
-    updateData: F,
+    plugins: E,
+    ReactiveJsonRoot: At,
+    setData: rt,
+    updateData: ot,
     // experimental: expose store for advanced usage
-    store: a,
+    store: o,
     // fallback: get data from store directly (non-reactive access)
     get templateData() {
-      return a.get("");
+      return o.get("");
     },
     templatePath: "data"
-  }, q = d.items.map((t) => /* @__PURE__ */ p(
-    Ct,
+  }, H = m.items.map((t) => /* @__PURE__ */ u(
+    xt,
     {
       datafield: t,
       path: "data." + t,
-      props: d.renderView[t]
+      props: m.renderView[t]
     },
     t
-  )), et = bt(Y);
-  return /* @__PURE__ */ p(ft.Provider, { value: a, children: /* @__PURE__ */ p(dt, { children: /* @__PURE__ */ p(ut.Provider, { value: tt, children: /* @__PURE__ */ p(gt.Provider, { value: {
+  )), nt = Et(tt);
+  return /* @__PURE__ */ u(yt.Provider, { value: o, children: /* @__PURE__ */ u(ft, { children: /* @__PURE__ */ u(gt.Provider, { value: at, children: /* @__PURE__ */ u(Pt.Provider, { value: {
     // Same here, getter for compatibility, but won't trigger updates
     get templateData() {
-      return a.get("");
+      return o.get("");
     },
     templatePath: "data"
-  }, children: et && L ? /* @__PURE__ */ H(Z, { children: [
-    /* @__PURE__ */ p(L, { children: q }),
-    O && /* @__PURE__ */ p(St, { Wrapper: O }),
-    T
-  ] }) : /* @__PURE__ */ H(st, { children: [
-    q,
-    T
+  }, children: nt && q ? /* @__PURE__ */ Y(et, { children: [
+    /* @__PURE__ */ u(q, { children: H }),
+    z && /* @__PURE__ */ u(kt, { Wrapper: z }),
+    j
+  ] }) : /* @__PURE__ */ Y(lt, { children: [
+    H,
+    j
   ] }) }) }) }) });
 };
 export {
-  xt as ReactiveJsonRoot
+  At as ReactiveJsonRoot
 };

package/dist/engine/index.js

@@ -6,8 +6,8 @@ import { EventDispatcherProvider as f, addEventListener as s, removeEventListene
 import { GlobalDataContext as c } from "./GlobalDataContext.js";
 import { GlobalDataContextProvider as D } from "./GlobalDataContextProvider.js";
 import { PaginationContext as b } from "./PaginationContext.js";
-import { ReactiveJsonRoot as R } from "./ReactiveJsonRoot.js";
-import { StoreContext as g, StoreProvider as A, useStore as E } from "./StoreContext.js";
+import { ReactiveJsonRoot as P } from "./ReactiveJsonRoot.js";
+import { StoreContext as S, StoreProvider as T, useStore as A } from "./StoreContext.js";
 import { TemplateContext as V } from "./TemplateContext.js";
 import { dataLocationToPath as L, evaluateAttributes as y, evaluateTemplateValue as z, evaluateTemplateValueCollection as F, isTemplateValue as J, useEvaluatedAttributes as B } from "./TemplateSystem.js";
 import { useReactiveData as j } from "./hook/useReactiveData.js";
@@ -19,8 +19,9 @@ import { formatString as Q, maybeFormatString as U } from "./utility/formatStrin
 import { propsDataLocationToPathAndValue as X } from "./utility/formElementsCommon.js";
 import { parseRjBuild as Z } from "./utility/parseRjBuild.js";
 import { normalizeAttributeNameForReactJsx as $, normalizeAttributesForReactJsx as ee } from "./utility/reactJsxHelpers.js";
-import { stringToBoolean as oe } from "./utility/stringToBoolean.js";
-import { View as ae } from "./View.js";
+import { interpolateSegments as oe } from "./utility/interpolateSegments.js";
+import { stringToBoolean as ae } from "./utility/stringToBoolean.js";
+import { View as me } from "./View.js";
 export {
   o as ActionDependant,
   n as DataStore,
@@ -29,11 +30,11 @@ export {
   c as GlobalDataContext,
   D as GlobalDataContextProvider,
   b as PaginationContext,
-  R as ReactiveJsonRoot,
-  g as StoreContext,
-  A as StoreProvider,
+  P as ReactiveJsonRoot,
+  S as StoreContext,
+  T as StoreProvider,
   V as TemplateContext,
-  ae as View,
+  me as View,
   s as addEventListener,
   M as alterData,
   O as analyzeDataOverrideReferences,
@@ -43,6 +44,7 @@ export {
   z as evaluateTemplateValue,
   F as evaluateTemplateValueCollection,
   Q as formatString,
+  oe as interpolateSegments,
   J as isTemplateValue,
   r as isValid,
   U as maybeFormatString,
@@ -53,8 +55,8 @@ export {
   X as propsDataLocationToPathAndValue,
   u as removeEventListener,
   I as replaceEventPlaceholders,
-  oe as stringToBoolean,
+  ae as stringToBoolean,
   B as useEvaluatedAttributes,
   j as useReactiveData,
-  E as useStore
+  A as useStore
 };

package/dist/engine/utility/index.js

@@ -4,19 +4,21 @@ import { applyDataMapping as m } from "./dataMappingSystem.js";
 import { replaceEventPlaceholders as f } from "./eventPlaceholderSystem.js";
 import { formatString as l, maybeFormatString as x } from "./formatString.js";
 import { propsDataLocationToPathAndValue as c } from "./formElementsCommon.js";
-import { parseRjBuild as g } from "./parseRjBuild.js";
+import { parseRjBuild as d } from "./parseRjBuild.js";
 import { normalizeAttributeNameForReactJsx as D, normalizeAttributesForReactJsx as R } from "./reactJsxHelpers.js";
-import { stringToBoolean as y } from "./stringToBoolean.js";
+import { interpolateSegments as y } from "./interpolateSegments.js";
+import { stringToBoolean as A } from "./stringToBoolean.js";
 export {
   o as alterData,
   a as analyzeDataOverrideReferences,
   m as applyDataMapping,
   l as formatString,
+  y as interpolateSegments,
   x as maybeFormatString,
   D as normalizeAttributeNameForReactJsx,
   R as normalizeAttributesForReactJsx,
-  g as parseRjBuild,
+  d as parseRjBuild,
   c as propsDataLocationToPathAndValue,
   f as replaceEventPlaceholders,
-  y as stringToBoolean
+  A as stringToBoolean
 };

package/dist/engine/utility/interpolateSegments.js

@@ -0,0 +1,63 @@
+const i = (e, l) => {
+  if (typeof e == "string") {
+    let t = null;
+    if (e.startsWith("~~.") ? t = e.substring(3) : e.startsWith("~.") && (t = e.substring(2)), t !== null) {
+      const r = l(t);
+      return r == null ? null : String(r);
+    }
+    return e;
+  }
+  return e == null ? null : String(e);
+}, p = (e, l) => {
+  if (typeof e == "string")
+    return e || null;
+  if (!Array.isArray(e) || e.length === 0)
+    return null;
+  const t = [], r = [];
+  for (const n of e) {
+    if (n !== null && typeof n == "object") {
+      if ("param" in n) {
+        const o = i(n.param, l), s = i(n.value, l);
+        if (!o || !s) {
+          if (n.required)
+            return console.warn(
+              `interpolateSegments: required param "${n.param}" resolved to empty key or value — aborting URL.`
+            ), null;
+          continue;
+        }
+        r.push(
+          `${encodeURIComponent(o)}=${encodeURIComponent(s)}`
+        );
+        continue;
+      }
+      if ("segment" in n) {
+        const o = i(n.segment, l);
+        if (!o) {
+          if (n.required)
+            return console.warn(
+              `interpolateSegments: required segment "${n.segment}" resolved to empty — aborting URL.`
+            ), null;
+          t.push("");
+          continue;
+        }
+        t.push(o);
+        continue;
+      }
+      console.warn("interpolateSegments: unrecognized segment object.", n);
+      continue;
+    }
+    if (typeof n == "string") {
+      const o = i(n, l);
+      o === null ? (console.warn(
+        `interpolateSegments: reference "${n}" resolved to null.`
+      ), t.push("")) : t.push(o);
+      continue;
+    }
+    t.push(String(n ?? ""));
+  }
+  const u = t.join(""), a = r.length > 0 ? "?" + r.join("&") : "";
+  return u + a || null;
+};
+export {
+  p as interpolateSegments
+};

package/dist/main.js

@@ -35,117 +35,118 @@ import { formatString as Se, maybeFormatString as he } from "./engine/utility/fo
 import { propsDataLocationToPathAndValue as Ee } from "./engine/utility/formElementsCommon.js";
 import { parseRjBuild as Ve } from "./engine/utility/parseRjBuild.js";
 import { normalizeAttributeNameForReactJsx as He, normalizeAttributesForReactJsx as Me } from "./engine/utility/reactJsxHelpers.js";
-import { stringToBoolean as Be } from "./engine/utility/stringToBoolean.js";
-import { View as ke } from "./engine/View.js";
-import { simpleMapping as Ne } from "./component/dataMapping/simpleMapping.js";
-import { VariablesDebug as Ue } from "./component/element/debug/VariablesDebug/VariablesDebug.js";
-import { Input as Ie } from "./component/element/form/Input.js";
-import { CheckBoxField as We } from "./component/element/form/CheckBoxField.js";
-import { ColorField as qe } from "./component/element/form/ColorField.js";
-import { DateField as Qe } from "./component/element/form/DateField.js";
-import { DateTimeField as Ye } from "./component/element/form/DateTimeField.js";
-import { EmailField as _e } from "./component/element/form/EmailField.js";
-import { FileField as eo } from "./component/element/form/FileField.js";
-import { HiddenField as ro } from "./component/element/form/HiddenField.js";
-import { MonthField as ao } from "./component/element/form/MonthField.js";
-import { NumberField as po } from "./component/element/form/NumberField.js";
-import { PasswordField as fo } from "./component/element/form/PasswordField.js";
-import { RangeField as lo } from "./component/element/form/RangeField.js";
-import { SearchField as so } from "./component/element/form/SearchField.js";
-import { SelectField as co } from "./component/element/form/SelectField.js";
-import { TelField as Do } from "./component/element/form/TelField.js";
-import { TextAreaField as Co } from "./component/element/form/TextAreaField.js";
-import { TextField as go } from "./component/element/form/TextField.js";
-import { TimeField as Ro } from "./component/element/form/TimeField.js";
-import { UrlField as ho } from "./component/element/form/UrlField.js";
-import { WeekField as Eo } from "./component/element/form/WeekField.js";
-import { FolderSortableTree as Vo } from "./component/element/html/FolderSortableTree.js";
-import { FormatNumeral as Ho } from "./component/element/html/FormatNumeral.js";
-import { Html as yo } from "./component/element/html/Html.js";
-import { LabelFromValue as Jo } from "./component/element/html/LabelFromValue.js";
-import { PreformattedMarkup as wo } from "./component/element/html/PreformattedMarkup.js";
-import { SortableTreeItemCollapseButton as zo } from "./component/element/html/SortableTreeItemCollapseButton.js";
-import { Count as Go } from "./component/element/special/Count.js";
-import { DataFilter as Oo } from "./component/element/special/DataFilter.js";
-import { DataSync as jo } from "./component/element/special/DataSync.js";
-import { DelayedActions as Ko, getReactionFunctionsToExecute as Qo } from "./component/element/special/DelayedActions.js";
-import { PageControls as Yo } from "./component/element/special/PageControls.js";
-import { Phantom as _o } from "./component/element/special/Phantom.js";
-import { ReactiveJsonBasicComponentWrapper as er } from "./component/element/special/ReactiveJsonBasicComponentWrapper.js";
-import { ReactiveJsonSubroot as rr } from "./component/element/special/ReactiveJsonSubroot.js";
-import { Switch as ar } from "./component/element/special/Switch.js";
-import { addData as pr } from "./component/reaction/addData.js";
-import { fetchData as fr } from "./component/reaction/fetchData.js";
-import { executeHttpRequest as lr } from "./component/reaction/utility/httpRequestCommon.js";
-import { moveData as sr } from "./component/reaction/moveData.js";
-import { postMessage as ur } from "./component/reaction/postMessage.js";
-import { redirectNow as Fr } from "./component/reaction/redirectNow.js";
-import { removeData as vr } from "./component/reaction/removeData.js";
-import { setClipboardData as br } from "./component/reaction/setClipboardData.js";
-import { setData as Tr } from "./component/reaction/setData.js";
-import { submitData as Sr } from "./component/reaction/submitData.js";
-import { triggerEvent as Ar } from "./component/reaction/triggerEvent.js";
+import { interpolateSegments as Be } from "./engine/utility/interpolateSegments.js";
+import { stringToBoolean as ke } from "./engine/utility/stringToBoolean.js";
+import { View as Ne } from "./engine/View.js";
+import { simpleMapping as Ue } from "./component/dataMapping/simpleMapping.js";
+import { VariablesDebug as Ie } from "./component/element/debug/VariablesDebug/VariablesDebug.js";
+import { Input as We } from "./component/element/form/Input.js";
+import { CheckBoxField as qe } from "./component/element/form/CheckBoxField.js";
+import { ColorField as Qe } from "./component/element/form/ColorField.js";
+import { DateField as Ye } from "./component/element/form/DateField.js";
+import { DateTimeField as _e } from "./component/element/form/DateTimeField.js";
+import { EmailField as eo } from "./component/element/form/EmailField.js";
+import { FileField as ro } from "./component/element/form/FileField.js";
+import { HiddenField as ao } from "./component/element/form/HiddenField.js";
+import { MonthField as po } from "./component/element/form/MonthField.js";
+import { NumberField as fo } from "./component/element/form/NumberField.js";
+import { PasswordField as lo } from "./component/element/form/PasswordField.js";
+import { RangeField as so } from "./component/element/form/RangeField.js";
+import { SearchField as co } from "./component/element/form/SearchField.js";
+import { SelectField as Do } from "./component/element/form/SelectField.js";
+import { TelField as Co } from "./component/element/form/TelField.js";
+import { TextAreaField as go } from "./component/element/form/TextAreaField.js";
+import { TextField as Ro } from "./component/element/form/TextField.js";
+import { TimeField as ho } from "./component/element/form/TimeField.js";
+import { UrlField as Eo } from "./component/element/form/UrlField.js";
+import { WeekField as Vo } from "./component/element/form/WeekField.js";
+import { FolderSortableTree as Ho } from "./component/element/html/FolderSortableTree.js";
+import { FormatNumeral as yo } from "./component/element/html/FormatNumeral.js";
+import { Html as Jo } from "./component/element/html/Html.js";
+import { LabelFromValue as wo } from "./component/element/html/LabelFromValue.js";
+import { PreformattedMarkup as zo } from "./component/element/html/PreformattedMarkup.js";
+import { SortableTreeItemCollapseButton as Go } from "./component/element/html/SortableTreeItemCollapseButton.js";
+import { Count as Oo } from "./component/element/special/Count.js";
+import { DataFilter as jo } from "./component/element/special/DataFilter.js";
+import { DataSync as Ko } from "./component/element/special/DataSync.js";
+import { DelayedActions as Xo, getReactionFunctionsToExecute as Yo } from "./component/element/special/DelayedActions.js";
+import { PageControls as _o } from "./component/element/special/PageControls.js";
+import { Phantom as er } from "./component/element/special/Phantom.js";
+import { ReactiveJsonBasicComponentWrapper as rr } from "./component/element/special/ReactiveJsonBasicComponentWrapper.js";
+import { ReactiveJsonSubroot as ar } from "./component/element/special/ReactiveJsonSubroot.js";
+import { Switch as pr } from "./component/element/special/Switch.js";
+import { addData as fr } from "./component/reaction/addData.js";
+import { fetchData as lr } from "./component/reaction/fetchData.js";
+import { executeHttpRequest as sr } from "./component/reaction/utility/httpRequestCommon.js";
+import { moveData as ur } from "./component/reaction/moveData.js";
+import { postMessage as Fr } from "./component/reaction/postMessage.js";
+import { redirectNow as vr } from "./component/reaction/redirectNow.js";
+import { removeData as br } from "./component/reaction/removeData.js";
+import { setClipboardData as Tr } from "./component/reaction/setClipboardData.js";
+import { setData as Sr } from "./component/reaction/setData.js";
+import { submitData as Ar } from "./component/reaction/submitData.js";
+import { triggerEvent as Pr } from "./component/reaction/triggerEvent.js";
 export {
   B as ActionDependant,
-  We as CheckBoxField,
-  qe as ColorField,
-  Go as Count,
+  qe as CheckBoxField,
+  Qe as ColorField,
+  Oo as Count,
   r as CustomEventListener,
-  Oo as DataFilter,
+  jo as DataFilter,
   z as DataStore,
-  jo as DataSync,
-  Qe as DateField,
-  Ye as DateTimeField,
-  Ko as DelayedActions,
-  _e as EmailField,
+  Ko as DataSync,
+  Ye as DateField,
+  _e as DateTimeField,
+  Xo as DelayedActions,
+  eo as EmailField,
   G as EventDispatcherContext,
   O as EventDispatcherProvider,
-  eo as FileField,
-  Vo as FolderSortableTree,
-  Ho as FormatNumeral,
+  ro as FileField,
+  Ho as FolderSortableTree,
+  yo as FormatNumeral,
   K as GlobalDataContext,
   X as GlobalDataContextProvider,
   a as HashChangeListener,
-  ro as HiddenField,
+  ao as HiddenField,
   p as Hide,
-  yo as Html,
-  Ie as Input,
-  Jo as LabelFromValue,
+  Jo as Html,
+  We as Input,
+  wo as LabelFromValue,
   f as MessageListener,
-  ao as MonthField,
-  po as NumberField,
-  Yo as PageControls,
+  po as MonthField,
+  fo as NumberField,
+  _o as PageControls,
   Z as PaginationContext,
-  fo as PasswordField,
-  _o as Phantom,
-  wo as PreformattedMarkup,
-  lo as RangeField,
+  lo as PasswordField,
+  er as Phantom,
+  zo as PreformattedMarkup,
+  so as RangeField,
   l as ReactOnEvent,
-  er as ReactiveJsonBasicComponentWrapper,
+  rr as ReactiveJsonBasicComponentWrapper,
   $ as ReactiveJsonRoot,
-  rr as ReactiveJsonSubroot,
+  ar as ReactiveJsonSubroot,
   s as Redirect,
-  so as SearchField,
-  co as SelectField,
+  co as SearchField,
+  Do as SelectField,
   u as SetAttributeValue,
-  zo as SortableTreeItemCollapseButton,
+  Go as SortableTreeItemCollapseButton,
   oe as StoreContext,
   re as StoreProvider,
-  ar as Switch,
-  Do as TelField,
+  pr as Switch,
+  Co as TelField,
   me as TemplateContext,
-  Co as TextAreaField,
-  go as TextField,
-  Ro as TimeField,
+  go as TextAreaField,
+  Ro as TextField,
+  ho as TimeField,
   F as ToggleAttributeValue,
   v as UnsetAttribute,
   b as UnsetAttributeValue,
-  ho as UrlField,
-  Ue as VariablesDebug,
-  ke as View,
+  Eo as UrlField,
+  Ie as VariablesDebug,
+  Ne as View,
   T as VisuallyHide,
-  Eo as WeekField,
-  pr as addData,
+  Vo as WeekField,
+  fr as addData,
   W as addEventListener,
   Fe as alterData,
   ve as analyzeDataOverrideReferences,
@@ -159,30 +160,31 @@ export {
   fe as evaluateAttributes,
   ie as evaluateTemplateValue,
   le as evaluateTemplateValueCollection,
-  lr as executeHttpRequest,
-  fr as fetchData,
+  sr as executeHttpRequest,
+  lr as fetchData,
   Se as formatString,
-  Qo as getReactionFunctionsToExecute,
+  Yo as getReactionFunctionsToExecute,
+  Be as interpolateSegments,
   ne as isTemplateValue,
   J as isValid,
   he as maybeFormatString,
   w as mergeComponentCollections,
-  sr as moveData,
+  ur as moveData,
   He as normalizeAttributeNameForReactJsx,
   Me as normalizeAttributesForReactJsx,
   Ve as parseRjBuild,
-  ur as postMessage,
+  Fr as postMessage,
   Ee as propsDataLocationToPathAndValue,
-  Fr as redirectNow,
-  vr as removeData,
+  vr as redirectNow,
+  br as removeData,
   j as removeEventListener,
   Te as replaceEventPlaceholders,
-  br as setClipboardData,
-  Tr as setData,
-  Ne as simpleMapping,
-  Be as stringToBoolean,
-  Sr as submitData,
-  Ar as triggerEvent,
+  Tr as setClipboardData,
+  Sr as setData,
+  Ue as simpleMapping,
+  ke as stringToBoolean,
+  Ar as submitData,
+  Pr as triggerEvent,
   se as useEvaluatedAttributes,
   ue as useReactiveData,
   te as useStore

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ea-lab/reactive-json",
   "private": false,
-  "version": "2.1.0",
+  "version": "2.3.0",
   "type": "module",
   "repository": {
     "type": "git",