@react-fabric/form 1.0.0-beta.9 → 1.0.1

package/dist/cjs/internal/ErrorIcon.js

@@ -7,26 +7,26 @@ var reactI18next = require('react-i18next');
 var jsxRuntime = require('react/jsx-runtime');
 
 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; }
-var ErrorIcon = function ErrorIcon(_ref) {
-  var _error$values$label, _error$values, _error$values2;
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), true).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 ErrorIcon(_ref) {
+  var _error$values$label;
   var _ref$error = _ref.error,
     error = _ref$error === void 0 ? "" : _ref$error,
     invalid = _ref.invalid;
   var _useTranslation = reactI18next.useTranslation(),
     t = _useTranslation.t;
-  return invalid && /*#__PURE__*/jsxRuntime.jsx(core.Tooltip, {
-    content: utilities.isString(error) ? "".concat(error) : t(error === null || error === void 0 ? void 0 : error.key, error.values ? _objectSpread(_objectSpread({}, error === null || error === void 0 ? void 0 : error.values), {}, {
-      label: t((_error$values$label = (_error$values = error.values) === null || _error$values === void 0 ? void 0 : _error$values.label) !== null && _error$values$label !== void 0 ? _error$values$label : "form:badkey", (_error$values2 = error.values) === null || _error$values2 === void 0 ? void 0 : _error$values2.path)
-    }) : {}),
+  return invalid && error && /*#__PURE__*/jsxRuntime.jsx(core.Tooltip, {
+    content: utilities.isObject(error) ? t(error.key, utilities.isObject(error.values) ? _objectSpread(_objectSpread({}, error.values), {}, {
+      label: t((_error$values$label = error.values.label) !== null && _error$values$label !== void 0 ? _error$values$label : "form:badkey", error.values.path)
+    }) : {}) : utilities.isString(error) ? error : "",
     placement: "bottom",
     color: "danger",
     children: /*#__PURE__*/jsxRuntime.jsx(core.Icon, {
       className: "flex-content first:ms-2 self-center",
       color: "danger",
-      icon: core.CoreIcons.alert
+      icon: "icon-[mdi--alert-circle-outline]"
     })
   });
-};
+}
 
 exports.ErrorIcon = ErrorIcon;

package/dist/cjs/internal/FieldWrapper.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var classNames = require('classnames');
-var Field_module = require('./Field.module.css');
+var utilities = require('@react-fabric/utilities');
+var ErrorIcon = require('./ErrorIcon.js');
 var jsxRuntime = require('react/jsx-runtime');
 
 /*
@@ -27,43 +27,53 @@ var jsxRuntime = require('react/jsx-runtime');
  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  */
 
-var FieldWrapper = function FieldWrapper(_ref) {
-  var label = _ref.label,
+function FieldWrapper(_ref) {
+  var id = _ref.id,
+    name = _ref.name,
+    label = _ref.label,
     appendLabel = _ref.appendLabel,
     width = _ref.width,
     _ref$labelWidth = _ref.labelWidth,
     labelWidth = _ref$labelWidth === void 0 ? 192 : _ref$labelWidth,
     inline = _ref.inline,
     info = _ref.info,
-    disabled = _ref.disabled,
     required = _ref.required,
     children = _ref.children,
     listing = _ref.listing,
-    className = _ref.className,
-    isInner = _ref["data-inner"];
+    invalid = _ref.invalid,
+    disabled = _ref.disabled,
+    error = _ref.error,
+    showError = _ref.showError;
   return /*#__PURE__*/jsxRuntime.jsxs("div", {
-    className: classNames(Field_module.fieldWrapper, className, inline ? "flex flex-nowrap gap-1" : "block"),
+    className: utilities.cn("fabric-fieldWrapper peer group relative", width ? "flex-content" : "flex-1", inline ? "flex flex-nowrap" : "flex flex-col"),
     "data-ref": "fieldWrapper",
+    "data-testid": "field_".concat(name),
     style: {
       width: width,
       flexBasis: width
     },
-    children: [!isInner && /*#__PURE__*/jsxRuntime.jsxs("div", {
-      className: "flex flex-nowrap flex-content gap-1 py-0.5 px-2",
+    children: [label && /*#__PURE__*/jsxRuntime.jsxs("div", {
+      className: "fabric-fieldLabel flex flex-nowrap flex-content items-end gap-1 py-0.5 px-2",
       style: {
         width: inline ? labelWidth : undefined
       },
       children: [/*#__PURE__*/jsxRuntime.jsx("label", {
         role: "none",
-        className: classNames("flex-initial truncate text-sm", disabled && "text-muted"),
+        htmlFor: id,
+        className: utilities.cn("flex-initial truncate text-sm", disabled && "text-muted"),
         onClick: function onClick(e) {
           var _e$currentTarget$clos;
           return (_e$currentTarget$clos = e.currentTarget.closest('[data-ref="fieldWrapper"]')) === null || _e$currentTarget$clos === void 0 || (_e$currentTarget$clos = _e$currentTarget$clos.querySelector("input,textarea")) === null || _e$currentTarget$clos === void 0 ? void 0 : _e$currentTarget$clos.focus();
         },
         children: label
       }), required && /*#__PURE__*/jsxRuntime.jsx("span", {
-        className: "text-danger-500 select-none flex-content text-[10px]",
+        className: "text-danger-500 select-none self-center flex-content text-[10px]",
         children: "\u273D"
+      }), showError && /*#__PURE__*/jsxRuntime.jsx(ErrorIcon.ErrorIcon, {
+        invalid: invalid,
+        error: error
+      }), /*#__PURE__*/jsxRuntime.jsx("div", {
+        className: "flex-1"
       }), appendLabel && /*#__PURE__*/jsxRuntime.jsx("span", {
         className: "flex-content",
         children: appendLabel
@@ -73,6 +83,6 @@ var FieldWrapper = function FieldWrapper(_ref) {
       children: info
     })]
   });
-};
+}
 
 exports.FieldWrapper = FieldWrapper;

package/dist/cjs/internal/InputWrapper.js

@@ -2,112 +2,110 @@
 
 var _defineProperty = require('@babel/runtime/helpers/defineProperty');
 var _slicedToArray = require('@babel/runtime/helpers/slicedToArray');
-var _objectWithoutProperties = require('@babel/runtime/helpers/objectWithoutProperties');
-var react$1 = require('@floating-ui/react');
 var core = require('@react-fabric/core');
 var utilities = require('@react-fabric/utilities');
-var classNames = require('classnames');
 var react = require('react');
-var jsxRuntime = require('react/jsx-runtime');
 var ErrorIcon = require('./ErrorIcon.js');
-var Field_module = require('./Field.module.css');
 var FieldWrapper = require('./FieldWrapper.js');
+var jsxRuntime = require('react/jsx-runtime');
 
-var _excluded = ["invalid", "error", "allowClear", "showClear", "decorateStart", "decorateEnd", "children", "onClear", "noOutline", "noBorder", "textarea", "data-inner", "data-open", "floatingExpand", "wrapperRef", "width"];
 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; }
-var InputWrapper = function InputWrapper(_ref) {
-  var _elRef$current;
-  var invalid = _ref.invalid,
-    error = _ref.error,
-    allowClear = _ref.allowClear,
-    showClear = _ref.showClear,
-    decorateStart = _ref.decorateStart,
-    decorateEnd = _ref.decorateEnd,
-    children = _ref.children,
-    onClear = _ref.onClear,
-    noOutline = _ref.noOutline,
-    noBorder = _ref.noBorder,
-    _ref$textarea = _ref.textarea,
-    textarea = _ref$textarea === void 0 ? false : _ref$textarea,
-    isInner = _ref["data-inner"];
-    _ref["data-open"];
-    var floatingExpand = _ref.floatingExpand,
-    wrapperRef = _ref.wrapperRef,
-    width = _ref.width,
-    rest = _objectWithoutProperties(_ref, _excluded);
-  var elRef = react.useRef(null);
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), true).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 InputWrapper(props) {
+  var invalid = props.invalid,
+    error = props.error,
+    showClear = props.showClear,
+    decorateStart = props.decorateStart,
+    decorateEnd = props.decorateEnd,
+    decorateEndShowWhenEmpty = props.decorateEndShowWhenEmpty,
+    decorateEndHideWhenEmpty = props.decorateEndHideWhenEmpty,
+    children = props.children,
+    isOpen = props.isOpen,
+    className = props.className,
+    focusRing = props.focusRing,
+    onClear = props.onClear,
+    borderless = props.borderless,
+    hasStepper = props.hasStepper,
+    actionButton = props.actionButton,
+    _props$textarea = props.textarea,
+    textarea = _props$textarea === void 0 ? false : _props$textarea,
+    _props$textareaExpand = props.textareaExpandable,
+    textareaExpandable = _props$textareaExpand === void 0 ? false : _props$textareaExpand,
+    floatingExpand = props.floatingExpand,
+    ref = props.ref;
+  var wrapperRef = react.useRef(null);
   var _useState = react.useState(false),
     _useState2 = _slicedToArray(_useState, 2),
     isExpanded = _useState2[0],
-    setExpanded = _useState2[1];
-  var Wrapper = react.useMemo(function () {
-    return isInner || !rest.label ? jsxRuntime.Fragment : FieldWrapper.FieldWrapper;
-  }, [isInner, rest.label]);
-  var wrapperProps = react.useMemo(function () {
-    return isInner || !rest.label ? {} : _objectSpread(_objectSpread({}, rest), {}, {
-      width: width
-    });
-  }, [isInner, rest, width]);
+    setIsExpanded = _useState2[1];
   var handleClear = react.useCallback(function (e) {
-    var _e$currentTarget$pare;
-    (_e$currentTarget$pare = e.currentTarget.parentElement) === null || _e$currentTarget$pare === void 0 || (_e$currentTarget$pare = _e$currentTarget$pare.querySelector("input,textarea,button")) === null || _e$currentTarget$pare === void 0 || _e$currentTarget$pare.focus();
+    var _e$currentTarget$pare, _parent$querySelector;
+    var parent = (_e$currentTarget$pare = e.currentTarget.parentElement) === null || _e$currentTarget$pare === void 0 ? void 0 : _e$currentTarget$pare.querySelector("& > :not(.fabric-decorate)");
+    var el = (_parent$querySelector = parent === null || parent === void 0 ? void 0 : parent.querySelector("input,textarea,button")) !== null && _parent$querySelector !== void 0 ? _parent$querySelector : parent;
+    el === null || el === void 0 || el.focus();
     onClear === null || onClear === void 0 || onClear();
   }, [onClear]);
   var doFocus = react.useCallback(function (e) {
-    var _e$currentTarget$pare2;
-    (_e$currentTarget$pare2 = e.currentTarget.parentElement) === null || _e$currentTarget$pare2 === void 0 || (_e$currentTarget$pare2 = _e$currentTarget$pare2.querySelector("input,textarea,button")) === null || _e$currentTarget$pare2 === void 0 || _e$currentTarget$pare2.focus();
-  }, [onClear]);
+    var _e$currentTarget$pare2, _parent$querySelector2;
+    var parent = (_e$currentTarget$pare2 = e.currentTarget.parentElement) === null || _e$currentTarget$pare2 === void 0 ? void 0 : _e$currentTarget$pare2.querySelector("& > :not(.fabric-decorate)");
+    var el = (_parent$querySelector2 = parent === null || parent === void 0 ? void 0 : parent.querySelector("input,textarea,button")) !== null && _parent$querySelector2 !== void 0 ? _parent$querySelector2 : parent;
+    el === null || el === void 0 || el.focus();
+  }, []);
   react.useEffect(function () {
-    isExpanded && setTimeout(function () {
-      var _wrapperRef$current;
-      return wrapperRef === null || wrapperRef === void 0 || (_wrapperRef$current = wrapperRef.current) === null || _wrapperRef$current === void 0 || (_wrapperRef$current = _wrapperRef$current.querySelector("textarea")) === null || _wrapperRef$current === void 0 ? void 0 : _wrapperRef$current.focus();
-    }, 50);
-  }, [isExpanded]);
-  var el = /*#__PURE__*/jsxRuntime.jsxs("div", {
-    role: "none",
-    ref: wrapperRef,
-    className: classNames(Field_module.inputWrapper, invalid && Field_module.invalidWrapper, !noOutline && !noBorder && "bg-[var(--fabric-input)] outline overflow-hidden", "flex flex-nowrap items-center", textarea ? "rounded-capped group" : "rounded", isExpanded ? "fixed inset-4 z-[99]" : floatingExpand ? "absolute inset-x-0" : "relative", !noOutline && "after:absolute after:bottom-0 after:h-px after:bg-primary-500 after:mx-auto"),
-    onKeyDown: function onKeyDown(e) {
-      return e.key === "Escape" && setExpanded(false);
-    },
-    children: [decorateStart && /*#__PURE__*/jsxRuntime.jsx("div", {
-      onClickCapture: doFocus,
-      className: classNames(Field_module.decorate, "text-muted leading-none flex-content", utilities.isString(decorateStart) && "px-1"),
-      children: decorateStart
-    }), /*#__PURE__*/jsxRuntime.jsx(ErrorIcon.ErrorIcon, {
-      invalid: invalid,
-      error: error
-    }), children, allowClear && showClear && /*#__PURE__*/jsxRuntime.jsx(core.Icon, {
-      icon: core.CoreIcons.close,
-      onClick: handleClear,
-      className: classNames("text-tint-500 hover:text-tint-700 p-1 z-1 flex-content", Field_module.inputClear, textarea && "self-start mt-1 me-1")
-    }), decorateEnd && /*#__PURE__*/jsxRuntime.jsx("div", {
-      onClickCapture: doFocus,
-      className: classNames(Field_module.decorate, "text-muted leading-none flex-content", utilities.isString(decorateEnd) && "px-1"),
-      children: decorateEnd
-    }), textarea && /*#__PURE__*/jsxRuntime.jsx(core.Icon, {
-      onClick: function onClick() {
-        return setExpanded(!isExpanded);
-      },
-      icon: isExpanded ? core.CoreIcons.arrowCollapse : core.CoreIcons.arrowExpand,
-      className: "hidden group-hover:block absolute top-0 end-0 bg-base hover:bg-tint-200 p-1 opacity-65 rounded-capped"
-    })]
-  });
-  return /*#__PURE__*/jsxRuntime.jsx(Wrapper, _objectSpread(_objectSpread({}, wrapperProps), {}, {
+    if (isExpanded) {
+      var tmr = setTimeout(function () {
+        var _wrapperRef$current;
+        return wrapperRef === null || wrapperRef === void 0 || (_wrapperRef$current = wrapperRef.current) === null || _wrapperRef$current === void 0 || (_wrapperRef$current = _wrapperRef$current.querySelector("textarea")) === null || _wrapperRef$current === void 0 ? void 0 : _wrapperRef$current.focus();
+      }, 50);
+      return function () {
+        clearTimeout(tmr);
+      };
+    }
+  }, [isExpanded, wrapperRef]);
+  return /*#__PURE__*/jsxRuntime.jsx(FieldWrapper.FieldWrapper, _objectSpread(_objectSpread({}, props), {}, {
     children: /*#__PURE__*/jsxRuntime.jsxs("div", {
-      ref: elRef,
-      className: "flex-1 relative min-h-8",
-      style: {
-        width: width,
-        flexBasis: width
+      role: "none",
+      ref: utilities.mergeRefs(ref, wrapperRef),
+      className: utilities.cn("fabric-inputWrapper", invalid && "fabric-invalidWrapper", !borderless && "outline", textarea ? "rounded-capped" : "rounded", className, "flex flex-1 flex-nowrap items-center bg-(--fabric-input)", isExpanded ? "fixed inset-4 z-99" : floatingExpand ? "absolute inset-x-0" : "relative", focusRing ? "focus-within:ring ring-primary-500" : "after:absolute after:bottom-0 after:h-px after:bg-primary-500 after:mx-auto", isOpen && "outline-primary-500"),
+      onKeyDown: function onKeyDown(e) {
+        return e.key === "Escape" && isExpanded && (setIsExpanded(false), e.stopPropagation());
       },
-      children: [!isExpanded && el, isExpanded && /*#__PURE__*/jsxRuntime.jsx(react$1.FloatingPortal, {
-        root: (_elRef$current = elRef.current) === null || _elRef$current === void 0 ? void 0 : _elRef$current.closest(".theme-base"),
-        children: el
+      children: [decorateStart && /*#__PURE__*/jsxRuntime.jsx("div", {
+        onClickCapture: doFocus,
+        className: utilities.cn("fabric-decorate", "text-muted leading-none flex-content", utilities.isString(decorateStart) && "px-1"),
+        children: decorateStart
+      }), /*#__PURE__*/jsxRuntime.jsx(ErrorIcon.ErrorIcon, {
+        invalid: invalid,
+        error: error
+      }), children, showClear && /*#__PURE__*/jsxRuntime.jsx("button", {
+        type: "button",
+        className: utilities.cn("size-fit leading-0 cursor-pointer", hasStepper && "relative -ms-12"),
+        onClick: handleClear,
+        children: /*#__PURE__*/jsxRuntime.jsx(core.Icon, {
+          icon: "icon-[mdi--close]",
+          className: utilities.cn("text-tint-500 hover:text-tint-700 p-1 z-1 flex-content", "fabric-inputClear")
+        })
+      }), decorateEnd && /*#__PURE__*/jsxRuntime.jsx("div", {
+        onClickCapture: doFocus,
+        className: utilities.cn("fabric-decorate", "text-muted leading-none flex-content", utilities.isString(decorateEnd) && "px-1", decorateEndHideWhenEmpty && "peer-placeholder-shown:hidden", decorateEndShowWhenEmpty && "hidden peer-placeholder-shown:inline-block"),
+        children: decorateEnd
+      }), actionButton && /*#__PURE__*/jsxRuntime.jsx("div", {
+        onClickCapture: doFocus,
+        className: utilities.cn("fabric-decorate", "text-muted leading-none flex-content"),
+        children: actionButton
+      }), textareaExpandable && /*#__PURE__*/jsxRuntime.jsx("button", {
+        type: "button",
+        className: "size-fit cursor-pointer leading-0 absolute top-0 inset-e-0",
+        onClick: function onClick() {
+          return setIsExpanded(!isExpanded);
+        },
+        children: /*#__PURE__*/jsxRuntime.jsx(core.Icon, {
+          icon: isExpanded ? "icon-[mdi--arrow-collapse]" : "icon-[mdi--arrow-expand]",
+          className: "hidden group-hover:block bg-default hover:bg-tint-200 p-1 opacity-65 rounded-capped"
+        })
       })]
     })
   }));
-};
+}
 
 exports.InputWrapper = InputWrapper;

package/dist/cjs/ranger/index.js

@@ -14,7 +14,7 @@ var useGetLatest = function useGetLatest(val) {
     return ref.current;
   }, []);
 };
-var useRanger = function useRanger(opts) {
+function useRanger(opts) {
   var _opts$tickSize;
   var tickSize = (_opts$tickSize = opts.tickSize) !== null && _opts$tickSize !== void 0 ? _opts$tickSize : 10;
   var values = opts.values;
@@ -195,17 +195,17 @@ var useRanger = function useRanger(opts) {
     } else {
       setActiveHandleIndex(i);
     }
-    var handleRelease = function handleRelease(e) {
+    var _handleRelease = function handleRelease() {
       var _getLatest5 = getLatest(),
         tempValues = _getLatest5.tempValues,
         onChange = _getLatest5.onChange,
         onDragEnd = _getLatest5.onDragEnd;
       document.removeEventListener("mousemove", i === -1 ? handleSegmentDrag : handleDrag);
       document.removeEventListener("touchmove", i === -1 ? handleSegmentDrag : handleDrag);
-      document.removeEventListener("mouseup", handleRelease, {
+      document.removeEventListener("mouseup", _handleRelease, {
         capture: true
       });
-      document.removeEventListener("touchend", handleRelease, {
+      document.removeEventListener("touchend", _handleRelease, {
         capture: true
       });
       var sortedValues = utils.sortNumList(tempValues || values);
@@ -218,10 +218,10 @@ var useRanger = function useRanger(opts) {
     onDragStart === null || onDragStart === void 0 || onDragStart();
     document.addEventListener("mousemove", i === -1 ? handleSegmentDrag : handleDrag);
     document.addEventListener("touchmove", i === -1 ? handleSegmentDrag : handleDrag);
-    document.addEventListener("mouseup", handleRelease, {
+    document.addEventListener("mouseup", _handleRelease, {
       capture: true
     });
-    document.addEventListener("touchend", handleRelease, {
+    document.addEventListener("touchend", _handleRelease, {
       capture: true
     });
   }, [getLatest, handleDrag]);
@@ -347,6 +347,6 @@ var useRanger = function useRanger(opts) {
     segments: segments,
     handles: handles
   };
-};
+}
 
 exports.useRanger = useRanger;

package/dist/cjs/ranger/utils.js

@@ -7,7 +7,12 @@ var _toConsumableArray = require('@babel/runtime/helpers/toConsumableArray');
  * https://github.com/TanStack/ranger
  */
 
-var getBoundingClientRect = function getBoundingClientRect(element) {
+/* eslint-disable @typescript-eslint/no-unsafe-argument */
+/* eslint-disable @typescript-eslint/no-unsafe-member-access */
+/* eslint-disable @typescript-eslint/no-unsafe-call */
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+
+function getBoundingClientRect(element) {
   var rect = element.getBoundingClientRect();
   return {
     top: Math.ceil(rect.top),
@@ -17,12 +22,12 @@ var getBoundingClientRect = function getBoundingClientRect(element) {
     bottom: Math.ceil(rect.bottom),
     height: Math.ceil(rect.height)
   };
-};
-var sortNumList = function sortNumList(arr) {
+}
+function sortNumList(arr) {
   return _toConsumableArray(arr).map(Number).sort(function (a, b) {
     return a - b;
   });
-};
+}
 var linearInterpolator = {
   getPercentageForValue: function getPercentageForValue(val, min, max) {
     return Math.max(0, Math.min(100, (val - min) / (max - min) * 100));