@tuspe/components 1.6.26 → 1.7.0

package/README.md

@@ -201,3 +201,54 @@ A simple `Modal` component that displays a popup with customizable content.
     title?: string
   }
 ```
+
+## Functions
+
+### calculatePreTax
+
+Computes the pre-tax amount by subtracting the tax from the total, using the specified VAT percentage.
+
+### calculateTax
+
+Calculates the tax portion of a total amount based on a given VAT percentage (default: 25.5%), ensuring precision.
+
+### fixNumber
+
+Converts a number or string to a rounded number with two decimal places, ensuring precision.
+
+### formatPrice
+
+Formats a number or string as a price with two decimal places, spaces as thousand separators, optional comma as a decimal separator, and an appended currency symbol (default: €).
+
+### handleCache
+
+Retrieves or stores values in the cache; keys are slugified, and values are updated or returned if they exist. This ensures that `+page.ts` and other pages only retrieve data from the backend once and that the WordPress frontend uses the product list data on the product page without retrieving the same page again.
+
+## preventDefault
+
+Previously, Svelte handled form submission without reloading the page. However, the `preventDefault` function is no longer supported by Svelte v5, so this function handles form submission without loading the page.
+
+### slugify
+
+Converts a string to a URL-friendly format by replacing special characters, removing quotes, and replacing non-alphanumeric characters with hyphens.
+
+
+### summary
+
+This function removes any HTML tags from a given string, then trims it to a maximum of 160 characters. If possible, it truncates at the last occurrence of a sentence-ending character (".", "!", "?"); otherwise, it appends "..." to indicate truncation.
+
+### validateArray
+
+Checks if a value is an array and contains more than a specified number of items (default: 0).
+
+### validateEmail
+
+Validates if a string is a properly formatted email address.
+
+### validateSlug
+
+Checks if a given string is a valid slug by ensuring it matches its slugified version.
+
+### validateString
+
+Ensures a string contains only allowed characters (letters, numbers, spaces, and certain symbols).

package/dist/index.d.ts

@@ -55,3 +55,7 @@ export declare const handleCache: (key: string, value?: any) => any;
  * PREVENT DEFAULT
  */
 export declare const preventDefault: (fn: Function) => (this: any, event: any) => void;
+/**
+ * SUMMARY
+ */
+export declare const summary: (text: string, num?: number) => string;

package/dist/index.js

@@ -103,3 +103,31 @@ export const preventDefault = (fn) => {
         fn.call(this, event);
     };
 };
+/**
+ * SUMMARY
+ */
+export const summary = (text, num = 160) => {
+    // Remove HTML tags
+    let sum = text.replace(/<[^>]*>/g, '').trim();
+    // If the summary is within the limit, return it directly.
+    if (sum.length <= num) {
+        return sum;
+    }
+    // Truncate the summary to the specified number of characters.
+    let truncatedSummary = sum.substring(0, num);
+    // Define end characters to find the last occurrence for truncation.
+    const endChars = ['.', '!', '?'];
+    // Variable to track if an end character is found.
+    let foundEndChar = false;
+    // Find the last occurrence of any end character within the truncated summary.
+    for (const char of endChars) {
+        const lastIndex = truncatedSummary.lastIndexOf(char);
+        if (lastIndex !== -1) {
+            truncatedSummary = truncatedSummary.substring(0, lastIndex + 1);
+            foundEndChar = true;
+            break; // Exit loop after finding the first end character.
+        }
+    }
+    // Return the summary. Append ellipsis only if no end character was found.
+    return truncatedSummary.trim() + (foundEndChar ? '' : '...');
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuspe/components",
-  "version": "1.6.26",
+  "version": "1.7.0",
   "description": "A reusable SvelteKit component library for form elements, breadcrumbs, prices and images.",
   "keywords": [
     "svelteKit",