@cocreate/element-prototype 1.29.3 → 1.31.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.31.0](https://github.com/CoCreate-app/CoCreate-element-prototype/compare/v1.30.0...v1.31.0) (2025-11-16)
+
+
+### Features
+
+* enhance date handling in getValue and add custom operators for number formatting and UID generation ([280a469](https://github.com/CoCreate-app/CoCreate-element-prototype/commit/280a469d7c8b007c4cb2ed35ac7f4645327ac25e))
+
+# [1.30.0](https://github.com/CoCreate-app/CoCreate-element-prototype/compare/v1.29.3...v1.30.0) (2025-10-11)
+
+
+### Features
+
+* add async support for getAttribute and enhance processOperators with async handling ([88cfe33](https://github.com/CoCreate-app/CoCreate-element-prototype/commit/88cfe33deff47ecd3c80b1c4c8b2de04b38530b1))
+
 ## [1.29.3](https://github.com/CoCreate-app/CoCreate-element-prototype/compare/v1.29.2...v1.29.3) (2025-07-13)
 
 

package/package.json

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

package/src/getAttribute.js

@@ -1,4 +1,4 @@
-import { processOperators } from "./operators";
+import { processOperators, processOperatorsAsync } from "./operators";
 
 // Store a reference to the original getAttribute function
 const originalGetAttribute = Element.prototype.getAttribute;
@@ -41,10 +41,29 @@ function getAttribute(element, name) {
 	return processOperators(element, value);
 }
 
+/**
+ * Asynchronously gets an attribute and processes its value for operators.
+ * @param {Element} element - The element from which to get the attribute.
+ * @param {string} name - The attribute name.
+ * @returns {Promise<string|object>} - A promise that resolves to the processed attribute value.
+ */
+async function getAttributeAsync(element, name) {
+	if (!(element instanceof Element)) {
+		throw new Error("First argument must be an Element");
+	}
+	let value = originalGetAttribute.call(element, name);
+	return await processOperatorsAsync(element, value);
+}
+
 // Override the getAttribute method on Element prototype
 Element.prototype.getAttribute = function (name) {
 	return getAttribute(this, name); // Use the custom getAttribute function
 };
 
+// Add getAttributeAsync to the Element prototype
+Element.prototype.getAttributeAsync = function (name) {
+	return getAttributeAsync(this, name);
+};
+
 // Export the custom getAttribute function
-export { getAttribute };
+export { getAttribute, getAttributeAsync };

package/src/getValue.js

@@ -203,6 +203,8 @@ const handleDateTime = (element, value, valueType) => {
 	} else if (value) {
 		// Initialize a new Date from the string or object
 		value = new Date(value);
+	} else {
+		value = new Date();
 	}
 
 	// Check if value is a valid date
@@ -255,6 +257,58 @@ const handleDateTime = (element, value, valueType) => {
 					let locale = element.getAttribute("locale") || "en-US";
 					value = value.toLocaleString(locale);
 					break;
+				case "addDays":
+					// Add days to the current date
+					const addDays = parseInt(element.getAttribute("add-days") || 0, 10);
+					value.setDate(value.getDate() + addDays);
+					value = value.toISOString();
+					break;
+				case "subtractDays":
+					// Subtract days from the current date
+					const subtractDays = parseInt(element.getAttribute("subtract-days") || 0, 10);
+					value.setDate(value.getDate() - subtractDays);
+					value = value.toISOString();
+					break;
+				case "startOfDay":
+					// Get the start of the current day (12:00 midnight)
+					const startOfDay = new Date(value);
+					startOfDay.setHours(0, 0, 0, 0); // Set time to midnight
+					value = startOfDay.toISOString();
+					break;
+				case "startOfWeek":
+					// Get the start of the current week (Sunday by default)
+					const startOfWeekOffset = parseInt(element.getAttribute("week-start-day") || 0, 10); // Default to Sunday (0)
+					const startOfWeek = new Date(value);
+					startOfWeek.setDate(value.getDate() - value.getDay() + startOfWeekOffset);
+					startOfWeek.setHours(0, 0, 0, 0); // Set to midnight
+					value = startOfWeek.toISOString();
+					break;
+				case "endOfWeek":
+					// Get the end of the current week (Saturday by default)
+					const endOfWeekOffset = parseInt(element.getAttribute("week-start-day") || 0, 10); // Default to Sunday (0)
+					const endOfWeek = new Date(value);
+					endOfWeek.setDate(value.getDate() - value.getDay() + 6 + endOfWeekOffset);
+					endOfWeek.setHours(23, 59, 59, 999); // Set to the end of the day
+					value = endOfWeek.toISOString();
+					break;
+				case "startOfMonth":
+					// Get the start of the month
+					value = new Date(value.getFullYear(), value.getMonth(), 1).toISOString();
+					break;
+				case "endOfMonth":
+					// Get the end of the month
+					value = new Date(value.getFullYear(), value.getMonth() + 1, 0).toISOString();
+					break;
+				case "startOfYear":
+					// Get the start of the year
+					value = new Date(value.getFullYear(), 0, 1).toISOString();
+					break;
+				case "endOfYear":
+					// Get the end of the year
+					value = new Date(value.getFullYear(), 11, 31).toISOString();
+					break;
+				
+
 				default:
 					if (typeof value[valueType] === "function") {
 						value = value[valueType]();

package/src/operators.js

@@ -1,4 +1,4 @@
-import { ObjectId, queryElements } from "@cocreate/utils";
+import { ObjectId, queryElements, getValueFromObject, uid } from "@cocreate/utils";
 
 // Operators handled directly for simple, synchronous value retrieval
 const customOperators = new Map(
@@ -36,6 +36,12 @@ const customOperators = new Map(
 			return path === "/" ? "" : path;
 		},
 		$param: (element, args) => args,
+		$getObjectValue: (element, args) => {
+			if (Array.isArray(args) && args.length >= 2) {
+				return getValueFromObject(args[0], args[1]);
+			}
+			return "";
+		},
 		$setValue: (element, args) => element.setValue(...args) || "",
 		$true: () => true,
 		$false: () => false,
@@ -48,7 +54,28 @@ const customOperators = new Map(
 			} catch (e) {
 				return value;
 			}
-		}
+		},
+		// TODO: Implement number formatting
+		$numberFormat: (element, args) => {
+			let number = parseFloat(args[0]);
+			// Simple, fixed arg mapping:
+			// args[0] = locale (internationalization)
+			// args[1] = options (object)
+			// args[2] = number (if provided). If not provided, fall back to legacy behavior where args[0] might be the number.
+			if (!Array.isArray(args)) args = [args];
+
+			const locale = args[0] || undefined;
+			const options = args[1] || {};
+			const numCandidate = args[2] !== undefined ? args[2] : args[0];
+
+			number = parseFloat(numCandidate);
+
+			if (isNaN(number)) return String(numCandidate ?? "");
+
+			return new Intl.NumberFormat(locale, options).format(number);
+		},
+		$uid: (element, args) => uid(args[0]) || "",
+
 	})
 );
 
@@ -73,6 +100,189 @@ const knownOperatorKeys = [
 	...propertyOperators
 ].sort((a, b) => b.length - a.length);
 
+/**
+ * Helper function to check if a string path starts with a known bare operator.
+ * This logic is necessary to separate '$value' from '[0].src' when no parentheses remain.
+ */
+const findBareOperatorInPath = (path, knownOperatorKeys) => {
+    const trimmedPath = path.trim();
+    for (const key of knownOperatorKeys) {
+        if (trimmedPath.startsWith(key)) {
+            const remaining = trimmedPath.substring(key.length);
+            // Edge Case Fix: Ensure the operator is followed by a space, bracket, dot, or end-of-string.
+            // This prevents "valueThing" from being incorrectly split into "$value" + "Thing".
+            if (remaining.length === 0 || /^\s|\[|\./.test(remaining)) {
+                return key;
+            }
+        }
+    }
+    return null;
+}
+
+/**
+ * Finds the innermost function call (operator + its balanced parentheses argument)
+ * in the expression. This is the core logic for iterative parsing.
+ * * @param {string} expression The full expression string.
+ * @returns {{operator: string, args: string, fullMatch: string} | null} Details of the innermost function call, or null.
+ */
+const findInnermostFunctionCall = (expression) => {
+    let balance = 0;
+    let deepestStart = -1;
+    let deepestEnd = -1;
+    let deepestBalance = -1;
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+
+    // First pass: Find the indices of the DEEPEST balanced parenthesis pair.
+    for (let i = 0; i < expression.length; i++) {
+        const char = expression[i];
+
+        if (char === '"' && !inSingleQuote) {
+            inDoubleQuote = !inDoubleQuote;
+            continue;
+        } else if (char === "'" && !inDoubleQuote) {
+            inSingleQuote = !inDoubleQuote;
+            continue;
+        }
+
+        if (inSingleQuote || inDoubleQuote) {
+            continue;
+        }
+
+        if (char === '(') {
+            balance++;
+            // Track the index of the open parenthesis that belongs to the deepest balance level
+            if (balance > deepestBalance) {
+                deepestBalance = balance;
+                deepestStart = i;
+                deepestEnd = -1; // Reset end until match is found
+            }
+        } else if (char === ')') {
+            if (balance === deepestBalance) {
+                // This is the closing parenthesis that matches the deepest open parenthesis found
+                deepestEnd = i;
+            }
+            balance--;
+        }
+    }
+    
+    // If we didn't find a balanced pair, or the match is invalid, exit.
+    if (deepestStart === -1 || deepestEnd === -1 || deepestEnd <= deepestStart) {
+        return null;
+    }
+
+    // Now we have the innermost argument content indices (deepestStart + 1 to deepestEnd - 1)
+    const rawArgs = expression.substring(deepestStart + 1, deepestEnd).trim();
+    
+    // Step 2: Find the operator name backward from the deepestStart index.
+    let operatorStart = -1;
+    let nonWhitespaceFound = false;
+
+    for (let i = deepestStart - 1; i >= 0; i--) {
+        const char = expression[i];
+        
+        // Skip trailing whitespace between operator and '('
+        if (!nonWhitespaceFound) {
+            if (/\s/.test(char)) {
+                continue;
+            }
+            nonWhitespaceFound = true;
+        }
+        
+        // Find the start of the operator name
+        // This regex captures letters, numbers, hyphens, and the required $
+        let isOperatorChar = /[\w\-\$]/.test(char);
+        
+        if (!isOperatorChar) {
+            operatorStart = i + 1;
+            break;
+        }
+        operatorStart = i;
+    }
+    
+    if (operatorStart === -1) operatorStart = 0;
+    
+    const operatorNameCandidate = expression.substring(operatorStart, deepestStart).trim();
+
+    // Step 3: Validate the operator name
+    if (knownOperatorKeys.includes(operatorNameCandidate)) {
+        // Construct the full match string: operatorNameCandidate(rawArgs)
+        const fullMatch = expression.substring(operatorStart, deepestEnd + 1);
+        
+        return {
+            operator: operatorNameCandidate,
+            args: rawArgs,
+            fullMatch: fullMatch
+        };
+    }
+    
+    return null; // Operator name invalid or not found
+};
+
+/**
+ * Main function to find the innermost operator.
+ * * Logic flow is updated to prioritize finding the innermost FUNCTION CALL,
+ * then fall back to finding a BARE OPERATOR if no function calls remain.
+ * * @param {string} expression The expression to parse.
+ * @returns {{operator: string, args: string, rawContent: string, fullMatch?: string} | {operator: null, args: string, rawContent: string}}
+ */
+const findInnermostOperator = (expression) => {
+    	// Helper function to strip leading and trailing parentheses from a string
+	function stripParentheses(str) {
+		let result = str;
+		if (result.startsWith("(")) {
+			result = result.substring(1);
+		}
+		if (result.endsWith(")")) {
+			result = result.substring(0, result.length - 1);
+		}
+		return result;
+	}
+	let args;
+
+    // --- 1. PRIORITY: Find Innermost FUNCTION CALL (Operator with Parentheses) ---
+    const functionCall = findInnermostFunctionCall(expression);
+
+    if (functionCall) {
+		// Return the full function expression details, including the full string section
+		args = stripParentheses(functionCall.args);
+		return {
+			operator: functionCall.operator,
+			args, // Arguments without parentheses
+			rawContent: functionCall.args, // The content inside the parentheses (arguments)
+			fullMatch: functionCall.fullMatch // The operator(args) string (the complete section to replace)
+		};
+	}
+    
+    // --- 2. FALLBACK: Find BARE OPERATOR (e.g., $value path) ---
+    
+    // If no function calls are found, the entire expression is treated as the raw content
+    const rawContent = expression.trim();
+
+    // Now check the raw content to see if it starts with a bare operator ($value)
+    const innermostOperator = findBareOperatorInPath(rawContent, knownOperatorKeys);
+
+    if (innermostOperator) {
+		const operatorArgs = rawContent.substring(innermostOperator.length).trim();
+		args = stripParentheses(operatorArgs);
+		return {
+			operator: innermostOperator,
+			args, // Arguments without parentheses
+			rawContent: rawContent,
+		};
+	}
+
+
+	args = stripParentheses(rawContent);
+	
+    // Fallback if no known operator is found
+    return {
+        operator: null,
+        args,
+        rawContent: rawContent
+    };
+};
+
 function escapeRegexKey(key) {
 	if (key.startsWith("$")) {
 		return "\\" + key; // Escape the leading $
@@ -82,71 +292,150 @@ function escapeRegexKey(key) {
 	return key; // Should not happen with current keys, but fallback
 }
 
-const operatorPattern = knownOperatorKeys.map(escapeRegexKey).join("|");
-
-// Regex to find potential operators and their arguments
-// $1: Potential operator identifier (e.g., $user_id, $closestDiv)
-// $2: Arguments within parentheses (optional)
-const regex = new RegExp(`(${operatorPattern})(?:\\s*\\((.*?)\\))?`, "g");
-
 /**
  * Synchronously processes a string, finding and replacing operators recursively.
  * Assumes ALL underlying operations (getValue, queryElements) are synchronous.
  * @param {Element | null} element - Context element.
  * @param {string} value - String containing operators.
  * @param {string[]} [exclude=[]] - Operator prefixes to ignore.
- * @returns {string} - Processed string.
+ * @returns {string | {value: string, params: Promise[]}} - Processed string or an object containing the partially processed string and unresolved Promises.
  */
-function processOperators(element, value, exclude = [], parent) {
+function processOperators(
+	element,
+	value,
+	exclude = [],
+	parent,
+	params = []
+) {
 	// Early exit if no operators are possible or value is not a string
 	if (typeof value !== "string" || !value.includes("$")) {
 		return value;
 	}
-	let params = [];
-	const processedValue = value.replace(
-		regex,
-		(match, operator, args = "") => {
-			// 'match' is the full matched string (e.g., "$closest(.myClass)")
-			// 'operator' is the identifier part (e.g., "$closest")
-			// 'args' is the content within parentheses (e.g., ".myClass") or "" if no parentheses
-
-			if (operator === "$param" && !args) {
-				return match;
+
+	let processedValue = value;
+	let hasPromise = false;
+	let parsedValue = null
+
+	while (processedValue.includes("$")) {
+        
+        // --- PROMISE TOKEN RESOLUTION ---
+        // If the processedValue starts with a resolved parameter token from the previous async step,
+        // substitute the token with its actual (now resolved) value from the params array.
+        const paramMatch = processedValue.match(/^\$\$PARAM_(\d+)\$\$/);
+        if (paramMatch && Array.isArray(params) && params.length > 0) {
+            const index = parseInt(paramMatch[1], 10);
+            if (index < params.length) {
+                const resolvedTokenValue = params[index];
+                processedValue = processedValue.replace(paramMatch[0], resolvedTokenValue);
+                // After replacement, we restart the loop to find the *next* innermost operator
+                continue; 
+            }
+        }
+        // --- END TOKEN RESOLUTION ---
+
+		const { operator, args, rawContent, fullMatch } = findInnermostOperator(processedValue);
+
+		if (!operator) {
+			break; // No more operators found
+		}
+
+		if (operator === "$param" && !args) {
+			break;
+		}
+
+		if (operator && !exclude.includes(operator)) {
+            
+            // --- Determine textToReplace ---
+            // The fullMatch property from findInnermostOperator ensures we correctly replace 
+            // the whole expression (e.g., "$param(...)") or just the bare operator ($value path).
+            const textToReplace = fullMatch || rawContent;
+            // --- END textToReplace CALCULATION ---
+
+			let resolvedValue = resolveOperator(element, operator, args, parent, params);
+
+			if (resolvedValue instanceof Promise) {
+				const paramIndex = params.length; // Get the index *before* push
+				params.push(resolvedValue); // Store the Promise
+                
+                // CRITICAL FIX: Replace the matched expression with a unique token, then break.
+                processedValue = processedValue.replace(textToReplace, `$$PARAM_${paramIndex}$$`);
+				hasPromise = true;
+				break; // Stop processing and yield
 			}
 
-			// If a valid operator was identified AND it's not in the exclude list
-			if (operator && !exclude.includes(operator)) {
-				// Resolve the value for the identified operator and its arguments
-				// Pass the *trimmed* arguments to the resolver
-				let resolvedValue = resolveOperator(
-					element,
-					operator,
-					args.replace(/^['"]|['"]$/g, "").trim(),
-					parent
-				);
-
-				if (operator === "$param") {
-					params.push(resolvedValue);
-					return "";
-				}
+			if (params.some((p) => p instanceof Promise)) {
+				hasPromise = true;
+				break; // A nested call found a promise, stop and yield
+			}
 
-				return resolvedValue ?? "";
+			let replacement = "";
+			if (operator === "$param") {
+				params.push(resolvedValue);
 			} else {
-				// If no known operator matched, or if it was excluded,
-				// return the original matched string (no replacement).
-				return match;
+				replacement = resolvedValue ?? "";
+			}
+
+			if (processedValue === textToReplace) {
+				processedValue = replacement;
+				break;
 			}
+				
+			processedValue = processedValue.replace(textToReplace, replacement);
+
+			if (!processedValue.includes("$")) {
+				// If there are still unresolved operators, we need to continue processing
+				break;
+			}
+
+		} else {
+			// If operator is excluded, we need to advance past it to avoid infinite loop
+			break;
 		}
-	);
+	}
+
+	if (hasPromise) {
+		return { value: processedValue, params };
+	}
 
 	if (params.length) {
-		return params;
+		if (processedValue.trim() === "") {
+			return params;
+		}
 	}
 
 	return processedValue;
 }
 
-/**
+async function processOperatorsAsync(
+	element,
+	value,
+	exclude = [],
+	parent,
+	params = []
+) {
+	let result = processOperators(element, value, exclude, parent, params);
+
+	while (typeof result === "object" && result.params) {
+		const resolvedParams = await Promise.all(result.params);
+		// Note: The second argument passed to processOperators here is the partially processed string (result.value)
+		// which now contains the PARAM tokens. The third argument is the array of resolved values (resolvedParams)
+		// which will be used to replace those tokens in the subsequent processOperators call.
+		result = processOperators(
+			element,
+			result.value,
+			exclude,
+			parent,
+			resolvedParams
+		);
+	}
+
+	if (result instanceof Promise) {
+		return await result;
+	}
+
+	return result;
+}
+
 /**
  * Synchronously determines and executes the action for processing a single operator token.
  * @param {HTMLElement|null} element - The context element from which to derive values or execute methods.
@@ -155,18 +444,28 @@ function processOperators(element, value, exclude = [], parent) {
  * @param {string} parent - Context in which the function is called, potentially affecting behavior or processing.
  * @returns {string} The final resolved value after applying the operator to the given elements.
  */
-function resolveOperator(element, operator, args, parent) {
+function resolveOperator(element, operator, args, parent, params) {
+	// If a promise is already in the params, we must stop and wait for it to be resolved.
+	if (params.some((p) => p instanceof Promise)) {
+		return "";
+	}
+
 	// If args contain any operators (indicated by '$'), process them recursively
-	if (args && args.includes("$")) {
+	if (args && typeof args === "string" && args.includes("$")) {
 		// Reprocess args to resolve any nested operators
-		args = processOperators(element, args, "", operator);
+		args = processOperators(element, args, "", operator, params);
+	}
+
+	if (params.some((p) => p instanceof Promise)) {
+		return operator;
 	}
 
 	// Initialize an array of elements to operate on, starting with the single element reference if provided
 	let targetElements = element ? [element] : [];
-
-	// If args are provided as a string, treat it as a selector to find applicable target elements
-	if (args && typeof args === "string") {
+    
+	// If the argument is a string and the operator is NOT a custom utility that expects raw data
+    // (like $param, $parse), we assume the argument is a selector.
+	if (args && typeof args === "string" && !customOperators.has(operator)) {
 		targetElements = queryElements({
 			element, // Use the context element as the base for querying
 			selector: args // Selector from args to find matching elements
@@ -182,7 +481,7 @@ function resolveOperator(element, operator, args, parent) {
 	// If the result is a string and still contains unresolved operators, process them further
 	if (value && typeof value === "string" && value.includes("$")) {
 		// Resolve any remaining operators within the value string
-		value = processOperators(element, value, parent);
+		value = processOperators(element, value, parent, params);
 	}
 
 	// Return the final processed value, fully resolved
@@ -216,8 +515,10 @@ function processValues(elements, operator, args, parent) {
 		if (typeof rawValue === "function") {
 			// If arguments are provided as an array
 			if (Array.isArray(args)) {
-				// If there are arguments, exit by returning an empty string (assumes args should not be used here)
-				if (args.length) {
+				// If the custom operator is NOT $param and has arguments, something is wrong with the flow.
+				// However, if it's a generic method on an element (like $setValue), the args are passed via spread.
+				if (customOperators.has(operator) && operator !== "$setValue" && operator !== "$getObjectValue" && args.length) {
+					// For simple custom operators that don't take multiple args, return an empty string.
 					return "";
 				}
 				// Invoke the function using the element and spread array arguments
@@ -235,6 +536,12 @@ function processValues(elements, operator, args, parent) {
 				return rawValue;
 			}
 		} else {
+			if (
+				rawValue instanceof Promise ||
+				(typeof rawValue === "object" && rawValue !== null)
+			) {
+				return rawValue;
+			}
 			// Otherwise, append the stringified rawValue to the aggregated result, defaulting to an empty string if it's nullish
 			aggregatedString += String(rawValue ?? "");
 		}
@@ -267,4 +574,4 @@ function getSubdomain() {
 	return null;
 }
 
-export { processOperators };
+export { processOperators, processOperatorsAsync };

package/src/setValue.js

@@ -87,7 +87,14 @@ const setValue = (el, value, dispatch) => {
 				}
 			}
 		} else if (el.type === "radio") {
-			el.value == value ? (el.checked = true) : (el.checked = false);
+			const wasChecked = el.checked;
+			if (el.value == value) {
+				el.checked = true;
+			} else {
+				el.checked = false;
+			}
+			// Only continue if checked state changed
+			if (el.checked === wasChecked) return;
 		} else if (el.type === "password") {
 			el.value = __decryptPassword(value);
 		} else if (el.tagName == "SELECT") {