@whitesev/pops/src/types/PopsDOMUtilsEventType.d.ts

弹窗库，包含了alert、confirm、prompt、drawer、folder、loading、iframe、panel、tooltip、searchSuggestion、rightClickMenu组件

export type PopsDOMUtilsEventObject<T extends Node> = Event & {
  target: T;
};

export type PopsDOMUtilsCreateElementAttributesMap = {
  style?: string;
  id?: string;
  class?: string;
  "data-"?: string;
  type?: string;
  [key: string]: any;
};
/**
 * 鼠标事件
 * + https://blog.csdn.net/weixin_68658847/article/details/126939879
 */

export interface PopsDOMUtils_MouseEvent {
  click: MouseEvent | 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 PopsDOMUtils_MouseEventType = keyof PopsDOMUtils_MouseEvent;
/**
 * 鼠标事件
 */
export interface PopsDOMUtils_KeyboardEvent {
  /** 键盘按下事件 */
  keydown: KeyboardEvent;
  /**
   * 键盘按压事件(字符键)
   *
   * @link https://developer.mozilla.org/zh-CN/docs/Web/API/Element/keypress_event
   * @deprecated
   */
  keypress: KeyboardEvent;
  /** 键盘释放事件 */
  keyup: KeyboardEvent;
}
export type PopsDOMUtils_KeyboardEventType = keyof PopsDOMUtils_KeyboardEvent;
/**
 * 框架/对象事件
 */
export interface PopsDOMUtils_Frame_Object_Event {
  abort: Event;
  beforeunload: Event;
  error: Event;
  hashchange: Event;
  load: Event;
  pageshow: Event;
  pagehide: Event;
  resize: Event;
  scroll: Event;
  unload: Event;
}
export type PopsDOMUtils_Frame_Object_EventType = keyof PopsDOMUtils_Frame_Object_Event;
/**
 * 表单事件
 */
export interface PopsDOMUtils_FormEvent {
  blur: Event;
  change: Event;
  focus: Event;
  focusin: Event;
  focusout: Event;
  input: Event;
  reset: Event;
  search: Event;
}
export type PopsDOMUtils_FormEventType = keyof PopsDOMUtils_FormEvent;

/**
 * 剪贴板事件
 */
export interface PopsDOMUtils_ClipboardEvent {
  copy: ClipboardEvent;
  cut: ClipboardEvent;
  paste: ClipboardEvent;
}
export type PopsDOMUtils_ClipboardEventType = keyof PopsDOMUtils_ClipboardEvent;

/**
 * 打印事件
 */
export interface PopsDOMUtils_PrintEvent {
  afterprint: Event;
  beforeprint: Event;
}
export type PopsDOMUtils_PrintEventType = keyof PopsDOMUtils_PrintEvent;

/**
 * 拖动事件
 */
export interface PopsDOMUtils_DragEvent {
  drag: DragEvent;
  dragend: DragEvent;
  dragenter: DragEvent;
  dragleave: DragEvent;
  dragover: DragEvent;
  dragstart: DragEvent;
  drop: DragEvent;
}
export type PopsDOMUtils_DragEventType = keyof PopsDOMUtils_DragEvent;

/**
 * 多媒体（Media）事件
 */
export interface PopsDOMUtils_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;
}
export type PopsDOMUtils_MediaEventType = keyof PopsDOMUtils_MediaEvent;

/**
 * 动画事件
 */
export interface PopsDOMUtils_AnimationEvent {
  animationend: AnimationEvent;
  animationiteration: AnimationEvent;
  animationstart: AnimationEvent;
}
export type PopsDOMUtils_AnimationEventType = keyof PopsDOMUtils_AnimationEvent;

/**
 * 过渡事件
 */
export interface PopsDOMUtils_TransitionEvent {
  transitionend: TransitionEvent;
}
export type PopsDOMUtils_TransitionEventType = keyof PopsDOMUtils_TransitionEvent;

/**
 * 触摸事件
 */
export interface PopsDOMUtils_TouchEvent {
  touchstart: TouchEvent;
  touchmove: TouchEvent;
  touchend: TouchEvent;
  touchcancel: TouchEvent;
  touchenter: TouchEvent;
  touchleave: TouchEvent;
}
export type PopsDOMUtils_TouchEventType = keyof PopsDOMUtils_TouchEvent;
/**
 * 其它事件
 */
export interface PopsDOMUtils_OtherEvent {
  message: Event;
  online: Event;
  offline: Event;
  popstate: Event;
  show: Event;
  storage: Event;
  toggle: Event;
  wheel: Event;
  propertychange: Event;
  fullscreenchange: Event;
  DOMContentLoaded: Event;
}
export type PopsDOMUtils_OtherEventType = keyof PopsDOMUtils_OtherEvent;

/**
 * 全部事件
 */
export type PopsDOMUtils_Event = PopsDOMUtils_MouseEvent &
  PopsDOMUtils_KeyboardEvent &
  PopsDOMUtils_Frame_Object_Event &
  PopsDOMUtils_FormEvent &
  PopsDOMUtils_ClipboardEvent &
  PopsDOMUtils_PrintEvent &
  PopsDOMUtils_DragEvent &
  PopsDOMUtils_MediaEvent &
  PopsDOMUtils_AnimationEvent &
  PopsDOMUtils_TransitionEvent &
  PopsDOMUtils_TouchEvent &
  PopsDOMUtils_OtherEvent;

/**
 * 事件类型
 */
export type PopsDOMUtils_EventType = keyof PopsDOMUtils_Event;

/**
 * 元素上的events属性
 */
export declare interface PopsDOMUtilsEventListenerOptionsAttribute {
  /**
   * DOMUtils的handlerCallBack，元素上的监听事件就是它，移除事件时也需要传入这个函数
   */
  handlerCallBack: (event: Event, $selector?: HTMLElement) => void;
  /**
   * 属性配置
   */
  option: PopsDOMUtilsEventListenerOption;
  /**
   * 用户添加的事件
   */
  callback: (event: Event, $selector?: HTMLElement) => void;
  /**
   * 子元素选择器
   */
  selector?: string[];
}

export type PopsDOMUtilsElementEventType =
  | HTMLElement
  | string
  | NodeList
  | (HTMLElement | Window | Document | Element | typeof globalThis)[]
  | Window
  | Document
  | Element
  | null
  | typeof globalThis
  | ShadowRoot
  | EventTarget
  | ChildNode
  | Node;

/**
 * 通过.on执行后的返回值
 */
export declare interface PopsDOMUtilsAddEventListenerResult {
  /**
   * 取消绑定的监听事件
   * @param filter (可选)过滤函数，对元素属性上的事件进行过滤出想要删除的事件
   */
  off(
    filter?: (
      value: PopsDOMUtilsEventListenerOptionsAttribute,
      index: number,
      array: PopsDOMUtilsEventListenerOptionsAttribute[]
    ) => boolean
  ): void;
  /**
   * 主动触发事件
   * @param details 赋予触发的Event的额外属性，如果是Event类型，那么将自动代替默认new的Event对象
   * @param useDispatchToEmit 是否使用dispatchEvent来触发事件，默认true，如果为false，则直接调用callback，但是这种会让使用了selectorTarget的没有值
   */
  emit(details?: object, useDispatchToEmit?: boolean): void;
}
export type ParseHTMLReturnType<T1, T2> = T1 extends true ? (T2 extends true ? Document : HTMLElement) : HTMLElement;

/**
 * 事件的额外配置
 */
export declare type PopsDOMUtilsEventListenerOption = AddEventListenerOptions & {
  /**
   * 前提：传入了`selector`参数
   *
   * 是否使用 event.composedPath() 来代替 event.target
   * @default false
   */
  isComposedPath?: boolean;
  /**
   * 前提：传入了`selector`参数
   *
   * 是否覆写`target`，仅传入了子元素的`selectorTarget`时才会生效
   *
   * 原始的`target`将命名为`originTarget`
   * @default true
   */
  overrideTarget?: boolean;
  /**
   * 是否阻止事件传播，包括阻止默认行为
   * @default false
   */
  isPreventEvent?: boolean;
};

export type PopsDOMUtilsTargetElementType = IArray<HTMLElement> | string | NodeList;

/**
 * 属性转驼峰
 */
export type PopsDOMUtilsCamelToKebabCSSProperty<S extends string> = S extends `webkit${infer U}`
  ? `-${Lowercase<"webkit">}${U extends `${infer First}${infer Rest}`
      ? First extends Uppercase<First>
        ? `-${Uncapitalize<First>}${PopsDOMUtilsCamelToKebabCSSProperty<Rest>}`
        : `${First}${PopsDOMUtilsCamelToKebabCSSProperty<Rest>}`
      : U}`
  : S extends `${infer T}${infer U}`
    ? U extends Uncapitalize<U>
      ? `${Uncapitalize<T>}${PopsDOMUtilsCamelToKebabCSSProperty<U>}`
      : `${Uncapitalize<T>}-${PopsDOMUtilsCamelToKebabCSSProperty<U>}`
    : S;

export type PopsDOMUtilsCSSPropertyType = PopsDOMUtilsCamelToKebabCSSProperty<
  Extract<
    keyof Omit<
      CSSStyleDeclaration,
      | "cssFloat"
      | "cssText"
      | "length"
      | "parentRule"
      | "getPropertyPriority"
      | "getPropertyValue"
      | "item"
      | "removeProperty"
      | "setProperty"
    >,
    string
  >
>;

export type PopsDOMUtilsCSSProperty = {
  [P in PopsDOMUtilsCSSPropertyType]: string | number;
};