@whitesev/domutils 1.6.6 → 1.6.7

package/dist/types/src/DOMUtilsEvent.d.ts

@@ -171,7 +171,7 @@ export declare class DOMUtilsEvent {
      *   console.log("文档加载完毕")
      * })
      */
-    ready<T extends Function>(callback: T): void;
+    ready<T extends (...args: any[]) => any>(callback: T): void;
     /**
      * 主动触发事件
      * @param element 需要触发的元素|元素数组|window
@@ -329,68 +329,68 @@ export declare class DOMUtilsEvent {
      */
     keypress(element: DOMUtilsTargetElementType | Element | DocumentFragment | Window | Node | typeof globalThis, handler: (this: HTMLElement, event: DOMUtils_Event["keypress"]) => void, option?: boolean | DOMUtilsEventListenerOption): void;
     /**
-     * 监听某个元素键盘按键事件或window全局按键事件
-     * 按下有值的键时触发，按下Ctrl\Alt\Shift\Meta是无值键。按下先触发keydown事件，再触发keypress事件。
-     * @param element 需要监听的对象，可以是全局Window或者某个元素
-     * @param eventName 事件名，默认keypress
-     * @param callback 自己定义的回调事件，参数1为当前的key，参数2为组合按键，数组类型，包含ctrl、shift、alt和meta（win键或mac的cmd键）
-     * @param options 监听事件的配置
-     * @example
-        Utils.listenKeyboard(window,(keyName,keyValue,otherKey,event)=>{
-            if(keyName === "Enter"){
-                console.log("回车按键的值是："+keyValue)
+       * 监听某个元素键盘按键事件或window全局按键事件
+       * 按下有值的键时触发，按下Ctrl\Alt\Shift\Meta是无值键。按下先触发keydown事件，再触发keypress事件。
+       * @param element 需要监听的对象，可以是全局Window或者某个元素
+       * @param eventName 事件名，默认keypress
+       * @param callback 自己定义的回调事件，参数1为当前的key，参数2为组合按键，数组类型，包含ctrl、shift、alt和meta（win键或mac的cmd键）
+       * @param options 监听事件的配置
+       * @example
+          Utils.listenKeyboard(window,(keyName,keyValue,otherKey,event)=>{
+              if(keyName === "Enter"){
+                  console.log("回车按键的值是："+keyValue)
+              }
+              if(otherKey.indexOf("ctrl") && keyName === "Enter" ){
+                  console.log("Ctrl和回车键");
             }
-            if(otherKey.indexOf("ctrl") && keyName === "Enter" ){
-                console.log("Ctrl和回车键");
-          }
-        })
-     * @example
-    字母和数字键的键码值(keyCode)
-      按键	键码	按键	键码	按键	键码	按键	键码
-      A	65	J	74	S	83	1	49
-      B	66	K	75	T	84	2	50
-      C	67	L	76	U	85	3	51
-      D	68	M	77	V	86	4	52
-      E	69	N	78	W	87	5	53
-      F	70	O	79	X	88	6	54
-      G	71	P	80	Y	89	7	55
-      H	72	Q	81	Z	90	8	56
-      I	73	R	82	0	48	9	57
-  
-      数字键盘上的键的键码值(keyCode)
-      功能键键码值(keyCode)
-      按键	键码	按键  	键码	按键	键码	按键	键码
-      0	96	8	104	F1	112	F7	118
-      1	97	9	105	F2	113	F8	119
-      2	98	*	106	F3	114	F9	120
-      3	99	+	107	F4	115	F10	121
-      4	100	Enter	108	F5	116	F11	122
-      5	101	-	109	F6	117	F12	123
-      6	102	.	110
-      7	103	/	111
-      
-      控制键键码值(keyCode)
-      按键		键码	按键		键码	按键		键码	按键		键码
-      BackSpace	8	Esc		27	→		39	-_		189
-      Tab		9	Spacebar	32	↓		40	.>		190
-      Clear		12	Page Up		33	Insert		45	/?		191
-      Enter		13	Page Down	34	Delete		46	`~		192
-      Shift		16	End		35	Num Lock	144	[{		219
-      Control		17	Home		36	;:		186	\|		220
-      Alt		18	←		37	=+		187	]}		221
-      Cape Lock	20	↑		38	,<		188	'"		222
-  
-      多媒体键码值(keyCode)
-      按键		键码
-      音量加		175
-      音量减		174
-      停止		179
-      静音		173
-      浏览器		172
-      邮件		180
-      搜索		170
-      收藏		171
-     **/
+          })
+       * @example
+      字母和数字键的键码值(keyCode)
+        按键	键码	按键	键码	按键	键码	按键	键码
+        A	65	J	74	S	83	1	49
+        B	66	K	75	T	84	2	50
+        C	67	L	76	U	85	3	51
+        D	68	M	77	V	86	4	52
+        E	69	N	78	W	87	5	53
+        F	70	O	79	X	88	6	54
+        G	71	P	80	Y	89	7	55
+        H	72	Q	81	Z	90	8	56
+        I	73	R	82	0	48	9	57
+    
+        数字键盘上的键的键码值(keyCode)
+        功能键键码值(keyCode)
+        按键	键码	按键  	键码	按键	键码	按键	键码
+        0	96	8	104	F1	112	F7	118
+        1	97	9	105	F2	113	F8	119
+        2	98	*	106	F3	114	F9	120
+        3	99	+	107	F4	115	F10	121
+        4	100	Enter	108	F5	116	F11	122
+        5	101	-	109	F6	117	F12	123
+        6	102	.	110
+        7	103	/	111
+        
+        控制键键码值(keyCode)
+        按键		键码	按键		键码	按键		键码	按键		键码
+        BackSpace	8	Esc		27	→		39	-_		189
+        Tab		9	Spacebar	32	↓		40	.>		190
+        Clear		12	Page Up		33	Insert		45	/?		191
+        Enter		13	Page Down	34	Delete		46	`~		192
+        Shift		16	End		35	Num Lock	144	[{		219
+        Control		17	Home		36	;:		186	\|		220
+        Alt		18	←		37	=+		187	]}		221
+        Cape Lock	20	↑		38	,<		188	'"		222
+    
+        多媒体键码值(keyCode)
+        按键		键码
+        音量加		175
+        音量减		174
+        停止		179
+        静音		173
+        浏览器		172
+        邮件		180
+        搜索		170
+        收藏		171
+       **/
     listenKeyboard(element: DOMUtilsTargetElementType | Element | DocumentFragment | Window | Node | typeof globalThis, eventName: "keyup" | "keypress" | "keydown" | undefined, callback: (keyName: string, keyValue: number, otherCodeList: string[], event: KeyboardEvent) => void, options?: DOMUtilsEventListenerOption | boolean): {
         removeListen(): void;
     };

package/dist/types/src/types/DOMUtilsEvent.d.ts

@@ -1,14 +1,14 @@
 export type DOMUtilsEventObject<T extends Node> = Event & {
-	target: T;
+  target: T;
 };
 
 export type DOMUtilsCreateElementAttributesMap = {
-	style?: string;
-	id?: string;
-	class?: string;
-	"data-"?: string;
-	type?: string;
-	[key: string]: any;
+  style?: string;
+  id?: string;
+  class?: string;
+  "data-"?: string;
+  type?: string;
+  [key: string]: any;
 };
 /**
  * 鼠标事件
@@ -16,57 +16,57 @@ export type DOMUtilsCreateElementAttributesMap = {
  */
 
 export interface DOMUtils_MouseEvent {
-	click: MouseEvent | PointerEvent;
-	auxclick: PointerEvent;
-	contextmenu: MouseEvent | PointerEvent;
-	dblclick: MouseEvent | PointerEvent;
-	mousedown: MouseEvent | PointerEvent;
-	mouseenter: MouseEvent | PointerEvent;
-	mouseleave: MouseEvent | PointerEvent;
-	mousemove: MouseEvent | PointerEvent;
-	mouseover: MouseEvent | PointerEvent;
-	mouseout: MouseEvent | PointerEvent;
-	mouseup: MouseEvent | PointerEvent;
-	hover: MouseEvent;
+  click: MouseEvent | PointerEvent;
+  auxclick: PointerEvent;
+  contextmenu: MouseEvent | PointerEvent;
+  dblclick: MouseEvent | PointerEvent;
+  mousedown: MouseEvent | PointerEvent;
+  mouseenter: MouseEvent | PointerEvent;
+  mouseleave: MouseEvent | PointerEvent;
+  mousemove: MouseEvent | PointerEvent;
+  mouseover: MouseEvent | PointerEvent;
+  mouseout: MouseEvent | PointerEvent;
+  mouseup: MouseEvent | PointerEvent;
+  hover: MouseEvent;
 }
 export type DOMUtils_MouseEventType = keyof DOMUtils_MouseEvent;
 /**
  * 鼠标事件
  */
 export interface DOMUtils_KeyboardEvent {
-	keydown: KeyboardEvent;
-	keypress: KeyboardEvent;
-	keyup: KeyboardEvent;
+  keydown: KeyboardEvent;
+  keypress: KeyboardEvent;
+  keyup: KeyboardEvent;
 }
 export type DOMUtils_KeyboardEventType = keyof DOMUtils_KeyboardEvent;
 /**
  * 框架/对象事件
  */
 export interface DOMUtils_Frame_Object_Event {
-	abort: Event;
-	beforeunload: Event;
-	error: Event;
-	hashchange: Event;
-	load: Event;
-	pageshow: Event;
-	pagehide: Event;
-	resize: Event;
-	scroll: Event;
-	unload: Event;
+  abort: Event;
+  beforeunload: Event;
+  error: Event;
+  hashchange: Event;
+  load: Event;
+  pageshow: Event;
+  pagehide: Event;
+  resize: Event;
+  scroll: Event;
+  unload: Event;
 }
 export type DOMUtils_Frame_Object_EventType = keyof DOMUtils_Frame_Object_Event;
 /**
  * 表单事件
  */
 export interface DOMUtils_FormEvent {
-	blur: Event;
-	change: Event;
-	focus: Event;
-	focusin: Event;
-	focusout: Event;
-	input: Event;
-	reset: Event;
-	search: Event;
+  blur: Event;
+  change: Event;
+  focus: Event;
+  focusin: Event;
+  focusout: Event;
+  input: Event;
+  reset: Event;
+  search: Event;
 }
 export type DOMUtils_FormEventType = keyof DOMUtils_FormEvent;
 
@@ -74,9 +74,9 @@ export type DOMUtils_FormEventType = keyof DOMUtils_FormEvent;
  * 剪贴板事件
  */
 export interface DOMUtils_ClipboardEvent {
-	copy: ClipboardEvent;
-	cut: ClipboardEvent;
-	paste: ClipboardEvent;
+  copy: ClipboardEvent;
+  cut: ClipboardEvent;
+  paste: ClipboardEvent;
 }
 export type DOMUtils_ClipboardEventType = keyof DOMUtils_ClipboardEvent;
 
@@ -84,8 +84,8 @@ export type DOMUtils_ClipboardEventType = keyof DOMUtils_ClipboardEvent;
  * 打印事件
  */
 export interface DOMUtils_PrintEvent {
-	afterprint: Event;
-	beforeprint: Event;
+  afterprint: Event;
+  beforeprint: Event;
 }
 export type DOMUtils_PrintEventType = keyof DOMUtils_PrintEvent;
 
@@ -93,13 +93,13 @@ export type DOMUtils_PrintEventType = keyof DOMUtils_PrintEvent;
  * 拖动事件
  */
 export interface DOMUtils_DragEvent {
-	drag: DragEvent;
-	dragend: DragEvent;
-	dragenter: DragEvent;
-	dragleave: DragEvent;
-	dragover: DragEvent;
-	dragstart: DragEvent;
-	drop: DragEvent;
+  drag: DragEvent;
+  dragend: DragEvent;
+  dragenter: DragEvent;
+  dragleave: DragEvent;
+  dragover: DragEvent;
+  dragstart: DragEvent;
+  drop: DragEvent;
 }
 export type DOMUtils_DragEventType = keyof DOMUtils_DragEvent;
 
@@ -107,28 +107,28 @@ export type DOMUtils_DragEventType = keyof DOMUtils_DragEvent;
  * 多媒体（Media）事件
  */
 export interface DOMUtils_MediaEvent {
-	abort: Event;
-	canplay: Event;
-	canplaythrough: Event;
-	durationchange: Event;
-	emptied: Event;
-	ended: Event;
-	error: Event;
-	loadeddata: Event;
-	loadedmetadata: Event;
-	loadstart: Event;
-	pause: Event;
-	play: Event;
-	playing: Event;
-	progress: Event;
-	ratechange: Event;
-	seeked: Event;
-	seeking: Event;
-	stalled: Event;
-	suspend: Event;
-	timeupdate: Event;
-	volumechange: Event;
-	waiting: Event;
+  abort: Event;
+  canplay: Event;
+  canplaythrough: Event;
+  durationchange: Event;
+  emptied: Event;
+  ended: Event;
+  error: Event;
+  loadeddata: Event;
+  loadedmetadata: Event;
+  loadstart: Event;
+  pause: Event;
+  play: Event;
+  playing: Event;
+  progress: Event;
+  ratechange: Event;
+  seeked: Event;
+  seeking: Event;
+  stalled: Event;
+  suspend: Event;
+  timeupdate: Event;
+  volumechange: Event;
+  waiting: Event;
 }
 export type DOMUtils_MediaEventType = keyof DOMUtils_MediaEvent;
 
@@ -136,9 +136,9 @@ export type DOMUtils_MediaEventType = keyof DOMUtils_MediaEvent;
  * 动画事件
  */
 export interface DOMUtils_AnimationEvent {
-	animationend: AnimationEvent;
-	animationiteration: AnimationEvent;
-	animationstart: AnimationEvent;
+  animationend: AnimationEvent;
+  animationiteration: AnimationEvent;
+  animationstart: AnimationEvent;
 }
 export type DOMUtils_AnimationEventType = keyof DOMUtils_AnimationEvent;
 
@@ -146,7 +146,7 @@ export type DOMUtils_AnimationEventType = keyof DOMUtils_AnimationEvent;
  * 过渡事件
  */
 export interface DOMUtils_TransitionEvent {
-	transitionend: TransitionEvent;
+  transitionend: TransitionEvent;
 }
 export type DOMUtils_TransitionEventType = keyof DOMUtils_TransitionEvent;
 
@@ -154,29 +154,29 @@ export type DOMUtils_TransitionEventType = keyof DOMUtils_TransitionEvent;
  * 触摸事件
  */
 export interface DOMUtils_TouchEvent {
-	touchstart: TouchEvent;
-	touchmove: TouchEvent;
-	touchend: TouchEvent;
-	touchcancel: TouchEvent;
-	touchenter: TouchEvent;
-	touchleave: TouchEvent;
+  touchstart: TouchEvent;
+  touchmove: TouchEvent;
+  touchend: TouchEvent;
+  touchcancel: TouchEvent;
+  touchenter: TouchEvent;
+  touchleave: TouchEvent;
 }
 export type DOMUtils_TouchEventType = keyof DOMUtils_TouchEvent;
 /**
  * 其它事件
  */
 export interface DOMUtils_OtherEvent {
-	message: Event;
-	online: Event;
-	offline: Event;
-	popstate: Event;
-	show: Event;
-	storage: Event;
-	toggle: Event;
-	wheel: Event;
-	propertychange: Event;
-	fullscreenchange: Event;
-	DOMContentLoaded: Event;
+  message: Event;
+  online: Event;
+  offline: Event;
+  popstate: Event;
+  show: Event;
+  storage: Event;
+  toggle: Event;
+  wheel: Event;
+  propertychange: Event;
+  fullscreenchange: Event;
+  DOMContentLoaded: Event;
 }
 export type DOMUtils_OtherEventType = keyof DOMUtils_OtherEvent;
 
@@ -184,17 +184,17 @@ export type DOMUtils_OtherEventType = keyof DOMUtils_OtherEvent;
  * 全部事件
  */
 export declare type DOMUtils_Event = DOMUtils_MouseEvent &
-	DOMUtils_KeyboardEvent &
-	DOMUtils_Frame_Object_Event &
-	DOMUtils_FormEvent &
-	DOMUtils_ClipboardEvent &
-	DOMUtils_PrintEvent &
-	DOMUtils_DragEvent &
-	DOMUtils_MediaEvent &
-	DOMUtils_AnimationEvent &
-	DOMUtils_TransitionEvent &
-	DOMUtils_TouchEvent &
-	DOMUtils_OtherEvent;
+  DOMUtils_KeyboardEvent &
+  DOMUtils_Frame_Object_Event &
+  DOMUtils_FormEvent &
+  DOMUtils_ClipboardEvent &
+  DOMUtils_PrintEvent &
+  DOMUtils_DragEvent &
+  DOMUtils_MediaEvent &
+  DOMUtils_AnimationEvent &
+  DOMUtils_TransitionEvent &
+  DOMUtils_TouchEvent &
+  DOMUtils_OtherEvent;
 
 /**
  * 事件类型
@@ -205,47 +205,47 @@ export declare type DOMUtils_EventType = keyof DOMUtils_Event;
  * 元素上的events属性
  */
 export declare interface DOMUtilsEventListenerOptionsAttribute {
-	/**
-	 * DOMUtils的ownCallBack，元素上的监听事件就是它，移除事件时也需要传入这个函数
-	 */
-	callback: (event: Event) => void;
-	/**
-	 * 属性配置
-	 */
-	option: DOMUtilsEventListenerOption;
-	/**
-	 * 用户添加的事件
-	 */
-	originCallBack: (event: Event, selectorTarget?: HTMLElement) => void;
-	/**
-	 * 子元素选择器
-	 */
-	selector?: string[];
+  /**
+   * DOMUtils的ownCallBack，元素上的监听事件就是它，移除事件时也需要传入这个函数
+   */
+  callback: (event: Event) => void;
+  /**
+   * 属性配置
+   */
+  option: DOMUtilsEventListenerOption;
+  /**
+   * 用户添加的事件
+   */
+  originCallBack: (event: Event, selectorTarget?: HTMLElement) => void;
+  /**
+   * 子元素选择器
+   */
+  selector?: string[];
 }
 
 /**
  * 事件的额外配置
  */
 export declare type DOMUtilsEventListenerOption = AddEventListenerOptions & {
-	/**
-	 * 是否使用 event.composedPath() 来代替 event.target
-	 *
-	 * 一般用于设置了selector参数
-	 */
-	isComposedPath?: boolean;
+  /**
+   * 是否使用 event.composedPath() 来代替 event.target
+   *
+   * 一般用于设置了selector参数
+   */
+  isComposedPath?: boolean;
 };
 export declare type DOMUtilsElementEventType =
-	| HTMLElement
-	| string
-	| NodeList
-	| (HTMLElement | Window | Document | Element | typeof globalThis)[]
-	| Window
-	| Document
-	| Element
-	| null
-	| typeof globalThis
-	| ShadowRoot
-	| EventTarget
-	| ChildNode
-	| Node
-	| DocumentFragment;
+  | HTMLElement
+  | string
+  | NodeList
+  | (HTMLElement | Window | Document | Element | typeof globalThis)[]
+  | Window
+  | Document
+  | Element
+  | null
+  | typeof globalThis
+  | ShadowRoot
+  | EventTarget
+  | ChildNode
+  | Node
+  | DocumentFragment;

package/dist/types/src/types/WindowApi.d.ts

@@ -2,13 +2,13 @@
  * 配置类型
  */
 export type WindowApiOption = {
-	document: Document;
-	window: Window & typeof globalThis;
-	globalThis?: typeof globalThis | Window;
-	self?: Window & typeof globalThis;
-	top: Window;
-	setTimeout: typeof setTimeout;
-	clearTimeout: typeof clearTimeout;
-	setInterval: typeof setInterval;
-	clearInterval: typeof clearInterval;
+  document: Document;
+  window: Window & typeof globalThis;
+  globalThis?: typeof globalThis | Window;
+  self?: Window & typeof globalThis;
+  top: Window;
+  setTimeout: typeof setTimeout;
+  clearTimeout: typeof clearTimeout;
+  setInterval: typeof setInterval;
+  clearInterval: typeof clearInterval;
 };

package/dist/types/src/types/global.d.ts

@@ -1,11 +1,3 @@
-export type ParseHTMLReturnType<T1, T2> = T1 extends true
-	? T2 extends true
-		? Document
-		: HTMLElement
-	: HTMLElement;
+export type ParseHTMLReturnType<T1, T2> = T1 extends true ? (T2 extends true ? Document : HTMLElement) : HTMLElement;
 
-export type DOMUtilsTargetElementType =
-	| HTMLElement
-	| string
-	| NodeList
-	| HTMLElement[];
+export type DOMUtilsTargetElementType = HTMLElement | string | NodeList | HTMLElement[];

package/dist/types/src/types/gm.d.ts

@@ -1,2 +1,6 @@
 /** GM中的unsafeWindow */
-declare var unsafeWindow: Window & typeof globalThis;
+declare const unsafeWindow: Window & typeof globalThis;
+
+declare interface Window {
+  trustedTypes: any;
+}

package/index.ts

@@ -0,0 +1,3 @@
+import { DOMUtils } from "./src/DOMUtils";
+
+export default DOMUtils;

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@whitesev/domutils",
-  "version": "1.6.6",
+  "version": "1.6.7",
   "type": "module",
   "description": "使用js重新对jQuery的部分函数进行了仿写",
   "main": "dist/index.cjs.js",
@@ -19,7 +19,8 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "./index.ts"
   ],
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
@@ -34,18 +35,29 @@
     "worker-timers": "^8.0.23"
   },
   "devDependencies": {
+    "@eslint/js": "^9.36.0",
     "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-typescript": "^12.1.2",
+    "browserslist": "^4.26.2",
+    "caniuse-lite": "^1.0.30001743",
+    "eslint": "^9.36.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-compat": "^6.0.2",
+    "eslint-plugin-prettier": "^5.5.4",
+    "globals": "^16.4.0",
     "rollup": "^4.44.1",
     "rollup-plugin-clear": "^2.0.7",
     "tslib": "^2.8.1",
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.44.0"
   },
   "scripts": {
-    "dev": "rollup --config --watch",
-    "build": "rollup --config",
-    "build:all": "rollup --config",
-    "build:all-new": "rollup --config"
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier . --write",
+    "dev": "pnpm run format && pnpm run lint && rollup -c -w",
+    "build": "pnpm run format && pnpm run lint && rollup -c"
   }
 }