@oscarpalmer/atoms 0.75.0 → 0.77.0

package/dist/js/array/chunk.cjs

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const number = require("../number.cjs");
 function chunk(array, size) {
+  const chunkSize = number.clamp(size ?? 64e3, 1, 64e3);
   const { length } = array;
-  const chunkSize = typeof size === "number" && size > 0 ? size : 64e3;
   if (length <= chunkSize) {
     return [array];
   }

package/dist/js/array/chunk.js

@@ -1,6 +1,7 @@
+import { clamp } from "../number.js";
 function chunk(array, size) {
+  const chunkSize = clamp(size ?? 64e3, 1, 64e3);
   const { length } = array;
-  const chunkSize = typeof size === "number" && size > 0 ? size : 64e3;
   if (length <= chunkSize) {
     return [array];
   }

package/dist/js/array/count.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const internal_arrayFind = require("../internal/array-find.cjs");
-function count(array, value, key) {
-  return internal_arrayFind.findValues("all", array, value, key).length;
+const internal_array_find = require("../internal/array/find.cjs");
+function count(array, ...parameters) {
+  return internal_array_find.findValues("all", array, parameters).length;
 }
 exports.count = count;

package/dist/js/array/count.js

@@ -1,6 +1,6 @@
-import { findValues } from "../internal/array-find.js";
-function count(array, value, key) {
-  return findValues("all", array, value, key).length;
+import { findValues } from "../internal/array/find.js";
+function count(array, ...parameters) {
+  return findValues("all", array, parameters).length;
 }
 export {
   count

package/dist/js/array/exists.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const internal_arrayFind = require("../internal/array-find.cjs");
-function exists(array, value, key) {
-  return internal_arrayFind.findValue("index", array, value, key) > -1;
+const internal_array_find = require("../internal/array/find.cjs");
+function exists(array, ...parameters) {
+  return internal_array_find.findValue("index", array, parameters) > -1;
 }
 exports.exists = exists;

package/dist/js/array/exists.js

@@ -1,6 +1,6 @@
-import { findValue } from "../internal/array-find.js";
-function exists(array, value, key) {
-  return findValue("index", array, value, key) > -1;
+import { findValue } from "../internal/array/find.js";
+function exists(array, ...parameters) {
+  return findValue("index", array, parameters) > -1;
 }
 export {
   exists

package/dist/js/array/filter.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const internal_arrayFind = require("../internal/array-find.cjs");
-function filter(array, value, key) {
-  return internal_arrayFind.findValues("all", array, value, key);
+const internal_array_find = require("../internal/array/find.cjs");
+function filter(array, ...parameters) {
+  return internal_array_find.findValues("all", array, parameters);
 }
 exports.filter = filter;

package/dist/js/array/filter.js

@@ -1,6 +1,6 @@
-import { findValues } from "../internal/array-find.js";
-function filter(array, value, key) {
-  return findValues("all", array, value, key);
+import { findValues } from "../internal/array/find.js";
+function filter(array, ...parameters) {
+  return findValues("all", array, parameters);
 }
 export {
   filter

package/dist/js/array/find.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const internal_arrayFind = require("../internal/array-find.cjs");
-function find(array, value, key) {
-  return internal_arrayFind.findValue("value", array, value, key);
+const internal_array_find = require("../internal/array/find.cjs");
+function find(array, ...parameters) {
+  return internal_array_find.findValue("value", array, parameters);
 }
 exports.find = find;

package/dist/js/array/find.js

@@ -1,6 +1,6 @@
-import { findValue } from "../internal/array-find.js";
-function find(array, value, key) {
-  return findValue("value", array, value, key);
+import { findValue } from "../internal/array/find.js";
+function find(array, ...parameters) {
+  return findValue("value", array, parameters);
 }
 export {
   find

package/dist/js/array/group-by.cjs

@@ -1,30 +1,32 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const internal_arrayCallbacks = require("../internal/array-callbacks.cjs");
-function groupBy(array, key) {
-  return groupValues(array, key, true, false);
+const internal_array_callbacks = require("../internal/array/callbacks.cjs");
+function groupBy(array, first, second, third) {
+  return groupValues(
+    array,
+    first,
+    second,
+    first === true || second === true || third === true
+  );
 }
-function groupValues(array, key, arrays, indicable) {
-  var _a;
-  const callbacks = internal_arrayCallbacks.getCallbacks(void 0, key);
-  const hasCallback = typeof (callbacks == null ? void 0 : callbacks.key) === "function";
-  if (!hasCallback && !indicable) {
-    return {};
-  }
+function groupValues(array, key, value, arrays) {
+  var _a, _b;
+  const callbacks = internal_array_callbacks.getCallbacks(void 0, key, value);
   const record = {};
   const { length } = array;
   for (let index = 0; index < length; index += 1) {
-    const value = array[index];
-    const key2 = hasCallback ? ((_a = callbacks == null ? void 0 : callbacks.key) == null ? void 0 : _a.call(callbacks, value, index, array)) ?? index : index;
+    const item = array[index];
+    const key2 = ((_a = callbacks == null ? void 0 : callbacks.key) == null ? void 0 : _a.call(callbacks, item, index, array)) ?? index;
+    const value2 = ((_b = callbacks == null ? void 0 : callbacks.value) == null ? void 0 : _b.call(callbacks, item, index, array)) ?? item;
     if (arrays) {
       const existing = record[key2];
-      if (Array.isArray(existing)) {
-        existing.push(value);
+      if (existing == null) {
+        record[key2] = [value2];
       } else {
-        record[key2] = [value];
+        existing.push(value2);
       }
     } else {
-      record[key2] = value;
+      record[key2] = value2;
     }
   }
   return record;

package/dist/js/array/group-by.js

@@ -1,28 +1,30 @@
-import { getCallbacks } from "../internal/array-callbacks.js";
-function groupBy(array, key) {
-  return groupValues(array, key, true, false);
+import { getCallbacks } from "../internal/array/callbacks.js";
+function groupBy(array, first, second, third) {
+  return groupValues(
+    array,
+    first,
+    second,
+    first === true || second === true || third === true
+  );
 }
-function groupValues(array, key, arrays, indicable) {
-  var _a;
-  const callbacks = getCallbacks(void 0, key);
-  const hasCallback = typeof (callbacks == null ? void 0 : callbacks.key) === "function";
-  if (!hasCallback && !indicable) {
-    return {};
-  }
+function groupValues(array, key, value, arrays) {
+  var _a, _b;
+  const callbacks = getCallbacks(void 0, key, value);
   const record = {};
   const { length } = array;
   for (let index = 0; index < length; index += 1) {
-    const value = array[index];
-    const key2 = hasCallback ? ((_a = callbacks == null ? void 0 : callbacks.key) == null ? void 0 : _a.call(callbacks, value, index, array)) ?? index : index;
+    const item = array[index];
+    const key2 = ((_a = callbacks == null ? void 0 : callbacks.key) == null ? void 0 : _a.call(callbacks, item, index, array)) ?? index;
+    const value2 = ((_b = callbacks == null ? void 0 : callbacks.value) == null ? void 0 : _b.call(callbacks, item, index, array)) ?? item;
     if (arrays) {
       const existing = record[key2];
-      if (Array.isArray(existing)) {
-        existing.push(value);
+      if (existing == null) {
+        record[key2] = [value2];
       } else {
-        record[key2] = [value];
+        existing.push(value2);
       }
     } else {
-      record[key2] = value;
+      record[key2] = value2;
     }
   }
   return record;

package/dist/js/array/index-of.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const internal_arrayFind = require("../internal/array-find.cjs");
-function indexOf(array, value, key) {
-  return internal_arrayFind.findValue("index", array, value, key);
+const internal_array_find = require("../internal/array/find.cjs");
+function indexOf(array, ...parameters) {
+  return internal_array_find.findValue("index", array, parameters);
 }
 exports.indexOf = indexOf;

package/dist/js/array/index-of.js

@@ -1,6 +1,6 @@
-import { findValue } from "../internal/array-find.js";
-function indexOf(array, value, key) {
-  return findValue("index", array, value, key);
+import { findValue } from "../internal/array/find.js";
+function indexOf(array, ...parameters) {
+  return findValue("index", array, parameters);
 }
 export {
   indexOf

package/dist/js/array/index.cjs

@@ -18,8 +18,8 @@ const array_unique = require("./unique.cjs");
 function flatten(array) {
   return array.flat(Number.POSITIVE_INFINITY);
 }
-function push(array, values) {
-  return array_insert.insertValues("push", array, values, array.length, 0);
+function push(array, pushed) {
+  return array_insert.insertValues("push", array, pushed, array.length, 0);
 }
 exports.insert = array_insert.insert;
 exports.chunk = array_chunk.chunk;

package/dist/js/array/index.js

@@ -17,8 +17,8 @@ import { unique } from "./unique.js";
 function flatten(array) {
   return array.flat(Number.POSITIVE_INFINITY);
 }
-function push(array, values) {
-  return insertValues("push", array, values, array.length, 0);
+function push(array, pushed) {
+  return insertValues("push", array, pushed, array.length, 0);
 }
 export {
   chunk,

package/dist/js/array/insert.cjs

@@ -1,11 +1,17 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const array_chunk = require("./chunk.cjs");
-function insert(array, index, values) {
-  insertValues("splice", array, values, index, 0);
+function insert(array, first, second) {
+  insertValues(
+    "splice",
+    array,
+    Array.isArray(first) ? first : second ?? [],
+    typeof first === "number" ? first : array.length,
+    0
+  );
 }
-function insertValues(type, array, values, start, deleteCount) {
-  const chunked = array_chunk.chunk(values);
+function insertValues(type, array, items, start, deleteCount) {
+  const chunked = array_chunk.chunk(items);
   const lastIndex = chunked.length - 1;
   let index = Number(chunked.length);
   let returned;

package/dist/js/array/insert.js

@@ -1,9 +1,15 @@
 import { chunk } from "./chunk.js";
-function insert(array, index, values) {
-  insertValues("splice", array, values, index, 0);
+function insert(array, first, second) {
+  insertValues(
+    "splice",
+    array,
+    Array.isArray(first) ? first : second ?? [],
+    typeof first === "number" ? first : array.length,
+    0
+  );
 }
-function insertValues(type, array, values, start, deleteCount) {
-  const chunked = chunk(values);
+function insertValues(type, array, items, start, deleteCount) {
+  const chunked = chunk(items);
   const lastIndex = chunked.length - 1;
   let index = Number(chunked.length);
   let returned;

package/dist/js/array/splice.cjs

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const array_insert = require("./insert.cjs");
-function splice(array, start, amountOrValues, values) {
-  const amoutOrValuesIsArray = Array.isArray(amountOrValues);
+function splice(array, start, first, second) {
+  const isArray = Array.isArray(first);
   return array_insert.insertValues(
     "splice",
     array,
-    amoutOrValuesIsArray ? amountOrValues : values ?? [],
+    isArray ? first : second ?? [],
     start,
-    amoutOrValuesIsArray ? array.length : typeof amountOrValues === "number" && amountOrValues > 0 ? amountOrValues : 0
+    isArray ? array.length : typeof first === "number" && first > 0 ? first : 0
   );
 }
 exports.splice = splice;

package/dist/js/array/splice.js

@@ -1,12 +1,12 @@
 import { insertValues } from "./insert.js";
-function splice(array, start, amountOrValues, values) {
-  const amoutOrValuesIsArray = Array.isArray(amountOrValues);
+function splice(array, start, first, second) {
+  const isArray = Array.isArray(first);
   return insertValues(
     "splice",
     array,
-    amoutOrValuesIsArray ? amountOrValues : values ?? [],
+    isArray ? first : second ?? [],
     start,
-    amoutOrValuesIsArray ? array.length : typeof amountOrValues === "number" && amountOrValues > 0 ? amountOrValues : 0
+    isArray ? array.length : typeof first === "number" && first > 0 ? first : 0
   );
 }
 export {

package/dist/js/array/to-map.cjs

@@ -1,22 +1,22 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const internal_arrayCallbacks = require("../internal/array-callbacks.cjs");
-function toMap(array, first, second) {
-  var _a;
-  const asArrays = first === true || second === true;
-  const callbacks = internal_arrayCallbacks.getCallbacks(void 0, first);
-  const hasCallback = typeof (callbacks == null ? void 0 : callbacks.key) === "function";
+const internal_array_callbacks = require("../internal/array/callbacks.cjs");
+function toMap(array, first, second, third) {
+  var _a, _b;
+  const asArrays = first === true || second === true || third === true;
+  const callbacks = internal_array_callbacks.getCallbacks(void 0, first, second);
   const map = /* @__PURE__ */ new Map();
   const { length } = array;
   for (let index = 0; index < length; index += 1) {
-    const value = array[index];
-    const key = hasCallback ? ((_a = callbacks == null ? void 0 : callbacks.key) == null ? void 0 : _a.call(callbacks, value, index, array)) ?? index : index;
+    const item = array[index];
+    const key = ((_a = callbacks == null ? void 0 : callbacks.key) == null ? void 0 : _a.call(callbacks, item, index, array)) ?? index;
+    const value = ((_b = callbacks == null ? void 0 : callbacks.value) == null ? void 0 : _b.call(callbacks, item, index, array)) ?? item;
     if (asArrays) {
       const existing = map.get(key);
-      if (Array.isArray(existing)) {
-        existing.push(value);
-      } else {
+      if (existing == null) {
         map.set(key, [value]);
+      } else {
+        existing.push(value);
       }
     } else {
       map.set(key, value);

package/dist/js/array/to-map.js

@@ -1,20 +1,20 @@
-import { getCallbacks } from "../internal/array-callbacks.js";
-function toMap(array, first, second) {
-  var _a;
-  const asArrays = first === true || second === true;
-  const callbacks = getCallbacks(void 0, first);
-  const hasCallback = typeof (callbacks == null ? void 0 : callbacks.key) === "function";
+import { getCallbacks } from "../internal/array/callbacks.js";
+function toMap(array, first, second, third) {
+  var _a, _b;
+  const asArrays = first === true || second === true || third === true;
+  const callbacks = getCallbacks(void 0, first, second);
   const map = /* @__PURE__ */ new Map();
   const { length } = array;
   for (let index = 0; index < length; index += 1) {
-    const value = array[index];
-    const key = hasCallback ? ((_a = callbacks == null ? void 0 : callbacks.key) == null ? void 0 : _a.call(callbacks, value, index, array)) ?? index : index;
+    const item = array[index];
+    const key = ((_a = callbacks == null ? void 0 : callbacks.key) == null ? void 0 : _a.call(callbacks, item, index, array)) ?? index;
+    const value = ((_b = callbacks == null ? void 0 : callbacks.value) == null ? void 0 : _b.call(callbacks, item, index, array)) ?? item;
     if (asArrays) {
       const existing = map.get(key);
-      if (Array.isArray(existing)) {
-        existing.push(value);
-      } else {
+      if (existing == null) {
         map.set(key, [value]);
+      } else {
+        existing.push(value);
       }
     } else {
       map.set(key, value);

package/dist/js/array/to-record.cjs

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const array_groupBy = require("./group-by.cjs");
-function toRecord(array, first, second) {
+function toRecord(array, first, second, third) {
   return array_groupBy.groupValues(
     array,
     first,
-    first === true || second === true,
-    true
+    second,
+    first === true || second === true || third === true
   );
 }
 exports.toRecord = toRecord;

package/dist/js/array/to-record.js

@@ -1,10 +1,10 @@
 import { groupValues } from "./group-by.js";
-function toRecord(array, first, second) {
+function toRecord(array, first, second, third) {
   return groupValues(
     array,
     first,
-    first === true || second === true,
-    true
+    second,
+    first === true || second === true || third === true
   );
 }
 export {

package/dist/js/array/unique.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const internal_arrayFind = require("../internal/array-find.cjs");
+const internal_array_find = require("../internal/array/find.cjs");
 function unique(array, key) {
-  return internal_arrayFind.findValues("unique", array, void 0, key);
+  return internal_array_find.findValues("unique", array, [key, void 0]);
 }
 exports.unique = unique;

package/dist/js/array/unique.js

@@ -1,6 +1,6 @@
-import { findValues } from "../internal/array-find.js";
+import { findValues } from "../internal/array/find.js";
 function unique(array, key) {
-  return findValues("unique", array, void 0, key);
+  return findValues("unique", array, [key, void 0]);
 }
 export {
   unique

package/dist/js/colour/base.cjs

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const colour_is = require("./is.cjs");
 class Colour {
   /**
-   * Gets the current value of the colour
+   * Get the current value of the colour
    */
   get value() {
     return { ...this.state.value };

package/dist/js/colour/base.js

@@ -1,7 +1,7 @@
 import { isColourValue } from "./is.js";
 class Colour {
   /**
-   * Gets the current value of the colour
+   * Get the current value of the colour
    */
   get value() {
     return { ...this.state.value };

package/dist/js/colour/hex.cjs

@@ -13,13 +13,13 @@ class HexColour {
     };
   }
   /**
-   * Gets the value of the colour
+   * Get the value of the colour
    */
   get value() {
     return `#${this.state.value}`;
   }
   /**
-   * Sets the value of the colour
+   * Set the value of the colour
    */
   set value(value) {
     this.state.value = colour_functions.anyPattern.test(value) ? colour_functions.getNormalisedHex(value) : "000000";

package/dist/js/colour/hex.js

@@ -11,13 +11,13 @@ class HexColour {
     };
   }
   /**
-   * Gets the value of the colour
+   * Get the value of the colour
    */
   get value() {
     return `#${this.state.value}`;
   }
   /**
-   * Sets the value of the colour
+   * Set the value of the colour
    */
   set value(value) {
     this.state.value = anyPattern.test(value) ? getNormalisedHex(value) : "000000";

package/dist/js/colour/hsl.cjs

@@ -5,37 +5,37 @@ const colour_functions = require("./functions.cjs");
 const number = require("../number.cjs");
 class HSLColour extends colour_base.Colour {
   /**
-   * Gets the current hue
+   * Get the current hue
    */
   get hue() {
     return +this.state.value.hue;
   }
   /**
-   * Sets the current hue
+   * Set the current hue
    */
   set hue(value) {
     this.state.value.hue = number.clamp(value, 0, 360);
   }
   /**
-   * Gets the current lightness
+   * Get the current lightness
    */
   get lightness() {
     return +this.state.value.lightness;
   }
   /**
-   * Sets the current lightness
+   * Set the current lightness
    */
   set lightness(value) {
     this.state.value.lightness = number.clamp(value, 0, 100);
   }
   /**
-   * Gets the current saturation
+   * Get the current saturation
    */
   get saturation() {
     return +this.state.value.saturation;
   }
   /**
-   * Sets the current saturation
+   * Set the current saturation
    */
   set saturation(value) {
     this.state.value.saturation = number.clamp(value, 0, 100);
@@ -43,15 +43,21 @@ class HSLColour extends colour_base.Colour {
   constructor(value) {
     super("hsl", value, defaults, properties);
   }
+  /**
+   * @inheritdoc
+   */
   toHex() {
     return HSLColour.toRgb(this.state.value).toHex();
   }
   /**
-   * Converts the colour to an RGB-colour
+   * Convert the colour to an RGB-colour
    */
   toRgb() {
     return HSLColour.toRgb(this.state.value);
   }
+  /**
+   * @inheritdoc
+   */
   toString() {
     return `hsl(${this.state.value.hue}, ${this.state.value.saturation}%, ${this.state.value.lightness}%)`;
   }

package/dist/js/colour/hsl.js

@@ -3,37 +3,37 @@ import { hslToRgb } from "./functions.js";
 import { clamp } from "../number.js";
 class HSLColour extends Colour {
   /**
-   * Gets the current hue
+   * Get the current hue
    */
   get hue() {
     return +this.state.value.hue;
   }
   /**
-   * Sets the current hue
+   * Set the current hue
    */
   set hue(value) {
     this.state.value.hue = clamp(value, 0, 360);
   }
   /**
-   * Gets the current lightness
+   * Get the current lightness
    */
   get lightness() {
     return +this.state.value.lightness;
   }
   /**
-   * Sets the current lightness
+   * Set the current lightness
    */
   set lightness(value) {
     this.state.value.lightness = clamp(value, 0, 100);
   }
   /**
-   * Gets the current saturation
+   * Get the current saturation
    */
   get saturation() {
     return +this.state.value.saturation;
   }
   /**
-   * Sets the current saturation
+   * Set the current saturation
    */
   set saturation(value) {
     this.state.value.saturation = clamp(value, 0, 100);
@@ -41,15 +41,21 @@ class HSLColour extends Colour {
   constructor(value) {
     super("hsl", value, defaults, properties);
   }
+  /**
+   * @inheritdoc
+   */
   toHex() {
     return HSLColour.toRgb(this.state.value).toHex();
   }
   /**
-   * Converts the colour to an RGB-colour
+   * Convert the colour to an RGB-colour
    */
   toRgb() {
     return HSLColour.toRgb(this.state.value);
   }
+  /**
+   * @inheritdoc
+   */
   toString() {
     return `hsl(${this.state.value.hue}, ${this.state.value.saturation}%, ${this.state.value.lightness}%)`;
   }