@dxyl/utils 1.1.0 → 1.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxyl/utils",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Collected many useful mathematical tools",
   "keywords": [
     "graphic",

package/types/events/eventTarget.d.ts

@@ -1,93 +1,60 @@
-export interface EventListener<T = any> {
-    (evt: Event<T>): void;
-}
-interface EventListenerObject<T = any> {
-    handleEvent(object: Event<T>): void;
-}
-interface EventInit {
-    bubbles?: boolean;
-    cancelable?: boolean;
-    composed?: boolean;
-}
-interface EventListenerOptions {
-    capture?: boolean;
-}
-type EventListenerOrEventListenerObject<T = any> = EventListener<T> | EventListenerObject<T>;
-interface AddEventListenerOptions extends EventListenerOptions {
+interface EventOptions {
     once?: boolean;
-    passive?: boolean;
-    signal?: AbortSignal;
+    capture?: boolean;
 }
-export declare class Event<T = any> {
-    readonly NONE = 0;
-    readonly CAPTURING_PHASE = 1;
-    readonly AT_TARGET = 2;
-    readonly BUBBLING_PHASE = 3;
+type EventCallback<T> = (event: Event<T>) => void;
+export declare const EventPhase: {
+    readonly NONE: 0;
+    readonly CAPTURING_PHASE: 1;
+    readonly AT_TARGET: 2;
+    readonly BUBBLING_PHASE: 3;
+};
+export type EventPhase = typeof EventPhase[keyof typeof EventPhase];
+export declare const NONE: 0;
+export declare const CAPTURING_PHASE: 1;
+export declare const AT_TARGET: 2;
+export declare const BUBBLING_PHASE: 3;
+export declare class Event<T = any, E extends Extract<keyof Record<string, any>, string> = ''> {
+    static create<T = any, E extends Extract<keyof Record<string, any>, string> = ''>(type: E, bubbles?: boolean, cancelable?: boolean): Event<T, E>;
+    type: E;
+    parentNode: null;
+    target: EventTarget | null;
+    currentTarget: EventTarget | null;
     data: T | null;
-    /** 事件类型 */
-    type: string;
-    /** 事件是否冒泡 */
+    eventPhase: number;
     bubbles: boolean;
-    /** 阻止事件冒泡的标志 */
-    cancelBubble: boolean;
-    /** 事件是否可以取消 */
     cancelable: boolean;
-    /** 事件是否支持跨文档冒泡 */
-    composed: boolean;
-    /** 事件是否被默认行为阻止 */
     defaultPrevented: boolean;
-    /** 事件是否由用户操作生成 */
-    isTrusted: boolean;
-    /** 事件的目标对象 */
-    target: EventTarget | null;
-    /** 当前正在处理事件的对象 */
-    currentTarget: EventTarget | null;
-    /** 事件阶段 */
-    eventPhase: number;
-    /** 事件的时间戳 */
-    timeStamp: number;
-    /**
-     * 标记事件是否应该立即停止传播
-     */
-    stopImmediatePropagationInternal: boolean;
-    /**
-     * 构造函数
-     * @param type 事件类型
-     * @param eventInitDict 可选的事件初始化字典
-     */
-    constructor(type: string, eventInitDict?: EventInit);
-    setData(data: T): this;
-    /**
-      * 初始化事件对象的属性
-      * @param type 事件类型
-      * @param bubbles 是否冒泡
-      * @param cancelable 是否可以取消
-      */
-    initEvent(type: string, bubbles?: boolean, cancelable?: boolean): void;
-    /**
-     * 阻止事件冒泡
-     */
-    stopPropagation(): void;
+    cancelBubble: boolean;
+    immediateCancelBubble: boolean;
+    constructor(type: E, bubbles?: boolean, cancelable?: boolean);
+    setData(data: T | null): this;
+    initEvent(type: E, bubbles?: boolean, cancelable?: boolean): void;
     /**
-     * 阻止事件的默认行为
+     *
+     * @returns {EventTarget[]}
      */
+    composedPath(): EventTarget<{}>[];
     preventDefault(): void;
-    /**
-     * 阻止事件冒泡并停止调用事件监听器
-     */
+    stopPropagation(): void;
     stopImmediatePropagation(): void;
-    /**
-     * 返回事件的目标对象及其祖先对象的路径
-     * @returns 事件路径的数组
-     */
-    composedPath(): EventTarget[];
 }
-export declare class EventTarget<Events extends Record<string, any> = any> {
-    private listeners;
+export interface EventTarget<Events extends Record<string, any> = {}> {
+    on<K extends keyof Events>(type: K, fn: EventCallback<Events[K]>, options?: EventOptions | boolean): void;
+    off<K extends keyof Events>(type: K, fn: EventCallback<Events[K]>, options?: EventOptions | boolean): void;
+    emit<K extends Extract<keyof Events, string>>(e: Event<Events[K], K>): void;
+}
+export declare class EventTarget<Events extends Record<string, any> = {}> {
     parentNode: EventTarget | null;
-    constructor();
-    addEventListener<E extends keyof Events>(type: E, callback: EventListenerOrEventListenerObject<Events[E]>, options?: AddEventListenerOptions | boolean): void;
-    dispatchEvent<E extends keyof Events>(event: Event<Events[E]>): boolean;
-    removeEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean): void;
+    private _bubble_emitter;
+    private _capture_emitter;
+    addEventListener<K extends keyof Events>(type: K, fn: EventCallback<Events[K]>, options?: EventOptions | boolean): void;
+    removeEventListener<K extends keyof Events>(type: K, fn: EventCallback<Events[K]>, options?: EventOptions | boolean): void;
+    /**
+     *
+     * @param {Event} e
+     */
+    dispatchEvent<K extends Extract<keyof Events, string>>(e: Event<Events[K], K>): boolean;
+    removeAllListeners(): void;
 }
-export {};
+export { EventTarget as EventPropagation };

package/types/lodash/_DataView.d.ts

@@ -0,0 +1,2 @@
+export default DataView;
+declare var DataView: any;

package/types/lodash/_Hash.d.ts

@@ -0,0 +1,29 @@
+import { default as hashClear } from './_hashClear.js';
+import { default as hashDelete } from './_hashDelete.js';
+import { default as hashGet } from './_hashGet.js';
+import { default as hashHas } from './_hashHas.js';
+import { default as hashSet } from './_hashSet.js';
+export default Hash;
+/**
+ * Creates a hash object.
+ *
+ * @private
+ * @constructor
+ * @param {Array} [entries] The key-value pairs to cache.
+ */
+declare function Hash(entries?: any[]): void;
+declare class Hash {
+    /**
+     * Creates a hash object.
+     *
+     * @private
+     * @constructor
+     * @param {Array} [entries] The key-value pairs to cache.
+     */
+    private constructor();
+    clear: typeof hashClear;
+    delete: typeof hashDelete;
+    get: typeof hashGet;
+    has: typeof hashHas;
+    set: typeof hashSet;
+}

package/types/lodash/_LazyWrapper.d.ts

@@ -0,0 +1,26 @@
+export default LazyWrapper;
+/**
+ * Creates a lazy wrapper object which wraps `value` to enable lazy evaluation.
+ *
+ * @private
+ * @constructor
+ * @param {*} value The value to wrap.
+ */
+declare function LazyWrapper(value: any): void;
+declare class LazyWrapper {
+    /**
+     * Creates a lazy wrapper object which wraps `value` to enable lazy evaluation.
+     *
+     * @private
+     * @constructor
+     * @param {*} value The value to wrap.
+     */
+    private constructor();
+    __wrapped__: any;
+    __actions__: any[];
+    __dir__: number;
+    __filtered__: boolean;
+    __iteratees__: any[];
+    __takeCount__: number;
+    __views__: any[];
+}

package/types/lodash/_ListCache.d.ts

@@ -0,0 +1,29 @@
+import { default as listCacheClear } from './_listCacheClear.js';
+import { default as listCacheDelete } from './_listCacheDelete.js';
+import { default as listCacheGet } from './_listCacheGet.js';
+import { default as listCacheHas } from './_listCacheHas.js';
+import { default as listCacheSet } from './_listCacheSet.js';
+export default ListCache;
+/**
+ * Creates an list cache object.
+ *
+ * @private
+ * @constructor
+ * @param {Array} [entries] The key-value pairs to cache.
+ */
+declare function ListCache(entries?: any[]): void;
+declare class ListCache {
+    /**
+     * Creates an list cache object.
+     *
+     * @private
+     * @constructor
+     * @param {Array} [entries] The key-value pairs to cache.
+     */
+    private constructor();
+    clear: typeof listCacheClear;
+    delete: typeof listCacheDelete;
+    get: typeof listCacheGet;
+    has: typeof listCacheHas;
+    set: typeof listCacheSet;
+}

package/types/lodash/_LodashWrapper.d.ts

@@ -0,0 +1,24 @@
+export default LodashWrapper;
+/**
+ * The base constructor for creating `lodash` wrapper objects.
+ *
+ * @private
+ * @param {*} value The value to wrap.
+ * @param {boolean} [chainAll] Enable explicit method chain sequences.
+ */
+declare function LodashWrapper(value: any, chainAll?: boolean): void;
+declare class LodashWrapper {
+    /**
+     * The base constructor for creating `lodash` wrapper objects.
+     *
+     * @private
+     * @param {*} value The value to wrap.
+     * @param {boolean} [chainAll] Enable explicit method chain sequences.
+     */
+    private constructor();
+    __wrapped__: any;
+    __actions__: any[];
+    __chain__: boolean;
+    __index__: number;
+    __values__: any;
+}

package/types/lodash/_Map.d.ts

@@ -0,0 +1,2 @@
+export default Map;
+declare var Map: any;

package/types/lodash/_MapCache.d.ts

@@ -0,0 +1,29 @@
+import { default as mapCacheClear } from './_mapCacheClear.js';
+import { default as mapCacheDelete } from './_mapCacheDelete.js';
+import { default as mapCacheGet } from './_mapCacheGet.js';
+import { default as mapCacheHas } from './_mapCacheHas.js';
+import { default as mapCacheSet } from './_mapCacheSet.js';
+export default MapCache;
+/**
+ * Creates a map cache object to store key-value pairs.
+ *
+ * @private
+ * @constructor
+ * @param {Array} [entries] The key-value pairs to cache.
+ */
+declare function MapCache(entries?: any[]): void;
+declare class MapCache {
+    /**
+     * Creates a map cache object to store key-value pairs.
+     *
+     * @private
+     * @constructor
+     * @param {Array} [entries] The key-value pairs to cache.
+     */
+    private constructor();
+    clear: typeof mapCacheClear;
+    delete: typeof mapCacheDelete;
+    get: typeof mapCacheGet;
+    has: typeof mapCacheHas;
+    set: typeof mapCacheSet;
+}

package/types/lodash/_Promise.d.ts

@@ -0,0 +1,2 @@
+export default Promise;
+declare var Promise: any;

package/types/lodash/_Set.d.ts

@@ -0,0 +1,2 @@
+export default Set;
+declare var Set: any;

package/types/lodash/_SetCache.d.ts

@@ -0,0 +1,28 @@
+import { default as MapCache } from './_MapCache.js';
+import { default as setCacheAdd } from './_setCacheAdd.js';
+import { default as setCacheHas } from './_setCacheHas.js';
+export default SetCache;
+/**
+ *
+ * Creates an array cache object to store unique values.
+ *
+ * @private
+ * @constructor
+ * @param {Array} [values] The values to cache.
+ */
+declare function SetCache(values?: any[]): void;
+declare class SetCache {
+    /**
+     *
+     * Creates an array cache object to store unique values.
+     *
+     * @private
+     * @constructor
+     * @param {Array} [values] The values to cache.
+     */
+    private constructor();
+    __data__: MapCache;
+    add: typeof setCacheAdd;
+    push: typeof setCacheAdd;
+    has: typeof setCacheHas;
+}

package/types/lodash/_Stack.d.ts

@@ -0,0 +1,32 @@
+import { default as ListCache } from './_ListCache.js';
+import { default as stackClear } from './_stackClear.js';
+import { default as stackDelete } from './_stackDelete.js';
+import { default as stackGet } from './_stackGet.js';
+import { default as stackHas } from './_stackHas.js';
+import { default as stackSet } from './_stackSet.js';
+export default Stack;
+/**
+ * Creates a stack cache object to store key-value pairs.
+ *
+ * @private
+ * @constructor
+ * @param {Array} [entries] The key-value pairs to cache.
+ */
+declare function Stack(entries?: any[]): void;
+declare class Stack {
+    /**
+     * Creates a stack cache object to store key-value pairs.
+     *
+     * @private
+     * @constructor
+     * @param {Array} [entries] The key-value pairs to cache.
+     */
+    private constructor();
+    __data__: ListCache;
+    size: any;
+    clear: typeof stackClear;
+    delete: typeof stackDelete;
+    get: typeof stackGet;
+    has: typeof stackHas;
+    set: typeof stackSet;
+}

package/types/lodash/_Symbol.d.ts

@@ -0,0 +1,3 @@
+export default Symbol;
+/** Built-in value references. */
+declare var Symbol: any;

package/types/lodash/_Uint8Array.d.ts

@@ -0,0 +1,3 @@
+export default Uint8Array;
+/** Built-in value references. */
+declare var Uint8Array: any;

package/types/lodash/_WeakMap.d.ts

@@ -0,0 +1,2 @@
+export default WeakMap;
+declare var WeakMap: any;

package/types/lodash/_addMapEntry.d.ts

@@ -0,0 +1,10 @@
+export default addMapEntry;
+/**
+ * Adds the key-value `pair` to `map`.
+ *
+ * @private
+ * @param {Object} map The map to modify.
+ * @param {Array} pair The key-value pair to add.
+ * @returns {Object} Returns `map`.
+ */
+declare function addMapEntry(map: Object, pair: any[]): Object;

package/types/lodash/_addSetEntry.d.ts

@@ -0,0 +1,10 @@
+export default addSetEntry;
+/**
+ * Adds `value` to `set`.
+ *
+ * @private
+ * @param {Object} set The set to modify.
+ * @param {*} value The value to add.
+ * @returns {Object} Returns `set`.
+ */
+declare function addSetEntry(set: Object, value: any): Object;

package/types/lodash/_apply.d.ts

@@ -0,0 +1,12 @@
+export default apply;
+/**
+ * A faster alternative to `Function#apply`, this function invokes `func`
+ * with the `this` binding of `thisArg` and the arguments of `args`.
+ *
+ * @private
+ * @param {Function} func The function to invoke.
+ * @param {*} thisArg The `this` binding of `func`.
+ * @param {Array} args The arguments to invoke `func` with.
+ * @returns {*} Returns the result of `func`.
+ */
+declare function apply(func: Function, thisArg: any, args: any[]): any;

package/types/lodash/_arrayAggregator.d.ts

@@ -0,0 +1,12 @@
+export default arrayAggregator;
+/**
+ * A specialized version of `baseAggregator` for arrays.
+ *
+ * @private
+ * @param {Array} [array] The array to iterate over.
+ * @param {Function} setter The function to set `accumulator` values.
+ * @param {Function} iteratee The iteratee to transform keys.
+ * @param {Object} accumulator The initial aggregated object.
+ * @returns {Function} Returns `accumulator`.
+ */
+declare function arrayAggregator(array?: any[], setter: Function, iteratee: Function, accumulator: Object): Function;

package/types/lodash/_arrayEach.d.ts

@@ -0,0 +1,11 @@
+export default arrayEach;
+/**
+ * A specialized version of `_.forEach` for arrays without support for
+ * iteratee shorthands.
+ *
+ * @private
+ * @param {Array} [array] The array to iterate over.
+ * @param {Function} iteratee The function invoked per iteration.
+ * @returns {Array} Returns `array`.
+ */
+declare function arrayEach(array?: any[], iteratee: Function): any[];

package/types/lodash/_arrayEachRight.d.ts

@@ -0,0 +1,11 @@
+export default arrayEachRight;
+/**
+ * A specialized version of `_.forEachRight` for arrays without support for
+ * iteratee shorthands.
+ *
+ * @private
+ * @param {Array} [array] The array to iterate over.
+ * @param {Function} iteratee The function invoked per iteration.
+ * @returns {Array} Returns `array`.
+ */
+declare function arrayEachRight(array?: any[], iteratee: Function): any[];

package/types/lodash/_arrayEvery.d.ts

@@ -0,0 +1,12 @@
+export default arrayEvery;
+/**
+ * A specialized version of `_.every` for arrays without support for
+ * iteratee shorthands.
+ *
+ * @private
+ * @param {Array} [array] The array to iterate over.
+ * @param {Function} predicate The function invoked per iteration.
+ * @returns {boolean} Returns `true` if all elements pass the predicate check,
+ *  else `false`.
+ */
+declare function arrayEvery(array?: any[], predicate: Function): boolean;

package/types/lodash/_arrayFilter.d.ts

@@ -0,0 +1,11 @@
+export default arrayFilter;
+/**
+ * A specialized version of `_.filter` for arrays without support for
+ * iteratee shorthands.
+ *
+ * @private
+ * @param {Array} [array] The array to iterate over.
+ * @param {Function} predicate The function invoked per iteration.
+ * @returns {Array} Returns the new filtered array.
+ */
+declare function arrayFilter(array?: any[], predicate: Function): any[];

package/types/lodash/_arrayIncludes.d.ts

@@ -0,0 +1,11 @@
+export default arrayIncludes;
+/**
+ * A specialized version of `_.includes` for arrays without support for
+ * specifying an index to search from.
+ *
+ * @private
+ * @param {Array} [array] The array to inspect.
+ * @param {*} target The value to search for.
+ * @returns {boolean} Returns `true` if `target` is found, else `false`.
+ */
+declare function arrayIncludes(array?: any[], value: any): boolean;

package/types/lodash/_arrayIncludesWith.d.ts

@@ -0,0 +1,11 @@
+export default arrayIncludesWith;
+/**
+ * This function is like `arrayIncludes` except that it accepts a comparator.
+ *
+ * @private
+ * @param {Array} [array] The array to inspect.
+ * @param {*} target The value to search for.
+ * @param {Function} comparator The comparator invoked per element.
+ * @returns {boolean} Returns `true` if `target` is found, else `false`.
+ */
+declare function arrayIncludesWith(array?: any[], value: any, comparator: Function): boolean;

package/types/lodash/_arrayLikeKeys.d.ts

@@ -0,0 +1,10 @@
+export default arrayLikeKeys;
+/**
+ * Creates an array of the enumerable property names of the array-like `value`.
+ *
+ * @private
+ * @param {*} value The value to query.
+ * @param {boolean} inherited Specify returning inherited property names.
+ * @returns {Array} Returns the array of property names.
+ */
+declare function arrayLikeKeys(value: any, inherited: boolean): any[];

package/types/lodash/_arrayMap.d.ts

@@ -0,0 +1,11 @@
+export default arrayMap;
+/**
+ * A specialized version of `_.map` for arrays without support for iteratee
+ * shorthands.
+ *
+ * @private
+ * @param {Array} [array] The array to iterate over.
+ * @param {Function} iteratee The function invoked per iteration.
+ * @returns {Array} Returns the new mapped array.
+ */
+declare function arrayMap(array?: any[], iteratee: Function): any[];

package/types/lodash/_arrayPush.d.ts

@@ -0,0 +1,10 @@
+export default arrayPush;
+/**
+ * Appends the elements of `values` to `array`.
+ *
+ * @private
+ * @param {Array} array The array to modify.
+ * @param {Array} values The values to append.
+ * @returns {Array} Returns `array`.
+ */
+declare function arrayPush(array: any[], values: any[]): any[];

package/types/lodash/_arrayReduce.d.ts

@@ -0,0 +1,14 @@
+export default arrayReduce;
+/**
+ * A specialized version of `_.reduce` for arrays without support for
+ * iteratee shorthands.
+ *
+ * @private
+ * @param {Array} [array] The array to iterate over.
+ * @param {Function} iteratee The function invoked per iteration.
+ * @param {*} [accumulator] The initial value.
+ * @param {boolean} [initAccum] Specify using the first element of `array` as
+ *  the initial value.
+ * @returns {*} Returns the accumulated value.
+ */
+declare function arrayReduce(array?: any[], iteratee: Function, accumulator?: any, initAccum?: boolean): any;

package/types/lodash/_arrayReduceRight.d.ts

@@ -0,0 +1,14 @@
+export default arrayReduceRight;
+/**
+ * A specialized version of `_.reduceRight` for arrays without support for
+ * iteratee shorthands.
+ *
+ * @private
+ * @param {Array} [array] The array to iterate over.
+ * @param {Function} iteratee The function invoked per iteration.
+ * @param {*} [accumulator] The initial value.
+ * @param {boolean} [initAccum] Specify using the last element of `array` as
+ *  the initial value.
+ * @returns {*} Returns the accumulated value.
+ */
+declare function arrayReduceRight(array?: any[], iteratee: Function, accumulator?: any, initAccum?: boolean): any;

package/types/lodash/_arraySample.d.ts

@@ -0,0 +1,9 @@
+export default arraySample;
+/**
+ * A specialized version of `_.sample` for arrays.
+ *
+ * @private
+ * @param {Array} array The array to sample.
+ * @returns {*} Returns the random element.
+ */
+declare function arraySample(array: any[]): any;

package/types/lodash/_arraySampleSize.d.ts

@@ -0,0 +1,10 @@
+export default arraySampleSize;
+/**
+ * A specialized version of `_.sampleSize` for arrays.
+ *
+ * @private
+ * @param {Array} array The array to sample.
+ * @param {number} n The number of elements to sample.
+ * @returns {Array} Returns the random elements.
+ */
+declare function arraySampleSize(array: any[], n: number): any[];

package/types/lodash/_arrayShuffle.d.ts

@@ -0,0 +1,9 @@
+export default arrayShuffle;
+/**
+ * A specialized version of `_.shuffle` for arrays.
+ *
+ * @private
+ * @param {Array} array The array to shuffle.
+ * @returns {Array} Returns the new shuffled array.
+ */
+declare function arrayShuffle(array: any[]): any[];

package/types/lodash/_arraySome.d.ts

@@ -0,0 +1,12 @@
+export default arraySome;
+/**
+ * A specialized version of `_.some` for arrays without support for iteratee
+ * shorthands.
+ *
+ * @private
+ * @param {Array} [array] The array to iterate over.
+ * @param {Function} predicate The function invoked per iteration.
+ * @returns {boolean} Returns `true` if any element passes the predicate check,
+ *  else `false`.
+ */
+declare function arraySome(array?: any[], predicate: Function): boolean;

package/types/lodash/_asciiSize.d.ts

@@ -0,0 +1,9 @@
+export default asciiSize;
+/**
+ * Gets the size of an ASCII `string`.
+ *
+ * @private
+ * @param {string} string The string inspect.
+ * @returns {number} Returns the string size.
+ */
+declare var asciiSize: Function;

package/types/lodash/_asciiToArray.d.ts

@@ -0,0 +1,9 @@
+export default asciiToArray;
+/**
+ * Converts an ASCII `string` to an array.
+ *
+ * @private
+ * @param {string} string The string to convert.
+ * @returns {Array} Returns the converted array.
+ */
+declare function asciiToArray(string: string): any[];

package/types/lodash/_asciiWords.d.ts

@@ -0,0 +1,9 @@
+export default asciiWords;
+/**
+ * Splits an ASCII `string` into an array of its words.
+ *
+ * @private
+ * @param {string} The string to inspect.
+ * @returns {Array} Returns the words of `string`.
+ */
+declare function asciiWords(string: any): any[];