toosoon-utils 3.1.0 → 4.0.0

package/lib/prng.js

@@ -1,13 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomGaussian = exports.randomIndex = exports.randomObjectProperty = exports.randomItem = exports.randomHexColor = exports.randomInt = exports.randomFloat = exports.randomSign = exports.randomBoolean = exports.random = exports.xoshiro128ss = exports.jsf32 = exports.mulberry32 = exports.splitmix32 = exports.sfc32 = exports.cyrb128 = void 0;
 /**
  * Produce a 128-bit hash value from a seed
  *
  * @param {string} seed Initial seed state
  * @returns {[number, number, number, number]} Hash numbers
  */
-function cyrb128(seed) {
+export function cyrb128(seed) {
     var h1 = 1779033703;
     var h2 = 3144134277;
     var h3 = 1013904242;
@@ -25,7 +22,6 @@ function cyrb128(seed) {
     h4 = Math.imul(h2 ^ (h4 >>> 19), 2716044179);
     return [(h1 ^ h2 ^ h3 ^ h4) >>> 0, (h2 ^ h1) >>> 0, (h3 ^ h1) >>> 0, (h4 ^ h1) >>> 0];
 }
-exports.cyrb128 = cyrb128;
 // *********************
 // PRNG Algorithms
 // *********************
@@ -38,7 +34,7 @@ exports.cyrb128 = cyrb128;
  * @param {number} d
  * @returns {number} Pseudo-random number
  */
-function sfc32(a, b, c, d) {
+export function sfc32(a, b, c, d) {
     a >>>= 0;
     b >>>= 0;
     c >>>= 0;
@@ -52,14 +48,13 @@ function sfc32(a, b, c, d) {
     c = (c + t) | 0;
     return (t >>> 0) / 4294967296;
 }
-exports.sfc32 = sfc32;
 /**
  * SplitMix32, Generator with a 32-bit state
  *
  * @param {number} a
  * @returns {number} Pseudo-random number
  */
-function splitmix32(a) {
+export function splitmix32(a) {
     a |= 0;
     a = (a + 0x9e3779b9) | 0;
     var t = a ^ (a >>> 16);
@@ -68,27 +63,25 @@ function splitmix32(a) {
     t = Math.imul(t, 0x735a2d97);
     return ((t = t ^ (t >>> 15)) >>> 0) / 4294967296;
 }
-exports.splitmix32 = splitmix32;
 /**
  * Mulberry32, Generator with a 32-bit state
  *
  * @param {number} a
  * @returns {number} Pseudo-random number
  */
-function mulberry32(a) {
+export function mulberry32(a) {
     var t = (a += 0x6d2b79f5);
     t = Math.imul(t ^ (t >>> 15), t | 1);
     t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
     return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
 }
-exports.mulberry32 = mulberry32;
 /**
  * Jenkins' Small Fast, Generator with a 32-bit state
  *
  * @param {number} a
  * @returns {number} Pseudo-random number
  */
-function jsf32(a, b, c, d) {
+export function jsf32(a, b, c, d) {
     a |= 0;
     b |= 0;
     c |= 0;
@@ -100,14 +93,13 @@ function jsf32(a, b, c, d) {
     d = (a + t) | 0;
     return (d >>> 0) / 4294967296;
 }
-exports.jsf32 = jsf32;
 /**
  * xoshiro128**, Generator with a 128-bit state
  *
  * @param {number} a
  * @returns {number} Pseudo-random number
  */
-function xoshiro128ss(a, b, c, d) {
+export function xoshiro128ss(a, b, c, d) {
     var t = b << 9;
     var r = a * 5;
     r = ((r << 7) | (r >>> 25)) * 9;
@@ -119,7 +111,6 @@ function xoshiro128ss(a, b, c, d) {
     d = (d << 11) | (d >>> 21);
     return (r >>> 0) / 4294967296;
 }
-exports.xoshiro128ss = xoshiro128ss;
 /**
  * Generate a pseudo-random number in the interval [0, 1]
  * PRNG equivalent of `Math.random()`
@@ -127,13 +118,12 @@ exports.xoshiro128ss = xoshiro128ss;
  * @param {PRNGParameters} prng PRNG parameters
  * @returns {number} Pseudo-random number
  */
-function random(prng) {
+export function random(prng) {
     var seed = typeof prng === 'string' ? prng : prng.seed;
     var algorithm = typeof prng === 'string' ? splitmix32 : prng.algorithm;
     var hashes = cyrb128(seed);
     return algorithm.apply(void 0, hashes);
 }
-exports.random = random;
 /**
  * Generate a pseudo-random boolean (true or false)
  *
@@ -141,11 +131,10 @@ exports.random = random;
  * @param {number} [probability=0.5] Probability to get true
  * @returns {boolean} Either `true` or `false`
  */
-function randomBoolean(prng, probability) {
+export function randomBoolean(prng, probability) {
     if (probability === void 0) { probability = 0.5; }
     return random(prng) < probability;
 }
-exports.randomBoolean = randomBoolean;
 /**
  * Generate a pseudo-random sign (1 or -1)
  *
@@ -153,11 +142,10 @@ exports.randomBoolean = randomBoolean;
  * @param {number} [probability=0.5] Probability to get 1
  * @returns {number} Either 1 or -1
  */
-function randomSign(prng, probability) {
+export function randomSign(prng, probability) {
     if (probability === void 0) { probability = 0.5; }
     return randomBoolean(prng, probability) ? 1 : -1;
 }
-exports.randomSign = randomSign;
 /**
  * Generate a pseudo-random floating-point number within a specified range
  *
@@ -167,13 +155,12 @@ exports.randomSign = randomSign;
  * @param {number} [precision=2] Number of digits after the decimal point
  * @returns {number} Generated float
  */
-function randomFloat(prng, min, max, precision) {
+export function randomFloat(prng, min, max, precision) {
     if (min === void 0) { min = 0; }
     if (max === void 0) { max = 1; }
     if (precision === void 0) { precision = 2; }
     return parseFloat(Math.min(min + random(prng) * (max - min), max).toFixed(precision));
 }
-exports.randomFloat = randomFloat;
 /**
  * Generate a pseudo-random integer number within a specified range
  *
@@ -182,20 +169,18 @@ exports.randomFloat = randomFloat;
  * @param {number} max          Maximum boundary
  * @returns {number} Generated integer
  */
-function randomInt(prng, min, max) {
+export function randomInt(prng, min, max) {
     return Math.floor(random(prng) * (max - min + 1) + min);
 }
-exports.randomInt = randomInt;
 /**
  * Generate a pseudo-random hexadecimal color
  *
  * @param {PRNGParameters} prng PRNG parameters
  * @returns {string} Generated hexadecimal color
  */
-function randomHexColor(prng) {
+export function randomHexColor(prng) {
     return '#' + ('00000' + ((random(prng) * (1 << 24)) | 0).toString(16)).slice(-6);
 }
-exports.randomHexColor = randomHexColor;
 /**
  * Pick a pseudo-random item from a given array
  *
@@ -203,12 +188,11 @@ exports.randomHexColor = randomHexColor;
  * @param {T[]} array           Array to pick the item from
  * @returns {T|undefined} Random item picked
  */
-function randomItem(prng, array) {
+export function randomItem(prng, array) {
     if (array.length === 0)
         return undefined;
     return array[randomInt(prng, 0, array.length - 1)];
 }
-exports.randomItem = randomItem;
 /**
  * Pick a pseudo-random property value from a given object
  *
@@ -216,14 +200,13 @@ exports.randomItem = randomItem;
  * @param {object} object       Object to pick the property from
  * @returns {T|undefined} Random item picked
  */
-function randomObjectProperty(prng, object) {
+export function randomObjectProperty(prng, object) {
     var keys = Object.keys(object);
     var key = randomItem(prng, keys);
     if (key && object.hasOwnProperty(key)) {
         return object[key];
     }
 }
-exports.randomObjectProperty = randomObjectProperty;
 /**
  * Select a pseudo-random index from an array of weighted items
  *
@@ -231,7 +214,7 @@ exports.randomObjectProperty = randomObjectProperty;
  * @param {number[]} weights    Array of weights
  * @returns {number} Random index based on weights
  */
-function randomIndex(prng, weights) {
+export function randomIndex(prng, weights) {
     if (weights.length === 0)
         return -1;
     var totalWeight = 0;
@@ -249,7 +232,6 @@ function randomIndex(prng, weights) {
     }
     return 0;
 }
-exports.randomIndex = randomIndex;
 /**
  * Generate a pseudo-random number fitting a Gaussian (normal) distribution
  *
@@ -258,7 +240,7 @@ exports.randomIndex = randomIndex;
  * @param {number} [spread=1]   Standard deviation
  * @returns {number} Generated number
  */
-function randomGaussian(prng, mean, spread) {
+export function randomGaussian(prng, mean, spread) {
     if (mean === void 0) { mean = 0; }
     if (spread === void 0) { spread = 1; }
     var seed = typeof prng === 'string' ? prng : prng.seed;
@@ -269,4 +251,3 @@ function randomGaussian(prng, mean, spread) {
     var z = Math.sqrt(-2.0 * Math.log(u)) * Math.cos(2.0 * Math.PI * v);
     return mean + z * spread;
 }
-exports.randomGaussian = randomGaussian;

package/lib/query.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasQuery = exports.setQuery = exports.getQuery = void 0;
 var search = typeof window !== 'undefined' ? window.location.search : undefined;
 var history = typeof window !== 'undefined' ? window.history : undefined;
 /**
@@ -9,31 +6,28 @@ var history = typeof window !== 'undefined' ? window.history : undefined;
  * @param {string} property Query property to check
  * @returns {string|null} Value associated to the given search parameter
  */
-function getQuery(property) {
+export function getQuery(property) {
     var params = new URLSearchParams(search);
     return params.get(property);
 }
-exports.getQuery = getQuery;
 /**
  * Set a query parameter
  *
  * @param {string} property Query property to set
  * @param {string} value    Value to set
  */
-function setQuery(property, value) {
+export function setQuery(property, value) {
     var params = new URLSearchParams(search);
     params.set(property, value);
     var string = '?' + params.toString().replace(/\=$/, '').replace(/\=\&/g, '&');
     history === null || history === void 0 ? void 0 : history.pushState({ str: string }, '', string);
 }
-exports.setQuery = setQuery;
 /**
  * Check if a query parameter exists
  *
  * @param {string} property Query property to check
  * @returns {boolean} True if the given property has a query parameter value, false otherwise
  */
-function hasQuery(property) {
+export function hasQuery(property) {
     return getQuery(property) !== null;
 }
-exports.hasQuery = hasQuery;

package/lib/random.d.ts

@@ -1,4 +1,4 @@
-import { Vector2, Vector3 } from './types';
+import type { Vector2, Vector3 } from './types';
 /**
  * Generate a random boolean (true or false)
  *

package/lib/random.js

@@ -1,29 +1,24 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.insideSphere = exports.onSphere = exports.insideCircle = exports.onCircle = exports.randomGaussian = exports.randomIndex = exports.randomObjectProperty = exports.randomItem = exports.randomHexColor = exports.randomInt = exports.randomFloat = exports.randomSign = exports.randomBoolean = void 0;
-var geometry_1 = require("./geometry");
+import { radToSphere } from './geometry';
 /**
  * Generate a random boolean (true or false)
  *
  * @param {number} [probability=0.5] Probability to get true
  * @returns {boolean} Either `true` or `false`
  */
-function randomBoolean(probability) {
+export function randomBoolean(probability) {
     if (probability === void 0) { probability = 0.5; }
     return Math.random() < probability;
 }
-exports.randomBoolean = randomBoolean;
 /**
  * Generate a random sign (1 or -1)
  *
  * @param {number} [probability=0.5] Probability to get 1
  * @returns {number} Either 1 or -1
  */
-function randomSign(probability) {
+export function randomSign(probability) {
     if (probability === void 0) { probability = 0.5; }
     return randomBoolean(probability) ? 1 : -1;
 }
-exports.randomSign = randomSign;
 /**
  * Generate a random floating-point number within a specified range
  *
@@ -32,13 +27,12 @@ exports.randomSign = randomSign;
  * @param {number} [precision=2] Number of digits after the decimal point
  * @returns {number} Generated float
  */
-function randomFloat(min, max, precision) {
+export function randomFloat(min, max, precision) {
     if (min === void 0) { min = 0; }
     if (max === void 0) { max = 1; }
     if (precision === void 0) { precision = 2; }
     return parseFloat(Math.min(min + Math.random() * (max - min), max).toFixed(precision));
 }
-exports.randomFloat = randomFloat;
 /**
  * Generate a random integer number within a specified range
  *
@@ -46,52 +40,48 @@ exports.randomFloat = randomFloat;
  * @param {number} max Maximum boundary
  * @returns {number} Generated integer
  */
-function randomInt(min, max) {
+export function randomInt(min, max) {
     return Math.floor(Math.random() * (max - min + 1) + min);
 }
-exports.randomInt = randomInt;
 /**
  * Generate a random hexadecimal color
  *
  * @returns {string} Generated hexadecimal color
  */
-function randomHexColor() {
+export function randomHexColor() {
     return '#' + ('00000' + ((Math.random() * (1 << 24)) | 0).toString(16)).slice(-6);
 }
-exports.randomHexColor = randomHexColor;
 /**
  * Pick a random item from a given array
  *
  * @param {T[]} array Array to pick the item from
  * @returns {T|undefined} Random item picked
  */
-function randomItem(array) {
+export function randomItem(array) {
     if (array.length === 0)
         return undefined;
     return array[randomInt(0, array.length - 1)];
 }
-exports.randomItem = randomItem;
 /**
  * Pick a random property value from a given object
  *
  * @param {object} object Object to pick the property from
  * @returns {T|undefined} Random item picked
  */
-function randomObjectProperty(object) {
+export function randomObjectProperty(object) {
     var keys = Object.keys(object);
     var key = randomItem(keys);
     if (key && object.hasOwnProperty(key)) {
         return object[key];
     }
 }
-exports.randomObjectProperty = randomObjectProperty;
 /**
  * Select a random index from an array of weighted items
  *
  * @param {number[]} weights Array of weights
  * @returns {number} Random index based on weights
  */
-function randomIndex(weights) {
+export function randomIndex(weights) {
     if (weights.length === 0)
         return -1;
     var totalWeight = 0;
@@ -110,7 +100,6 @@ function randomIndex(weights) {
     }
     return 0;
 }
-exports.randomIndex = randomIndex;
 /**
  * Generate a random number fitting a Gaussian (normal) distribution
  *
@@ -118,7 +107,7 @@ exports.randomIndex = randomIndex;
  * @param {number} [spread=1] Standard deviation
  * @returns {number} Generated number
  */
-function randomGaussian(mean, spread) {
+export function randomGaussian(mean, spread) {
     if (mean === void 0) { mean = 0; }
     if (spread === void 0) { spread = 1; }
     var u = Math.random();
@@ -126,7 +115,6 @@ function randomGaussian(mean, spread) {
     var z = Math.sqrt(-2.0 * Math.log(u)) * Math.cos(2.0 * Math.PI * v);
     return mean + z * spread;
 }
-exports.randomGaussian = randomGaussian;
 // *********************
 // Geometry
 // *********************
@@ -137,7 +125,7 @@ exports.randomGaussian = randomGaussian;
  * @param  {Vector2} [target]  Target vector
  * @returns {Vector2} Random 2D point on circle
  */
-function onCircle(radius, target) {
+export function onCircle(radius, target) {
     if (radius === void 0) { radius = 1; }
     if (target === void 0) { target = { x: 0, y: 0 }; }
     var angle = Math.random() * 2.0 * Math.PI;
@@ -145,7 +133,6 @@ function onCircle(radius, target) {
     target.y = radius * Math.sin(angle);
     return target;
 }
-exports.onCircle = onCircle;
 /**
  * Produce a random 2D point inside a unit circle
  *
@@ -153,13 +140,12 @@ exports.onCircle = onCircle;
  * @param  {Vector2} [target]  Target vector
  * @returns {Vector2} Random 2D point inside circle
  */
-function insideCircle(radius, target) {
+export function insideCircle(radius, target) {
     if (radius === void 0) { radius = 1; }
     if (target === void 0) { target = { x: 0, y: 0 }; }
     radius *= Math.random();
     return onCircle(radius, target);
 }
-exports.insideCircle = insideCircle;
 /**
  * Produce a random 3D point on the surface of a unit sphere
  *
@@ -167,16 +153,15 @@ exports.insideCircle = insideCircle;
  * @param  {Vector3} [target]  Target vector
  * @returns {Vector3} Random 3D point on sphere
  */
-function onSphere(radius, target) {
+export function onSphere(radius, target) {
     if (radius === void 0) { radius = 1; }
     if (target === void 0) { target = { x: 0, y: 0, z: 0 }; }
     var u = Math.random() * Math.PI * 2;
     var v = Math.random() * 2 - 1;
     var phi = u;
     var theta = Math.acos(v);
-    return (0, geometry_1.radToSphere)(radius, phi, theta, target);
+    return radToSphere(radius, phi, theta, target);
 }
-exports.onSphere = onSphere;
 /**
  * Produce a random 3D point inside a unit sphere
  *
@@ -184,10 +169,9 @@ exports.onSphere = onSphere;
  * @param  {Vector3} [target]  Target vector
  * @returns {Vector3} Random 3D point inside sphere
  */
-function insideSphere(radius, target) {
+export function insideSphere(radius, target) {
     if (radius === void 0) { radius = 1; }
     if (target === void 0) { target = { x: 0, y: 0, z: 0 }; }
     radius *= Math.random();
     return onSphere(radius, target);
 }
-exports.insideSphere = insideSphere;

package/lib/strings.js

@@ -1,26 +1,22 @@
-"use strict";
 // ******************************************
 // Cases
 // ******************************************
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeTrailingSlash = exports.addTrailingSlash = exports.cleanPath = exports.toConstantCase = exports.toTrainCase = exports.toPascalCase = exports.toCamelCase = exports.toSnakeCase = exports.toKebabCase = exports.capitalize = void 0;
 /**
  * Capitalize a string
  *
  * @param {string} string String to capitalize
  * @returns {string} Capitalized string
  */
-function capitalize(string) {
+export function capitalize(string) {
     return string.charAt(0).toUpperCase() + string.slice(1);
 }
-exports.capitalize = capitalize;
 /**
  * Convert a string to kebab-case: 'Hello world' -> 'hello-world'
  *
  * @param {string} string String to convert
  * @returns {string} Converted string
  */
-function toKebabCase(string) {
+export function toKebabCase(string) {
     return (string
         // Insert a hyphen between lowercase and uppercase letters
         .replace(/([a-z])([A-Z])/g, '$1-$2')
@@ -28,14 +24,13 @@ function toKebabCase(string) {
         .replace(/[\s_]+/g, '-')
         .toLowerCase());
 }
-exports.toKebabCase = toKebabCase;
 /**
  * Convert a string to snake_case: 'Hello world' -> 'hello_world'
  *
  * @param {string} string String to convert
  * @returns {string} Converted string
  */
-function toSnakeCase(string) {
+export function toSnakeCase(string) {
     return (string
         // Insert an underscore between lowercase and uppercase letters
         .replace(/([a-z])([A-Z])/g, '$1_$2')
@@ -43,42 +38,39 @@ function toSnakeCase(string) {
         .replace(/[\s-]+/g, '_')
         .toLowerCase());
 }
-exports.toSnakeCase = toSnakeCase;
 /**
  * Convert a string to camelCase: 'Hello world' -> 'helloWorld'
  *
  * @param {string} string String to convert
  * @returns {string} Converted string
  */
-function toCamelCase(string) {
+export function toCamelCase(string) {
     return (string
         // Remove separators and capitalize the following letter
         .replace(/[-_\s]+(.)?/g, function (_, c) { return (c ? c.toUpperCase() : ''); })
         // Ensure the first letter is lowercase
         .replace(/^([A-Z])/, function (c) { return c.toLowerCase(); }));
 }
-exports.toCamelCase = toCamelCase;
 /**
  * Convert a string to PascalCase: 'Hello world' -> 'HelloWorld'
  *
  * @param {string} string String to convert
  * @returns {string} Converted string
  */
-function toPascalCase(string) {
+export function toPascalCase(string) {
     return (string
         // Remove separators and capitalizes the following letter
         .replace(/[-_\s]+(.)?/g, function (_, c) { return (c ? c.toUpperCase() : ''); })
         // Ensure the first letter is uppercase
         .replace(/^([a-z])/, function (c) { return c.toUpperCase(); }));
 }
-exports.toPascalCase = toPascalCase;
 /**
  * Convert a string to Train-Case: 'Hello world' -> 'Hello-World'
  *
  * @param {string} string String to convert
  * @returns {string} Converted string
  */
-function toTrainCase(string) {
+export function toTrainCase(string) {
     return (string
         // Insert a hyphen between lowercase and uppercase letters
         .replace(/([a-z])([A-Z])/g, '$1-$2')
@@ -88,14 +80,13 @@ function toTrainCase(string) {
         // Capitalizes each word
         .replace(/\b\w/g, function (c) { return c.toUpperCase(); }));
 }
-exports.toTrainCase = toTrainCase;
 /**
  * Convert a string to CONSTANT_CASE: 'Hello world' -> 'HELLO_WORLD'
  *
  * @param {string} string String to convert
  * @returns {string} Converted string
  */
-function toConstantCase(string) {
+export function toConstantCase(string) {
     return (string
         // Insert an underscore between lowercase and uppercase letters
         .replace(/([a-z])([A-Z])/g, '$1_$2')
@@ -103,7 +94,6 @@ function toConstantCase(string) {
         .replace(/[\s-]+/g, '_')
         .toUpperCase());
 }
-exports.toConstantCase = toConstantCase;
 // ******************************************
 // Paths
 // ******************************************
@@ -113,31 +103,28 @@ exports.toConstantCase = toConstantCase;
  * @param {string} path Path to clean
  * @returns {string} Cleaned path
  */
-function cleanPath(path) {
+export function cleanPath(path) {
     return path.split('#')[0].split('?')[0];
 }
-exports.cleanPath = cleanPath;
 /**
  * Convert a path by ensuring it has a trailing slash
  *
  * @param {string} path Path to convert
  * @returns {string}
  */
-function addTrailingSlash(path) {
+export function addTrailingSlash(path) {
     if (path.match(/\.[a-z]{2,4}$/i) || path.match(/^mailto:/) || path.endsWith('/'))
         return path;
     return "".concat(path, "/");
 }
-exports.addTrailingSlash = addTrailingSlash;
 /**
  * Convert a path by ensuring it has not a trailing slash
  *
  * @param {string} path Path to convert
  * @returns {string}
  */
-function removeTrailingSlash(path) {
+export function removeTrailingSlash(path) {
     if (path.endsWith('/'))
         return path.slice(0, -1);
     return "".concat(path);
 }
-exports.removeTrailingSlash = removeTrailingSlash;