@vettvangur/vanilla 0.0.58 → 0.0.60

package/dist/index.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
  */
 
-/**
- * @memberof @vettvangur/vanilla
+/**
+ * @memberof @vettvangur/vanilla
  */
 
-/**
- * Capitalize.
- *
- * @param value - Value.
- * @param lowerRest - Value.
- * @returns Result of the operation.
- *
- * @example
- * // vanilla (src/tools/javascript/vanilla/index.mjs)
- * // import { capitalize } from '@vettvangur/vanilla'
- *
- * capitalize(value, lowerRest)
+/**
+ * Capitalize.
+ *
+ * @param value - Value.
+ * @param lowerRest - Value.
+ * @returns Result of the operation.
+ *
+ * @example
+ * // vanilla (src/tools/javascript/vanilla/index.mjs)
+ * // import { capitalize } from '@vettvangur/vanilla'
+ *
+ * capitalize(value, lowerRest)
  */
 function capitalize(value, lowerRest = false) {
   if (!value) {
@@ -35,50 +35,62 @@ function capitalize(value, lowerRest = false) {
   return firstChar + rest;
 }
 
-/**
- * Dictionary.
- *
- * @param key - Value.
- * @param data - Value.
- * @param culture - Value.
- * @returns Result of the operation.
- *
- * @example
- * // vanilla (src/tools/javascript/vanilla/index.mjs)
- * // import { dictionary } from '@vettvangur/vanilla'
- *
- * dictionary(key, data, culture)
+/**
+ * Dictionary.
+ *
+ * @param key - Value.
+ * @param data - Value.
+ * @param culture - Value.
+ * @returns Result of the operation.
+ *
+ * @example
+ * // vanilla (src/tools/javascript/vanilla/index.mjs)
+ * // import { dictionary } from '@vettvangur/vanilla'
+ *
+ * dictionary(key, data, culture)
  */
+// WeakMap keyed by the input `data` array gives us O(1) memo lookups while
+// still letting unreachable translation arrays be garbage-collected.
+const dictionaryIndex = new WeakMap();
 function dictionary(key, data, culture = 'is-IS') {
+  var _item$values$find;
   const notFound = '[Translation not found]';
   if (data === null || data === undefined) {
     return notFound;
   }
-  for (const item of data) {
-    if (item.itemKey === key) {
-      var _item$values$find;
-      const translation = (_item$values$find = item.values.find(b => b.language === culture)) === null || _item$values$find === void 0 ? void 0 : _item$values$find.value;
-      return translation || notFound;
+  let byKey = dictionaryIndex.get(data);
+  if (!byKey) {
+    byKey = new Map();
+    for (const _item of data) {
+      if (_item && _item.itemKey) {
+        byKey.set(_item.itemKey, _item);
+      }
     }
+    dictionaryIndex.set(data, byKey);
+  }
+  const item = byKey.get(key);
+  if (!item) {
+    return notFound;
   }
-  return notFound;
+  const translation = (_item$values$find = item.values.find(b => b.language === culture)) === null || _item$values$find === void 0 ? void 0 : _item$values$find.value;
+  return translation || notFound;
 }
 
-/**
- * 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({
@@ -90,35 +102,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 {
@@ -129,25 +133,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,
@@ -160,14 +164,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,
@@ -182,54 +186,49 @@ 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;
+  }, {});
 };
 
-/**
- * Get template.
- *
- * @param alias - Value.
- * @param templates - Value.
- * @returns Result of the operation.
- *
- * @example
- * // vanilla (src/tools/javascript/vanilla/index.mjs)
- * // import { getTemplate } from '@vettvangur/vanilla'
- *
- * getTemplate(alias, templates)
+/**
+ * Get template.
+ *
+ * @param alias - Value.
+ * @param templates - Value.
+ * @returns Result of the operation.
+ *
+ * @example
+ * // vanilla (src/tools/javascript/vanilla/index.mjs)
+ * // import { getTemplate } from '@vettvangur/vanilla'
+ *
+ * getTemplate(alias, templates)
  */
 function getTemplate(alias, templates) {
   const template = templates[capitalize(alias)];
@@ -239,18 +238,18 @@ function getTemplate(alias, templates) {
   return template;
 }
 
-/**
- * Get block.
- *
- * @param alias - Value.
- * @param blocks - Value.
- * @returns Result of the operation.
- *
- * @example
- * // vanilla (src/tools/javascript/vanilla/index.mjs)
- * // import { getBlock } from '@vettvangur/vanilla'
- *
- * getBlock(alias, blocks)
+/**
+ * Get block.
+ *
+ * @param alias - Value.
+ * @param blocks - Value.
+ * @returns Result of the operation.
+ *
+ * @example
+ * // vanilla (src/tools/javascript/vanilla/index.mjs)
+ * // import { getBlock } from '@vettvangur/vanilla'
+ *
+ * getBlock(alias, blocks)
  */
 function getBlock(alias, blocks) {
   if (!blocks) {
@@ -263,17 +262,17 @@ function getBlock(alias, blocks) {
   return block;
 }
 
-/**
- * Return whether empty is enabled.
- *
- * @param value - Value.
- * @returns Boolean indicating whether empty is enabled.
- *
- * @example
- * // vanilla (src/tools/javascript/vanilla/index.mjs)
- * // import { isEmpty } from '@vettvangur/vanilla'
- *
- * isEmpty(value)
+/**
+ * Return whether empty is enabled.
+ *
+ * @param value - Value.
+ * @returns Boolean indicating whether empty is enabled.
+ *
+ * @example
+ * // vanilla (src/tools/javascript/vanilla/index.mjs)
+ * // import { isEmpty } from '@vettvangur/vanilla'
+ *
+ * isEmpty(value)
  */
 function isEmpty(value) {
   if (value === '' || value === undefined || value === null) {
@@ -282,89 +281,92 @@ function isEmpty(value) {
   return false;
 }
 
-/**
- * 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);
+  };
 }
 
-/**
- * Umbraco.
- *
- * @example
- * console.log(Umbraco)
+/**
+ * Umbraco.
+ *
+ * @example
+ * console.log(Umbraco)
  */
 const Umbraco = Object.freeze({
   NODE: 'node',
@@ -374,45 +376,42 @@ const Umbraco = Object.freeze({
   EXTRA: 'extra'
 });
 
-/**
- * Get translation.
- *
- * @param key - Value.
- * @param translations - Value.
- * @returns Result of the operation.
- *
- * @example
- * // vanilla (src/tools/javascript/vanilla/index.mjs)
- * // import { getTranslation } from '@vettvangur/vanilla'
- *
- * getTranslation(key, translations)
+/**
+ * Get translation.
+ *
+ * @param key - Value.
+ * @param translations - Value.
+ * @returns Result of the operation.
+ *
+ * @example
+ * // vanilla (src/tools/javascript/vanilla/index.mjs)
+ * // import { getTranslation } from '@vettvangur/vanilla'
+ *
+ * getTranslation(key, translations)
  */
 function getTranslation(key, translations) {
   if (!translations) {
     return;
   }
-  const translation = translations[key];
-  if (!translation) {
-    console.error(`[vettvangur-vanilla :: getTranslation] No translation for key ${key} found.`);
-    return;
-  }
-  return translation;
+  return translations[key];
 }
 
-/**
- * Get culture.
- *
- * @param path - Value.
- * @returns Result of the operation.
- *
- * @example
- * // vanilla (src/tools/javascript/vanilla/index.mjs)
- * // import { getCulture } from '@vettvangur/vanilla'
- *
- * getCulture(path)
+/**
+ * Get culture.
+ *
+ * @param path - Value.
+ * @returns Result of the operation.
+ *
+ * @example
+ * // vanilla (src/tools/javascript/vanilla/index.mjs)
+ * // import { getCulture } from '@vettvangur/vanilla'
+ *
+ * getCulture(path)
  */
 function getCulture(path) {
-  const match = path.match(/^\/([a-z]{2})(\/|$)/i);
+  // Match BCP-47-ish prefixes: 2-3 letter language, optionally followed by
+  // a region subtag (e.g. `en-US`, `eng-US`, `is`, `pt-BR`).
+  const match = path.match(/^\/([a-z]{2,3}(?:-[a-z]{2,4})?)(\/|$)/i);
   return match ? match[1].toLowerCase() : null;
 }