@vettvangur/vanilla 0.0.58 → 0.0.60

package/dist/data.esm.js

@@ -1,30 +1,30 @@
-/**
- * vanilla :: index.mjs.
- *
- * Vanilla JS helper utilities.
- *
- * These docs are generated from inline JSDoc in the repo and are intended for contributors.
- *
- * @generated
- * @module vanilla
+/**
+ * vanilla :: index.mjs.
+ *
+ * Vanilla JS helper utilities.
+ *
+ * These docs are generated from inline JSDoc in the repo and are intended for contributors.
+ *
+ * @generated
+ * @module vanilla
  */
 
 
-/**
- * Fetcher.
- *
- * @param {object} options - Options object.
- * @param {string} options.url - Value.
- * @param {any} [options.options=null] - Options that control behavior.
- * @param {boolean} [options.throwOnError=false] - Value.
- * @returns Result of the operation.
- * @throws When the operation fails.
- *
- * @example
- * // vanilla (src/tools/javascript/vanilla/index.mjs)
- * // import { fetcher } from '@vettvangur/vanilla'
- *
- * await fetcher({ url: url, options: {}, throwOnError: throwOnError })
+/**
+ * Fetcher.
+ *
+ * @param {object} options - Options object.
+ * @param {string} options.url - Value.
+ * @param {any} [options.options=null] - Options that control behavior.
+ * @param {boolean} [options.throwOnError=false] - Value.
+ * @returns Result of the operation.
+ * @throws When the operation fails.
+ *
+ * @example
+ * // vanilla (src/tools/javascript/vanilla/index.mjs)
+ * // import { fetcher } from '@vettvangur/vanilla'
+ *
+ * await fetcher({ url: url, options: {}, throwOnError: throwOnError })
  */
 
 async function fetcher({
@@ -36,35 +36,27 @@ async function fetcher({
   try {
     const request = await fetch(url, options);
     if (!request.ok) {
-      const errorDetails = await request.text();
-      const fullErrorMessage = `${errorMessage} - Status: ${request.status}, ${request.statusText}, Details: ${errorDetails}`;
-      console.error(fullErrorMessage);
       if (throwOnError) {
-        throw new Error(fullErrorMessage);
+        const errorDetails = await request.text();
+        throw new Error(`${errorMessage} - Status: ${request.status}, ${request.statusText}, Details: ${errorDetails}`);
       }
-
-      // Return null instead of undefined on error for predictable handling
       return null;
     }
     return await request.json();
   } catch (error) {
-    const fullErrorMessage = `${errorMessage} - ${error}`;
-    console.error(fullErrorMessage);
     if (throwOnError) {
       throw error;
     }
-
-    // Return null instead of undefined on error for predictable handling
     return null;
   }
 }
 
-/**
- * Checks if a given string is a valid regular expression pattern.
- *
- * @ignore
- * @param {string} pattern - The regex pattern to validate.
- * @returns {boolean} Returns `true` if the pattern is a valid regex, otherwise `false`.
+/**
+ * Checks if a given string is a valid regular expression pattern.
+ *
+ * @ignore
+ * @param {string} pattern - The regex pattern to validate.
+ * @returns {boolean} Returns `true` if the pattern is a valid regex, otherwise `false`.
  */
 function isValidRegex(pattern) {
   try {
@@ -75,25 +67,25 @@ function isValidRegex(pattern) {
   }
 }
 
-/**
- * Regexr.
- *
- * @example
- * console.log(regexr)
+/**
+ * Regexr.
+ *
+ * @example
+ * console.log(regexr)
  */
 const regexr = {
-  /**
-   * Tests whether a given value matches a regex pattern.
-   *
-   * @param {Object} params - Parameters for testing regex.
-   * @param {string} params.value - The string to test against the regex.
-   * @param {string} params.pattern - The regex pattern to match.
-   * @param {string} [params.flags='g'] - Regex flags (default: 'g').
-   * @returns {boolean} Returns `true` if the value matches the pattern, otherwise `false`.
-   *
-   * @example
-   * const isMatch = regexr.match(pattern)
-   * console.log(isMatch) // return true or false
+  /**
+   * Tests whether a given value matches a regex pattern.
+   *
+   * @param {Object} params - Parameters for testing regex.
+   * @param {string} params.value - The string to test against the regex.
+   * @param {string} params.pattern - The regex pattern to match.
+   * @param {string} [params.flags='g'] - Regex flags (default: 'g').
+   * @returns {boolean} Returns `true` if the value matches the pattern, otherwise `false`.
+   *
+   * @example
+   * const isMatch = regexr.match(pattern)
+   * console.log(isMatch) // return true or false
    */
   test({
     value,
@@ -106,14 +98,14 @@ const regexr = {
     const regexp = new RegExp(pattern, flags);
     return regexp.test(value);
   },
-  /**
-   * Matches a given value against a regex pattern and returns the matches.
-   *
-   * @param {Object} params - Parameters for matching regex.
-   * @param {string} params.value - The string to match against the regex.
-   * @param {string} params.pattern - The regex pattern to match.
-   * @param {string} [params.flags='g'] - Regex flags (default: 'g').
-   * @returns {Array<string>|null} Returns an array of matches, or `null` if no match is found.
+  /**
+   * Matches a given value against a regex pattern and returns the matches.
+   *
+   * @param {Object} params - Parameters for matching regex.
+   * @param {string} params.value - The string to match against the regex.
+   * @param {string} params.pattern - The regex pattern to match.
+   * @param {string} [params.flags='g'] - Regex flags (default: 'g').
+   * @returns {Array<string>|null} Returns an array of matches, or `null` if no match is found.
    */
   match({
     value,
@@ -128,40 +120,35 @@ const regexr = {
   }
 };
 
-/**
- * Flatten.
- *
- * @param obj - Value.
- * @param prefix - Value.
- * @returns Result of the operation.
- *
- * @example
- * // vanilla (src/tools/javascript/vanilla/index.mjs)
- * // import { flatten } from '@vettvangur/vanilla'
- *
- * flatten(obj, prefix)
+/**
+ * Flatten.
+ *
+ * @param obj - Value.
+ * @param prefix - Value.
+ * @returns Result of the operation.
+ *
+ * @example
+ * // vanilla (src/tools/javascript/vanilla/index.mjs)
+ * // import { flatten } from '@vettvangur/vanilla'
+ *
+ * flatten(obj, prefix)
  */
 const flatten = (obj, prefix = '') => {
-  try {
-    if (!obj || typeof obj !== 'object') {
-      console.error('❌ FLATTEN ERROR: Received invalid data:', obj);
-      return {};
-    }
-    return Object.keys(obj).reduce((acc, key) => {
-      const fullKey = key === 'DEFAULT' ? prefix : prefix ? `${prefix}-${key}` : key;
-      if (typeof obj[key] === 'object' && key !== 'DEFAULT') {
-        Object.assign(acc, flatten(obj[key], fullKey));
-      } else if (typeof obj[key] === 'string') {
-        acc[fullKey] = obj[key];
-      } else {
-        console.warn('! Skipping Invalid Key:', key, 'Value:', obj[key]);
-      }
-      return acc;
-    }, {});
-  } catch (error) {
-    console.error('🚨 Flatten Function Error:', error);
-    return {}; // Prevents Tailwind from crashing
+  if (obj == null) {
+    return {};
   }
+  if (typeof obj !== 'object') {
+    throw new TypeError(`flatten: expected an object, got ${typeof obj}`);
+  }
+  return Object.keys(obj).reduce((acc, key) => {
+    const fullKey = key === 'DEFAULT' ? prefix : prefix ? `${prefix}-${key}` : key;
+    if (typeof obj[key] === 'object' && key !== 'DEFAULT') {
+      Object.assign(acc, flatten(obj[key], fullKey));
+    } else if (typeof obj[key] === 'string') {
+      acc[fullKey] = obj[key];
+    }
+    return acc;
+  }, {});
 };
 
 export { fetcher, flatten, regexr };

package/dist/dom.esm.js

@@ -1,91 +1,94 @@
-/**
- * vanilla :: index.mjs.
- *
- * Vanilla JS helper utilities.
- *
- * These docs are generated from inline JSDoc in the repo and are intended for contributors.
- *
- * @generated
- * @module vanilla
+/**
+ * vanilla :: index.mjs.
+ *
+ * Vanilla JS helper utilities.
+ *
+ * These docs are generated from inline JSDoc in the repo and are intended for contributors.
+ *
+ * @generated
+ * @module vanilla
  */
 
 
-/**
- * Preload timeout.
- *
- * @returns Nothing.
- *
- * @example
- * // vanilla (src/tools/javascript/vanilla/index.mjs)
- * // import { preloadTimeout } from '@vettvangur/vanilla'
- *
- * preloadTimeout()
+/**
+ * Preload timeout.
+ *
+ * @returns Nothing.
+ *
+ * @example
+ * // vanilla (src/tools/javascript/vanilla/index.mjs)
+ * // import { preloadTimeout } from '@vettvangur/vanilla'
+ *
+ * preloadTimeout()
  */
 function preloadTimeout() {
+  if (typeof document === 'undefined') {
+    return () => {};
+  }
   const body = document.querySelector('.body');
   if (!body) {
-    return;
+    return () => {};
   }
-  setTimeout(() => body.classList.add('loaded'), 100);
-  setTimeout(() => {
+  const t1 = setTimeout(() => body.classList.add('loaded'), 100);
+  const t2 = setTimeout(() => {
     body.classList.add('preload--hidden');
     body.classList.remove('preload--transitions');
   }, 400);
+  return () => {
+    clearTimeout(t1);
+    clearTimeout(t2);
+  };
 }
 
-/**
- * Click outside.
- *
- * @param callback - Value.
- * @returns Nothing.
- *
- * @example
- * // vanilla (src/tools/javascript/vanilla/index.mjs)
- * // import { clickOutside } from '@vettvangur/vanilla'
- *
- * clickOutside(callback)
+/**
+ * Click outside.
+ *
+ * @param callback - Value.
+ * @returns Nothing.
+ *
+ * @example
+ * // vanilla (src/tools/javascript/vanilla/index.mjs)
+ * // import { clickOutside } from '@vettvangur/vanilla'
+ *
+ * clickOutside(callback)
  */
 function clickOutside(callback) {
-  // Clicks
-  document.addEventListener('click', e => {
+  if (typeof document === 'undefined') {
+    return () => {};
+  }
+  const onClick = e => {
     const target = e.target;
     const classTargets = document.querySelectorAll('.co-el');
 
-    // Check if the click target is inside an element with class `.co-trigger`
     // @ts-ignore
     if (target.closest('.co-trigger')) {
       return;
     }
-
-    // Execute the callback function
     callback(e);
-
-    // Close open elements
     Array.prototype.forEach.call(classTargets, item => {
       if (item.classList.contains('open')) {
         item.classList.remove('open');
       }
     });
-  }, false);
-
-  // ESC key
-  document.addEventListener('keyup', e => {
+  };
+  const onKeyUp = e => {
     const openElements = document.querySelectorAll('.open');
     const keys = e.keyCode || e.which;
-
-    // If ESC key (key code 27) is pressed
     if (keys === 27) {
-      // Execute the callback function
       callback(e);
-
-      // Close open elements
       Array.prototype.forEach.call(openElements, item => {
         if (item.classList.contains('open')) {
           item.classList.remove('open');
         }
       });
     }
-  });
+  };
+  document.addEventListener('click', onClick, false);
+  document.addEventListener('keyup', onKeyUp);
+  return () => {
+    document.removeEventListener('click', onClick, false);
+    document.removeEventListener('keyup', onKeyUp);
+  };
 }
 
 export { clickOutside, preloadTimeout };