@webalternatif/js-core 1.1.1 → 1.1.2

package/dist/esm/utils.js

@@ -1,17 +1,11 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.throttle = exports.strParseFloat = exports.sizeOf = exports.noop = exports.flatten = exports.equals = exports.debounce = void 0;
-var _traversal = require("./traversal.js");
-var _is = require("./is.js");
-const equals = function (o1, o2, seen = new WeakMap()) {
+import { each, map } from "./traversal.js";
+import { isArray, isFunction, isObject, isUndefined } from "./is.js";
+export const equals = function (o1, o2, seen = new WeakMap()) {
   if (o1 === o2) return true;
   if (typeof o1 !== typeof o2 || o1 == null || o2 == null) {
     return false;
   }
-  if ((0, _is.isObject)(o1)) {
+  if (isObject(o1)) {
     if (seen.has(o1)) {
       return seen.get(o1) === o2;
     }
@@ -25,11 +19,9 @@ const equals = function (o1, o2, seen = new WeakMap()) {
   }
   return false;
 };
-exports.equals = equals;
-const noop = function () {};
-exports.noop = noop;
-const sizeOf = function (o) {
-  return (0, _traversal.map)(o, noop).length;
+export const noop = function () {};
+export const sizeOf = function (o) {
+  return map(o, noop).length;
 };
 
 /**
@@ -48,20 +40,17 @@ const sizeOf = function (o) {
  * console.log(result);
  * // Output: [1, 2, 3, 4]
  */
-exports.sizeOf = sizeOf;
-const flatten = function (o) {
-  if ((0, _is.isObject)(o) || (0, _is.isArray)(o)) {
-    return [].concat.apply([], (0, _traversal.map)(o, (i, val) => flatten(val)));
+export const flatten = function (o) {
+  if (isObject(o) || isArray(o)) {
+    return [].concat.apply([], map(o, (i, val) => flatten(val)));
   }
   return o;
 };
-exports.flatten = flatten;
-const strParseFloat = function (val) {
+export const strParseFloat = function (val) {
   if (!val) return 0;
   return parseFloat((val + '').replace(/\s/g, '').replace(',', '.'));
 };
-exports.strParseFloat = strParseFloat;
-const throttle = function (func, wait, leading = true, trailing = true, context = null) {
+export const throttle = function (func, wait, leading = true, trailing = true, context = null) {
   let timeout = null;
   let lastCall = 0;
   return function (...args) {
@@ -93,8 +82,7 @@ const throttle = function (func, wait, leading = true, trailing = true, context
  * @param {Object} [context=null] - The context to bind to `func`.
  * @returns {Function} The debounced function.
  */
-exports.throttle = throttle;
-const debounce = function (func, wait, immediate = false, context = null) {
+export const debounce = function (func, wait, immediate = false, context = null) {
   let timeout = null;
   let lastCall = 0;
   return function (...args) {
@@ -114,5 +102,4 @@ const debounce = function (func, wait, immediate = false, context = null) {
       func.apply(context || this, args);
     }, wait);
   };
-};
-exports.debounce = debounce;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webalternatif/js-core",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "type": "module",
   "types": "types/index.d.ts",
   "main": "dist/cjs/index.js",

package/types/dom.d.ts

@@ -15,29 +15,29 @@ declare namespace _default {
      */
     function child(el: Element, selector?: string): Element | null;
     /**
-     * @param {Element|Document|string} refEl
-     * @param {string} [selector='*']
-     * @returns {NodeList}
+     * @param {Element|Document} refEl
+     * @param {string|Element|NodeList|Array<Element>} [selector]
+     * @returns {Element|null}
      */
-    function find(refEl: Element | Document | string, selector?: string): NodeList;
+    function findOne(refEl: Element | Document, selector?: string | Element | NodeList | Array<Element>): Element | null;
     /**
-     * @param {Element|Document|string} refEl
-     * @param {string} [selector='*']
-     * @returns {Element|null}
+     * @param {Element|Document} refEl
+     * @param {string|Element|NodeList|Array<Element>} selector
+     * @returns {Array<Element>}
      */
-    function findOne(refEl: Element | Document | string, selector?: string): Element | null;
+    function find(refEl: Element | Document, selector: string | Element | NodeList | Array<Element>): Array<Element>;
     /**
-     * @param {Element} el
+     * @param {Element|NodeList|Array<Element>} el
      * @param {string} className
-     * @returns {Element}
+     * @returns {Element|NodeList|Array<Element>}
      */
-    function addClass(el: Element, className: string): Element;
+    function addClass(el: Element | NodeList | Array<Element>, className: string): Element | NodeList | Array<Element>;
     /**
-     * @param {Element} el
-     * @param {string} classNames
-     * @returns {Element}
+     * @param {Element|NodeList|Array<Element>} el
+     * @param {string} className
+     * @returns {Element|NodeList|Array<Element>}
      */
-    function removeClass(el: Element, classNames: string): Element;
+    function removeClass(el: Element | NodeList | Array<Element>, className: string): Element | NodeList | Array<Element>;
     /**
      * @param {Element} el
      * @param {string} classNames
@@ -52,28 +52,28 @@ declare namespace _default {
      */
     function hasClass(el: Element, classNames: string): boolean;
     /**
-     * @param {Element} el
-     * @param {Element} child
-     * @returns {Element}
+     * @param {Node} node
+     * @param {...Node} children
+     * @returns {Node}
      */
-    function append(el: Element, child: Element): Element;
+    function append(node: Node, ...children: Node[]): Node;
     /**
-     * @param {Element} el
-     * @param {Element} child
-     * @returns {Element}
+     * @param {Node} node
+     * @param {...Node} children
+     * @returns {Node}
      */
-    function prepend(el: Element, child: Element): Element;
+    function prepend(node: Node, ...children: Node[]): Node;
     /**
-     * @param {Element} el
+     * @param {Element|NodeList|Array<Element>|string} els
      * @returns {void}
      */
-    function remove(el: Element): void;
+    function remove(...els: Element | NodeList | Array<Element> | string): void;
     /**
      * @param {Element} el
-     * @param {string} [selector]
+     * @param {string|Element} selector
      * @returns {Element|null}
      */
-    function closest(el: Element, selector?: string): Element | null;
+    function closest(el: Element, selector: string | Element): Element | null;
     /**
      * @param {Element} el
      * @param {string} [selector]
@@ -98,6 +98,18 @@ declare namespace _default {
      * @returns {Element[]}
      */
     function prevAll(el: Element, selector?: string): Element[];
+    /**
+     * @param {Element} el
+     * @param {Element|string} selector
+     * @returns {Element[]}
+     */
+    function nextUntil(el: Element, selector: Element | string): Element[];
+    /**
+     * @param {Element} el
+     * @param {Element|string} selector
+     * @returns {Element[]}
+     */
+    function prevUntil(el: Element, selector: Element | string): Element[];
     /**
      * @param {Element} el
      * @param {Element} wrappingElement
@@ -149,11 +161,11 @@ declare namespace _default {
      * @param {Element} el
      * @param {Object<string, string>|string} name
      * @param {string} [value]
-     * @returns {Element}
+     * @returns {Element|DOMStringMap}
      */
     function data(el: Element, name: {
         [x: string]: string;
-    } | string, value?: string): Element;
+    } | string, value?: string): Element | DOMStringMap;
     /**
      * @param {Element} el
      * @param {string} name
@@ -178,11 +190,11 @@ declare namespace _default {
     function off(el: Element | Document | Window, event: string, handler: Function, options: Object): Element;
     /**
      * @param {HTMLElement} el
-     * @param {Object<string, string>|string} styles
+     * @param {Object<string, string>|string} style
      * @param {string} [value]
      * @returns {Element}
      */
-    function css(el: HTMLElement, styles: {
+    function css(el: HTMLElement, style: {
         [x: string]: string;
     } | string, value?: string): Element;
     /**
@@ -205,15 +217,15 @@ declare namespace _default {
      */
     function first(nodeList: NodeList): Element | null;
     /**
-     * @param {NodeList} nodeList
+     * @param {NodeList|Array<Element>} nodeList
      * @returns {Element|null}
      */
-    function last(nodeList: NodeList): Element | null;
+    function last(nodeList: NodeList | Array<Element>): Element | null;
     /**
      * @param {string} html
-     * @returns {Element}
+     * @returns {Element|null}
      */
-    function create(html: string): Element;
+    function create(html: string): Element | null;
     /**
      * @param {NodeList} nodeList
      * @param {number} [index=0]
@@ -237,5 +249,11 @@ declare namespace _default {
      * @returns {Element}
      */
     function empty(el: Element): Element;
+    /**
+     * @param {Element|NodeList} el
+     * @param {string|Element} selector
+     * @return {Element[]}
+     */
+    function not(el: Element | NodeList, selector: string | Element): Element[];
 }
 export default _default;

package/types/index.d.ts

@@ -31,20 +31,22 @@ declare const webf: {
     dom: {
         children(el: Element, selector?: string): NodeList;
         child(el: Element, selector?: string): Element | null;
-        find(refEl: Element | Document | string, selector?: string): NodeList;
-        findOne(refEl: Element | Document | string, selector?: string): Element | null;
-        addClass(el: Element, className: string): Element;
-        removeClass(el: Element, classNames: string): Element;
+        findOne(refEl: Element | Document, selector?: string | Element | NodeList | Array<Element>): Element | null;
+        find(refEl: Element | Document, selector: string | Element | NodeList | Array<Element>): Array<Element>;
+        addClass(el: Element | NodeList | Array<Element>, className: string): Element | NodeList | Array<Element>;
+        removeClass(el: Element | NodeList | Array<Element>, className: string): Element | NodeList | Array<Element>;
         toggleClass(el: Element, classNames: string, force?: boolean): Element;
         hasClass(el: Element, classNames: string): boolean;
-        append(el: Element, child: Element): Element;
-        prepend(el: Element, child: Element): Element;
-        remove(el: Element): void;
-        closest(el: Element, selector?: string): Element | null;
+        append(node: Node, ...children: Node[]): Node;
+        prepend(node: Node, ...children: Node[]): Node;
+        remove(...els: Element | NodeList | Array<Element> | string): void;
+        closest(el: Element, selector: string | Element): Element | null;
         next(el: Element, selector?: string): Element | null;
         prev(el: Element, selector?: string | null): Element | null;
         nextAll(el: Element, selector?: string): Element[];
         prevAll(el: Element, selector?: string): Element[];
+        nextUntil(el: Element, selector: Element | string): Element[];
+        prevUntil(el: Element, selector: Element | string): Element[];
         wrap(el: Element, wrappingElement: Element): Element;
         attr(el: Element, name: string, value?: any): Element | any;
         prop(el: Element, name: string, value?: any): any | Element;
@@ -55,33 +57,34 @@ declare const webf: {
         toggle(el: Element): Element;
         data(el: Element, name: {
             [x: string]: string;
-        } | string, value?: string): Element;
+        } | string, value?: string): Element | DOMStringMap;
         removeData(el: Element, name: string): Element | any;
         on(el: Element | Document | Window, event: string, handler: Function, options?: AddEventListenerOptions | false): Element;
         off(el: Element | Document | Window, event: string, handler: Function, options: Object): Element;
-        css(el: HTMLElement, styles: {
+        css(el: HTMLElement, style: {
             [x: string]: string;
         } | string, value?: string): Element;
         closestFind(el: Element, selectorClosest: string, selectorFind: string): NodeList | null;
         closestFindOne(el: Element, selectorClosest: string, selectorFindOne: string): Element | null;
         first(nodeList: NodeList): Element | null;
-        last(nodeList: NodeList): Element | null;
-        create(html: string): Element;
+        last(nodeList: NodeList | Array<Element>): Element | null;
+        create(html: string): Element | null;
         eq(nodeList: NodeList, index?: number): Element | null;
         after(el: Element, newEl: Element): Element;
         before(el: Element, newEl: Element): Element;
         empty(el: Element): Element;
+        not(el: Element | NodeList, selector: string | Element): Element[];
     };
     isWindow: (o: any) => boolean;
     isDomElement: (o: any) => boolean;
     getStyle: (elem: any, cssRule: any) => any;
-    each: (o: any, callback: any, context: any) => any;
-    foreach: (o: any, callback: any, context: any) => any;
-    map: (o: any, callback: any, context: any) => any[];
-    reduce: (o: any, callback: any, initialValue: any) => any;
-    extend: (...args: any[]) => any;
-    clone: (o: any) => any;
-    merge: (first: any, second?: any[], ...args: any[]) => any;
+    each: <T>(o: Collection<T>, callback: (key: number | string, value: T, o: Collection<T>, index: number) => (void | boolean), context?: any) => typeof o;
+    foreach: <T>(o: Collection<T>, callback: (value: T, key: number | string, o: Collection<T>, index: number) => (void | boolean), context?: any) => typeof o;
+    map: <T, R>(o: Collection<T>, callback: (key: number | string, value: T, o: Collection<T>, index: number) => (R | null | false), context?: any) => any[];
+    reduce: <T, R>(o: Collection<T>, callback: (accumulator: R | T, value: T, key: any, index: number, o: Collection<T>) => R, initialValue?: R) => R;
+    extend: <T>(...args: (boolean | T)[]) => T;
+    clone: <T>(o: T) => T;
+    merge: <T>(first: Collection<T>, second?: Collection<T>, ...args: Collection<T>[]) => Array<T>;
     inArray: (value: any, arr: Object | any[], index?: number, strict?: boolean) => boolean;
     indexOf: (arr: any, elt: any, from?: number) => number;
     compareArray: (a1: any, a2: any) => any;

package/types/is.d.ts

@@ -5,6 +5,7 @@ export function isPlainObject(o: any): boolean;
 export function isBoolean(b: any): boolean;
 export function isBool(b: any): boolean;
 export function isUndefined(v: any): v is undefined;
+export function isArrayLike(o: any): boolean;
 export function isArray(a: any): a is any[];
 export function isDate(o: any): boolean;
 export function isEvent(o: any): boolean;

package/types/traversal.d.ts

@@ -1,7 +1,10 @@
-export function each(o: any, callback: any, context: any): any;
-export function foreach(o: any, callback: any, context: any): any;
-export function map(o: any, callback: any, context: any): any[];
-export function reduce(o: any, callback: any, initialValue: any): any;
-export function extend(...args: any[]): any;
-export function clone(o: any): any;
-export function merge(first: any, second?: any[], ...args: any[]): any;
+export function each<T>(o: Collection<T>, callback: (key: number | string, value: T, o: Collection<T>, index: number) => (void | boolean), context?: any): typeof o;
+export function foreach<T>(o: Collection<T>, callback: (value: T, key: number | string, o: Collection<T>, index: number) => (void | boolean), context?: any): typeof o;
+export function map<T, R>(o: Collection<T>, callback: (key: number | string, value: T, o: Collection<T>, index: number) => (R | null | false), context?: any): any[];
+export function reduce<T, R>(o: Collection<T>, callback: (accumulator: R | T, value: T, key: any, index: number, o: Collection<T>) => R, initialValue?: R): R;
+export function extend<T>(...args: (boolean | T)[]): T;
+export function clone<T>(o: T): T;
+export function merge<T>(first: Collection<T>, second?: Collection<T>, ...args: Collection<T>[]): Array<T>;
+export type Collection<T> = Array<T> | Set<T> | Map<any, T> | {
+    [x: string]: T;
+} | string;