@vettvangur/vanilla 0.0.57 → 0.0.59

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,32 @@ 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 || typeof obj !== 'object') {
+    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];
+    }
+    return acc;
+  }, {});
 };
 
 export { fetcher, flatten, regexr };

package/dist/dom.esm.js

@@ -1,25 +1,25 @@
-/**
- * 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() {
   const body = document.querySelector('.body');
@@ -33,17 +33,17 @@ function preloadTimeout() {
   }, 400);
 }
 
-/**
- * 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

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,19 +35,19 @@ 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)
  */
 function dictionary(key, data, culture = 'is-IS') {
   const notFound = '[Translation not found]';
@@ -64,21 +64,21 @@ function dictionary(key, data, culture = 'is-IS') {
   return 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 +90,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 +121,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 +152,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 +174,46 @@ 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 || typeof obj !== 'object') {
+    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];
+    }
+    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 +223,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 +247,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,16 +266,16 @@ 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() {
   const body = document.querySelector('.body');
@@ -305,17 +289,17 @@ function preloadTimeout() {
   }, 400);
 }
 
-/**
- * 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
@@ -360,11 +344,11 @@ function clickOutside(callback) {
   });
 }
 
-/**
- * Umbraco.
- *
- * @example
- * console.log(Umbraco)
+/**
+ * Umbraco.
+ *
+ * @example
+ * console.log(Umbraco)
  */
 const Umbraco = Object.freeze({
   NODE: 'node',
@@ -374,42 +358,37 @@ 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);

package/dist/server.esm.js

@@ -2,33 +2,33 @@ import path from 'node:path';
 import process from 'node:process';
 import dotenv from 'dotenv';
 
-/**
- * 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({
@@ -40,34 +40,26 @@ 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;
   }
 }
 
-/**
- * Umbraco.
- *
- * @example
- * console.log(Umbraco)
+/**
+ * Umbraco.
+ *
+ * @example
+ * console.log(Umbraco)
  */
 const Umbraco = Object.freeze({
   NODE: 'node',
@@ -140,11 +132,11 @@ async function loadEnvFiles(showMessage = true) {
  * @param {string} [options.expand=''] - Fields to expand.
  * @param {string} [options.node=''] - Specific node to fetch extras for (if applicable).
  * @param {string} [options.contentType=''] - Type of content - used to fetch extraData for that specific type.
- * @returns {string} The constructed URL for fetching Umbraco content.
+ * @returns {Promise<string>} The constructed URL for fetching Umbraco content.
  * @throws Will throw an error if an unsupported fetch type is provided.
  */
-function getUmbracoFetchUrl(route, fetchType, options = {}) {
-  loadEnvFiles();
+async function getUmbracoFetchUrl(route, fetchType, options = {}) {
+  await loadEnvFiles(false);
   const params = {
     skip: options.skip || 0,
     take: options.take || 9999,
@@ -197,21 +189,16 @@ async function getUmbracoData({
   options = {},
   fetchOptions = {}
 }) {
-  try {
-    /** @type {string[]} */
-    const validFetchTypes = Object.values(Umbraco);
-    if (!validFetchTypes.includes(fetchType)) {
-      throw new Error(`Invalid fetch type: ${fetchType}`);
-    }
-    const umbracofetchUrl = getUmbracoFetchUrl(route, fetchType, options);
-    return await fetcher({
-      url: umbracofetchUrl,
-      options: fetchOptions
-    });
-  } catch (error) {
-    console.error('[@vettvangur/vanilla :: getUmbracoData]', error);
-    return null;
+  /** @type {string[]} */
+  const validFetchTypes = Object.values(Umbraco);
+  if (!validFetchTypes.includes(fetchType)) {
+    throw new Error(`Invalid fetch type: ${fetchType}`);
   }
+  const umbracofetchUrl = await getUmbracoFetchUrl(route, fetchType, options);
+  return fetcher({
+    url: umbracofetchUrl,
+    options: fetchOptions
+  });
 }
 
 export { getUmbracoData, loadEnvFiles };

package/dist/string.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,19 +35,19 @@ 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)
  */
 function dictionary(key, data, culture = 'is-IS') {
   const notFound = '[Translation not found]';
@@ -64,17 +64,17 @@ function dictionary(key, data, culture = 'is-IS') {
   return notFound;
 }
 
-/**
- * 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) {
@@ -83,42 +83,37 @@ function isEmpty(value) {
   return false;
 }
 
-/**
- * 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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vettvangur/vanilla",
-  "version": "0.0.57",
+  "version": "0.0.59",
   "description": "Vettvangur | Vanilla JS Utility Library",
   "access": "public",
   "type": "module",