toosoon-utils 1.4.0 → 2.0.0

package/src/constants.ts

@@ -1,172 +0,0 @@
-// *********************
-// Maths
-// *********************
-export const EPSILON = 1e-10;
-export const PI = Math.PI;
-export const TWO_PI = Math.PI * 2;
-export const HALF_PI = Math.PI / 2;
-export const QUARTER_PI = Math.PI / 4;
-
-// *********************
-// Colors
-// *********************
-
-// X11 colors
-// -> https://www.w3.org/TR/css-color-3/#svg-color
-export const W3CX11 = {
-  aliceblue: 0xf0f8ff,
-  antiquewhite: 0xfaebd7,
-  aqua: 0x00ffff,
-  aquamarine: 0x7fffd4,
-  azure: 0xf0ffff,
-  beige: 0xf5f5dc,
-  bisque: 0xffe4c4,
-  black: 0x000000,
-  blanchedalmond: 0xffebcd,
-  blue: 0x0000ff,
-  blueviolet: 0x8a2be2,
-  brown: 0xa52a2a,
-  burlywood: 0xdeb887,
-  cadetblue: 0x5f9ea0,
-  chartreuse: 0x7fff00,
-  chocolate: 0xd2691e,
-  coral: 0xff7f50,
-  cornflower: 0x6495ed,
-  cornflowerblue: 0x6495ed,
-  cornsilk: 0xfff8dc,
-  crimson: 0xdc143c,
-  cyan: 0x00ffff,
-  darkblue: 0x00008b,
-  darkcyan: 0x008b8b,
-  darkgoldenrod: 0xb8860b,
-  darkgray: 0xa9a9a9,
-  darkgreen: 0x006400,
-  darkgrey: 0xa9a9a9,
-  darkkhaki: 0xbdb76b,
-  darkmagenta: 0x8b008b,
-  darkolivegreen: 0x556b2f,
-  darkorange: 0xff8c00,
-  darkorchid: 0x9932cc,
-  darkred: 0x8b0000,
-  darksalmon: 0xe9967a,
-  darkseagreen: 0x8fbc8f,
-  darkslateblue: 0x483d8b,
-  darkslategray: 0x2f4f4f,
-  darkslategrey: 0x2f4f4f,
-  darkturquoise: 0x00ced1,
-  darkviolet: 0x9400d3,
-  deeppink: 0xff1493,
-  deepskyblue: 0x00bfff,
-  dimgray: 0x696969,
-  dimgrey: 0x696969,
-  dodgerblue: 0x1e90ff,
-  firebrick: 0xb22222,
-  floralwhite: 0xfffaf0,
-  forestgreen: 0x228b22,
-  fuchsia: 0xff00ff,
-  gainsboro: 0xdcdcdc,
-  ghostwhite: 0xf8f8ff,
-  gold: 0xffd700,
-  goldenrod: 0xdaa520,
-  gray: 0x808080,
-  green: 0x008000,
-  greenyellow: 0xadff2f,
-  grey: 0x808080,
-  honeydew: 0xf0fff0,
-  hotpink: 0xff69b4,
-  indianred: 0xcd5c5c,
-  indigo: 0x4b0082,
-  ivory: 0xfffff0,
-  khaki: 0xf0e68c,
-  laserlemon: 0xffff54,
-  lavender: 0xe6e6fa,
-  lavenderblush: 0xfff0f5,
-  lawngreen: 0x7cfc00,
-  lemonchiffon: 0xfffacd,
-  lightblue: 0xadd8e6,
-  lightcoral: 0xf08080,
-  lightcyan: 0xe0ffff,
-  lightgoldenrod: 0xfafad2,
-  lightgoldenrodyellow: 0xfafad2,
-  lightgray: 0xd3d3d3,
-  lightgreen: 0x90ee90,
-  lightgrey: 0xd3d3d3,
-  lightpink: 0xffb6c1,
-  lightsalmon: 0xffa07a,
-  lightseagreen: 0x20b2aa,
-  lightskyblue: 0x87cefa,
-  lightslategray: 0x778899,
-  lightslategrey: 0x778899,
-  lightsteelblue: 0xb0c4de,
-  lightyellow: 0xffffe0,
-  lime: 0x00ff00,
-  limegreen: 0x32cd32,
-  linen: 0xfaf0e6,
-  magenta: 0xff00ff,
-  maroon: 0x800000,
-  maroon2: 0x7f0000,
-  maroon3: 0xb03060,
-  mediumaquamarine: 0x66cdaa,
-  mediumblue: 0x0000cd,
-  mediumorchid: 0xba55d3,
-  mediumpurple: 0x9370db,
-  mediumseagreen: 0x3cb371,
-  mediumslateblue: 0x7b68ee,
-  mediumspringgreen: 0x00fa9a,
-  mediumturquoise: 0x48d1cc,
-  mediumvioletred: 0xc71585,
-  midnightblue: 0x191970,
-  mintcream: 0xf5fffa,
-  mistyrose: 0xffe4e1,
-  moccasin: 0xffe4b5,
-  navajowhite: 0xffdead,
-  navy: 0x000080,
-  oldlace: 0xfdf5e6,
-  olive: 0x808000,
-  olivedrab: 0x6b8e23,
-  orange: 0xffa500,
-  orangered: 0xff4500,
-  orchid: 0xda70d6,
-  palegoldenrod: 0xeee8aa,
-  palegreen: 0x98fb98,
-  paleturquoise: 0xafeeee,
-  palevioletred: 0xdb7093,
-  papayawhip: 0xffefd5,
-  peachpuff: 0xffdab9,
-  peru: 0xcd853f,
-  pink: 0xffc0cb,
-  plum: 0xdda0dd,
-  powderblue: 0xb0e0e6,
-  purple: 0x800080,
-  purple2: 0x7f007f,
-  purple3: 0xa020f0,
-  rebeccapurple: 0x663399,
-  red: 0xff0000,
-  rosybrown: 0xbc8f8f,
-  royalblue: 0x4169e1,
-  saddlebrown: 0x8b4513,
-  salmon: 0xfa8072,
-  sandybrown: 0xf4a460,
-  seagreen: 0x2e8b57,
-  seashell: 0xfff5ee,
-  sienna: 0xa0522d,
-  silver: 0xc0c0c0,
-  skyblue: 0x87ceeb,
-  slateblue: 0x6a5acd,
-  slategray: 0x708090,
-  slategrey: 0x708090,
-  snow: 0xfffafa,
-  springgreen: 0x00ff7f,
-  steelblue: 0x4682b4,
-  tan: 0xd2b48c,
-  teal: 0x008080,
-  thistle: 0xd8bfd8,
-  tomato: 0xff6347,
-  turquoise: 0x40e0d0,
-  violet: 0xee82ee,
-  wheat: 0xf5deb3,
-  white: 0xffffff,
-  whitesmoke: 0xf5f5f5,
-  yellow: 0xffff00,
-  yellowgreen: 0x9acd32
-};

package/src/dom.ts

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

package/src/files.ts

@@ -1,42 +0,0 @@
-type InputChangeEvent = Event & { target: (EventTarget & { files?: FileList }) | null };
-
-/**
- * Download a Blob object into user files
- *
- * @param {Blob} blob       Blob object to download
- * @param {string} filename Downloaded file name
- */
-export function download(blob: Blob, filename: string): void {
-  const link = document.createElement('a');
-  link.setAttribute('href', URL.createObjectURL(blob));
-  link.setAttribute('download', filename);
-
-  document.body.appendChild(link);
-  link.click();
-  document.body.removeChild(link);
-}
-
-/**
- * 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
- */
-export function upload(onLoad: (dataUrl: string) => void, accept: string = ''): void {
-  const input = document.createElement('input');
-  input.setAttribute('type', 'file');
-  input.setAttribute('accept', accept);
-
-  input.addEventListener('change', (event: InputChangeEvent) => {
-    const file = event.target?.files?.[0];
-    if (file) {
-      const fileReader = new FileReader();
-      fileReader.addEventListener('load', () => onLoad(URL.createObjectURL(file)));
-      fileReader.readAsDataURL(file);
-    }
-  });
-
-  document.body.appendChild(input);
-  input.click();
-  document.body.removeChild(input);
-}

package/src/functions.ts

@@ -1,56 +0,0 @@
-import { Deferred } from './types';
-
-/**
- * No-op function
- */
-export const noop: () => void = () => {};
-
-/**
- * Promise wrapped setTimeout
- *
- * @param {number} [timeout=0] Time to wait (in milliseconds)
- * @returns {Promise}
- */
-export function wait(timeout: number = 0): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, timeout));
-}
-
-/**
- * Deferred promise implementation
- *
- * @returns {Deferred}
- */
-export function defer<T = void>(): Deferred<T> {
-  let resolve!: (value: T | PromiseLike<T>) => void;
-  let reject!: (reason?: unknown) => void;
-  const promise = new Promise<T>((_resolve, _reject) => {
-    resolve = _resolve;
-    reject = _reject;
-  });
-  return { promise, resolve, reject };
-}
-
-/**
- * Polyfill for `now()` functions
- */
-export let now: () => number;
-
-// In node.js, use `process.hrtime`
-if (typeof process !== 'undefined' && process.hrtime) {
-  now = function () {
-    // Convert [seconds, nanoseconds] to milliseconds
-    const time = process.hrtime();
-    return time[0] * 1000 + time[1] / 1000000;
-  };
-}
-// 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
-  now = performance.now.bind(performance);
-} else if (typeof Date.now !== 'undefined') {
-  now = Date.now;
-} else {
-  now = function () {
-    return new Date().getTime();
-  };
-}

package/src/geometry.ts

@@ -1,160 +0,0 @@
-import { PI } from './constants';
-import { Vector3 } from './types';
-
-/**
- * Convert a radians value into degrees
- *
- * @param {number} radians Angle in radians
- * @returns {number} Angle in degrees
- */
-export function toDegrees(radians: number): number {
-  return (radians * 180) / PI;
-}
-
-/**
- * Convert a degrees value into radians
- *
- * @param {number} degrees Angle in degrees
- * @returns {number} Angle in radians
- */
-export function toRadians(degrees: number): number {
-  return (degrees * PI) / 180;
-}
-
-/**
- * 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 function angle(x1: number, y1: number, x2: number, y2: number): number {
-  return Math.atan2(y2 - y1, x2 - x1);
-}
-
-/**
- * Find the closest angle between to angles
- *
- * @param {number} source Source angle in radians
- * @param {number} target Target angle in radians
- * @returns {number} Closest angle
- */
-export function closestAngle(source: number, target: number): number {
-  const delta = target - source;
-  return delta > PI ? target - 2 * PI : target < -PI ? delta + 2 * PI : target;
-}
-
-/**
- * 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 function distance(x1: number, y1: number, x2: number, y2: number): number {
-  const dx = x1 - x2;
-  const dy = y1 - y2;
-  return Math.sqrt(dx * dx + dy * dy);
-}
-
-/**
- * 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 function diagonal(width: number, height: number): number {
-  return Math.sqrt(width * width + height * height);
-}
-
-/**
- * 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, PI]
- * @param  {number} theta   Equator angle around the y (up) axis : [0, 2*PI]
- * @param  {Vector3} target Target vector
- * @returns {Vector3}
- */
-export function radToSphere(
-  radius: number,
-  phi: number,
-  theta: number,
-  target: Vector3 = { x: 0, y: 0, z: 0 }
-): Vector3 {
-  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;
-}
-
-// *********************
-// Fit
-// *********************
-interface FitInput {
-  width: number;
-  height: number;
-}
-
-interface FitOutput {
-  left: number;
-  top: number;
-  width: number;
-  height: number;
-  scale: number;
-}
-
-/**
- * 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: FitInput, container: FitInput, mode: 'contain' | 'cover'): FitOutput {
-  const ratioWidth = container.width / target.width;
-  const ratioHeight = container.height / target.height;
-
-  let scale: number;
-  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
-  };
-}
-
-/**
- * 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 function cover(target: FitInput, container: FitInput): FitOutput {
-  return fit(target, container, '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}
- */
-export function contain(target: FitInput, container: FitInput): FitOutput {
-  return fit(target, container, 'contain');
-}