@cocreate/utils 1.40.0 → 1.41.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.41.0](https://github.com/CoCreate-app/CoCreate-utils/compare/v1.40.1...v1.41.0) (2025-11-16)
+
+
+### Features
+
+* add uid function to generate UUIDs with customizable length ([7103971](https://github.com/CoCreate-app/CoCreate-utils/commit/71039712fe19d37bacdd5cd23db3366dd6b16ccb))
+
+## [1.40.1](https://github.com/CoCreate-app/CoCreate-utils/compare/v1.40.0...v1.40.1) (2025-10-10)
+
+
+### Bug Fixes
+
+* refine getRelativePath handling for localhost and improve getValueFromObject validation ([b7bd32f](https://github.com/CoCreate-app/CoCreate-utils/commit/b7bd32fa83d503108e9398e40c1c519caadb8ed5))
+
 # [1.40.0](https://github.com/CoCreate-app/CoCreate-utils/compare/v1.39.2...v1.40.0) (2025-10-08)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocreate/utils",
-  "version": "1.40.0",
+  "version": "1.41.0",
   "description": "A simple utils component in vanilla javascript. Easily configured using HTML5 attributes and/or JavaScript API.",
   "keywords": [
     "utils",

package/src/index.js

@@ -46,15 +46,17 @@
 			path = window.location.pathname.replace(/\/[^\/]*$/, ""); // Remove file from path
 		}
 
-		// For localhost/127.0.0.1, trim everything after '/src'
+		// For localhost/127.0.0.1, remove everything up to and including the first '/src'
+		// so content AFTER '/src' is treated as the root
 		if (
 			isBrowser &&
 			(location.hostname === "localhost" ||
 				location.hostname === "127.0.0.1")
 		) {
+			// Find the '/src' directory in the path and keep everything after it (exclude '/src' itself)
 			const srcIndex = path.indexOf("/src");
 			if (srcIndex !== -1) {
-				path = path.substring(0, srcIndex + 4); // keep '/src'
+				path = path.slice(srcIndex + 4); // remove '/src' and everything before it
 			}
 		}
 
@@ -112,6 +114,21 @@
 		};
 	}
 
+	function uid(length = 36) {
+		let pattern = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx';
+		if (length > 36) {
+			length = 36; // If requested length is more than 36, set it to 36.
+		}
+
+		let uuid = pattern.replace(/[xy]/g, function (c) {
+			var r = (Math.random() * 16) | 0;
+			var v = c === 'x' ? r : (r & 0x3 | 0x8);
+			return v.toString(16);
+		}).substring(0, length); // Truncate to the requested length.
+
+		return uuid;
+	}
+
 	function checkValue(value) {
 		if (/{{\s*([\w\W]+)\s*}}/g.test(value)) return false;
 		else return true;
@@ -314,13 +331,14 @@
 
 	function getValueFromObject(object = {}, path = "", throwError = false) {
 		try {
-			if (!Object.keys(object).length || !path) {
+			if ((!Array.isArray(object) && !Object.keys(object).length) || !path) {
 				if (throwError)
 					throw new Error("Invalid input to getValueFromObject");
 				return;
 			}
 
-			path = path.replace(/\[(\d+)\]/g, ".$1");
+			// remove leading dot if path is like `[0].src`
+			path = path.replace(/\[(\d+)\]/g, ".$1").replace(/^\./, '');
 
 			let data = object,
 				subpath = path.split(".");
@@ -706,106 +724,114 @@
 	 * @returns {Array} - An array of elements that match the query.
 	 */
 	function queryElements({ element = document, prefix, selector }) {
-		// Initialize a Set to store unique elements.
-		let elements = new Set();
-
-		// If no selector is provided and the element is an element node.
-		if (!selector && element.nodeType === 1) {
-			// If no prefix is provided, derive one from the element's attributes.
-			if (!prefix) {
-				for (let attr of element.attributes) {
-					// If an attribute with "-query" suffix is found, extract prefix.
-					if (attr.name.endsWith("-query")) {
-						prefix = attr.name.slice(0, -6);
+		try {
+			// Initialize a Set to store unique elements.
+			let elements = new Set();
+
+			// If no selector is provided and the element is an element node.
+			if (!selector && element.nodeType === 1) {
+				// If no prefix is provided, derive one from the element's attributes.
+				if (!prefix) {
+					for (let attr of element.attributes) {
+						// If an attribute with "-query" suffix is found, extract prefix.
+						if (attr.name.endsWith("-query")) {
+							prefix = attr.name.slice(0, -6);
+						}
 					}
+					// If no valid prefix is found, exit the function.
+					if (!prefix) return [];
 				}
-				// If no valid prefix is found, exit the function.
-				if (!prefix) return false;
+				// Get the selector using the derived prefix.
+				selector = element.getAttribute(prefix + "-" + "query");
+				if (!selector) return []; // Exit if no selector is found.
 			}
-			// Get the selector using the derived prefix.
-			selector = element.getAttribute(prefix + "-" + "query");
-			if (!selector) return false; // Exit if no selector is found.
-		}
 
-		// Split complex selectors into individual ones, handling nested structures.
-		let selectors = selector.split(/,(?![^()\[\]]*[)\]])/g);
-		for (let i = 0; i < selectors.length; i++) {
-			if (!selectors[i]) continue; // Skip empty selectors.
+			// Split complex selectors into individual ones, handling nested structures.
+			let selectors = selector.split(/,(?![^()\[\]]*[)\]])/g);
+			for (let i = 0; i < selectors.length; i++) {
+				if (!selectors[i]) continue; // Skip empty selectors.
 
-			let queriedElement = element; // Start query from the current element.
+				let queriedElement = element; // Start query from the current element.
 
-			// If media queries are included, verify and filter the selector accordingly.
-			if (selectors[i].includes("@")) {
-				selectors[i] = checkMediaQueries(selectors[i]);
-				if (selectors[i] === false) continue; // Skip if media query is not matched.
-			}
+				// If media queries are included, verify and filter the selector accordingly.
+				if (selectors[i].includes("@")) {
+					selectors[i] = checkMediaQueries(selectors[i]);
+					if (selectors[i] === false) continue; // Skip if media query is not matched.
+				}
+
+				let remainingSelector = selectors[i].trim(); // Trim any whitespace.
+				let match;
+
+				// Process each part of the selector that corresponds to specific query types/operators.
+				while (
+					(match = queryTypesRegex.exec(remainingSelector)) !== null
+				) {
+					const matchIndex = match.index;
+					const operator = match[0];
+
+					// Process the part before the operator (if any).
+					const part = remainingSelector
+						.substring(0, matchIndex)
+						.trim()
+						.replace(/,$/, "");
+					if (part) {
+						queriedElement = querySelector(queriedElement, part);
+						if (!queriedElement) break; // Exit loop if no element is found.
+					}
+
+					// Remove the processed part and operator from the remaining selector.
+					remainingSelector = remainingSelector
+						.substring(matchIndex + operator.length)
+						.trim();
+
+					// Handle the $closest operator specifically.
+					if (operator === "$closest") {
+						let [closest, remaining = ""] =
+							remainingSelector.split(/\s+/, 2);
+						queriedElement = queriedElement.closest(closest);
+						remainingSelector = remaining.trim();
+					} else {
+						// Process other operators using the queryType function.
+						queriedElement = queryType(queriedElement, operator);
+					}
 
-			let remainingSelector = selectors[i].trim(); // Trim any whitespace.
-			let match;
-
-			// Process each part of the selector that corresponds to specific query types/operators.
-			while ((match = queryTypesRegex.exec(remainingSelector)) !== null) {
-				const matchIndex = match.index;
-				const operator = match[0];
-
-				// Process the part before the operator (if any).
-				const part = remainingSelector
-					.substring(0, matchIndex)
-					.trim()
-					.replace(/,$/, "");
-				if (part) {
-					queriedElement = querySelector(queriedElement, part);
 					if (!queriedElement) break; // Exit loop if no element is found.
 				}
 
-				// Remove the processed part and operator from the remaining selector.
-				remainingSelector = remainingSelector
-					.substring(matchIndex + operator.length)
-					.trim();
+				if (!queriedElement) continue; // Skip if no element is found.
 
-				// Handle the $closest operator specifically.
-				if (operator === "$closest") {
-					let [closest, remaining = ""] = remainingSelector.split(
-						/\s+/,
-						2
+				// Process the remaining part after the last operator (if any).
+				if (remainingSelector) {
+					queriedElement = querySelector(
+						queriedElement,
+						remainingSelector
 					);
-					queriedElement = queriedElement.closest(closest);
-					remainingSelector = remaining.trim();
-				} else {
-					// Process other operators using the queryType function.
-					queriedElement = queryType(queriedElement, operator);
 				}
 
-				if (!queriedElement) break; // Exit loop if no element is found.
-			}
-
-			if (!queriedElement) continue; // Skip if no element is found.
-
-			// Process the remaining part after the last operator (if any).
-			if (remainingSelector) {
-				queriedElement = querySelector(
-					queriedElement,
-					remainingSelector
-				);
-			}
-
-			// Add elements to the set.
-			if (
-				Array.isArray(queriedElement) ||
-				queriedElement instanceof HTMLCollection ||
-				queriedElement instanceof NodeList
-			) {
-				for (let el of queriedElement) {
-					if (el instanceof Element) {
-						elements.add(el);
+				// Add elements to the set.
+				if (
+					Array.isArray(queriedElement) ||
+					queriedElement instanceof HTMLCollection ||
+					queriedElement instanceof NodeList
+				) {
+					for (let el of queriedElement) {
+						if (el instanceof Element) {
+							elements.add(el);
+						}
 					}
+				} else if (queriedElement instanceof Element) {
+					elements.add(queriedElement);
 				}
-			} else if (queriedElement instanceof Element) {
-				elements.add(queriedElement);
 			}
-		}
 
-		return Array.from(elements); // Convert Set to Array and return found elements.
+			return Array.from(elements); // Convert Set to Array and return found elements.
+		} catch (e) {
+			console.error(
+				`CoCreate: Error in queryElements with selector: "${selector}".`,
+				e
+			);
+			return [];
+		}
 	}
 
 	function queryType(element, type) {
@@ -1275,6 +1301,7 @@
 	return {
 		getRelativePath,
 		ObjectId,
+		uid,
 		checkValue,
 		isValidDate,
 		dotNotationToObject,