toosoon-utils 1.5.0 → 2.1.0

package/src/random.ts

@@ -1,162 +0,0 @@
-import { radToSphere } from './geometry';
-import { Vector2, Vector3 } from './types';
-
-/**
- * Generate a random boolean (true or false)
- *
- * @param {number} [probability=0.5] Probability to get true
- * @returns {boolean} Either `true` or `false`
- */
-export function randomBoolean(probability: number = 0.5): boolean {
-  return Math.random() < probability;
-}
-
-/**
- * Generate a random sign (1 or -1)
- *
- * @param {number} [probability=0.5] Probability to get 1
- * @returns {number} Either 1 or -1
- */
-export function randomSign(probability: number = 0.5): number {
-  return randomBoolean(probability) ? 1 : -1;
-}
-
-/**
- * Generate a random floating-point number within a specified range
- *
- * @param {number} [min=0]       Minimum boundary
- * @param {number} [max=1]       Maximum boundary
- * @param {number} [precision=2] Number of digits after the decimal point
- * @returns {number} Generated float
- */
-export function randomFloat(min: number = 0, max: number = 1, precision: number = 2): number {
-  return parseFloat(Math.min(min + Math.random() * (max - min), max).toFixed(precision));
-}
-
-/**
- * Generate a random integer number within a specified range
- *
- * @param {number} min Minimum boundary
- * @param {number} max Maximum boundary
- * @returns {number} Generated integer
- */
-export function randomInt(min: number, max: number): number {
-  return Math.floor(Math.random() * (max - min + 1) + min);
-}
-
-/**
- * Generate a random hexadecimal color
- *
- * @returns {string} Generated hexadecimal color
- */
-export function randomHexColor(): string {
-  return '#' + ('00000' + ((Math.random() * (1 << 24)) | 0).toString(16)).slice(-6);
-}
-
-/**
- * Pick a random item from a given array
- *
- * @param {T[]} array Array to pick the item from
- * @returns {T|undefined} Random item picked
- */
-export function randomItem<T = unknown>(array: T[]): T | undefined {
-  if (array.length === 0) return undefined;
-  return array[randomInt(0, array.length - 1)];
-}
-
-/**
- * Pick a random property value from a given object
- *
- * @param {object} object Object to pick the property from
- * @returns {T|undefined} Random item picked
- */
-export function randomObjectProperty<T = unknown>(object: Record<string, T>): T | undefined {
-  const keys = Object.keys(object);
-  const key = randomItem(keys);
-  if (key && object.hasOwnProperty(key)) {
-    return object[key as keyof object];
-  }
-}
-
-/**
- * Select a random index from an array of weighted items
- *
- * @param {number[]} weights Array of weights
- * @returns {number} Random index based on weights
- */
-export function randomIndex(weights: number[]): number {
-  if (weights.length === 0) return -1;
-
-  let totalWeight = 0;
-  for (let weight of weights) {
-    totalWeight += weight;
-  }
-
-  if (totalWeight <= 0) {
-    console.warn('randomIndex()', 'Weights must sum to > 0', totalWeight);
-  }
-
-  let weight = Math.random() * totalWeight;
-  for (let i = 0; i < weights.length; i++) {
-    if (weight < weights[i]) return i;
-    weight -= weights[i];
-  }
-
-  return 0;
-}
-
-// *********************
-// Geometry
-// *********************
-/**
- * Produce a random 2D point around the perimiter of a unit circle
- *
- * @param  {number} [radius=1]        Radius of the circle
- * @param  {Vector2} [target] Target vector
- * @returns {Vector2} Random 2D point on circle
- */
-export function onCircle(radius: number = 1, target: Vector2 = { x: 0, y: 0 }): Vector2 {
-  const angle = Math.random() * 2.0 * Math.PI;
-  target.x = radius * Math.cos(angle);
-  target.y = radius * Math.sin(angle);
-  return target;
-}
-
-/**
- * Produce a random 2D point inside a unit circle
- *
- * @param  {number} [radius=1]        Radius of the circle
- * @param  {Vector2} [target] Target vector
- * @returns {Vector2} Random 2D point inside circle
- */
-export function insideCircle(radius: number = 1, target: Vector2 = { x: 0, y: 0 }): Vector2 {
-  radius *= Math.random();
-  return onCircle(radius, target);
-}
-
-/**
- * Produce a random 3D point on the surface of a unit sphere
- *
- * @param  {number} [radius=1]        Radius of the sphere
- * @param  {Vector3} [target] Target vector
- * @returns {Vector3} Random 3D point on sphere
- */
-export function onSphere(radius: number = 1, target: Vector3 = { x: 0, y: 0, z: 0 }): Vector3 {
-  const u = Math.random() * Math.PI * 2;
-  const v = Math.random() * 2 - 1;
-  const phi = u;
-  const theta = Math.acos(v);
-  return radToSphere(radius, phi, theta, target);
-}
-
-/**
- * Produce a random 3D point inside a unit sphere
- *
- * @param  {number} [radius=1]        Radius of the sphere
- * @param  {Vector3} [target] Target vector
- * @returns {Vector3} Random 3D point inside sphere
- */
-export function insideSphere(radius: number = 1, target: Vector3 = { x: 0, y: 0, z: 0 }): Vector3 {
-  radius *= Math.random();
-  return onSphere(radius, target);
-}

package/src/strings.ts

@@ -1,19 +0,0 @@
-/**
- * Capitalize a string
- *
- * @param  {string} string String to capitalize
- * @returns {string} Capitalized string
- */
-export function capitalize(string: string): string {
-  return string.charAt(0).toUpperCase() + string.slice(1);
-}
-
-/**
- * Clean a path by removing params
- *
- * @param  {string} path Path to clean
- * @returns {string} Cleaned path
- */
-export function cleanPath(path: string): string {
-  return path.split('#')[0].split('?')[0];
-}

package/src/types.ts

@@ -1,33 +0,0 @@
-import { W3CX11 } from './constants';
-
-// *********************
-// Colors
-// *********************
-export type ColorName = keyof typeof W3CX11;
-
-export type ColorRepresentation = ColorName | string | number | [number, number, number];
-
-// *********************
-// Functions
-// *********************
-export interface Deferred<T> {
-  promise: Promise<T>;
-  resolve: (value: T | PromiseLike<T>) => void;
-  reject: (reason?: unknown) => void;
-}
-
-// *********************
-// Geometry
-// *********************
-export interface Vector2 {
-  x: number;
-  y: number;
-}
-
-export interface Vector3 extends Vector2 {
-  z: number;
-}
-
-export interface Vector4 extends Vector3 {
-  w: number;
-}