@bquery/bquery 1.3.0 → 1.4.0

package/dist/core.es.mjs

@@ -1,5 +1,5 @@
-import { s as f } from "./sanitize-1FBEPAFH.js";
-const g = (n) => Array.isArray(n) ? n : [n], o = (n, e) => {
+import { s as f } from "./sanitize-Cxvxa-DX.js";
+const g = (n) => Array.isArray(n) ? n : [n], l = (n, e) => {
   for (const t of n)
     e(t);
 }, p = (n) => f(n), w = (n, e) => {
@@ -13,8 +13,8 @@ const g = (n) => Array.isArray(n) ? n : [n], o = (n, e) => {
     return;
   }
   const r = g(e), i = t === "afterbegin" || t === "afterend" ? r.slice().reverse() : r;
-  o(i, (l) => {
-    n.insertAdjacentElement(t, l);
+  l(i, (o) => {
+    n.insertAdjacentElement(t, o);
   });
 };
 class h {
@@ -105,25 +105,13 @@ class h {
   htmlUnsafe(e) {
     return this.element.innerHTML = e, this;
   }
-  /**
-   * Gets or sets CSS styles on the element.
-   *
-   * @param property - A CSS property name or an object of property-value pairs
-   * @param value - The value when setting a single property
-   * @returns The instance for method chaining
-   *
-   * @example
-   * ```ts
-   * // Single property
-   * $('#box').css('color', 'red');
-   *
-   * // Multiple properties
-   * $('#box').css({ color: 'red', 'font-size': '16px' });
-   * ```
-   */
   css(e, t) {
-    if (typeof e == "string")
-      return t !== void 0 && this.element.style.setProperty(e, t), this;
+    if (typeof e == "string") {
+      if (t !== void 0)
+        return this.element.style.setProperty(e, t), this;
+      const r = this.element.ownerDocument?.defaultView;
+      return !r || typeof r.getComputedStyle != "function" ? "" : r.getComputedStyle(this.element).getPropertyValue(e);
+    }
     for (const [r, s] of Object.entries(e))
       this.element.style.setProperty(r, s);
     return this;
@@ -386,9 +374,9 @@ class h {
    * ```
    */
   delegate(e, t, r) {
-    const s = `${e}:${t}`, i = (l) => {
-      const u = l.target.closest(t);
-      u && this.element.contains(u) && r(l, u);
+    const s = `${e}:${t}`, i = (o) => {
+      const u = o.target.closest(t);
+      u && this.element.contains(u) && r(o, u);
     };
     return this.delegatedHandlers.has(s) || this.delegatedHandlers.set(s, /* @__PURE__ */ new Map()), this.delegatedHandlers.get(s).set(r, i), this.element.addEventListener(e, i), this;
   }
@@ -412,8 +400,8 @@ class h {
   undelegate(e, t, r) {
     const s = `${e}:${t}`, i = this.delegatedHandlers.get(s);
     if (i) {
-      const l = i.get(r);
-      l && (this.element.removeEventListener(e, l), i.delete(r), i.size === 0 && this.delegatedHandlers.delete(s));
+      const o = i.get(r);
+      o && (this.element.removeEventListener(e, o), i.delete(r), i.size === 0 && this.delegatedHandlers.delete(s));
     }
     return this;
   }
@@ -426,6 +414,22 @@ class h {
   matches(e) {
     return this.element.matches(e);
   }
+  /**
+   * Alias for `matches()`. Checks if the element matches a CSS selector.
+   *
+   * @param selector - CSS selector to match against
+   * @returns True if the element matches the selector
+   *
+   * @example
+   * ```ts
+   * if ($('#el').is('.active')) {
+   *   console.log('Element is active');
+   * }
+   * ```
+   */
+  is(e) {
+    return this.matches(e);
+  }
   /**
    * Checks if the element has a specific class.
    *
@@ -509,8 +513,8 @@ class h {
     for (const [s, i] of r.entries())
       if (typeof i == "string")
         if (s in t) {
-          const l = t[s];
-          Array.isArray(l) ? l.push(i) : t[s] = [l, i];
+          const o = t[s];
+          Array.isArray(o) ? o.push(i) : t[s] = [o, i];
         } else
           t[s] = i;
     return t;
@@ -661,15 +665,15 @@ class c {
   }
   /** Add one or more classes to all elements. */
   addClass(...e) {
-    return o(this.elements, (t) => t.classList.add(...e)), this;
+    return l(this.elements, (t) => t.classList.add(...e)), this;
   }
   /** Remove one or more classes from all elements. */
   removeClass(...e) {
-    return o(this.elements, (t) => t.classList.remove(...e)), this;
+    return l(this.elements, (t) => t.classList.remove(...e)), this;
   }
   /** Toggle a class on all elements. */
   toggleClass(e, t) {
-    return o(this.elements, (r) => r.classList.toggle(e, t)), this;
+    return l(this.elements, (r) => r.classList.toggle(e, t)), this;
   }
   /**
    * Sets an attribute on all elements or gets from first.
@@ -679,7 +683,7 @@ class c {
    * @returns Attribute value when getting, instance when setting
    */
   attr(e, t) {
-    return t === void 0 ? this.first()?.getAttribute(e) ?? "" : (o(this.elements, (r) => r.setAttribute(e, t)), this);
+    return t === void 0 ? this.first()?.getAttribute(e) ?? "" : (l(this.elements, (r) => r.setAttribute(e, t)), this);
   }
   /**
    * Removes an attribute from all elements.
@@ -688,11 +692,11 @@ class c {
    * @returns The instance for method chaining
    */
   removeAttr(e) {
-    return o(this.elements, (t) => t.removeAttribute(e)), this;
+    return l(this.elements, (t) => t.removeAttribute(e)), this;
   }
   /** Toggle an attribute on all elements. */
   toggleAttr(e, t) {
-    return o(this.elements, (r) => {
+    return l(this.elements, (r) => {
       const s = r.hasAttribute(e);
       t ?? !s ? r.setAttribute(e, "") : r.removeAttribute(e);
     }), this;
@@ -704,7 +708,7 @@ class c {
    * @returns Text content when getting, instance when setting
    */
   text(e) {
-    return e === void 0 ? this.first()?.textContent ?? "" : (o(this.elements, (t) => {
+    return e === void 0 ? this.first()?.textContent ?? "" : (l(this.elements, (t) => {
       t.textContent = e;
     }), this);
   }
@@ -718,7 +722,7 @@ class c {
     if (e === void 0)
       return this.first()?.innerHTML ?? "";
     const t = p(e);
-    return o(this.elements, (r) => {
+    return l(this.elements, (r) => {
       r.innerHTML = t;
     }), this;
   }
@@ -730,7 +734,7 @@ class c {
    * @warning Bypasses XSS protection
    */
   htmlUnsafe(e) {
-    return o(this.elements, (t) => {
+    return l(this.elements, (t) => {
       t.innerHTML = e;
     }), this;
   }
@@ -750,20 +754,22 @@ class c {
   after(e) {
     return this.insertAll(e, "afterend"), this;
   }
-  /**
-   * Applies CSS styles to all elements.
-   *
-   * @param property - Property name or object of properties
-   * @param value - Value when setting single property
-   * @returns The instance for method chaining
-   */
   css(e, t) {
-    return typeof e == "string" ? (t !== void 0 && o(this.elements, (r) => {
-      r.style.setProperty(e, t);
-    }), this) : (o(this.elements, (r) => {
+    if (typeof e == "string") {
+      if (t !== void 0)
+        return l(this.elements, (i) => {
+          i.style.setProperty(e, t);
+        }), this;
+      const r = this.first();
+      if (!r)
+        return "";
+      const s = r.ownerDocument?.defaultView;
+      return !s || typeof s.getComputedStyle != "function" ? "" : s.getComputedStyle(r).getPropertyValue(e);
+    }
+    return l(this.elements, (r) => {
       for (const [s, i] of Object.entries(e))
         r.style.setProperty(s, i);
-    }), this);
+    }), this;
   }
   /** Wrap each element with a wrapper element or tag. */
   wrap(e) {
@@ -818,7 +824,7 @@ class c {
    * @returns The instance for method chaining
    */
   show(e = "") {
-    return o(this.elements, (t) => {
+    return l(this.elements, (t) => {
       t.removeAttribute("hidden"), t.style.display = e;
     }), this;
   }
@@ -828,7 +834,7 @@ class c {
    * @returns The instance for method chaining
    */
   hide() {
-    return o(this.elements, (e) => {
+    return l(this.elements, (e) => {
       e.style.display = "none";
     }), this;
   }
@@ -840,7 +846,7 @@ class c {
    * @returns The instance for method chaining
    */
   on(e, t) {
-    return o(this.elements, (r) => r.addEventListener(e, t)), this;
+    return l(this.elements, (r) => r.addEventListener(e, t)), this;
   }
   /**
    * Adds a one-time event listener to all elements.
@@ -850,7 +856,7 @@ class c {
    * @returns The instance for method chaining
    */
   once(e, t) {
-    return o(this.elements, (r) => r.addEventListener(e, t, { once: !0 })), this;
+    return l(this.elements, (r) => r.addEventListener(e, t, { once: !0 })), this;
   }
   /**
    * Removes an event listener from all elements.
@@ -860,7 +866,7 @@ class c {
    * @returns The instance for method chaining
    */
   off(e, t) {
-    return o(this.elements, (r) => r.removeEventListener(e, t)), this;
+    return l(this.elements, (r) => r.removeEventListener(e, t)), this;
   }
   /**
    * Triggers a custom event on all elements.
@@ -870,7 +876,7 @@ class c {
    * @returns The instance for method chaining
    */
   trigger(e, t) {
-    return o(this.elements, (r) => {
+    return l(this.elements, (r) => {
       r.dispatchEvent(new CustomEvent(e, { detail: t, bubbles: !0, cancelable: !0 }));
     }), this;
   }
@@ -896,14 +902,14 @@ class c {
    */
   delegate(e, t, r) {
     const s = `${e}:${t}`;
-    return o(this.elements, (i) => {
-      const l = (a) => {
+    return l(this.elements, (i) => {
+      const o = (a) => {
         const m = a.target.closest(t);
         m && i.contains(m) && r(a, m);
       };
       this.delegatedHandlers.has(i) || this.delegatedHandlers.set(i, /* @__PURE__ */ new Map());
       const u = this.delegatedHandlers.get(i);
-      u.has(s) || u.set(s, /* @__PURE__ */ new Map()), u.get(s).set(r, l), i.addEventListener(e, l);
+      u.has(s) || u.set(s, /* @__PURE__ */ new Map()), u.get(s).set(r, o), i.addEventListener(e, o);
     }), this;
   }
   /**
@@ -925,22 +931,43 @@ class c {
    */
   undelegate(e, t, r) {
     const s = `${e}:${t}`;
-    return o(this.elements, (i) => {
-      const l = this.delegatedHandlers.get(i);
-      if (!l) return;
-      const u = l.get(s);
+    return l(this.elements, (i) => {
+      const o = this.delegatedHandlers.get(i);
+      if (!o) return;
+      const u = o.get(s);
       if (!u) return;
       const a = u.get(r);
-      a && (i.removeEventListener(e, a), u.delete(r), u.size === 0 && l.delete(s), l.size === 0 && this.delegatedHandlers.delete(i));
+      a && (i.removeEventListener(e, a), u.delete(r), u.size === 0 && o.delete(s), o.size === 0 && this.delegatedHandlers.delete(i));
     }), this;
   }
+  /**
+   * Finds all descendant elements matching the selector across all elements
+   * in the collection. Returns a new BQueryCollection with the results.
+   *
+   * @param selector - CSS selector to match
+   * @returns A new BQueryCollection with all matching descendants
+   *
+   * @example
+   * ```ts
+   * $$('.container').find('.item').addClass('highlight');
+   * ```
+   */
+  find(e) {
+    const t = /* @__PURE__ */ new Set(), r = [];
+    for (const s of this.elements) {
+      const i = s.querySelectorAll(e);
+      for (let o = 0; o < i.length; o++)
+        t.has(i[o]) || (t.add(i[o]), r.push(i[o]));
+    }
+    return new c(r);
+  }
   /**
    * Removes all elements from the DOM.
    *
    * @returns The instance for method chaining
    */
   remove() {
-    return o(this.elements, (e) => e.remove()), this;
+    return l(this.elements, (e) => e.remove()), this;
   }
   /**
    * Clears all child nodes from all elements.
@@ -948,7 +975,7 @@ class c {
    * @returns The instance for method chaining
    */
   empty() {
-    return o(this.elements, (e) => {
+    return l(this.elements, (e) => {
       e.innerHTML = "";
     }), this;
   }
@@ -956,15 +983,15 @@ class c {
   insertAll(e, t) {
     if (typeof e == "string") {
       const s = p(e);
-      o(this.elements, (i) => {
+      l(this.elements, (i) => {
         i.insertAdjacentHTML(t, s);
       });
       return;
     }
     const r = g(e);
     this.elements.forEach((s, i) => {
-      const l = i === 0 ? r : r.map((u) => u.cloneNode(!0));
-      b(s, l, t);
+      const o = i === 0 ? r : r.map((u) => u.cloneNode(!0));
+      b(s, o, t);
     });
   }
 }
@@ -989,10 +1016,10 @@ function L(n, e) {
     t.push(n.slice(r, r + e));
   return t;
 }
-function H(n) {
+function v(n) {
   return n.filter(Boolean);
 }
-function v(n) {
+function H(n) {
   const e = [];
   for (const t of n)
     Array.isArray(t) ? e.push(...t) : e.push(t);
@@ -1000,22 +1027,38 @@ function v(n) {
 }
 function N(n, e) {
   let t;
-  return (...r) => {
-    t && clearTimeout(t), t = setTimeout(() => n(...r), e);
-  };
+  return Object.assign(
+    (...s) => {
+      t !== void 0 && clearTimeout(t), t = setTimeout(() => {
+        t = void 0, n(...s);
+      }, e);
+    },
+    {
+      cancel: () => {
+        t !== void 0 && (clearTimeout(t), t = void 0);
+      }
+    }
+  );
 }
-function $(n, e) {
+function S(n, e) {
   let t = 0;
-  return (...r) => {
-    const s = Date.now();
-    s - t >= e && (t = s, n(...r));
-  };
+  return Object.assign(
+    (...s) => {
+      const i = Date.now();
+      i - t >= e && (t = i, n(...s));
+    },
+    {
+      cancel: () => {
+        t = 0;
+      }
+    }
+  );
 }
-function M(n) {
+function $(n) {
   let e = !1, t;
   return (...r) => (e || (t = n(...r), e = !0), t);
 }
-function S() {
+function M() {
 }
 function j(n = "bQuery") {
   return `${n}_${Math.random().toString(36).slice(2, 9)}`;
@@ -1030,16 +1073,16 @@ function T(n, e) {
     return e;
   }
 }
-function k(n) {
+function P(n) {
   return n == null ? !0 : typeof n == "string" ? n.trim().length === 0 : Array.isArray(n) ? n.length === 0 : typeof n == "object" ? Object.keys(n).length === 0 : !1;
 }
-function P(n, e) {
+function k(n, e) {
   return Math.floor(Math.random() * (e - n + 1)) + n;
 }
 function z(n, e, t) {
   return Math.min(Math.max(n, e), t);
 }
-function x(n, e, t, r = !0) {
+function D(n, e, t, r = !0) {
   return r ? n >= e && n <= t : n > e && n < t;
 }
 function q(n, e = 0) {
@@ -1049,7 +1092,7 @@ function q(n, e = 0) {
 function d(n) {
   return Object.prototype.toString.call(n) === "[object Object]";
 }
-function D(n) {
+function x(n) {
   return n === "__proto__" || n === "constructor" || n === "prototype";
 }
 function R(n) {
@@ -1059,7 +1102,7 @@ function A(...n) {
   const e = {};
   for (const t of n)
     for (const [r, s] of Object.entries(t))
-      D(r) || (d(s) && d(e[r]) ? e[r] = A(
+      x(r) || (d(s) && d(e[r]) ? e[r] = A(
         e[r],
         s
       ) : e[r] = s);
@@ -1083,37 +1126,37 @@ function F(n, e) {
 function U(n) {
   return n && n.charAt(0).toUpperCase() + n.slice(1);
 }
-function _(n) {
+function J(n) {
   return n.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
 }
-function J(n) {
+function V(n) {
   return n.replace(/[-_\s]+(.)?/g, (e, t) => t ? t.toUpperCase() : "").replace(/^[A-Z]/, (e) => e.toLowerCase());
 }
-function I(n, e, t = "…") {
+function _(n, e, t = "…") {
   if (e <= 0) return "";
   if (n.length <= e) return n;
   const r = Math.max(0, e - t.length);
   return `${n.slice(0, r)}${t}`;
 }
-function Z(n) {
+function I(n) {
   return n.normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^\w\s-]/g, "").trim().replace(/[\s_-]+/g, "-").toLowerCase();
 }
-function K(n) {
+function Z(n) {
   return n.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function G(n) {
+function K(n) {
   return typeof Element < "u" && n instanceof Element;
 }
-function Q(n) {
+function G(n) {
   return !!(n && typeof n == "object" && "elements" in n);
 }
-function V(n) {
+function X(n) {
   return typeof n == "function";
 }
-function X(n) {
+function Y(n) {
   return typeof n == "string";
 }
-function Y(n) {
+function Q(n) {
   return typeof n == "number" && !Number.isNaN(n);
 }
 function ee(n) {
@@ -1138,17 +1181,17 @@ const ue = {
   omit: W,
   hasOwn: F,
   debounce: N,
-  throttle: $,
-  once: M,
-  noop: S,
+  throttle: S,
+  once: $,
+  noop: M,
   uid: j,
-  isElement: G,
-  isCollection: Q,
-  isEmpty: k,
+  isElement: K,
+  isCollection: G,
+  isEmpty: P,
   isPlainObject: d,
-  isFunction: V,
-  isString: X,
-  isNumber: Y,
+  isFunction: X,
+  isString: Y,
+  isNumber: Q,
   isBoolean: ee,
   isArray: te,
   isDate: ne,
@@ -1156,21 +1199,21 @@ const ue = {
   isObject: se,
   parseJson: T,
   sleep: O,
-  randomInt: P,
+  randomInt: k,
   clamp: z,
-  inRange: x,
+  inRange: D,
   toNumber: q,
   capitalize: U,
-  toKebabCase: _,
-  toCamelCase: J,
-  truncate: I,
-  slugify: Z,
-  escapeRegExp: K,
+  toKebabCase: J,
+  toCamelCase: V,
+  truncate: _,
+  slugify: I,
+  escapeRegExp: Z,
   ensureArray: E,
   unique: C,
   chunk: L,
-  compact: H,
-  flatten: v
+  compact: v,
+  flatten: H
 };
 export {
   oe as $,
@@ -1181,39 +1224,39 @@ export {
   L as chunk,
   z as clamp,
   R as clone,
-  H as compact,
+  v as compact,
   N as debounce,
   E as ensureArray,
-  K as escapeRegExp,
-  v as flatten,
+  Z as escapeRegExp,
+  H as flatten,
   F as hasOwn,
-  x as inRange,
+  D as inRange,
   te as isArray,
   ee as isBoolean,
-  Q as isCollection,
+  G as isCollection,
   ne as isDate,
-  G as isElement,
-  k as isEmpty,
-  V as isFunction,
-  Y as isNumber,
+  K as isElement,
+  P as isEmpty,
+  X as isFunction,
+  Q as isNumber,
   se as isObject,
   d as isPlainObject,
   re as isPromise,
-  X as isString,
+  Y as isString,
   A as merge,
-  S as noop,
+  M as noop,
   W as omit,
-  M as once,
+  $ as once,
   T as parseJson,
   B as pick,
-  P as randomInt,
+  k as randomInt,
   O as sleep,
-  Z as slugify,
-  $ as throttle,
-  J as toCamelCase,
-  _ as toKebabCase,
+  I as slugify,
+  S as throttle,
+  V as toCamelCase,
+  J as toKebabCase,
   q as toNumber,
-  I as truncate,
+  _ as truncate,
   j as uid,
   C as unique,
   ue as utils