@oscarpalmer/atoms 0.74.1 → 0.76.0

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

@@ -1,18 +1,16 @@
-// src/js/query.ts
-import { isNullableOrWhitespace, isPlainObject } from "./is";
-import { join } from "./string";
-import { setValue } from "./value";
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const is = require("./is.cjs");
+const string_index = require("./string/index.cjs");
+const value_set = require("./value/set.cjs");
 function fromQuery(query) {
   const parts = query.split("&");
   const { length } = parts;
   const parameters = {};
-  for (let index = 0;index < length; index += 1) {
+  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));
+      value_set.setValue(parameters, key, getValue(value));
     } else {
       if (key in parameters) {
         if (!Array.isArray(parameters[key])) {
@@ -30,15 +28,19 @@ function getParts(value, fromArray, prefix) {
   const keys = Object.keys(value);
   const { length } = keys;
   const parts = [];
-  for (let index = 0;index < length; index += 1) {
+  for (let index = 0; index < length; index += 1) {
     const key = keys[index];
     const val = value[key];
     if (Array.isArray(val)) {
-      parts.push(...getParts(val, true, join([prefix, fromArray ? null : key], ".")));
-    } else if (isPlainObject(val)) {
-      parts.push(...getParts(val, false, join([prefix, key], ".")));
+      parts.push(
+        ...getParts(val, true, string_index.join([prefix, fromArray ? null : key], "."))
+      );
+    } else if (is.isPlainObject(val)) {
+      parts.push(...getParts(val, false, string_index.join([prefix, key], ".")));
     } else if (isDecodable(val)) {
-      parts.push(`${encodeURIComponent(join([prefix, fromArray ? null : key], "."))}=${encodeURIComponent(val)}`);
+      parts.push(
+        `${encodeURIComponent(string_index.join([prefix, fromArray ? null : key], "."))}=${encodeURIComponent(val)}`
+      );
     }
   }
   return parts;
@@ -59,7 +61,5 @@ function isDecodable(value) {
 function toQuery(parameters) {
   return getParts(parameters, false).filter((part) => part.length > 0).join("&");
 }
-export {
-  toQuery,
-  fromQuery
-};
+exports.fromQuery = fromQuery;
+exports.toQuery = toQuery;

package/dist/js/query.js

@@ -1,95 +1,22 @@
-// src/js/array/compact.ts
-function compact(array, strict) {
-  return strict === true ? array.filter((item) => !!item) : array.filter((item) => item != null);
-}
-// 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;
-}
-function join(value, delimiter) {
-  return compact(value).map(getString).filter((value2) => value2.trim().length > 0).join(typeof delimiter === "string" ? delimiter : "");
-}
-// src/js/internal/value-handle.ts
-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;
-  }
-}
-// src/js/value/set.ts
-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 : {};
-  for (let index = 0;index < length; index += 1) {
-    const part = parts[index];
-    if (index === lastIndex) {
-      handleValue(target, part, value, false, shouldIgnoreCase);
-      break;
-    }
-    let next = handleValue(target, part, null, true, shouldIgnoreCase);
-    if (typeof next !== "object" || next === null) {
-      next = {};
-      target[part] = next;
-    }
-    target = next;
-  }
-  return data;
-}
-// src/js/is.ts
-function isNullableOrWhitespace(value) {
-  return value == null || /^\s*$/.test(getString(value));
-}
-function isPlainObject(value) {
-  if (typeof value !== "object" || value === null) {
-    return false;
-  }
-  const prototype = Object.getPrototypeOf(value);
-  return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value) && !(Symbol.iterator in value);
-}
-
-// src/js/query.ts
+import { isPlainObject } from "./is.js";
+import { join } from "./string/index.js";
+import { setValue } from "./value/set.js";
 function fromQuery(query) {
   const parts = query.split("&");
   const { length } = parts;
   const parameters = {};
-  for (let index = 0;index < length; index += 1) {
+  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, getValue2(value));
+      setValue(parameters, key, getValue(value));
     } else {
       if (key in parameters) {
         if (!Array.isArray(parameters[key])) {
           parameters[key] = [parameters[key]];
         }
-        parameters[key].push(getValue2(value));
+        parameters[key].push(getValue(value));
       } else {
-        parameters[key] = getValue2(value);
+        parameters[key] = getValue(value);
       }
     }
   }
@@ -99,20 +26,24 @@ function getParts(value, fromArray, prefix) {
   const keys = Object.keys(value);
   const { length } = keys;
   const parts = [];
-  for (let index = 0;index < length; index += 1) {
+  for (let index = 0; index < length; index += 1) {
     const key = keys[index];
     const val = value[key];
     if (Array.isArray(val)) {
-      parts.push(...getParts(val, true, join([prefix, fromArray ? null : key], ".")));
+      parts.push(
+        ...getParts(val, true, join([prefix, fromArray ? null : key], "."))
+      );
     } else if (isPlainObject(val)) {
       parts.push(...getParts(val, false, join([prefix, key], ".")));
     } else if (isDecodable(val)) {
-      parts.push(`${encodeURIComponent(join([prefix, fromArray ? null : key], "."))}=${encodeURIComponent(val)}`);
+      parts.push(
+        `${encodeURIComponent(join([prefix, fromArray ? null : key], "."))}=${encodeURIComponent(val)}`
+      );
     }
   }
   return parts;
 }
-function getValue2(value) {
+function getValue(value) {
   if (/^(false|true)$/.test(value)) {
     return value === "true";
   }
@@ -129,6 +60,6 @@ function toQuery(parameters) {
   return getParts(parameters, false).filter((part) => part.length > 0).join("&");
 }
 export {
-  toQuery,
-  fromQuery
+  fromQuery,
+  toQuery
 };

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

@@ -1,4 +1,13 @@
-// src/js/queue.ts
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+if (globalThis._atomic_queued == null) {
+  const queued = /* @__PURE__ */ new Set();
+  Object.defineProperty(globalThis, "_atomic_queued", {
+    get() {
+      return queued;
+    }
+  });
+}
 function queue(callback) {
   _atomic_queued.add(callback);
   if (_atomic_queued.size > 0) {
@@ -6,20 +15,10 @@ function queue(callback) {
       const callbacks = [..._atomic_queued];
       const { length } = callbacks;
       _atomic_queued.clear();
-      for (let index = 0;index < length; index += 1) {
+      for (let index = 0; index < length; index += 1) {
         callbacks[index]();
       }
     });
   }
 }
-if (globalThis._atomic_queued == null) {
-  const queued = new Set;
-  Object.defineProperty(globalThis, "_atomic_queued", {
-    get() {
-      return queued;
-    }
-  });
-}
-export {
-  queue
-};
+exports.queue = queue;

package/dist/js/queue.js

@@ -1,4 +1,11 @@
-// src/js/queue.ts
+if (globalThis._atomic_queued == null) {
+  const queued = /* @__PURE__ */ new Set();
+  Object.defineProperty(globalThis, "_atomic_queued", {
+    get() {
+      return queued;
+    }
+  });
+}
 function queue(callback) {
   _atomic_queued.add(callback);
   if (_atomic_queued.size > 0) {
@@ -6,20 +13,12 @@ function queue(callback) {
       const callbacks = [..._atomic_queued];
       const { length } = callbacks;
       _atomic_queued.clear();
-      for (let index = 0;index < length; index += 1) {
+      for (let index = 0; index < length; index += 1) {
         callbacks[index]();
       }
     });
   }
 }
-if (globalThis._atomic_queued == null) {
-  const queued = new Set;
-  Object.defineProperty(globalThis, "_atomic_queued", {
-    get() {
-      return queued;
-    }
-  });
-}
 export {
   queue
 };

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

@@ -1,5 +1,6 @@
-// src/js/random.ts
-import { shuffle } from "./array/shuffle";
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const array_shuffle = require("./array/shuffle.cjs");
 function getRandomBoolean() {
   return Math.random() > 0.5;
 }
@@ -9,7 +10,7 @@ function getRandomCharacters(length, selection) {
   }
   const actual = typeof selection === "string" && selection.length > 0 ? selection : "abcdefghijklmnopqrstuvwxyz";
   let characters = "";
-  for (let index = 0;index < length; index += 1) {
+  for (let index = 0; index < length; index += 1) {
     characters += actual.charAt(getRandomInteger(0, actual.length));
   }
   return characters;
@@ -17,11 +18,6 @@ function getRandomCharacters(length, selection) {
 function getRandomColour() {
   return `#${Array.from({ length: 6 }, getRandomHex).join("")}`;
 }
-function getRandomDate(earliest, latest) {
-  const earliestTime = earliest?.getTime() ?? -8640000000000000;
-  const latestTime = latest?.getTime() ?? 8640000000000000;
-  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;
@@ -39,16 +35,13 @@ function getRandomItems(array, amount) {
   if (amount === 1) {
     return array.length === 0 ? [] : [array[getRandomInteger(0, array.length)]];
   }
-  return amount == null || amount >= array.length ? shuffle(array) : shuffle(array).slice(0, amount);
-}
-export {
-  getRandomItems,
-  getRandomItem,
-  getRandomInteger,
-  getRandomHex,
-  getRandomFloat,
-  getRandomDate,
-  getRandomColour,
-  getRandomCharacters,
-  getRandomBoolean
-};
+  return amount == null || amount >= array.length ? array_shuffle.shuffle(array) : array_shuffle.shuffle(array).slice(0, amount);
+}
+exports.getRandomBoolean = getRandomBoolean;
+exports.getRandomCharacters = getRandomCharacters;
+exports.getRandomColour = getRandomColour;
+exports.getRandomFloat = getRandomFloat;
+exports.getRandomHex = getRandomHex;
+exports.getRandomInteger = getRandomInteger;
+exports.getRandomItem = getRandomItem;
+exports.getRandomItems = getRandomItems;

package/dist/js/random.js

@@ -1,15 +1,4 @@
-// src/js/array/shuffle.ts
-function shuffle(array) {
-  const shuffled = array.slice();
-  const { length } = shuffled;
-  for (let index = 0;index < length; index += 1) {
-    const random = getRandomInteger(0, length);
-    [shuffled[index], shuffled[random]] = [shuffled[random], shuffled[index]];
-  }
-  return shuffled;
-}
-
-// src/js/random.ts
+import { shuffle } from "./array/shuffle.js";
 function getRandomBoolean() {
   return Math.random() > 0.5;
 }
@@ -19,7 +8,7 @@ function getRandomCharacters(length, selection) {
   }
   const actual = typeof selection === "string" && selection.length > 0 ? selection : "abcdefghijklmnopqrstuvwxyz";
   let characters = "";
-  for (let index = 0;index < length; index += 1) {
+  for (let index = 0; index < length; index += 1) {
     characters += actual.charAt(getRandomInteger(0, actual.length));
   }
   return characters;
@@ -27,11 +16,6 @@ function getRandomCharacters(length, selection) {
 function getRandomColour() {
   return `#${Array.from({ length: 6 }, getRandomHex).join("")}`;
 }
-function getRandomDate(earliest, latest) {
-  const earliestTime = earliest?.getTime() ?? -8640000000000000;
-  const latestTime = latest?.getTime() ?? 8640000000000000;
-  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;
@@ -52,13 +36,12 @@ function getRandomItems(array, amount) {
   return amount == null || amount >= array.length ? shuffle(array) : shuffle(array).slice(0, amount);
 }
 export {
-  getRandomItems,
-  getRandomItem,
-  getRandomInteger,
-  getRandomHex,
-  getRandomFloat,
-  getRandomDate,
-  getRandomColour,
+  getRandomBoolean,
   getRandomCharacters,
-  getRandomBoolean
+  getRandomColour,
+  getRandomFloat,
+  getRandomHex,
+  getRandomInteger,
+  getRandomItem,
+  getRandomItems
 };

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

@@ -1,36 +1,49 @@
-// src/js/sized.ts
-import { clamp } from "./number";
-function getMaximum(first, second) {
-  const actual = (typeof first === "number" ? first : typeof second === "number" ? second : undefined) ?? 2 ** 20;
-  return clamp(actual, 1, 2 ** 24);
-}
-
+"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 number = require("./number.cjs");
 class SizedMap extends Map {
-  maximumSize;
-  get full() {
-    return this.size >= this.maximumSize;
-  }
-  get maximum() {
-    return this.maximumSize;
-  }
   constructor(entries, maximum) {
-    const maximumSize = getMaximum(typeof entries === "number" ? entries : typeof maximum === "number" ? maximum : undefined);
-    super(Array.isArray(entries) ? entries.slice(0, maximumSize) : undefined);
+    const maximumSize = getMaximum(
+      typeof entries === "number" ? entries : typeof maximum === "number" ? maximum : void 0
+    );
+    super(Array.isArray(entries) ? entries.slice(0, maximumSize) : void 0);
+    __publicField(this, "maximumSize");
     this.maximumSize = maximumSize;
     if (Array.isArray(entries) && entries.length > maximumSize) {
-      for (let index = 0;index < maximumSize; index += 1) {
+      for (let index = 0; index < maximumSize; index += 1) {
         this.set(...entries[entries.length - maximumSize + index]);
       }
     }
   }
+  /**
+   * Is the Map full?
+   */
+  get full() {
+    return this.size >= this.maximumSize;
+  }
+  /**
+   * The maximum size of the Map
+   */
+  get maximum() {
+    return this.maximumSize;
+  }
+  /**
+   * @inheritdoc
+   */
   get(key) {
     const value = super.get(key);
-    if (value === undefined && !this.has(key)) {
+    if (value == null && !this.has(key)) {
       return;
     }
     this.set(key, value);
     return value;
   }
+  /**
+   * @inheritdoc
+   */
   set(key, value) {
     if (this.has(key)) {
       this.delete(key);
@@ -40,25 +53,37 @@ class SizedMap extends Map {
     return super.set(key, value);
   }
 }
-
 class SizedSet extends Set {
-  maximumSize;
-  get full() {
-    return this.size >= this.maximumSize;
-  }
-  get maximum() {
-    return this.maximumSize;
-  }
   constructor(values, maximum) {
-    const maximumSize = getMaximum(typeof values === "number" ? values : typeof maximum === "number" ? maximum : undefined);
-    super(Array.isArray(values) && values.length <= maximumSize ? values : undefined);
+    const maximumSize = getMaximum(
+      typeof values === "number" ? values : typeof maximum === "number" ? maximum : void 0
+    );
+    super(
+      Array.isArray(values) && values.length <= maximumSize ? values : void 0
+    );
+    __publicField(this, "maximumSize");
     this.maximumSize = maximumSize;
     if (Array.isArray(values) && values.length > maximumSize) {
-      for (let index = 0;index < maximumSize; index += 1) {
+      for (let index = 0; index < maximumSize; index += 1) {
         this.add(values[values.length - maximumSize + index]);
       }
     }
   }
+  /**
+   * Is the Set full?
+   */
+  get full() {
+    return this.size >= this.maximumSize;
+  }
+  /**
+   * The maximum size of the Set
+   */
+  get maximum() {
+    return this.maximumSize;
+  }
+  /**
+   * @inheritdoc
+   */
   add(value) {
     if (this.has(value)) {
       this.delete(value);
@@ -67,6 +92,11 @@ class SizedSet extends Set {
     }
     return super.add(value);
   }
+  /**
+   * Get a value from an index in the Set, if it exists
+   * - Negative indices are counted from the end
+   * - Optionally move the value to the end with `update`
+   */
   at(index, update) {
     const value = [...this.values()][index < 0 ? this.size + index : index];
     if ((update ?? false) && this.has(value)) {
@@ -75,6 +105,9 @@ class SizedSet extends Set {
     }
     return value;
   }
+  /**
+   * Get a value from the Set, if it exists _(and move it to the end)_
+   */
   get(value, update) {
     if (this.has(value)) {
       if (update ?? false) {
@@ -85,7 +118,9 @@ class SizedSet extends Set {
     }
   }
 }
-export {
-  SizedSet,
-  SizedMap
-};
+function getMaximum(first, second) {
+  const actual = (typeof first === "number" ? first : void 0) ?? 2 ** 20;
+  return number.clamp(actual, 1, 2 ** 24);
+}
+exports.SizedMap = SizedMap;
+exports.SizedSet = SizedSet;