@openmrs/esm-form-engine-lib 3.3.1-pre.2208 → 3.3.1-pre.2219

package/dist/openmrs-esm-form-engine-lib.js

@@ -1 +1 @@
-var _openmrs_esm_form_engine_lib;(()=>{"use strict";var e,r,t,n,o,i,a,l,s,u,f,d,p,c,h,m,v,g,b,y,w,_={78008:(e,r,t)=>{var n={"./start":()=>Promise.all([t.e(177),t.e(435),t.e(759),t.e(72),t.e(286),t.e(449)]).then((()=>()=>t(69449)))},o=(e,r)=>(t.R=r,r=t.o(n,e)?n[e]():Promise.resolve().then((()=>{throw new Error('Module "'+e+'" does not exist in container.')})),t.R=void 0,r),i=(e,r)=>{if(t.S){var n="default",o=t.S[n];if(o&&o!==e)throw new Error("Container initialization failed as it has already been initialized with a different share scope");return t.S[n]=e,t.I(n,r)}};t.d(r,{get:()=>o,init:()=>i})}},j={};function P(e){var r=j[e];if(void 0!==r)return r.exports;var t=j[e]={id:e,loaded:!1,exports:{}};return _[e].call(t.exports,t,t.exports,P),t.loaded=!0,t.exports}P.m=_,P.c=j,P.n=e=>{var r=e&&e.__esModule?()=>e.default:()=>e;return P.d(r,{a:r}),r},r=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,P.t=function(t,n){if(1&n&&(t=this(t)),8&n)return t;if("object"==typeof t&&t){if(4&n&&t.__esModule)return t;if(16&n&&"function"==typeof t.then)return t}var o=Object.create(null);P.r(o);var i={};e=e||[null,r({}),r([]),r(r)];for(var a=2&n&&t;"object"==typeof a&&!~e.indexOf(a);a=r(a))Object.getOwnPropertyNames(a).forEach((e=>i[e]=()=>t[e]));return i.default=()=>t,P.d(o,i),o},P.d=(e,r)=>{for(var t in r)P.o(r,t)&&!P.o(e,t)&&Object.defineProperty(e,t,{enumerable:!0,get:r[t]})},P.f={},P.e=e=>Promise.all(Object.keys(P.f).reduce(((r,t)=>(P.f[t](e,r),r)),[])),P.u=e=>e+".js",P.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),P.o=(e,r)=>Object.prototype.hasOwnProperty.call(e,r),t={},n="@openmrs/esm-form-engine-lib:",P.l=(e,r,o,i)=>{if(t[e])t[e].push(r);else{var a,l;if(void 0!==o)for(var s=document.getElementsByTagName("script"),u=0;u<s.length;u++){var f=s[u];if(f.getAttribute("src")==e||f.getAttribute("data-webpack")==n+o){a=f;break}}a||(l=!0,(a=document.createElement("script")).charset="utf-8",a.timeout=120,P.nc&&a.setAttribute("nonce",P.nc),a.setAttribute("data-webpack",n+o),a.src=e),t[e]=[r];var d=(r,n)=>{a.onerror=a.onload=null,clearTimeout(p);var o=t[e];if(delete t[e],a.parentNode&&a.parentNode.removeChild(a),o&&o.forEach((e=>e(n))),r)return r(n)},p=setTimeout(d.bind(null,void 0,{type:"timeout",target:a}),12e4);a.onerror=d.bind(null,a.onerror),a.onload=d.bind(null,a.onload),l&&document.head.appendChild(a)}},P.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},P.nmd=e=>(e.paths=[],e.children||(e.children=[]),e),P.j=719,(()=>{P.S={};var e={},r={};P.I=(t,n)=>{n||(n=[]);var o=r[t];if(o||(o=r[t]={}),!(n.indexOf(o)>=0)){if(n.push(o),e[t])return e[t];P.o(P.S,t)||(P.S[t]={});var i=P.S[t],a="@openmrs/esm-form-engine-lib",l=(e,r,t,n)=>{var o=i[e]=i[e]||{},l=o[r];(!l||!l.loaded&&(!n!=!l.eager?n:a>l.from))&&(o[r]={get:t,from:a,eager:!!n})},s=[];return"default"===t&&(l("@openmrs/esm-framework","8.0.1-pre.3511",(()=>Promise.all([P.e(177),P.e(747),P.e(435),P.e(72),P.e(184),P.e(286),P.e(796)]).then((()=>()=>P(16747))))),l("dayjs","1.11.13",(()=>P.e(353).then((()=>()=>P(74353))))),l("i18next","25.6.0",(()=>P.e(635).then((()=>()=>P(72635))))),l("react-i18next","16.0.0",(()=>Promise.all([P.e(255),P.e(72)]).then((()=>()=>P(77255))))),l("react","18.3.1",(()=>P.e(540).then((()=>()=>P(96540))))),l("swr/immutable","2.3.3",(()=>Promise.all([P.e(177),P.e(72),P.e(606)]).then((()=>()=>P(54225))))),l("swr/infinite","2.3.3",(()=>Promise.all([P.e(177),P.e(72),P.e(41)]).then((()=>()=>P(23041)))))),e[t]=s.length?Promise.all(s).then((()=>e[t]=1)):1}}})(),(()=>{var e;P.g.importScripts&&(e=P.g.location+"");var r=P.g.document;if(!e&&r&&(r.currentScript&&"SCRIPT"===r.currentScript.tagName.toUpperCase()&&(e=r.currentScript.src),!e)){var t=r.getElementsByTagName("script");if(t.length)for(var n=t.length-1;n>-1&&(!e||!/^http(s?):/.test(e));)e=t[n--].src}if(!e)throw new Error("Automatic publicPath is not supported in this browser");e=e.replace(/^blob:/,"").replace(/#.*$/,"").replace(/\?.*$/,"").replace(/\/[^\/]+$/,"/"),P.p=e})(),o=e=>{var r=e=>e.split(".").map((e=>+e==e?+e:e)),t=/^([^-+]+)?(?:-([^+]+))?(?:\+(.+))?$/.exec(e),n=t[1]?r(t[1]):[];return t[2]&&(n.length++,n.push.apply(n,r(t[2]))),t[3]&&(n.push([]),n.push.apply(n,r(t[3]))),n},i=(e,r)=>{e=o(e),r=o(r);for(var t=0;;){if(t>=e.length)return t<r.length&&"u"!=(typeof r[t])[0];var n=e[t],i=(typeof n)[0];if(t>=r.length)return"u"==i;var a=r[t],l=(typeof a)[0];if(i!=l)return"o"==i&&"n"==l||"s"==l||"u"==i;if("o"!=i&&"u"!=i&&n!=a)return n<a;t++}},a=e=>{var r=e[0],t="";if(1===e.length)return"*";if(r+.5){t+=0==r?">=":-1==r?"<":1==r?"^":2==r?"~":r>0?"=":"!=";for(var n=1,o=1;o<e.length;o++)n--,t+="u"==(typeof(l=e[o]))[0]?"-":(n>0?".":"")+(n=2,l);return t}var i=[];for(o=1;o<e.length;o++){var l=e[o];i.push(0===l?"not("+s()+")":1===l?"("+s()+" || "+s()+")":2===l?i.pop()+" "+i.pop():a(l))}return s();function s(){return i.pop().replace(/^\((.+)\)$/,"$1")}},l=(e,r)=>{if(0 in e){r=o(r);var t=e[0],n=t<0;n&&(t=-t-1);for(var i=0,a=1,s=!0;;a++,i++){var u,f,d=a<e.length?(typeof e[a])[0]:"";if(i>=r.length||"o"==(f=(typeof(u=r[i]))[0]))return!s||("u"==d?a>t&&!n:""==d!=n);if("u"==f){if(!s||"u"!=d)return!1}else if(s)if(d==f)if(a<=t){if(u!=e[a])return!1}else{if(n?u>e[a]:u<e[a])return!1;u!=e[a]&&(s=!1)}else if("s"!=d&&"n"!=d){if(n||a<=t)return!1;s=!1,a--}else{if(a<=t||f<d!=n)return!1;s=!1}else"s"!=d&&"n"!=d&&(s=!1,a--)}}var p=[],c=p.pop.bind(p);for(i=1;i<e.length;i++){var h=e[i];p.push(1==h?c()|c():2==h?c()&c():h?l(h,r):!c())}return!!c()},s=(e,r)=>e&&P.o(e,r),u=e=>(e.loaded=1,e.get()),f=e=>Object.keys(e).reduce(((r,t)=>(e[t].eager&&(r[t]=e[t]),r)),{}),d=(e,r,t)=>{var n=t?f(e[r]):e[r];return Object.keys(n).reduce(((e,r)=>!e||!n[e].loaded&&i(e,r)?r:e),0)},p=(e,r,t,n)=>"Unsatisfied version "+t+" from "+(t&&e[r][t].from)+" of shared singleton module "+r+" (required "+a(n)+")",c=e=>{throw new Error(e)},h=e=>{"undefined"!=typeof console&&console.warn&&console.warn(e)},m=(e,r,t)=>t?t():((e,r)=>c("Shared module "+r+" doesn't exist in shared scope "+e))(e,r),v=(e=>function(r,t,n,o,i){var a=P.I(r);return a&&a.then&&!n?a.then(e.bind(e,r,P.S[r],t,!1,o,i)):e(r,P.S[r],t,n,o,i)})(((e,r,t,n,o,i)=>{if(!s(r,t))return m(e,t,i);var a=d(r,t,n);return l(o,a)||h(p(r,t,a,o)),u(r[t][a])})),g={},b={16072:()=>v("default","react",!1,[1,18],(()=>P.e(540).then((()=>()=>P(96540))))),56339:()=>v("default","swr/infinite",!1,[1,2],(()=>P.e(422).then((()=>()=>P(23041))))),92232:()=>v("default","i18next",!1,[1,25],(()=>P.e(635).then((()=>()=>P(72635))))),2076:()=>v("default","react-i18next",!1,[1,16],(()=>P.e(255).then((()=>()=>P(77255))))),15847:()=>v("default","@openmrs/esm-framework",!1,[1,8],(()=>Promise.all([P.e(177),P.e(747),P.e(184)]).then((()=>()=>P(16747))))),44209:()=>v("default","swr/immutable",!1,[1,2],(()=>Promise.all([P.e(177),P.e(225)]).then((()=>()=>P(54225))))),70231:()=>v("default","dayjs",!1,[1,1],(()=>P.e(353).then((()=>()=>P(74353)))))},y={72:[16072],184:[56339,92232],286:[2076,15847],449:[44209,70231],796:[44209,70231]},w={},P.f.consumes=(e,r)=>{P.o(y,e)&&y[e].forEach((e=>{if(P.o(g,e))return r.push(g[e]);if(!w[e]){var t=r=>{g[e]=0,P.m[e]=t=>{delete P.c[e],t.exports=r()}};w[e]=!0;var n=r=>{delete g[e],P.m[e]=t=>{throw delete P.c[e],r}};try{var o=b[e]();o.then?r.push(g[e]=o.then(t).catch(n)):t(o)}catch(e){n(e)}}}))},(()=>{var e={719:0};P.f.j=(r,t)=>{var n=P.o(e,r)?e[r]:void 0;if(0!==n)if(n)t.push(n[2]);else if(/^(184|286|72)$/.test(r))e[r]=0;else{var o=new Promise(((t,o)=>n=e[r]=[t,o]));t.push(n[2]=o);var i=P.p+P.u(r),a=new Error;P.l(i,(t=>{if(P.o(e,r)&&(0!==(n=e[r])&&(e[r]=void 0),n)){var o=t&&("load"===t.type?"missing":t.type),i=t&&t.target&&t.target.src;a.message="Loading chunk "+r+" failed.\n("+o+": "+i+")",a.name="ChunkLoadError",a.type=o,a.request=i,n[1](a)}}),"chunk-"+r,r)}};var r=(r,t)=>{var n,o,[i,a,l]=t,s=0;if(i.some((r=>0!==e[r]))){for(n in a)P.o(a,n)&&(P.m[n]=a[n]);l&&l(P)}for(r&&r(t);s<i.length;s++)o=i[s],P.o(e,o)&&e[o]&&e[o][0](),e[o]=0},t=globalThis.webpackChunk_openmrs_esm_form_engine_lib=globalThis.webpackChunk_openmrs_esm_form_engine_lib||[];t.forEach(r.bind(null,0)),t.push=r.bind(null,t.push.bind(t))})(),P.nc=void 0;var S=P(78008);_openmrs_esm_form_engine_lib=S})();
+var _openmrs_esm_form_engine_lib;(()=>{"use strict";var e,r,t,n,o,i,a,l,s,u,f,d,p,c,h,m,v,g,b,y,w,_={78008:(e,r,t)=>{var n={"./start":()=>Promise.all([t.e(177),t.e(435),t.e(926),t.e(72),t.e(286),t.e(449)]).then((()=>()=>t(69449)))},o=(e,r)=>(t.R=r,r=t.o(n,e)?n[e]():Promise.resolve().then((()=>{throw new Error('Module "'+e+'" does not exist in container.')})),t.R=void 0,r),i=(e,r)=>{if(t.S){var n="default",o=t.S[n];if(o&&o!==e)throw new Error("Container initialization failed as it has already been initialized with a different share scope");return t.S[n]=e,t.I(n,r)}};t.d(r,{get:()=>o,init:()=>i})}},j={};function P(e){var r=j[e];if(void 0!==r)return r.exports;var t=j[e]={id:e,loaded:!1,exports:{}};return _[e].call(t.exports,t,t.exports,P),t.loaded=!0,t.exports}P.m=_,P.c=j,P.n=e=>{var r=e&&e.__esModule?()=>e.default:()=>e;return P.d(r,{a:r}),r},r=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,P.t=function(t,n){if(1&n&&(t=this(t)),8&n)return t;if("object"==typeof t&&t){if(4&n&&t.__esModule)return t;if(16&n&&"function"==typeof t.then)return t}var o=Object.create(null);P.r(o);var i={};e=e||[null,r({}),r([]),r(r)];for(var a=2&n&&t;"object"==typeof a&&!~e.indexOf(a);a=r(a))Object.getOwnPropertyNames(a).forEach((e=>i[e]=()=>t[e]));return i.default=()=>t,P.d(o,i),o},P.d=(e,r)=>{for(var t in r)P.o(r,t)&&!P.o(e,t)&&Object.defineProperty(e,t,{enumerable:!0,get:r[t]})},P.f={},P.e=e=>Promise.all(Object.keys(P.f).reduce(((r,t)=>(P.f[t](e,r),r)),[])),P.u=e=>e+".js",P.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),P.o=(e,r)=>Object.prototype.hasOwnProperty.call(e,r),t={},n="@openmrs/esm-form-engine-lib:",P.l=(e,r,o,i)=>{if(t[e])t[e].push(r);else{var a,l;if(void 0!==o)for(var s=document.getElementsByTagName("script"),u=0;u<s.length;u++){var f=s[u];if(f.getAttribute("src")==e||f.getAttribute("data-webpack")==n+o){a=f;break}}a||(l=!0,(a=document.createElement("script")).charset="utf-8",a.timeout=120,P.nc&&a.setAttribute("nonce",P.nc),a.setAttribute("data-webpack",n+o),a.src=e),t[e]=[r];var d=(r,n)=>{a.onerror=a.onload=null,clearTimeout(p);var o=t[e];if(delete t[e],a.parentNode&&a.parentNode.removeChild(a),o&&o.forEach((e=>e(n))),r)return r(n)},p=setTimeout(d.bind(null,void 0,{type:"timeout",target:a}),12e4);a.onerror=d.bind(null,a.onerror),a.onload=d.bind(null,a.onload),l&&document.head.appendChild(a)}},P.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},P.nmd=e=>(e.paths=[],e.children||(e.children=[]),e),P.j=719,(()=>{P.S={};var e={},r={};P.I=(t,n)=>{n||(n=[]);var o=r[t];if(o||(o=r[t]={}),!(n.indexOf(o)>=0)){if(n.push(o),e[t])return e[t];P.o(P.S,t)||(P.S[t]={});var i=P.S[t],a="@openmrs/esm-form-engine-lib",l=(e,r,t,n)=>{var o=i[e]=i[e]||{},l=o[r];(!l||!l.loaded&&(!n!=!l.eager?n:a>l.from))&&(o[r]={get:t,from:a,eager:!!n})},s=[];return"default"===t&&(l("@openmrs/esm-framework","8.0.1-pre.3511",(()=>Promise.all([P.e(177),P.e(747),P.e(435),P.e(72),P.e(184),P.e(286),P.e(796)]).then((()=>()=>P(16747))))),l("dayjs","1.11.13",(()=>P.e(353).then((()=>()=>P(74353))))),l("i18next","25.6.0",(()=>P.e(635).then((()=>()=>P(72635))))),l("react-i18next","16.0.0",(()=>Promise.all([P.e(255),P.e(72)]).then((()=>()=>P(77255))))),l("react","18.3.1",(()=>P.e(540).then((()=>()=>P(96540))))),l("swr/immutable","2.3.3",(()=>Promise.all([P.e(177),P.e(72),P.e(606)]).then((()=>()=>P(54225))))),l("swr/infinite","2.3.3",(()=>Promise.all([P.e(177),P.e(72),P.e(41)]).then((()=>()=>P(23041)))))),e[t]=s.length?Promise.all(s).then((()=>e[t]=1)):1}}})(),(()=>{var e;P.g.importScripts&&(e=P.g.location+"");var r=P.g.document;if(!e&&r&&(r.currentScript&&"SCRIPT"===r.currentScript.tagName.toUpperCase()&&(e=r.currentScript.src),!e)){var t=r.getElementsByTagName("script");if(t.length)for(var n=t.length-1;n>-1&&(!e||!/^http(s?):/.test(e));)e=t[n--].src}if(!e)throw new Error("Automatic publicPath is not supported in this browser");e=e.replace(/^blob:/,"").replace(/#.*$/,"").replace(/\?.*$/,"").replace(/\/[^\/]+$/,"/"),P.p=e})(),o=e=>{var r=e=>e.split(".").map((e=>+e==e?+e:e)),t=/^([^-+]+)?(?:-([^+]+))?(?:\+(.+))?$/.exec(e),n=t[1]?r(t[1]):[];return t[2]&&(n.length++,n.push.apply(n,r(t[2]))),t[3]&&(n.push([]),n.push.apply(n,r(t[3]))),n},i=(e,r)=>{e=o(e),r=o(r);for(var t=0;;){if(t>=e.length)return t<r.length&&"u"!=(typeof r[t])[0];var n=e[t],i=(typeof n)[0];if(t>=r.length)return"u"==i;var a=r[t],l=(typeof a)[0];if(i!=l)return"o"==i&&"n"==l||"s"==l||"u"==i;if("o"!=i&&"u"!=i&&n!=a)return n<a;t++}},a=e=>{var r=e[0],t="";if(1===e.length)return"*";if(r+.5){t+=0==r?">=":-1==r?"<":1==r?"^":2==r?"~":r>0?"=":"!=";for(var n=1,o=1;o<e.length;o++)n--,t+="u"==(typeof(l=e[o]))[0]?"-":(n>0?".":"")+(n=2,l);return t}var i=[];for(o=1;o<e.length;o++){var l=e[o];i.push(0===l?"not("+s()+")":1===l?"("+s()+" || "+s()+")":2===l?i.pop()+" "+i.pop():a(l))}return s();function s(){return i.pop().replace(/^\((.+)\)$/,"$1")}},l=(e,r)=>{if(0 in e){r=o(r);var t=e[0],n=t<0;n&&(t=-t-1);for(var i=0,a=1,s=!0;;a++,i++){var u,f,d=a<e.length?(typeof e[a])[0]:"";if(i>=r.length||"o"==(f=(typeof(u=r[i]))[0]))return!s||("u"==d?a>t&&!n:""==d!=n);if("u"==f){if(!s||"u"!=d)return!1}else if(s)if(d==f)if(a<=t){if(u!=e[a])return!1}else{if(n?u>e[a]:u<e[a])return!1;u!=e[a]&&(s=!1)}else if("s"!=d&&"n"!=d){if(n||a<=t)return!1;s=!1,a--}else{if(a<=t||f<d!=n)return!1;s=!1}else"s"!=d&&"n"!=d&&(s=!1,a--)}}var p=[],c=p.pop.bind(p);for(i=1;i<e.length;i++){var h=e[i];p.push(1==h?c()|c():2==h?c()&c():h?l(h,r):!c())}return!!c()},s=(e,r)=>e&&P.o(e,r),u=e=>(e.loaded=1,e.get()),f=e=>Object.keys(e).reduce(((r,t)=>(e[t].eager&&(r[t]=e[t]),r)),{}),d=(e,r,t)=>{var n=t?f(e[r]):e[r];return Object.keys(n).reduce(((e,r)=>!e||!n[e].loaded&&i(e,r)?r:e),0)},p=(e,r,t,n)=>"Unsatisfied version "+t+" from "+(t&&e[r][t].from)+" of shared singleton module "+r+" (required "+a(n)+")",c=e=>{throw new Error(e)},h=e=>{"undefined"!=typeof console&&console.warn&&console.warn(e)},m=(e,r,t)=>t?t():((e,r)=>c("Shared module "+r+" doesn't exist in shared scope "+e))(e,r),v=(e=>function(r,t,n,o,i){var a=P.I(r);return a&&a.then&&!n?a.then(e.bind(e,r,P.S[r],t,!1,o,i)):e(r,P.S[r],t,n,o,i)})(((e,r,t,n,o,i)=>{if(!s(r,t))return m(e,t,i);var a=d(r,t,n);return l(o,a)||h(p(r,t,a,o)),u(r[t][a])})),g={},b={16072:()=>v("default","react",!1,[1,18],(()=>P.e(540).then((()=>()=>P(96540))))),56339:()=>v("default","swr/infinite",!1,[1,2],(()=>P.e(422).then((()=>()=>P(23041))))),92232:()=>v("default","i18next",!1,[1,25],(()=>P.e(635).then((()=>()=>P(72635))))),2076:()=>v("default","react-i18next",!1,[1,16],(()=>P.e(255).then((()=>()=>P(77255))))),15847:()=>v("default","@openmrs/esm-framework",!1,[1,8],(()=>Promise.all([P.e(177),P.e(747),P.e(184)]).then((()=>()=>P(16747))))),44209:()=>v("default","swr/immutable",!1,[1,2],(()=>Promise.all([P.e(177),P.e(225)]).then((()=>()=>P(54225))))),70231:()=>v("default","dayjs",!1,[1,1],(()=>P.e(353).then((()=>()=>P(74353)))))},y={72:[16072],184:[56339,92232],286:[2076,15847],449:[44209,70231],796:[44209,70231]},w={},P.f.consumes=(e,r)=>{P.o(y,e)&&y[e].forEach((e=>{if(P.o(g,e))return r.push(g[e]);if(!w[e]){var t=r=>{g[e]=0,P.m[e]=t=>{delete P.c[e],t.exports=r()}};w[e]=!0;var n=r=>{delete g[e],P.m[e]=t=>{throw delete P.c[e],r}};try{var o=b[e]();o.then?r.push(g[e]=o.then(t).catch(n)):t(o)}catch(e){n(e)}}}))},(()=>{var e={719:0};P.f.j=(r,t)=>{var n=P.o(e,r)?e[r]:void 0;if(0!==n)if(n)t.push(n[2]);else if(/^(184|286|72)$/.test(r))e[r]=0;else{var o=new Promise(((t,o)=>n=e[r]=[t,o]));t.push(n[2]=o);var i=P.p+P.u(r),a=new Error;P.l(i,(t=>{if(P.o(e,r)&&(0!==(n=e[r])&&(e[r]=void 0),n)){var o=t&&("load"===t.type?"missing":t.type),i=t&&t.target&&t.target.src;a.message="Loading chunk "+r+" failed.\n("+o+": "+i+")",a.name="ChunkLoadError",a.type=o,a.request=i,n[1](a)}}),"chunk-"+r,r)}};var r=(r,t)=>{var n,o,[i,a,l]=t,s=0;if(i.some((r=>0!==e[r]))){for(n in a)P.o(a,n)&&(P.m[n]=a[n]);l&&l(P)}for(r&&r(t);s<i.length;s++)o=i[s],P.o(e,o)&&e[o]&&e[o][0](),e[o]=0},t=globalThis.webpackChunk_openmrs_esm_form_engine_lib=globalThis.webpackChunk_openmrs_esm_form_engine_lib||[];t.forEach(r.bind(null,0)),t.push=r.bind(null,t.push.bind(t))})(),P.nc=void 0;var S=P(78008);_openmrs_esm_form_engine_lib=S})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmrs/esm-form-engine-lib",
-  "version": "3.3.1-pre.2208",
+  "version": "3.3.1-pre.2219",
   "description": "React Form Engine for O3",
   "browser": "dist/openmrs-esm-form-engine-lib.js",
   "main": "src/index.ts",

package/src/components/processor-factory/form-processor-factory.component.tsx

@@ -31,11 +31,15 @@ const FormProcessorFactory = ({
 
   const processor = useMemo(() => {
     const ProcessorClass = formProcessors[formJson.processor];
+    let processorInstance;
     if (ProcessorClass) {
-      return new ProcessorClass(formJson);
+      processorInstance = new ProcessorClass(formJson);
+    } else {
+      console.error(`Form processor ${formJson.processor} not found, defaulting to EncounterFormProcessor`);
+      processorInstance = new EncounterFormProcessor(formJson);
     }
-    console.error(`Form processor ${formJson.processor} not found, defaulting to EncounterFormProcessor`);
-    return new EncounterFormProcessor(formJson);
+    processorInstance.prepareFormSchema(formJson);
+    return processorInstance;
   }, [formProcessors, formJson.processor]);
 
   const [processorContext, setProcessorContext] = useState<FormProcessorContextProps>({

package/src/processors/encounter/encounter-form-processor.test.ts

@@ -0,0 +1,225 @@
+import { EncounterFormProcessor } from './encounter-form-processor';
+import { type FormSchema } from '../../types';
+
+describe('EncounterFormProcessor', () => {
+  describe('prepareFormSchema - validateCalculateExpressions', () => {
+    let processor: EncounterFormProcessor;
+    let consoleSpy: jest.SpyInstance;
+
+    beforeEach(() => {
+      processor = new EncounterFormProcessor(null);
+      consoleSpy = jest.spyOn(console, 'error').mockImplementation();
+    });
+
+    afterEach(() => {
+      consoleSpy.mockRestore();
+    });
+
+    it('should warn when a calculateExpression contains a quoted string that matches a field ID', () => {
+      const schema: FormSchema = {
+        name: 'Test Form',
+        pages: [
+          {
+            label: 'Page 1',
+            sections: [
+              {
+                label: 'Section 1',
+                isExpanded: 'true',
+                questions: [
+                  {
+                    label: 'Last Menstrual Period',
+                    type: 'obs',
+                    id: 'lmp',
+                    questionOptions: {
+                      rendering: 'date',
+                      concept: 'test-concept',
+                    },
+                  },
+                  {
+                    label: 'Expected Date of Delivery',
+                    type: 'obs',
+                    id: 'edd',
+                    questionOptions: {
+                      rendering: 'date',
+                      concept: 'test-concept',
+                      calculate: {
+                        calculateExpression: "calcEDD('lmp')",
+                      },
+                    },
+                  },
+                ],
+              },
+            ],
+          },
+        ],
+        processor: 'EncounterFormProcessor',
+        encounterType: 'test-encounter-type',
+        referencedForms: [],
+        uuid: 'test-form-uuid',
+      } as unknown as FormSchema;
+
+      processor.prepareFormSchema(schema);
+
+      expect(consoleSpy).toHaveBeenCalledWith(
+        expect.stringContaining("incorrectly quotes the field ID 'lmp' as a string"),
+      );
+    });
+
+    it('should not warn when a calculateExpression uses bare variable references', () => {
+      const schema: FormSchema = {
+        name: 'Test Form',
+        pages: [
+          {
+            label: 'Page 1',
+            sections: [
+              {
+                label: 'Section 1',
+                isExpanded: 'true',
+                questions: [
+                  {
+                    label: 'Last Menstrual Period',
+                    type: 'obs',
+                    id: 'lmp',
+                    questionOptions: {
+                      rendering: 'date',
+                      concept: 'test-concept',
+                    },
+                  },
+                  {
+                    label: 'Expected Date of Delivery',
+                    type: 'obs',
+                    id: 'edd',
+                    questionOptions: {
+                      rendering: 'date',
+                      concept: 'test-concept',
+                      calculate: {
+                        calculateExpression: 'calcEDD(lmp)',
+                      },
+                    },
+                  },
+                ],
+              },
+            ],
+          },
+        ],
+        processor: 'EncounterFormProcessor',
+        encounterType: 'test-encounter-type',
+        referencedForms: [],
+        uuid: 'test-form-uuid',
+      } as unknown as FormSchema;
+
+      processor.prepareFormSchema(schema);
+
+      expect(consoleSpy).not.toHaveBeenCalled();
+    });
+
+    it('should not warn when a quoted string does not match any field ID', () => {
+      const schema: FormSchema = {
+        name: 'Test Form',
+        pages: [
+          {
+            label: 'Page 1',
+            sections: [
+              {
+                label: 'Section 1',
+                isExpanded: 'true',
+                questions: [
+                  {
+                    label: 'Duration',
+                    type: 'obs',
+                    id: 'duration',
+                    questionOptions: {
+                      rendering: 'number',
+                      concept: 'test-concept',
+                      calculate: {
+                        calculateExpression: "calcTimeDifference(onsetDate, 'd')",
+                      },
+                    },
+                  },
+                ],
+              },
+            ],
+          },
+        ],
+        processor: 'EncounterFormProcessor',
+        encounterType: 'test-encounter-type',
+        referencedForms: [],
+        uuid: 'test-form-uuid',
+      } as unknown as FormSchema;
+
+      processor.prepareFormSchema(schema);
+
+      // 'd' is not a field ID, so no warning should be issued
+      expect(consoleSpy).not.toHaveBeenCalled();
+    });
+
+    it('should warn for nested questions in obsGroups', () => {
+      const schema: FormSchema = {
+        name: 'Test Form',
+        pages: [
+          {
+            label: 'Page 1',
+            sections: [
+              {
+                label: 'Section 1',
+                isExpanded: 'true',
+                questions: [
+                  {
+                    label: 'Height',
+                    type: 'obs',
+                    id: 'height',
+                    questionOptions: {
+                      rendering: 'number',
+                      concept: 'test-concept',
+                    },
+                  },
+                  {
+                    label: 'Weight',
+                    type: 'obs',
+                    id: 'weight',
+                    questionOptions: {
+                      rendering: 'number',
+                      concept: 'test-concept',
+                    },
+                  },
+                  {
+                    label: 'Vitals Group',
+                    type: 'obsGroup',
+                    id: 'vitalsGroup',
+                    questionOptions: {
+                      rendering: 'group',
+                      concept: 'test-concept',
+                    },
+                    questions: [
+                      {
+                        label: 'BMI',
+                        type: 'obs',
+                        id: 'bmi',
+                        questionOptions: {
+                          rendering: 'number',
+                          concept: 'test-concept',
+                          calculate: {
+                            calculateExpression: "calcBMI('height', 'weight')",
+                          },
+                        },
+                      },
+                    ],
+                  },
+                ],
+              },
+            ],
+          },
+        ],
+        processor: 'EncounterFormProcessor',
+        encounterType: 'test-encounter-type',
+        referencedForms: [],
+        uuid: 'test-form-uuid',
+      } as unknown as FormSchema;
+
+      processor.prepareFormSchema(schema);
+
+      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining("incorrectly quotes the field ID 'height' as a string"));
+      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining("incorrectly quotes the field ID 'weight' as a string"));
+    });
+  });
+});

package/src/processors/encounter/encounter-form-processor.ts

@@ -81,6 +81,8 @@ const contextInitializableTypes = [
 
 export class EncounterFormProcessor extends FormProcessor {
   prepareFormSchema(schema: FormSchema) {
+    const allFieldIds = new Set<string>();
+
     schema.pages.forEach((page) => {
       page.sections.forEach((section) => {
         section.questions.forEach((question) => {
@@ -90,6 +92,11 @@ export class EncounterFormProcessor extends FormProcessor {
     });
 
     function prepareFormField(field: FormField, section: FormSection, page: FormPage, schema: FormSchema) {
+      // Collect field ID
+      if (field.id) {
+        allFieldIds.add(field.id);
+      }
+
       // inherit inlineRendering and readonly from parent section and page if not set
       field.inlineRendering =
         field.inlineRendering ?? section.inlineRendering ?? page.inlineRendering ?? schema.inlineRendering;
@@ -106,6 +113,9 @@ export class EncounterFormProcessor extends FormProcessor {
       }
     }
 
+    // Validate calculate expressions for common mistakes
+    validateCalculateExpressions(schema, allFieldIds);
+
     return schema;
   }
 
@@ -368,3 +378,43 @@ async function evaluateCalculateExpression(
     values[field.id] = value;
   }
 }
+
+/**
+ * Validates calculate expressions to warn about common mistakes.
+ * Specifically, checks if string literals in expressions match field IDs,
+ * which usually indicates the user should use bare variable references instead.
+ *
+ * For example: calcEDD('lmp') should be calcEDD(lmp)
+ */
+function validateCalculateExpressions(schema: FormSchema, allFieldIds: Set<string>) {
+  const stringLiteralPattern = /(['"])([a-zA-Z_][a-zA-Z0-9_]*)\1/g;
+
+  function checkExpression(expression: string, fieldId: string) {
+    for (const match of expression.matchAll(stringLiteralPattern)) {
+      const quotedValue = match[2];
+      if (allFieldIds.has(quotedValue)) {
+        console.error(
+          `The calculateExpression for the field '${fieldId}' incorrectly quotes the field ID '${quotedValue}' as a string. ` +
+            `Field IDs must be referenced as variables without quotes to access their values. ` +
+            `Remove the quotes: use ${quotedValue} instead of '${quotedValue}'.`,
+        );
+      }
+    }
+  }
+
+  function processField(field: FormField) {
+    if (field.questionOptions?.calculate?.calculateExpression) {
+      checkExpression(field.questionOptions.calculate.calculateExpression, field.id);
+    }
+    // Process nested questions (for obsGroups)
+    if (field.questions) {
+      field.questions.forEach(processField);
+    }
+  }
+
+  schema.pages.forEach((page) => {
+    page.sections.forEach((section) => {
+      section.questions.forEach(processField);
+    });
+  });
+}

package/src/utils/common-expression-helpers.test.ts

@@ -104,6 +104,68 @@ describe('CommonExpressionHelpers', () => {
     });
   });
 
+  describe('isDateAfterSimple', () => {
+    it('should return true if the left date is after the right date', () => {
+      const left = new Date('2021-12-31');
+      const right = '2021-01-01';
+      expect(helpers.isDateAfterSimple(left, right)).toBe(true);
+    });
+
+    it('should return false if the left date is not after the right date', () => {
+      const left = new Date('2021-01-01');
+      const right = '2021-12-31';
+      expect(helpers.isDateAfterSimple(left, right)).toBe(false);
+    });
+
+    it('should accept a Date object as the right parameter', () => {
+      const left = new Date('2021-12-31');
+      const right = new Date('2021-01-01');
+      expect(helpers.isDateAfterSimple(left, right)).toBe(true);
+    });
+
+    it('should use custom format when provided', () => {
+      const left = new Date('2021-12-31');
+      const right = '31/01/2021';
+      expect(helpers.isDateAfterSimple(left, right, 'DD/MM/YYYY')).toBe(true);
+    });
+  });
+
+  describe('addWeeksToDate', () => {
+    it('should add weeks to a date correctly', () => {
+      const date = new Date('2021-01-01');
+      const result = helpers.addWeeksToDate(date, 2);
+      expect(result).toEqual(new Date('2021-01-15'));
+    });
+
+    it('should not mutate the original date', () => {
+      const date = new Date('2021-01-01');
+      const originalTime = date.getTime();
+      helpers.addWeeksToDate(date, 2);
+      expect(date.getTime()).toBe(originalTime);
+    });
+  });
+
+  describe('addDaysToDate', () => {
+    it('should add days to a date correctly', () => {
+      const date = new Date('2021-01-01');
+      const result = helpers.addDaysToDate(date, 10);
+      expect(result).toEqual(new Date('2021-01-11'));
+    });
+
+    it('should not mutate the original date', () => {
+      const date = new Date('2021-01-01');
+      const originalTime = date.getTime();
+      helpers.addDaysToDate(date, 10);
+      expect(date.getTime()).toBe(originalTime);
+    });
+
+    it('should handle negative days', () => {
+      const date = new Date('2021-01-15');
+      const result = helpers.addDaysToDate(date, -5);
+      expect(result).toEqual(new Date('2021-01-10'));
+    });
+  });
+
   describe('useFieldValue', () => {
     it('should return the field value if the key exists', () => {
       helpers.allFieldValues = { question1: 'value1' };
@@ -155,6 +217,23 @@ describe('CommonExpressionHelpers', () => {
     });
   });
 
+  describe('calcBSA', () => {
+    it('should return the correct BSA value using Mosteller formula', () => {
+      // BSA = sqrt((height * weight) / 3600)
+      // For height=180cm, weight=75kg: sqrt((180 * 75) / 3600) = sqrt(3.75) ≈ 1.94
+      const height = 180;
+      const weight = 75;
+      expect(helpers.calcBSA(height, weight)).toBeCloseTo(1.94, 2);
+    });
+
+    it('should return null if height or weight is not provided', () => {
+      expect(helpers.calcBSA(null, 75)).toBe(null);
+      expect(helpers.calcBSA(180, null)).toBe(null);
+      expect(helpers.calcBSA(0, 75)).toBe(null);
+      expect(helpers.calcBSA(180, 0)).toBe(null);
+    });
+  });
+
   describe('calcEDD', () => {
     it('should return the expected date of delivery', () => {
       const lmp = new Date('2021-01-01');
@@ -349,8 +428,8 @@ describe('CommonExpressionHelpers', () => {
       expect(helpers.calcTimeDifference(obsDate, 'y')).toBe(1);
     });
 
-    it('should return "0" if obsDate is not provided', () => {
-      expect(helpers.calcTimeDifference(null, 'd')).toBe('0');
+    it('should return 0 if obsDate is not provided', () => {
+      expect(helpers.calcTimeDifference(null, 'd')).toBe(0);
     });
   });
 

package/src/utils/common-expression-helpers.ts

@@ -1,6 +1,6 @@
 import dayjs from 'dayjs';
-import duration from 'dayjs/plugin/duration';
-dayjs.extend(duration);
+import customParseFormat from 'dayjs/plugin/customParseFormat';
+dayjs.extend(customParseFormat);
 import findIndex from 'lodash/findIndex';
 import filter from 'lodash/filter';
 import first from 'lodash/first';
@@ -28,65 +28,168 @@ export class CommonExpressionHelpers {
     this.patient = patient;
   }
 
+  /**
+   * Shared helper for Z-score calculations. Finds the standard deviation (SD) value
+   * by comparing a measurement against WHO growth reference data.
+   * @param refSectionObject - Reference data object with SD columns (e.g., '-3SD', '-2SD', etc.)
+   * @param measurementValue - The patient's measurement to compare against reference values
+   * @returns The SD score as a string (e.g., '-2', '0', '1') or null if no reference data
+   */
+  private calculateZScoreFromRef = (
+    refSectionObject: Record<string, any> | undefined,
+    measurementValue: number,
+  ): string | null => {
+    if (!refSectionObject) {
+      console.warn('Z-score calculation: No reference data object provided');
+      return null;
+    }
+
+    const refObjectKeys = Object.keys(refSectionObject);
+    const refObjectValues = refObjectKeys.map((key) => refSectionObject[key]);
+    const minimumValue = refObjectValues[1];
+    const minReferencePoint: number[] = [];
+
+    if (measurementValue < minimumValue) {
+      minReferencePoint.push(minimumValue);
+    } else {
+      forEach(refObjectValues, (value) => {
+        if (value <= measurementValue) {
+          minReferencePoint.push(value);
+        }
+      });
+    }
+
+    const lastReferenceValue = last(minReferencePoint);
+    const lastValueIndex = findIndex(refObjectValues, (o) => o === lastReferenceValue);
+    const SDValue = refObjectKeys[lastValueIndex];
+    let formattedSDValue = SDValue?.replace('SD', '');
+
+    if (formattedSDValue?.includes('neg')) {
+      formattedSDValue = '-' + formattedSDValue.substring(0, 1);
+    }
+
+    if (formattedSDValue === 'S' || formattedSDValue === 'L' || formattedSDValue === 'M' || formattedSDValue === '-5') {
+      formattedSDValue = '-4';
+    }
+
+    return formattedSDValue ?? null;
+  };
+
+  /**
+   * Returns the current date and time.
+   * @returns A new Date object representing the current moment
+   */
   today = () => {
     return new Date();
   };
 
+  /**
+   * Checks if a collection contains a specific value.
+   * @param collection - The array to search in
+   * @param value - The value to search for
+   * @returns true if the collection contains the value, false otherwise
+   */
   includes = <T = any>(collection: T[], value: T) => {
     return collection?.includes(value);
   };
 
-  isDateBefore = (left: Date, right: string | Date, format?: string) => {
-    let otherDate: any = right;
-    if (typeof right == 'string') {
-      otherDate = format ? dayjs(right, format, true).toDate() : dayjs(right, 'YYYY-MM-DD', true).toDate();
-    }
+  /**
+   * Checks if the left date is before the right date.
+   * @param left - The date to check
+   * @param right - The date to compare against (can be a Date object or string)
+   * @param format - Optional format string for parsing right date (defaults to 'YYYY-MM-DD')
+   * @returns true if left is before right
+   */
+  isDateBefore = (left: Date, right: string | Date, format?: string): boolean => {
+    const otherDate: Date = right instanceof Date ? right : (format ? dayjs(right, format, true).toDate() : dayjs(right, 'YYYY-MM-DD', true).toDate());
     return left?.getTime() < otherDate.getTime();
   };
 
-  isDateAfter = (selectedDate: Date, baseDate: Date, duration: number, timePeriod: string) => {
-    let calculatedDate = new Date(0);
-    selectedDate = dayjs(selectedDate, 'YYYY-MM-DD', true).toDate();
-    baseDate = dayjs(baseDate, 'YYYY-MM-DD', true).toDate();
+  /**
+   * Checks if selectedDate is on or after baseDate plus a duration offset.
+   * @param selectedDate - The date to check
+   * @param baseDate - The base date to add the duration to
+   * @param duration - The number of time units to add to baseDate
+   * @param timePeriod - The time unit: 'days', 'weeks', 'months', or 'years'
+   * @returns true if selectedDate >= (baseDate + duration)
+   */
+  isDateAfter = (selectedDate: Date, baseDate: Date, duration: number, timePeriod: 'days' | 'weeks' | 'months' | 'years'): boolean => {
+    const parsedBaseDate = dayjs(baseDate);
 
+    let calculatedDate: Date;
     switch (timePeriod) {
       case 'months':
-        calculatedDate = new Date(baseDate.setMonth(baseDate.getMonth() + duration));
+        calculatedDate = parsedBaseDate.add(duration, 'month').toDate();
         break;
       case 'weeks':
-        calculatedDate = this.addWeeksToDate(baseDate, duration);
+        calculatedDate = parsedBaseDate.add(duration, 'week').toDate();
         break;
       case 'days':
-        calculatedDate = this.addDaysToDate(baseDate, duration);
+        calculatedDate = parsedBaseDate.add(duration, 'day').toDate();
         break;
       case 'years':
-        calculatedDate = new Date(baseDate.setFullYear(baseDate.getFullYear() + duration));
+        calculatedDate = parsedBaseDate.add(duration, 'year').toDate();
         break;
       default:
-        break;
+        calculatedDate = new Date(0);
     }
     return selectedDate.getTime() >= calculatedDate.getTime();
   };
 
-  addWeeksToDate = (date: Date, weeks: number) => {
-    date.setDate(date.getDate() + 7 * weeks);
-
-    return date;
+  /**
+   * Adds weeks to a date without mutating the original.
+   * @param date - The starting date
+   * @param weeks - Number of weeks to add
+   * @returns A new Date object with the weeks added
+   */
+  addWeeksToDate = (date: Date, weeks: number): Date => {
+    return dayjs(date).add(weeks, 'week').toDate();
   };
 
+  /**
+   * Adds days to a date without mutating the original.
+   * @param date - The starting date
+   * @param days - Number of days to add
+   * @returns A new Date object with the days added
+   */
   addDaysToDate = (date: Date, days: number): Date => {
     return dayjs(date).add(days, 'day').toDate();
   };
 
+  /**
+   * Simple date comparison - checks if left date is strictly after right date.
+   * Mirrors the API of isDateBefore for consistency.
+   * @param left - The date to check
+   * @param right - The date to compare against (string or Date)
+   * @param format - Optional format string for parsing right date (defaults to 'YYYY-MM-DD')
+   * @returns true if left is after right
+   */
+  isDateAfterSimple = (left: Date, right: string | Date, format?: string): boolean => {
+    const otherDate: Date = right instanceof Date ? right : (format ? dayjs(right, format, true).toDate() : dayjs(right, 'YYYY-MM-DD', true).toDate());
+    return left?.getTime() > otherDate.getTime();
+  };
+
+  /**
+   * Retrieves the current value of another form field and registers a dependency.
+   * When the referenced field changes, expressions using this helper will be re-evaluated.
+   * @param questionId - The ID of the field to get the value from
+   * @returns The field's current value, or null if not found/set
+   */
   useFieldValue = (questionId: string) => {
     const targetField = this.allFields.find((field) => field.id === questionId);
     if (targetField) {
-      // track field dependency
       registerDependency(this.node, targetField);
     }
     return this.allFieldValues[questionId] ?? null;
   };
 
+  /**
+   * Tests if a value does NOT match a regular expression pattern.
+   * Returns true for empty/null/undefined values (treated as non-matching).
+   * @param regexString - The regular expression pattern to test against
+   * @param val - The value to test
+   * @returns true if the value does not match the pattern or is empty/null/undefined
+   */
   doesNotMatchExpression = (regexString: string, val: string | null | undefined): boolean => {
     if (!val || ['undefined', 'null', ''].includes(val.toString())) {
       return true;
@@ -96,27 +199,41 @@ export class CommonExpressionHelpers {
     return !pattern.test(val);
   };
 
+  /**
+   * Calculates Body Mass Index (BMI) from height and weight.
+   * Formula: weight (kg) / height (m)²
+   * @param height - Height in centimeters
+   * @param weight - Weight in kilograms
+   * @returns BMI rounded to 1 decimal place, or null if inputs are missing
+   */
   calcBMI = (height: number, weight: number) => {
-    let r: string;
-    if (height && weight) {
-      r = (weight / (((height / 100) * height) / 100)).toFixed(1);
+    if (!height || !weight) {
+      return null;
     }
-    return r ? parseFloat(r) : null;
+    const heightInMeters = height / 100;
+    const bmi = (weight / (heightInMeters * heightInMeters)).toFixed(1);
+    return parseFloat(bmi);
   };
 
   /**
-   * Expected date of delivery
-   * @param lmpQuestionId
-   * @returns
+   * Calculates the Expected Date of Delivery (EDD) from the last menstrual period.
+   * Uses Naegele's rule: LMP + 280 days (40 weeks).
+   * @param lmp - Last menstrual period date
+   * @returns Expected delivery date, or null if lmp is not provided
    */
-  calcEDD = (lmp: Date) => {
-    let resultEdd = {};
-    if (lmp) {
-      resultEdd = new Date(lmp.getTime() + 280 * 24 * 60 * 60 * 1000);
+  calcEDD = (lmp: Date): Date | null => {
+    if (!lmp) {
+      return null;
     }
-    return lmp ? resultEdd : null;
+    return new Date(lmp.getTime() + 280 * 24 * 60 * 60 * 1000);
   };
 
+  /**
+   * Calculates the number of complete months a patient has been on ART.
+   * @param artStartDate - The date when ART treatment started
+   * @returns Number of months on ART, 0 if less than 30 days, or null if no start date
+   * @throws Error if artStartDate is not a valid Date object
+   */
   calcMonthsOnART = (artStartDate: Date) => {
     if (artStartDate == null) {
       return null;
@@ -136,6 +253,18 @@ export class CommonExpressionHelpers {
     return dayjs(today).diff(artStartDate, 'month');
   };
 
+  /**
+   * Determines viral load suppression status based on the viral load count.
+   *
+   * WARNING: This function returns hardcoded concept UUIDs that are specific to certain
+   * OpenMRS implementations. These UUIDs may not exist or may differ in your system.
+   * Consider using form-level configuration or concept mappings instead.
+   *
+   * @param viralLoadCount - The viral load count (copies/mL)
+   * @returns Concept UUID based on suppression threshold (>50 copies/mL), or null if no count
+   * @deprecated Consider implementing viral load status logic in form expressions with
+   *             configurable concept UUIDs instead of using this hardcoded helper.
+   */
   calcViralLoadStatus = (viralLoadCount: number) => {
     let resultViralLoadStatus: string;
     if (viralLoadCount) {
@@ -148,46 +277,76 @@ export class CommonExpressionHelpers {
     return resultViralLoadStatus ?? null;
   };
 
-  calcNextVisitDate = (followupDate, arvDispensedInDays) => {
-    let resultNextVisitDate: Date;
+  /**
+   * Calculates the next clinic visit date based on ARV dispensing duration.
+   * @param followupDate - The current follow-up/encounter date
+   * @param arvDispensedInDays - Number of days of ARV medication dispensed
+   * @returns The next visit date (followupDate + arvDispensedInDays), or null if inputs are missing
+   */
+  calcNextVisitDate = (followupDate: Date, arvDispensedInDays: number): Date | null => {
     if (followupDate && arvDispensedInDays) {
-      resultNextVisitDate = new Date(followupDate.getTime() + arvDispensedInDays * 24 * 60 * 60 * 1000);
+      return new Date(followupDate.getTime() + arvDispensedInDays * 24 * 60 * 60 * 1000);
     }
-    return resultNextVisitDate ?? null;
+    return null;
   };
 
-  calcTreatmentEndDate = (followupDate: Date, arvDispensedInDays: number, patientStatus: string) => {
-    let resultTreatmentEndDate = {};
-    let extraDaysAdded = 30 + arvDispensedInDays;
-    if (followupDate && arvDispensedInDays && patientStatus == '160429AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA') {
-      resultTreatmentEndDate = new Date(followupDate.getTime() + extraDaysAdded * 24 * 60 * 60 * 1000);
+  /**
+   * Calculates the treatment end date for patients on ART.
+   * Adds a 30-day grace period plus the ARV dispensing duration.
+   *
+   * WARNING: This function checks against a hardcoded concept UUID (160429AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA)
+   * for 'Currently in Treatment' status. This UUID may not exist or may differ in your system.
+   * Consider implementing this logic in form expressions with configurable concept references instead.
+   *
+   * @param followupDate - The current follow-up/encounter date
+   * @param arvDispensedInDays - Number of days of ARV medication dispensed
+   * @param patientStatus - The patient's treatment status UUID (must match hardcoded UUID)
+   * @returns Treatment end date (followupDate + 30 + arvDispensedInDays), or null if conditions not met
+   * @deprecated Consider implementing treatment end date logic in form expressions with
+   *             configurable concept UUIDs instead of using this hardcoded helper.
+   */
+  calcTreatmentEndDate = (followupDate: Date, arvDispensedInDays: number, patientStatus: string): Date | null => {
+    if (!followupDate || !arvDispensedInDays || patientStatus !== '160429AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA') {
+      return null;
     }
-    return followupDate && arvDispensedInDays && patientStatus == '160429AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'
-      ? resultTreatmentEndDate
-      : null;
+    const extraDaysAdded = 30 + arvDispensedInDays;
+    return new Date(followupDate.getTime() + extraDaysAdded * 24 * 60 * 60 * 1000);
   };
 
-  calcAgeBasedOnDate = (dateValue?: ConstructorParameters<typeof Date>[0] | null) => {
-    let targetYear = null;
-    if (dateValue) {
-      targetYear = new Date(dateValue).getFullYear();
-    } else {
-      targetYear = new Date().getFullYear();
-    }
-    let birthDate = new Date(this.patient.birthDate).getFullYear();
-    let calculatedYear = targetYear - birthDate;
-    return calculatedYear;
+  /**
+   * Calculates the patient's age in years based on a reference date.
+   * Note: Uses year-only calculation (ignores month/day), so a patient born in December 1990
+   * will be considered 31 years old on January 1, 2021.
+   * @param dateValue - The reference date to calculate age at (defaults to today if not provided)
+   * @returns Age in years (year difference only, not precise age)
+   */
+  calcAgeBasedOnDate = (dateValue?: ConstructorParameters<typeof Date>[0] | null): number => {
+    const targetYear = dateValue ? new Date(dateValue).getFullYear() : new Date().getFullYear();
+    const birthYear = new Date(this.patient.birthDate).getFullYear();
+    return targetYear - birthYear;
   };
 
-  //Ampath Helper Functions
-  calcBSA = (height: number, weight: number) => {
-    let result: string;
-    if (height && weight) {
-      result = Math.sqrt((height * weight) / 3600).toFixed(2);
+  /**
+   * Calculates Body Surface Area (BSA) using the Mosteller formula.
+   * Formula: √((height × weight) / 3600)
+   * @param height - Height in centimeters
+   * @param weight - Weight in kilograms
+   * @returns BSA in m² rounded to 2 decimal places, or null if inputs are missing
+   */
+  calcBSA = (height: number, weight: number): number | null => {
+    if (!height || !weight) {
+      return null;
     }
-    return result ? parseFloat(result) : null;
+    return parseFloat(Math.sqrt((height * weight) / 3600).toFixed(2));
   };
 
+  /**
+   * Checks if an array contains ALL of the specified members.
+   * @param array - The array to search in
+   * @param members - A single value or array of values that must all be present
+   * @returns true if array contains all members, false otherwise.
+   *          Returns true for empty members array. Returns false for null/non-array input.
+   */
   arrayContains = <T = any>(array: T[], members: T[] | T) => {
     if (!array || !Array.isArray(array)) {
       return false;
@@ -214,6 +373,13 @@ export class CommonExpressionHelpers {
     return true;
   };
 
+  /**
+   * Checks if an array contains ANY of the specified members.
+   * @param array - The array to search in
+   * @param members - An array of values where at least one must be present
+   * @returns true if array contains at least one member, false otherwise.
+   *          Returns true for empty members array. Returns false for null/non-array input.
+   */
   arrayContainsAny = <T = any>(array: T[], members: T[]) => {
     if (!array || !Array.isArray(array)) {
       return false;
@@ -240,14 +406,27 @@ export class CommonExpressionHelpers {
     return false;
   };
 
+  /**
+   * Parses a date string into a Date object using OpenMRS framework parsing.
+   * @param dateString - The date string to parse
+   * @returns A Date object
+   */
   parseDate = (dateString: string) => {
     return parseDate(dateString);
   };
 
+  /**
+   * Formats a date value into a string.
+   * @param value - The date to format (Date object or value that can be converted to Date)
+   * @param format - Optional dayjs format string (e.g., 'YYYY-MM-DD', 'DD/MM/YYYY').
+   *                 If not provided, uses OpenMRS default locale format.
+   * @returns Formatted date string
+   * @throws Error if the value cannot be converted to a valid date
+   */
   formatDate = (value: ConstructorParameters<typeof Date>[0], format?: string) => {
     if (!(value instanceof Date)) {
       value = new Date(value);
-      if (value === null || value === undefined || isNaN(value.getTime())) {
+      if (isNaN(value.getTime())) {
         throw new Error('DateFormatException: value passed is not a valid date');
       }
     }
@@ -257,6 +436,12 @@ export class CommonExpressionHelpers {
     return formatDate(value);
   };
 
+  /**
+   * Extracts values for a specific key from an array of objects (typically repeating group data).
+   * @param key - The property key to extract from each object
+   * @param array - Array of objects to extract values from
+   * @returns Array of values for the specified key
+   */
   extractRepeatingGroupValues = (key: string | number | symbol, array: Record<string | number | symbol, unknown>[]) => {
     const values = array.map(function (item) {
       return item[key];
@@ -266,20 +451,14 @@ export class CommonExpressionHelpers {
 
   /**
    * Calculates the gravida (total number of pregnancies) based on term pregnancies and abortions/miscarriages.
-   *
-   * @param {number|string} parityTerm - The number of term pregnancies.
-   * @param {number|string} parityAbortion - The number of abortions (including miscarriages).
-   * @returns {number} The total number of pregnancies (gravida).
-   * @throws {Error} If either input is not a valid number.
-   *
-   * @example
-   * const gravida = calcGravida(2, 1);
-   * console.log(gravida); // Output: 3
+   * @param parityTerm - The number of term pregnancies (can be number or numeric string)
+   * @param parityAbortion - The number of abortions including miscarriages (can be number or numeric string)
+   * @returns The total number of pregnancies (gravida)
+   * @throws Error if either input is not a valid number
    */
-
-  calcGravida = (parityTerm, parityAbortion) => {
-    const term = parseInt(parityTerm, 10);
-    const abortion = parseInt(parityAbortion, 10);
+  calcGravida = (parityTerm: number | string, parityAbortion: number | string): number => {
+    const term = typeof parityTerm === 'number' ? parityTerm : parseInt(parityTerm, 10);
+    const abortion = typeof parityAbortion === 'number' ? parityAbortion : parseInt(parityAbortion, 10);
 
     if (!Number.isInteger(term) || !Number.isInteger(abortion)) {
       throw new Error('Both inputs must be valid numbers.');
@@ -288,181 +467,106 @@ export class CommonExpressionHelpers {
     return term + abortion;
   };
 
-  calcWeightForHeightZscore = (height, weight) => {
+  /**
+   * Calculates the Weight-for-Height Z-score for pediatric patients using WHO growth standards.
+   * Used to assess acute malnutrition (wasting).
+   * @param height - Patient's height/length in centimeters (valid range: 45-110 cm)
+   * @param weight - Patient's weight in kilograms
+   * @returns Z-score as a string (e.g., '-2', '0', '1'), '-4' if out of range, or null if inputs missing
+   */
+  calcWeightForHeightZscore = (height: number, weight: number): string | null => {
+    if (!height || !weight) {
+      return null;
+    }
+
     const birthDate = new Date(this.patient.birthDate);
     const weightForHeightRef = getZRefByGenderAndAge(this.patient.sex, birthDate, new Date()).weightForHeightRef;
-    let refSection;
-    let formattedSDValue;
-    if (height && weight) {
-      height = parseFloat(height).toFixed(1);
-    }
+
+    const formattedHeight = height.toFixed(1);
     const standardHeightMin = 45;
     const standardMaxHeight = 110;
-    if (height < standardHeightMin || height > standardMaxHeight) {
-      formattedSDValue = -4;
-    } else {
-      refSection = filter(weightForHeightRef, (refObject) => {
-        return parseFloat(refObject['Length']).toFixed(1) === height;
-      });
-    }
 
-    const refSectionObject = first(refSection);
-    if (refSectionObject) {
-      const refObjectValues = Object.keys(refSectionObject)
-        .map((key) => refSectionObject[key])
-        .map((x) => x);
-      const refObjectKeys = Object.keys(refSectionObject);
-      const minimumValue = refObjectValues[1];
-      const minReferencePoint = [];
-      if (weight < minimumValue) {
-        minReferencePoint.push(minimumValue);
-      } else {
-        forEach(refObjectValues, (value) => {
-          if (value <= weight) {
-            minReferencePoint.push(value);
-          }
-        });
-      }
-      const lastReferenceValue = last(minReferencePoint);
-      const lastValueIndex = findIndex(refObjectValues, (o) => {
-        return o === lastReferenceValue;
-      });
-      const SDValue = refObjectKeys[lastValueIndex];
-      formattedSDValue = SDValue?.replace('SD', '');
-      if (formattedSDValue.includes('neg')) {
-        formattedSDValue = formattedSDValue.substring(1, 0);
-        formattedSDValue = '-' + formattedSDValue;
-      }
-      if (
-        formattedSDValue === 'S' ||
-        formattedSDValue === 'L' ||
-        formattedSDValue === 'M' ||
-        formattedSDValue === '-5'
-      ) {
-        formattedSDValue = '-4';
-      }
+    if (parseFloat(formattedHeight) < standardHeightMin || parseFloat(formattedHeight) > standardMaxHeight) {
+      return '-4';
     }
 
-    return height && weight ? formattedSDValue : null;
+    const refSection = filter(weightForHeightRef, (refObject) => {
+      return parseFloat(refObject['Length']).toFixed(1) === formattedHeight;
+    });
+
+    const refSectionObject = first(refSection);
+    return this.calculateZScoreFromRef(refSectionObject, weight);
   };
 
-  calcBMIForAgeZscore = (height, weight) => {
+  /**
+   * Calculates the BMI-for-Age Z-score for pediatric patients using WHO growth standards.
+   * Used to assess both undernutrition and overweight/obesity.
+   * @param height - Patient's height in centimeters
+   * @param weight - Patient's weight in kilograms
+   * @returns Z-score as a string (e.g., '-2', '0', '1'), or null if inputs missing
+   */
+  calcBMIForAgeZscore = (height: number, weight: number): string | null => {
+    if (!height || !weight) {
+      return null;
+    }
+
     const birthDate = new Date(this.patient.birthDate);
     const bmiForAgeRef = getZRefByGenderAndAge(this.patient.sex, birthDate, new Date()).bmiForAgeRef;
-    let bmi;
-    const maxAgeInDays = 1856;
-    if (height && weight) {
-      bmi = (weight / (((height / 100) * height) / 100)).toFixed(1);
-    }
-    const refSectionObject = first(bmiForAgeRef);
-    let formattedSDValue;
-    if (refSectionObject) {
-      const refObjectValues = Object.keys(refSectionObject)
-        .map((key) => refSectionObject[key])
-        .map((x) => x);
-      const refObjectKeys = Object.keys(refSectionObject);
-      const minimumValue = refObjectValues[1];
-      const minReferencePoint = [];
-      if (bmi < minimumValue) {
-        minReferencePoint.push(minimumValue);
-      } else {
-        forEach(refObjectValues, (value) => {
-          if (value <= bmi) {
-            minReferencePoint.push(value);
-          }
-        });
-      }
-      const lastReferenceValue = last(minReferencePoint);
-      const lastValueIndex = findIndex(refObjectValues, (o) => {
-        return o === lastReferenceValue;
-      });
-      const SDValue = refObjectKeys[lastValueIndex];
-      formattedSDValue = SDValue?.replace('SD', '');
-      if (formattedSDValue.includes('neg')) {
-        formattedSDValue = formattedSDValue.substring(1, 0);
-        formattedSDValue = '-' + formattedSDValue;
-      }
 
-      if (
-        formattedSDValue === 'S' ||
-        formattedSDValue === 'L' ||
-        formattedSDValue === 'M' ||
-        formattedSDValue === '-5'
-      ) {
-        formattedSDValue = '-4';
-      }
-    }
+    const heightInMeters = height / 100;
+    const bmi = parseFloat((weight / (heightInMeters * heightInMeters)).toFixed(1));
 
-    return bmi && refSectionObject ? formattedSDValue : null;
+    const refSectionObject = first(bmiForAgeRef);
+    return this.calculateZScoreFromRef(refSectionObject, bmi);
   };
 
-  calcHeightForAgeZscore = (height, weight) => {
+  /**
+   * Calculates the Height-for-Age Z-score for pediatric patients using WHO growth standards.
+   * Used to assess chronic malnutrition (stunting).
+   * @param height - Patient's height/length in centimeters
+   * @param _weight - Unused parameter kept for backward compatibility
+   * @returns Z-score as a string (e.g., '-2', '0', '1'), or null if height is missing
+   */
+  calcHeightForAgeZscore = (height: number, _weight?: number): string | null => {
+    if (!height) {
+      return null;
+    }
+
     const birthDate = new Date(this.patient.birthDate);
     const heightForAgeRef = getZRefByGenderAndAge(this.patient.sex, birthDate, new Date()).heightForAgeRef;
     const refSectionObject = first(heightForAgeRef);
-    let formattedSDValue;
-    if (refSectionObject) {
-      const refObjectValues = Object.keys(refSectionObject)
-        .map((key) => refSectionObject[key])
-        .map((x) => x);
-      const refObjectKeys = Object.keys(refSectionObject);
-      const minimumValue = refObjectValues[1];
-      const minReferencePoint = [];
-      if (height < minimumValue) {
-        minReferencePoint.push(minimumValue);
-      } else {
-        forEach(refObjectValues, (value) => {
-          if (value <= height) {
-            minReferencePoint.push(value);
-          }
-        });
-      }
-      const lastReferenceValue = last(minReferencePoint);
-      const lastValueIndex = findIndex(refObjectValues, (o) => {
-        return o === lastReferenceValue;
-      });
-      const SDValue = refObjectKeys[lastValueIndex];
-      formattedSDValue = SDValue?.replace('SD', '');
-      if (formattedSDValue.includes('neg')) {
-        formattedSDValue = formattedSDValue.substring(1, 0);
-        formattedSDValue = '-' + formattedSDValue;
-      }
-
-      if (
-        formattedSDValue === 'S' ||
-        formattedSDValue === 'L' ||
-        formattedSDValue === 'M' ||
-        formattedSDValue === '-5'
-      ) {
-        formattedSDValue = '-4';
-      }
-    }
 
-    return height && weight && refSectionObject ? formattedSDValue : null;
+    return this.calculateZScoreFromRef(refSectionObject, height);
   };
 
-  calcTimeDifference = (obsDate: Date | dayjs.Dayjs, timeFrame: 'd' | 'w' | 'm' | 'y') => {
-    let daySinceLastObs: number | string = '';
+  /**
+   * Calculates the time difference between an observation date and today.
+   * @param obsDate - The observation/reference date to compare against today
+   * @param timeFrame - The unit of time: 'd' (days), 'w' (weeks), 'm' (months), or 'y' (years)
+   * @returns The absolute time difference as a number, or 0 if obsDate is not provided
+   */
+  calcTimeDifference = (obsDate: Date | dayjs.Dayjs, timeFrame: 'd' | 'w' | 'm' | 'y'): number => {
+    if (!obsDate) {
+      return 0;
+    }
+
     const endDate = dayjs();
-    if (obsDate) {
-      if (timeFrame == 'd') {
-        daySinceLastObs = Math.abs(Math.round(endDate.diff(obsDate, 'day', true)));
-      }
-      if (timeFrame == 'w') {
-        daySinceLastObs = Math.abs(Math.round(endDate.diff(obsDate, 'week', true)));
-      }
-      if (timeFrame == 'm') {
-        daySinceLastObs = Math.abs(Math.round(endDate.diff(obsDate, 'month', true)));
-      }
-      if (timeFrame == 'y') {
-        daySinceLastObs = Math.abs(Math.round(endDate.diff(obsDate, 'year', true)));
-      }
+    switch (timeFrame) {
+      case 'd':
+        return Math.abs(Math.round(endDate.diff(obsDate, 'day', true)));
+      case 'w':
+        return Math.abs(Math.round(endDate.diff(obsDate, 'week', true)));
+      case 'm':
+        return Math.abs(Math.round(endDate.diff(obsDate, 'month', true)));
+      case 'y':
+        return Math.abs(Math.round(endDate.diff(obsDate, 'year', true)));
     }
-    return daySinceLastObs === '' ? '0' : daySinceLastObs;
   };
 
   /**
-   * Used as wrapper around async functions. It basically evaluates the promised value.
+   * Resolves a Promise and returns its value. Used to await async operations in form expressions.
+   * @param lazy - A Promise to resolve
+   * @returns A Promise that resolves to the value of the input Promise
    */
   resolve = (lazy: Promise<unknown>) => {
     return Promise.resolve(lazy);
@@ -484,6 +588,12 @@ export function simpleHash(str: string) {
   return hash;
 }
 
+/**
+ * Registers a dependency relationship between a form node and a field.
+ * When the determinant field's value changes, the dependent node will be re-evaluated.
+ * @param node - The dependent node (page, section, or field) that depends on the determinant
+ * @param determinant - The field that the node depends on
+ */
 export function registerDependency(node: FormNode, determinant: FormField) {
   if (!node || !determinant) {
     return;