@splendidlabz/utils 1.12.1 → 1.14.0

package/dist/cjs/dom/font-size.cjs

@@ -28,7 +28,7 @@ __export(font_size_exports, {
 });
 module.exports = __toCommonJS(font_size_exports);
 
-// src/lib/numbers/index.js
+// src/lib/numbers/split-unit.js
 function splitUnit(string) {
   if (typeof string === "number") return [string, null];
   const regex = /(-?\d*\.?\d+)\s*([a-z]+)/i;

package/dist/cjs/dom/index.cjs

@@ -705,7 +705,7 @@ function Focusable(container = document.body) {
   return getFocusableElements(container);
 }
 
-// src/lib/numbers/index.js
+// src/lib/numbers/split-unit.js
 function splitUnit(string) {
   if (typeof string === "number") return [string, null];
   const regex = /(-?\d*\.?\d+)\s*([a-z]+)/i;
@@ -1023,8 +1023,13 @@ var queryParams = {
     const searchParams = new URLSearchParams(location.search);
     return searchParams.get(key);
   },
+  /**
+   * Converts a params object into a URL query string
+   * @param {Object} params - Key-value pairs to stringify
+   * @returns {string} URL-encoded query string
+   */
   stringify(params) {
-    const searchParams = new URLSearchParams(location.search);
+    const searchParams = new URLSearchParams(params);
     return searchParams.toString();
   }
 };

package/dist/cjs/dom/query-params.cjs

@@ -27,8 +27,13 @@ var queryParams = {
     const searchParams = new URLSearchParams(location.search);
     return searchParams.get(key);
   },
+  /**
+   * Converts a params object into a URL query string
+   * @param {Object} params - Key-value pairs to stringify
+   * @returns {string} URL-encoded query string
+   */
   stringify(params) {
-    const searchParams = new URLSearchParams(location.search);
+    const searchParams = new URLSearchParams(params);
     return searchParams.toString();
   }
 };

package/dist/cjs/lib/colors.cjs

@@ -0,0 +1,39 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/colors.js
+var colors_exports = {};
+__export(colors_exports, {
+  hexToRgb: () => hexToRgb
+});
+module.exports = __toCommonJS(colors_exports);
+function hexToRgb(hex) {
+  let h = hex.replace("#", "");
+  if (h.length === 3)
+    h = h.split("").map((c) => c + c).join("");
+  const int = parseInt(h, 16);
+  return {
+    r: +((int >> 16 & 255) / 255).toFixed(3),
+    g: +((int >> 8 & 255) / 255).toFixed(3),
+    b: +((int & 255) / 255).toFixed(3)
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  hexToRgb
+});

package/dist/cjs/lib/date/index.cjs

@@ -119,7 +119,7 @@ var MONTHS = [
   }
 ];
 
-// src/lib/numbers/index.js
+// src/lib/numbers/split-unit.js
 function splitUnit(string) {
   if (typeof string === "number") return [string, null];
   const regex = /(-?\d*\.?\d+)\s*([a-z]+)/i;

package/dist/cjs/lib/date/time.cjs

@@ -30,7 +30,7 @@ __export(time_exports, {
 });
 module.exports = __toCommonJS(time_exports);
 
-// src/lib/numbers/index.js
+// src/lib/numbers/split-unit.js
 function splitUnit(string) {
   if (typeof string === "number") return [string, null];
   const regex = /(-?\d*\.?\d+)\s*([a-z]+)/i;

package/dist/cjs/lib/functions/index.cjs

@@ -117,7 +117,7 @@ function throttle(callback, wait2) {
 
 // src/lib/functions/timeout.js
 function timeout(wait2, callback) {
-  setTimeout(callback, wait2);
+  return setTimeout(callback, wait2);
 }
 function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));

package/dist/cjs/lib/functions/timeout.cjs

@@ -25,7 +25,7 @@ __export(timeout_exports, {
 });
 module.exports = __toCommonJS(timeout_exports);
 function timeout(wait2, callback) {
-  setTimeout(callback, wait2);
+  return setTimeout(callback, wait2);
 }
 function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));

package/dist/cjs/lib/index.cjs

@@ -43,6 +43,8 @@ __export(lib_exports, {
   curry: () => curry,
   debounce: () => debounce,
   delay: () => delay,
+  displacePresets: () => displacePresets,
+  displaceSettings: () => displaceSettings,
   extendObject: () => extendObject,
   flattenArrayFields: () => flattenArrayFields,
   flattenObject: () => flattenObject,
@@ -55,6 +57,7 @@ __export(lib_exports, {
   getSymbolValue: () => getSymbolValue,
   getTimeInMs: () => getTimeInMs,
   getType: () => getType,
+  hexToRgb: () => hexToRgb,
   isArray: () => isArray,
   isEmpty: () => isEmpty,
   isEqual: () => isEqual,
@@ -70,6 +73,8 @@ __export(lib_exports, {
   markdown: () => markdown,
   mix: () => mix,
   ms: () => ms,
+  noiseColorMatrix: () => noiseColorMatrix,
+  noisePresets: () => noisePresets,
   normalizeObject: () => normalizeObject,
   notEmpty: () => notEmpty,
   notEqual: () => notEqual,
@@ -89,6 +94,8 @@ __export(lib_exports, {
   sanitize: () => sanitize,
   sanitizeArray: () => sanitizeArray,
   sanitizeObject: () => sanitizeObject,
+  scatter: () => scatter,
+  seededRandom: () => seededRandom,
   shuffle: () => shuffle,
   singular: () => singular,
   sizeOf: () => sizeOf,
@@ -285,6 +292,19 @@ function isFunction(x) {
   return typeof x === "function";
 }
 
+// src/lib/colors.js
+function hexToRgb(hex) {
+  let h = hex.replace("#", "");
+  if (h.length === 3)
+    h = h.split("").map((c) => c + c).join("");
+  const int = parseInt(h, 16);
+  return {
+    r: +((int >> 16 & 255) / 255).toFixed(3),
+    g: +((int >> 8 & 255) / 255).toFixed(3),
+    b: +((int & 255) / 255).toFixed(3)
+  };
+}
+
 // src/lib/date/days.js
 var DAYS = [
   { short: "Sun", long: "Sunday", numeric: 1 },
@@ -380,7 +400,16 @@ function toRadians(angle) {
   return angle * (Math.PI / 180);
 }
 
-// src/lib/numbers/index.js
+// src/lib/numbers/random.js
+function seededRandom(seed = 1) {
+  let state = seed >>> 0;
+  return () => {
+    state = state * 1664525 + 1013904223 >>> 0;
+    return state / 4294967296;
+  };
+}
+
+// src/lib/numbers/split-unit.js
 function splitUnit(string) {
   if (typeof string === "number") return [string, null];
   const regex = /(-?\d*\.?\d+)\s*([a-z]+)/i;
@@ -624,7 +653,7 @@ function throttle(callback, wait2) {
 
 // src/lib/functions/timeout.js
 function timeout(wait2, callback) {
-  setTimeout(callback, wait2);
+  return setTimeout(callback, wait2);
 }
 function delay(ms2) {
   return new Promise((resolve) => setTimeout(resolve, ms2));
@@ -1527,7 +1556,30 @@ function stripNumbers(string) {
   return string.replace(/\d*/, "");
 }
 
-// src/lib/style/index.js
+// src/lib/style/scatter.js
+var round = (n) => {
+  const value = Math.round(n * 100) / 100;
+  return value === 0 ? 0 : value;
+};
+function scatter(count, options = {}) {
+  const { seed = 1, spread = 20, rotation = 6, amount = 1 } = options;
+  const random = seededRandom(seed);
+  const items = [];
+  for (let i = 0; i < count; i++) {
+    const x = round((random() - 0.5) * 2 * spread * amount);
+    const y = round((random() - 0.5) * 2 * spread * amount);
+    const r = round((random() - 0.5) * 2 * rotation * amount);
+    items.push({
+      x,
+      y,
+      rotation: r,
+      transform: `translate(${x}%, ${y}%) rotate(${r}deg)`
+    });
+  }
+  return items;
+}
+
+// src/lib/style/to-style-string.js
 function toStyleString(style) {
   if (!style) return null;
   if (typeof style === "string") return style;
@@ -1537,6 +1589,85 @@ function toStyleString(style) {
   }).join("; ").concat(";");
 }
 
+// src/lib/svg/displace.js
+var displacePresets = {
+  // Ink bleeding into absorbent paper. Long wavelength, small push.
+  "wet-ink": {
+    type: "fractalNoise",
+    frequency: 0.015,
+    octaves: 3,
+    scale: 9,
+    seed: 2
+  },
+  // Ink bitten into paper tooth. The edge roughens without the letterform
+  // moving, so this is the only preset that survives at body sizes.
+  letterpress: {
+    type: "fractalNoise",
+    frequency: 0.09,
+    octaves: 1,
+    scale: 2,
+    seed: 5
+  },
+  // Air over heat. Anisotropic so the shimmer rises instead of swimming.
+  // Reads as nothing unless animated.
+  "heat-haze": {
+    type: "fractalNoise",
+    frequency: [4e-3, 0.02],
+    animateTo: [6e-3, 0.03],
+    duration: 8,
+    octaves: 2,
+    scale: 7,
+    seed: 11
+  },
+  // Tracking error on worn tape. A near-infinite horizontal wavelength against
+  // a very short vertical one is what tears rather than blobs.
+  "bad-tape": {
+    type: "turbulence",
+    frequency: [8e-4, 0.06],
+    animateTo: [8e-4, 0.09],
+    duration: 2.5,
+    octaves: 1,
+    scale: 14,
+    seed: 3
+  },
+  // Past the shred threshold on purpose.
+  shred: {
+    type: "turbulence",
+    frequency: 0.055,
+    octaves: 2,
+    scale: 32,
+    seed: 7
+  }
+};
+var format = (f) => Array.isArray(f) ? f.join(" ") : String(f);
+function displaceSettings(opts = {}) {
+  const base = opts.preset && displacePresets[opts.preset] || displacePresets["wet-ink"];
+  const frequency = opts.frequency ?? base.frequency;
+  const animateTo = opts.animateTo ?? base.animateTo;
+  return {
+    type: opts.type ?? base.type,
+    frequency: format(frequency),
+    animateTo: animateTo ? format(animateTo) : null,
+    duration: opts.duration ?? base.duration ?? 6,
+    octaves: opts.octaves ?? base.octaves,
+    scale: opts.scale ?? base.scale,
+    seed: opts.seed ?? base.seed
+  };
+}
+
+// src/lib/svg/noise.js
+var noisePresets = {
+  black: "#000000",
+  sepia: "#a67c52",
+  synthwave: "#ff2bd6"
+};
+function noiseColorMatrix(color, strength) {
+  if (!color || color === "rainbow")
+    return `1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 ${strength} 0`;
+  const { r, g, b } = hexToRgb(noisePresets[color] ?? color);
+  return `0 0 0 0 ${r} 0 0 0 0 ${g} 0 0 0 0 ${b} 0 0 0 ${strength} 0`;
+}
+
 // src/lib/symbols/symbols.js
 function getSymbol(object, description) {
   return Object.getOwnPropertySymbols(object).find(
@@ -1562,6 +1693,8 @@ function getSymbolValue(object, description) {
   curry,
   debounce,
   delay,
+  displacePresets,
+  displaceSettings,
   extendObject,
   flattenArrayFields,
   flattenObject,
@@ -1574,6 +1707,7 @@ function getSymbolValue(object, description) {
   getSymbolValue,
   getTimeInMs,
   getType,
+  hexToRgb,
   isArray,
   isEmpty,
   isEqual,
@@ -1589,6 +1723,8 @@ function getSymbolValue(object, description) {
   markdown,
   mix,
   ms,
+  noiseColorMatrix,
+  noisePresets,
   normalizeObject,
   notEmpty,
   notEqual,
@@ -1608,6 +1744,8 @@ function getSymbolValue(object, description) {
   sanitize,
   sanitizeArray,
   sanitizeObject,
+  scatter,
+  seededRandom,
   shuffle,
   singular,
   sizeOf,

package/dist/cjs/lib/numbers/index.cjs

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/lib/numbers/index.js
 var numbers_exports = {};
 __export(numbers_exports, {
+  seededRandom: () => seededRandom,
   splitUnit: () => splitUnit,
   toDegrees: () => toDegrees,
   toRadians: () => toRadians
@@ -33,7 +34,16 @@ function toRadians(angle) {
   return angle * (Math.PI / 180);
 }
 
-// src/lib/numbers/index.js
+// src/lib/numbers/random.js
+function seededRandom(seed = 1) {
+  let state = seed >>> 0;
+  return () => {
+    state = state * 1664525 + 1013904223 >>> 0;
+    return state / 4294967296;
+  };
+}
+
+// src/lib/numbers/split-unit.js
 function splitUnit(string) {
   if (typeof string === "number") return [string, null];
   const regex = /(-?\d*\.?\d+)\s*([a-z]+)/i;
@@ -43,6 +53,7 @@ function splitUnit(string) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  seededRandom,
   splitUnit,
   toDegrees,
   toRadians

package/dist/cjs/lib/numbers/random.cjs

@@ -0,0 +1,35 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/numbers/random.js
+var random_exports = {};
+__export(random_exports, {
+  seededRandom: () => seededRandom
+});
+module.exports = __toCommonJS(random_exports);
+function seededRandom(seed = 1) {
+  let state = seed >>> 0;
+  return () => {
+    state = state * 1664525 + 1013904223 >>> 0;
+    return state / 4294967296;
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  seededRandom
+});

package/dist/cjs/lib/numbers/split-unit.cjs

@@ -0,0 +1,35 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/numbers/split-unit.js
+var split_unit_exports = {};
+__export(split_unit_exports, {
+  splitUnit: () => splitUnit
+});
+module.exports = __toCommonJS(split_unit_exports);
+function splitUnit(string) {
+  if (typeof string === "number") return [string, null];
+  const regex = /(-?\d*\.?\d+)\s*([a-z]+)/i;
+  const match = string.match(regex);
+  if (match) return [parseFloat(match[1]), match[2]];
+  return [parseFloat(string), null];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  splitUnit
+});

package/dist/cjs/lib/style/index.cjs

@@ -19,10 +19,43 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/lib/style/index.js
 var style_exports = {};
 __export(style_exports, {
+  scatter: () => scatter,
   toStyleString: () => toStyleString
 });
 module.exports = __toCommonJS(style_exports);
 
+// src/lib/numbers/random.js
+function seededRandom(seed = 1) {
+  let state = seed >>> 0;
+  return () => {
+    state = state * 1664525 + 1013904223 >>> 0;
+    return state / 4294967296;
+  };
+}
+
+// src/lib/style/scatter.js
+var round = (n) => {
+  const value = Math.round(n * 100) / 100;
+  return value === 0 ? 0 : value;
+};
+function scatter(count, options = {}) {
+  const { seed = 1, spread = 20, rotation = 6, amount = 1 } = options;
+  const random = seededRandom(seed);
+  const items = [];
+  for (let i = 0; i < count; i++) {
+    const x = round((random() - 0.5) * 2 * spread * amount);
+    const y = round((random() - 0.5) * 2 * spread * amount);
+    const r = round((random() - 0.5) * 2 * rotation * amount);
+    items.push({
+      x,
+      y,
+      rotation: r,
+      transform: `translate(${x}%, ${y}%) rotate(${r}deg)`
+    });
+  }
+  return items;
+}
+
 // src/lib/strings/convert-case/convert-case.js
 function toKebab(string) {
   if (!string) return "";
@@ -49,7 +82,7 @@ function isDigit(char) {
   return /[0-9]/.test(char);
 }
 
-// src/lib/style/index.js
+// src/lib/style/to-style-string.js
 function toStyleString(style) {
   if (!style) return null;
   if (typeof style === "string") return style;
@@ -60,5 +93,6 @@ function toStyleString(style) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  scatter,
   toStyleString
 });

package/dist/cjs/lib/style/scatter.cjs

@@ -0,0 +1,60 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/style/scatter.js
+var scatter_exports = {};
+__export(scatter_exports, {
+  scatter: () => scatter
+});
+module.exports = __toCommonJS(scatter_exports);
+
+// src/lib/numbers/random.js
+function seededRandom(seed = 1) {
+  let state = seed >>> 0;
+  return () => {
+    state = state * 1664525 + 1013904223 >>> 0;
+    return state / 4294967296;
+  };
+}
+
+// src/lib/style/scatter.js
+var round = (n) => {
+  const value = Math.round(n * 100) / 100;
+  return value === 0 ? 0 : value;
+};
+function scatter(count, options = {}) {
+  const { seed = 1, spread = 20, rotation = 6, amount = 1 } = options;
+  const random = seededRandom(seed);
+  const items = [];
+  for (let i = 0; i < count; i++) {
+    const x = round((random() - 0.5) * 2 * spread * amount);
+    const y = round((random() - 0.5) * 2 * spread * amount);
+    const r = round((random() - 0.5) * 2 * rotation * amount);
+    items.push({
+      x,
+      y,
+      rotation: r,
+      transform: `translate(${x}%, ${y}%) rotate(${r}deg)`
+    });
+  }
+  return items;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  scatter
+});

package/dist/cjs/lib/style/to-style-string.cjs

@@ -0,0 +1,64 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/style/to-style-string.js
+var to_style_string_exports = {};
+__export(to_style_string_exports, {
+  toStyleString: () => toStyleString
+});
+module.exports = __toCommonJS(to_style_string_exports);
+
+// src/lib/strings/convert-case/convert-case.js
+function toKebab(string) {
+  if (!string) return "";
+  return string.split("").map((letter, index) => {
+    const previousLetter = string[index - 1] || "";
+    const currentLetter = letter;
+    if (isDigit(currentLetter) && !isDigit(previousLetter)) {
+      return `-${currentLetter}`;
+    }
+    if (!isCaps(currentLetter)) return currentLetter;
+    if (previousLetter === "") {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    if (isCaps(previousLetter)) {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    return `-${currentLetter.toLowerCase()}`;
+  }).join("").trim().replace(/[-_\s]+/g, "-");
+}
+function isCaps(char) {
+  return /\p{Lu}/u.test(char);
+}
+function isDigit(char) {
+  return /[0-9]/.test(char);
+}
+
+// src/lib/style/to-style-string.js
+function toStyleString(style) {
+  if (!style) return null;
+  if (typeof style === "string") return style;
+  return Object.entries(style).map(([k, v]) => {
+    if (k.startsWith("--")) return `${k}:${v}`;
+    else return `${toKebab(k)}:${v}`;
+  }).join("; ").concat(";");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  toStyleString
+});