toosoon-utils 1.0.0

package/lib/constants.js

@@ -0,0 +1,173 @@
+"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;
+// *********************
+// Color
+// *********************
+// X11 colors
+// -> https://www.w3.org/TR/css-color-3/#svg-color
+exports.W3CX11 = {
+    aliceblue: '#f0f8ff',
+    antiquewhite: '#faebd7',
+    aqua: '#00ffff',
+    aquamarine: '#7fffd4',
+    azure: '#f0ffff',
+    beige: '#f5f5dc',
+    bisque: '#ffe4c4',
+    black: '#000000',
+    blanchedalmond: '#ffebcd',
+    blue: '#0000ff',
+    blueviolet: '#8a2be2',
+    brown: '#a52a2a',
+    burlywood: '#deb887',
+    cadetblue: '#5f9ea0',
+    chartreuse: '#7fff00',
+    chocolate: '#d2691e',
+    coral: '#ff7f50',
+    cornflower: '#6495ed',
+    cornflowerblue: '#6495ed',
+    cornsilk: '#fff8dc',
+    crimson: '#dc143c',
+    cyan: '#00ffff',
+    darkblue: '#00008b',
+    darkcyan: '#008b8b',
+    darkgoldenrod: '#b8860b',
+    darkgray: '#a9a9a9',
+    darkgreen: '#006400',
+    darkgrey: '#a9a9a9',
+    darkkhaki: '#bdb76b',
+    darkmagenta: '#8b008b',
+    darkolivegreen: '#556b2f',
+    darkorange: '#ff8c00',
+    darkorchid: '#9932cc',
+    darkred: '#8b0000',
+    darksalmon: '#e9967a',
+    darkseagreen: '#8fbc8f',
+    darkslateblue: '#483d8b',
+    darkslategray: '#2f4f4f',
+    darkslategrey: '#2f4f4f',
+    darkturquoise: '#00ced1',
+    darkviolet: '#9400d3',
+    deeppink: '#ff1493',
+    deepskyblue: '#00bfff',
+    dimgray: '#696969',
+    dimgrey: '#696969',
+    dodgerblue: '#1e90ff',
+    firebrick: '#b22222',
+    floralwhite: '#fffaf0',
+    forestgreen: '#228b22',
+    fuchsia: '#ff00ff',
+    gainsboro: '#dcdcdc',
+    ghostwhite: '#f8f8ff',
+    gold: '#ffd700',
+    goldenrod: '#daa520',
+    gray: '#808080',
+    green: '#008000',
+    greenyellow: '#adff2f',
+    grey: '#808080',
+    honeydew: '#f0fff0',
+    hotpink: '#ff69b4',
+    indianred: '#cd5c5c',
+    indigo: '#4b0082',
+    ivory: '#fffff0',
+    khaki: '#f0e68c',
+    laserlemon: '#ffff54',
+    lavender: '#e6e6fa',
+    lavenderblush: '#fff0f5',
+    lawngreen: '#7cfc00',
+    lemonchiffon: '#fffacd',
+    lightblue: '#add8e6',
+    lightcoral: '#f08080',
+    lightcyan: '#e0ffff',
+    lightgoldenrod: '#fafad2',
+    lightgoldenrodyellow: '#fafad2',
+    lightgray: '#d3d3d3',
+    lightgreen: '#90ee90',
+    lightgrey: '#d3d3d3',
+    lightpink: '#ffb6c1',
+    lightsalmon: '#ffa07a',
+    lightseagreen: '#20b2aa',
+    lightskyblue: '#87cefa',
+    lightslategray: '#778899',
+    lightslategrey: '#778899',
+    lightsteelblue: '#b0c4de',
+    lightyellow: '#ffffe0',
+    lime: '#00ff00',
+    limegreen: '#32cd32',
+    linen: '#faf0e6',
+    magenta: '#ff00ff',
+    maroon: '#800000',
+    maroon2: '#7f0000',
+    maroon3: '#b03060',
+    mediumaquamarine: '#66cdaa',
+    mediumblue: '#0000cd',
+    mediumorchid: '#ba55d3',
+    mediumpurple: '#9370db',
+    mediumseagreen: '#3cb371',
+    mediumslateblue: '#7b68ee',
+    mediumspringgreen: '#00fa9a',
+    mediumturquoise: '#48d1cc',
+    mediumvioletred: '#c71585',
+    midnightblue: '#191970',
+    mintcream: '#f5fffa',
+    mistyrose: '#ffe4e1',
+    moccasin: '#ffe4b5',
+    navajowhite: '#ffdead',
+    navy: '#000080',
+    oldlace: '#fdf5e6',
+    olive: '#808000',
+    olivedrab: '#6b8e23',
+    orange: '#ffa500',
+    orangered: '#ff4500',
+    orchid: '#da70d6',
+    palegoldenrod: '#eee8aa',
+    palegreen: '#98fb98',
+    paleturquoise: '#afeeee',
+    palevioletred: '#db7093',
+    papayawhip: '#ffefd5',
+    peachpuff: '#ffdab9',
+    peru: '#cd853f',
+    pink: '#ffc0cb',
+    plum: '#dda0dd',
+    powderblue: '#b0e0e6',
+    purple: '#800080',
+    purple2: '#7f007f',
+    purple3: '#a020f0',
+    rebeccapurple: '#663399',
+    red: '#ff0000',
+    rosybrown: '#bc8f8f',
+    royalblue: '#4169e1',
+    saddlebrown: '#8b4513',
+    salmon: '#fa8072',
+    sandybrown: '#f4a460',
+    seagreen: '#2e8b57',
+    seashell: '#fff5ee',
+    sienna: '#a0522d',
+    silver: '#c0c0c0',
+    skyblue: '#87ceeb',
+    slateblue: '#6a5acd',
+    slategray: '#708090',
+    slategrey: '#708090',
+    snow: '#fffafa',
+    springgreen: '#00ff7f',
+    steelblue: '#4682b4',
+    tan: '#d2b48c',
+    teal: '#008080',
+    thistle: '#d8bfd8',
+    tomato: '#ff6347',
+    turquoise: '#40e0d0',
+    violet: '#ee82ee',
+    wheat: '#f5deb3',
+    white: '#ffffff',
+    whitesmoke: '#f5f5f5',
+    yellow: '#ffff00',
+    yellowgreen: '#9acd32'
+};

package/lib/dom.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Find the closest parent that matches a selector
+ *
+ * @param {Element}          element  Target element
+ * @param {(Element|string)} selector Selector or parent to match
+ * @returns {Element|null}
+ */
+export declare function closest(element: Element, 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
+ * @returns {{ canvas: HTMLCanvasElement, ctx: CanvasRenderingContext2D }}
+ */
+export declare function createCanvas(width: number, height: number): {
+    canvas: HTMLCanvasElement;
+    ctx: CanvasRenderingContext2D;
+};
+/**
+ * Inject CSS style in `document.head`
+ *
+ * @param {string} cssContent CSS style to inject
+ */
+export declare function injectStyles(cssContent: string): void;

package/lib/dom.js

@@ -0,0 +1,53 @@
+"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}          element  Target element
+ * @param {(Element|string)} selector Selector or parent to match
+ * @returns {Element|null}
+ */
+function closest(element, selector) {
+    var current = element;
+    while (current && current.nodeType !== DOCUMENT_NODE_TYPE) {
+        if ((typeof selector === 'string' && current.matches(selector)) || current === selector) {
+            return current;
+        }
+        current = element.parentNode;
+    }
+    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
+ * @returns {{ canvas: HTMLCanvasElement, ctx: CanvasRenderingContext2D }}
+ */
+function createCanvas(width, height) {
+    var _a;
+    var canvas = document.createElement('canvas');
+    canvas.width = width;
+    canvas.height = height;
+    var ctx = (_a = canvas.getContext('2d')) !== null && _a !== void 0 ? _a : new CanvasRenderingContext2D();
+    return { canvas: canvas, ctx: ctx };
+}
+exports.createCanvas = createCanvas;
+/**
+ * Inject CSS style in `document.head`
+ *
+ * @param {string} cssContent CSS style to inject
+ */
+function injectStyles(cssContent) {
+    var $style = document.createElement('style');
+    $style.innerHTML = cssContent;
+    var $before = document.querySelector('head link[rel=stylesheet], head style');
+    if ($before)
+        document.head.insertBefore($style, $before);
+    else
+        document.head.appendChild($style);
+}
+exports.injectStyles = injectStyles;

package/lib/files.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Download a Blob object into user files
+ *
+ * @param {Blob} blob       Blob object to download
+ * @param {string} filename Downloaded file name
+ */
+export declare function download(blob: Blob, filename: string): void;
+/**
+ * Upload a file from user files
+ *
+ * @param {Function} onLoad    Callback called once the file is loaded
+ * @param {string} [accept=''] Types the file input should accept
+ */
+export declare function upload(onLoad: (dataUrl: string) => void, accept?: string): void;

package/lib/files.js

@@ -0,0 +1,43 @@
+"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) {
+    var link = document.createElement('a');
+    link.setAttribute('href', URL.createObjectURL(blob));
+    link.setAttribute('download', filename);
+    document.body.appendChild(link);
+    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=''] Types the file input should accept
+ */
+function upload(onLoad, accept) {
+    if (accept === void 0) { accept = ''; }
+    var input = document.createElement('input');
+    input.setAttribute('type', 'file');
+    input.setAttribute('accept', accept);
+    input.addEventListener('change', function (event) {
+        var _a, _b;
+        var file = (_b = (_a = event.target) === null || _a === void 0 ? void 0 : _a.files) === null || _b === void 0 ? void 0 : _b[0];
+        if (file) {
+            var fileReader = new FileReader();
+            fileReader.addEventListener('load', function () { return onLoad(URL.createObjectURL(file)); });
+            fileReader.readAsDataURL(file);
+        }
+    });
+    document.body.appendChild(input);
+    input.click();
+    document.body.removeChild(input);
+}
+exports.upload = upload;

package/lib/functions.d.ts

@@ -0,0 +1,18 @@
+import { Deferred } from './types';
+/**
+ * No-op function
+ */
+export declare const noop: () => void;
+/**
+ * Promise wrapped setTimeout
+ *
+ * @param {number} timeout Time in ms
+ * @returns {Promise}
+ */
+export declare function wait(timeout: number): Promise<void>;
+/**
+ * Deferred promise implementation
+ *
+ * @returns {Deferred}
+ */
+export declare function defer<T = void>(): Deferred<T>;

package/lib/functions.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defer = exports.wait = exports.noop = void 0;
+/**
+ * No-op function
+ */
+var noop = function () { };
+exports.noop = noop;
+/**
+ * Promise wrapped setTimeout
+ *
+ * @param {number} timeout Time in ms
+ * @returns {Promise}
+ */
+function wait(timeout) {
+    return new Promise(function (resolve) { return setTimeout(resolve, timeout); });
+}
+exports.wait = wait;
+/**
+ * Deferred promise implementation
+ *
+ * @returns {Deferred}
+ */
+function defer() {
+    var resolve;
+    var reject;
+    var promise = new Promise(function (_resolve, _reject) {
+        resolve = _resolve;
+        reject = _reject;
+    });
+    return { promise: promise, resolve: resolve, reject: reject };
+}
+exports.defer = defer;

package/lib/geometry.d.ts

@@ -0,0 +1,89 @@
+import { Vector3 } from './types';
+/**
+ * Convert a radians value into degrees
+ *
+ * @param {number} radians Angle in radians
+ * @returns {number} Angle in degrees
+ */
+export declare function toDegrees(radians: number): number;
+/**
+ * Convert a degrees value into radians
+ *
+ * @param {number} degrees Angle in degrees
+ * @returns {number} Angle in radians
+ */
+export declare function toRadians(degrees: number): number;
+/**
+ * Calculate the angle from a point to another
+ *
+ * @param  {number} x1 X value of the first point
+ * @param  {number} y1 Y value of the first point
+ * @param  {number} x2 X value of the second point
+ * @param  {number} y2 Y value of the second point
+ * @returns {number} Angle
+ */
+export declare function angle(x1: number, y1: number, x2: number, y2: number): number;
+/**
+ * Find the closest angle betwween to angles
+ *
+ * @param {number} source Source angle in radians
+ * @param {number} target Target angle in radians
+ * @returns {number} Closest angle
+ */
+export declare function closestAngle(source: number, target: number): number;
+/**
+ * Calculate the distance between two points
+ *
+ * @param {number} x1 X coord of the first point
+ * @param {number} y1 Y coord of the first point
+ * @param {number} x2 X coord of the second point
+ * @param {number} y2 Y coord of the second point
+ * @returns {number} Computed distance
+ */
+export declare function distance(x1: number, y1: number, x2: number, y2: number): number;
+/**
+ * Calculate the length of the diagonal of a rectangle
+ *
+ * @param {number} width  Width of the rectangle
+ * @param {number} height Height of the rectangle
+ * @returns {number} Diagonal length
+ */
+export declare function diagonal(width: number, height: number): number;
+/**
+ * Convert radians to a 3D point on the surface of a unit sphere
+ *
+ * @param  {number} radius  Radius of the sphere
+ * @param  {number} phi     Polar angle from the y (up) axis     : 0 to PI
+ * @param  {number} theta   Equator angle around the y (up) axis : 0 to 2 PI
+ * @param  {Vector3} target Target vector
+ * @returns {Vector3}
+ */
+export declare function radToSphere(radius: number, phi: number, theta: number, target?: Vector3): Vector3;
+interface FitInput {
+    width: number;
+    height: number;
+}
+interface FitOutput {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    scale: number;
+}
+/**
+ * Make a target fit a container (cover mode)
+ *
+ * @param {FitInput} target    Dimension of the target
+ * @param {FitInput} container Dimension of the container
+ * @returns {FitOutput}
+ */
+export declare function cover(target: FitInput, container: FitInput): FitOutput;
+/**
+ * Make a target fit a container (contain mode)
+ *
+ * @param {FitInput} target    Dimension of the target
+ * @param {FitInput} container Dimension of the container
+ * @returns {FitOutput}
+ */
+export declare function contain(target: FitInput, container: FitInput): FitOutput;
+export {};

package/lib/geometry.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contain = exports.cover = exports.radToSphere = exports.diagonal = exports.distance = exports.closestAngle = exports.angle = exports.toRadians = exports.toDegrees = void 0;
+var constants_1 = require("./constants");
+/**
+ * Convert a radians value into degrees
+ *
+ * @param {number} radians Angle in radians
+ * @returns {number} Angle in degrees
+ */
+function toDegrees(radians) {
+    return (radians * 180) / constants_1.PI;
+}
+exports.toDegrees = toDegrees;
+/**
+ * Convert a degrees value into radians
+ *
+ * @param {number} degrees Angle in degrees
+ * @returns {number} Angle in radians
+ */
+function toRadians(degrees) {
+    return (degrees * constants_1.PI) / 180;
+}
+exports.toRadians = toRadians;
+/**
+ * Calculate the angle from a point to another
+ *
+ * @param  {number} x1 X value of the first point
+ * @param  {number} y1 Y value of the first point
+ * @param  {number} x2 X value of the second point
+ * @param  {number} y2 Y value of the second point
+ * @returns {number} Angle
+ */
+function angle(x1, y1, x2, y2) {
+    return Math.atan2(y2 - y1, x2 - x1);
+}
+exports.angle = angle;
+/**
+ * Find the closest angle betwween to angles
+ *
+ * @param {number} source Source angle in radians
+ * @param {number} target Target angle in radians
+ * @returns {number} Closest angle
+ */
+function closestAngle(source, target) {
+    var delta = target - source;
+    return delta > constants_1.PI ? target - 2 * constants_1.PI : target < -constants_1.PI ? delta + 2 * constants_1.PI : target;
+}
+exports.closestAngle = closestAngle;
+/**
+ * Calculate the distance between two points
+ *
+ * @param {number} x1 X coord of the first point
+ * @param {number} y1 Y coord of the first point
+ * @param {number} x2 X coord of the second point
+ * @param {number} y2 Y coord of the second point
+ * @returns {number} Computed distance
+ */
+function distance(x1, y1, x2, y2) {
+    var dx = x1 - x2;
+    var dy = y1 - y2;
+    return Math.sqrt(dx * dx + dy * dy);
+}
+exports.distance = distance;
+/**
+ * Calculate the length of the diagonal of a rectangle
+ *
+ * @param {number} width  Width of the rectangle
+ * @param {number} height Height of the rectangle
+ * @returns {number} Diagonal length
+ */
+function diagonal(width, height) {
+    return Math.sqrt(width * width + height * height);
+}
+exports.diagonal = diagonal;
+/**
+ * Convert radians to a 3D point on the surface of a unit sphere
+ *
+ * @param  {number} radius  Radius of the sphere
+ * @param  {number} phi     Polar angle from the y (up) axis     : 0 to PI
+ * @param  {number} theta   Equator angle around the y (up) axis : 0 to 2 PI
+ * @param  {Vector3} target Target vector
+ * @returns {Vector3}
+ */
+function radToSphere(radius, phi, theta, target) {
+    if (target === void 0) { target = { x: 0, y: 0, z: 0 }; }
+    target.x = radius * Math.sin(phi) * Math.sin(theta);
+    target.y = radius * Math.cos(phi);
+    target.z = radius * Math.sin(phi) * Math.cos(theta);
+    return target;
+}
+exports.radToSphere = radToSphere;
+/**
+ * Make a target fit a container
+ *
+ * @param {FitInput} target    Dimension of the target
+ * @param {FitInput} container Dimension of the container
+ * @param {string} mode        Can be 'contain' | 'cover'
+ * @returns {FitOutput}
+ */
+function fit(target, container, mode) {
+    var ratioWidth = container.width / target.width;
+    var ratioHeight = container.height / target.height;
+    var scale;
+    if (mode === 'contain') {
+        scale = ratioWidth < ratioHeight ? ratioWidth : ratioHeight;
+    }
+    else {
+        scale = ratioWidth > ratioHeight ? ratioWidth : ratioHeight;
+    }
+    return {
+        left: (container.width - target.width * scale) >> 1,
+        top: (container.height - target.height * scale) >> 1,
+        width: target.width * scale,
+        height: target.height * scale,
+        scale: scale
+    };
+}
+/**
+ * Make a target fit a container (cover mode)
+ *
+ * @param {FitInput} target    Dimension of the target
+ * @param {FitInput} container Dimension of the container
+ * @returns {FitOutput}
+ */
+function cover(target, container) {
+    return fit(target, container, 'cover');
+}
+exports.cover = cover;
+/**
+ * Make a target fit a container (contain mode)
+ *
+ * @param {FitInput} target    Dimension of the target
+ * @param {FitInput} container Dimension of the container
+ * @returns {FitOutput}
+ */
+function contain(target, container) {
+    return fit(target, container, 'contain');
+}
+exports.contain = contain;

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+export * from './colors';
+export * from './dom';
+export * from './files';
+export * from './functions';
+export * from './geometry';
+export * from './maths';
+export * from './now';
+export * from './random';
+export * from './strings';
+export * from './constants';
+export * from './types';

package/lib/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./colors"), exports);
+__exportStar(require("./dom"), exports);
+__exportStar(require("./files"), exports);
+__exportStar(require("./functions"), exports);
+__exportStar(require("./geometry"), exports);
+__exportStar(require("./maths"), exports);
+__exportStar(require("./now"), exports);
+__exportStar(require("./random"), exports);
+__exportStar(require("./strings"), exports);
+__exportStar(require("./constants"), exports);
+__exportStar(require("./types"), exports);