toosoon-utils 3.0.4 → 4.0.0

package/lib/colors.js

@@ -1,19 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hclToRgb = exports.rgbToHcl = exports.deltaE = exports.rgbToLab = exports.labToRgb = exports.hclToLab = exports.labToHcl = exports.hsbToRgb = exports.rgbToHsb = exports.hslToRgb = exports.rgbToHsl = exports.normalizeHslString = exports.darken = exports.lighten = exports.hexToRgb = exports.rgbToHexString = exports.rgbToHex = exports.normalizeHexString = exports.normalizeColor = void 0;
-var constants_1 = require("./constants");
-var geometry_1 = require("./geometry");
-var maths_1 = require("./maths");
+import { W3CX11 } from './constants';
+import { toDegrees, toRadians } from './geometry';
+import { clamp } from './maths';
 /**
  * Normalize a color representation into RGB
  *
  * @param {ColorRepresentation} color Color representation
  * @returns {[number,number,number]} Normalized RGB color
  */
-function normalizeColor(color) {
+export function normalizeColor(color) {
     var _a;
     if (typeof color === 'string') {
-        return hexToRgb((_a = constants_1.W3CX11[color]) !== null && _a !== void 0 ? _a : color);
+        return hexToRgb((_a = W3CX11[color]) !== null && _a !== void 0 ? _a : color);
     }
     else if (typeof color === 'number') {
         return hexToRgb(color);
@@ -22,7 +19,6 @@ function normalizeColor(color) {
         return color;
     }
 }
-exports.normalizeColor = normalizeColor;
 // ******************************************
 // RGB & Hexadecimal color spaces
 // ******************************************
@@ -32,7 +28,7 @@ exports.normalizeColor = normalizeColor;
  * @param {string} hex Hexadecimal string
  * @returns {string} Normalized hexadecimal string
  */
-function normalizeHexString(hex) {
+export function normalizeHexString(hex) {
     var match;
     var result = '000000';
     hex = hex.toLocaleLowerCase();
@@ -50,7 +46,6 @@ function normalizeHexString(hex) {
     }
     return "#".concat(result);
 }
-exports.normalizeHexString = normalizeHexString;
 /**
  * Convert RGB to hexadecimal
  * Note: rgb values are contained in the interval [0, 1]
@@ -58,11 +53,10 @@ exports.normalizeHexString = normalizeHexString;
  * @param  {[number, number, number]} rgb RGB color
  * @returns {number} Hexadecimal color
  */
-function rgbToHex(_a) {
+export function rgbToHex(_a) {
     var r = _a[0], g = _a[1], b = _a[2];
     return ((r * 255) << 16) ^ ((g * 255) << 8) ^ ((b * 255) << 0);
 }
-exports.rgbToHex = rgbToHex;
 /**
  * Convert RGB to hexadecimal string
  * Note: rgb values are contained in the interval [0, 1]
@@ -70,23 +64,22 @@ exports.rgbToHex = rgbToHex;
  * @param  {[number, number, number]} rgb RGB color
  * @returns {string} Hexadecimal string
  */
-function rgbToHexString(_a) {
+export function rgbToHexString(_a) {
     var r = _a[0], g = _a[1], b = _a[2];
-    r = (0, maths_1.clamp)(Math.round(r * 255), 0, 255);
-    g = (0, maths_1.clamp)(Math.round(g * 255), 0, 255);
-    b = (0, maths_1.clamp)(Math.round(b * 255), 0, 255);
+    r = clamp(Math.round(r * 255), 0, 255);
+    g = clamp(Math.round(g * 255), 0, 255);
+    b = clamp(Math.round(b * 255), 0, 255);
     var result = (b | (g << 8) | (r << 16) | (1 << 24)).toString(16).slice(1);
     return "#".concat(result);
 }
-exports.rgbToHexString = rgbToHexString;
 /**
  * Convert hexadecimal to RGB
  * Note: rgb values are contained in the interval [0, 1]
  *
- * @param  {(number|string)} hex Hexadecimal color
+ * @param  {number|string} hex Hexadecimal color
  * @returns {[number, number, number]} RGB color
  */
-function hexToRgb(hex) {
+export function hexToRgb(hex) {
     if (typeof hex === 'number') {
         hex = Math.floor(hex);
     }
@@ -99,7 +92,6 @@ function hexToRgb(hex) {
     var b = (hex & 255) / 255;
     return [r, g, b];
 }
-exports.hexToRgb = hexToRgb;
 /**
  * Lighten a color
  *
@@ -107,7 +99,7 @@ exports.hexToRgb = hexToRgb;
  * @param {number} [amount=0] Amount of the color offset
  * @returns {string} Computed hexadecimal
  */
-function lighten(hex, amount) {
+export function lighten(hex, amount) {
     if (amount === void 0) { amount = 0; }
     var prefix = '';
     if (hex[0] === '#') {
@@ -115,16 +107,15 @@ function lighten(hex, amount) {
         prefix = '#';
     }
     var value = parseInt(hex, 16);
-    var r = (0, maths_1.clamp)((value >> 16) + amount, 0, 255);
-    var b = (0, maths_1.clamp)(((value >> 8) & 0x00ff) + amount, 0, 255);
-    var g = (0, maths_1.clamp)((value & 0x0000ff) + amount, 0, 255);
+    var r = clamp((value >> 16) + amount, 0, 255);
+    var b = clamp(((value >> 8) & 0x00ff) + amount, 0, 255);
+    var g = clamp((value & 0x0000ff) + amount, 0, 255);
     var result = g | (b << 8) | (r << 16);
     if (r === 0 && g === 0 && b === 0 && amount !== 0) {
         result = '000000';
     }
     return prefix + result.toString(16);
 }
-exports.lighten = lighten;
 /**
  * Darken a color
  *
@@ -132,11 +123,10 @@ exports.lighten = lighten;
  * @param {number} [amount=0] Amount of the color offset
  * @returns {string} Computed hexadecimal
  */
-function darken(hex, amount) {
+export function darken(hex, amount) {
     if (amount === void 0) { amount = 0; }
     return lighten(hex, -amount);
 }
-exports.darken = darken;
 // ***************************************************
 // RGB & Hue-Saturation-Lightness (HSL) color spaces
 // ***************************************************
@@ -147,12 +137,11 @@ exports.darken = darken;
  * @param  {string} hsl HSL string (format: 'hsl(360, 100%, 100%)')
  * @returns {[number, number, number]} Normalized HSL color
  */
-function normalizeHslString(hsl) {
+export function normalizeHslString(hsl) {
     var _a, _b;
     var _c = (_b = (_a = hsl.match(/\d+/g)) === null || _a === void 0 ? void 0 : _a.map(Number)) !== null && _b !== void 0 ? _b : [0, 0, 0], h = _c[0], s = _c[1], l = _c[2];
     return [h, s / 100, l / 100];
 }
-exports.normalizeHslString = normalizeHslString;
 /**
  * Convert RGB to HSL
  * Notes:
@@ -162,7 +151,7 @@ exports.normalizeHslString = normalizeHslString;
  * @param  {[number, number, number]} rgb RGB color
  * @returns {[number, number, number]} HSL color
  */
-function rgbToHsl(_a) {
+export function rgbToHsl(_a) {
     var r = _a[0], g = _a[1], b = _a[2];
     var l = Math.max(r, g, b);
     var s = l - Math.min(r, g, b);
@@ -173,7 +162,6 @@ function rgbToHsl(_a) {
         (2 * l - s) / 2
     ];
 }
-exports.rgbToHsl = rgbToHsl;
 /**
  * Convert HSL to RGB
  * Notes:
@@ -183,14 +171,13 @@ exports.rgbToHsl = rgbToHsl;
  * @param  {[number, number, number]} hsl HSL color
  * @returns {[number, number, number]} RGB color
  */
-function hslToRgb(_a) {
+export function hslToRgb(_a) {
     var h = _a[0], s = _a[1], l = _a[2];
     var a = s * Math.min(l, 1 - l);
     var k = function (v) { return (v + h / 30) % 12; };
     var f = function (v) { return l - a * Math.max(-1, Math.min(k(v) - 3, Math.min(9 - k(v), 1))); };
     return [f(0), f(8), f(4)];
 }
-exports.hslToRgb = hslToRgb;
 // ***************************************************
 // RGB & Hue-Saturation-Brightness (HSB) color spaces
 // ***************************************************
@@ -203,7 +190,7 @@ exports.hslToRgb = hslToRgb;
  * @param  {[number, number, number]} rgb RGB color
  * @returns {[number, number, number]} HSB color
  */
-function rgbToHsb(_a) {
+export function rgbToHsb(_a) {
     var r = _a[0], g = _a[1], b = _a[2];
     var max = Math.max(r, g, b);
     var min = Math.min(r, g, b);
@@ -211,7 +198,6 @@ function rgbToHsb(_a) {
     var h = delta === 0 ? 0 : delta && max === r ? (g - b) / delta : max === g ? 2 + (b - r) / delta : 4 + (r - g) / delta;
     return [60 * (h < 0 ? h + 6 : h), max && delta / max, max];
 }
-exports.rgbToHsb = rgbToHsb;
 /**
  * Convert HSB to RGB
  * Notes:
@@ -221,13 +207,12 @@ exports.rgbToHsb = rgbToHsb;
  * @param  {[number, number, number]} hsb HSB color
  * @returns {[number, number, number]} RGB color
  */
-function hsbToRgb(_a) {
+export function hsbToRgb(_a) {
     var h = _a[0], s = _a[1], b = _a[2];
     var k = function (v) { return (v + h / 60) % 6; };
     var f = function (v) { return b * (1 - s * Math.max(0, Math.min(k(v), 4 - k(v), 1))); };
     return [f(5), f(3), f(1)];
 }
-exports.hsbToRgb = hsbToRgb;
 // *********************************************
 // LAB & Hue-Chroma-Luminance (HCL) color spaces
 // *********************************************
@@ -238,13 +223,12 @@ exports.hsbToRgb = hsbToRgb;
  * @param {[number, number, number]} lab LAB color
  * @returns {[number, number, number]} HCL color
  */
-function labToHcl(_a) {
+export function labToHcl(_a) {
     var l = _a[0], a = _a[1], b = _a[2];
     var c = Math.sqrt(a * a + b * b);
     var h = abToHue(a, b);
     return [h, c, l];
 }
-exports.labToHcl = labToHcl;
 /**
  * Convert HCL to LAB
  * -> http://www.brucelindbloom.com/index.html?Eqn_LCH_to_Lab.html
@@ -252,13 +236,12 @@ exports.labToHcl = labToHcl;
  * @param {[number, number, number]} hcl HCL color
  * @returns {[number, number, number]} LAB color space
  */
-function hclToLab(_a) {
+export function hclToLab(_a) {
     var h = _a[0], c = _a[1], l = _a[2];
-    var a = c * Math.cos((0, geometry_1.toRadians)(h));
-    var b = c * Math.sin((0, geometry_1.toRadians)(h));
+    var a = c * Math.cos(toRadians(h));
+    var b = c * Math.sin(toRadians(h));
     return [l, a, b];
 }
-exports.hclToLab = hclToLab;
 /**
  * Convert A and B of LAB to Hue of LCH
  * -> https://stackoverflow.com/questions/53733379/conversion-of-cielab-to-cielchab-not-yielding-correct-result
@@ -290,7 +273,7 @@ function abToHue(a, b) {
     else if (a > 0 && b < 0) {
         xBias = 360;
     }
-    return (0, geometry_1.toDegrees)(Math.atan(b / a)) + xBias;
+    return toDegrees(Math.atan(b / a)) + xBias;
 }
 // ******************************************
 // LAB & RGB color spaces
@@ -305,7 +288,7 @@ var f4 = function (v) { return (v > 0.008856 ? Math.pow(v, 1 / 3) : 7.787 * v +
  * @param {[number, number, number]} lab LAB color
  * @returns {[number, number, number]} RGB color
  */
-function labToRgb(_a) {
+export function labToRgb(_a) {
     var l = _a[0], a = _a[1], b = _a[2];
     var y = (l + 16) / 116;
     var x = a / 500 + y;
@@ -314,19 +297,18 @@ function labToRgb(_a) {
     y = 1.0 * f1(y);
     z = 1.08883 * f1(z);
     return [
-        (0, maths_1.clamp)(f2(x * 3.2406 + y * -1.5372 + z * -0.4986)),
-        (0, maths_1.clamp)(f2(x * -0.9689 + y * 1.8758 + z * 0.0415)),
-        (0, maths_1.clamp)(f2(x * 0.0557 + y * -0.204 + z * 1.057))
+        clamp(f2(x * 3.2406 + y * -1.5372 + z * -0.4986)),
+        clamp(f2(x * -0.9689 + y * 1.8758 + z * 0.0415)),
+        clamp(f2(x * 0.0557 + y * -0.204 + z * 1.057))
     ];
 }
-exports.labToRgb = labToRgb;
 /**
  * Converts RGB to LAB
  *
  * @param {[number, number, number]} rgb RGB color
  * @returns {[number, number, number]} LAB color
  */
-function rgbToLab(_a) {
+export function rgbToLab(_a) {
     var r = _a[0], g = _a[1], b = _a[2];
     r = f3(r);
     g = f3(g);
@@ -336,7 +318,6 @@ function rgbToLab(_a) {
     var z = f4((r * 0.0193 + g * 0.1192 + b * 0.9505) / 1.08883);
     return [116 * y - 16, 500 * (x - y), 200 * (y - z)];
 }
-exports.rgbToLab = rgbToLab;
 /**
  * Get the delta from two LAB colors
  *
@@ -344,7 +325,7 @@ exports.rgbToLab = rgbToLab;
  * @param {[number, number, number]} labB Second LAB color
  * @returns {number} Delta
  */
-function deltaE(labA, labB) {
+export function deltaE(labA, labB) {
     var deltaL = labA[0] - labB[0];
     var deltaA = labA[1] - labB[1];
     var deltaB = labA[2] - labB[2];
@@ -361,7 +342,6 @@ function deltaE(labA, labB) {
     var i = deltaLKlsl * deltaLKlsl + deltaCkcsc * deltaCkcsc + deltaHkhsh * deltaHkhsh;
     return i < 0 ? 0 : Math.sqrt(i);
 }
-exports.deltaE = deltaE;
 // *********************************************
 // RGB & Hue-Chroma-Luminance (HCL) color spaces
 // *********************************************
@@ -371,19 +351,17 @@ exports.deltaE = deltaE;
  * @param {[number, number, number]} rgb RGB color
  * @returns {[number, number, number]} HCL color
  */
-function rgbToHcl(_a) {
+export function rgbToHcl(_a) {
     var r = _a[0], g = _a[1], b = _a[2];
     return labToHcl(rgbToLab([r, g, b]));
 }
-exports.rgbToHcl = rgbToHcl;
 /**
  * Converts HCL to RGB
  *
  * @param {[number, number, number]} hcl RGB color
  * @returns {[number, number, number]} RGB color
  */
-function hclToRgb(_a) {
+export function hclToRgb(_a) {
     var h = _a[0], c = _a[1], l = _a[2];
     return labToRgb(hclToLab([h, c, l]));
 }
-exports.hclToRgb = hclToRgb;

package/lib/constants.js

@@ -1,20 +1,17 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.W3CX11 = exports.QUARTER_PI = exports.HALF_PI = exports.TWO_PI = exports.PI = exports.EPSILON = void 0;
 // *********************
 // Maths
 // *********************
-exports.EPSILON = 1e-10;
-exports.PI = Math.PI;
-exports.TWO_PI = Math.PI * 2;
-exports.HALF_PI = Math.PI / 2;
-exports.QUARTER_PI = Math.PI / 4;
+export var EPSILON = 1e-10;
+export var PI = Math.PI;
+export var TWO_PI = Math.PI * 2;
+export var HALF_PI = Math.PI / 2;
+export var QUARTER_PI = Math.PI / 4;
 // *********************
 // Colors
 // *********************
 // X11 colors
 // -> https://www.w3.org/TR/css-color-3/#svg-color
-exports.W3CX11 = {
+export var W3CX11 = {
     aliceblue: 0xf0f8ff,
     antiquewhite: 0xfaebd7,
     aqua: 0x00ffff,

package/lib/dom.d.ts

@@ -2,15 +2,15 @@
  * Find the closest parent that matches a selector
  *
  * @param {Element|null}     element  Target element
- * @param {(Element|string)} selector Selector or parent to match
+ * @param {Element|string} selector Selector or parent to match
  * @returns {Element|null}
  */
 export declare function closest(element: Element | null, selector: Element | string): Element | null;
 /**
  * Create a canvas and 2d context
  *
- * @param {Number} width  Width of the canvas
- * @param {Number} height Height of the canvas
+ * @param {number} width  Width of the canvas
+ * @param {number} height Height of the canvas
  * @returns {{ canvas: HTMLCanvasElement, ctx: CanvasRenderingContext2D }}
  */
 export declare function createCanvas(width: number, height: number): {

package/lib/dom.js

@@ -1,15 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.injectStyles = exports.createCanvas = exports.closest = void 0;
 var DOCUMENT_NODE_TYPE = 9;
 /**
  * Find the closest parent that matches a selector
  *
  * @param {Element|null}     element  Target element
- * @param {(Element|string)} selector Selector or parent to match
+ * @param {Element|string} selector Selector or parent to match
  * @returns {Element|null}
  */
-function closest(element, selector) {
+export function closest(element, selector) {
     var current = element;
     while (current && current.nodeType !== DOCUMENT_NODE_TYPE) {
         if ((typeof selector === 'string' && current.matches(selector)) || current === selector) {
@@ -19,15 +16,14 @@ function closest(element, selector) {
     }
     return current;
 }
-exports.closest = closest;
 /**
  * Create a canvas and 2d context
  *
- * @param {Number} width  Width of the canvas
- * @param {Number} height Height of the canvas
+ * @param {number} width  Width of the canvas
+ * @param {number} height Height of the canvas
  * @returns {{ canvas: HTMLCanvasElement, ctx: CanvasRenderingContext2D }}
  */
-function createCanvas(width, height) {
+export function createCanvas(width, height) {
     var _a;
     var canvas = document.createElement('canvas');
     canvas.width = width;
@@ -35,13 +31,12 @@ function createCanvas(width, height) {
     var ctx = (_a = canvas.getContext('2d')) !== null && _a !== void 0 ? _a : new CanvasRenderingContext2D();
     return { canvas: canvas, ctx: ctx };
 }
-exports.createCanvas = createCanvas;
 /**
  * Inject CSS styles in `document.head`
  *
  * @param {string} styles CSS styles to inject
  */
-function injectStyles(styles) {
+export function injectStyles(styles) {
     var $style = document.createElement('style');
     $style.innerHTML = styles;
     var $before = document.querySelector('head link[rel=stylesheet], head style');
@@ -50,4 +45,3 @@ function injectStyles(styles) {
     else
         document.head.appendChild($style);
 }
-exports.injectStyles = injectStyles;

package/lib/files.js

@@ -1,13 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.upload = exports.download = void 0;
 /**
  * Download a Blob object into user files
  *
  * @param {Blob} blob       Blob object to download
  * @param {string} filename Downloaded file name
  */
-function download(blob, filename) {
+export function download(blob, filename) {
     var link = document.createElement('a');
     link.setAttribute('href', URL.createObjectURL(blob));
     link.setAttribute('download', filename);
@@ -15,14 +12,13 @@ function download(blob, filename) {
     link.click();
     document.body.removeChild(link);
 }
-exports.download = download;
 /**
  * Upload a file from user files
  *
  * @param {Function} onLoad    Callback called once the file is loaded
  * @param {string} [accept=''] MIME type the file input should accept
  */
-function upload(onLoad, accept) {
+export function upload(onLoad, accept) {
     if (accept === void 0) { accept = ''; }
     var input = document.createElement('input');
     input.setAttribute('type', 'file');
@@ -40,4 +36,3 @@ function upload(onLoad, accept) {
     input.click();
     document.body.removeChild(input);
 }
-exports.upload = upload;

package/lib/functions.js

@@ -1,22 +1,17 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.now = exports.defer = exports.throttle = exports.debounce = exports.wait = exports.noop = void 0;
 /**
  * No-op function
  */
-var noop = function () { };
-exports.noop = noop;
+export var noop = function () { };
 /**
  * Promise wrapped setTimeout
  *
  * @param {number} [delay=0] Time to wait (in milliseconds)
  * @returns {Promise}
  */
-function wait(delay) {
+export function wait(delay) {
     if (delay === void 0) { delay = 0; }
     return new Promise(function (resolve) { return setTimeout(resolve, delay); });
 }
-exports.wait = wait;
 /**
  * Create a debounced function that delays the execution of `callback` until a specified `delay` time has passed since the last call
  *
@@ -24,7 +19,7 @@ exports.wait = wait;
  * @param {number} delay      Delay (in milliseconds)
  * @returns {Function} Debounced function
  */
-function debounce(callback, delay) {
+export function debounce(callback, delay) {
     var timeout = null;
     return function () {
         var args = [];
@@ -36,7 +31,6 @@ function debounce(callback, delay) {
         timeout = setTimeout(function () { return callback.apply(void 0, args); }, delay);
     };
 }
-exports.debounce = debounce;
 /**
  * Create a throttled function that limits the execution of `callback` to once every `limit` time
  *
@@ -44,27 +38,26 @@ exports.debounce = debounce;
  * @param {number} limit      Minimum interval between two calls (in milliseconds)
  * @returns {Function} Throttled function
  */
-function throttle(callback, limit) {
+export function throttle(callback, limit) {
     var lastTime = 0;
     return function () {
         var args = [];
         for (var _i = 0; _i < arguments.length; _i++) {
             args[_i] = arguments[_i];
         }
-        var time = (0, exports.now)();
+        var time = now();
         if (time - lastTime >= limit) {
             lastTime = time;
             callback.apply(void 0, args);
         }
     };
 }
-exports.throttle = throttle;
 /**
  * Deferred promise implementation
  *
  * @returns {Deferred}
  */
-function defer() {
+export function defer() {
     var resolve;
     var reject;
     var promise = new Promise(function (_resolve, _reject) {
@@ -73,10 +66,13 @@ function defer() {
     });
     return { promise: promise, resolve: resolve, reject: reject };
 }
-exports.defer = defer;
+/**
+ * Polyfill for `now()` functions
+ */
+export var now;
 // In node.js, use `process.hrtime`
 if (typeof process !== 'undefined' && process.hrtime) {
-    exports.now = function () {
+    now = function () {
         // Convert [seconds, nanoseconds] to milliseconds
         var time = process.hrtime();
         return time[0] * 1000 + time[1] / 1000000;
@@ -85,13 +81,13 @@ if (typeof process !== 'undefined' && process.hrtime) {
 // In a browser use `performance` or `Date`
 else if (typeof performance !== 'undefined') {
     // This must be bound, because directly assigning this function leads to an invocation exception in Chrome
-    exports.now = performance.now.bind(performance);
+    now = performance.now.bind(performance);
 }
 else if (typeof Date.now !== 'undefined') {
-    exports.now = Date.now;
+    now = Date.now;
 }
 else {
-    exports.now = function () {
+    now = function () {
         return new Date().getTime();
     };
 }

package/lib/geometry.d.ts

@@ -1,4 +1,4 @@
-import { Vector3 } from './types';
+import type { Vector3 } from './types';
 /**
  * Convert a radians value into degrees
  *