@webalternatif/js-core 1.2.1 → 1.3.1

package/types/dom.d.ts

@@ -1,6 +1,7 @@
 export function isWindow(o: any): boolean;
+export function isDocument(o: any): boolean;
 export function isDomElement(o: any): boolean;
-export function getStyle(elem: any, cssRule: any): any;
+export function getStyle(el: Element, cssRule: string): string;
 declare namespace _default {
     /**
      * @param {Element} el
@@ -15,17 +16,31 @@ declare namespace _default {
      */
     function child(el: Element, selector?: string): Element | null;
     /**
-     * @param {Element|Document} refEl
-     * @param {string|Element|NodeList|Array<Element>} [selector]
-     * @returns {Element|null}
+     * @param {Element|Document|string} refEl
+     * @param {string|Element|NodeList|Array<Element>} selector
+     * @returns {Element}
      */
-    function findOne(refEl: Element | Document, selector?: string | Element | NodeList | Array<Element>): Element | null;
+    function findOne(refEl: Element | Document | string, selector: string | Element | NodeList | Array<Element>): Element;
     /**
-     * @param {Element|Document} refEl
+     * @param {Element|Document|string} refEl
      * @param {string|Element|NodeList|Array<Element>} selector
      * @returns {Array<Element>}
      */
-    function find(refEl: Element | Document, selector: string | Element | NodeList | Array<Element>): Array<Element>;
+    function find(refEl: Element | Document | string, selector: string | Element | NodeList | Array<Element>): Array<Element>;
+    /**
+     * @param {Element|string} el
+     * @param {string} data
+     * @param {string} [value]
+     * @returns {Element|null}
+     */
+    function findOneByData(el: Element | string, data: string, value?: string): Element | null;
+    /**
+     * @param {Element|string} el
+     * @param {string} data
+     * @param {string} [value]
+     * @returns {Element[]}
+     */
+    function findByData(el: Element | string, data: string, value?: string): Element[];
     /**
      * @param {Element|NodeList|Array<Element>} el
      * @param {string} className
@@ -53,16 +68,16 @@ declare namespace _default {
     function hasClass(el: Element, classNames: string): boolean;
     /**
      * @param {Node} node
-     * @param {...Node} children
+     * @param {...(Node|string)} children
      * @returns {Node}
      */
-    function append(node: Node, ...children: Node[]): Node;
+    function append(node: Node, ...children: (Node | string)[]): Node;
     /**
      * @param {Node} node
-     * @param {...Node} children
+     * @param {...(Node|string)} children
      * @returns {Node}
      */
-    function prepend(node: Node, ...children: Node[]): Node;
+    function prepend(node: Node, ...children: (Node | string)[]): Node;
     /**
      * @param {Element|NodeList|Array<Element>|string} els
      * @returns {void}
@@ -70,10 +85,10 @@ declare namespace _default {
     function remove(...els: Element | NodeList | Array<Element> | string): void;
     /**
      * @param {Element} el
-     * @param {string|Element} selector
+     * @param {string|Element} [selector]
      * @returns {Element|null}
      */
-    function closest(el: Element, selector: string | Element): Element | null;
+    function closest(el: Element, selector?: string | Element): Element | null;
     /**
      * @param {Element} el
      * @param {string} [selector]
@@ -174,20 +189,22 @@ declare namespace _default {
     function removeData(el: Element, name: string): Element | any;
     /**
      * @param {Element|Document|Window} el
-     * @param {string} event
-     * @param {function} handler
-     * @param {AddEventListenerOptions|false} options
+     * @param {string} events
+     * @param {string|Element|function} selector
+     * @param {function|AddEventListenerOptions|boolean} [handler]
+     * @param {AddEventListenerOptions|boolean} [options]
      * @returns {Element}
      */
-    function on(el: Element | Document | Window, event: string, handler: Function, options?: AddEventListenerOptions | false): Element;
+    function on(el: Element | Document | Window, events: string, selector: string | Element | Function, handler?: Function | AddEventListenerOptions | boolean, options?: AddEventListenerOptions | boolean): Element;
     /**
      * @param {Element|Document|Window} el
-     * @param {string} event
-     * @param {function} handler
-     * @param {Object} options
+     * @param {string} [events]
+     * @param {string|Element|function} selector
+     * @param {function|AddEventListenerOptions|boolean} [handler]
+     * @param {AddEventListenerOptions|boolean} [options]
      * @returns {Element}
      */
-    function off(el: Element | Document | Window, event: string, handler: Function, options: Object): Element;
+    function off(el: Element | Document | Window, events?: string, selector: string | Element | Function, handler?: Function | AddEventListenerOptions | boolean, options?: AddEventListenerOptions | boolean): Element;
     /**
      * @param {HTMLElement} el
      * @param {Object<string, string>|string} style
@@ -227,23 +244,23 @@ declare namespace _default {
      */
     function create(html: string): Element | null;
     /**
-     * @param {NodeList} nodeList
+     * @param {NodeList|Array<Element>} nodeList
      * @param {number} [index=0]
      * @returns {Element|null}
      */
-    function eq(nodeList: NodeList, index?: number): Element | null;
+    function eq(nodeList: NodeList | Array<Element>, index?: number): Element | null;
     /**
      * @param {Element} el
-     * @param {Element} newEl
-     * @returns {Element}
+     * @param {Element|string} newEl
+     * @returns {Element|null}
      */
-    function after(el: Element, newEl: Element): Element;
+    function after(el: Element, newEl: Element | string): Element | null;
     /**
      * @param {Element} el
-     * @param {Element} newEl
-     * @returns {Element}
+     * @param {Element|string} newEl
+     * @returns {Element|null}
      */
-    function before(el: Element, newEl: Element): Element;
+    function before(el: Element, newEl: Element | string): Element | null;
     /**
      * @param {Element} el
      * @returns {Element}
@@ -255,6 +272,17 @@ declare namespace _default {
      * @return {Element[]}
      */
     function not(el: Element | NodeList, selector: string | Element): Element[];
+    /**
+     * @param {Element} elem1
+     * @param {Element} elem2
+     * @returns {boolean}
+     */
+    function collide(elem1: Element, elem2: Element): boolean;
+    /**
+     * @param {Element} el
+     * @param {string|Element} selector
+     */
+    function matches(el: Element, selector: string | Element): boolean;
     /**
      * @param {Element} el
      * @param {Element} child
@@ -267,5 +295,13 @@ declare namespace _default {
      * @returns {Element}
      */
     function replaceChildren(el: Element, ...children: Element[]): Element;
+    /**
+     * @param {Element|Document|Window} el
+     * @returns {{top: number, left: number}}
+     */
+    function offset(el: Element | Document | Window): {
+        top: number;
+        left: number;
+    };
 }
 export default _default;

package/types/index.d.ts

@@ -31,16 +31,18 @@ declare const webf: {
     dom: {
         children(el: Element, selector?: string): NodeList;
         child(el: Element, selector?: string): Element | null;
-        findOne(refEl: Element | Document, selector?: string | Element | NodeList | Array<Element>): Element | null;
-        find(refEl: Element | Document, selector: string | Element | NodeList | Array<Element>): Array<Element>;
+        findOne(refEl: Element | Document | string, selector: string | Element | NodeList | Array<Element>): Element;
+        find(refEl: Element | Document | string, selector: string | Element | NodeList | Array<Element>): Array<Element>;
+        findOneByData(el: Element | string, data: string, value?: string): Element | null;
+        findByData(el: Element | string, data: string, value?: string): 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(node: Node, ...children: Node[]): Node;
-        prepend(node: Node, ...children: Node[]): Node;
+        append(node: Node, ...children: (Node | string)[]): Node;
+        prepend(node: Node, ...children: (Node | string)[]): Node;
         remove(...els: Element | NodeList | Array<Element> | string): void;
-        closest(el: Element, selector: string | Element): Element | null;
+        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[];
@@ -59,8 +61,8 @@ declare const webf: {
             [x: string]: string;
         } | 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;
+        on(el: Element | Document | Window, events: string, selector: string | Element | Function, handler?: Function | AddEventListenerOptions | boolean, options?: AddEventListenerOptions | boolean): Element;
+        off(el: Element | Document | Window, events?: string, selector: string | Element | Function, handler?: Function | AddEventListenerOptions | boolean, options?: AddEventListenerOptions | boolean): Element;
         css(el: HTMLElement, style: {
             [x: string]: string;
         } | string, value?: string): Element;
@@ -69,20 +71,51 @@ declare const webf: {
         first(nodeList: NodeList | Element | Array<Element>): Element | null;
         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;
+        eq(nodeList: NodeList | Array<Element>, index?: number): Element | null;
+        after(el: Element, newEl: Element | string): Element | null;
+        before(el: Element, newEl: Element | string): Element | null;
         empty(el: Element): Element;
         not(el: Element | NodeList, selector: string | Element): Element[];
+        collide(elem1: Element, elem2: Element): boolean;
+        matches(el: Element, selector: string | Element): boolean;
         replaceChild(el: Element, child: Element, oldChild: Element): Element;
         replaceChildren(el: Element, ...children: Element[]): Element;
+        offset(el: Element | Document | Window): {
+            top: number;
+            left: number;
+        };
     };
     isWindow: (o: any) => boolean;
+    isDocument: (o: any) => boolean;
     isDomElement: (o: any) => boolean;
-    getStyle: (elem: any, cssRule: any) => any;
+    getStyle: (el: Element, cssRule: string) => string;
+    randAlpha: (n: any) => string;
+    randAlphaCs: (n: any) => string;
+    randAlphaNum: (n: any) => string;
+    randAlphaNumCs: (n: any) => string;
+    randNum: (n: any) => string;
+    rand: (range: any, n: any) => string;
+    uniqid: (prefix?: string) => string;
+    isString: (str: any) => boolean;
+    isObject: (o: any) => boolean;
+    isFunction: (f: any) => boolean;
+    isPlainObject: (o: any) => boolean;
+    isBoolean: (b: any) => boolean;
+    isBool: (b: any) => boolean;
+    isUndefined: (v: any) => v is undefined;
+    isArrayLike: (o: any) => boolean;
+    isArray: (a: any) => a is any[];
+    isDate: (o: any) => boolean;
+    isEvent: (o: any) => boolean;
+    isInteger: (n: any) => boolean;
+    isInt: (n: any) => boolean;
+    isFloat: (n: any) => boolean;
+    isScalar: (value: any) => boolean;
+    isEventSupported: (eventName: any) => boolean;
+    isTouchDevice: () => boolean;
     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[];
+    map: <T, R>(o: Collection<T>, callback: (key: number | string, value: T, o: Collection<T>, index: number) => (R | null | false), context?: any) => Array<R>;
     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;
@@ -125,7 +158,7 @@ declare const webf: {
     stripTags: (str: any, tag: any) => any;
     toUrl: (str: any) => any;
     escapeRegex: (str: any) => any;
-    camelCase: (str: any) => any;
+    camelCase: (str: any) => string;
     format: (str: any, ...args: any[]) => any;
     f: (str: any, ...args: any[]) => any;
     toCssClassName: (str: any) => any;
@@ -136,9 +169,11 @@ declare const webf: {
 import * as stringFunctions from './string.js';
 import * as arrayFunctions from './array.js';
 import * as traversal from './traversal.js';
+import * as is from './is.js';
+import * as random from './random.js';
 import { getStyle } from './dom.js';
 import dom from './dom.js';
 import * as math from './math.js';
 import * as utils from './utils.js';
 import eventDispatcher from './eventDispatcher.js';
-export { stringFunctions, arrayFunctions, traversal, getStyle, dom, math, utils, eventDispatcher };
+export { stringFunctions, arrayFunctions, traversal, is, random, getStyle, dom, math, utils, eventDispatcher };

package/types/random.d.ts

@@ -1,7 +1,7 @@
-export function uniqid(): string;
 export function randAlpha(n: any): string;
 export function randAlphaCs(n: any): string;
 export function randAlphaNum(n: any): string;
 export function randAlphaNumCs(n: any): string;
 export function randNum(n: any): string;
 export function rand(range: any, n: any): string;
+export function uniqid(prefix?: string): string;

package/types/string.d.ts

@@ -28,7 +28,7 @@ export function repeat(str: any, n: any): string;
 export function stripTags(str: any, tag: any): any;
 export function toUrl(str: any): any;
 export function escapeRegex(str: any): any;
-export function camelCase(str: any): any;
+export function camelCase(str: any): string;
 export function format(str: any, ...args: any[]): any;
 export function f(str: any, ...args: any[]): any;
 export function toCssClassName(str: any): any;

package/types/traversal.d.ts

@@ -1,6 +1,6 @@
 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 map<T, R>(o: Collection<T>, callback: (key: number | string, value: T, o: Collection<T>, index: number) => (R | null | false), context?: any): Array<R>;
 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;