@ukhomeoffice/cop-react-form-renderer 6.15.3-alpha → 6.15.3

package/dist/hooks/useGetRequest.js

@@ -8,10 +8,6 @@ var _axios = _interopRequireDefault(require("axios"));
 var _react = require("react");
 var _useAxios = _interopRequireDefault(require("./useAxios"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-// Global imports
-
-// Local imports
-
 // Caches for responses and errors.
 const cache = {};
 const errorCache = {};
@@ -31,15 +27,18 @@ const STATUS_IDLE = exports.STATUS_IDLE = 'idle';
 const STATUS_FETCHING = exports.STATUS_FETCHING = 'fetching';
 const STATUS_FETCHED = exports.STATUS_FETCHED = 'fetched';
 const STATUS_ERROR = exports.STATUS_ERROR = 'error';
-const useGetRequest = url => {
+const useGetRequest = function (url) {
+  let caching = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
   const axiosInstance = (0, _useAxios.default)();
-  const cancelToken = _axios.default.CancelToken.source();
-  const cancelRequests = () => {
-    if (cancelToken) cancelToken.cancel();
-  };
+  const cancelTokenRef = (0, _react.useRef)(_axios.default.CancelToken.source());
   const [status, setStatus] = (0, _react.useState)(STATUS_IDLE);
   const [error, setError] = (0, _react.useState)(null);
   const [data, setData] = (0, _react.useState)(null);
+  const cancelRequests = () => {
+    if (cancelTokenRef.current) {
+      cancelTokenRef.current.cancel();
+    }
+  };
   (0, _react.useEffect)(() => {
     if (!url || !axiosInstance) return;
     const fetchData = async () => {
@@ -47,9 +46,9 @@ const useGetRequest = url => {
         setError(null);
         setStatus(STATUS_FETCHING);
         let fetchedData;
-        if (cache[url]) {
+        if (caching && cache[url]) {
           fetchedData = cache[url];
-        } else if (errorCache[url]) {
+        } else if (caching && errorCache[url]) {
           /**
            * This logic is intended to stop multiple requests being made in succession
            * that all fail. Presently, this will only allow the first request to be
@@ -60,24 +59,25 @@ const useGetRequest = url => {
           throw errorCache[url];
         } else {
           const response = await axiosInstance.get(url, {
-            cancelToken: cancelToken.token
+            cancelToken: cancelTokenRef.current.token
           }).catch(e => {
+            setError(e);
             throw e;
           });
           fetchedData = response.data;
-          cache[url] = fetchedData;
+          if (caching) cache[url] = fetchedData;
         }
         setData(fetchedData);
         setStatus(STATUS_FETCHED);
       } catch (e) {
-        errorCache[url] = e;
+        if (caching) errorCache[url] = e;
         setError(e);
         setData(null);
         setStatus(STATUS_ERROR);
       }
     };
     fetchData();
-  }, [axiosInstance, url, cancelToken.token]);
+  }, [axiosInstance, url, caching]);
   return {
     status,
     error,

package/dist/hooks/useRefData.js

@@ -28,13 +28,14 @@ const getRefDataUrl = component => {
   return undefined;
 };
 const useRefData = (component, formData) => {
+  var _component$data;
   const url = getRefDataUrl(_objectSpread(_objectSpread({}, component), {}, {
     formData
   }));
   const {
     status: _status,
     data: _data
-  } = (0, _useGetRequest.default)(url);
+  } = (0, _useGetRequest.default)(url, component === null || component === void 0 || (_component$data = component.data) === null || _component$data === void 0 ? void 0 : _component$data.useCache);
   const [data, setData] = (0, _react.useState)([]);
   const [status, setStatus] = (0, _react.useState)(STATUS_LOADING);
   (0, _react.useEffect)(() => {
@@ -52,7 +53,7 @@ const useRefData = (component, formData) => {
       setData([]);
       setStatus(STATUS_COMPLETE);
     }
-  }, [component, _status, _data, url, setData, setStatus]);
+  }, [component.id, _status, _data, url]);
   return {
     data,
     status

package/dist/utils/CollectionPage/getQuickEditPage.js

@@ -8,8 +8,8 @@ var _meetsAllConditions = _interopRequireDefault(require("../Condition/meetsAllC
 var _showFormPage = _interopRequireDefault(require("../FormPage/showFormPage"));
 const _excluded = ["id"];
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var s = Object.getOwnPropertySymbols(e); for (r = 0; r < s.length; r++) o = s[r], t.includes(o) || {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
-function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (e.includes(n)) continue; t[n] = r[n]; } return t; }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }

package/dist/utils/Component/getComponentTests/getComponent.multifile.test.js

@@ -23,7 +23,8 @@ describe('utils.Component.get', () => {
       fieldId: FIELD_ID,
       label: LABEL,
       onChange: ON_CHANGE,
-      'data-testid': ID
+      'data-testid': ID,
+      allowedTypes: []
     };
     const {
       container

package/dist/utils/Component/getDefaultValueFromConfig.js

@@ -75,7 +75,8 @@ const setupDefaultObjectValue = (defaultObject, data) => {
   // defaultObject.sourced is an object with values that should
   // be used as field names to get values from data.
   if (defaultObj.sourced) {
-    result = result !== null && result !== void 0 ? result : {};
+    var _result;
+    result = (_result = result) !== null && _result !== void 0 ? _result : {};
     Object.keys(defaultObj.sourced).every(key => {
       const sourcedValue = typeof defaultObj.sourced[key] === 'string' && (0, _getSourceData.default)(data, defaultObj.sourced[key]);
       if (sourcedValue === undefined && defaultObj.skipIfSourceInvalid) {

package/dist/utils/Condition/meetsCondition.js

@@ -20,6 +20,26 @@ const getComparisonValue = (condition, data) => {
   return condition.value;
 };
 
+/**
+ * Processes a value based on its type.
+ * - If it's an array, returns its length.
+ * - If it's a string, parses it as a float.
+ * - If it's a number, returns it as is.
+ * - Returns `undefined` for other types.
+ * 
+ * @param {any} value - The value to process.
+ * @returns {number | undefined} - The processed value or `undefined` if not applicable.
+ */
+const getProcessedValue = obj => {
+  if (Array.isArray(obj)) return obj.length;
+  if (typeof obj === "string") {
+    const cleaned = obj.replace(/,/g, ''); // Remove all commas
+    return Number.isNaN(cleaned) ? null : parseFloat(cleaned);
+  }
+  if (typeof obj === "number") return obj;
+  return null;
+};
+
 /**
  * Looks at a condition object to see if the supplied value meets it.
  * The condition object contains an `op` property, along with a comparator
@@ -66,21 +86,15 @@ const meetsCondition = (condition, value, data) => {
         }
       case '<':
         {
-          if (!value || !compare) {
-            return false;
-          }
-          const valFloat = parseFloat(value.replace(',', ''));
-          const compareFloat = parseFloat(compare.replace(',', ''));
-          return valFloat < compareFloat;
+          const valFloat = getProcessedValue(value);
+          const compareFloat = getProcessedValue(compare);
+          return valFloat != null && compareFloat != null && valFloat < compareFloat;
         }
       case '>':
         {
-          if (!value || !compare) {
-            return false;
-          }
-          const valFloat = parseFloat(value.replace(/,/g, ''));
-          const compareFloat = parseFloat(compare.replace(/,/g, ''));
-          return valFloat > compareFloat;
+          const valFloat = getProcessedValue(value);
+          const compareFloat = getProcessedValue(compare);
+          return valFloat != null && compareFloat != null && valFloat > compareFloat;
         }
       case 'contains':
         {

package/dist/utils/Condition/meetsCondition.test.js

@@ -551,6 +551,27 @@ describe('utils.Condition.meetsCondition', () => {
       };
       expect((0, _meetsCondition.default)(CONDITION, '10,000,000')).toBeTruthy();
     });
+    it('greater than should handle value is 0', () => {
+      const CONDITION = {
+        op: '>',
+        value: 0
+      };
+      expect((0, _meetsCondition.default)(CONDITION, 1)).toBeTruthy();
+    });
+    it('greater than should handle compear is 0', () => {
+      const CONDITION = {
+        op: '<',
+        value: 1
+      };
+      expect((0, _meetsCondition.default)(CONDITION, 0)).toBeTruthy();
+    });
+    it('greater than should handle array is 0', () => {
+      const CONDITION = {
+        op: '>',
+        value: 1
+      };
+      expect((0, _meetsCondition.default)(CONDITION, ["A", "B", "C"])).toBeTruthy();
+    });
   });
   describe('operator includes', () => {
     it('should accept a string that exists within the value', () => {

package/dist/utils/Data/getAutocompleteSource.js

@@ -7,63 +7,80 @@ exports.default = void 0;
 var _copReactComponents = require("@ukhomeoffice/cop-react-components");
 var _getOptions = _interopRequireDefault(require("./getOptions"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-// Global Imports
-
-// Local imports
+const MAX_NUMBER_RESULTS = 6000; // lower is better for performance, this still includes all ports
 
+const assignFullMatchScore = (subStringMatchIndex, label) => {
+  const matchAtBeginning = subStringMatchIndex === 0;
+  let score = 0;
+  if (matchAtBeginning) {
+    score = 1;
+  }
+  if (!matchAtBeginning) {
+    const isCompleteWord = label.substring(subStringMatchIndex - 1).startsWith(" ");
+    score = isCompleteWord ? 2 : 3;
+  }
+  return score;
+};
+const noMatch = score => score === 0;
+const lowerCaseMatch = (searchTerm, query) => typeof searchTerm !== 'string' ? false : searchTerm.toLowerCase().includes(query);
+const assignSynonymsScore = (option, searchQuery) => {
+  let score = 0;
+  const isMatch = option.synonyms.some(synonym => lowerCaseMatch(synonym, searchQuery));
+  if (isMatch) {
+    score = 4;
+  }
+  return score;
+};
+const assignExtraFieldsScore = (config, option, searchQuery) => {
+  let score = 0;
+  const isMatch = config.item.extraFieldsToSearch.some(field => {
+    const fieldToSearch = option[field];
+    return lowerCaseMatch(fieldToSearch, searchQuery);
+  });
+  if (isMatch) {
+    score = 5;
+  }
+  return score;
+};
+const mapToScoreAndLabel = (option, searchQuery, labelMapper, config) => {
+  var _config$item;
+  const label = labelMapper ? labelMapper(option).toLowerCase() : option.label.toLowerCase() || '';
+  let score = 0;
+  const subStringMatchIndex = label.indexOf(searchQuery);
+  const isFullMatch = subStringMatchIndex !== -1;
+  if (isFullMatch) {
+    score = assignFullMatchScore(subStringMatchIndex, label);
+  }
+  if (noMatch(score) && option.synonyms) {
+    score = assignSynonymsScore(option, searchQuery);
+  }
+  if (noMatch(score) && (_config$item = config.item) !== null && _config$item !== void 0 && _config$item.extraFieldsToSearch) {
+    score = assignExtraFieldsScore(config, option, searchQuery);
+  }
+  return {
+    score,
+    label,
+    option
+  };
+};
+const scoreOptions = (searchQuery, labelMapper, config) => (scoredOptions, option) => {
+  const scoredOption = mapToScoreAndLabel(option, searchQuery, labelMapper, config);
+  if (scoredOption.score > 0) {
+    scoredOptions.push(scoredOption);
+  }
+  return scoredOptions;
+};
+const compareByScoreAndLabel = (r1, r2) => (r1.score - r2.score) * 16 + r1.label.localeCompare(r2.label);
 const getAutocompleteSource = config => {
   let options = [];
   (0, _getOptions.default)(config, val => {
     options = val;
   });
-  const labelMaker = config !== null && config !== void 0 && config.item ? _copReactComponents.Utils.itemLabel(config.item) : null;
-  return (query, populateResults) => {
-    const lcQuery = query ? query.toLowerCase() : '';
-
-    // go through all options and give them a grade
-
-    const results = options.map(opt => {
-      const label = labelMaker ? labelMaker(opt) : opt.label || '';
-      const lcLabel = label.toLowerCase();
-
-      // result 'score'
-      let grade = 0;
-
-      // highest result - match at start of string
-      const index = lcLabel.indexOf(lcQuery);
-      if (index === 0) {
-        grade = 1;
-      } else if (index > 0) {
-        grade = lcLabel.substring(index - 1).startsWith(" ") ? 2 : 3;
-      } else {
-        var _config$item;
-        if (opt.synonyms) {
-          const match = opt.synonyms.some(synonym => synonym.toLowerCase().includes(lcQuery));
-          if (match) {
-            grade = 4;
-          }
-        }
-        if (!grade && (_config$item = config.item) !== null && _config$item !== void 0 && _config$item.extraFieldsToSearch) {
-          const found = config.item.extraFieldsToSearch.some(field => {
-            if (typeof opt[field] !== 'string') {
-              return false;
-            }
-            return opt[field].toLowerCase().includes(lcQuery);
-          });
-          if (found) grade = 5;
-        }
-      }
-      return {
-        grade,
-        label,
-        opt
-      };
-    }).filter(result => result.grade > 0);
-
-    // sort results and then map to just opts
-    populateResults(results
-    // the sort prioritises grade but also sorts by string value
-    .sort((r1, r2) => (r1.grade - r2.grade) * 16 + r1.label.localeCompare(r2.label)).map(r => r.opt));
+  const labelMapper = config !== null && config !== void 0 && config.item ? _copReactComponents.Utils.itemLabel(config.item) : null;
+  return (query, renderResult) => {
+    const searchQuery = typeof query === 'string' ? query.toLowerCase() : '';
+    const result = options.reduce(scoreOptions(searchQuery, labelMapper, config), []).sort(compareByScoreAndLabel).slice(0, MAX_NUMBER_RESULTS).map(scoredOptions => scoredOptions.option);
+    renderResult(result);
   };
 };
 var _default = exports.default = getAutocompleteSource;

package/dist/utils/Data/getAutocompleteSource.test.js

@@ -6,10 +6,9 @@ function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbol
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
-function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } // Local imports
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 describe('utils', () => {
   describe('Data', () => {
-    // test data
     const gbCurrency = {
       currencyName: 'Great British Pounds',
       currencyCode: 'GBP',
@@ -25,7 +24,7 @@ describe('utils', () => {
       value: 'USD',
       label: 'USD',
       slangTerm: 'bucks',
-      synonyms: ['greenbacks']
+      synonyms: ['greenbacks', 11]
     };
     const options = {
       alpha: {
@@ -81,6 +80,15 @@ describe('utils', () => {
             }]);
           });
         });
+        it('should only return first 6000 results that have some type of match', () => {
+          const moreThanMaxNumberOfOptions = Array(6001).fill(options.alpha);
+          const config = {
+            data: {
+              options: moreThanMaxNumberOfOptions
+            }
+          };
+          (0, _getAutocompleteSource.default)(config)(options.alpha.label, results => expect(results.length).toEqual(6000));
+        });
         it('should handle an empty query', () => {
           const CONFIG = {
             data: {
@@ -117,6 +125,18 @@ describe('utils', () => {
             expect(results).toEqual([options.alpha, options.bravo]);
           });
         });
+        it('should handle a non string query', () => {
+          const CONFIG = {
+            data: {
+              options: [options.alpha, options.bravo]
+            }
+          };
+          const SOURCE = (0, _getAutocompleteSource.default)(CONFIG);
+          SOURCE(1, results => {
+            expect(results.length).toEqual(2);
+            expect(results).toEqual([options.alpha, options.bravo]);
+          });
+        });
         it('should handle a missing label on an option', () => {
           const CONFIG = {
             data: {
@@ -171,8 +191,7 @@ describe('utils', () => {
             item: {
               value: 'currencyCode',
               label: 'currencyCode',
-              // eslint-disable-next-line no-template-curly-in-string
-              format: '${currencyName} (${currencyCode})'
+              format: "${currencyName} (${currencyCode})"
             },
             data: {
               options: testCurrencies
@@ -194,8 +213,7 @@ describe('utils', () => {
             item: {
               value: 'currencyCode',
               label: 'currencyCode',
-              // eslint-disable-next-line no-template-curly-in-string
-              format: '${currencyName} (${currencyCode})'
+              format: "${currencyName} (${currencyCode})"
             },
             data: {
               options: testCurrencies
@@ -212,8 +230,7 @@ describe('utils', () => {
             item: {
               value: 'currencyCode',
               label: 'currencyCode',
-              // eslint-disable-next-line no-template-curly-in-string
-              format: '${currencyName} (${currencyCode})'
+              format: "${currencyName} (${currencyCode})"
             },
             data: {
               options: testCurrencies
@@ -230,8 +247,7 @@ describe('utils', () => {
             item: {
               value: 'currencyCode',
               label: 'currencyCode',
-              // eslint-disable-next-line no-template-curly-in-string
-              format: '${currencyName} (${currencyCode})'
+              format: "${currencyName} (${currencyCode})"
             },
             data: {
               options: testCurrencies
@@ -248,8 +264,7 @@ describe('utils', () => {
             item: {
               value: 'currencyCode',
               label: 'currencyCode',
-              // eslint-disable-next-line no-template-curly-in-string
-              format: '${currencyName} (${currencyCode})'
+              format: "${currencyName} (${currencyCode})"
             },
             data: {
               options: [gbCurrency, {
@@ -281,8 +296,7 @@ describe('utils', () => {
             item: {
               value: 'currencyCode',
               label: 'currencyCode',
-              // eslint-disable-next-line no-template-curly-in-string
-              format: '${currencyName} (${currencyCode})'
+              format: "${currencyName} (${currencyCode})"
             },
             data: {
               options: testCurrencies
@@ -300,9 +314,8 @@ describe('utils', () => {
             item: {
               value: 'currencyCode',
               label: 'currencyCode',
-              // eslint-disable-next-line no-template-curly-in-string
-              format: '${currencyName} (${currencyCode})',
-              extraFieldsToSearch: ['slangTerm']
+              format: "${currencyName} (${currencyCode})",
+              extraFieldsToSearch: ['slangTerm', null]
             },
             data: {
               options: testCurrencies

package/dist/utils/Operate/doesContainValue.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _copReactComponents = require("@ukhomeoffice/cop-react-components");
+var _getSourceData = _interopRequireDefault(require("../Data/getSourceData"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// Global imports.
+
+// Local imports.
+
+/**
+ * Returns if it can find a value in the form data. supports searching in arrays and objects
+ * @param {object} config The config of the operation.
+ * @param {string} config.target the JPath to the object/array that contains the data we want to checkon
+ * @param {string} config.key the JPath to the field we want to check
+ * @param {string} config.value the value that we want to check the the data against
+ * @param {object} data A page's formData.
+ * @returns The index of the matching value if one exists, or null.
+ */
+const doesContainValue = (config, data) => {
+  const targetPath = _copReactComponents.Utils.interpolateString(config.target, data);
+  const target = (0, _getSourceData.default)(data, targetPath);
+  if (target && Array.isArray(target)) {
+    return target.some(entry => config.key ? (0, _getSourceData.default)(entry, config.key) === config.value : entry === config.value);
+  }
+  if (target && typeof target === "object") {
+    return (0, _getSourceData.default)(target, config.key) === config.value;
+  }
+  return false;
+};
+var _default = exports.default = doesContainValue;

package/dist/utils/Operate/doesContainValue.test.js

@@ -0,0 +1,75 @@
+"use strict";
+
+var _doesContainValue = _interopRequireDefault(require("./doesContainValue"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+describe('doesContainValue', () => {
+  const mockData = {
+    arrayOfValues: ['abc', 'bcd', 'cde', 'def', {
+      root: {
+        branch: 'leaf'
+      }
+    }],
+    cutoffIndex: 1,
+    ignoreIndex: 2,
+    valueToSearchFor: 'cde',
+    targetName: 'arrayOfValues',
+    fieldName: 'valueToSearchFor',
+    cutoffName: 'cutoffIndex',
+    ignoreName: 'ignoreIndex'
+  };
+  test('returns true if value exists in array', () => {
+    const config = {
+      target: 'arrayOfValues',
+      value: 'cde'
+    };
+    const result = (0, _doesContainValue.default)(config, mockData);
+    expect(result).toBe(true);
+  });
+  test('returns false if value does not exist in array', () => {
+    const config = {
+      target: 'arrayOfValues',
+      value: 'xyz'
+    };
+    const result = (0, _doesContainValue.default)(config, mockData);
+    expect(result).toBe(false);
+  });
+  test('returns true if key-value pair matches in array object', () => {
+    const config = {
+      target: 'arrayOfValues',
+      key: 'root.branch',
+      value: 'leaf'
+    };
+    const result = (0, _doesContainValue.default)(config, mockData);
+    expect(result).toBe(true);
+  });
+  test('returns false if key-value pair does not match in array object', () => {
+    const config = {
+      target: 'arrayOfValues',
+      key: 'root.branch',
+      value: 'notLeaf'
+    };
+    const result = (0, _doesContainValue.default)(config, mockData);
+    expect(result).toBe(false);
+  });
+  test('handles non-array targets gracefully', () => {
+    const config = {
+      target: 'nonExistentTarget',
+      value: 'value'
+    };
+    const result = (0, _doesContainValue.default)(config, mockData);
+    expect(result).toBe(false);
+  });
+  test('handles objects as target correctly', () => {
+    const config = {
+      target: 'objectTarget',
+      key: 'key',
+      value: 'value'
+    };
+    const result = (0, _doesContainValue.default)(config, {
+      objectTarget: {
+        key: 'value'
+      }
+    });
+    expect(result).toBe(true);
+  });
+});

package/dist/utils/Operate/runPageOperations.js

@@ -14,6 +14,7 @@ var _shouldRun = _interopRequireDefault(require("./shouldRun"));
 var _setDataItem = _interopRequireDefault(require("../Data/setDataItem"));
 var _getFirstOf = _interopRequireDefault(require("./getFirstOf"));
 var _getLength = _interopRequireDefault(require("./getLength"));
+var _doesContainValue = _interopRequireDefault(require("./doesContainValue"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 // Global imports.
 
@@ -22,6 +23,7 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
 const functions = {
   checkValueIsTruthy: _checkValueIsTruthy.default,
   getIndexOfMatchingValueIn: _getIndexOfMatchingValueIn.default,
+  doesContainValue: _doesContainValue.default,
   persistValueInFormData: _persistValueInFormData.default,
   setValueInFormData: _setValueInFormData.default,
   deleteValueInFormData: _deleteValueInFormData.default,

package/dist/utils/Validate/validateOnPageLoad.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.doValidateOnPageLoad = void 0;
+var _Condition = _interopRequireDefault(require("../Condition"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const doValidateOnPageLoad = page => {
+  var _validation$runWhen, _validation$runWhen2;
+  if (!(page !== null && page !== void 0 && page.customValidation)) return false;
+
+  // Find the validation with `onLoad` set to true
+  const validation = page === null || page === void 0 ? void 0 : page.customValidation.find(item => {
+    var _item$runWhen;
+    return ((_item$runWhen = item.runWhen) === null || _item$runWhen === void 0 ? void 0 : _item$runWhen.onLoad) === true;
+  });
+  if (!validation) return false;
+
+  // Check if the constraint is met using the condition
+  return (_validation$runWhen = validation.runWhen) !== null && _validation$runWhen !== void 0 && _validation$runWhen.constraint ? _Condition.default.meetsOne((_validation$runWhen2 = validation.runWhen) === null || _validation$runWhen2 === void 0 ? void 0 : _validation$runWhen2.constraint, page.formData) : false;
+};
+exports.doValidateOnPageLoad = doValidateOnPageLoad;