@splendidlabz/utils 1.10.1 → 1.10.3

package/dist/esm/dom/keyboard.js

@@ -1,4 +1,3 @@
-// src/dom/keyboard.js
 function isTab(event) {
   return !event.shiftKey && event.key === "Tab";
 }

package/dist/esm/dom/local-store.js

@@ -1,5 +1,4 @@
-// src/dom/local-store.js
-var localStore = {
+const localStore = {
   /**
    * Retrieves a value from localStorage
    * @param {string} key - The key to retrieve from localStorage

package/dist/esm/dom/media.js

@@ -1,4 +1,3 @@
-// src/dom/media.js
 async function imagesLoaded(node) {
   const images = Array.from(node.querySelectorAll("img"));
   const promises = images.map((img) => {

package/dist/esm/dom/observers/index.js

@@ -1,224 +1,4 @@
-// src/dom/events.js
-function dispatchEvent(node, eventName, detail, options = {}) {
-  node.dispatchEvent(
-    new CustomEvent(eventName, {
-      ...options,
-      detail
-    })
-  );
-}
-
-// src/dom/get-element.js
-function getNodeType(node) {
-  if (node instanceof Element) return "element";
-  if (node instanceof NodeList) return "nodelist";
-  if (Array.isArray(node)) return "array";
-}
-
-// src/dom/observers/observer.js
-function useObserverMethodOnTarget(target, observer, method = "observe", options = void 0) {
-  const targetType = getNodeType(target);
-  if (targetType === "element") observer[method](target, options);
-  if (targetType === "nodelist") {
-    const elements = Array.from(target);
-    elements.forEach((element) => observer[method](element, options));
-  }
-  if (targetType === "array") {
-    target.forEach((element) => observer[method](element, options));
-  }
-}
-
-// src/dom/observers/intersection-observer.js
-function intersectionObserver(target, options = {}) {
-  const { callback, ...opts } = options;
-  const observer = new IntersectionObserver(observerFn, opts);
-  useObserverMethodOnTarget(target, observer, "observe");
-  function observerFn(entries) {
-    for (const entry of entries) {
-      if (callback) callback({ entry, entries, observer });
-      else dispatchEvent(target, "intersect", { entry, entries, observer });
-    }
-  }
-  return {
-    observer,
-    observe(target2) {
-      useObserverMethodOnTarget(target2, observer, "observe", options);
-    },
-    unobserve(target2) {
-      useObserverMethodOnTarget(target2, observer, "unobserve");
-    },
-    takeRecords() {
-      return observer.takeRecords();
-    },
-    disconnect() {
-      const records = observer.takeRecords();
-      observer.disconnect();
-      if (records.length > 0) observerFn(records);
-    },
-    destroy() {
-      observer.disconnect();
-    }
-  };
-}
-
-// src/dom/observers/mutation-observer.js
-var defaultOptions = {
-  attributes: false,
-  childList: false,
-  subtree: false
-};
-function mutationObserver(target, options) {
-  options = { ...defaultOptions, ...options };
-  const { callback, ...opts } = options;
-  const observer = new MutationObserver(observerFn);
-  if (target === window) target = document.body;
-  useObserverMethodOnTarget(target, observer, "observe", opts);
-  function observerFn(entries) {
-    for (const entry of entries) {
-      if (callback) callback({ entry, entries, observer });
-      else dispatchEvent(target, "mutate", { entry, entries, observer });
-    }
-  }
-  return {
-    observer,
-    observe(target2) {
-      useObserverMethodOnTarget(target2, observer, "observe", options);
-    },
-    takeRecords() {
-      return observer.takeRecords();
-    },
-    disconnect() {
-      const records = observer.takeRecords();
-      observer.disconnect();
-      if (records.length > 0) observerFn(records);
-    },
-    destroy() {
-      observer.disconnect();
-    }
-  };
-}
-
-// src/dom/observers/resize-observer.js
-function resizeObserver(target, options) {
-  const { callback, ...opts } = options;
-  const observer = new ResizeObserver(observerFn);
-  if (target === window || target === document)
-    target = document.documentElement;
-  useObserverMethodOnTarget(target, observer, "observe", opts);
-  function observerFn(entries) {
-    for (const entry of entries) {
-      if (callback) callback({ entry, entries, observer });
-      else
-        dispatchEvent(entry.target, "resize-obs", { entry, entries, observer });
-    }
-  }
-  return {
-    observe(target2) {
-      useObserverMethodOnTarget(target2, observer, "observe", options);
-    },
-    unobserve(target2) {
-      useObserverMethodOnTarget(target2, observer, "unobserve");
-    },
-    disconnect: (_) => observer.disconnect(),
-    destroy: (_) => observer.disconnect()
-  };
-}
-
-// src/dom/observers/scroll-observer.js
-var defaultOptions2 = {
-  threshold: 0,
-  // Float between 0 to 1.
-  tolerance: 0.1,
-  // Float between 0 to 1. Tolerance for event firing
-  once: false
-  // Only fire threshold callback once
-};
-function getScrollElement(node) {
-  if (node === document || node === window || node === document.documentElement) {
-    return document.documentElement;
-  }
-  return (
-    /** @type {Element} */
-    node
-  );
-}
-function scrollObserver(node, options = {}) {
-  const { callback, onScrollDown, onScrollUp, onEnterThreshold, ...userOpts } = options;
-  const opts = { ...defaultOptions2, ...userOpts };
-  const { threshold, tolerance, once } = opts;
-  let prevScrollDirection = null;
-  let prevScrollTop = 0;
-  let prevScrollPercent = 0;
-  let thresholdFired = false;
-  let rafId = null;
-  const isDocumentScroll = node === document || node === window || node === document.documentElement;
-  const scrollElement = getScrollElement(node);
-  const eventTarget = isDocumentScroll ? window : node;
-  let cachedScrollHeight = 0;
-  let cachedClientHeight = 0;
-  updateCache();
-  const cacheObserver = resizeObserver(scrollElement, {
-    callback: updateCache
-  });
-  eventTarget.addEventListener("scroll", throttledObserve, { passive: true });
-  function throttledObserve() {
-    rafId = requestAnimationFrame(observe);
-  }
-  function updateCache() {
-    cachedScrollHeight = scrollElement.scrollHeight;
-    cachedClientHeight = scrollElement.clientHeight;
-  }
-  function observe() {
-    const scrollTop = scrollElement.scrollTop;
-    if (Math.abs(scrollTop - prevScrollTop) < 1) return;
-    const scrollDirection = scrollTop > prevScrollTop ? "down" : "up";
-    const maxScroll = Math.max(1, cachedScrollHeight - cachedClientHeight);
-    const scrollPercent = Math.min(1, Math.max(0, scrollTop / maxScroll));
-    const thresholdMin = threshold - tolerance / 2;
-    const thresholdMax = threshold + tolerance / 2;
-    const wasInThreshold = prevScrollPercent >= thresholdMin && prevScrollPercent <= thresholdMax;
-    const isInThreshold = scrollPercent >= thresholdMin && scrollPercent <= thresholdMax;
-    const hasEnteredThreshold = !wasInThreshold && isInThreshold && (!once || !thresholdFired);
-    if (hasEnteredThreshold && once) {
-      thresholdFired = true;
-    }
-    const callbackData = {
-      scrollTop,
-      scrollDirection,
-      scrollPercent,
-      directionChanged: scrollDirection !== prevScrollDirection,
-      hasEnteredThreshold,
-      isInThreshold
-    };
-    if (typeof callback === "function") {
-      callback(callbackData);
-    }
-    if (scrollDirection !== prevScrollDirection) {
-      if (scrollDirection === "down" && typeof onScrollDown === "function") {
-        onScrollDown(callbackData);
-      }
-      if (scrollDirection === "up" && typeof onScrollUp === "function") {
-        onScrollUp(callbackData);
-      }
-    }
-    if (hasEnteredThreshold && typeof onEnterThreshold === "function") {
-      onEnterThreshold(callbackData);
-    }
-    prevScrollTop = scrollTop;
-    prevScrollPercent = scrollPercent;
-    prevScrollDirection = scrollDirection;
-  }
-  return {
-    destroy() {
-      eventTarget.removeEventListener("scroll", throttledObserve);
-      if (rafId) cancelAnimationFrame(rafId);
-      cacheObserver.destroy();
-    }
-  };
-}
-export {
-  intersectionObserver,
-  mutationObserver,
-  resizeObserver,
-  scrollObserver
-};
+export * from "./intersection-observer.js";
+export * from "./mutation-observer.js";
+export * from "./resize-observer.js";
+export * from "./scroll-observer.js";

package/dist/esm/dom/observers/intersection-observer.js

@@ -1,34 +1,5 @@
-// src/dom/events.js
-function dispatchEvent(node, eventName, detail, options = {}) {
-  node.dispatchEvent(
-    new CustomEvent(eventName, {
-      ...options,
-      detail
-    })
-  );
-}
-
-// src/dom/get-element.js
-function getNodeType(node) {
-  if (node instanceof Element) return "element";
-  if (node instanceof NodeList) return "nodelist";
-  if (Array.isArray(node)) return "array";
-}
-
-// src/dom/observers/observer.js
-function useObserverMethodOnTarget(target, observer, method = "observe", options = void 0) {
-  const targetType = getNodeType(target);
-  if (targetType === "element") observer[method](target, options);
-  if (targetType === "nodelist") {
-    const elements = Array.from(target);
-    elements.forEach((element) => observer[method](element, options));
-  }
-  if (targetType === "array") {
-    target.forEach((element) => observer[method](element, options));
-  }
-}
-
-// src/dom/observers/intersection-observer.js
+import { dispatchEvent } from "../events.js";
+import { useObserverMethodOnTarget } from "./observer.js";
 function intersectionObserver(target, options = {}) {
   const { callback, ...opts } = options;
   const observer = new IntersectionObserver(observerFn, opts);

package/dist/esm/dom/observers/mutation-observer.js

@@ -1,35 +1,6 @@
-// src/dom/events.js
-function dispatchEvent(node, eventName, detail, options = {}) {
-  node.dispatchEvent(
-    new CustomEvent(eventName, {
-      ...options,
-      detail
-    })
-  );
-}
-
-// src/dom/get-element.js
-function getNodeType(node) {
-  if (node instanceof Element) return "element";
-  if (node instanceof NodeList) return "nodelist";
-  if (Array.isArray(node)) return "array";
-}
-
-// src/dom/observers/observer.js
-function useObserverMethodOnTarget(target, observer, method = "observe", options = void 0) {
-  const targetType = getNodeType(target);
-  if (targetType === "element") observer[method](target, options);
-  if (targetType === "nodelist") {
-    const elements = Array.from(target);
-    elements.forEach((element) => observer[method](element, options));
-  }
-  if (targetType === "array") {
-    target.forEach((element) => observer[method](element, options));
-  }
-}
-
-// src/dom/observers/mutation-observer.js
-var defaultOptions = {
+import { dispatchEvent } from "../events.js";
+import { useObserverMethodOnTarget } from "./observer.js";
+const defaultOptions = {
   attributes: false,
   childList: false,
   subtree: false

package/dist/esm/dom/observers/observer.js

@@ -1,11 +1,4 @@
-// src/dom/get-element.js
-function getNodeType(node) {
-  if (node instanceof Element) return "element";
-  if (node instanceof NodeList) return "nodelist";
-  if (Array.isArray(node)) return "array";
-}
-
-// src/dom/observers/observer.js
+import { getNodeType } from "../get-element.js";
 function useObserverMethodOnTarget(target, observer, method = "observe", options = void 0) {
   const targetType = getNodeType(target);
   if (targetType === "element") observer[method](target, options);

package/dist/esm/dom/observers/resize-observer.js

@@ -1,34 +1,5 @@
-// src/dom/events.js
-function dispatchEvent(node, eventName, detail, options = {}) {
-  node.dispatchEvent(
-    new CustomEvent(eventName, {
-      ...options,
-      detail
-    })
-  );
-}
-
-// src/dom/get-element.js
-function getNodeType(node) {
-  if (node instanceof Element) return "element";
-  if (node instanceof NodeList) return "nodelist";
-  if (Array.isArray(node)) return "array";
-}
-
-// src/dom/observers/observer.js
-function useObserverMethodOnTarget(target, observer, method = "observe", options = void 0) {
-  const targetType = getNodeType(target);
-  if (targetType === "element") observer[method](target, options);
-  if (targetType === "nodelist") {
-    const elements = Array.from(target);
-    elements.forEach((element) => observer[method](element, options));
-  }
-  if (targetType === "array") {
-    target.forEach((element) => observer[method](element, options));
-  }
-}
-
-// src/dom/observers/resize-observer.js
+import { dispatchEvent } from "../events.js";
+import { useObserverMethodOnTarget } from "./observer.js";
 function resizeObserver(target, options) {
   const { callback, ...opts } = options;
   const observer = new ResizeObserver(observerFn);

package/dist/esm/dom/observers/scroll-observer.js

@@ -1,61 +1,5 @@
-// src/dom/events.js
-function dispatchEvent(node, eventName, detail, options = {}) {
-  node.dispatchEvent(
-    new CustomEvent(eventName, {
-      ...options,
-      detail
-    })
-  );
-}
-
-// src/dom/get-element.js
-function getNodeType(node) {
-  if (node instanceof Element) return "element";
-  if (node instanceof NodeList) return "nodelist";
-  if (Array.isArray(node)) return "array";
-}
-
-// src/dom/observers/observer.js
-function useObserverMethodOnTarget(target, observer, method = "observe", options = void 0) {
-  const targetType = getNodeType(target);
-  if (targetType === "element") observer[method](target, options);
-  if (targetType === "nodelist") {
-    const elements = Array.from(target);
-    elements.forEach((element) => observer[method](element, options));
-  }
-  if (targetType === "array") {
-    target.forEach((element) => observer[method](element, options));
-  }
-}
-
-// src/dom/observers/resize-observer.js
-function resizeObserver(target, options) {
-  const { callback, ...opts } = options;
-  const observer = new ResizeObserver(observerFn);
-  if (target === window || target === document)
-    target = document.documentElement;
-  useObserverMethodOnTarget(target, observer, "observe", opts);
-  function observerFn(entries) {
-    for (const entry of entries) {
-      if (callback) callback({ entry, entries, observer });
-      else
-        dispatchEvent(entry.target, "resize-obs", { entry, entries, observer });
-    }
-  }
-  return {
-    observe(target2) {
-      useObserverMethodOnTarget(target2, observer, "observe", options);
-    },
-    unobserve(target2) {
-      useObserverMethodOnTarget(target2, observer, "unobserve");
-    },
-    disconnect: (_) => observer.disconnect(),
-    destroy: (_) => observer.disconnect()
-  };
-}
-
-// src/dom/observers/scroll-observer.js
-var defaultOptions = {
+import { resizeObserver } from "./resize-observer.js";
+const defaultOptions = {
   threshold: 0,
   // Float between 0 to 1.
   tolerance: 0.1,

package/dist/esm/dom/pkce.js

@@ -1,11 +1,4 @@
-// src/dom/random-string.js
-function randomString(length = 10) {
-  const firstLetter = String.fromCharCode(65 + Math.floor(Math.random() * 26));
-  const others = Math.random().toString(36).substring(2, 2 + length - 1);
-  return firstLetter + others;
-}
-
-// src/dom/pkce.js
+import { randomString } from "./random-string.js";
 async function PKCE() {
   const codeVerifier = await randomString();
   const codeChallenge = await getCodeChallenge(codeVerifier);

package/dist/esm/dom/query-params.js

@@ -1,5 +1,4 @@
-// src/dom/query-params.js
-var queryParams = {
+const queryParams = {
   get(key) {
     const searchParams = new URLSearchParams(location.search);
     return searchParams.get(key);

package/dist/esm/dom/random-string.js

@@ -1,4 +1,3 @@
-// src/dom/random-string.js
 function randomString(length = 10) {
   const firstLetter = String.fromCharCode(65 + Math.floor(Math.random() * 26));
   const others = Math.random().toString(36).substring(2, 2 + length - 1);

package/dist/esm/dom/sanitize.js

@@ -1,31 +1,8 @@
-// src/dom/sanitize.js
 import DOMPurify from "dompurify";
-
-// src/lib/form/sanitize.js
+import { sanitize as sanitizeLib } from "../lib/form/sanitize.js";
 function sanitize(value, options = {}) {
-  const { sanitizer, ...rest } = options;
-  if (!sanitizer) throw new Error("sanitizer function is required");
-  if (typeof value === "string") return sanitizer(value, rest);
-  if (Array.isArray(value)) return sanitizeArray(value, { sanitizer, ...rest });
-  if (value && typeof value === "object") {
-    return Object.fromEntries(
-      Object.entries(value).map(([key, val]) => [
-        key,
-        sanitize(val, { sanitizer, ...rest })
-      ])
-    );
-  }
-  return value;
-}
-function sanitizeArray(arr, { sanitizer, ...rest }) {
-  if (!sanitizer) throw new Error("sanitizer function is required");
-  return arr.map((item) => sanitize(item, { sanitizer, ...rest }));
-}
-
-// src/dom/sanitize.js
-function sanitize2(value, options = {}) {
-  return sanitize(value, { sanitizer: DOMPurify.sanitize, ...options });
+  return sanitizeLib(value, { sanitizer: DOMPurify.sanitize, ...options });
 }
 export {
-  sanitize2 as sanitize
+  sanitize
 };

package/dist/esm/dom/session-store.js

@@ -1,5 +1,4 @@
-// src/dom/session-store.js
-var sessionStore = {
+const sessionStore = {
   get(key) {
     const value = sessionStorage.getItem(key);
     if (!value) return;

package/dist/esm/dom/spam-prevention.js

@@ -1,4 +1,3 @@
-// src/dom/spam-prevention.js
 function preventSpam(form, { honeypotField = "hp", honeypotDuration = 2e3 } = {}) {
   const startTime = Date.now();
   let hasInteraction = false;

package/dist/esm/dom/trap-focus.js

@@ -1,124 +1,5 @@
-// src/dom/focusable.js
-function getFocusableElements(container = document.body) {
-  return {
-    /**
-     * Gets the number of keyboard focusable elements.
-     * This is useful for checking if there are any focusable elements
-     * before attempting to focus them.
-     * 
-     * @returns {number} The number of keyboard focusable elements
-     */
-    get length() {
-      return this.keyboard.length;
-    },
-    /**
-     * Gets all focusable elements within the container that are visible and enabled.
-     * This includes elements that can be focused via mouse or programmatically,
-     * but may not be keyboard focusable.
-     * 
-     * Elements are considered focusable if they:
-     * - Are not disabled
-     * - Are not hidden
-     * - Are not display:none
-     * 
-     * @returns {HTMLElement[]} Array of focusable elements that are visible and enabled
-     */
-    get all() {
-      const elements = Array.from(
-        container.querySelectorAll(
-          `a, 
-            button, 
-            input, 
-            textarea, 
-            select, 
-            details, 
-            iframe, 
-            embed, 
-            object, 
-            summary, 
-            dialog, 
-            audio[controls], 
-            video[controls], 
-            [contenteditable], 
-            [tabindex]
-          `
-        )
-      );
-      return elements.filter((el) => {
-        if (el.hasAttribute("disabled")) return false;
-        if (el.hasAttribute("hidden")) return false;
-        if (window.getComputedStyle(el).display === "none") return false;
-        return true;
-      });
-    },
-    /**
-     * Gets elements that can be focused via keyboard (tabIndex > -1).
-     * These are the elements that will be focused when using the Tab key.
-     * 
-     * @returns {HTMLElement[]} Array of keyboard focusable elements
-     */
-    get keyboard() {
-      return this.all.filter((el) => el instanceof HTMLElement && el.tabIndex > -1);
-    },
-    /**
-     * Alias for keyboard focusable elements.
-     * This is provided for semantic clarity in certain contexts.
-     * 
-     * @returns {HTMLElement[]} Array of keyboard focusable elements
-     */
-    get keyboardOnly() {
-      return this.keyboard;
-    },
-    /**
-     * Gets the first keyboard focusable element.
-     * This is useful for setting initial focus when opening a modal or dialog.
-     * 
-     * @returns {HTMLElement|null} The first focusable element or null if none exist
-     */
-    get first() {
-      return this.keyboard[0] || null;
-    },
-    /**
-     * Gets the last keyboard focusable element.
-     * This is useful for focus trapping when using Shift+Tab.
-     * 
-     * @returns {HTMLElement|null} The last focusable element or null if none exist
-     */
-    get last() {
-      return this.keyboard[this.length - 1] || null;
-    },
-    /**
-     * Gets the next focusable element after the given index.
-     * This is useful for implementing custom tab order or focus management.
-     * 
-     * @param {number} index - The current element's index in the keyboard focusable array
-     * @returns {HTMLElement|null} The next focusable element or null if none exists
-     */
-    next(index) {
-      return this.keyboard[index + 1] || null;
-    },
-    /**
-     * Gets the previous focusable element before the given index.
-     * This is useful for implementing custom tab order or focus management.
-     * 
-     * @param {number} index - The current element's index in the keyboard focusable array
-     * @returns {HTMLElement|null} The previous focusable element or null if none exists
-     */
-    prev(index) {
-      return this.keyboard[index - 1] || null;
-    }
-  };
-}
-
-// src/dom/keyboard.js
-function isTab(event) {
-  return !event.shiftKey && event.key === "Tab";
-}
-function isShiftTab(event) {
-  return event.shiftKey && event.key === "Tab";
-}
-
-// src/dom/trap-focus.js
+import { getFocusableElements } from "./focusable.js";
+import { isShiftTab, isTab } from "./keyboard.js";
 function trapFocus({ event, focusables }) {
   if (event.key !== "Tab") return;
   if (isTab(event) && document.activeElement === focusables.last) {

package/dist/esm/dom/ui/aria-current.js

@@ -1,4 +1,3 @@
-// src/dom/ui/aria-current.js
 function markActiveAnchorIn(container, anchorType = "page") {
   if (!container) return;
   const { pathname } = window.location;

package/dist/esm/dom/ui/inconsistent-button-fix.js

@@ -1,4 +1,3 @@
-// src/dom/ui/inconsistent-button-fix.js
 function inconsistentButtonFix() {
   document.addEventListener("click", (event) => {
     if (event.target instanceof HTMLButtonElement) {