powerpagestoolkit 1.3.102 → 1.3.104

package/dist/index.bundle.js

@@ -1,6 +1,6 @@
 /******/ var __webpack_modules__ = ({
 
-/***/ 693:
+/***/ 672:
 /***/ ((module, __webpack_exports__, __webpack_require__) => {
 
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
@@ -48,6 +48,11 @@ ___CSS_LOADER_EXPORT___.push([module.id, `.info-icon {
     right: auto;
   }
 }
+
+.required-field::after {
+  content: " *" !important;
+  color: #f00 !important;
+}
 `, ""]);
 // Exports
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (___CSS_LOADER_EXPORT___);
@@ -568,113 +573,40 @@ var API = {
 };
 /* harmony default export */ const JS_API = (API);
 ;// ./src/JS/waitFor.js
-/**
- * @description a function that will wait for a targeted element to appear in the DOM, and then resolve a promise to allow further action to be performed after the targeted elements appears
- * @param {String} target a query target expression to target a specific element that you want to appear in the DOM before taking further action
- * @returns {Promise} the element targeted by ID *target*
- */
-
 function waitFor(target) {
-  return new Promise(function (resolve) {
-    if (target instanceof HTMLElement) {
-      return resolve(target);
-    }
-    if (document.querySelector(target)) {
-      return resolve(document.querySelector(target));
-    }
+  return new Promise(function (resolve, reject) {
+    // Create observer to watch for target in DOM
     var observer = new MutationObserver(function () {
-      if (document.querySelector(target)) {
+      var observedElement = document.querySelector(target);
+      if (observedElement) {
+        clearTimeout(timeout);
         observer.disconnect();
-        resolve(document.querySelector(target));
+        resolve(observedElement);
       }
     });
+    var timeout = setTimeout(function () {
+      observer.disconnect();
+      reject(new Error("Element not found: ".concat(target, " within 5 seconds")));
+    }, 5000);
+
+    // Check if target is already in DOM
+    if (target instanceof HTMLElement) {
+      clearTimeout(timeout);
+      return resolve(target);
+    }
+    var element = document.querySelector(target);
+    if (element) {
+      clearTimeout(timeout);
+      return resolve(element);
+    }
     observer.observe(document.body, {
       subtree: true,
-      attributes: true
+      attributes: true,
+      childList: true // Detects added/removed child elements
     });
   });
 }
-;// ./src/JS/FieldValidation.class.js
-function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
-function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
-function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
-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); }
-var FieldValidation = /*#__PURE__*/_createClass(function FieldValidation(fieldLogicalName, fieldDisplayname, evaluationFunction) {
-  _classCallCheck(this, FieldValidation);
-  _defineProperty(this, "createValidator", function () {
-    if (typeof Page_Validators == "undefined") return;
-    // Create new validator
-    var newValidator = document.createElement("span");
-    newValidator.style.display = "none";
-    newValidator.id = "".concat(this.fieldLogicalName, "Validator");
-    newValidator.controltovalidate = "".concat(this.fieldLogicalName);
-    newValidator.errormessage = "<a href='#".concat(this.fieldDisplayname, "_label'>").concat(this.fieldDisplayname, " is a required field</a>");
-    newValidator.validationGroup = ""; // Set this if you have set ValidationGroup on the form
-    newValidator.initialvalue = "";
-    newValidator.evaluationfunction = this.evaluationFunction;
-    // Add the new validator to the page validators array:
-    // eslint-disable-next-line no-undef
-    Page_Validators.push(newValidator);
-  });
-  this.fieldLogicalName = fieldLogicalName;
-  this.fieldDisplayname = fieldDisplayname;
-  this.evaluationFunction = evaluationFunction.bind(this);
-  this.createValidator();
-});
-
-// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/injectStylesIntoStyleTag.js
-var injectStylesIntoStyleTag = __webpack_require__(72);
-var injectStylesIntoStyleTag_default = /*#__PURE__*/__webpack_require__.n(injectStylesIntoStyleTag);
-// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/styleDomAPI.js
-var styleDomAPI = __webpack_require__(825);
-var styleDomAPI_default = /*#__PURE__*/__webpack_require__.n(styleDomAPI);
-// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/insertBySelector.js
-var insertBySelector = __webpack_require__(659);
-var insertBySelector_default = /*#__PURE__*/__webpack_require__.n(insertBySelector);
-// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/setAttributesWithoutAttributes.js
-var setAttributesWithoutAttributes = __webpack_require__(56);
-var setAttributesWithoutAttributes_default = /*#__PURE__*/__webpack_require__.n(setAttributesWithoutAttributes);
-// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/insertStyleElement.js
-var insertStyleElement = __webpack_require__(540);
-var insertStyleElement_default = /*#__PURE__*/__webpack_require__.n(insertStyleElement);
-// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/styleTagTransform.js
-var styleTagTransform = __webpack_require__(113);
-var styleTagTransform_default = /*#__PURE__*/__webpack_require__.n(styleTagTransform);
-// EXTERNAL MODULE: ./node_modules/css-loader/dist/cjs.js!./src/CSS/infoEl.style.css
-var infoEl_style = __webpack_require__(693);
-;// ./src/CSS/infoEl.style.css
-
-      
-      
-      
-      
-      
-      
-      
-      
-      
-
-var options = {};
-
-options.styleTagTransform = (styleTagTransform_default());
-options.setAttributes = (setAttributesWithoutAttributes_default());
-options.insert = insertBySelector_default().bind(null, "head");
-options.domAPI = (styleDomAPI_default());
-options.insertStyleElement = (insertStyleElement_default());
-
-var update = injectStylesIntoStyleTag_default()(infoEl_style/* default */.A, options);
-
-
-
-
-       /* harmony default export */ const CSS_infoEl_style = (infoEl_style/* default */.A && infoEl_style/* default */.A.locals ? infoEl_style/* default */.A.locals : undefined);
-
 ;// ./src/JS/createInfoElement.js
- // Import the CSS file
-
 function CreateInfoEl(titleString) {
   var span = document.createElement("span");
   span.classList.add("info-icon");
@@ -728,6 +660,97 @@ function CreateInfoEl(titleString) {
   });
   return span;
 }
+;// ./src/JS/errors.js
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), 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); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
+function _possibleConstructorReturn(t, e) { if (e && ("object" == _typeof(e) || "function" == typeof e)) return e; if (void 0 !== e) throw new TypeError("Derived constructors may only return object or undefined"); return _assertThisInitialized(t); }
+function _assertThisInitialized(e) { if (void 0 === e) throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); return e; }
+function _inherits(t, e) { if ("function" != typeof e && null !== e) throw new TypeError("Super expression must either be null or a function"); t.prototype = Object.create(e && e.prototype, { constructor: { value: t, writable: !0, configurable: !0 } }), Object.defineProperty(t, "prototype", { writable: !1 }), e && _setPrototypeOf(t, e); }
+function _wrapNativeSuper(t) { var r = "function" == typeof Map ? new Map() : void 0; return _wrapNativeSuper = function _wrapNativeSuper(t) { if (null === t || !_isNativeFunction(t)) return t; if ("function" != typeof t) throw new TypeError("Super expression must either be null or a function"); if (void 0 !== r) { if (r.has(t)) return r.get(t); r.set(t, Wrapper); } function Wrapper() { return _construct(t, arguments, _getPrototypeOf(this).constructor); } return Wrapper.prototype = Object.create(t.prototype, { constructor: { value: Wrapper, enumerable: !1, writable: !0, configurable: !0 } }), _setPrototypeOf(Wrapper, t); }, _wrapNativeSuper(t); }
+function _construct(t, e, r) { if (_isNativeReflectConstruct()) return Reflect.construct.apply(null, arguments); var o = [null]; o.push.apply(o, e); var p = new (t.bind.apply(t, o))(); return r && _setPrototypeOf(p, r.prototype), p; }
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+function _isNativeFunction(t) { try { return -1 !== Function.toString.call(t).indexOf("[native code]"); } catch (n) { return "function" == typeof t; } }
+function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
+function _getPrototypeOf(t) { return _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function (t) { return t.__proto__ || Object.getPrototypeOf(t); }, _getPrototypeOf(t); }
+var DOMNodeInitializationError = /*#__PURE__*/function (_Error) {
+  function DOMNodeInitializationError(instance, error) {
+    var _this;
+    _classCallCheck(this, DOMNodeInitializationError);
+    _this = _callSuper(this, DOMNodeInitializationError, ["There was an error initializing a DOMNodeReference for target: ".concat(instance.target, ", :: ").concat(error)]);
+    _this.name = "DOMNodeInitializationError";
+    return _this;
+  }
+  _inherits(DOMNodeInitializationError, _Error);
+  return _createClass(DOMNodeInitializationError);
+}(/*#__PURE__*/_wrapNativeSuper(Error));
+var DOMNodeNotFoundError = /*#__PURE__*/function (_Error2) {
+  function DOMNodeNotFoundError(instance) {
+    _classCallCheck(this, DOMNodeNotFoundError);
+    return _callSuper(this, DOMNodeNotFoundError, ["The targeted DOM element was not found: ".concat(instance.target)]);
+  }
+  _inherits(DOMNodeNotFoundError, _Error2);
+  return _createClass(DOMNodeNotFoundError);
+}(/*#__PURE__*/_wrapNativeSuper(Error));
+var ConditionalRenderingError = /*#__PURE__*/function (_Error3) {
+  function ConditionalRenderingError(instance, error) {
+    _classCallCheck(this, ConditionalRenderingError);
+    return _callSuper(this, ConditionalRenderingError, ["There was an error condiguring conditional rendering for target: ".concat(instance.target, " :: ").concat(error)]);
+  }
+  _inherits(ConditionalRenderingError, _Error3);
+  return _createClass(ConditionalRenderingError);
+}(/*#__PURE__*/_wrapNativeSuper(Error));
+// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/injectStylesIntoStyleTag.js
+var injectStylesIntoStyleTag = __webpack_require__(72);
+var injectStylesIntoStyleTag_default = /*#__PURE__*/__webpack_require__.n(injectStylesIntoStyleTag);
+// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/styleDomAPI.js
+var styleDomAPI = __webpack_require__(825);
+var styleDomAPI_default = /*#__PURE__*/__webpack_require__.n(styleDomAPI);
+// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/insertBySelector.js
+var insertBySelector = __webpack_require__(659);
+var insertBySelector_default = /*#__PURE__*/__webpack_require__.n(insertBySelector);
+// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/setAttributesWithoutAttributes.js
+var setAttributesWithoutAttributes = __webpack_require__(56);
+var setAttributesWithoutAttributes_default = /*#__PURE__*/__webpack_require__.n(setAttributesWithoutAttributes);
+// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/insertStyleElement.js
+var insertStyleElement = __webpack_require__(540);
+var insertStyleElement_default = /*#__PURE__*/__webpack_require__.n(insertStyleElement);
+// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/styleTagTransform.js
+var styleTagTransform = __webpack_require__(113);
+var styleTagTransform_default = /*#__PURE__*/__webpack_require__.n(styleTagTransform);
+// EXTERNAL MODULE: ./node_modules/css-loader/dist/cjs.js!./src/CSS/style.css
+var style = __webpack_require__(672);
+;// ./src/CSS/style.css
+
+      
+      
+      
+      
+      
+      
+      
+      
+      
+
+var options = {};
+
+options.styleTagTransform = (styleTagTransform_default());
+options.setAttributes = (setAttributesWithoutAttributes_default());
+options.insert = insertBySelector_default().bind(null, "head");
+options.domAPI = (styleDomAPI_default());
+options.insertStyleElement = (insertStyleElement_default());
+
+var update = injectStylesIntoStyleTag_default()(style/* default */.A, options);
+
+
+
+
+       /* harmony default export */ const CSS_style = (style/* default */.A && style/* default */.A.locals ? style/* default */.A.locals : undefined);
+
 ;// ./src/JS/DOMNodeReferences.js
 function DOMNodeReferences_typeof(o) { "@babel/helpers - typeof"; return DOMNodeReferences_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, DOMNodeReferences_typeof(o); }
 function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == DOMNodeReferences_typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator["return"] && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(DOMNodeReferences_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, "catch": function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
@@ -742,6 +765,7 @@ function DOMNodeReferences_toPrimitive(t, r) { if ("object" != DOMNodeReferences
 
 
 
+
 /**
  * Class representing a reference to a DOM node.
  */
@@ -762,16 +786,10 @@ var DOMNodeReference = /*#__PURE__*/function () {
     this.value = null;
     // we defer the rest of initialization
   }
-
-  /**
-   * Initializes the DOMNodeReference instance by waiting for the element to be available in the DOM.
-   */
-  /******/ /******/
   return DOMNodeReferences_createClass(DOMNodeReference, [{
-    key: "init",
-    value: (function () {
-      var _init = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
-        var _this = this;
+    key: "_init",
+    value: function () {
+      var _init2 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
         var element;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
@@ -786,139 +804,202 @@ var DOMNodeReference = /*#__PURE__*/function () {
                 _context.next = 7;
                 break;
               }
-              throw new Error("[SYNACT] No Element could be found with the provided query selector: ".concat(this.target));
+              throw new DOMNodeNotFoundError(this);
             case 7:
-              this.value = this.element.value;
               if (!this.element.classList.contains("boolean-radio")) {
-                _context.next = 15;
+                _context.next = 10;
                 break;
               }
-              _context.next = 11;
-              return createDOMNodeReference("#".concat(this.element.id, "_1"));
-            case 11:
-              this.yesRadio = _context.sent;
-              _context.next = 14;
-              return createDOMNodeReference("#".concat(this.element.id, "_0"));
-            case 14:
-              this.noRadio = _context.sent;
-            case 15:
-              this.element.addEventListener("change", function () {
-                _this.value = _this.element.value;
-              });
-
-              // based on the type of element we have targeted in instantiation
-              // we now grab the parent element that will be responsible for
-              // 'showing' and 'hiding' the target element
-              // this is needed also in order to observe changes to visibility so that
-              // changes to target can cascade to dependent DOMNodeReferences
-              _context.t0 = this.element.tagName;
-              _context.next = _context.t0 === "SPAN" ? 19 : _context.t0 === "INPUT" ? 19 : _context.t0 === "TEXTAREA" ? 19 : _context.t0 === "SELECT" ? 19 : _context.t0 === "FIELDSET" ? 21 : 21;
-              break;
-            case 19:
-              this.visibilityController = this.element.closest("td");
-              return _context.abrupt("break", 22);
-            case 21:
-              this.visibilityController = this.element;
-            case 22:
+              _context.next = 10;
+              return this._attachRadioButtons();
+            case 10:
+              this._initValueSync();
+              this._attachVisibilityController();
               this.defaultDisplay = this.visibilityController.style.display;
               this.isLoaded = true;
-              _context.next = 29;
+              _context.next = 19;
               break;
-            case 26:
-              _context.prev = 26;
-              _context.t1 = _context["catch"](0);
-              throw new Error("powerpagestoolkit: There was an error initializing a DOMNodeReference with the target: ".concat(this.target, " :: ").concat(_context.t1));
-            case 29:
+            case 16:
+              _context.prev = 16;
+              _context.t0 = _context["catch"](0);
+              throw new DOMNodeInitializationError(this, _context.t0);
+            case 19:
             case "end":
               return _context.stop();
           }
-        }, _callee, this, [[0, 26]]);
+        }, _callee, this, [[0, 16]]);
       }));
-      function init() {
-        return _init.apply(this, arguments);
+      function _init() {
+        return _init2.apply(this, arguments);
       }
-      return init;
+      return _init;
     }()
-    /**
-     * Hides the element by setting its display style to "none".
-     * @method hide
-     */
-    /******/
-    )
+  }, {
+    key: "_initValueSync",
+    value: function _initValueSync() {
+      // Function to update this.value based on element type
+
+      // Initial sync
+      this.updateValue();
+
+      // Event listeners for real-time changes based on element type
+      var elementType = this.element.type;
+      if (elementType === "checkbox" || elementType === "radio") {
+        this.element.addEventListener("click", this.updateValue.bind(this));
+      } else if (elementType === "select-one" || elementType === "select-multiple") {
+        this.element.addEventListener("change", this.updateValue.bind(this));
+      } else {
+        this.element.addEventListener("input", this.updateValue.bind(this));
+      }
+    }
+  }, {
+    key: "updateValue",
+    value: function updateValue() {
+      switch (this.element.type) {
+        case "checkbox":
+        case "radio":
+          this.value = this.element.checked;
+          this.checked = this.element.checked;
+          break;
+        case "select-multiple":
+          this.value = Array.from(this.element.selectedOptions).map(function (option) {
+            return option.value;
+          });
+          break;
+        case "file":
+          this.value = this.element.files.length > 0 ? Array.from(this.element.files) : null;
+          break;
+        case "number":
+          this.value = this.element.value !== "" ? Number(this.element.value) : null;
+          break;
+        default:
+          this.value = this.element.value || null;
+          break;
+      }
+      if (this.element.classList.contains("boolean-radio")) {
+        this.yesRadio.updateValue();
+        this.noRadio.updateValue();
+      }
+    }
+  }, {
+    key: "_attachVisibilityController",
+    value: function _attachVisibilityController() {
+      // Set the default visibility controller to the element itself
+      this.visibilityController = this.element;
+
+      // If the element is a table, use its closest fieldset as the controller
+      if (this.element.tagName === "TABLE") {
+        var fieldset = this.element.closest("fieldset");
+        if (fieldset) {
+          this.visibilityController = fieldset;
+        }
+        return;
+      }
+
+      // For specific tag types, use the closest 'td' if available as the controller
+      var tagsRequiringTdParent = ["SPAN", "INPUT", "TEXTAREA", "SELECT", "TABLE"];
+      if (tagsRequiringTdParent.includes(this.element.tagName)) {
+        var tdParent = this.element.closest("td");
+        if (tdParent) {
+          this.visibilityController = tdParent;
+        }
+      }
+    }
+  }, {
+    key: "_attachRadioButtons",
+    value: function () {
+      var _attachRadioButtons2 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              _context2.next = 2;
+              return createDOMNodeReference("#".concat(this.element.id, "_1"));
+            case 2:
+              this.yesRadio = _context2.sent;
+              _context2.next = 5;
+              return createDOMNodeReference("#".concat(this.element.id, "_0"));
+            case 5:
+              this.noRadio = _context2.sent;
+            case 6:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this);
+      }));
+      function _attachRadioButtons() {
+        return _attachRadioButtons2.apply(this, arguments);
+      }
+      return _attachRadioButtons;
+    }()
+  }, {
+    key: "on",
+    value: function on(eventType, eventHandler) {
+      this.element.addEventListener(eventType, eventHandler.bind(this));
+    }
   }, {
     key: "hide",
     value: function hide() {
       this.visibilityController.style.display = "none";
     }
-
-    /**
-     * Shows the element by restoring its default display style.
-     * @method show
-     */
-    /******/
   }, {
     key: "show",
     value: function show() {
       this.visibilityController.style.display = this.defaultDisplay;
     }
-
-    /**
-     * Sets the value of the HTML element.
-     * @method setValue
-     * @param {string} value - The value to set for the HTML element.
-     */
-    /******/
+  }, {
+    key: "toggleVisibility",
+    value: function toggleVisibility(shouldShow) {
+      if (shouldShow instanceof Function) {
+        shouldShow() ? this.show() : this.hide();
+      } else {
+        shouldShow ? this.show() : this.hide();
+      }
+    }
   }, {
     key: "setValue",
     value: function setValue(value) {
-      this.element.value = value;
+      if (this.element.classList.contains("boolean-radio")) {
+        this.yesRadio.element.checked = value;
+        this.noRadio.element.checked = !value;
+      } else {
+        this.element.value = value;
+      }
+    }
+  }, {
+    key: "disable",
+    value: function disable() {
+      try {
+        this.element.disabled = true;
+      } catch (e) {
+        throw new Error("There was an error trying to disable the target: ".concat(this.target));
+      }
+    }
+  }, {
+    key: "enable",
+    value: function enable() {
+      try {
+        this.element.disabled = false;
+      } catch (e) {
+        throw new Error("There was an error trying to disable the target: ".concat(this.target));
+      }
     }
-
-    /**
-     * Appends child elements to the HTML element.
-     * @method append
-     * @param {...HTMLElement} elements - The elements to append to the HTML element.
-     */
-    /******/
   }, {
     key: "append",
     value: function append() {
       var _this$element;
       (_this$element = this.element).append.apply(_this$element, arguments);
     }
-
-    /**
-     * Inserts elements after the HTML element.
-     * @method after
-     * @param {...HTMLElement} elements - The elements to insert after the HTML element.
-     */
-    /******/
   }, {
     key: "after",
     value: function after() {
       var _this$element2;
       (_this$element2 = this.element).after.apply(_this$element2, arguments);
     }
-
-    /**
-     * Retrieves the label associated with the HTML element.
-     * @method getLabel
-     * @returns {HTMLElement} The label element associated with this element.
-     * @throws {Error} Throws an error if the label cannot be found.
-     */
-    /******/
   }, {
     key: "getLabel",
     value: function getLabel() {
       return document.querySelector("#".concat(this.element.id, "_label")) || null;
     }
-
-    /**
-     * Appends child elements to the label associated with the HTML element.
-     * @method appendToLabel
-     * @param {...HTMLElement} elements - The elements to append to the label.
-     */
-    /******/
   }, {
     key: "appendToLabel",
     value: function appendToLabel() {
@@ -930,146 +1011,94 @@ var DOMNodeReference = /*#__PURE__*/function () {
         label.append.apply(label, [" "].concat(elements));
       }
     }
-
-    /**
-     * Adds a click event listener to the HTML element.
-     * @method addClickListener
-     * @param {Function} eventHandler - The function to execute when the element is clicked.
-     */
-    /******/
-  }, {
-    key: "addClickListener",
-    value: function addClickListener(eventHandler) {
-      this.element.addEventListener("click", function (e) {
-        e.preventDefault();
-        eventHandler();
-      });
-    }
-
-    /**
-     * Adds a change event listener to the HTML element.
-     * @method addChangeListener
-     * @param {Function} eventHandler - The function to execute when the element's value changes.
-     */
-    /******/
-  }, {
-    key: "addChangeListener",
-    value: function addChangeListener(eventHandler) {
-      this.element.addEventListener("change", function (e) {
-        e.preventDefault();
-        eventHandler();
-      });
-    }
-
-    /**
-     * Unchecks both the yes and no radio buttons if they exist.
-     * @method uncheckRadios
-     */
-    /******/
-  }, {
-    key: "uncheckRadios",
-    value: function uncheckRadios() {
-      if (this.yesRadio && this.noRadio) {
-        this.yesRadio.element.checked = false;
-        this.noRadio.element.checked = false;
-      } else {
-        console.error("[SYNACT] Attempted to uncheck radios for an element that has no radios");
-      }
-    }
-
-    /**
-     * Creates a validation instance for the field.
-     * @method createValidation
-     * @param {Function} evaluationFunction - The function used to evaluate the field.
-     * @param {string} fieldDisplayName - The field name to display in error if validation fails.
-     */
-    /******/
-  }, {
-    key: "createValidation",
-    value: function createValidation(evaluationFunction, fieldDisplayName) {
-      new FieldValidation(this.id, "'".concat(fieldDisplayName, "'"), evaluationFunction);
-    }
-
-    /**
-     * Adds a tooltip with specified text to the label associated with the HTML element.
-     * @method addLabelTooltip
-     * @param {string} text - The text to display in the tooltip.
-     */
-    /******/
   }, {
     key: "addLabelTooltip",
     value: function addLabelTooltip(text) {
       this.appendToLabel(CreateInfoEl(text));
     }
-
-    /******/
   }, {
     key: "addToolTip",
     value: function addToolTip(text) {
       this.append(CreateInfoEl(text));
     }
-
-    /**
-     * Sets the inner HTML content of the HTML element.
-     * @method setTextContent
-     * @param {string} text - The text to set as the inner HTML of the element.
-     */
-    /******/
   }, {
     key: "setTextContent",
     value: function setTextContent(text) {
       this.element.innerHTML = text;
     }
-
-    /**
-     *
-     * @param {boolean} shouldShow shows or hides the target
-     * if = true => show, if = false => hide
-     */
   }, {
-    key: "toggleVisibility",
-    value: function toggleVisibility(shouldShow) {
-      shouldShow ? this.show() : this.hide();
+    key: "uncheckRadios",
+    value: function uncheckRadios() {
+      if (this.yesRadio && this.noRadio) {
+        this.yesRadio.element.checked = false;
+        this.noRadio.element.checked = false;
+      } else {
+        console.error("[SYNACT] Attempted to uncheck radios for an element that has no radios");
+      }
     }
-
-    /**
-     *
-     * @param {Function} condition A Function that return a boolean value to set the
-     *  visibility of the targeted element. if condition() returns true, element is shown.
-     *  If false, element is hidden
-     * @param {DOMNodeReference} triggerNode The DOMNodeReference to which an
-     * event listener will be registered to change the visibility state of the calling
-     * DOMNodeReference
-     */
-    /******/
   }, {
     key: "configureConditionalRendering",
-    value: function configureConditionalRendering(condition, triggerNode) {
+    value: function configureConditionalRendering(condition, triggerNodes) {
+      var _this = this;
+      try {
+        this.toggleVisibility(condition());
+        if (triggerNodes) {
+          var nodes = Array.isArray(triggerNodes) ? triggerNodes : [triggerNodes];
+          nodes.forEach(function (node) {
+            node.on("change", function () {
+              return _this.toggleVisibility(condition());
+            });
+            var observer = new MutationObserver(function () {
+              var display = window.getComputedStyle(node.visibilityController).display;
+              _this.toggleVisibility(display !== "none" && condition());
+            });
+            observer.observe(node.visibilityController, {
+              attributes: true,
+              attributeFilter: ["style"]
+            });
+          });
+        }
+      } catch (e) {
+        throw new ConditionalRenderingError(this, e);
+      }
+    }
+  }, {
+    key: "configureValidationAndRequirements",
+    value: function configureValidationAndRequirements(_ref, fieldDisplayName) {
       var _this2 = this;
-      this.toggleVisibility(condition());
-      if (triggerNode) {
-        triggerNode.addChangeListener(function () {
-          _this2.toggleVisibility(condition());
-        });
-        var observer = new MutationObserver(function () {
-          var display = window.getComputedStyle(triggerNode.visibilityController).display;
-          _this2.toggleVisibility(display !== "none" && condition());
-        });
-        observer.observe(triggerNode.visibilityController, {
-          attributes: true,
-          attributeFilter: ["style"]
+      var requirementLogic = _ref.requirementLogic,
+        validationLogic = _ref.validationLogic;
+      var dependencies = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+      if (typeof Page_Validators !== "undefined") {
+        var newValidator = document.createElement("span");
+        newValidator.style.display = "none";
+        newValidator.id = "".concat(this.id, "Validator");
+        newValidator.controltovalidate = this.id;
+        newValidator.errormessage = "<a href='#".concat(this.element.id, "_label'>").concat(fieldDisplayName, " is a required field</a>");
+        newValidator.evaluationfunction = validationLogic.bind(this);
+        //eslint-disable-next-line
+        Page_Validators.push(newValidator);
+      } else {
+        throw new Error("Attempted to add to Validator where Page_Validators do not exist");
+      }
+      this.setRequiredLevel(requirementLogic(this));
+      if (!dependencies) return;
+      dependencies = Array.isArray(dependencies) ? dependencies : [dependencies];
+      dependencies.forEach(function (dep) {
+        dep.element.addEventListener("change", function () {
+          return _this2.setRequiredLevel(requirementLogic(_this2));
         });
+      });
+    }
+  }, {
+    key: "setRequiredLevel",
+    value: function setRequiredLevel(isRequired) {
+      if (isRequired) {
+        this.getLabel().classList.add("required-field");
+      } else {
+        this.getLabel().classList.remove("required-field");
       }
     }
-
-    /**
-     * Executes a callback function once the element is fully loaded.
-     * If the element is already loaded, the callback is called immediately.
-     * Otherwise, a MutationObserver is used to detect when the element is added to the DOM.
-     * @method onceLoaded
-     * @param {Function} callback - A callback function to execute once the element is loaded.
-     */
-    /******/
   }, {
     key: "onceLoaded",
     value: function onceLoaded(callback) {
@@ -1111,21 +1140,21 @@ function createDOMNodeReference(_x) {
  * @returns {Promise<DOMNodeReference[]>} A promise that resolves to an array of Proxies of initialized DOMNodeReference instances.
  */
 function _createDOMNodeReference() {
-  _createDOMNodeReference = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2(target) {
+  _createDOMNodeReference = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee3(target) {
     var instance;
-    return _regeneratorRuntime().wrap(function _callee2$(_context2) {
-      while (1) switch (_context2.prev = _context2.next) {
+    return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+      while (1) switch (_context3.prev = _context3.next) {
         case 0:
-          _context2.prev = 0;
+          _context3.prev = 0;
           instance = new DOMNodeReference(target);
-          _context2.next = 4;
-          return instance.init();
+          _context3.next = 4;
+          return instance._init();
         case 4:
-          return _context2.abrupt("return", new Proxy(instance, {
+          return _context3.abrupt("return", new Proxy(instance, {
             get: function get(target, prop) {
               // do not proxy the initialization method
               // init() is only needed in this factory function
-              if (prop == "init") return undefined;
+              if (prop.toString().startsWith("_")) return undefined;
 
               // proxy the class to wrap all methods in the 'onceLoaded' method, to make sure the
               // element is always available before executing method
@@ -1144,15 +1173,15 @@ function _createDOMNodeReference() {
             }
           }));
         case 7:
-          _context2.prev = 7;
-          _context2.t0 = _context2["catch"](0);
-          console.error("There was an error creating a DOMNodeReference: ".concat(_context2.t0));
-          throw new Error(_context2.t0);
+          _context3.prev = 7;
+          _context3.t0 = _context3["catch"](0);
+          console.error("There was an error creating a DOMNodeReference: ".concat(_context3.t0));
+          throw new Error(_context3.t0);
         case 11:
         case "end":
-          return _context2.stop();
+          return _context3.stop();
       }
-    }, _callee2, null, [[0, 7]]);
+    }, _callee3, null, [[0, 7]]);
   }));
   return _createDOMNodeReference.apply(this, arguments);
 }
@@ -1160,19 +1189,19 @@ function createMultipleDOMNodeReferences(_x2) {
   return _createMultipleDOMNodeReferences.apply(this, arguments);
 }
 function _createMultipleDOMNodeReferences() {
-  _createMultipleDOMNodeReferences = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee3(querySelector) {
+  _createMultipleDOMNodeReferences = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee4(querySelector) {
     var elements;
-    return _regeneratorRuntime().wrap(function _callee3$(_context3) {
-      while (1) switch (_context3.prev = _context3.next) {
+    return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
         case 0:
-          _context3.prev = 0;
+          _context4.prev = 0;
           elements = Array.from(document.querySelectorAll(querySelector));
-          _context3.next = 4;
+          _context4.next = 4;
           return Promise.all(elements.map(function (element) {
             return createDOMNodeReference(element);
           }));
         case 4:
-          elements = _context3.sent;
+          elements = _context4.sent;
           elements.hideAll = function () {
             return elements.forEach(function (instance) {
               return instance.hide();
@@ -1183,17 +1212,17 @@ function _createMultipleDOMNodeReferences() {
               return instance.show();
             });
           };
-          return _context3.abrupt("return", elements);
+          return _context4.abrupt("return", elements);
         case 10:
-          _context3.prev = 10;
-          _context3.t0 = _context3["catch"](0);
-          console.error("There was an error creating multiple DOMNodeReferences: ".concat(_context3.t0));
-          throw new Error(_context3.t0);
+          _context4.prev = 10;
+          _context4.t0 = _context4["catch"](0);
+          console.error("There was an error creating multiple DOMNodeReferences: ".concat(_context4.t0));
+          throw new Error(_context4.t0);
         case 14:
         case "end":
-          return _context3.stop();
+          return _context4.stop();
       }
-    }, _callee3, null, [[0, 10]]);
+    }, _callee4, null, [[0, 10]]);
   }));
   return _createMultipleDOMNodeReferences.apply(this, arguments);
 }

package/index.d.ts

@@ -9,11 +9,37 @@ class DOMNodeReference {
   constructor(target: string): DOMNodeReference;
 
   target: string;
+  /**
+   * The element targeted when instantiating DOMNodeReference.
+   * Made available in order to perform normal DOM traversal,
+   * or access properties not available through this class.
+   * @type {HTMLElement | null}
+   */
   element: HTMLElement | null;
   isLoaded: boolean;
   visibilityController: HTMLElement | null;
   defaultDisplay: string;
+  /**
+   * The value of the element that this node represents
+   * stays in syncs with the live DOM elements via event handler
+   * @type {string | null}
+   */
   value: string | null;
+  /**
+   * Represents the 'yes' option of a boolean radio field.
+   * This property is only available when the parent node
+   * is a main field for a boolean radio input.
+   * @type {DOMNodeReference | undefined}
+   */
+  yesRadio?: DOMNodeReference;
+
+  /**
+   * Represents the 'no' option of a boolean radio field.
+   * This property is only available when the parent node
+   * is a main field for a boolean radio input.
+   * @type {DOMNodeReference | undefined}
+   */
+  noRadio?: DOMNodeReference;
 
   /**
    * Initializes the DOMNodeReference instance by waiting for the element to be available in the DOM.
@@ -34,16 +60,40 @@ class DOMNodeReference {
 
   /**
    * Sets the value of the HTML element.
-   * @param {string} value - The value to set for the HTML element.
+   * @param {() => any} value - The value to set for the HTML element.
+   * for parents of boolean radios, pass true or false as value, or
+   * an expression returning a boolean
    */
   setValue(value: string): void;
 
+  /**
+   * Disables the element so that users cannot input any data
+   */
+  disable(): void;
+
+  /**
+   * Enables the element so that users can input data
+   */
+  enable(): void;
+
+  /**
+   * Prepends elements to the target
+   * @param {...HTMLElement} elements - The elements to prepend to the HTML element
+   */
+  prepend(...elements: HTMLElement[]): void;
+
   /**
    * Appends child elements to the HTML element.
    * @param {...HTMLElement} elements - The elements to append to the HTML element.
    */
   append(...elements: HTMLElement[]): void;
 
+  /**
+   * Inserts elements before the HTML element.
+   * @param {...HTMLElement} elements - The elements to insert before the HTML element.
+   */
+  before(...elements: HTMLElement[]): void;
+
   /**
    * Inserts elements after the HTML element.
    * @param {...HTMLElement} elements - The elements to insert after the HTML element.
@@ -52,9 +102,10 @@ class DOMNodeReference {
 
   /**
    * Retrieves the label associated with the HTML element.
-   * @returns {HTMLElement} The label element associated with this element, or **null** if no label element is present
+   * @returns {HTMLElement} The label element associated with this element.
+   * @throws {Error} Throws an error if the label cannot be found.
    */
-  getLabel(): HTMLElement | null;
+  getLabel(): HTMLElement;
 
   /**
    * Appends child elements to the label associated with the HTML element.
@@ -63,33 +114,44 @@ class DOMNodeReference {
   appendToLabel(...elements: HTMLElement[]): void;
 
   /**
-   * Adds a click event listener to the HTML element.
-   * @param {Function} eventHandler - The function to execute when the element is clicked.
-   */
-  addClickListener(eventHandler: () => void): void;
-
-  /**
-   * Adds a change event listener to the HTML element.
-   * @param {Function} eventHandler - The function to execute when the element's value changes.
+   * Sets up an event listener based on the specified event type, executing the specified
+   * event handler
+   * @param {string} eventType - The DOM event to watch for
+   * @param {(this: DOMNodeReference, e: Event) => void} eventHandler - The callback function that runs when the
+   * specified event occurs
    */
-  addChangeListener(eventHandler: () => void): void;
-
+  on(eventType: string, eventHandler: (event: Event) => void): void;
   /**
    * Unchecks both the yes and no radio buttons if they exist.
    */
   uncheckRadios(): void;
 
   /**
-   * Creates a validation instance for the field.
-   * @param {Function} evaluationFunction - The function used to evaluate the field.
-   * @param {string} fieldDisplayName - The field name to display in error if validation
-   * fails.
+   * Configures validation and requirement conditions for the field based on the provided logic functions and dependencies.
+   * Creates a validator and sets a required level dynamically based on dependency changes.
+   * @param {Object} config An object containing the requirement and validation logical functions
+   * @param {(this: DOMNodeReference) => boolean} config.requirementLogic - Function to determine if the field is required.
+   * @param {(this: DOMNodeReference) => boolean} config.validationLogic - Function to evaluate the field's validity.
+   * @param {string} fieldDisplayName - Display name used in error messages if validation fails.
+   * @param {Array<DOMNodeReference>} [dependencies] - Optional dependencies for setting requirement conditions dynamically.
    */
-  createValidation(
-    evaluationFunction: (value: any) => boolean,
-    fieldDisplayName: string
+  configureValidationAndRequirements(
+    config: {
+      requirementLogic: (this: this) => boolean;
+      validationLogic: (this: this) => boolean;
+    },
+    fieldDisplayName: string,
+    dependencies?: DOMNodeReference[]
   ): void;
 
+  /**
+   * Sets the required level for the field by adding or removing the "required-field" class on the label.
+   *
+   * @param {boolean} isRequired - Determines whether the field should be marked as required.
+   * If true, the "required-field" class is added to the label; if false, it is removed.
+   */
+  setRequiredLevel(isRequired: boolean): void;
+
   /**
    * Adds a tooltip with specified text to the label associated with the HTML element.
    * @param {string} text - The text to display in the tooltip.
@@ -110,17 +172,19 @@ class DOMNodeReference {
   toggleVisibility(shouldShow: boolean): void;
 
   /**
+   * Configures conditional rendering for the target element based on a condition
+   * and the visibility of one or more trigger elements.
    *
-   * @param {Function} condition A Function that return a boolean value to set the
-   *  visibility of the targeted element. if condition() returns true, element is shown.
-   *  If false, element is hidden
-   * @param {DOMNodeReference} triggerNode The DOMNodeReference to which an
-   * event listener will be registered to change the visibility state of the calling
-   * DOMNodeReference
+   * @param {Function} condition - A function that returns a boolean to determine
+   * the visibility of the target element. If `condition()` returns true, the element is shown;
+   * otherwise, it is hidden.
+   * @param {DOMNodeReference | DOMNodeReference[]} triggerNodes - A single `DOMNodeReference`
+   * or an array of `DOMNodeReference` instances. Event listeners are registered on each
+   * `triggerNode` to toggle the visibility of the target element based on the `condition`.
    */
   configureConditionalRendering(
     condition: () => boolean,
-    triggerNode: DOMNodeReference
+    triggerNodes?: DOMNodeReference | DOMNodeReference[]
   ): void;
 
   /**

package/package.json

@@ -1,61 +1,61 @@
-{
-  "name": "powerpagestoolkit",
-  "version": "1.3.102",
-  "description": "Reference, manipulate, and engage with Power Pages sites through the nodes in the DOM; use a variety of custom methods that allow customizing your power pages site quicker and easier.  ",
-  "main": "./dist/index.bundle.js",
-  "types": "index.d.ts",
-  "scripts": {
-    "build": "webpack",
-    "lint": "eslint ./src/JS/*"
-  },
-  "devDependencies": {
-    "@babel/core": "^7.25.8",
-    "@babel/node": "^7.26.0",
-    "@babel/preset-env": "^7.25.8",
-    "@types/node": "^22.8.0",
-    "babel-loader": "^9.2.1",
-    "clean-webpack-plugin": "^4.0.0",
-    "css-loader": "^7.1.2",
-    "eslint": "^8.57.1",
-    "eslint-plugin-import": "^2.31.0",
-    "style-loader": "^4.0.0",
-    "terser-webpack-plugin": "^5.3.4",
-    "typescript": "^5.6.3",
-    "webpack": "^5.95.0",
-    "webpack-cli": "^5.1.4"
-  },
-  "author": "KeatonBrewster",
-  "license": "SSPL-1.0",
-  "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Keaton-Brewster/PowerPagesToolKit"
-  },
-  "keywords": [
-    "powerpages",
-    "power pages",
-    "power platform",
-    "dynamics 365",
-    "power apps portal",
-    "dynamics 365 portal",
-    "portal",
-    "portal management",
-    "api",
-    "javascript",
-    "ajax",
-    "dataverse",
-    "dom-manipulation",
-    "node",
-    "http-request",
-    "json",
-    "rest-api",
-    "ajax-wrapper",
-    "form-management",
-    "frontend",
-    "web-development"
-  ],
-  "files": [
-    "dist",
-    "index.d.ts"
-  ]
-}
+{
+  "name": "powerpagestoolkit",
+  "version": "1.3.104",
+  "description": "Reference, manipulate, and engage with Power Pages sites through the nodes in the DOM; use a variety of custom methods that allow customizing your power pages site quicker and easier.  ",
+  "main": "./dist/index.bundle.js",
+  "types": "index.d.ts",
+  "scripts": {
+    "build": "webpack",
+    "lint": "eslint ./src/JS/*"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.25.8",
+    "@babel/node": "^7.26.0",
+    "@babel/preset-env": "^7.25.8",
+    "@types/node": "^22.8.0",
+    "babel-loader": "^9.2.1",
+    "clean-webpack-plugin": "^4.0.0",
+    "css-loader": "^7.1.2",
+    "eslint": "^8.57.1",
+    "eslint-plugin-import": "^2.31.0",
+    "style-loader": "^4.0.0",
+    "terser-webpack-plugin": "^5.3.4",
+    "typescript": "^5.6.3",
+    "webpack": "^5.95.0",
+    "webpack-cli": "^5.1.4"
+  },
+  "author": "KeatonBrewster",
+  "license": "SSPL-1.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Keaton-Brewster/PowerPagesToolKit"
+  },
+  "keywords": [
+    "powerpages",
+    "power pages",
+    "power platform",
+    "dynamics 365",
+    "power apps portal",
+    "dynamics 365 portal",
+    "portal",
+    "portal management",
+    "api",
+    "javascript",
+    "ajax",
+    "dataverse",
+    "dom-manipulation",
+    "node",
+    "http-request",
+    "json",
+    "rest-api",
+    "ajax-wrapper",
+    "form-management",
+    "frontend",
+    "web-development"
+  ],
+  "files": [
+    "dist",
+    "index.d.ts"
+  ]
+}