@oscarpalmer/atoms 0.98.0 → 0.100.0

package/dist/array/flatten.cjs

@@ -3,10 +3,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 function flatten(array) {
-  if (!Array.isArray(array)) {
-    return [];
-  }
-  return array.flat(Number.POSITIVE_INFINITY);
+  return Array.isArray(array) ? array.flat(Number.POSITIVE_INFINITY) : [];
 }
 
 exports.flatten = flatten;

package/dist/array/flatten.js

@@ -1,8 +1,5 @@
 function flatten(array) {
-  if (!Array.isArray(array)) {
-    return [];
-  }
-  return array.flat(Number.POSITIVE_INFINITY);
+  return Array.isArray(array) ? array.flat(Number.POSITIVE_INFINITY) : [];
 }
 
 export { flatten };

package/dist/array/sort.cjs

@@ -2,9 +2,26 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const internal_is = require('../internal/is.cjs');
 const internal_value_compare = require('../internal/value/compare.cjs');
+const internal_is = require('../internal/is.cjs');
 
+function getSorter(value, modifier) {
+  const isObject = internal_is.isPlainObject(value);
+  const sorter = {
+    identifier: "",
+    modifier
+  };
+  sorter.compare = isObject && typeof value.compare === "function" ? value.compare : void 0;
+  sorter.key = isObject && typeof value.key === "string" ? value.key : typeof value === "string" ? value : void 0;
+  sorter.callback = sorter.key == null ? isObject && typeof value.value === "function" ? value.value : typeof value === "function" ? value : void 0 : void 0;
+  if (isObject && typeof value.direction === "string") {
+    sorter.modifier = value.direction === "ascending" ? 1 : value.direction === "descending" ? -1 : modifier;
+  }
+  if (sorter.key != null || sorter.callback != null) {
+    sorter.identifier = `${sorter.key ?? sorter.callback}`;
+    return sorter;
+  }
+}
 function sort(array, first, second) {
   if (!Array.isArray(array)) {
     return [];
@@ -13,55 +30,38 @@ function sort(array, first, second) {
     return array;
   }
   const direction = first === true || second === true ? "desc" : "asc";
-  const unknownSorters = Array.isArray(first) ? first : [first];
-  let { length } = unknownSorters;
-  const sorters = [];
-  for (let index = 0; index < length; index += 1) {
-    const unknownSorter = unknownSorters[index];
-    const sorter = {
-      direction,
-      callback: void 0
-    };
-    if (internal_is.isKey(unknownSorter)) {
-      sorter.callback = (value) => value[unknownSorter];
-    } else if (typeof unknownSorter === "function") {
-      sorter.callback = unknownSorter;
-    } else if (typeof unknownSorter?.value === "function" || internal_is.isKey(unknownSorter?.value)) {
-      sorter.direction = unknownSorter?.direction ?? direction;
-      sorter.callback = typeof unknownSorter.value === "function" ? unknownSorter.value : (value) => value[unknownSorter.value];
-    }
-    if (typeof sorter.callback === "function") {
-      const existing = sorters.findIndex(
-        (existing2) => existing2.callback.toString() === sorter.callback.toString()
-      );
-      if (existing > -1) {
-        sorters.splice(existing, 1);
-      }
-      sorters.push(sorter);
-    }
-  }
-  length = sorters.length;
+  const modifier = direction === "asc" ? 1 : -1;
+  const sorters = (Array.isArray(first) ? first : [first]).map((item) => getSorter(item, modifier)).filter((sorter) => sorter != null).filter(
+    (current, index, sorters2) => sorters2.findIndex((next) => next.identifier === current.identifier) === index
+  );
+  const { length } = sorters;
   if (length === 0) {
     return array.sort(
-      (first2, second2) => internal_value_compare.compare(first2, second2) * (direction === "asc" ? 1 : -1)
+      (first2, second2) => internal_value_compare.compare(first2, second2) * modifier
     );
   }
   if (length === 1) {
-    return array.sort(
-      (first2, second2) => internal_value_compare.compare(sorters[0].callback(first2), sorters[0].callback(second2)) * (sorters[0].direction === "asc" ? 1 : -1)
-    );
+    const sorter = sorters[0];
+    const { callback, key, modifier: modifier2 } = sorter;
+    return array.sort((first2, second2) => {
+      const firstValue = key == null ? callback?.(first2) : first2[key];
+      const secondValue = key == null ? callback?.(second2) : second2[key];
+      return (sorter.compare?.(first2, firstValue, second2, secondValue) ?? internal_value_compare.compare(firstValue, secondValue)) * modifier2;
+    });
   }
-  const sorted = array.sort((first2, second2) => {
+  return array.sort((first2, second2) => {
     for (let index = 0; index < length; index += 1) {
-      const { callback, direction: direction2 } = sorters[index];
-      const compared = internal_value_compare.compare(callback(first2), callback(second2)) * (direction2 === "asc" ? 1 : -1);
+      const sorter = sorters[index];
+      const { callback, key, modifier: modifier2 } = sorter;
+      const firstValue = key == null ? callback?.(first2) : first2[key];
+      const secondValue = key == null ? callback?.(second2) : second2[key];
+      const compared = (sorter.compare?.(first2, firstValue, second2, secondValue) ?? internal_value_compare.compare(firstValue, secondValue)) * modifier2;
       if (compared !== 0) {
         return compared;
       }
     }
     return 0;
   });
-  return sorted;
 }
 
 exports.sort = sort;

package/dist/array/sort.js

@@ -1,6 +1,23 @@
-import { isKey } from '../internal/is.js';
 import { compare } from '../internal/value/compare.js';
+import { isPlainObject } from '../internal/is.js';
 
+function getSorter(value, modifier) {
+  const isObject = isPlainObject(value);
+  const sorter = {
+    identifier: "",
+    modifier
+  };
+  sorter.compare = isObject && typeof value.compare === "function" ? value.compare : void 0;
+  sorter.key = isObject && typeof value.key === "string" ? value.key : typeof value === "string" ? value : void 0;
+  sorter.callback = sorter.key == null ? isObject && typeof value.value === "function" ? value.value : typeof value === "function" ? value : void 0 : void 0;
+  if (isObject && typeof value.direction === "string") {
+    sorter.modifier = value.direction === "ascending" ? 1 : value.direction === "descending" ? -1 : modifier;
+  }
+  if (sorter.key != null || sorter.callback != null) {
+    sorter.identifier = `${sorter.key ?? sorter.callback}`;
+    return sorter;
+  }
+}
 function sort(array, first, second) {
   if (!Array.isArray(array)) {
     return [];
@@ -9,55 +26,38 @@ function sort(array, first, second) {
     return array;
   }
   const direction = first === true || second === true ? "desc" : "asc";
-  const unknownSorters = Array.isArray(first) ? first : [first];
-  let { length } = unknownSorters;
-  const sorters = [];
-  for (let index = 0; index < length; index += 1) {
-    const unknownSorter = unknownSorters[index];
-    const sorter = {
-      direction,
-      callback: void 0
-    };
-    if (isKey(unknownSorter)) {
-      sorter.callback = (value) => value[unknownSorter];
-    } else if (typeof unknownSorter === "function") {
-      sorter.callback = unknownSorter;
-    } else if (typeof unknownSorter?.value === "function" || isKey(unknownSorter?.value)) {
-      sorter.direction = unknownSorter?.direction ?? direction;
-      sorter.callback = typeof unknownSorter.value === "function" ? unknownSorter.value : (value) => value[unknownSorter.value];
-    }
-    if (typeof sorter.callback === "function") {
-      const existing = sorters.findIndex(
-        (existing2) => existing2.callback.toString() === sorter.callback.toString()
-      );
-      if (existing > -1) {
-        sorters.splice(existing, 1);
-      }
-      sorters.push(sorter);
-    }
-  }
-  length = sorters.length;
+  const modifier = direction === "asc" ? 1 : -1;
+  const sorters = (Array.isArray(first) ? first : [first]).map((item) => getSorter(item, modifier)).filter((sorter) => sorter != null).filter(
+    (current, index, sorters2) => sorters2.findIndex((next) => next.identifier === current.identifier) === index
+  );
+  const { length } = sorters;
   if (length === 0) {
     return array.sort(
-      (first2, second2) => compare(first2, second2) * (direction === "asc" ? 1 : -1)
+      (first2, second2) => compare(first2, second2) * modifier
     );
   }
   if (length === 1) {
-    return array.sort(
-      (first2, second2) => compare(sorters[0].callback(first2), sorters[0].callback(second2)) * (sorters[0].direction === "asc" ? 1 : -1)
-    );
+    const sorter = sorters[0];
+    const { callback, key, modifier: modifier2 } = sorter;
+    return array.sort((first2, second2) => {
+      const firstValue = key == null ? callback?.(first2) : first2[key];
+      const secondValue = key == null ? callback?.(second2) : second2[key];
+      return (sorter.compare?.(first2, firstValue, second2, secondValue) ?? compare(firstValue, secondValue)) * modifier2;
+    });
   }
-  const sorted = array.sort((first2, second2) => {
+  return array.sort((first2, second2) => {
     for (let index = 0; index < length; index += 1) {
-      const { callback, direction: direction2 } = sorters[index];
-      const compared = compare(callback(first2), callback(second2)) * (direction2 === "asc" ? 1 : -1);
+      const sorter = sorters[index];
+      const { callback, key, modifier: modifier2 } = sorter;
+      const firstValue = key == null ? callback?.(first2) : first2[key];
+      const secondValue = key == null ? callback?.(second2) : second2[key];
+      const compared = (sorter.compare?.(first2, firstValue, second2, secondValue) ?? compare(firstValue, secondValue)) * modifier2;
       if (compared !== 0) {
         return compared;
       }
     }
     return 0;
   });
-  return sorted;
 }
 
 export { sort };

package/dist/array/unique.cjs

@@ -8,10 +8,7 @@ function unique(array, key) {
   if (!Array.isArray(array)) {
     return [];
   }
-  if (array.length < 2) {
-    return array;
-  }
-  return internal_array_find.findValues("unique", array, [key, void 0]);
+  return array.length > 1 ? internal_array_find.findValues("unique", array, [key, void 0]) : array;
 }
 
 exports.unique = unique;

package/dist/array/unique.js

@@ -4,10 +4,7 @@ function unique(array, key) {
   if (!Array.isArray(array)) {
     return [];
   }
-  if (array.length < 2) {
-    return array;
-  }
-  return findValues("unique", array, [key, void 0]);
+  return array.length > 1 ? findValues("unique", array, [key, void 0]) : array;
 }
 
 export { unique };

package/dist/color/is.cjs

@@ -5,6 +5,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const internal_number = require('../internal/number.cjs');
 const color_constants = require('./constants.cjs');
 
+function isBytey(value) {
+  return typeof value === "number" && internal_number.between(value, 0, 255);
+}
 function isColor(value) {
   return typeof value === "object" && value !== null && "$color" in value && value.$color === true;
 }
@@ -14,9 +17,6 @@ function isDegree(value) {
 function isHexColor(value) {
   return typeof value === "string" && color_constants.anyPattern.test(value);
 }
-function isHexy(value) {
-  return typeof value === "number" && internal_number.between(value, 0, 255);
-}
 function isHSLColor(value) {
   return isObject(value, color_constants.hslKeys);
 }
@@ -44,12 +44,12 @@ function isPercentage(value) {
   return typeof value === "number" && internal_number.between(value, 0, 100);
 }
 const validators = {
-  blue: isHexy,
-  green: isHexy,
+  blue: isBytey,
+  green: isBytey,
   hue: isDegree,
   lightness: isPercentage,
   saturation: isPercentage,
-  red: isHexy
+  red: isBytey
 };
 
 exports.isColor = isColor;

package/dist/color/is.js

@@ -1,6 +1,9 @@
 import { between } from '../internal/number.js';
 import { anyPattern, hslKeys, rgbKeys } from './constants.js';
 
+function isBytey(value) {
+  return typeof value === "number" && between(value, 0, 255);
+}
 function isColor(value) {
   return typeof value === "object" && value !== null && "$color" in value && value.$color === true;
 }
@@ -10,9 +13,6 @@ function isDegree(value) {
 function isHexColor(value) {
   return typeof value === "string" && anyPattern.test(value);
 }
-function isHexy(value) {
-  return typeof value === "number" && between(value, 0, 255);
-}
 function isHSLColor(value) {
   return isObject(value, hslKeys);
 }
@@ -40,12 +40,12 @@ function isPercentage(value) {
   return typeof value === "number" && between(value, 0, 100);
 }
 const validators = {
-  blue: isHexy,
-  green: isHexy,
+  blue: isBytey,
+  green: isBytey,
   hue: isDegree,
   lightness: isPercentage,
   saturation: isPercentage,
-  red: isHexy
+  red: isBytey
 };
 
 export { isColor, isHSLColor, isHexColor, isRGBColor };

package/dist/function.cjs

@@ -2,16 +2,13 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const internal_number = require('./internal/number.cjs');
+const internal_function = require('./internal/function.cjs');
 const internal_string = require('./internal/string.cjs');
 const sized = require('./sized.cjs');
-const internal_function = require('./internal/function.cjs');
 
-class Memoised {
-  constructor(callback, cacheSize) {
-    const cache = new sized.SizedMap(
-      cacheSize ?? 2 ** 16
-    );
+class Memoized {
+  constructor(callback, size) {
+    const cache = new sized.SizedMap(size ?? 2 ** 16);
     const getter = (...parameters) => {
       const key = parameters.length === 1 ? parameters[0] : internal_string.join(parameters.map(internal_string.getString));
       if (cache?.has(key) ?? false) {
@@ -66,49 +63,64 @@ class Memoised {
   }
 }
 function debounce(callback, time) {
-  const interval = internal_number.clamp(time ?? 0, 0, 1e3);
-  let timer;
-  const debounced = (...parameters) => {
-    if (timer != null) {
-      clearTimeout(timer);
-    }
-    timer = +setTimeout(() => {
+  const interval = typeof time === "number" && time >= internal_function.milliseconds ? time : internal_function.milliseconds;
+  function step(now, parameters) {
+    if (interval === internal_function.milliseconds || now - start >= interval) {
       callback(...parameters);
-    }, interval);
+    } else {
+      frame = requestAnimationFrame((next) => {
+        step(next, parameters);
+      });
+    }
+  }
+  let frame;
+  let start;
+  const debounced = (...parameters) => {
+    debounced.cancel();
+    frame = requestAnimationFrame((now) => {
+      start = now - internal_function.milliseconds;
+      step(now, parameters);
+    });
   };
   debounced.cancel = () => {
-    if (timer != null) {
-      clearTimeout(timer);
+    if (frame != null) {
+      cancelAnimationFrame(frame);
+      frame = void 0;
     }
   };
   return debounced;
 }
 function memoize(callback, cacheSize) {
-  return new Memoised(callback, cacheSize);
+  return new Memoized(
+    callback,
+    typeof cacheSize === "number" ? cacheSize : void 0
+  );
 }
 function throttle(callback, time) {
-  const interval = internal_number.clamp(time ?? 0, 0, 1e3);
-  let timestamp = performance.now();
-  let timer;
-  const throttler = (...parameters) => {
-    if (timer != null) {
-      clearTimeout(timer);
-    }
-    const now = performance.now();
-    const difference = now - timestamp;
-    if (difference >= interval) {
-      timestamp = now;
+  const interval = typeof time === "number" && time >= internal_function.milliseconds ? time : internal_function.milliseconds;
+  function step(now, parameters) {
+    if (interval === internal_function.milliseconds || now - last >= interval) {
+      last = now;
       callback(...parameters);
     } else {
-      timer = +setTimeout(() => {
-        timestamp = performance.now();
-        callback(...parameters);
-      }, difference + interval);
+      frame = requestAnimationFrame((next) => {
+        step(next, parameters);
+      });
     }
+  }
+  let last;
+  let frame;
+  const throttler = (...parameters) => {
+    throttler.cancel();
+    frame = requestAnimationFrame((now) => {
+      last ??= now - internal_function.milliseconds;
+      step(now, parameters);
+    });
   };
   throttler.cancel = () => {
-    if (timer != null) {
-      clearTimeout(timer);
+    if (frame != null) {
+      cancelAnimationFrame(frame);
+      frame = void 0;
     }
   };
   return throttler;

package/dist/function.js

@@ -1,13 +1,11 @@
-import { clamp } from './internal/number.js';
+import { milliseconds } from './internal/function.js';
+export { noop } from './internal/function.js';
 import { join, getString } from './internal/string.js';
 import { SizedMap } from './sized.js';
-export { noop } from './internal/function.js';
 
-class Memoised {
-  constructor(callback, cacheSize) {
-    const cache = new SizedMap(
-      cacheSize ?? 2 ** 16
-    );
+class Memoized {
+  constructor(callback, size) {
+    const cache = new SizedMap(size ?? 2 ** 16);
     const getter = (...parameters) => {
       const key = parameters.length === 1 ? parameters[0] : join(parameters.map(getString));
       if (cache?.has(key) ?? false) {
@@ -62,49 +60,64 @@ class Memoised {
   }
 }
 function debounce(callback, time) {
-  const interval = clamp(time ?? 0, 0, 1e3);
-  let timer;
-  const debounced = (...parameters) => {
-    if (timer != null) {
-      clearTimeout(timer);
-    }
-    timer = +setTimeout(() => {
+  const interval = typeof time === "number" && time >= milliseconds ? time : milliseconds;
+  function step(now, parameters) {
+    if (interval === milliseconds || now - start >= interval) {
       callback(...parameters);
-    }, interval);
+    } else {
+      frame = requestAnimationFrame((next) => {
+        step(next, parameters);
+      });
+    }
+  }
+  let frame;
+  let start;
+  const debounced = (...parameters) => {
+    debounced.cancel();
+    frame = requestAnimationFrame((now) => {
+      start = now - milliseconds;
+      step(now, parameters);
+    });
   };
   debounced.cancel = () => {
-    if (timer != null) {
-      clearTimeout(timer);
+    if (frame != null) {
+      cancelAnimationFrame(frame);
+      frame = void 0;
     }
   };
   return debounced;
 }
 function memoize(callback, cacheSize) {
-  return new Memoised(callback, cacheSize);
+  return new Memoized(
+    callback,
+    typeof cacheSize === "number" ? cacheSize : void 0
+  );
 }
 function throttle(callback, time) {
-  const interval = clamp(time ?? 0, 0, 1e3);
-  let timestamp = performance.now();
-  let timer;
-  const throttler = (...parameters) => {
-    if (timer != null) {
-      clearTimeout(timer);
-    }
-    const now = performance.now();
-    const difference = now - timestamp;
-    if (difference >= interval) {
-      timestamp = now;
+  const interval = typeof time === "number" && time >= milliseconds ? time : milliseconds;
+  function step(now, parameters) {
+    if (interval === milliseconds || now - last >= interval) {
+      last = now;
       callback(...parameters);
     } else {
-      timer = +setTimeout(() => {
-        timestamp = performance.now();
-        callback(...parameters);
-      }, difference + interval);
+      frame = requestAnimationFrame((next) => {
+        step(next, parameters);
+      });
     }
+  }
+  let last;
+  let frame;
+  const throttler = (...parameters) => {
+    throttler.cancel();
+    frame = requestAnimationFrame((now) => {
+      last ??= now - milliseconds;
+      step(now, parameters);
+    });
   };
   throttler.cancel = () => {
-    if (timer != null) {
-      clearTimeout(timer);
+    if (frame != null) {
+      cancelAnimationFrame(frame);
+      frame = void 0;
     }
   };
   return throttler;

package/dist/index.cjs

@@ -85,7 +85,6 @@ exports.isEmpty = is.isEmpty;
 exports.isNullable = is.isNullable;
 exports.isNullableOrEmpty = is.isNullableOrEmpty;
 exports.isNullableOrWhitespace = is.isNullableOrWhitespace;
-exports.isNumber = is.isNumber;
 exports.isNumerical = is.isNumerical;
 exports.isObject = is.isObject;
 exports.isPrimitive = is.isPrimitive;
@@ -137,6 +136,7 @@ exports.isRGBColor = color_is.isRGBColor;
 exports.noop = internal_function.noop;
 exports.isArrayOrPlainObject = internal_is.isArrayOrPlainObject;
 exports.isKey = internal_is.isKey;
+exports.isNumber = internal_is.isNumber;
 exports.isPlainObject = internal_is.isPlainObject;
 exports.isTypedArray = internal_is.isTypedArray;
 exports.max = internal_math_aggregate.max;

package/dist/index.js

@@ -19,7 +19,7 @@ export { Color, getColor, getForegroundColor, getHSLColor, getHexColor, getRGBCo
 export { emitter } from './emitter.js';
 export { debounce, memoize, throttle } from './function.js';
 export { translate } from './i18n.js';
-export { isEmpty, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPrimitive } from './is.js';
+export { isEmpty, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumerical, isObject, isPrimitive } from './is.js';
 export { logger } from './logger.js';
 export { average, min, round, sum } from './math.js';
 export { between, clamp, getNumber } from './internal/number.js';
@@ -43,6 +43,6 @@ export { smush } from './value/smush.js';
 export { unsmush } from './value/unsmush.js';
 export { isColor, isHSLColor, isHexColor, isRGBColor } from './color/is.js';
 export { noop } from './internal/function.js';
-export { isArrayOrPlainObject, isKey, isPlainObject, isTypedArray } from './internal/is.js';
+export { isArrayOrPlainObject, isKey, isNumber, isPlainObject, isTypedArray } from './internal/is.js';
 export { max } from './internal/math/aggregate.js';
 export { getRandomFloat, getRandomInteger } from './internal/random.js';

package/dist/internal/array/shuffle.cjs

@@ -11,7 +11,7 @@ function shuffle(array) {
   if (array.length < 2) {
     return array;
   }
-  const shuffled = array.slice();
+  const shuffled = [...array];
   let index = Number(shuffled.length);
   while (--index >= 0) {
     const random = internal_random.getRandomInteger(0, index);

package/dist/internal/array/shuffle.js

@@ -7,7 +7,7 @@ function shuffle(array) {
   if (array.length < 2) {
     return array;
   }
-  const shuffled = array.slice();
+  const shuffled = [...array];
   let index = Number(shuffled.length);
   while (--index >= 0) {
     const random = getRandomInteger(0, index);

package/dist/internal/function.cjs

@@ -4,5 +4,26 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 function noop() {
 }
+function step(now) {
+  if (values.length === 7) {
+    exports.milliseconds = Math.floor(
+      values.slice(2).reduce((first, second) => first + second) / 5 * 2
+    ) / 2;
+    last = void 0;
+    values.length = 0;
+  } else {
+    last ??= now;
+    const difference = now - last;
+    if (difference > 0) {
+      values.push(difference);
+    }
+    last = now;
+    requestAnimationFrame(step);
+  }
+}
+const values = [];
+let last;
+exports.milliseconds = Math.floor(1e3 / 60 * 2) / 2;
+requestAnimationFrame(step);
 
 exports.noop = noop;

package/dist/internal/function.js

@@ -1,4 +1,25 @@
 function noop() {
 }
+function step(now) {
+  if (values.length === 7) {
+    milliseconds = Math.floor(
+      values.slice(2).reduce((first, second) => first + second) / 5 * 2
+    ) / 2;
+    last = void 0;
+    values.length = 0;
+  } else {
+    last ??= now;
+    const difference = now - last;
+    if (difference > 0) {
+      values.push(difference);
+    }
+    last = now;
+    requestAnimationFrame(step);
+  }
+}
+const values = [];
+let last;
+let milliseconds = Math.floor(1e3 / 60 * 2) / 2;
+requestAnimationFrame(step);
 
-export { noop };
+export { milliseconds, noop };