@oscarpalmer/atoms 0.80.0 → 0.82.0

package/dist/array/chunk.cjs

@@ -1,17 +1,15 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const number = require("../number.cjs");
-function chunk(array, size) {
-  const chunkSize = number.clamp(size ?? 5e3, 1, 5e3);
+function chunk(array) {
   const { length } = array;
-  if (length <= chunkSize) {
+  if (length <= 5e3) {
     return [array];
   }
   const chunks = [];
-  let remaining = Number(length);
-  while (remaining > 0) {
-    chunks.push(array.splice(0, chunkSize));
-    remaining -= chunkSize;
+  let index = 0;
+  while (index < length) {
+    chunks.push(array.slice(index, index + 5e3));
+    index += 5e3;
   }
   return chunks;
 }

package/dist/array/chunk.js

@@ -1,15 +1,13 @@
-import { clamp } from "../number.js";
-function chunk(array, size) {
-  const chunkSize = clamp(size ?? 5e3, 1, 5e3);
+function chunk(array) {
   const { length } = array;
-  if (length <= chunkSize) {
+  if (length <= 5e3) {
     return [array];
   }
   const chunks = [];
-  let remaining = Number(length);
-  while (remaining > 0) {
-    chunks.push(array.splice(0, chunkSize));
-    remaining -= chunkSize;
+  let index = 0;
+  while (index < length) {
+    chunks.push(array.slice(index, index + 5e3));
+    index += 5e3;
   }
   return chunks;
 }

package/dist/array/compact.cjs

@@ -1,6 +1,15 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 function compact(array, strict) {
-  return strict === true ? array.filter((item) => !!item) : array.filter((item) => item != null);
+  const isStrict = strict ?? false;
+  const { length } = array;
+  const compacted = [];
+  for (let index = 0; index < length; index += 1) {
+    const item = array[index];
+    if (isStrict && !!item || !isStrict && item != null) {
+      compacted.push(item);
+    }
+  }
+  return compacted;
 }
 exports.compact = compact;

package/dist/array/compact.js

@@ -1,5 +1,14 @@
 function compact(array, strict) {
-  return strict === true ? array.filter((item) => !!item) : array.filter((item) => item != null);
+  const isStrict = strict ?? false;
+  const { length } = array;
+  const compacted = [];
+  for (let index = 0; index < length; index += 1) {
+    const item = array[index];
+    if (isStrict && !!item || !isStrict && item != null) {
+      compacted.push(item);
+    }
+  }
+  return compacted;
 }
 export {
   compact

package/dist/{colour → color}/base.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const colour_is = require("./is.cjs");
+const color_is = require("./is.cjs");
 const defaults = {
   hsl: {
     hue: 0,
@@ -18,26 +18,26 @@ const properties = {
   rgb: ["blue", "green", "red"]
 };
 function getValue(value, type) {
-  return colour_is.isColourValue(value, properties[type]) ? { ...value } : { ...defaults[type] };
+  return color_is.isColorValue(value, properties[type]) ? { ...value } : { ...defaults[type] };
 }
-class Colour {
+class Color {
   /**
-   * Get the current value of the colour
+   * Get the current value of the color
    */
   get value() {
     return { ...this.state.value };
   }
   /**
-   * Set the current value of the colour
+   * Set the current value of the color
    */
   set value(value) {
-    this.state.value = getValue(value, this.$colour);
+    this.state.value = getValue(value, this.$color);
   }
   constructor(type, value) {
-    this.$colour = type;
+    this.$color = type;
     this.state = {
       value: getValue(value, type)
     };
   }
 }
-exports.Colour = Colour;
+exports.Color = Color;

package/dist/{colour → color}/base.js

@@ -1,4 +1,4 @@
-import { isColourValue } from "./is.js";
+import { isColorValue } from "./is.js";
 const defaults = {
   hsl: {
     hue: 0,
@@ -16,28 +16,28 @@ const properties = {
   rgb: ["blue", "green", "red"]
 };
 function getValue(value, type) {
-  return isColourValue(value, properties[type]) ? { ...value } : { ...defaults[type] };
+  return isColorValue(value, properties[type]) ? { ...value } : { ...defaults[type] };
 }
-class Colour {
+class Color {
   /**
-   * Get the current value of the colour
+   * Get the current value of the color
    */
   get value() {
     return { ...this.state.value };
   }
   /**
-   * Set the current value of the colour
+   * Set the current value of the color
    */
   set value(value) {
-    this.state.value = getValue(value, this.$colour);
+    this.state.value = getValue(value, this.$color);
   }
   constructor(type, value) {
-    this.$colour = type;
+    this.$color = type;
     this.state = {
       value: getValue(value, type)
     };
   }
 }
 export {
-  Colour
+  Color
 };

package/dist/{colour → color}/functions.cjs

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const number = require("../number.cjs");
-const colour_hex = require("./hex.cjs");
-const colour_hsl = require("./hsl.cjs");
-const colour_rgb = require("./rgb.cjs");
+const color_hex = require("./hex.cjs");
+const color_hsl = require("./hsl.cjs");
+const color_rgb = require("./rgb.cjs");
 const anyPattern = /^#*([a-f0-9]{3}){1,2}$/i;
 const groupedPattern = /^#*([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})$/i;
 function getNormalisedHex(value) {
@@ -18,7 +18,7 @@ function hexToRgb(value) {
   for (let index = 1; index < length; index += 1) {
     rgb.push(Number.parseInt(pairs[index], 16));
   }
-  return new colour_rgb.RGBColour({
+  return new color_rgb.RGBColor({
     blue: rgb[2] ?? 0,
     green: rgb[1] ?? 0,
     red: rgb[0] ?? 0
@@ -36,16 +36,16 @@ function hslToRgb(value) {
     const mod = saturation * Math.min(lightness, 1 - lightness);
     return lightness - mod * Math.max(-1, Math.min(part - 3, 9 - part, 1));
   }
-  return new colour_rgb.RGBColour({
+  return new color_rgb.RGBColor({
     blue: number.clamp(Math.round(get(4) * 255), 0, 255),
     green: number.clamp(Math.round(get(8) * 255), 0, 255),
     red: number.clamp(Math.round(get(0) * 255), 0, 255)
   });
 }
 function rgbToHex(value) {
-  return new colour_hex.HexColour(
-    `${[value.red, value.green, value.blue].map((colour) => {
-      const hex = colour.toString(16);
+  return new color_hex.HexColor(
+    `${[value.red, value.green, value.blue].map((color) => {
+      const hex = color.toString(16);
       return hex.length === 1 ? `0${hex}` : hex;
     }).join("")}`
   );
@@ -82,7 +82,7 @@ function rgbToHsl(rgb) {
   if (hue >= 360) {
     hue -= 360;
   }
-  return new colour_hsl.HSLColour({
+  return new color_hsl.HSLColor({
     hue: +hue.toFixed(2),
     lightness: +(lightness * 100).toFixed(2),
     saturation: +(saturation * 100).toFixed(2)

package/dist/{colour → color}/functions.js

@@ -1,7 +1,7 @@
 import { clamp } from "../number.js";
-import { HexColour } from "./hex.js";
-import { HSLColour } from "./hsl.js";
-import { RGBColour } from "./rgb.js";
+import { HexColor } from "./hex.js";
+import { HSLColor } from "./hsl.js";
+import { RGBColor } from "./rgb.js";
 const anyPattern = /^#*([a-f0-9]{3}){1,2}$/i;
 const groupedPattern = /^#*([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})$/i;
 function getNormalisedHex(value) {
@@ -16,7 +16,7 @@ function hexToRgb(value) {
   for (let index = 1; index < length; index += 1) {
     rgb.push(Number.parseInt(pairs[index], 16));
   }
-  return new RGBColour({
+  return new RGBColor({
     blue: rgb[2] ?? 0,
     green: rgb[1] ?? 0,
     red: rgb[0] ?? 0
@@ -34,16 +34,16 @@ function hslToRgb(value) {
     const mod = saturation * Math.min(lightness, 1 - lightness);
     return lightness - mod * Math.max(-1, Math.min(part - 3, 9 - part, 1));
   }
-  return new RGBColour({
+  return new RGBColor({
     blue: clamp(Math.round(get(4) * 255), 0, 255),
     green: clamp(Math.round(get(8) * 255), 0, 255),
     red: clamp(Math.round(get(0) * 255), 0, 255)
   });
 }
 function rgbToHex(value) {
-  return new HexColour(
-    `${[value.red, value.green, value.blue].map((colour) => {
-      const hex = colour.toString(16);
+  return new HexColor(
+    `${[value.red, value.green, value.blue].map((color) => {
+      const hex = color.toString(16);
       return hex.length === 1 ? `0${hex}` : hex;
     }).join("")}`
   );
@@ -80,7 +80,7 @@ function rgbToHsl(rgb) {
   if (hue >= 360) {
     hue -= 360;
   }
-  return new HSLColour({
+  return new HSLColor({
     hue: +hue.toFixed(2),
     lightness: +(lightness * 100).toFixed(2),
     saturation: +(saturation * 100).toFixed(2)

package/dist/color/hex.cjs

@@ -0,0 +1,56 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const color_functions = require("./functions.cjs");
+class HexColor {
+  constructor(value) {
+    __publicField(this, "state");
+    this.$color = "hex";
+    this.state = {
+      value: typeof value === "string" && color_functions.anyPattern.test(value) ? color_functions.getNormalisedHex(value) : "000000"
+    };
+  }
+  /**
+   * Get the value of the color
+   */
+  get value() {
+    return `#${this.state.value}`;
+  }
+  /**
+   * Set the value of the color
+   */
+  set value(value) {
+    this.state.value = color_functions.anyPattern.test(value) ? color_functions.getNormalisedHex(value) : "000000";
+  }
+  /**
+   * Convert the color to an RGB-color
+   */
+  toHsl() {
+    return HexColor.toRgb(this.value).toHsl();
+  }
+  /**
+   * Convert the color to an HSL-color
+   */
+  toRgb() {
+    return HexColor.toRgb(this.value);
+  }
+  /**
+   * Get the color as a string _(prefixed with #)_
+   */
+  toString() {
+    return this.value;
+  }
+  /**
+   * Convert a hex-color to an RGB-color
+   */
+  static toRgb(value) {
+    return color_functions.hexToRgb(value);
+  }
+}
+function getHexColor(value) {
+  return new HexColor(value);
+}
+exports.HexColor = HexColor;
+exports.getHexColor = getHexColor;

package/dist/{colour → color}/hex.js

@@ -2,55 +2,55 @@ var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import { anyPattern, getNormalisedHex, hexToRgb } from "./functions.js";
-class HexColour {
+class HexColor {
   constructor(value) {
     __publicField(this, "state");
-    this.$colour = "hex";
+    this.$color = "hex";
     this.state = {
       value: typeof value === "string" && anyPattern.test(value) ? getNormalisedHex(value) : "000000"
     };
   }
   /**
-   * Get the value of the colour
+   * Get the value of the color
    */
   get value() {
     return `#${this.state.value}`;
   }
   /**
-   * Set the value of the colour
+   * Set the value of the color
    */
   set value(value) {
     this.state.value = anyPattern.test(value) ? getNormalisedHex(value) : "000000";
   }
   /**
-   * Convert the colour to an RGB-colour
+   * Convert the color to an RGB-color
    */
   toHsl() {
-    return HexColour.toRgb(this.value).toHsl();
+    return HexColor.toRgb(this.value).toHsl();
   }
   /**
-   * Convert the colour to an HSL-colour
+   * Convert the color to an HSL-color
    */
   toRgb() {
-    return HexColour.toRgb(this.value);
+    return HexColor.toRgb(this.value);
   }
   /**
-   * Get the colour as a string _(prefixed with #)_
+   * Get the color as a string _(prefixed with #)_
    */
   toString() {
     return this.value;
   }
   /**
-   * Convert a hex-colour to an RGB-colour
+   * Convert a hex-color to an RGB-color
    */
   static toRgb(value) {
     return hexToRgb(value);
   }
 }
-function getHexColour(value) {
-  return new HexColour(value);
+function getHexColor(value) {
+  return new HexColor(value);
 }
 export {
-  HexColour,
-  getHexColour
+  HexColor,
+  getHexColor
 };

package/dist/{colour → color}/hsl.cjs

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const number = require("../number.cjs");
-const colour_base = require("./base.cjs");
-const colour_functions = require("./functions.cjs");
-class HSLColour extends colour_base.Colour {
+const color_base = require("./base.cjs");
+const color_functions = require("./functions.cjs");
+class HSLColor extends color_base.Color {
   /**
    * Get the current hue
    */
@@ -47,13 +47,13 @@ class HSLColour extends colour_base.Colour {
    * @inheritdoc
    */
   toHex() {
-    return HSLColour.toRgb(this.state.value).toHex();
+    return HSLColor.toRgb(this.state.value).toHex();
   }
   /**
-   * Convert the colour to an RGB-colour
+   * Convert the color to an RGB-color
    */
   toRgb() {
-    return HSLColour.toRgb(this.state.value);
+    return HSLColor.toRgb(this.state.value);
   }
   /**
    * @inheritdoc
@@ -62,14 +62,14 @@ class HSLColour extends colour_base.Colour {
     return `hsl(${this.state.value.hue}, ${this.state.value.saturation}%, ${this.state.value.lightness}%)`;
   }
   /**
-   * Convert an HSL-colour to an RGB-colour
+   * Convert an HSL-color to an RGB-color
    */
   static toRgb(value) {
-    return colour_functions.hslToRgb(value);
+    return color_functions.hslToRgb(value);
   }
 }
-function getHSLColour(value) {
-  return new HSLColour(value);
+function getHSLColor(value) {
+  return new HSLColor(value);
 }
-exports.HSLColour = HSLColour;
-exports.getHSLColour = getHSLColour;
+exports.HSLColor = HSLColor;
+exports.getHSLColor = getHSLColor;

package/dist/{colour → color}/hsl.js

@@ -1,7 +1,7 @@
 import { clamp } from "../number.js";
-import { Colour } from "./base.js";
+import { Color } from "./base.js";
 import { hslToRgb } from "./functions.js";
-class HSLColour extends Colour {
+class HSLColor extends Color {
   /**
    * Get the current hue
    */
@@ -45,13 +45,13 @@ class HSLColour extends Colour {
    * @inheritdoc
    */
   toHex() {
-    return HSLColour.toRgb(this.state.value).toHex();
+    return HSLColor.toRgb(this.state.value).toHex();
   }
   /**
-   * Convert the colour to an RGB-colour
+   * Convert the color to an RGB-color
    */
   toRgb() {
-    return HSLColour.toRgb(this.state.value);
+    return HSLColor.toRgb(this.state.value);
   }
   /**
    * @inheritdoc
@@ -60,16 +60,16 @@ class HSLColour extends Colour {
     return `hsl(${this.state.value.hue}, ${this.state.value.saturation}%, ${this.state.value.lightness}%)`;
   }
   /**
-   * Convert an HSL-colour to an RGB-colour
+   * Convert an HSL-color to an RGB-color
    */
   static toRgb(value) {
     return hslToRgb(value);
   }
 }
-function getHSLColour(value) {
-  return new HSLColour(value);
+function getHSLColor(value) {
+  return new HSLColor(value);
 }
 export {
-  HSLColour,
-  getHSLColour
+  HSLColor,
+  getHSLColor
 };

package/dist/color/index.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const color_functions = require("./functions.cjs");
+const color_hex = require("./hex.cjs");
+const color_hsl = require("./hsl.cjs");
+const color_is = require("./is.cjs");
+const color_rgb = require("./rgb.cjs");
+function getForegroundColor(value) {
+  const values = [value.blue / 255, value.green / 255, value.red / 255];
+  for (let color of values) {
+    if (color <= 0.03928) {
+      color /= 12.92;
+    } else {
+      color = ((color + 0.055) / 1.055) ** 2.4;
+    }
+  }
+  const luminance = 0.2126 * values[2] + 0.7152 * values[1] + 0.0722 * values[0];
+  return luminance > 0.625 ? "black" : "white";
+}
+exports.hexToRgb = color_functions.hexToRgb;
+exports.hslToRgb = color_functions.hslToRgb;
+exports.rgbToHex = color_functions.rgbToHex;
+exports.rgbToHsl = color_functions.rgbToHsl;
+exports.HexColor = color_hex.HexColor;
+exports.getHexColor = color_hex.getHexColor;
+exports.HSLColor = color_hsl.HSLColor;
+exports.getHSLColor = color_hsl.getHSLColor;
+exports.isColor = color_is.isColor;
+exports.isHSLColor = color_is.isHSLColor;
+exports.isHexColor = color_is.isHexColor;
+exports.isRGBColor = color_is.isRGBColor;
+exports.RGBColor = color_rgb.RGBColor;
+exports.getRGBColor = color_rgb.getRGBColor;
+exports.getForegroundColor = getForegroundColor;

package/dist/color/index.js

@@ -0,0 +1,34 @@
+import { hexToRgb, hslToRgb, rgbToHex, rgbToHsl } from "./functions.js";
+import { HexColor, getHexColor } from "./hex.js";
+import { HSLColor, getHSLColor } from "./hsl.js";
+import { isColor, isHSLColor, isHexColor, isRGBColor } from "./is.js";
+import { RGBColor, getRGBColor } from "./rgb.js";
+function getForegroundColor(value) {
+  const values = [value.blue / 255, value.green / 255, value.red / 255];
+  for (let color of values) {
+    if (color <= 0.03928) {
+      color /= 12.92;
+    } else {
+      color = ((color + 0.055) / 1.055) ** 2.4;
+    }
+  }
+  const luminance = 0.2126 * values[2] + 0.7152 * values[1] + 0.0722 * values[0];
+  return luminance > 0.625 ? "black" : "white";
+}
+export {
+  HSLColor,
+  HexColor,
+  RGBColor,
+  getForegroundColor,
+  getHSLColor,
+  getHexColor,
+  getRGBColor,
+  hexToRgb,
+  hslToRgb,
+  isColor,
+  isHSLColor,
+  isHexColor,
+  isRGBColor,
+  rgbToHex,
+  rgbToHsl
+};

package/dist/color/is.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function isColor(value) {
+  return isInstance(/^(hex|hsl|rgb)$/, value);
+}
+function isColorValue(value, properties) {
+  return typeof value === "object" && value !== null && properties.every(
+    (property) => property in value && typeof value[property] === "number"
+  );
+}
+function isHexColor(value) {
+  return isInstance(/^hex$/, value);
+}
+function isHSLColor(value) {
+  return isInstance(/^hsl$/, value);
+}
+function isInstance(pattern, value) {
+  return typeof value === "object" && value !== null && "$color" in value && typeof value.$color === "string" && pattern.test(value.$color);
+}
+function isRGBColor(value) {
+  return isInstance(/^rgb$/, value);
+}
+exports.isColor = isColor;
+exports.isColorValue = isColorValue;
+exports.isHSLColor = isHSLColor;
+exports.isHexColor = isHexColor;
+exports.isRGBColor = isRGBColor;

package/dist/color/is.js

@@ -0,0 +1,27 @@
+function isColor(value) {
+  return isInstance(/^(hex|hsl|rgb)$/, value);
+}
+function isColorValue(value, properties) {
+  return typeof value === "object" && value !== null && properties.every(
+    (property) => property in value && typeof value[property] === "number"
+  );
+}
+function isHexColor(value) {
+  return isInstance(/^hex$/, value);
+}
+function isHSLColor(value) {
+  return isInstance(/^hsl$/, value);
+}
+function isInstance(pattern, value) {
+  return typeof value === "object" && value !== null && "$color" in value && typeof value.$color === "string" && pattern.test(value.$color);
+}
+function isRGBColor(value) {
+  return isInstance(/^rgb$/, value);
+}
+export {
+  isColor,
+  isColorValue,
+  isHSLColor,
+  isHexColor,
+  isRGBColor
+};