@vettvangur/vanilla 0.0.58 → 0.0.60

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,46 +35,58 @@ 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);
   }
-  return notFound;
+  const item = byKey.get(key);
+  if (!item) {
+    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;
 }
 
-/**
- * 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,45 +95,42 @@ 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);
+  // 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;
 }
 

package/dist/types/index.d.ts

@@ -25,20 +25,6 @@
  * capitalize(value, lowerRest)
  */
 export function capitalize(value: any, lowerRest?: boolean): any;
-/**
- * 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)
- */
 export function dictionary(key: any, data: any, culture?: string): any;
 /**
  * Fetcher.
@@ -113,7 +99,7 @@ export function isEmpty(value: any): boolean;
  *
  * preloadTimeout()
  */
-export function preloadTimeout(): void;
+export function preloadTimeout(): () => void;
 /**
  * Click outside.
  *
@@ -126,7 +112,7 @@ export function preloadTimeout(): void;
  *
  * clickOutside(callback)
  */
-export function clickOutside(callback: any): void;
+export function clickOutside(callback: any): () => void;
 /**
  * Get translation.
  *

package/package.json

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