@oscarpalmer/atoms 0.74.1 → 0.76.0

package/dist/js/internal/array/callbacks.cjs

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function getCallback(value) {
+  switch (typeof value) {
+    case "function":
+      return value;
+    case "number":
+    case "string":
+      return typeof value === "string" && value.includes(".") ? void 0 : (obj) => obj[value];
+    default:
+      return;
+  }
+}
+function getCallbacks(bool, key, value) {
+  if (typeof bool === "function") {
+    return { bool };
+  }
+  return {
+    key: getCallback(key),
+    value: getCallback(value)
+  };
+}
+exports.getCallbacks = getCallbacks;

package/dist/js/internal/array/callbacks.js

@@ -0,0 +1,23 @@
+function getCallback(value) {
+  switch (typeof value) {
+    case "function":
+      return value;
+    case "number":
+    case "string":
+      return typeof value === "string" && value.includes(".") ? void 0 : (obj) => obj[value];
+    default:
+      return;
+  }
+}
+function getCallbacks(bool, key, value) {
+  if (typeof bool === "function") {
+    return { bool };
+  }
+  return {
+    key: getCallback(key),
+    value: getCallback(value)
+  };
+}
+export {
+  getCallbacks
+};

package/dist/js/internal/array/find.cjs

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const internal_array_callbacks = require("./callbacks.cjs");
+function findValue(type, array, bool, key, value) {
+  var _a;
+  const callbacks = internal_array_callbacks.getCallbacks(bool, key);
+  if ((callbacks == null ? void 0 : callbacks.bool) == null && (callbacks == null ? void 0 : callbacks.key) == null) {
+    return type === "index" ? array.findIndex((item) => item === value) : array.find((item) => item === value);
+  }
+  if (callbacks.bool != null) {
+    const index = array.findIndex(callbacks.bool);
+    return type === "index" ? index : index > -1 ? array[index] : void 0;
+  }
+  const { length } = array;
+  for (let index = 0; index < length; index += 1) {
+    const item = array[index];
+    if (((_a = callbacks.key) == null ? void 0 : _a.call(callbacks, item, index, array)) === value) {
+      return type === "index" ? index : item;
+    }
+  }
+  return type === "index" ? -1 : void 0;
+}
+function findValues(type, array, bool, key, value) {
+  var _a;
+  const callbacks = internal_array_callbacks.getCallbacks(bool, key);
+  const { length } = array;
+  if (type === "unique" && (callbacks == null ? void 0 : callbacks.key) == null && length >= 100) {
+    return Array.from(new Set(array));
+  }
+  if ((callbacks == null ? void 0 : callbacks.bool) != null) {
+    return array.filter(callbacks.bool);
+  }
+  if (type === "all" && key == null) {
+    return array.filter((item) => item === value);
+  }
+  const result = [];
+  const values = (callbacks == null ? void 0 : callbacks.key) != null ? [] : result;
+  for (let index = 0; index < length; index += 1) {
+    const item = array[index];
+    const keyed = ((_a = callbacks == null ? void 0 : callbacks.key) == null ? void 0 : _a.call(callbacks, item, index, array)) ?? item;
+    if (type === "all" && keyed === value || type === "unique" && values.indexOf(keyed) === -1) {
+      if (values !== result) {
+        values.push(keyed);
+      }
+      result.push(item);
+    }
+  }
+  return result;
+}
+exports.findValue = findValue;
+exports.findValues = findValues;

package/dist/js/internal/array/find.js

@@ -0,0 +1,51 @@
+import { getCallbacks } from "./callbacks.js";
+function findValue(type, array, bool, key, value) {
+  var _a;
+  const callbacks = getCallbacks(bool, key);
+  if ((callbacks == null ? void 0 : callbacks.bool) == null && (callbacks == null ? void 0 : callbacks.key) == null) {
+    return type === "index" ? array.findIndex((item) => item === value) : array.find((item) => item === value);
+  }
+  if (callbacks.bool != null) {
+    const index = array.findIndex(callbacks.bool);
+    return type === "index" ? index : index > -1 ? array[index] : void 0;
+  }
+  const { length } = array;
+  for (let index = 0; index < length; index += 1) {
+    const item = array[index];
+    if (((_a = callbacks.key) == null ? void 0 : _a.call(callbacks, item, index, array)) === value) {
+      return type === "index" ? index : item;
+    }
+  }
+  return type === "index" ? -1 : void 0;
+}
+function findValues(type, array, bool, key, value) {
+  var _a;
+  const callbacks = getCallbacks(bool, key);
+  const { length } = array;
+  if (type === "unique" && (callbacks == null ? void 0 : callbacks.key) == null && length >= 100) {
+    return Array.from(new Set(array));
+  }
+  if ((callbacks == null ? void 0 : callbacks.bool) != null) {
+    return array.filter(callbacks.bool);
+  }
+  if (type === "all" && key == null) {
+    return array.filter((item) => item === value);
+  }
+  const result = [];
+  const values = (callbacks == null ? void 0 : callbacks.key) != null ? [] : result;
+  for (let index = 0; index < length; index += 1) {
+    const item = array[index];
+    const keyed = ((_a = callbacks == null ? void 0 : callbacks.key) == null ? void 0 : _a.call(callbacks, item, index, array)) ?? item;
+    if (type === "all" && keyed === value || type === "unique" && values.indexOf(keyed) === -1) {
+      if (values !== result) {
+        values.push(keyed);
+      }
+      result.push(item);
+    }
+  }
+  return result;
+}
+export {
+  findValue,
+  findValues
+};

package/dist/js/internal/value/handle.cjs

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function findKey(needle, haystack, ignoreCase) {
+  if (!ignoreCase) {
+    return needle;
+  }
+  const keys = Object.keys(haystack);
+  const normalised = keys.map((key) => key.toLowerCase());
+  const index = normalised.indexOf(needle.toLowerCase());
+  return index > -1 ? keys[index] : needle;
+}
+function handleValue(data, path, value, get, ignoreCase) {
+  if (typeof data === "object" && data !== null && !/^(__proto__|constructor|prototype)$/i.test(path)) {
+    const key = findKey(path, data, ignoreCase);
+    if (get) {
+      return data[key];
+    }
+    data[key] = value;
+  }
+}
+exports.handleValue = handleValue;

package/dist/js/internal/{value-handle.mjs → value/handle.js}

@@ -1,4 +1,3 @@
-// src/js/internal/value-handle.ts
 function findKey(needle, haystack, ignoreCase) {
   if (!ignoreCase) {
     return needle;

package/dist/js/{is.mjs → is.cjs}

@@ -1,5 +1,6 @@
-// src/js/is.ts
-import { getString } from "./string";
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const string_index = require("./string/index.cjs");
 function isArrayOrPlainObject(value) {
   return Array.isArray(value) || isPlainObject(value);
 }
@@ -7,7 +8,7 @@ function isEmpty(value) {
   const values = Object.values(value);
   const { length } = values;
   let count = 0;
-  for (let index = 0;index < length; index += 1) {
+  for (let index = 0; index < length; index += 1) {
     if (values[index] != null) {
       count += 1;
     }
@@ -21,10 +22,10 @@ function isNullable(value) {
   return value == null;
 }
 function isNullableOrEmpty(value) {
-  return value == null || getString(value) === "";
+  return value == null || string_index.getString(value) === "";
 }
 function isNullableOrWhitespace(value) {
-  return value == null || /^\s*$/.test(getString(value));
+  return value == null || /^\s*$/.test(string_index.getString(value));
 }
 function isNumber(value) {
   return typeof value === "number" && !Number.isNaN(value);
@@ -45,16 +46,14 @@ function isPlainObject(value) {
 function isPrimitive(value) {
   return value == null || /^(bigint|boolean|number|string|symbol)$/.test(typeof value);
 }
-export {
-  isPrimitive,
-  isPlainObject,
-  isObject,
-  isNumerical,
-  isNumber,
-  isNullableOrWhitespace,
-  isNullableOrEmpty,
-  isNullable,
-  isKey,
-  isEmpty,
-  isArrayOrPlainObject
-};
+exports.isArrayOrPlainObject = isArrayOrPlainObject;
+exports.isEmpty = isEmpty;
+exports.isKey = isKey;
+exports.isNullable = isNullable;
+exports.isNullableOrEmpty = isNullableOrEmpty;
+exports.isNullableOrWhitespace = isNullableOrWhitespace;
+exports.isNumber = isNumber;
+exports.isNumerical = isNumerical;
+exports.isObject = isObject;
+exports.isPlainObject = isPlainObject;
+exports.isPrimitive = isPrimitive;

package/dist/js/is.js

@@ -1,29 +1,17 @@
-// src/js/string/index.ts
-function getString(value) {
-  if (typeof value === "string") {
-    return value;
-  }
-  if (typeof value !== "object" || value == null) {
-    return String(value);
-  }
-  const valueOff = value.valueOf?.() ?? value;
-  const asString = valueOff?.toString?.() ?? String(valueOff);
-  return asString.startsWith("[object ") ? JSON.stringify(value) : asString;
-}
-// src/js/is.ts
+import { getString } from "./string/index.js";
 function isArrayOrPlainObject(value) {
   return Array.isArray(value) || isPlainObject(value);
 }
 function isEmpty(value) {
   const values = Object.values(value);
   const { length } = values;
-  let count2 = 0;
-  for (let index = 0;index < length; index += 1) {
+  let count = 0;
+  for (let index = 0; index < length; index += 1) {
     if (values[index] != null) {
-      count2 += 1;
+      count += 1;
     }
   }
-  return count2 === 0;
+  return count === 0;
 }
 function isKey(value) {
   return typeof value === "number" || typeof value === "string";
@@ -57,15 +45,15 @@ function isPrimitive(value) {
   return value == null || /^(bigint|boolean|number|string|symbol)$/.test(typeof value);
 }
 export {
-  isPrimitive,
-  isPlainObject,
-  isObject,
-  isNumerical,
-  isNumber,
-  isNullableOrWhitespace,
-  isNullableOrEmpty,
-  isNullable,
-  isKey,
+  isArrayOrPlainObject,
   isEmpty,
-  isArrayOrPlainObject
+  isKey,
+  isNullable,
+  isNullableOrEmpty,
+  isNullableOrWhitespace,
+  isNumber,
+  isNumerical,
+  isObject,
+  isPlainObject,
+  isPrimitive
 };

package/dist/js/logger.cjs

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const _function = require("./function.cjs");
+if (globalThis._atomic_logging == null) {
+  globalThis._atomic_logging = true;
+}
+class Logger {
+  /**
+   * Log any number of values at the "debug" log level
+   */
+  get debug() {
+    return this.enabled ? console.debug : _function.noop;
+  }
+  /**
+   * Log the value and shows all its properties
+   */
+  get dir() {
+    return this.enabled ? console.dir : _function.noop;
+  }
+  /**
+   * Is logging to the console enabled? _(defaults to `true`)_
+   */
+  get enabled() {
+    return globalThis._atomic_logging ?? true;
+  }
+  /**
+   * Enable or disable logging to the console
+   */
+  set enabled(value) {
+    globalThis._atomic_logging = value;
+  }
+  /**
+   * Log any number of values at the "error" log level
+   */
+  get error() {
+    return this.enabled ? console.error : _function.noop;
+  }
+  /**
+   * Log any number of values at the "info" log level
+   */
+  get info() {
+    return this.enabled ? console.info : _function.noop;
+  }
+  /**
+   * Log any number of values at the "log" log level
+   */
+  get log() {
+    return this.enabled ? console.log : _function.noop;
+  }
+  /**
+   * Log data as a table, with optional properties to use as columns
+   */
+  get table() {
+    return this.enabled ? console.table : _function.noop;
+  }
+  /**
+   * Log any number of values together with a trace from where it was called
+   */
+  get trace() {
+    return this.enabled ? console.trace : _function.noop;
+  }
+  /**
+   * Log any number of values at the "warn" log level
+   */
+  get warn() {
+    return this.enabled ? console.warn : _function.noop;
+  }
+  /**
+   * - 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) {
+    return new Time(label);
+  }
+}
+class Time {
+  constructor(label) {
+    this.state = {
+      label,
+      started: globalThis._atomic_logging ?? true,
+      stopped: false
+    };
+    if (this.state.started) {
+      console.time(label);
+    }
+  }
+  /**
+   * - Log the current duration of the timer
+   * - _(Ignored if logging is disabled)_
+   */
+  log() {
+    if (this.state.started && !this.state.stopped && logger.enabled) {
+      console.timeLog(this.state.label);
+    }
+  }
+  /**
+   * - 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) {
+      this.state.stopped = true;
+      console.timeEnd(this.state.label);
+    }
+  }
+}
+const logger = new Logger();
+exports.logger = logger;

package/dist/js/logger.js

@@ -1,48 +1,76 @@
-// src/js/function.ts
-function noop() {
-}
-
-// src/js/logger.ts
+import { noop } from "./function.js";
 if (globalThis._atomic_logging == null) {
   globalThis._atomic_logging = true;
 }
-
 class Logger {
+  /**
+   * Log any number of values at the "debug" log level
+   */
   get debug() {
     return this.enabled ? console.debug : noop;
   }
+  /**
+   * Log the value and shows all its properties
+   */
   get dir() {
     return this.enabled ? console.dir : noop;
   }
+  /**
+   * Is logging to the console enabled? _(defaults to `true`)_
+   */
   get enabled() {
     return globalThis._atomic_logging ?? true;
   }
+  /**
+   * Enable or disable logging to the console
+   */
   set enabled(value) {
     globalThis._atomic_logging = value;
   }
+  /**
+   * Log any number of values at the "error" log level
+   */
   get error() {
     return this.enabled ? console.error : noop;
   }
+  /**
+   * Log any number of values at the "info" log level
+   */
   get info() {
     return this.enabled ? console.info : noop;
   }
+  /**
+   * Log any number of values at the "log" log level
+   */
   get log() {
     return this.enabled ? console.log : noop;
   }
+  /**
+   * Log data as a table, with optional properties to use as columns
+   */
   get table() {
     return this.enabled ? console.table : noop;
   }
+  /**
+   * Log any number of values together with a trace from where it was called
+   */
   get trace() {
     return this.enabled ? console.trace : noop;
   }
+  /**
+   * Log any number of values at the "warn" log level
+   */
   get warn() {
     return this.enabled ? console.warn : noop;
   }
+  /**
+   * - 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) {
     return new Time(label);
   }
 }
-
 class Time {
   constructor(label) {
     this.state = {
@@ -54,11 +82,19 @@ class Time {
       console.time(label);
     }
   }
+  /**
+   * - Log the current duration of the timer
+   * - _(Ignored if logging is disabled)_
+   */
   log() {
     if (this.state.started && !this.state.stopped && logger.enabled) {
       console.timeLog(this.state.label);
     }
   }
+  /**
+   * - 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) {
       this.state.stopped = true;
@@ -66,7 +102,7 @@ class Time {
     }
   }
 }
-var logger = new Logger;
+const logger = new Logger();
 export {
   logger
 };

package/dist/js/{math.mjs → math.cjs}

@@ -1,4 +1,5 @@
-// src/js/math.ts
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 function average(values) {
   return values.length > 0 ? sum(values) / values.length : Number.NaN;
 }
@@ -18,10 +19,8 @@ function round(value, decimals) {
 function sum(values) {
   return values.reduce((previous, current) => previous + current, 0);
 }
-export {
-  sum,
-  round,
-  min,
-  max,
-  average
-};
+exports.average = average;
+exports.max = max;
+exports.min = min;
+exports.round = round;
+exports.sum = sum;

package/dist/js/math.js

@@ -1,4 +1,3 @@
-// src/js/math.ts
 function average(values) {
   return values.length > 0 ? sum(values) / values.length : Number.NaN;
 }
@@ -19,9 +18,9 @@ function sum(values) {
   return values.reduce((previous, current) => previous + current, 0);
 }
 export {
-  sum,
-  round,
-  min,
+  average,
   max,
-  average
+  min,
+  round,
+  sum
 };

package/dist/js/models.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/js/models.js

@@ -0,0 +1 @@
+

package/dist/js/{number.mjs → number.cjs}

@@ -1,4 +1,5 @@
-// src/js/number.ts
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 function between(value, min, max) {
   return value >= min && value <= max;
 }
@@ -9,15 +10,16 @@ function clamp(value, min, max, loop) {
   return value > max ? loop === true ? min : max : value;
 }
 function getNumber(value) {
+  var _a;
   if (typeof value === "number") {
     return value;
   }
   if (typeof value === "symbol") {
     return Number.NaN;
   }
-  let parsed = value?.valueOf?.() ?? value;
+  let parsed = ((_a = value == null ? void 0 : value.valueOf) == null ? void 0 : _a.call(value)) ?? value;
   if (typeof parsed === "object") {
-    parsed = parsed?.toString() ?? parsed;
+    parsed = (parsed == null ? void 0 : parsed.toString()) ?? parsed;
   }
   if (typeof parsed !== "string") {
     return parsed == null ? Number.NaN : typeof parsed === "number" ? parsed : +parsed;
@@ -35,8 +37,6 @@ function getNumber(value) {
   }
   return +(/^0x[0-9a-f]+$/i.test(trimmed) ? trimmed : trimmed.replace(/_/g, ""));
 }
-export {
-  getNumber,
-  clamp,
-  between
-};
+exports.between = between;
+exports.clamp = clamp;
+exports.getNumber = getNumber;

package/dist/js/number.js

@@ -1,4 +1,3 @@
-// src/js/number.ts
 function between(value, min, max) {
   return value >= min && value <= max;
 }
@@ -9,15 +8,16 @@ function clamp(value, min, max, loop) {
   return value > max ? loop === true ? min : max : value;
 }
 function getNumber(value) {
+  var _a;
   if (typeof value === "number") {
     return value;
   }
   if (typeof value === "symbol") {
     return Number.NaN;
   }
-  let parsed = value?.valueOf?.() ?? value;
+  let parsed = ((_a = value == null ? void 0 : value.valueOf) == null ? void 0 : _a.call(value)) ?? value;
   if (typeof parsed === "object") {
-    parsed = parsed?.toString() ?? parsed;
+    parsed = (parsed == null ? void 0 : parsed.toString()) ?? parsed;
   }
   if (typeof parsed !== "string") {
     return parsed == null ? Number.NaN : typeof parsed === "number" ? parsed : +parsed;
@@ -36,7 +36,7 @@ function getNumber(value) {
   return +(/^0x[0-9a-f]+$/i.test(trimmed) ? trimmed : trimmed.replace(/_/g, ""));
 }
 export {
-  getNumber,
+  between,
   clamp,
-  between
+  getNumber
 };