@instructure/ui-utils 11.7.8 → 11.7.9-pr-snapshot-1792147648392

package/lib/mergeDeep.js

@@ -1,89 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-exports.mergeDeep = mergeDeep;
-/*
- * The MIT License (MIT)
- *
- * Copyright (c) 2015 - present Instructure, Inc.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-/**
- * ---
- * category: utilities/Misc
- * ---
- * Deep merge N objects into a single result object.
- * Merging creates a new object, so that none of the arguments are modified.
- *
- * @module mergeDeep
- *
- * @param {Object} args objects to merge
- * @returns {Object} a new object with items from all arguments
- */
-function mergeDeep(...args) {
-  // note: This could be typed as the union of its args, but since
-  // its barely used its not worth the effort currently
-  let target = {};
-  args.forEach(arg => {
-    target = mergeSourceIntoTarget(target, arg);
-  });
-  return target;
-}
-function mergeSourceIntoTarget(target, source) {
-  if (isObject(source)) {
-    const keys = [...Object.keys(source), ...Object.getOwnPropertySymbols(source)];
-    const merged = {
-      ...target
-    };
-    keys.forEach(key => {
-      // Block prototype-pollution payloads. These keys can arrive via
-      // JSON.parse or other deserialization in consumer-supplied
-      // themeOverride props.
-      if (key === '__proto__' || key === 'prototype' || key === 'constructor') {
-        return;
-      }
-      if (isObject(target[key]) && isObject(source[key])) {
-        merged[key] = mergeSourceIntoTarget(target[key], source[key]);
-      } else if (isArray(source[key]) && isArray(target[key])) {
-        merged[key] = [...new Set([...target[key], ...source[key]])];
-      } else if (isArray(target[key])) {
-        merged[key] = [...new Set([...target[key], ...[source[key]]])];
-      } else {
-        merged[key] = source[key];
-      }
-    });
-    return merged;
-  } else {
-    return {
-      ...target
-    };
-  }
-}
-function isObject(item) {
-  return item && (typeof item === 'object' || typeof item === 'function') && !Array.isArray(item);
-}
-function isArray(item) {
-  return Array.isArray(item);
-}
-var _default = exports.default = mergeDeep;

package/lib/ms.js

@@ -1,62 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-exports.ms = ms;
-var _parseUnit = require("./parseUnit.js");
-/*
- * The MIT License (MIT)
- *
- * Copyright (c) 2015 - present Instructure, Inc.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-/**
- * ---
- * category: utilities/Misc
- * ---
- * Converts a unit value time combination (s, ms) to a number representing ms
- *
- * @module ms
- *
- * Example inputs:
- *  - '100s'
- *  - '20ms'
- *
- * @param {String|Number} val
- * @returns {Number} Returns numerical representation of milliseconds
- */
-function ms(val) {
-  // TODO: throw an error if val is not number or string
-  if (!val || typeof val === 'number') {
-    return val;
-  }
-  const [num, unit] = (0, _parseUnit.parseUnit)(val);
-  if (unit === 'ms') {
-    return num;
-  } else if (unit === 's') {
-    return num * 1000;
-  } else {
-    return num;
-  }
-}
-var _default = exports.default = ms;

package/lib/package.json

@@ -1 +0,0 @@
-{"type":"commonjs"}

package/lib/parseUnit.js

@@ -1,57 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-exports.parseUnit = parseUnit;
-/*
- * The MIT License (MIT)
- *
- * Copyright (c) 2015 - present Instructure, Inc.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-/**
- * ---
- * category: utilities/Misc
- * ---
- * Converts a CSS unit value combination into an array of type [ value, unit ]
- *
- * @module parseUnit
- *
- * Example inputs:
- *  - '100px'
- *  - '20rem'
- *  - '10vh'
- *  - '400vmin'
- *
- * @param {string|number} str
- * @returns {Array} Returns array of shape [ value, unit ] Unit is '' if it could
- * not be parsed
- */
-
-function parseUnit(str) {
-  const value = `${str}`;
-  // eslint-disable-next-line no-useless-escape
-  const match = value.match(/[\d.\-\+]*\s*(.*)/);
-  return [parseFloat(value), match && match.length > 0 ? match[1] : ''];
-}
-var _default = exports.default = parseUnit;

package/lib/pascalize.js

@@ -1,55 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-exports.pascalize = pascalize;
-var _capitalizeFirstLetter = require("./capitalizeFirstLetter.js");
-var _camelize = require("./camelize.js");
-/*
- * The MIT License (MIT)
- *
- * Copyright (c) 2015 - present Instructure, Inc.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-/**
- * ---
- * category: utilities/Misc
- * ---
- * Converts a hyphenated or camel cased string to pascal case
- *
- * Example inputs:
- *  - 'foo-bar'
- *  - 'baz-qux'
- *
- * Example outputs:
- *  - 'FooBar'
- *  - 'BazQux'
- *
- * @module pascalize
- * @param {String} str
- * @returns {String} Returns pascal cased string
- */
-function pascalize(str) {
-  return (0, _capitalizeFirstLetter.capitalizeFirstLetter)((0, _camelize.camelize)(str));
-}
-var _default = exports.default = pascalize;

package/lib/px.js

@@ -1,68 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-exports.px = px;
-var _canUseDOM = require("@instructure/ui-dom-utils/lib/canUseDOM.js");
-var _getFontSize = require("@instructure/ui-dom-utils/lib/getFontSize.js");
-var _parseUnit = require("./parseUnit.js");
-/*
- * The MIT License (MIT)
- *
- * Copyright (c) 2015 - present Instructure, Inc.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-/**
- * ---
- * category: utilities/Misc
- * ---
- * Converts a unit value size combination (em, rem, px) to a number representing px
- *
- * Example inputs:
- *  - '100rem'
- *  - '20em'
- *  - '40px'
- *
- * @module px
- *
- * @param {String|number} val The value to look up. If it's a number its just returned as is.
- * @param {Document|Window|Node|React.ReactElement |React.Component|null} el - containing element, for context measure is em (defaults to `document.body`)
- * @returns {Number} Returns numerical representation of pixels
- */
-function px(val, el) {
-  // TODO !val should not be needed
-  if (!val || typeof val === 'number') {
-    return val;
-  }
-  const [num, unit] = (0, _parseUnit.parseUnit)(val);
-  if (unit === 'rem') {
-    return num * (0, _getFontSize.getFontSize)();
-  } else if (unit === 'em') {
-    const doc = _canUseDOM.canUseDOM ? document.body : null;
-    const container = el || doc;
-    return num * (0, _getFontSize.getFontSize)(container);
-  } else {
-    return num;
-  }
-}
-var _default = exports.default = px;

package/lib/safeHref.js

@@ -1,115 +0,0 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-exports.safeHref = safeHref;
-var _dompurify = _interopRequireDefault(require("dompurify"));
-/*
- * The MIT License (MIT)
- *
- * Copyright (c) 2015 - present Instructure, Inc.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-// Use a dedicated DOMPurify instance instead of the shared singleton so our
-// HTML profile never leaks onto the global instance other code relies on, and
-// our validation stays correct even if someone else mutates the singleton via
-// setConfig(). `window` is guarded for SSR; passing `undefined` yields an
-// unsupported instance, in which case we fall back to `ssrSafeHref`.
-const purify = (0, _dompurify.default)(typeof window === 'undefined' ? undefined : window);
-if (purify.isSupported) {
-  purify.setConfig({
-    USE_PROFILES: {
-      html: true
-    }
-  });
-}
-const SAFE_SCHEMES = ['http:', 'https:', 'ftp:', 'ftps:', 'mailto:', 'tel:', 'sms:', 'callto:', 'cid:', 'xmpp:', 'matrix:', 'webcal:', 'feed:', 'geo:'];
-
-/**
- * Remove all control characters (e.g. line break, tab, escape) and trim the
- * string
- */
-function normalizeValue(value) {
-  // eslint-disable-next-line no-control-regex
-  return value.replace(/[\u0000-\u001F\u007F]/g, '').trim();
-}
-
-// Extract the scheme from a URL-ish value, or `null` if it has none.
-function extractScheme(value) {
-  const schemeMatch = normalizeValue(value).match(/^([a-zA-Z][a-zA-Z0-9+.-]*):/);
-  return schemeMatch ? schemeMatch[1].toLowerCase() + ':' : null;
-}
-
-// (tag, attr) pairs that may legitimately carry a `data:` URI — matches
-// DOMPurify's defaults so the SSR fallback doesn't reject inline images that
-// the browser path would allow.
-const DATA_URI_TAGS = [['img', 'src'], ['source', 'src'], ['source', 'srcset'], ['video', 'poster']];
-
-// SSR fallback: DOMPurify only operates when a DOM is available. When it
-// isn't, validate the scheme directly so server-rendered components don't
-// silently drop every href.
-function ssrSafeHref(value, tag, attr) {
-  const normalized = normalizeValue(value);
-  if (normalized === '') return true;
-  const firstChar = normalized.charAt(0);
-  if (firstChar === '#' || firstChar === '/' || firstChar === '?') return true;
-  const scheme = extractScheme(normalized);
-  if (!scheme) return true;
-  if (SAFE_SCHEMES.includes(scheme)) return true;
-  if (scheme === 'data:' && DATA_URI_TAGS.some(([t, a]) => t === tag && a === attr)) {
-    return true;
-  }
-  return false;
-}
-
-/**
- * ---
- * category: utilities/utils
- * ---
- * Validates an attribute value and returns it only when the value is safe to
- * render. Delegates to `DOMPurify.isValidAttribute` in the browser; falls back
- * to a minimal scheme allow-list under SSR.
- *
- * @module safeHref
- *
- * @param href The value to validate
- * @param tag Element name the value will be applied to (e.g. `'a'`, `'img'`)
- * @param attr Attribute name (e.g. `'href'`, `'src'`)
- * @returns The original value if safe, `undefined` if blocked
- */
-function safeHref(href, tag, attr) {
-  if (href == null || typeof href === 'undefined') return undefined;
-  const value = String(href);
-
-  // Pre-check our scheme allowlist before DOMPurify, since DOMPurify's default
-  // ALLOWED_URI_REGEXP rejects schemes like `webcal:` that we treat as safe.
-  const scheme = extractScheme(value);
-  if (scheme && SAFE_SCHEMES.includes(scheme)) return href;
-  const isSafe = purify.isSupported ? purify.isValidAttribute(tag, attr, value) : ssrSafeHref(value, tag, attr);
-  if (!isSafe) {
-    return undefined;
-  }
-  return href;
-}
-var _default = exports.default = safeHref;

package/lib/safeLinkProps.js

@@ -1,59 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-exports.safeLinkProps = safeLinkProps;
-var _safeHref = require("./safeHref.js");
-/*
- * The MIT License (MIT)
- *
- * Copyright (c) 2015 - present Instructure, Inc.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-/**
- * ---
- * category: utilities/utils
- * ---
- * Centralizes the security-related normalization for link-rendering
- * components: validates `href`, and supplies a safe default `rel` when
- * `target="_blank"` is in use.
- *
- * @module safeLinkProps
- */
-
-function safeLinkProps(input) {
-  const {
-    target,
-    rel,
-    tag,
-    attr
-  } = input;
-  const href = (0, _safeHref.safeHref)(input.href, tag, attr);
-  const finalRel = target === '_blank' && rel == null ? 'noopener noreferrer' : rel;
-  return {
-    href,
-    target,
-    rel: finalRel
-  };
-}
-var _default = exports.default = safeLinkProps;

package/lib/shallowEqual.js

@@ -1,85 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-exports.shallowEqual = shallowEqual;
-/*
- * The MIT License (MIT)
- *
- * Copyright (c) 2015 - present Instructure, Inc.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-// https://github.com/facebook/fbjs/blob/master/packages/fbjs/src/core/shallowEqual.js
-const hasOwnProperty = Object.prototype.hasOwnProperty;
-
-/**
- * ---
- * category: utilities/Misc
- * ---
- * Performs equality by iterating through keys on an object and returning false
- * when any key has values which are not strictly equal between the arguments.
- *
- * @module shallowEqual
- *
- * @param {Object} objA
- * @param {Object} objB
- * @returns {Boolean} Returns true when the values of all keys are strictly equal
- */
-function shallowEqual(objA, objB) {
-  if (is(objA, objB)) {
-    return true;
-  }
-  if (typeof objA !== 'object' || objA === null || typeof objB !== 'object' || objB === null) {
-    return false;
-  }
-  const keysA = Object.keys(objA);
-  const keysB = Object.keys(objB);
-  if (keysA.length !== keysB.length) {
-    return false;
-  }
-
-  // Test for A's keys different from B.
-  for (let i = 0; i < keysA.length; i++) {
-    if (!hasOwnProperty.call(objB, keysA[i]) || !is(objA[keysA[i]], objB[keysA[i]])) {
-      return false;
-    }
-  }
-  return true;
-}
-
-/*
- * inlined Object.is polyfill to avoid requiring consumers ship their own
- * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is
- */
-function is(x, y) {
-  // SameValue algorithm
-  if (x === y) {
-    // Steps 1-5, 7-10
-    // Steps 6.b-6.e: +0 != -0
-    return x !== 0 || y !== 0 || 1 / x === 1 / y;
-  } else {
-    // Step 6.a: NaN == NaN
-    return x !== x && y !== y;
-  }
-}
-var _default = exports.default = shallowEqual;

package/lib/within.js

@@ -1,48 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-exports.within = within;
-/*
- * The MIT License (MIT)
- *
- * Copyright (c) 2015 - present Instructure, Inc.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-/**
- * ---
- * category: utilities/Misc
- * ---
- * Determines if one numerical value (a) is within a designated range (diff) of another (b)
- *
- * @module within
- *
- * @param {number} a
- * @param {number} b
- * @param {number} [diff=1]
- * @returns {Boolean} Returns true if a is within the diff range of b
- */
-function within(a, b, diff = 1) {
-  return a + diff >= b && b >= a - diff;
-}
-var _default = exports.default = within;