@fluixi/dom 1.0.0-alpha.83 → 1.0.0-alpha.84

package/dist/lib/dom/types.cjs

@@ -1 +1,18 @@
-"use strict";var r=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var i=Object.prototype.hasOwnProperty;var u=(n,e,a,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of p(e))!i.call(n,o)&&o!==a&&r(n,o,{get:()=>e[o],enumerable:!(t=s(e,o))||t.enumerable});return n};var c=n=>u(r({},"__esModule",{value:!0}),n);var T={};module.exports=c(T);
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/dom/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/lib/dom/utils.cjs

@@ -1 +1,381 @@
-"use strict";var l=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var E=Object.prototype.hasOwnProperty;var b=(e,t)=>{for(var n in t)l(e,n,{get:t[n],enumerable:!0})},x=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of g(t))!E.call(e,o)&&o!==n&&l(e,o,{get:()=>t[o],enumerable:!(r=m(t,o))||r.enumerable});return e};var h=e=>x(l({},"__esModule",{value:!0}),e);var te={};b(te,{JSX_PROPERTIES:()=>N,SVG_ELEMENTS:()=>A,SVG_NAMESPACE:()=>L,VOID_ELEMENTS:()=>S,addClass:()=>I,appendChildren:()=>q,applyElementProp:()=>C,closest:()=>O,createElement:()=>W,delegate:()=>B,getAttribute:()=>V,getGlobal:()=>ee,getLitEventName:()=>T,getOffset:()=>z,getStyle:()=>G,hasClass:()=>H,isCustomElement:()=>f,isDOMNode:()=>U,isEventHandler:()=>w,isJSXTemplate:()=>Q,isLitTemplateResult:()=>p,isReactElement:()=>Z,isTemplateFactory:()=>_,isVisible:()=>D,observeIntersection:()=>X,observeResize:()=>K,query:()=>a,queryAll:()=>M,registerGlobal:()=>k,removeAttribute:()=>j,removeChildren:()=>$,removeClass:()=>P,scrollIntoView:()=>F,setAttribute:()=>c,setStyles:()=>d,shouldSetAsProperty:()=>v,toAttributeName:()=>y,toggleClass:()=>R,waitForElement:()=>J});module.exports=h(te);function y(e){return e.startsWith("aria-")||e.startsWith("data-")?e:/[A-Z]/.test(e)?e.replace(/([A-Z])/g,"-$1").toLowerCase():e}function w(e){return e.startsWith("@")||e.startsWith("on")&&e.length>2}function T(e){return e.startsWith("@")?e.slice(1):e.startsWith("on")?e.slice(2).toLowerCase():e}function v(e,t){let n=new Set(["checked","value","selected","disabled","readonly","required","multiple","open","contenteditable","draggable","spellcheck"]),r={input:new Set(["value","checked","indeterminate"]),textarea:new Set(["value"]),select:new Set(["value"]),option:new Set(["selected","value"]),audio:new Set(["volume","currentTime","paused"]),video:new Set(["volume","currentTime","paused"]),img:new Set(["src","srcset"]),iframe:new Set(["src"]),a:new Set(["href"])};return n.has(t)||r[e]&&r[e].has(t)}var S=new Set(["area","base","br","col","embed","hr","img","input","link","meta","param","source","track","wbr"]),A=new Set(["svg","g","path","circle","rect","line","polyline","polygon","ellipse","text","tspan","use","defs","symbol","mask","clipPath","pattern","linearGradient","radialGradient","stop","filter","feGaussianBlur","feOffset","feMerge","feMergeNode","foreignObject"]),L="http://www.w3.org/2000/svg";function f(e){return e.localName.includes("-")}function C(e,t,n,r=!1){if(n==null){e.removeAttribute(t);return}if(f(e)){e[t]=n;return}c(e,t,n,r)}var N=new Set(["className","value","checked","selected","innerHTML","innerText","textContent","indeterminate","htmlFor"]);function a(e,t=document){return t.querySelector(e)}function M(e,t=document){return Array.from(t.querySelectorAll(e))}function O(e,t){return e.closest(t)}function I(e,...t){e.classList.add(...t)}function P(e,...t){e.classList.remove(...t)}function R(e,...t){t.forEach(n=>e.classList.toggle(n))}function H(e,t){return e.classList.contains(t)}function c(e,t,n,r=!1){if(n==null||n===!1){e.removeAttribute(t);return}if(n===!0){e.setAttribute(t,"");return}if(typeof n=="object"){e.setAttribute(t,JSON.stringify(n));return}e.setAttribute(t,String(n))}function V(e,t){return e.getAttribute(t)}function j(e,t){e.removeAttribute(t)}function d(e,t){Object.assign(e.style,t)}function G(e,t){return window.getComputedStyle(e).getPropertyValue(t)}function W(e,t={},...n){let r=document.createElement(e);return Object.entries(t).forEach(([o,i])=>{if(o==="class"||o==="className")r.className=i;else if(o==="style"&&typeof i=="object")d(r,i);else if(o.startsWith("on")&&typeof i=="function"){let s=o.slice(2).toLowerCase();r.addEventListener(s,i)}else c(r,o,i)}),n.forEach(o=>{typeof o=="string"?r.appendChild(document.createTextNode(o)):r.appendChild(o)}),r}function $(e){for(;e.firstChild;)e.removeChild(e.firstChild)}function q(e,...t){t.forEach(n=>{typeof n=="string"?e.appendChild(document.createTextNode(n)):e.appendChild(n)})}function D(e){let t=e.getBoundingClientRect();return t.top>=0&&t.left>=0&&t.bottom<=window.innerHeight&&t.right<=window.innerWidth}function F(e,t={behavior:"smooth",block:"nearest"}){e.scrollIntoView(t)}function z(e){let t=e.getBoundingClientRect();return{top:t.top+window.pageYOffset,left:t.left+window.pageXOffset}}function B(e,t,n,r){let o=i=>{let s=i.target.closest(n);s&&e.contains(s)&&r(i,s)};return e.addEventListener(t,o),()=>{e.removeEventListener(t,o)}}function J(e,t=5e3){return new Promise((n,r)=>{let o=a(e);if(o){n(o);return}let i=new MutationObserver(()=>{let u=a(e);u&&(i.disconnect(),clearTimeout(s),n(u))});i.observe(document.body,{childList:!0,subtree:!0});let s=setTimeout(()=>{i.disconnect(),r(new Error(`Element ${e} not found within ${t}ms`))},t)})}function X(e,t,n={}){let r=new IntersectionObserver(o=>{o.forEach(i=>{t(i.isIntersecting)})},n);return r.observe(e),()=>{r.disconnect()}}function K(e,t){let n=new ResizeObserver(r=>{r.forEach(t)});return n.observe(e),()=>{n.disconnect()}}var Y=typeof Symbol=="function"&&Symbol.for?Symbol.for("react.element"):60103;function Z(e){return typeof e=="object"&&e!==null&&e.$$typeof===Y}function p(e){return e&&typeof e=="object"&&e.strings&&Array.isArray(e.strings)&&e.values&&Array.isArray(e.values)}function _(e){if(typeof e!="function")return!1;try{let t=e();return p(t)}catch{return!1}}function Q(e){return typeof e=="object"&&e!==null&&(e.$$typeof==="template"||typeof e.type=="function")}function U(e){return e instanceof Node}function k(e,t,n="Fluixi"){typeof globalThis<"u"&&(typeof globalThis[n]>"u"&&(globalThis[n]={}),typeof globalThis[n][e]>"u"&&(globalThis[n][e]=t))}function ee(e,t,n="Fluixi"){return typeof globalThis<"u"&&typeof globalThis[n]<"u"&&typeof globalThis[n][e]<"u"?globalThis[n][e]:t}
+/*! @fluixi/dom v1.0.0-alpha.84 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/dom/utils.ts
+var utils_exports = {};
+__export(utils_exports, {
+  JSX_PROPERTIES: () => JSX_PROPERTIES,
+  SVG_ELEMENTS: () => SVG_ELEMENTS,
+  SVG_NAMESPACE: () => SVG_NAMESPACE,
+  VOID_ELEMENTS: () => VOID_ELEMENTS,
+  addClass: () => addClass,
+  appendChildren: () => appendChildren,
+  applyElementProp: () => applyElementProp,
+  closest: () => closest,
+  createElement: () => createElement,
+  delegate: () => delegate,
+  getAttribute: () => getAttribute,
+  getGlobal: () => getGlobal,
+  getLitEventName: () => getLitEventName,
+  getOffset: () => getOffset,
+  getStyle: () => getStyle,
+  hasClass: () => hasClass,
+  isCustomElement: () => isCustomElement,
+  isDOMNode: () => isDOMNode,
+  isEventHandler: () => isEventHandler,
+  isJSXTemplate: () => isJSXTemplate,
+  isLitTemplateResult: () => isLitTemplateResult,
+  isReactElement: () => isReactElement,
+  isTemplateFactory: () => isTemplateFactory,
+  isVisible: () => isVisible,
+  observeIntersection: () => observeIntersection,
+  observeResize: () => observeResize,
+  query: () => query,
+  queryAll: () => queryAll,
+  registerGlobal: () => registerGlobal,
+  removeAttribute: () => removeAttribute,
+  removeChildren: () => removeChildren,
+  removeClass: () => removeClass,
+  scrollIntoView: () => scrollIntoView,
+  setAttribute: () => setAttribute,
+  setStyles: () => setStyles,
+  shouldSetAsProperty: () => shouldSetAsProperty,
+  toAttributeName: () => toAttributeName,
+  toggleClass: () => toggleClass,
+  waitForElement: () => waitForElement
+});
+module.exports = __toCommonJS(utils_exports);
+function toAttributeName(key) {
+  if (key.startsWith("aria-") || key.startsWith("data-")) {
+    return key;
+  }
+  if (/[A-Z]/.test(key)) {
+    return key.replace(/([A-Z])/g, "-$1").toLowerCase();
+  }
+  return key;
+}
+function isEventHandler(key) {
+  return key.startsWith("@") || key.startsWith("on") && key.length > 2;
+}
+function getLitEventName(key) {
+  if (key.startsWith("@")) {
+    return key.slice(1);
+  }
+  if (key.startsWith("on")) {
+    const eventName = key.slice(2);
+    return eventName.toLowerCase();
+  }
+  return key;
+}
+function shouldSetAsProperty(element, key) {
+  const propertyAttributes = /* @__PURE__ */ new Set([
+    "checked",
+    "value",
+    "selected",
+    "disabled",
+    "readonly",
+    "required",
+    "multiple",
+    "open",
+    "contenteditable",
+    "draggable",
+    "spellcheck"
+  ]);
+  const elementSpecificProps = {
+    input: /* @__PURE__ */ new Set(["value", "checked", "indeterminate"]),
+    textarea: /* @__PURE__ */ new Set(["value"]),
+    select: /* @__PURE__ */ new Set(["value"]),
+    option: /* @__PURE__ */ new Set(["selected", "value"]),
+    audio: /* @__PURE__ */ new Set(["volume", "currentTime", "paused"]),
+    video: /* @__PURE__ */ new Set(["volume", "currentTime", "paused"]),
+    img: /* @__PURE__ */ new Set(["src", "srcset"]),
+    iframe: /* @__PURE__ */ new Set(["src"]),
+    a: /* @__PURE__ */ new Set(["href"])
+  };
+  return propertyAttributes.has(key) || elementSpecificProps[element] && elementSpecificProps[element].has(key);
+}
+var VOID_ELEMENTS = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr"
+]);
+var SVG_ELEMENTS = /* @__PURE__ */ new Set([
+  "svg",
+  "g",
+  "path",
+  "circle",
+  "rect",
+  "line",
+  "polyline",
+  "polygon",
+  "ellipse",
+  "text",
+  "tspan",
+  "use",
+  "defs",
+  "symbol",
+  "mask",
+  "clipPath",
+  "pattern",
+  "linearGradient",
+  "radialGradient",
+  "stop",
+  "filter",
+  "feGaussianBlur",
+  "feOffset",
+  "feMerge",
+  "feMergeNode",
+  "foreignObject"
+]);
+var SVG_NAMESPACE = "http://www.w3.org/2000/svg";
+function isCustomElement(element) {
+  return element.localName.includes("-");
+}
+function applyElementProp(element, name, value, isSVG = false) {
+  if (value == null) {
+    element.removeAttribute(name);
+    return;
+  }
+  if (isCustomElement(element)) {
+    element[name] = value;
+    return;
+  }
+  setAttribute(element, name, value, isSVG);
+}
+var JSX_PROPERTIES = /* @__PURE__ */ new Set([
+  "className",
+  "value",
+  "checked",
+  "selected",
+  "innerHTML",
+  "innerText",
+  "textContent",
+  "indeterminate",
+  "htmlFor"
+]);
+function query(selector, root = document) {
+  return root.querySelector(selector);
+}
+function queryAll(selector, root = document) {
+  return Array.from(root.querySelectorAll(selector));
+}
+function closest(element, selector) {
+  return element.closest(selector);
+}
+function addClass(element, ...classes) {
+  element.classList.add(...classes);
+}
+function removeClass(element, ...classes) {
+  element.classList.remove(...classes);
+}
+function toggleClass(element, ...classes) {
+  classes.forEach((cls) => element.classList.toggle(cls));
+}
+function hasClass(element, className) {
+  return element.classList.contains(className);
+}
+function setAttribute(element, name, value, isSVG = false) {
+  if (value == null || value === false) {
+    element.removeAttribute(name);
+    return;
+  }
+  if (value === true) {
+    element.setAttribute(name, "");
+    return;
+  }
+  if (typeof value === "object") {
+    element.setAttribute(name, JSON.stringify(value));
+    return;
+  }
+  element.setAttribute(name, String(value));
+}
+function getAttribute(element, name) {
+  return element.getAttribute(name);
+}
+function removeAttribute(element, name) {
+  element.removeAttribute(name);
+}
+function setStyles(element, styles) {
+  Object.assign(element.style, styles);
+}
+function getStyle(element, property) {
+  return window.getComputedStyle(element).getPropertyValue(property);
+}
+function createElement(tagName, attributes = {}, ...children) {
+  const element = document.createElement(tagName);
+  Object.entries(attributes).forEach(([key, value]) => {
+    if (key === "class" || key === "className") {
+      element.className = value;
+    } else if (key === "style" && typeof value === "object") {
+      setStyles(element, value);
+    } else if (key.startsWith("on") && typeof value === "function") {
+      const event = key.slice(2).toLowerCase();
+      element.addEventListener(event, value);
+    } else {
+      setAttribute(element, key, value);
+    }
+  });
+  children.forEach((child) => {
+    if (typeof child === "string") {
+      element.appendChild(document.createTextNode(child));
+    } else {
+      element.appendChild(child);
+    }
+  });
+  return element;
+}
+function removeChildren(element) {
+  while (element.firstChild) {
+    element.removeChild(element.firstChild);
+  }
+}
+function appendChildren(parent, ...children) {
+  children.forEach((child) => {
+    if (typeof child === "string") {
+      parent.appendChild(document.createTextNode(child));
+    } else {
+      parent.appendChild(child);
+    }
+  });
+}
+function isVisible(element) {
+  const rect = element.getBoundingClientRect();
+  return rect.top >= 0 && rect.left >= 0 && rect.bottom <= window.innerHeight && rect.right <= window.innerWidth;
+}
+function scrollIntoView(element, options = { behavior: "smooth", block: "nearest" }) {
+  element.scrollIntoView(options);
+}
+function getOffset(element) {
+  const rect = element.getBoundingClientRect();
+  return {
+    top: rect.top + window.pageYOffset,
+    left: rect.left + window.pageXOffset
+  };
+}
+function delegate(parent, eventName, selector, handler) {
+  const listener = (event) => {
+    const target = event.target.closest(selector);
+    if (target && parent.contains(target)) {
+      handler(event, target);
+    }
+  };
+  parent.addEventListener(eventName, listener);
+  return () => {
+    parent.removeEventListener(eventName, listener);
+  };
+}
+function waitForElement(selector, timeout = 5e3) {
+  return new Promise((resolve, reject) => {
+    const element = query(selector);
+    if (element) {
+      resolve(element);
+      return;
+    }
+    const observer = new MutationObserver(() => {
+      const element2 = query(selector);
+      if (element2) {
+        observer.disconnect();
+        clearTimeout(timeoutId);
+        resolve(element2);
+      }
+    });
+    observer.observe(document.body, {
+      childList: true,
+      subtree: true
+    });
+    const timeoutId = setTimeout(() => {
+      observer.disconnect();
+      reject(new Error(`Element ${selector} not found within ${timeout}ms`));
+    }, timeout);
+  });
+}
+function observeIntersection(element, callback, options = {}) {
+  const observer = new IntersectionObserver((entries) => {
+    entries.forEach((entry) => {
+      callback(entry.isIntersecting);
+    });
+  }, options);
+  observer.observe(element);
+  return () => {
+    observer.disconnect();
+  };
+}
+function observeResize(element, callback) {
+  const observer = new ResizeObserver((entries) => {
+    entries.forEach(callback);
+  });
+  observer.observe(element);
+  return () => {
+    observer.disconnect();
+  };
+}
+var REACT_ELEMENT_TYPE = typeof Symbol === "function" && Symbol.for ? /* @__PURE__ */ Symbol.for("react.element") : 60103;
+function isReactElement(value) {
+  return typeof value === "object" && value !== null && value.$$typeof === REACT_ELEMENT_TYPE;
+}
+function isLitTemplateResult(value) {
+  return value && typeof value === "object" && value.strings && Array.isArray(value.strings) && value.values && Array.isArray(value.values);
+}
+function isTemplateFactory(value) {
+  if (typeof value !== "function") return false;
+  try {
+    const result = value();
+    return isLitTemplateResult(result);
+  } catch {
+    return false;
+  }
+}
+function isJSXTemplate(value) {
+  return typeof value === "object" && value !== null && (value.$$typeof === "template" || typeof value.type === "function");
+}
+function isDOMNode(value) {
+  return value instanceof Node;
+}
+function registerGlobal(key, value, _Key = "Fluixi") {
+  if (typeof globalThis !== "undefined") {
+    if (typeof globalThis[_Key] === "undefined") {
+      globalThis[_Key] = {};
+    }
+    if (typeof globalThis[_Key][key] === "undefined") {
+      globalThis[_Key][key] = value;
+    }
+  }
+}
+function getGlobal(key, value, _Key = "Fluixi") {
+  if (typeof globalThis !== "undefined") {
+    if (typeof globalThis[_Key] !== "undefined") {
+      if (typeof globalThis[_Key][key] !== "undefined") {
+        return globalThis[_Key][key];
+      }
+    }
+  }
+  return value;
+}

package/dist/lib/dom/utils.d.ts

@@ -1,5 +1,4 @@
 /**
- * @fileoverview DOM utilities for Fluixi
  * @module @fluixi/core/dom
  *
  * This module provides utilities for DOM manipulation and queries.
@@ -31,7 +30,7 @@ export declare const SVG_ELEMENTS: Set<string>;
 export declare const SVG_NAMESPACE = "http://www.w3.org/2000/svg";
 /**
  * Returns true for custom elements (tag name contains a hyphen per the Web
- * Components spec — e.g. `adf-accounts-selector`).
+ * Components spec: e.g. `adf-accounts-selector`).
  */
 export declare function isCustomElement(element: Element): boolean;
 /**
@@ -48,11 +47,6 @@ export declare const JSX_PROPERTIES: Set<string>;
 /**
  * Queries a single element with type safety
  *
- * @template T - Element type
- * @param {string} selector - CSS selector
- * @param {Element | Document} root - Root element (default: document)
- * @returns {T | null} Found element or null
- *
  * @example
  * ```typescript
  * import { query } from '@fluixi/core/dom';
@@ -65,11 +59,6 @@ export declare function query<T extends Element = Element>(selector: string, roo
 /**
  * Queries all matching elements with type safety
  *
- * @template T - Element type
- * @param {string} selector - CSS selector
- * @param {Element | Document} root - Root element (default: document)
- * @returns {T[]} Array of matching elements
- *
  * @example
  * ```typescript
  * import { queryAll } from '@fluixi/core/dom';
@@ -82,11 +71,6 @@ export declare function queryAll<T extends Element = Element>(selector: string,
 /**
  * Queries the closest matching ancestor element
  *
- * @template T - Element type
- * @param {Element} element - Starting element
- * @param {string} selector - CSS selector
- * @returns {T | null} Closest matching ancestor or null
- *
  * @example
  * ```typescript
  * import { closest } from '@fluixi/core/dom';
@@ -99,9 +83,6 @@ export declare function closest<T extends Element = Element>(element: Element, s
 /**
  * Adds one or more classes to an element
  *
- * @param {Element} element - Target element
- * @param {...string} classes - Classes to add
- *
  * @example
  * ```typescript
  * import { addClass } from '@fluixi/core/dom';
@@ -113,9 +94,6 @@ export declare function addClass(element: Element, ...classes: string[]): void;
 /**
  * Removes one or more classes from an element
  *
- * @param {Element} element - Target element
- * @param {...string} classes - Classes to remove
- *
  * @example
  * ```typescript
  * import { removeClass } from '@fluixi/core/dom';
@@ -127,9 +105,6 @@ export declare function removeClass(element: Element, ...classes: string[]): voi
 /**
  * Toggles one or more classes on an element
  *
- * @param {Element} element - Target element
- * @param {...string} classes - Classes to toggle
- *
  * @example
  * ```typescript
  * import { toggleClass } from '@fluixi/core/dom';
@@ -141,10 +116,6 @@ export declare function toggleClass(element: Element, ...classes: string[]): voi
 /**
  * Checks if element has a class
  *
- * @param {Element} element - Target element
- * @param {string} className - Class name to check
- * @returns {boolean} True if element has the class
- *
  * @example
  * ```typescript
  * import { hasClass } from '@fluixi/core/dom';
@@ -158,10 +129,6 @@ export declare function hasClass(element: Element, className: string): boolean;
 /**
  * Sets an attribute on an element
  *
- * @param {Element} element - Target element
- * @param {string} name - Attribute name
- * @param {string | number | boolean} value - Attribute value
- *
  * @example
  * ```typescript
  * import { setAttribute } from '@fluixi/core/dom';
@@ -174,10 +141,6 @@ export declare function setAttribute(element: Element, name: string, value: unkn
 /**
  * Gets an attribute from an element
  *
- * @param {Element} element - Target element
- * @param {string} name - Attribute name
- * @returns {string | null} Attribute value or null
- *
  * @example
  * ```typescript
  * import { getAttribute } from '@fluixi/core/dom';
@@ -189,9 +152,6 @@ export declare function getAttribute(element: Element, name: string): string | n
 /**
  * Removes an attribute from an element
  *
- * @param {Element} element - Target element
- * @param {string} name - Attribute name
- *
  * @example
  * ```typescript
  * import { removeAttribute } from '@fluixi/core/dom';
@@ -203,9 +163,6 @@ export declare function removeAttribute(element: Element, name: string): void;
 /**
  * Sets multiple styles on an element
  *
- * @param {HTMLElement} element - Target element
- * @param {Partial<CSSStyleDeclaration>} styles - Styles object
- *
  * @example
  * ```typescript
  * import { setStyles } from '@fluixi/core/dom';
@@ -221,10 +178,6 @@ export declare function setStyles(element: any, styles: Partial<CSSStyleDeclarat
 /**
  * Gets computed style of an element
  *
- * @param {Element} element - Target element
- * @param {string} property - CSS property name
- * @returns {string} Computed style value
- *
  * @example
  * ```typescript
  * import { getStyle } from '@fluixi/core/dom';
@@ -236,12 +189,6 @@ export declare function getStyle(element: Element, property: string): string;
 /**
  * Creates an element with attributes and children
  *
- * @template K - Element tag name
- * @param {K} tagName - HTML tag name
- * @param {Record<string, any>} attributes - Element attributes
- * @param {...(Node | string)} children - Child nodes or text
- * @returns {HTMLElementTagNameMap[K]} Created element
- *
  * @example
  * ```typescript
  * import { createElement } from '@fluixi/core/dom';
@@ -256,8 +203,6 @@ export declare function createElement<K extends keyof HTMLElementTagNameMap>(tag
 /**
  * Removes all children from an element
  *
- * @param {Element} element - Target element
- *
  * @example
  * ```typescript
  * import { removeChildren } from '@fluixi/core/dom';
@@ -269,9 +214,6 @@ export declare function removeChildren(element: Element): void;
 /**
  * Appends multiple children to an element
  *
- * @param {Element} parent - Parent element
- * @param {...(Node | string)} children - Children to append
- *
  * @example
  * ```typescript
  * import { appendChildren } from '@fluixi/core/dom';
@@ -287,9 +229,6 @@ export declare function appendChildren(parent: Element, ...children: (Node | str
 /**
  * Checks if element is visible in the viewport
  *
- * @param {Element} element - Target element
- * @returns {boolean} True if element is visible
- *
  * @example
  * ```typescript
  * import { isVisible } from '@fluixi/core/dom';
@@ -303,9 +242,6 @@ export declare function isVisible(element: Element): boolean;
 /**
  * Scrolls element into view smoothly
  *
- * @param {Element} element - Target element
- * @param {ScrollIntoViewOptions} options - Scroll options
- *
  * @example
  * ```typescript
  * import { scrollIntoView } from '@fluixi/core/dom';
@@ -317,9 +253,6 @@ export declare function scrollIntoView(element: Element, options?: ScrollIntoVie
 /**
  * Gets element's offset relative to document
  *
- * @param {Element} element - Target element
- * @returns {{ top: number; left: number }} Offset coordinates
- *
  * @example
  * ```typescript
  * import { getOffset } from '@fluixi/core/dom';
@@ -334,13 +267,6 @@ export declare function getOffset(element: Element): {
 /**
  * Delegates event handling to a parent element
  *
- * @template K - Event type
- * @param {Element} parent - Parent element
- * @param {K} eventName - Event name
- * @param {string} selector - Child selector
- * @param {(event: Event, target: Element) => void} handler - Event handler
- * @returns {() => void} Cleanup function
- *
  * @example
  * ```typescript
  * import { delegate } from '@fluixi/core/dom';
@@ -354,10 +280,6 @@ export declare function delegate<K extends keyof HTMLElementEventMap>(parent: El
 /**
  * Waits for an element to appear in the DOM
  *
- * @param {string} selector - CSS selector
- * @param {number} timeout - Timeout in milliseconds (default: 5000)
- * @returns {Promise<Element>} Promise that resolves with the element
- *
  * @example
  * ```typescript
  * import { waitForElement } from '@fluixi/core/dom';
@@ -369,11 +291,6 @@ export declare function waitForElement(selector: string, timeout?: number): Prom
 /**
  * Observes element intersection with viewport
  *
- * @param {Element} element - Target element
- * @param {(isIntersecting: boolean) => void} callback - Callback function
- * @param {IntersectionObserverInit} options - Observer options
- * @returns {() => void} Cleanup function
- *
  * @example
  * ```typescript
  * import { observeIntersection } from '@fluixi/core/dom';
@@ -387,10 +304,6 @@ export declare function observeIntersection(element: Element, callback: (isInter
 /**
  * Observes element size changes
  *
- * @param {Element} element - Target element
- * @param {(entry: ResizeObserverEntry) => void} callback - Callback function
- * @returns {() => void} Cleanup function
- *
  * @example
  * ```typescript
  * import { observeResize } from '@fluixi/core/dom';

package/dist/lib/dom/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/dom/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/dom/utils.ts"],"names":[],"mappings":"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"}