feat: added new methods: children, clear, childNodes, insertAfter, isInput, isVisible, nextUntil, parents, prepend, remove, siblings, text, triggerEvent(#167)

*

* fix: changed children helper to use a shorter approach

* feat: added new method: attribute, renamed children to childElements

* fix: attribute value can be boolean or null

Author: marcospont

.eslintrc

@@ -3,6 +3,7 @@
   "rules": {
     "no-nested-ternary": "off",
     "consistent-return": "off",
+    "import/extensions": "off",
     "import/no-mutable-exports": "off",
     "@typescript-eslint/member-delimiter-style": "off"
   }

.size-snapshot.json

@@ -1,15 +1,15 @@
 {
   "lib/dist/dom-helpers.js": {
-    "bundled": 15481,
-    "minified": 8329,
-    "gzipped": 3124,
+    "bundled": 24575,
+    "minified": 12882,
+    "gzipped": 4632,
     "treeshaked": {
       "rollup": {
-        "code": 653,
+        "code": 716,
         "import_statements": 0
       },
       "webpack": {
-        "code": 1940
+        "code": 2003
       }
     }
   }

src/activeElement.ts

@@ -1,9 +1,9 @@
 import ownerDocument from './ownerDocument'
 
 /**
- * Return the actively focused element safely.
+ * Returns the actively focused element safely.
  *
- * @param doc the document to checl
+ * @param doc the document to check
  */
 export default function activeElement(doc = ownerDocument()) {
   // Support: IE 9 only

src/addClass.ts

@@ -1,5 +1,11 @@
 import hasClass from './hasClass'
 
+/**
+ * Adds a CSS class to a given element.
+ * 
+ * @param element the element
+ * @param className the CSS class name
+ */
 export default function addClass(
   element: Element | SVGElement,
   className: string

src/addEventListener.ts

@@ -30,8 +30,14 @@ export type EventHandler<K extends keyof HTMLElementEventMap> = (
 export type TaggedEventHandler<
   K extends keyof HTMLElementEventMap
 > = EventHandler<K> & { __once?: EventHandler<K> }
+
 /**
  * An `addEventListener` ponyfill, supports the `once` option
+ * 
+ * @param node the element
+ * @param eventName the event name
+ * @param handle the handler
+ * @param options event options
  */
 function addEventListener<K extends keyof HTMLElementEventMap>(
   node: HTMLElement,

src/attribute.ts

@@ -0,0 +1,24 @@
+/**
+ * Gets or sets an attribute of a given element.
+ * 
+ * @param node the element
+ * @param attr the attribute to get or set
+ * @param val the attribute value
+ */
+export default function attribute(
+  node: Element | null,
+  attr: string,
+  val?: string | boolean | null
+): string | null | undefined {
+  if (node) {
+    if (typeof val === 'undefined') {
+      return node.getAttribute(attr);
+    }
+    if (!val && val !== '') {
+      node.removeAttribute(attr);
+    } else {
+      node.setAttribute(attr, String(val));
+    }
+  }
+}
+

src/childElements.ts

@@ -0,0 +1,10 @@
+/**
+ * Collects all child elements of an element.
+ * 
+ * @param node the element
+ */
+export default function childElements(
+  node: Element | null
+): Element[] {
+  return node ? Array.from(node.children) : [];
+}

src/childNodes.ts

@@ -0,0 +1,12 @@
+const toArray = Function.prototype.bind.call(Function.prototype.call, [].slice)
+
+/**
+ * Collects all child nodes of an element.
+ * 
+ * @param node the node
+ */
+export default function childNodes(
+  node: Element | null
+): Node[] {
+  return node ? toArray(node.childNodes) : [];
+}

src/clear.ts

@@ -0,0 +1,16 @@
+/**
+ * Removes all child nodes from a given node.
+ * 
+ * @param node the node to clear
+ */
+export default function clear(
+  node: Node | null
+): Node | null {
+  if (node) {
+    while (node.firstChild) {
+      node.removeChild(node.firstChild);
+    }
+    return node;
+  }
+  return null;
+}

src/closest.ts

@@ -1,5 +1,12 @@
 import matches from './matches'
 
+/**
+ * Returns the closest parent element that matches a given selector.
+ * 
+ * @param node the reference element
+ * @param selector the selector to match
+ * @param stopAt stop traversing when this element is found
+ */
 export default function closest(
   node: Element,
   selector: string,