@oscarpalmer/atoms 0.38.0 → 0.39.0

package/dist/js/index.js

@@ -363,6 +363,12 @@ function getPosition(event) {
   return typeof x === "number" && typeof y === "number" ? { x, y } : undefined;
 }
 // src/js/string.ts
+function capitalise(value) {
+  if (value.length === 0) {
+    return value;
+  }
+  return value.length === 1 ? value.toLocaleUpperCase() : value.charAt(0).toLocaleUpperCase() + value.slice(1).toLocaleLowerCase();
+}
 function createUuid() {
   return "10000000-1000-4000-8000-100000000000".replace(/[018]/g, (substring) => (substring ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> substring / 4).toString(16));
 }
@@ -377,11 +383,21 @@ function getString(value) {
   const asString = valueOff?.toString?.() ?? String(valueOff);
   return asString.startsWith("[object ") ? JSON.stringify(value) : asString;
 }
+function titleCase(value) {
+  return value.split(/\s+/).map((word) => capitalise(word)).join(" ");
+}
 
 // src/js/is.ts
 function isArrayOrPlainObject(value) {
   return Array.isArray(value) || isPlainObject(value);
 }
+function isEmpty(value) {
+  if (Array.isArray(value)) {
+    return value.length === 0 || value.filter((item) => item != null).length === 0;
+  }
+  const values = Object.values(value);
+  return values.length === 0 || values.filter((item) => item != null).length === 0;
+}
 function isNullable(value) {
   return value == null;
 }
@@ -468,6 +484,28 @@ if (globalThis._atomic_queued == null) {
     }
   });
 }
+// src/js/random.ts
+function getRandomBoolean() {
+  return Math.random() > 0.5;
+}
+function getRandomColour() {
+  return `#${Array.from({ length: 6 }, getRandomHex).join("")}`;
+}
+function getRandomDate(earliest, latest) {
+  const earliestTime = earliest?.getTime() ?? -8640000000000000;
+  const latestTime = latest?.getTime() ?? 8640000000000000;
+  return new Date(getRandomInteger(earliestTime, latestTime));
+}
+function getRandomFloat(min, max) {
+  const minimum = min ?? Number.MIN_SAFE_INTEGER;
+  return Math.random() * ((max ?? Number.MAX_SAFE_INTEGER) - minimum) + minimum;
+}
+function getRandomInteger(min, max) {
+  return Math.floor(getRandomFloat(min, max));
+}
+function getRandomHex() {
+  return "0123456789ABCDEF"[getRandomInteger(0, 16)];
+}
 // src/js/timer.ts
 function isRepeated(value) {
   return /^repeat$/.test(value?.$timer ?? "");
@@ -553,8 +591,10 @@ function when(condition, options) {
   });
   const instance = Object.create({
     stop() {
-      repeated.stop();
-      rejecter?.();
+      if (repeated.active) {
+        repeated.stop();
+        rejecter?.();
+      }
     },
     then(resolve, reject) {
       repeated.start();
@@ -581,8 +621,8 @@ var work = function(type, timer2, state, options) {
   const isRepeated2 = count > 0;
   let index = 0;
   let total = count * (interval > 0 ? interval : 1);
-  if (total < milliseconds) {
-    total = milliseconds;
+  if (total < 16.66667) {
+    total = 16.66667;
   }
   let current;
   let start;
@@ -624,19 +664,6 @@ var work = function(type, timer2, state, options) {
   state.frame = requestAnimationFrame(step);
   return timer2;
 };
-var milliseconds = 0;
-(() => {
-  let start;
-  function fn(time) {
-    if (start == null) {
-      start = time;
-      requestAnimationFrame(fn);
-    } else {
-      milliseconds = time - start;
-    }
-  }
-  requestAnimationFrame(fn);
-})();
 // src/js/touch.ts
 var supportsTouch = (() => {
   let value = false;
@@ -850,6 +877,7 @@ export {
   when,
   wait,
   unique,
+  titleCase,
   splice,
   setValue,
   repeat,
@@ -869,6 +897,7 @@ export {
   isNullableOrEmpty,
   isNullable,
   isFocusableElement,
+  isEmpty,
   isArrayOrPlainObject,
   insert,
   indexOf,
@@ -877,6 +906,13 @@ export {
   getTextDirection,
   getTabbableElements,
   getString,
+  getRandomInteger,
+  getRandomHex,
+  getRandomFloat,
+  getRandomDate,
+  getRandomColour,
+  getRandomColour as getRandomColor,
+  getRandomBoolean,
   getPosition,
   getNumber,
   getFocusableElements,
@@ -892,6 +928,8 @@ export {
   clone,
   clamp,
   chunk,
+  capitalise as capitalize,
+  capitalise,
   between,
   findElements as $$,
   findElement as $

package/dist/js/index.mjs

@@ -7,6 +7,7 @@ export * from "./is";
 export * from "./models";
 export * from "./number";
 export * from "./queue";
+export * from "./random";
 export * from "./string";
 export * from "./timer";
 export * from "./touch";

package/dist/js/is.js

@@ -15,6 +15,13 @@ function getString(value) {
 function isArrayOrPlainObject(value) {
   return Array.isArray(value) || isPlainObject(value);
 }
+function isEmpty(value) {
+  if (Array.isArray(value)) {
+    return value.length === 0 || value.filter((item) => item != null).length === 0;
+  }
+  const values = Object.values(value);
+  return values.length === 0 || values.filter((item) => item != null).length === 0;
+}
 function isNullable(value) {
   return value == null;
 }
@@ -52,5 +59,6 @@ export {
   isNullableOrWhitespace,
   isNullableOrEmpty,
   isNullable,
+  isEmpty,
   isArrayOrPlainObject
 };

package/dist/js/is.mjs

@@ -3,6 +3,13 @@ import {getString} from "./string";
 function isArrayOrPlainObject(value) {
   return Array.isArray(value) || isPlainObject(value);
 }
+function isEmpty(value) {
+  if (Array.isArray(value)) {
+    return value.length === 0 || value.filter((item) => item != null).length === 0;
+  }
+  const values = Object.values(value);
+  return values.length === 0 || values.filter((item) => item != null).length === 0;
+}
 function isNullable(value) {
   return value == null;
 }
@@ -40,5 +47,6 @@ export {
   isNullableOrWhitespace,
   isNullableOrEmpty,
   isNullable,
+  isEmpty,
   isArrayOrPlainObject
 };

package/dist/js/random.js

@@ -0,0 +1,31 @@
+// src/js/random.ts
+function getRandomBoolean() {
+  return Math.random() > 0.5;
+}
+function getRandomColour() {
+  return `#${Array.from({ length: 6 }, getRandomHex).join("")}`;
+}
+function getRandomDate(earliest, latest) {
+  const earliestTime = earliest?.getTime() ?? -8640000000000000;
+  const latestTime = latest?.getTime() ?? 8640000000000000;
+  return new Date(getRandomInteger(earliestTime, latestTime));
+}
+function getRandomFloat(min, max) {
+  const minimum = min ?? Number.MIN_SAFE_INTEGER;
+  return Math.random() * ((max ?? Number.MAX_SAFE_INTEGER) - minimum) + minimum;
+}
+function getRandomInteger(min, max) {
+  return Math.floor(getRandomFloat(min, max));
+}
+function getRandomHex() {
+  return "0123456789ABCDEF"[getRandomInteger(0, 16)];
+}
+export {
+  getRandomInteger,
+  getRandomHex,
+  getRandomFloat,
+  getRandomDate,
+  getRandomColour,
+  getRandomColour as getRandomColor,
+  getRandomBoolean
+};

package/dist/js/random.mjs

@@ -0,0 +1,31 @@
+// src/js/random.ts
+function getRandomBoolean() {
+  return Math.random() > 0.5;
+}
+function getRandomColour() {
+  return `#${Array.from({ length: 6 }, getRandomHex).join("")}`;
+}
+function getRandomDate(earliest, latest) {
+  const earliestTime = earliest?.getTime() ?? -8640000000000000;
+  const latestTime = latest?.getTime() ?? 8640000000000000;
+  return new Date(getRandomInteger(earliestTime, latestTime));
+}
+function getRandomFloat(min, max) {
+  const minimum = min ?? Number.MIN_SAFE_INTEGER;
+  return Math.random() * ((max ?? Number.MAX_SAFE_INTEGER) - minimum) + minimum;
+}
+function getRandomInteger(min, max) {
+  return Math.floor(getRandomFloat(min, max));
+}
+function getRandomHex() {
+  return "0123456789ABCDEF"[getRandomInteger(0, 16)];
+}
+export {
+  getRandomInteger,
+  getRandomHex,
+  getRandomFloat,
+  getRandomDate,
+  getRandomColour,
+  getRandomColour as getRandomColor,
+  getRandomBoolean
+};

package/dist/js/string.js

@@ -1,4 +1,10 @@
 // src/js/string.ts
+function capitalise(value) {
+  if (value.length === 0) {
+    return value;
+  }
+  return value.length === 1 ? value.toLocaleUpperCase() : value.charAt(0).toLocaleUpperCase() + value.slice(1).toLocaleLowerCase();
+}
 function createUuid() {
   return "10000000-1000-4000-8000-100000000000".replace(/[018]/g, (substring) => (substring ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> substring / 4).toString(16));
 }
@@ -13,7 +19,13 @@ function getString(value) {
   const asString = valueOff?.toString?.() ?? String(valueOff);
   return asString.startsWith("[object ") ? JSON.stringify(value) : asString;
 }
+function titleCase(value) {
+  return value.split(/\s+/).map((word) => capitalise(word)).join(" ");
+}
 export {
+  titleCase,
   getString,
-  createUuid
+  createUuid,
+  capitalise as capitalize,
+  capitalise
 };

package/dist/js/string.mjs

@@ -1,4 +1,10 @@
 // src/js/string.ts
+function capitalise(value) {
+  if (value.length === 0) {
+    return value;
+  }
+  return value.length === 1 ? value.toLocaleUpperCase() : value.charAt(0).toLocaleUpperCase() + value.slice(1).toLocaleLowerCase();
+}
 function createUuid() {
   return "10000000-1000-4000-8000-100000000000".replace(/[018]/g, (substring) => (substring ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> substring / 4).toString(16));
 }
@@ -13,7 +19,13 @@ function getString(value) {
   const asString = valueOff?.toString?.() ?? String(valueOff);
   return asString.startsWith("[object ") ? JSON.stringify(value) : asString;
 }
+function titleCase(value) {
+  return value.split(/\s+/).map((word) => capitalise(word)).join(" ");
+}
 export {
+  titleCase,
   getString,
-  createUuid
+  createUuid,
+  capitalise as capitalize,
+  capitalise
 };

package/dist/js/timer.js

@@ -83,8 +83,10 @@ function when(condition, options) {
   });
   const instance = Object.create({
     stop() {
-      repeated.stop();
-      rejecter?.();
+      if (repeated.active) {
+        repeated.stop();
+        rejecter?.();
+      }
     },
     then(resolve, reject) {
       repeated.start();
@@ -111,8 +113,8 @@ var work = function(type, timer2, state, options) {
   const isRepeated2 = count > 0;
   let index = 0;
   let total = count * (interval > 0 ? interval : 1);
-  if (total < milliseconds) {
-    total = milliseconds;
+  if (total < 16.66667) {
+    total = 16.66667;
   }
   let current;
   let start;
@@ -154,19 +156,6 @@ var work = function(type, timer2, state, options) {
   state.frame = requestAnimationFrame(step);
   return timer2;
 };
-var milliseconds = 0;
-(() => {
-  let start;
-  function fn(time) {
-    if (start == null) {
-      start = time;
-      requestAnimationFrame(fn);
-    } else {
-      milliseconds = time - start;
-    }
-  }
-  requestAnimationFrame(fn);
-})();
 export {
   when,
   wait,

package/dist/js/timer.mjs

@@ -83,8 +83,10 @@ function when(condition, options) {
   });
   const instance = Object.create({
     stop() {
-      repeated.stop();
-      rejecter?.();
+      if (repeated.active) {
+        repeated.stop();
+        rejecter?.();
+      }
     },
     then(resolve, reject) {
       repeated.start();
@@ -111,8 +113,8 @@ var work = function(type, timer2, state, options) {
   const isRepeated2 = count > 0;
   let index = 0;
   let total = count * (interval > 0 ? interval : 1);
-  if (total < milliseconds) {
-    total = milliseconds;
+  if (total < 16.66667) {
+    total = 16.66667;
   }
   let current;
   let start;
@@ -154,19 +156,6 @@ var work = function(type, timer2, state, options) {
   state.frame = requestAnimationFrame(step);
   return timer2;
 };
-var milliseconds = 0;
-(() => {
-  let start;
-  function fn(time) {
-    if (start == null) {
-      start = time;
-      requestAnimationFrame(fn);
-    } else {
-      milliseconds = time - start;
-    }
-  }
-  requestAnimationFrame(fn);
-})();
 export {
   when,
   wait,

package/package.json

@@ -8,10 +8,10 @@
 	},
 	"description": "Sweet little atomic goodies…",
 	"devDependencies": {
-		"@biomejs/biome": "^1.6",
-		"@happy-dom/global-registrator": "^14.7",
+		"@biomejs/biome": "^1.7",
+		"@happy-dom/global-registrator": "^14.11",
 		"bun": "^1.1",
-		"sass": "^1.74",
+		"sass": "^1.77",
 		"typescript": "^5.4"
 	},
 	"exports": {
@@ -105,7 +105,11 @@
 		},
 		"./package.json": "./package.json"
 	},
-	"files": ["dist", "src", "types"],
+	"files": [
+		"dist",
+		"src",
+		"types"
+	],
 	"keywords": [],
 	"license": "MIT",
 	"main": "./dist/js/index.js",
@@ -126,5 +130,5 @@
 	},
 	"type": "module",
 	"types": "./types/index.d.ts",
-	"version": "0.38.0"
+	"version": "0.39.0"
 }

package/src/js/index.ts

@@ -6,6 +6,7 @@ export * from './is';
 export * from './models';
 export * from './number';
 export * from './queue';
+export * from './random';
 export * from './string';
 export * from './timer';
 export * from './touch';

package/src/js/is.ts

@@ -10,6 +10,20 @@ export function isArrayOrPlainObject(
 	return Array.isArray(value) || isPlainObject(value);
 }
 
+export function isEmpty(value: ArrayOrPlainObject): boolean {
+	if (Array.isArray(value)) {
+		return (
+			value.length === 0 || value.filter(item => item != null).length === 0
+		);
+	}
+
+	const values = Object.values(value);
+
+	return (
+		values.length === 0 || values.filter(item => item != null).length === 0
+	);
+}
+
 /**
  * Is the value undefined or null?
  */

package/src/js/random.ts

@@ -0,0 +1,48 @@
+/**
+ * Returns a random boolean
+ */
+export function getRandomBoolean(): boolean {
+	return Math.random() > 0.5;
+}
+
+/**
+ * Returns a random hexadecimal colour
+ */
+export function getRandomColour(): string {
+	return `#${Array.from({length: 6}, getRandomHex).join('')}`;
+}
+
+/**
+ * Returns a random date
+ */
+export function getRandomDate(earliest?: Date, latest?: Date): Date {
+	const earliestTime = earliest?.getTime() ?? -8_640_000_000_000_000;
+	const latestTime = latest?.getTime() ?? 8_640_000_000_000_000;
+
+	return new Date(getRandomInteger(earliestTime, latestTime));
+}
+
+/**
+ * Returns a random floating-point number
+ */
+export function getRandomFloat(min?: number, max?: number): number {
+	const minimum = min ?? Number.MIN_SAFE_INTEGER;
+
+	return Math.random() * ((max ?? Number.MAX_SAFE_INTEGER) - minimum) + minimum;
+}
+
+/**
+ * Returns a random integer
+ */
+export function getRandomInteger(min?: number, max?: number): number {
+	return Math.floor(getRandomFloat(min, max));
+}
+
+/**
+ * Returns a random hexadecimal character
+ */
+export function getRandomHex(): string {
+	return '0123456789ABCDEF'[getRandomInteger(0, 16)];
+}
+
+export {getRandomColour as getRandomColor};

package/src/js/string.ts

@@ -1,13 +1,26 @@
+/**
+ * Capitalise the first letter of a string _(and lowercase the rest)_
+ */
+export function capitalise(value: string): string {
+	if (value.length === 0) {
+		return value;
+	}
+	return value.length === 1
+		? value.toLocaleUpperCase()
+		: value.charAt(0).toLocaleUpperCase() + value.slice(1).toLocaleLowerCase();
+}
+
 /**
  * Create a new UUID
  */
 export function createUuid(): string {
 	return '10000000-1000-4000-8000-100000000000'.replace(
 		/[018]/g,
-		(substring: any) =>
+		(substring: string) =>
 			(
-				substring ^
-				(crypto.getRandomValues(new Uint8Array(1))[0] & (15 >> (substring / 4)))
+				(substring as never) ^
+				(crypto.getRandomValues(new Uint8Array(1))[0] &
+					(15 >> ((substring as never) / 4)))
 			).toString(16),
 	);
 }
@@ -29,3 +42,15 @@ export function getString(value: unknown): string {
 
 	return asString.startsWith('[object ') ? JSON.stringify(value) : asString;
 }
+
+/**
+ * Convert a string to title case _(capitalising every word)_
+ */
+export function titleCase(value: string): string {
+	return value
+		.split(/\s+/)
+		.map(word => capitalise(word))
+		.join(' ');
+}
+
+export {capitalise as capitalize};

package/src/js/timer.ts

@@ -94,8 +94,6 @@ type WhenOptions = {} & OptionsWithCount;
 
 type WorkType = 'restart' | 'start' | 'stop';
 
-let milliseconds = 0;
-
 /**
  * Is the value a repeating timer?
  */
@@ -202,13 +200,13 @@ export function wait(callback: () => void): Timer;
 
 /**
  * Creates a timer which calls a callback after a certain amount of time
- * - `time` defaults to `0`
  */
 export function wait(callback: () => void, time: number): Timer;
 
 /**
  * Creates a timer which calls a callback after a certain amount of time
  * - `options.interval` defaults to `0`
+ * - `options.timeout` defaults to `30_000` _(30 seconds)_
  */
 export function wait(
 	callback: () => void,
@@ -264,9 +262,11 @@ export function when(
 
 	const instance = Object.create({
 		stop() {
-			repeated.stop();
+			if (repeated.active) {
+				repeated.stop();
 
-			rejecter?.();
+				rejecter?.();
+			}
 		},
 		// biome-ignore lint/suspicious/noThenProperty: <explanation>
 		then(resolve?: () => void, reject?: () => void) {
@@ -314,8 +314,8 @@ function work(
 	let index = 0;
 	let total = count * (interval > 0 ? interval : 1);
 
-	if (total < milliseconds) {
-		total = milliseconds;
+	if (total < 16.66667) {
+		total = 16.66667;
 	}
 
 	let current: DOMHighResTimeStamp | null;
@@ -372,22 +372,3 @@ function work(
 
 	return timer;
 }
-
-/**
- * Called immediately to calculate an approximate refresh rate in milliseconds
- */
-(() => {
-	let start: number;
-
-	function fn(time: number) {
-		if (start == null) {
-			start = time;
-
-			requestAnimationFrame(fn);
-		} else {
-			milliseconds = time - start;
-		}
-	}
-
-	requestAnimationFrame(fn);
-})();

package/types/index.d.ts

@@ -6,6 +6,7 @@ export * from './is';
 export * from './models';
 export * from './number';
 export * from './queue';
+export * from './random';
 export * from './string';
 export * from './timer';
 export * from './touch';

package/types/is.d.ts

@@ -3,6 +3,7 @@ import type { ArrayOrPlainObject, PlainObject, Primitive } from './models';
  * Is the value an array or a record?
  */
 export declare function isArrayOrPlainObject(value: unknown): value is ArrayOrPlainObject;
+export declare function isEmpty(value: ArrayOrPlainObject): boolean;
 /**
  * Is the value undefined or null?
  */

package/types/random.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Returns a random boolean
+ */
+export declare function getRandomBoolean(): boolean;
+/**
+ * Returns a random hexadecimal colour
+ */
+export declare function getRandomColour(): string;
+/**
+ * Returns a random date
+ */
+export declare function getRandomDate(earliest?: Date, latest?: Date): Date;
+/**
+ * Returns a random floating-point number
+ */
+export declare function getRandomFloat(min?: number, max?: number): number;
+/**
+ * Returns a random integer
+ */
+export declare function getRandomInteger(min?: number, max?: number): number;
+/**
+ * Returns a random hexadecimal character
+ */
+export declare function getRandomHex(): string;
+export { getRandomColour as getRandomColor };

package/types/string.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Capitalise the first letter of a string _(and lowercase the rest)_
+ */
+export declare function capitalise(value: string): string;
 /**
  * Create a new UUID
  */
@@ -6,3 +10,8 @@ export declare function createUuid(): string;
  * Get the string value from any value
  */
 export declare function getString(value: unknown): string;
+/**
+ * Convert a string to title case _(capitalising every word)_
+ */
+export declare function titleCase(value: string): string;
+export { capitalise as capitalize };

package/types/timer.d.ts

@@ -93,12 +93,12 @@ export declare function repeat(callback: IndexedCallback, options?: Partial<Repe
 export declare function wait(callback: () => void): Timer;
 /**
  * Creates a timer which calls a callback after a certain amount of time
- * - `time` defaults to `0`
  */
 export declare function wait(callback: () => void, time: number): Timer;
 /**
  * Creates a timer which calls a callback after a certain amount of time
  * - `options.interval` defaults to `0`
+ * - `options.timeout` defaults to `30_000` _(30 seconds)_
  */
 export declare function wait(callback: () => void, options: Partial<WaitOptions>): Timer;
 /**