@oscarpalmer/atoms 0.75.0 → 0.76.0

package/dist/js/logger.cjs

@@ -6,13 +6,13 @@ if (globalThis._atomic_logging == null) {
 }
 class Logger {
   /**
-   * Logs any number of values at the "debug" log level
+   * Log any number of values at the "debug" log level
    */
   get debug() {
     return this.enabled ? console.debug : _function.noop;
   }
   /**
-   * Logs the value and shows all its properties
+   * Log the value and shows all its properties
    */
   get dir() {
     return this.enabled ? console.dir : _function.noop;
@@ -30,43 +30,43 @@ class Logger {
     globalThis._atomic_logging = value;
   }
   /**
-   * Logs any number of values at the "error" log level
+   * Log any number of values at the "error" log level
    */
   get error() {
     return this.enabled ? console.error : _function.noop;
   }
   /**
-   * Logs any number of values at the "info" log level
+   * Log any number of values at the "info" log level
    */
   get info() {
     return this.enabled ? console.info : _function.noop;
   }
   /**
-   * Logs any number of values at the "log" log level
+   * Log any number of values at the "log" log level
    */
   get log() {
     return this.enabled ? console.log : _function.noop;
   }
   /**
-   * Logs data as a table, with optional properties to use as columns
+   * Log data as a table, with optional properties to use as columns
    */
   get table() {
     return this.enabled ? console.table : _function.noop;
   }
   /**
-   * Logs any number of values together with a trace from where it was called
+   * Log any number of values together with a trace from where it was called
    */
   get trace() {
     return this.enabled ? console.trace : _function.noop;
   }
   /**
-   * Logs any number of values at the "warn" log level
+   * Log any number of values at the "warn" log level
    */
   get warn() {
     return this.enabled ? console.warn : _function.noop;
   }
   /**
-   * - Starts a logged timer with a label
+   * - Start a logged timer with a label
    * - Returns a `Time`-object for logging the current duration of the timer and stopping the timer _(and logging the total duration)_
    */
   time(label) {
@@ -85,8 +85,8 @@ class Time {
     }
   }
   /**
-   * - Logs the current duration of the timer
-   * - Ignored if logging is disabled
+   * - Log the current duration of the timer
+   * - _(Ignored if logging is disabled)_
    */
   log() {
     if (this.state.started && !this.state.stopped && logger.enabled) {
@@ -94,8 +94,8 @@ class Time {
     }
   }
   /**
-   * - Stops the timer and logs the total duration
-   * - Will always log the total duration, even if logging is disabled
+   * - Stop the timer and logs the total duration
+   * - _(Will always log the total duration, even if logging is disabled)_
    */
   stop() {
     if (this.state.started && !this.state.stopped) {

package/dist/js/logger.js

@@ -4,13 +4,13 @@ if (globalThis._atomic_logging == null) {
 }
 class Logger {
   /**
-   * Logs any number of values at the "debug" log level
+   * Log any number of values at the "debug" log level
    */
   get debug() {
     return this.enabled ? console.debug : noop;
   }
   /**
-   * Logs the value and shows all its properties
+   * Log the value and shows all its properties
    */
   get dir() {
     return this.enabled ? console.dir : noop;
@@ -28,43 +28,43 @@ class Logger {
     globalThis._atomic_logging = value;
   }
   /**
-   * Logs any number of values at the "error" log level
+   * Log any number of values at the "error" log level
    */
   get error() {
     return this.enabled ? console.error : noop;
   }
   /**
-   * Logs any number of values at the "info" log level
+   * Log any number of values at the "info" log level
    */
   get info() {
     return this.enabled ? console.info : noop;
   }
   /**
-   * Logs any number of values at the "log" log level
+   * Log any number of values at the "log" log level
    */
   get log() {
     return this.enabled ? console.log : noop;
   }
   /**
-   * Logs data as a table, with optional properties to use as columns
+   * Log data as a table, with optional properties to use as columns
    */
   get table() {
     return this.enabled ? console.table : noop;
   }
   /**
-   * Logs any number of values together with a trace from where it was called
+   * Log any number of values together with a trace from where it was called
    */
   get trace() {
     return this.enabled ? console.trace : noop;
   }
   /**
-   * Logs any number of values at the "warn" log level
+   * Log any number of values at the "warn" log level
    */
   get warn() {
     return this.enabled ? console.warn : noop;
   }
   /**
-   * - Starts a logged timer with a label
+   * - Start a logged timer with a label
    * - Returns a `Time`-object for logging the current duration of the timer and stopping the timer _(and logging the total duration)_
    */
   time(label) {
@@ -83,8 +83,8 @@ class Time {
     }
   }
   /**
-   * - Logs the current duration of the timer
-   * - Ignored if logging is disabled
+   * - Log the current duration of the timer
+   * - _(Ignored if logging is disabled)_
    */
   log() {
     if (this.state.started && !this.state.stopped && logger.enabled) {
@@ -92,8 +92,8 @@ class Time {
     }
   }
   /**
-   * - Stops the timer and logs the total duration
-   * - Will always log the total duration, even if logging is disabled
+   * - Stop the timer and logs the total duration
+   * - _(Will always log the total duration, even if logging is disabled)_
    */
   stop() {
     if (this.state.started && !this.state.stopped) {

package/dist/js/query.cjs

@@ -9,9 +9,6 @@ function fromQuery(query) {
   const parameters = {};
   for (let index = 0; index < length; index += 1) {
     const [key, value] = parts[index].split("=").map(decodeURIComponent);
-    if (is.isNullableOrWhitespace(key)) {
-      continue;
-    }
     if (key.includes(".")) {
       value_set.setValue(parameters, key, getValue(value));
     } else {

package/dist/js/query.js

@@ -1,4 +1,4 @@
-import { isNullableOrWhitespace, isPlainObject } from "./is.js";
+import { isPlainObject } from "./is.js";
 import { join } from "./string/index.js";
 import { setValue } from "./value/set.js";
 function fromQuery(query) {
@@ -7,9 +7,6 @@ function fromQuery(query) {
   const parameters = {};
   for (let index = 0; index < length; index += 1) {
     const [key, value] = parts[index].split("=").map(decodeURIComponent);
-    if (isNullableOrWhitespace(key)) {
-      continue;
-    }
     if (key.includes(".")) {
       setValue(parameters, key, getValue(value));
     } else {

package/dist/js/random.cjs

@@ -18,11 +18,6 @@ function getRandomCharacters(length, selection) {
 function getRandomColour() {
   return `#${Array.from({ length: 6 }, getRandomHex).join("")}`;
 }
-function getRandomDate(earliest, latest) {
-  const earliestTime = (earliest == null ? void 0 : earliest.getTime()) ?? -864e13;
-  const latestTime = (latest == null ? void 0 : latest.getTime()) ?? 864e13;
-  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;
@@ -45,7 +40,6 @@ function getRandomItems(array, amount) {
 exports.getRandomBoolean = getRandomBoolean;
 exports.getRandomCharacters = getRandomCharacters;
 exports.getRandomColour = getRandomColour;
-exports.getRandomDate = getRandomDate;
 exports.getRandomFloat = getRandomFloat;
 exports.getRandomHex = getRandomHex;
 exports.getRandomInteger = getRandomInteger;

package/dist/js/random.js

@@ -16,11 +16,6 @@ function getRandomCharacters(length, selection) {
 function getRandomColour() {
   return `#${Array.from({ length: 6 }, getRandomHex).join("")}`;
 }
-function getRandomDate(earliest, latest) {
-  const earliestTime = (earliest == null ? void 0 : earliest.getTime()) ?? -864e13;
-  const latestTime = (latest == null ? void 0 : latest.getTime()) ?? 864e13;
-  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;
@@ -44,7 +39,6 @@ export {
   getRandomBoolean,
   getRandomCharacters,
   getRandomColour,
-  getRandomDate,
   getRandomFloat,
   getRandomHex,
   getRandomInteger,

package/dist/js/sized.cjs

@@ -35,7 +35,7 @@ class SizedMap extends Map {
    */
   get(key) {
     const value = super.get(key);
-    if (value === void 0 && !this.has(key)) {
+    if (value == null && !this.has(key)) {
       return;
     }
     this.set(key, value);

package/dist/js/sized.js

@@ -33,7 +33,7 @@ class SizedMap extends Map {
    */
   get(key) {
     const value = super.get(key);
-    if (value === void 0 && !this.has(key)) {
+    if (value == null && !this.has(key)) {
       return;
     }
     this.set(key, value);

package/dist/js/string/index.cjs

@@ -31,9 +31,15 @@ function parse(value, reviver) {
   }
 }
 function truncate(value, length, suffix) {
+  if (length <= 0) {
+    return "";
+  }
+  if (length >= value.length) {
+    return value;
+  }
   const suffixLength = (suffix == null ? void 0 : suffix.length) ?? 0;
   const truncatedLength = length - suffixLength;
-  return value.length <= length ? value : `${value.slice(0, truncatedLength)}${suffix ?? ""}`;
+  return `${value.slice(0, truncatedLength)}${suffix ?? ""}`;
 }
 function words(value) {
   return value.match(/[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g) ?? [];

package/dist/js/string/index.js

@@ -29,9 +29,15 @@ function parse(value, reviver) {
   }
 }
 function truncate(value, length, suffix) {
+  if (length <= 0) {
+    return "";
+  }
+  if (length >= value.length) {
+    return value;
+  }
   const suffixLength = (suffix == null ? void 0 : suffix.length) ?? 0;
   const truncatedLength = length - suffixLength;
-  return value.length <= length ? value : `${value.slice(0, truncatedLength)}${suffix ?? ""}`;
+  return `${value.slice(0, truncatedLength)}${suffix ?? ""}`;
 }
 function words(value) {
   return value.match(/[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g) ?? [];

package/dist/js/value/compare.cjs

@@ -42,7 +42,6 @@ function compare(first, second) {
       if (index === lastIndex) {
         return 0;
       }
-      continue;
     }
     return firstNumber - secondNumber;
   }

package/dist/js/value/compare.js

@@ -40,7 +40,6 @@ function compare(first, second) {
       if (index === lastIndex) {
         return 0;
       }
-      continue;
     }
     return firstNumber - secondNumber;
   }

package/dist/js/value/get.cjs

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const internal_valueHandle = require("../internal/value-handle.cjs");
+const internal_value_handle = require("../internal/value/handle.cjs");
 function getValue(data, path, ignoreCase) {
   const shouldIgnoreCase = ignoreCase === true;
   const parts = (shouldIgnoreCase ? path.toLowerCase() : path).split(".");
   const { length } = parts;
   let index = 0;
-  let value = typeof data === "object" ? data ?? {} : {};
+  let value = data;
   while (index < length && value != null) {
-    value = internal_valueHandle.handleValue(
+    value = internal_value_handle.handleValue(
       value,
       parts[index++],
       null,

package/dist/js/value/get.js

@@ -1,10 +1,10 @@
-import { handleValue } from "../internal/value-handle.js";
+import { handleValue } from "../internal/value/handle.js";
 function getValue(data, path, ignoreCase) {
   const shouldIgnoreCase = ignoreCase === true;
   const parts = (shouldIgnoreCase ? path.toLowerCase() : path).split(".");
   const { length } = parts;
   let index = 0;
-  let value = typeof data === "object" ? data ?? {} : {};
+  let value = data;
   while (index < length && value != null) {
     value = handleValue(
       value,

package/dist/js/value/set.cjs

@@ -1,19 +1,19 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const internal_valueHandle = require("../internal/value-handle.cjs");
+const internal_value_handle = require("../internal/value/handle.cjs");
 function setValue(data, path, value, ignoreCase) {
   const shouldIgnoreCase = ignoreCase === true;
   const parts = (shouldIgnoreCase ? path.toLowerCase() : path).split(".");
   const { length } = parts;
   const lastIndex = length - 1;
-  let target = typeof data === "object" && data !== null ? data : {};
+  let target = data;
   for (let index = 0; index < length; index += 1) {
     const part = parts[index];
     if (index === lastIndex) {
-      internal_valueHandle.handleValue(target, part, value, false, shouldIgnoreCase);
+      internal_value_handle.handleValue(target, part, value, false, shouldIgnoreCase);
       break;
     }
-    let next = internal_valueHandle.handleValue(target, part, null, true, shouldIgnoreCase);
+    let next = internal_value_handle.handleValue(target, part, null, true, shouldIgnoreCase);
     if (typeof next !== "object" || next === null) {
       next = {};
       target[part] = next;

package/dist/js/value/set.js

@@ -1,10 +1,10 @@
-import { handleValue } from "../internal/value-handle.js";
+import { handleValue } from "../internal/value/handle.js";
 function setValue(data, path, value, ignoreCase) {
   const shouldIgnoreCase = ignoreCase === true;
   const parts = (shouldIgnoreCase ? path.toLowerCase() : path).split(".");
   const { length } = parts;
   const lastIndex = length - 1;
-  let target = typeof data === "object" && data !== null ? data : {};
+  let target = data;
   for (let index = 0; index < length; index += 1) {
     const part = parts[index];
     if (index === lastIndex) {

package/package.json

@@ -12,6 +12,7 @@
 		"@types/node": "^22.7",
 		"@vitest/coverage-istanbul": "^2.1",
 		"dts-bundle-generator": "^9.5",
+		"glob": "^11",
 		"happy-dom": "^15.7",
 		"sass": "^1.79",
 		"typescript": "^5.6",
@@ -223,11 +224,11 @@
 		"build:js": "npx vite build && npm run types",
 		"clean": "rm -rf ./dist && rm -rf ./types && rm -f ./tsconfig.tsbuildinfo",
 		"test": "npx vitest --coverage",
-		"types": "npx tsc && npx dts-bundle-generator --config ./dts.config.ts",
+		"types": "npx tsc && npx dts-bundle-generator --config ./dts.config.ts --silent",
 		"watch:css": "npx sass ./src/css:./dist/css --no-source-map --watch",
 		"watch:js": "npx vite build --watch"
 	},
 	"type": "module",
 	"types": "./types/index.d.cts",
-	"version": "0.75.0"
+	"version": "0.76.0"
 }

package/src/js/array/chunk.ts

@@ -1,16 +1,17 @@
+import {clamp} from '~/number';
+
 /**
- * Chunks an array into smaller arrays of a specified size
+ * Chunk an array _(into smaller arrays of a specified size)_
  */
-export function chunk<Value>(array: Value[], size?: number): Value[][] {
+export function chunk<Item>(array: Item[], size?: number): Item[][] {
+	const chunkSize = clamp(size ?? 64_000, 1, 64_000);
 	const {length} = array;
 
-	const chunkSize = typeof size === 'number' && size > 0 ? size : 64_000;
-
 	if (length <= chunkSize) {
 		return [array];
 	}
 
-	const chunks: Value[][] = [];
+	const chunks: Item[][] = [];
 
 	let remaining = Number(length);
 

package/src/js/array/compact.ts

@@ -1,19 +1,17 @@
 /**
- * Compacts and returns an array with all falsey values removed
+ * Compact an array _(removing all `null` and `undefined` values)_
  */
-export function compact<Value>(
-	array: Value[],
-	strict: true,
-): Exclude<Value, 0 | '' | false | null | undefined>[];
+export function compact<Item>(array: Item[]): Exclude<Item, null | undefined>[];
 
 /**
- * Compacts and returns an array with all `null` and `undefined` values removed
+ * Compact an array _(removing all falsey values)_
  */
-export function compact<Value>(
-	array: Value[],
-): Exclude<Value, null | undefined>[];
+export function compact<Item>(
+	array: Item[],
+	strict: true,
+): Exclude<Item, 0 | '' | false | null | undefined>[];
 
-export function compact<Value>(array: Value[], strict?: boolean): Value[] {
+export function compact<Item>(array: Item[], strict?: boolean): Item[] {
 	return strict === true
 		? array.filter(item => !!item)
 		: array.filter(item => item != null);

package/src/js/array/count.ts

@@ -1,29 +1,49 @@
-import type {BooleanCallback, KeyCallback} from '@/array/models';
-import {findValues} from '@/internal/array-find';
-import type {Key} from '@/models';
+import {findValues} from '~/internal/array/find';
+import type {BooleanCallback, KeyCallback} from '~/array/models';
 
 /**
- * Returns the number of items _(count)_ that match the given value
+ * Get the number of items _(count)_ that match the given value
  */
-export function count<Model, Value>(
-	array: Model[],
-	value: Value | BooleanCallback<Model>,
+export function count<Item>(array: Item[], value: Item): number;
+
+/**
+ * Get the number of items _(count)_ that match the given value
+ */
+export function count<Item>(
+	array: Item[],
+	matches: BooleanCallback<Item>,
+): number;
+
+/**
+ * Get the number of items _(count)_ that match the given value
+ */
+export function count<Item, Key extends keyof Item>(
+	array: Item[],
+	key: Key,
+	value: Item[Key],
 ): number;
 
 /**
- * - Returns the number of items _(count)_ that match the given value
- * - Use `key` to find a comparison value to match with `value`
+ * Get the number of items _(count)_ that match the given value
  */
-export function count<Model, Value = Model>(
-	array: Model[],
-	value: Value,
-	key: Key | KeyCallback<Model>,
+export function count<Item, Key extends KeyCallback<Item>>(
+	array: Item[],
+	key: Key,
+	value: ReturnType<Key>,
 ): number;
 
-export function count<Model, Value = Model>(
-	array: Model[],
-	value: Value | BooleanCallback<Model>,
-	key?: Key | KeyCallback<Model>,
-): number {
-	return findValues('all', array, value, key).length;
+export function count(array: unknown[], ...parameters: unknown[]): number {
+	const {length} = parameters;
+
+	return findValues(
+		'all',
+		array,
+		length === 1 && typeof parameters[0] === 'function'
+			? parameters[0]
+			: undefined,
+		length === 2 ? parameters[0] : undefined,
+		length === 1 && typeof parameters[0] !== 'function'
+			? parameters[0]
+			: parameters[1],
+	).length;
 }

package/src/js/array/exists.ts

@@ -1,29 +1,53 @@
-import type {BooleanCallback, KeyCallback} from '@/array/models';
-import {findValue} from '@/internal/array-find';
-import type {Key} from '@/models';
+import {findValue} from '~/internal/array/find';
+import type {BooleanCallback, KeyCallback} from './models';
 
 /**
  * Does the value exist in array?
  */
-export function exists<Model, Value>(
-	array: Model[],
-	value: Value | BooleanCallback<Model>,
+export function exists<Item>(array: Item[], value: Item): boolean;
+
+/**
+ * Does the value exist in array?
+ */
+export function exists<Item>(
+	array: Item[],
+	matches: BooleanCallback<Item>,
 ): boolean;
 
 /**
  * - Does the value exist in array?
  * - Use `key` to find a comparison value to match with `value`
  */
-export function exists<Model, Value = Model>(
-	array: Model[],
-	value: Value,
-	key: Key | KeyCallback<Model>,
+export function exists<Item, Key extends keyof Item>(
+	array: Item[],
+	key: Key,
+	value: Item[Key],
 ): boolean;
 
-export function exists<Model, Value = Model>(
-	array: Model[],
-	value: Value | BooleanCallback<Model>,
-	key?: Key | KeyCallback<Model>,
-): boolean {
-	return (findValue('index', array, value, key) as number) > -1;
+/**
+ * - Does the value exist in array?
+ * - Use `key` to find a comparison value to match with `value`
+ */
+export function exists<Item, Key extends KeyCallback<Item>>(
+	array: Item[],
+	key: Key,
+	value: ReturnType<Key>,
+): boolean;
+
+export function exists(array: unknown[], ...parameters: unknown[]): boolean {
+	const {length} = parameters;
+
+	return (
+		(findValue(
+			'index',
+			array,
+			length === 1 && typeof parameters[0] === 'function'
+				? parameters[0]
+				: undefined,
+			length === 2 ? parameters[0] : undefined,
+			length === 1 && typeof parameters[0] !== 'function'
+				? parameters[0]
+				: parameters[1],
+		) as number) > -1
+	);
 }