@js-toolkit/web-utils 1.57.0 → 1.58.0

package/EventEmitterListener.d.ts

@@ -16,11 +16,11 @@ export declare class EventEmitterListener<T extends EmitterTarget, M extends Any
     private createWrapper;
     getListenerList<L = unknown>({ event, type }?: GetListenersOptions): L[];
     getListeners<L = unknown>({ event, type }?: GetListenersOptions): Record<string, L[]>;
-    has<K extends GetEventType<T>>(type: K, listener?: GetEventListener<T, K, M> | undefined, ...rest: [
+    has<K extends GetEventType<T>>(type: K, listener?: GetEventListener<T, K, M>, ...rest: [
         ...(T extends DomEventTarget ? [options?: GetOffOptions<T> | undefined] : []),
         ...unknown[]
     ]): boolean;
-    has(type: string, listener?: GetEventListener<T, string, M> | undefined, ...rest: [
+    has(type: string, listener?: GetEventListener<T, string, M>, ...rest: [
         ...(T extends DomEventTarget ? [options?: GetOffOptions<T> | undefined] : []),
         ...unknown[]
     ]): boolean;
@@ -48,8 +48,8 @@ export declare class EventEmitterListener<T extends EmitterTarget, M extends Any
         ...(T extends DomEventTarget ? [options?: GetOffOptions<T> | undefined] : []),
         ...unknown[]
     ]): this;
-    removeAllListeners<K extends GetEventType<T>>(type?: K | undefined): this;
-    removeAllListeners(type?: string | undefined): this;
+    removeAllListeners<K extends GetEventType<T>>(type?: K): this;
+    removeAllListeners(type?: string): this;
     removeAllListenersBut<K extends GetEventType<T>>(...types: K[]): this;
     removeAllListenersBut(...types: string[]): this;
     emit<K extends GetEventType<T>>(type: K, ...args: Parameters<GetEventListener<T, K, M>>): this;

package/EventEmitterListener.utils.d.ts

@@ -11,15 +11,14 @@ export type EventEmitterLike = {
 };
 export type EmitterTarget = DomEventTarget | EventTargetLike | EventEmitterLike;
 export type GetDomEventType<T extends DomEventTarget> = T['addEventListener'] extends {
-    (type: infer K, listener: (this: T, ev: any) => any, options?: boolean | AddEventListenerOptions | undefined): void;
-    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions | undefined): void;
+    (type: infer K, listener: (this: T, ev: any) => any, options?: boolean | AddEventListenerOptions): void;
+    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
 } ? K : string;
 export type GetDomEventListener<E, EM extends AnyObject> = (ev: E extends keyof EM ? EM[E] : Event, ...rest: unknown[]) => unknown;
-export type GetEventType<T extends EmitterTarget> = T extends DomEventTarget ? GetDomEventType<T> : T extends EventEmitterLike ? T['on'] extends {
+export type GetEventTypeFromFn<T extends EventEmitterLike['on']> = T extends {
     (type: infer K, listener: AnyFunction, ...rest: unknown[]): unknown;
-} ? K : string : T extends EventTargetLike ? T['addEventListener'] extends {
-    (type: infer K, listener: AnyFunction, ...rest: unknown[]): unknown;
-} ? K : string : string;
+} ? K : string;
+export type GetEventType<T extends EmitterTarget> = T extends DomEventTarget ? GetDomEventType<T> : T extends EventEmitterLike ? GetEventTypeFromFn<T['on']> : T extends EventTargetLike ? GetEventTypeFromFn<T['addEventListener']> : string;
 export type GetEventListener<T extends EmitterTarget, E, EM extends AnyObject = GetEventMap<T>> = T extends DomEventTarget ? IfExtends<EM, EmptyObject, EventListener, GetDomEventListener<E, EM>> : IfExtends<EM, EmptyObject, Parameters<T extends EventEmitterLike ? T['on'] : T extends EventTargetLike ? T['addEventListener'] : AnyFunction>['1'], (event: E extends keyof EM ? EM[E] : unknown, ...rest: any[]) => unknown>;
 type ListenersMapToEventMap<T extends Record<string, AnyFunction[]>> = {
     [P in keyof T]: Parameters<T[P][number]>[0];

package/EventEmitterListener.utils.js

@@ -1 +1 @@
-import{isEmptyObject}from"@js-toolkit/utils/isEmptyObject";export function isEventTargetLike(e){return void 0!==e.addEventListener&&void 0!==e.removeEventListener}export function isDomEventTarget(e){return isEventTargetLike(e)&&void 0!==e.dispatchEvent}export function isEventEmitterLike(e){return!isEventTargetLike(e)&&!isDomEventTarget(e)&&void 0!==e.on&&void 0!==e.once&&void 0!==e.off}let passiveSupported=!1;export function isPassiveSupported(){return passiveSupported}try{const e={get passive(){return passiveSupported=!0,!1}};window.addEventListener("__testpassive__",null,e)}catch(t){}export function normalizeOptions(e){if(e&&"object"==typeof e){let t=e;if("passive"in e&&!passiveSupported){const{passive:i,...n}=e;t=n}return isEmptyObject(t)?void 0:t}return e}
+import{isEmptyObject}from"@js-toolkit/utils/isEmptyObject";export function isEventTargetLike(e){return void 0!==e.addEventListener&&void 0!==e.removeEventListener}export function isDomEventTarget(e){return isEventTargetLike(e)&&void 0!==e.dispatchEvent}export function isEventEmitterLike(e){return!isEventTargetLike(e)&&!isDomEventTarget(e)&&void 0!==e.on&&void 0!==e.once&&void 0!==e.off}let passiveSupported=!1;export function isPassiveSupported(){return passiveSupported}try{const e={get passive(){return passiveSupported=!0,!1}};window.addEventListener("__testpassive__",null,e)}catch{}export function normalizeOptions(e){if(e&&"object"==typeof e){let t=e;if("passive"in e&&!passiveSupported){const{passive:i,...n}=e;t=n}return isEmptyObject(t)?void 0:t}return e}

package/EventListeners.d.ts

@@ -4,5 +4,5 @@ export declare class EventListeners {
     private readonly listeners;
     getScopes(): IterableIterator<EmitterTarget>;
     scope<T extends EmitterTarget, M extends AnyObject = GetEventMap<T>>(target: T, scope?: string): EventEmitterListener<T, M>;
-    removeAllListeners<T extends EmitterTarget>(target?: T | undefined, scope?: string): this;
+    removeAllListeners<T extends EmitterTarget>(target?: T, scope?: string): this;
 }

package/createRafLoop.d.ts

@@ -3,7 +3,7 @@ export interface RafLoopStartOptions {
     readonly scope?: AnimationFrameProvider | undefined;
 }
 export interface RafLoop {
-    start: (callback: FrameRequestCallback, options?: RafLoopStartOptions | undefined) => void;
+    start: (callback: FrameRequestCallback, options?: RafLoopStartOptions) => void;
     stop: VoidFunction;
     isActive: () => boolean;
 }

package/fullscreen.d.ts

@@ -17,9 +17,9 @@ export declare namespace fullscreen {
     export function isApiEnabled(): boolean;
     export function isFullscreen(): boolean;
     export function getElement(): Element | null | undefined;
-    export function on(type: EventType, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions | undefined): void;
-    export function off(type: EventType, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions | undefined): void;
-    export function request(elem: Element, options?: FullscreenOptions | undefined): Promise<void>;
+    export function on(type: EventType, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    export function off(type: EventType, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    export function request(elem: Element, options?: FullscreenOptions): Promise<void>;
     export function exit(): Promise<void>;
     export function toggle(elem: Element): Promise<void>;
     export function onChange(listener: EventListenerOrEventListenerObject): void;

package/getCurrentScriptUrl.d.ts

@@ -1 +1 @@
-export declare function getCurrentScriptUrl(url?: string | URL | undefined): URL;
+export declare function getCurrentScriptUrl(url?: string | URL): URL;

package/getEventAwaiter.d.ts

@@ -1,6 +1,11 @@
 import { type Awaiter } from '@js-toolkit/utils/getAwaiter';
-import { type EmitterTarget, type GetEventType } from './EventEmitterListener.utils';
+import { type EmitterTarget, type EventTargetLike, type GetEventType, type GetEventTypeFromFn } from './EventEmitterListener.utils';
 export type EventAwaiter = Awaiter<void>;
-export declare function getEventAwaiter<T extends EmitterTarget, E extends GetEventType<T>>(target: T, resolveEvent: E | E[], rejectEvent?: E | E[], 
-/** If it returns null or undefined then reject is ignored. */
-eventToError?: (event: any) => unknown): EventAwaiter;
+interface Options {
+    /** If it returns true then resolve is ignored. */
+    readonly ignoreResolve?: (event: any) => boolean;
+    /** If it returns null or undefined then reject is ignored. */
+    readonly eventToError?: (event: any) => unknown;
+}
+export declare function getEventAwaiter<T extends EmitterTarget, E extends T extends EventTargetLike ? GetEventTypeFromFn<OverloadToUnion<T['addEventListener']>> : GetEventType<T>>(target: T, resolveEvent: E | E[], rejectEvent?: E | E[], { ignoreResolve, eventToError }?: Options): EventAwaiter;
+export {};

package/getEventAwaiter.js

@@ -1 +1 @@
-import{getAwaiter}from"@js-toolkit/utils/getAwaiter";import{EventEmitterListener}from"./EventEmitterListener";import{isEventEmitterLike}from"./EventEmitterListener.utils";export function getEventAwaiter(t,e,r,i){const o=getAwaiter({lazy:!0}),n=Array.isArray(e)?e:[e],s=Array.isArray(r)?r:[r],E=isEventEmitterLike(t)?t:new EventEmitterListener(t),a=()=>{o.resolve()},f=t=>{const e=i?i(t):t;null!=e&&o.reject(e)},m=()=>{n.forEach((t=>E.off(t,a))),s.forEach((t=>E.off(t,f)))},c=o.resolve;o.resolve=(...t)=>{m(),c(...t)};const v=o.reject;return o.reject=(...t)=>{v(...t),m()},n.forEach((t=>E.on(t,a))),s.forEach((t=>E.on(t,f))),o}
+import{getAwaiter}from"@js-toolkit/utils/getAwaiter";import{EventEmitterListener}from"./EventEmitterListener";import{isEventEmitterLike}from"./EventEmitterListener.utils";export function getEventAwaiter(e,t,r,{ignoreResolve:i,eventToError:o}={}){const n=getAwaiter({lazy:!0}),s=Array.isArray(t)?t:[t],E=Array.isArray(r)?r:[r],a=isEventEmitterLike(e)?e:new EventEmitterListener(e),f=e=>{!(!!i&&i(e))&&n.resolve()},m=e=>{const t=o?o(e):e;null!=t&&n.reject(t)},v=()=>{s.forEach((e=>a.off(e,f))),E.forEach((e=>a.off(e,m)))},c=n.resolve;n.resolve=(...e)=>{v(),c(...e)};const l=n.reject;return n.reject=(...e)=>{l(...e),v()},s.forEach((e=>a.on(e,f))),E.forEach((e=>a.on(e,m))),n}

package/getRandomID.d.ts

@@ -1 +1 @@
-export declare function getRandomID(maxLength?: number | undefined): string;
+export declare function getRandomID(maxLength?: number): string;

package/media/resetMedia.d.ts

@@ -1,2 +1,2 @@
-/** Remove media from hardware decoder buffer */
+/** Remove media from hardware decoder buffer. */
 export declare function resetMedia(media: HTMLMediaElement): void;

package/media/resetMedia.js

@@ -1 +1 @@
-export function resetMedia(e){(e.src||e.srcObject)&&(URL.revokeObjectURL(e.src),e.removeAttribute("src"),e.srcObject=null,e.load())}
+export function resetMedia(e){if(e.src||e.srcObject||e.childElementCount>0){if(URL.revokeObjectURL(e.src),e.removeAttribute("src"),e.srcObject=null,e.childElementCount>0)for(const t of e.children)t instanceof HTMLSourceElement&&e.removeChild(t);e.load()}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@js-toolkit/web-utils",
-  "version": "1.57.0",
+  "version": "1.58.0",
   "description": "Web utils",
   "author": "VZH",
   "license": "MIT",
@@ -20,18 +20,18 @@
     "@js-toolkit/node-utils": "^1.2.1"
   },
   "devDependencies": {
-    "@eslint/compat": "^1.2.2",
-    "@eslint/eslintrc": "^3.1.0",
-    "@eslint/js": "^9.14.0",
-    "@js-toolkit/configs": "^3.93.11",
-    "@js-toolkit/utils": "^1.54.2",
+    "@eslint/compat": "^1.2.3",
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.15.0",
+    "@js-toolkit/configs": "^3.93.12",
+    "@js-toolkit/utils": "^1.54.7",
     "@types/eslint": "^9.6.1",
     "@types/eslint__eslintrc": "^2.1.2",
     "@types/eslint__js": "^8.42.3",
     "@types/lodash.throttle": "^4.1.9",
     "@types/uuid": "^10.0.0",
     "copyfiles": "^2.4.1",
-    "eslint": "^9.14.0",
+    "eslint": "^9.15.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-prettier": "^5.2.1",
@@ -42,8 +42,8 @@
     "rimraf": "^6.0.1",
     "terser": "^5.36.0",
     "typescript": "^5.6.3",
-    "typescript-eslint": "^8.14.0",
-    "ua-parser-js": "^2.0.0-rc.2",
+    "typescript-eslint": "^8.15.0",
+    "ua-parser-js": "^2.0.0",
     "uuid": "^11.0.3",
     "webpack": "^5.96.1",
     "yargs": "^17.7.2"

package/saveFileAs.d.ts

@@ -1 +1 @@
-export declare function saveFileAs(filename: string, url: string, attrs?: Record<string, string> | undefined): void;
+export declare function saveFileAs(filename: string, url: string, attrs?: Record<string, string>): void;