handsontable 0.0.0-next-010265d-20231005 → 0.0.0-next-9379dd1-20231020

package/helpers/dom/element.js

@@ -36,23 +36,30 @@ exports.isChildOf = isChildOf;
 exports.isDetached = isDetached;
 exports.isInput = isInput;
 exports.isOutsideInput = isOutsideInput;
+exports.isThisHotChild = isThisHotChild;
 exports.isVisible = isVisible;
+exports.makeElementContentEditableAndSelectItsContent = makeElementContentEditableAndSelectItsContent;
 exports.matchesCSSRules = matchesCSSRules;
 exports.observeVisibilityChangeOnce = observeVisibilityChangeOnce;
 exports.offset = offset;
 exports.outerHeight = outerHeight;
 exports.outerWidth = outerWidth;
 exports.overlayContainsElement = overlayContainsElement;
+exports.removeAttribute = removeAttribute;
 exports.removeClass = removeClass;
+exports.removeContentEditableFromElementAndDeselect = removeContentEditableFromElementAndDeselect;
 exports.removeEvent = removeEvent;
 exports.removeTextNodes = removeTextNodes;
 exports.resetCssTransform = resetCssTransform;
+exports.runWithSelectedContendEditableElement = runWithSelectedContendEditableElement;
 exports.selectElementIfAllowed = selectElementIfAllowed;
+exports.setAttribute = setAttribute;
 exports.setCaretPosition = setCaretPosition;
 exports.setOverlayPosition = setOverlayPosition;
 require("core-js/modules/es.array.push.js");
 require("core-js/modules/es.error.cause.js");
 var _string = require("../string");
+var _a11y = require("../a11y");
 /**
  * Get the parent of the specified node in the DOM tree.
  *
@@ -80,6 +87,18 @@ function getParent(element) {
   return parent;
 }
 
+/**
+ * Check if the provided element is a child of the provided Handsontable container.
+ *
+ * @param {HTMLElement} element Element to be analyzed.
+ * @param {HTMLElement} thisHotContainer The Handsontable container.
+ * @returns {boolean}
+ */
+function isThisHotChild(element, thisHotContainer) {
+  const closestHandsontableContainer = element.closest('.handsontable');
+  return !!closestHandsontableContainer && (closestHandsontableContainer.parentNode === thisHotContainer || closestHandsontableContainer === thisHotContainer);
+}
+
 /**
  * Gets `frameElement` of the specified frame. Returns null if it is a top frame or if script has no access to read property.
  *
@@ -93,7 +112,7 @@ function getFrameElement(frame) {
 /**
  * Gets parent frame of the specified frame. Returns null if it is a top frame or if script has no access to read property.
  *
- * @param {Window} frame Frame from which should be get frameElement in safe way.
+ * @param {Window} frame Frame from which should get frameElement in a safe way.
  * @returns {Window|null}
  */
 function getParentWindow(frame) {
@@ -103,7 +122,7 @@ function getParentWindow(frame) {
 /**
  * Checks if script has access to read from parent frame of specified frame.
  *
- * @param {Window} frame Frame from which should be get frameElement in safe way.
+ * @param {Window} frame Frame from which should get frameElement in a safe way.
  * @returns {boolean}
  */
 function hasAccessToParentWindow(frame) {
@@ -238,7 +257,7 @@ function overlayContainsElement(overlayType, element, root) {
 }
 
 /**
- * @param {string} classNames The element "class" attribute string.
+ * @param {string[]} classNames The element "class" attribute string.
  * @returns {string[]}
  */
 function filterEmptyClassNames(classNames) {
@@ -248,6 +267,35 @@ function filterEmptyClassNames(classNames) {
   return classNames.filter(x => !!x);
 }
 
+/**
+ * Filter out the RegExp entries from an array.
+ *
+ * @param {(string|RegExp)[]} list Array of either strings, Regexes or a mix of both.
+ * @param {boolean} [returnBoth] If `true`, both the array without regexes and an array of regexes will be returned.
+ * @returns {string[]|{regexFree: string[], regexes: RegExp[]}}
+ */
+function filterRegexes(list, returnBoth) {
+  if (!list || !list.length) {
+    return returnBoth ? {
+      regexFree: [],
+      regexes: []
+    } : [];
+  }
+  const regexes = [];
+  const regexFree = [];
+  regexFree.push(...list.filter(entry => {
+    const isRegex = entry instanceof RegExp;
+    if (isRegex && returnBoth) {
+      regexes.push(entry);
+    }
+    return !isRegex;
+  }));
+  return returnBoth ? {
+    regexFree,
+    regexes
+  } : regexFree;
+}
+
 /**
  * Checks if element has class name.
  *
@@ -282,16 +330,86 @@ function addClass(element, className) {
  * Remove class name from an element.
  *
  * @param {HTMLElement} element An element to process.
- * @param {string|Array} className Class name as string or array of strings.
+ * @param {string|Array<string|RegExp>} className Class name as string or array of strings.
  */
 function removeClass(element, className) {
   if (typeof className === 'string') {
     className = className.split(' ');
+  } else if (className instanceof RegExp) {
+    className = [className];
   }
-  className = filterEmptyClassNames(className);
-  if (className.length > 0) {
-    element.classList.remove(...className);
+  let {
+    regexFree: stringClasses,
+    // eslint-disable-next-line prefer-const
+    regexes: regexClasses
+  } = filterRegexes(className, true);
+  stringClasses = filterEmptyClassNames(stringClasses);
+  if (stringClasses.length > 0) {
+    element.classList.remove(...stringClasses);
+  }
+  regexClasses.forEach(regexClassName => {
+    element.classList.forEach(currentClassName => {
+      if (regexClassName.test(currentClassName)) {
+        element.classList.remove(currentClassName);
+      }
+    });
+  });
+}
+
+/**
+ * Set a single attribute or multiple attributes at once.
+ *
+ * @param {HTMLElement} domElement The HTML element to be modified.
+ * @param {Array[]|string} attributes If setting multiple attributes at once, `attributes` holds an array containing the
+ * attributes to be added. Each element of the array should be an array in a form of `[attributeName,
+ * attributeValue]`. If setting a single attribute, `attributes` holds the name of the attribute.
+ * @param {string|number|undefined} [attributeValue] If setting a single attribute, `attributeValue` holds the attribute
+ * value.
+ */
+function setAttribute(domElement) {
+  let attributes = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+  let attributeValue = arguments.length > 2 ? arguments[2] : undefined;
+  if (!Array.isArray(attributes)) {
+    attributes = [[attributes, attributeValue]];
+  }
+  attributes.forEach(attributeInfo => {
+    if (Array.isArray(attributeInfo) && attributeInfo[0] !== '') {
+      domElement.setAttribute(...attributeInfo);
+    }
+  });
+}
+
+/**
+ * Remove a single attribute or multiple attributes from the provided element at once.
+ *
+ * @param {HTMLElement} domElement The HTML element to be processed.
+ * @param {Array<string|RegExp>|string} attributesToRemove If removing multiple attributes, `attributesToRemove`
+ * holds an array of attribute names to be removed from the provided element. If removing a single attribute, it
+ * holds the attribute name.
+ */
+function removeAttribute(domElement) {
+  let attributesToRemove = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+  if (typeof attributesToRemove === 'string') {
+    attributesToRemove = attributesToRemove.split(' ');
+  } else if (attributesToRemove instanceof RegExp) {
+    attributesToRemove = [attributesToRemove];
   }
+  const {
+    regexFree: stringAttributes,
+    regexes: regexAttributes
+  } = filterRegexes(attributesToRemove, true);
+  stringAttributes.forEach(attributeNameToRemove => {
+    if (attributeNameToRemove !== '') {
+      domElement.removeAttribute(attributeNameToRemove);
+    }
+  });
+  regexAttributes.forEach(attributeRegex => {
+    domElement.getAttributeNames().forEach(attributeName => {
+      if (attributeRegex.test(attributeName)) {
+        domElement.removeAttribute(attributeName);
+      }
+    });
+  });
 }
 
 /**
@@ -309,7 +427,7 @@ function removeTextNodes(element) {
 }
 
 /**
- * Remove childs function
+ * Remove children function
  * WARNING - this doesn't unload events and data attached by jQuery
  * http://jsperf.com/jquery-html-vs-empty-vs-innerhtml/9
  * http://jsperf.com/jquery-html-vs-empty-vs-innerhtml/11 - no siginificant improvement with Chrome remove() method.
@@ -327,7 +445,7 @@ function empty(element) {
 const HTML_CHARACTERS = /(<(.*)>|&(.*);)/;
 
 /**
- * Insert content into element trying avoid innerHTML method.
+ * Insert content into element trying to avoid innerHTML method.
  *
  * @param {HTMLElement} element An element to write into.
  * @param {string} content The text to write.
@@ -957,4 +1075,65 @@ function observeVisibilityChangeOnce(elementToBeObserved, callback) {
     root: elementToBeObserved.ownerDocument.body
   });
   visibilityObserver.observe(elementToBeObserved);
+}
+
+/**
+ * Add a `contenteditable` attribute, select the contents and optionally add the `invisibleSelection`
+ * class to the provided element.
+ *
+ * @param {HTMLElement} element Element to be processed.
+ * @param {boolean} [invisibleSelection=true] `true` if the class should be added to the element.
+ * @param {boolean} [ariaHidden=true] `true` if the `aria-hidden` attribute should be added to the processed element.
+ */
+function makeElementContentEditableAndSelectItsContent(element) {
+  let invisibleSelection = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+  let ariaHidden = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+  const ownerDocument = element.ownerDocument;
+  const range = ownerDocument.createRange();
+  const sel = ownerDocument.defaultView.getSelection();
+  setAttribute(element, 'contenteditable', true);
+  if (ariaHidden) {
+    setAttribute(element, ...(0, _a11y.A11Y_HIDDEN)());
+  }
+  if (invisibleSelection) {
+    addClass(element, 'invisibleSelection');
+  }
+  range.selectNodeContents(element);
+  sel.removeAllRanges();
+  sel.addRange(range);
+}
+
+/**
+ * Remove the `contenteditable` attribute, deselect the contents and optionally remove the `invisibleSelection`
+ * class from the provided element.
+ *
+ * @param {HTMLElement} selectedElement The element to be deselected.
+ * @param {boolean} [removeInvisibleSelectionClass=true] `true` if the class should be removed from the element.
+ */
+function removeContentEditableFromElementAndDeselect(selectedElement) {
+  let removeInvisibleSelectionClass = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+  const sel = selectedElement.ownerDocument.defaultView.getSelection();
+  if (selectedElement.hasAttribute('aria-hidden')) {
+    selectedElement.removeAttribute('aria-hidden');
+  }
+  sel.removeAllRanges();
+  if (removeInvisibleSelectionClass) {
+    removeClass(selectedElement, 'invisibleSelection');
+  }
+  selectedElement.removeAttribute('contenteditable');
+}
+
+/**
+ * Run the provided callback while the provided element is selected and modified to have the `contenteditable`
+ * attribute added. Optionally, the selection can be configured to be invisible.
+ *
+ * @param {HTMLElement} element Element to be selected.
+ * @param {Function} callback Callback to be called.
+ * @param {boolean} [invisibleSelection=true] `true` if the selection should be invisible.
+ */
+function runWithSelectedContendEditableElement(element, callback) {
+  let invisibleSelection = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+  makeElementContentEditableAndSelectItsContent(element, invisibleSelection);
+  callback();
+  removeContentEditableFromElementAndDeselect(element, invisibleSelection);
 }

package/helpers/dom/element.mjs

@@ -1,6 +1,7 @@
 import "core-js/modules/es.array.push.js";
 import "core-js/modules/es.error.cause.js";
 import { sanitize } from "../string.mjs";
+import { A11Y_HIDDEN } from "../a11y.mjs";
 /**
  * Get the parent of the specified node in the DOM tree.
  *
@@ -28,6 +29,18 @@ export function getParent(element) {
   return parent;
 }
 
+/**
+ * Check if the provided element is a child of the provided Handsontable container.
+ *
+ * @param {HTMLElement} element Element to be analyzed.
+ * @param {HTMLElement} thisHotContainer The Handsontable container.
+ * @returns {boolean}
+ */
+export function isThisHotChild(element, thisHotContainer) {
+  const closestHandsontableContainer = element.closest('.handsontable');
+  return !!closestHandsontableContainer && (closestHandsontableContainer.parentNode === thisHotContainer || closestHandsontableContainer === thisHotContainer);
+}
+
 /**
  * Gets `frameElement` of the specified frame. Returns null if it is a top frame or if script has no access to read property.
  *
@@ -41,7 +54,7 @@ export function getFrameElement(frame) {
 /**
  * Gets parent frame of the specified frame. Returns null if it is a top frame or if script has no access to read property.
  *
- * @param {Window} frame Frame from which should be get frameElement in safe way.
+ * @param {Window} frame Frame from which should get frameElement in a safe way.
  * @returns {Window|null}
  */
 export function getParentWindow(frame) {
@@ -51,7 +64,7 @@ export function getParentWindow(frame) {
 /**
  * Checks if script has access to read from parent frame of specified frame.
  *
- * @param {Window} frame Frame from which should be get frameElement in safe way.
+ * @param {Window} frame Frame from which should get frameElement in a safe way.
  * @returns {boolean}
  */
 export function hasAccessToParentWindow(frame) {
@@ -186,7 +199,7 @@ export function overlayContainsElement(overlayType, element, root) {
 }
 
 /**
- * @param {string} classNames The element "class" attribute string.
+ * @param {string[]} classNames The element "class" attribute string.
  * @returns {string[]}
  */
 function filterEmptyClassNames(classNames) {
@@ -196,6 +209,35 @@ function filterEmptyClassNames(classNames) {
   return classNames.filter(x => !!x);
 }
 
+/**
+ * Filter out the RegExp entries from an array.
+ *
+ * @param {(string|RegExp)[]} list Array of either strings, Regexes or a mix of both.
+ * @param {boolean} [returnBoth] If `true`, both the array without regexes and an array of regexes will be returned.
+ * @returns {string[]|{regexFree: string[], regexes: RegExp[]}}
+ */
+function filterRegexes(list, returnBoth) {
+  if (!list || !list.length) {
+    return returnBoth ? {
+      regexFree: [],
+      regexes: []
+    } : [];
+  }
+  const regexes = [];
+  const regexFree = [];
+  regexFree.push(...list.filter(entry => {
+    const isRegex = entry instanceof RegExp;
+    if (isRegex && returnBoth) {
+      regexes.push(entry);
+    }
+    return !isRegex;
+  }));
+  return returnBoth ? {
+    regexFree,
+    regexes
+  } : regexFree;
+}
+
 /**
  * Checks if element has class name.
  *
@@ -230,16 +272,86 @@ export function addClass(element, className) {
  * Remove class name from an element.
  *
  * @param {HTMLElement} element An element to process.
- * @param {string|Array} className Class name as string or array of strings.
+ * @param {string|Array<string|RegExp>} className Class name as string or array of strings.
  */
 export function removeClass(element, className) {
   if (typeof className === 'string') {
     className = className.split(' ');
+  } else if (className instanceof RegExp) {
+    className = [className];
   }
-  className = filterEmptyClassNames(className);
-  if (className.length > 0) {
-    element.classList.remove(...className);
+  let {
+    regexFree: stringClasses,
+    // eslint-disable-next-line prefer-const
+    regexes: regexClasses
+  } = filterRegexes(className, true);
+  stringClasses = filterEmptyClassNames(stringClasses);
+  if (stringClasses.length > 0) {
+    element.classList.remove(...stringClasses);
+  }
+  regexClasses.forEach(regexClassName => {
+    element.classList.forEach(currentClassName => {
+      if (regexClassName.test(currentClassName)) {
+        element.classList.remove(currentClassName);
+      }
+    });
+  });
+}
+
+/**
+ * Set a single attribute or multiple attributes at once.
+ *
+ * @param {HTMLElement} domElement The HTML element to be modified.
+ * @param {Array[]|string} attributes If setting multiple attributes at once, `attributes` holds an array containing the
+ * attributes to be added. Each element of the array should be an array in a form of `[attributeName,
+ * attributeValue]`. If setting a single attribute, `attributes` holds the name of the attribute.
+ * @param {string|number|undefined} [attributeValue] If setting a single attribute, `attributeValue` holds the attribute
+ * value.
+ */
+export function setAttribute(domElement) {
+  let attributes = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+  let attributeValue = arguments.length > 2 ? arguments[2] : undefined;
+  if (!Array.isArray(attributes)) {
+    attributes = [[attributes, attributeValue]];
+  }
+  attributes.forEach(attributeInfo => {
+    if (Array.isArray(attributeInfo) && attributeInfo[0] !== '') {
+      domElement.setAttribute(...attributeInfo);
+    }
+  });
+}
+
+/**
+ * Remove a single attribute or multiple attributes from the provided element at once.
+ *
+ * @param {HTMLElement} domElement The HTML element to be processed.
+ * @param {Array<string|RegExp>|string} attributesToRemove If removing multiple attributes, `attributesToRemove`
+ * holds an array of attribute names to be removed from the provided element. If removing a single attribute, it
+ * holds the attribute name.
+ */
+export function removeAttribute(domElement) {
+  let attributesToRemove = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+  if (typeof attributesToRemove === 'string') {
+    attributesToRemove = attributesToRemove.split(' ');
+  } else if (attributesToRemove instanceof RegExp) {
+    attributesToRemove = [attributesToRemove];
   }
+  const {
+    regexFree: stringAttributes,
+    regexes: regexAttributes
+  } = filterRegexes(attributesToRemove, true);
+  stringAttributes.forEach(attributeNameToRemove => {
+    if (attributeNameToRemove !== '') {
+      domElement.removeAttribute(attributeNameToRemove);
+    }
+  });
+  regexAttributes.forEach(attributeRegex => {
+    domElement.getAttributeNames().forEach(attributeName => {
+      if (attributeRegex.test(attributeName)) {
+        domElement.removeAttribute(attributeName);
+      }
+    });
+  });
 }
 
 /**
@@ -257,7 +369,7 @@ export function removeTextNodes(element) {
 }
 
 /**
- * Remove childs function
+ * Remove children function
  * WARNING - this doesn't unload events and data attached by jQuery
  * http://jsperf.com/jquery-html-vs-empty-vs-innerhtml/9
  * http://jsperf.com/jquery-html-vs-empty-vs-innerhtml/11 - no siginificant improvement with Chrome remove() method.
@@ -275,7 +387,7 @@ export function empty(element) {
 export const HTML_CHARACTERS = /(<(.*)>|&(.*);)/;
 
 /**
- * Insert content into element trying avoid innerHTML method.
+ * Insert content into element trying to avoid innerHTML method.
  *
  * @param {HTMLElement} element An element to write into.
  * @param {string} content The text to write.
@@ -904,4 +1016,65 @@ export function observeVisibilityChangeOnce(elementToBeObserved, callback) {
     root: elementToBeObserved.ownerDocument.body
   });
   visibilityObserver.observe(elementToBeObserved);
+}
+
+/**
+ * Add a `contenteditable` attribute, select the contents and optionally add the `invisibleSelection`
+ * class to the provided element.
+ *
+ * @param {HTMLElement} element Element to be processed.
+ * @param {boolean} [invisibleSelection=true] `true` if the class should be added to the element.
+ * @param {boolean} [ariaHidden=true] `true` if the `aria-hidden` attribute should be added to the processed element.
+ */
+export function makeElementContentEditableAndSelectItsContent(element) {
+  let invisibleSelection = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+  let ariaHidden = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+  const ownerDocument = element.ownerDocument;
+  const range = ownerDocument.createRange();
+  const sel = ownerDocument.defaultView.getSelection();
+  setAttribute(element, 'contenteditable', true);
+  if (ariaHidden) {
+    setAttribute(element, ...A11Y_HIDDEN());
+  }
+  if (invisibleSelection) {
+    addClass(element, 'invisibleSelection');
+  }
+  range.selectNodeContents(element);
+  sel.removeAllRanges();
+  sel.addRange(range);
+}
+
+/**
+ * Remove the `contenteditable` attribute, deselect the contents and optionally remove the `invisibleSelection`
+ * class from the provided element.
+ *
+ * @param {HTMLElement} selectedElement The element to be deselected.
+ * @param {boolean} [removeInvisibleSelectionClass=true] `true` if the class should be removed from the element.
+ */
+export function removeContentEditableFromElementAndDeselect(selectedElement) {
+  let removeInvisibleSelectionClass = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+  const sel = selectedElement.ownerDocument.defaultView.getSelection();
+  if (selectedElement.hasAttribute('aria-hidden')) {
+    selectedElement.removeAttribute('aria-hidden');
+  }
+  sel.removeAllRanges();
+  if (removeInvisibleSelectionClass) {
+    removeClass(selectedElement, 'invisibleSelection');
+  }
+  selectedElement.removeAttribute('contenteditable');
+}
+
+/**
+ * Run the provided callback while the provided element is selected and modified to have the `contenteditable`
+ * attribute added. Optionally, the selection can be configured to be invisible.
+ *
+ * @param {HTMLElement} element Element to be selected.
+ * @param {Function} callback Callback to be called.
+ * @param {boolean} [invisibleSelection=true] `true` if the selection should be invisible.
+ */
+export function runWithSelectedContendEditableElement(element, callback) {
+  let invisibleSelection = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+  makeElementContentEditableAndSelectItsContent(element, invisibleSelection);
+  callback();
+  removeContentEditableFromElementAndDeselect(element, invisibleSelection);
 }

package/helpers/mixed.js

@@ -134,7 +134,7 @@ const domMessages = {
 function _injectProductInfo(key, element) {
   const hasValidType = !isEmpty(key);
   const isNonCommercial = typeof key === 'string' && key.toLowerCase() === 'non-commercial-and-evaluation';
-  const hotVersion = "0.0.0-next-010265d-20231005";
+  const hotVersion = "0.0.0-next-9379dd1-20231020";
   let keyValidityDate;
   let consoleMessageState = 'invalid';
   let domMessageState = 'invalid';

package/helpers/mixed.mjs

@@ -124,7 +124,7 @@ const domMessages = {
 export function _injectProductInfo(key, element) {
   const hasValidType = !isEmpty(key);
   const isNonCommercial = typeof key === 'string' && key.toLowerCase() === 'non-commercial-and-evaluation';
-  const hotVersion = "0.0.0-next-010265d-20231005";
+  const hotVersion = "0.0.0-next-9379dd1-20231020";
   let keyValidityDate;
   let consoleMessageState = 'invalid';
   let domMessageState = 'invalid';

package/helpers/number.d.ts

@@ -3,3 +3,4 @@ export function isNumericLike(value: any): boolean;
 export function rangeEach(rangeFrom: number, rangeTo: number, iteratee: (index: number) => void): void;
 export function rangeEachReverse(rangeFrom: number, rangeTo: number, iteratee: (index: number) => void): void;
 export function valueAccordingPercent(value: number, percent: string | number): number;
+export function clamp(value: number, minValue: number, maxValue: number): number;

package/helpers/number.js

@@ -1,6 +1,7 @@
 "use strict";
 
 exports.__esModule = true;
+exports.clamp = clamp;
 exports.isNumeric = isNumeric;
 exports.isNumericLike = isNumericLike;
 exports.rangeEach = rangeEach;
@@ -111,4 +112,21 @@ function valueAccordingPercent(value, percent) {
   percent = parseInt(percent.toString().replace('%', ''), 10);
   percent = isNaN(percent) ? 0 : percent;
   return parseInt(value * percent / 100, 10);
+}
+
+/**
+ * Clamps the value between min and max.
+ *
+ * @param {number} value The base number value.
+ * @param {number} minValue The max number value.
+ * @param {number} maxValue The min number value.
+ * @returns {number}
+ */
+function clamp(value, minValue, maxValue) {
+  if (Math.min(value, minValue) === value) {
+    return minValue;
+  } else if (Math.max(value, maxValue) === value) {
+    return maxValue;
+  }
+  return value;
 }

package/helpers/number.mjs

@@ -103,4 +103,21 @@ export function valueAccordingPercent(value, percent) {
   percent = parseInt(percent.toString().replace('%', ''), 10);
   percent = isNaN(percent) ? 0 : percent;
   return parseInt(value * percent / 100, 10);
+}
+
+/**
+ * Clamps the value between min and max.
+ *
+ * @param {number} value The base number value.
+ * @param {number} minValue The max number value.
+ * @param {number} maxValue The min number value.
+ * @returns {number}
+ */
+export function clamp(value, minValue, maxValue) {
+  if (Math.min(value, minValue) === value) {
+    return minValue;
+  } else if (Math.max(value, maxValue) === value) {
+    return maxValue;
+  }
+  return value;
 }

package/i18n/constants.js

@@ -165,4 +165,10 @@ exports.FILTERS_BUTTONS_PLACEHOLDER_SEARCH = FILTERS_BUTTONS_PLACEHOLDER_SEARCH;
 const FILTERS_BUTTONS_PLACEHOLDER_VALUE = `${FILTERS_NAMESPACE}buttons.placeholder.value`;
 exports.FILTERS_BUTTONS_PLACEHOLDER_VALUE = FILTERS_BUTTONS_PLACEHOLDER_VALUE;
 const FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE = `${FILTERS_NAMESPACE}buttons.placeholder.secondValue`;
-exports.FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE = FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE;
+exports.FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE = FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE;
+const CHECKBOX_RENDERER_NAMESPACE = 'CheckboxRenderer:';
+exports.CHECKBOX_RENDERER_NAMESPACE = CHECKBOX_RENDERER_NAMESPACE;
+const CHECKBOX_CHECKED = `${CHECKBOX_RENDERER_NAMESPACE}checked`;
+exports.CHECKBOX_CHECKED = CHECKBOX_CHECKED;
+const CHECKBOX_UNCHECKED = `${CHECKBOX_RENDERER_NAMESPACE}unchecked`;
+exports.CHECKBOX_UNCHECKED = CHECKBOX_UNCHECKED;

package/i18n/constants.mjs

@@ -83,4 +83,7 @@ export const FILTERS_BUTTONS_OK = `${FILTERS_NAMESPACE}buttons.ok`;
 export const FILTERS_BUTTONS_CANCEL = `${FILTERS_NAMESPACE}buttons.cancel`;
 export const FILTERS_BUTTONS_PLACEHOLDER_SEARCH = `${FILTERS_NAMESPACE}buttons.placeholder.search`;
 export const FILTERS_BUTTONS_PLACEHOLDER_VALUE = `${FILTERS_NAMESPACE}buttons.placeholder.value`;
-export const FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE = `${FILTERS_NAMESPACE}buttons.placeholder.secondValue`;
+export const FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE = `${FILTERS_NAMESPACE}buttons.placeholder.secondValue`;
+export const CHECKBOX_RENDERER_NAMESPACE = 'CheckboxRenderer:';
+export const CHECKBOX_CHECKED = `${CHECKBOX_RENDERER_NAMESPACE}checked`;
+export const CHECKBOX_UNCHECKED = `${CHECKBOX_RENDERER_NAMESPACE}unchecked`;

package/i18n/languages/en-US.js

@@ -89,7 +89,9 @@ const dictionary = {
   [C.FILTERS_BUTTONS_CANCEL]: 'Cancel',
   [C.FILTERS_BUTTONS_PLACEHOLDER_SEARCH]: 'Search',
   [C.FILTERS_BUTTONS_PLACEHOLDER_VALUE]: 'Value',
-  [C.FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE]: 'Second value'
+  [C.FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE]: 'Second value',
+  [C.CHECKBOX_CHECKED]: 'Checked',
+  [C.CHECKBOX_UNCHECKED]: 'Unchecked'
 };
 var _default = dictionary;
 exports.default = _default;

package/i18n/languages/en-US.mjs

@@ -83,6 +83,8 @@ const dictionary = {
   [C.FILTERS_BUTTONS_CANCEL]: 'Cancel',
   [C.FILTERS_BUTTONS_PLACEHOLDER_SEARCH]: 'Search',
   [C.FILTERS_BUTTONS_PLACEHOLDER_VALUE]: 'Value',
-  [C.FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE]: 'Second value'
+  [C.FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE]: 'Second value',
+  [C.CHECKBOX_CHECKED]: 'Checked',
+  [C.CHECKBOX_UNCHECKED]: 'Unchecked'
 };
 export default dictionary;

package/i18n/languages/pl-PL.js

@@ -89,7 +89,9 @@ const dictionary = {
   [C.FILTERS_BUTTONS_CANCEL]: 'Anuluj',
   [C.FILTERS_BUTTONS_PLACEHOLDER_SEARCH]: 'Szukaj',
   [C.FILTERS_BUTTONS_PLACEHOLDER_VALUE]: 'Wartość',
-  [C.FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE]: 'Druga wartość'
+  [C.FILTERS_BUTTONS_PLACEHOLDER_SECOND_VALUE]: 'Druga wartość',
+  [C.CHECKBOX_CHECKED]: 'Zaznaczony',
+  [C.CHECKBOX_UNCHECKED]: 'Odznaczony'
 };
 var _default = dictionary;
 exports.default = _default;