@webalternatif/js-core 1.5.4 → 1.6.0

package/types/dom.d.ts

@@ -9,177 +9,177 @@ declare namespace dom {
      * @param {string} [selector]
      * @returns {NodeList}
      */
-    function children(el: Element, selector?: string): NodeList;
+    export function children(el: Element, selector?: string): NodeList;
     /**
      * @param {Element} el
      * @param {string} [selector]
      * @returns {Element|null}
      */
-    function child(el: Element, selector?: string): Element | null;
+    export function child(el: Element, selector?: string): Element | null;
     /**
      * @param {Element|Document|string} refEl
      * @param {string|Element|NodeList|Array<Element>} [selector]
      * @returns {Element}
      */
-    function findOne(refEl: Element | Document | string, selector?: string | Element | NodeList | Array<Element>): Element;
+    export function findOne(refEl: Element | Document | string, selector?: string | Element | NodeList | Array<Element>): Element;
     /**
      * @param {Element|Document|string} refEl
      * @param {string|Element|NodeList|Array<Element>} [selector]
      * @returns {Array<Element>}
      */
-    function find(refEl: Element | Document | string, selector?: string | Element | NodeList | Array<Element>): Array<Element>;
+    export 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;
+    export 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[];
+    export function findByData(el: Element | string, data: string, value?: string): Element[];
     /**
      * @param {Element|NodeList|Array<Element>} el
      * @param {string} className
      * @returns {Element|NodeList|Array<Element>}
      */
-    function addClass(el: Element | NodeList | Array<Element>, className: string): Element | NodeList | Array<Element>;
+    export function addClass(el: Element | NodeList | Array<Element>, className: string): Element | NodeList | Array<Element>;
     /**
      * @param {Element|NodeList|Array<Element>} el
      * @param {string} className
      * @returns {Element|NodeList|Array<Element>}
      */
-    function removeClass(el: Element | NodeList | Array<Element>, className: string): Element | NodeList | Array<Element>;
+    export function removeClass(el: Element | NodeList | Array<Element>, className: string): Element | NodeList | Array<Element>;
     /**
      * @param {Element} el
      * @param {string} classNames
      * @param {boolean} [force]
      * @returns {Element}
      */
-    function toggleClass(el: Element, classNames: string, force?: boolean): Element;
+    export function toggleClass(el: Element, classNames: string, force?: boolean): Element;
     /**
      * @param {Element} el
      * @param {string} classNames
      * @returns {boolean}
      */
-    function hasClass(el: Element, classNames: string): boolean;
+    export function hasClass(el: Element, classNames: string): boolean;
     /**
      * @param {Node} node
      * @param {...(Node|string)} children
      * @returns {Node}
      */
-    function append(node: Node, ...children: (Node | string)[]): Node;
+    export function append(node: Node, ...children: (Node | string)[]): Node;
     /**
      * @param {Node} node
      * @param {...(Node|string)} children
      * @returns {Node}
      */
-    function prepend(node: Node, ...children: (Node | string)[]): Node;
+    export function prepend(node: Node, ...children: (Node | string)[]): Node;
     /**
      * @param {Element|NodeList|Array<Element>|string} els
      * @returns {void}
      */
-    function remove(...els: Element | NodeList | Array<Element> | string): void;
+    export function remove(...els: Element | NodeList | Array<Element> | string): void;
     /**
      * @param {Element} el
      * @param {string|Element} [selector]
      * @returns {Element|null}
      */
-    function closest(el: Element, selector?: string | Element): Element | null;
+    export function closest(el: Element, selector?: string | Element): Element | null;
     /**
      * @param {Element} el
      * @param {string} [selector]
      * @returns {Element|null}
      */
-    function next(el: Element, selector?: string): Element | null;
+    export function next(el: Element, selector?: string): Element | null;
     /**
      * @param {Element} el
      * @param {string|null} [selector]
      * @returns {Element|null}
      */
-    function prev(el: Element, selector?: string | null): Element | null;
+    export function prev(el: Element, selector?: string | null): Element | null;
     /**
      * @param {Element} el
      * @param {string} [selector]
      * @returns {Element[]}
      */
-    function nextAll(el: Element, selector?: string): Element[];
+    export function nextAll(el: Element, selector?: string): Element[];
     /**
      * @param {Element} el
      * @param {string} [selector]
      * @returns {Element[]}
      */
-    function prevAll(el: Element, selector?: string): Element[];
+    export function prevAll(el: Element, selector?: string): Element[];
     /**
      * @param {Element} el
      * @param {Element|string} selector
      * @returns {Element[]}
      */
-    function nextUntil(el: Element, selector: Element | string): Element[];
+    export 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[];
+    export function prevUntil(el: Element, selector: Element | string): Element[];
     /**
      * @param {Element} el
      * @param {Element} wrappingElement
      * @returns {Element}
      */
-    function wrap(el: Element, wrappingElement: Element): Element;
+    export function wrap(el: Element, wrappingElement: Element): Element;
     /**
      * @param {Element} el
      * @param {string} name
      * @param {*} [value]
      * @returns {Element|*}
      */
-    function attr(el: Element, name: string, value?: any): Element | any;
+    export function attr(el: Element, name: string, value?: any): Element | any;
     /**
      * @param {Element} el
      * @param {string} name
      * @param {*} [value]
      * @returns {*|Element}
      */
-    function prop(el: Element, name: string, value?: any): any | Element;
+    export function prop(el: Element, name: string, value?: any): any | Element;
     /**
      * @param {Element} el
      * @param {string} [html]
-     * @returns {Element|*}
+     * @returns {Element|string}
      */
-    function html(el: Element, html?: string): Element | any;
+    export function html(el: Element, html?: string): Element | string;
     /**
      * @param {Element} el
      * @param {string} [text]
-     * @returns {Element|*}
+     * @returns {Element|string}
      */
-    function text(el: Element, text?: string): Element | any;
+    export function text(el: Element, text?: string): Element | string;
     /**
      * @param {Element} el
      * @returns {Element}
      */
-    function hide(el: Element): Element;
+    export function hide(el: Element): Element;
     /**
      * @param {Element} el
      * @returns {Element}
      */
-    function show(el: Element): Element;
+    export function show(el: Element): Element;
     /**
      * @param {Element} el
      * @returns {Element}
      */
-    function toggle(el: Element): Element;
+    export function toggle(el: Element): Element;
     /**
      * @param {Element} el
      * @param {Object<string, string>|string} name
      * @param {string} [value]
      * @returns {Element|DOMStringMap}
      */
-    function data(el: Element, name: {
+    export function data(el: Element, name: {
         [x: string]: string;
     } | string, value?: string): Element | DOMStringMap;
     /**
@@ -187,32 +187,14 @@ declare namespace dom {
      * @param {string} name
      * @returns {Element|*}
      */
-    function removeData(el: Element, name: string): Element | any;
-    /**
-     * @param {Element|Document|Window} el
-     * @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, events: string, selector: string | Element | Function, handler?: Function | AddEventListenerOptions | boolean, options?: AddEventListenerOptions | boolean): Element;
-    /**
-     * @param {Element|Document|Window} el
-     * @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, events?: string, selector?: string | Element | Function, handler?: Function | AddEventListenerOptions | boolean, options?: AddEventListenerOptions | boolean): Element;
+    export function removeData(el: Element, name: string): Element | any;
     /**
      * @param {HTMLElement} el
      * @param {Object<string, string>|string} style
      * @param {string} [value]
      * @returns {Element}
      */
-    function css(el: HTMLElement, style: {
+    export function css(el: HTMLElement, style: {
         [x: string]: string;
     } | string, value?: string): Element;
     /**
@@ -221,87 +203,101 @@ declare namespace dom {
      * @param {string} selectorFind
      * @returns {Array<Element>}
      */
-    function closestFind(el: Element, selectorClosest: string, selectorFind: string): Array<Element>;
+    export function closestFind(el: Element, selectorClosest: string, selectorFind: string): Array<Element>;
     /**
      * @param {Element} el
      * @param {string} selectorClosest
      * @param {string} selectorFindOne
      * @returns {Element|null}
      */
-    function closestFindOne(el: Element, selectorClosest: string, selectorFindOne: string): Element | null;
+    export function closestFindOne(el: Element, selectorClosest: string, selectorFindOne: string): Element | null;
     /**
      * @param {NodeList|Element|Array<Element>} nodeList
      * @returns {Element|null}
      */
-    function first(nodeList: NodeList | Element | Array<Element>): Element | null;
+    export function first(nodeList: NodeList | Element | Array<Element>): Element | null;
     /**
      * @param {NodeList|Array<Element>} nodeList
      * @returns {Element|null}
      */
-    function last(nodeList: NodeList | Array<Element>): Element | null;
+    export function last(nodeList: NodeList | Array<Element>): Element | null;
     /**
      * @param {string} html
      * @returns {Element|DocumentFragment|null}
      */
-    function create(html: string): Element | DocumentFragment | null;
+    export function create(html: string): Element | DocumentFragment | null;
     /**
      * @param {NodeList|Array<Element>} nodeList
      * @param {number} [index=0]
      * @returns {Element|null}
      */
-    function eq(nodeList: NodeList | Array<Element>, index?: number): Element | null;
+    export function eq(nodeList: NodeList | Array<Element>, index?: number): Element | null;
     /**
      * @param {Element} el
      * @param {Element|string} newEl
      * @returns {Element|null}
      */
-    function after(el: Element, newEl: Element | string): Element | null;
+    export function after(el: Element, newEl: Element | string): Element | null;
     /**
      * @param {Element} el
      * @param {Element|string} newEl
      * @returns {Element|null}
      */
-    function before(el: Element, newEl: Element | string): Element | null;
+    export function before(el: Element, newEl: Element | string): Element | null;
     /**
-     * @param {Element|string} el
+     * @param {Element} el
      * @returns {Element}
      */
-    function empty(el: Element | string): Element;
+    export function empty(el: Element): Element;
     /**
      * @param {Element|NodeList|Array<Element>} el
      * @param {string|Element} selector
      * @return {Array<Element>}
      */
-    function not(el: Element | NodeList | Array<Element>, selector: string | Element): Array<Element>;
+    export function not(el: Element | NodeList | Array<Element>, selector: string | Element): Array<Element>;
     /**
      * @param {Element} elem1
      * @param {Element} elem2
      * @returns {boolean}
      */
-    function collide(elem1: Element, elem2: Element): boolean;
+    export function collide(elem1: Element, elem2: Element): boolean;
     /**
      * @param {Element} el
      * @param {string|Element} selector
      */
-    function matches(el: Element, selector: string | Element): boolean;
+    export function matches(el: Element, selector: string | Element): boolean;
     /**
      * @param {Element} el
      * @param {Element} child
      * @param {Element} oldChild
      */
-    function replaceChild(el: Element, child: Element, oldChild: Element): Element;
+    export function replaceChild(el: Element, child: Element, oldChild: Element): Element;
     /**
      * @param {Element} el
      * @param {NodeList|Array<Element>|string[]} children
      * @returns {Element}
      */
-    function replaceChildren(el: Element, ...children: NodeList | Array<Element> | string[]): Element;
+    export function replaceChildren(el: Element, ...children: NodeList | Array<Element> | string[]): Element;
     /**
      * @param {Element|Document|Window} el
      * @returns {{top: number, left: number}}
      */
-    function offset(el: Element | Document | Window): {
+    export function offset(el: Element | Document | Window): {
         top: number;
         left: number;
     };
+    /**
+     * @param {Node} el
+     * @returns {boolean}
+     */
+    export function isEditable(el: Node): boolean;
+    /**
+     * @param {Node} node
+     * @returns {boolean}
+     */
+    export function isInDOM(node: Node): boolean;
+    export { on };
+    export { off };
 }
+import { on } from './onOff.js';
+import { off } from './onOff.js';

package/types/index.d.ts

@@ -1,6 +1,13 @@
 export default webf;
+/**
+ * Main entry point of js-core.
+ *
+ * Provides pure JavaScript utility functions such as string, array,
+ * type checking, traversal, math and other helpers.
+ *
+ * @module webf
+ */
 declare const webf: {
-    default: typeof i18n.default;
     equals: (o1: any, o2: any, seen?: WeakMap<WeakKey, any>) => any;
     noop: () => void;
     sizeOf: (o: any) => number;
@@ -15,63 +22,6 @@ declare const webf: {
     max: (list: any, cmp_func: any) => number | undefined;
     dec2hex: (n: number) => string;
     hex2dec: (hex: string) => number;
-    dom: {
-        children(el: Element, selector?: string): NodeList;
-        child(el: Element, selector?: string): Element | null;
-        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 | 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;
-        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;
-        html(el: Element, html?: string): Element | any;
-        text(el: Element, text?: string): Element | any;
-        hide(el: Element): Element;
-        show(el: Element): Element;
-        toggle(el: Element): Element;
-        data(el: Element, name: {
-            [x: string]: string;
-        } | string, value?: string): Element | DOMStringMap;
-        removeData(el: Element, name: string): Element | any;
-        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;
-        closestFind(el: Element, selectorClosest: string, selectorFind: string): Array<Element>;
-        closestFindOne(el: Element, selectorClosest: string, selectorFindOne: string): Element | null;
-        first(nodeList: NodeList | Element | Array<Element>): Element | null;
-        last(nodeList: NodeList | Array<Element>): Element | null;
-        create(html: string): Element | DocumentFragment | null;
-        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 | string): Element;
-        not(el: Element | NodeList | Array<Element>, selector: string | Element): Array<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: NodeList | Array<Element> | string[]): Element;
-        offset(el: Element | Document | Window): {
-            top: number;
-            left: number;
-        };
-    };
     isWindow: (o: any) => boolean;
     isDocument: (o: any) => boolean;
     isDomElement: (o: any) => boolean;
@@ -89,15 +39,15 @@ declare const webf: {
     isPlainObject: (o: any) => boolean;
     isBoolean: (b: any) => boolean;
     isBool: (b: any) => boolean;
-    isUndefined: (v: any) => v is undefined;
+    isUndefined: (v: any) => boolean;
     isArrayLike: (o: any) => boolean;
-    isArray: (a: any) => a is any[];
+    isArray: (a: any) => boolean;
     isDate: (o: any) => boolean;
     isEvent: (o: any) => boolean;
     isInteger: (n: any) => boolean;
     isInt: (n: any) => boolean;
     isFloat: (n: any) => boolean;
-    isScalar: (value: any) => boolean;
+    isScalar: (v: 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;
@@ -108,7 +58,8 @@ declare const webf: {
     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;
+    indexOf: (arr: Array<any> | string, elt: any, from?: number) => number;
+    lastIndexOf: (arr: Array<any> | string, elt: any, from?: number) => number;
     compareArray: (a1: any, a2: any) => any;
     arrayUnique: (arr: any) => any;
     array_unique: (arr: any) => any;
@@ -165,5 +116,4 @@ import * as utils from './utils.js';
 import eventDispatcher from './eventDispatcher.js';
 import Mouse from './Mouse.js';
 import Translator from './Translator.js';
-import * as i18n from './Translator.js';
 export { stringFunctions, arrayFunctions, traversal, is, random, getStyle, dom, math, utils, eventDispatcher, Mouse, Translator };

package/types/is.d.ts

@@ -4,14 +4,14 @@ export function isFunction(f: any): boolean;
 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 isUndefined(v: any): boolean;
 export function isArrayLike(o: any): boolean;
-export function isArray(a: any): a is any[];
+export function isArray(a: any): boolean;
 export function isDate(o: any): boolean;
 export function isEvent(o: any): boolean;
 export function isInteger(n: any): boolean;
 export function isInt(n: any): boolean;
 export function isFloat(n: any): boolean;
-export function isScalar(value: any): boolean;
+export function isScalar(v: any): boolean;
 export function isEventSupported(eventName: any): boolean;
 export function isTouchDevice(): boolean;

package/types/onOff.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @param {Element|Document|Window} el
+ * @param {string} events
+ * @param {string|Element|function} selector
+ * @param {function|AddEventListenerOptions|boolean} [handler]
+ * @param {AddEventListenerOptions|boolean} [options]
+ * @returns {Element}
+ */
+export 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} [events]
+ * @param {string|Element|function} [selector]
+ * @param {function|AddEventListenerOptions|boolean} [handler]
+ * @param {AddEventListenerOptions|boolean} [options]
+ * @returns {Element}
+ */
+export function off(el: Element | Document | Window, events?: string, selector?: string | Element | Function, handler?: Function | AddEventListenerOptions | boolean, options?: AddEventListenerOptions | boolean): Element;
+export function __resetCustomEventsForTests(): void;