select-animation 1.5.0 → 1.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "select-animation",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "High-performance JavaScript animation engine for organic & fluid motion",
   "main": "select-animation.js",  
   "scripts": {

package/select-animation.js

@@ -101,36 +101,46 @@
     // Usage: select('.class', '#id')
     // -----------------------------
     // --- Enhanced DOM Selection Utility with Explicit Error Reporting ---
-    const selectDom = function (selector) {
-        // 1. Check if the input is a DOM element directly
-        if (isElement(selector)) return [selector];
-
-        // 2. Handle string selectors (e.g., ".class", "#id")
-        if (typeof selector === "string") {
-            const nodes = document.querySelectorAll(selector);
-            if (nodes.length === 0) {
-                // Warning if the selector is valid string but matches nothing
-                console.warn(`Select-Animation: No elements found matching the selector "${selector}".`);
-            }
-            return Array.from(nodes);
-        }
-
-        // 3. Handle arrays or collections
-        if (Array.isArray(selector) || (selector && typeof selector.length === "number")) {
-            return Array.from(selector).filter(isElement);
+    // --- Enhanced DOM Selection Utility (Supports Multiple Arguments) ---
+    const selectDom = function (...selectors) {
+        const allElements = [];
+
+        // If no arguments were passed at all
+        if (selectors.length === 0) {
+            console.warn("Select-Animation: selectDom() was called without any arguments.");
+            return [];
         }
 
-        // 4. CRITICAL: Handle invalid types (like numbers, null, undefined)
-        if (selector !== undefined && selector !== null) {
-            // Throwing a console error to stop the developer and force a fix
-            console.error(
-                `Select-Animation ERROR: Invalid input passed to selectDom().\n` +
-                `Expected: String (selector), HTMLElement, or Array.\n` +
-                `Received: ${typeof selector} (${selector})`
-            );
-        }
+        selectors.forEach((selector) => {
+            // 1. If the argument is already a DOM element
+            if (isElement(selector)) {
+                allElements.push(selector);
+            } 
+            // 2. If the argument is a string (Selector)
+            else if (typeof selector === "string") {
+                const nodes = document.querySelectorAll(selector);
+                if (nodes.length === 0) {
+                    console.warn(`Select-Animation: No elements found for selector "${selector}".`);
+                } else {
+                    // Spread the NodeList into our results array
+                    allElements.push(...Array.from(nodes));
+                }
+            } 
+            // 3. If the argument is an array or collection
+            else if (Array.isArray(selector) || (selector && typeof selector.length === "number")) {
+                const filtered = Array.from(selector).filter(isElement);
+                allElements.push(...filtered);
+            } 
+            // 4. INVALID INPUT: Alert the developer if they passed a number/null/etc.
+            else if (selector !== undefined && selector !== null) {
+                console.error(
+                    `Select-Animation ERROR: Invalid selector type "${typeof selector}". ` +
+                    `Expected String, Element, or Array, but received:`, selector
+                );
+            }
+        });
 
-        return [];
+        return allElements;
     };
 
     // -----------------------------