zcw-shared 1.22.0 → 1.24.0

package/references/eventsource.d.ts

@@ -0,0 +1,121 @@
+// EventSource (Server-Sent Events) 类型声明
+
+/**
+ * EventSource 连接状态
+ */
+export enum EventSourceReadyState {
+  CONNECTING = 0,
+  OPEN = 1,
+  CLOSED = 2
+}
+
+/**
+ * EventSource 事件接口
+ */
+export interface EventSourceEventMap {
+  open: Event
+  message: MessageEvent
+  error: Event
+}
+
+/**
+ * EventSource 消息事件
+ */
+export interface MessageEvent extends Event {
+  readonly data: string
+  readonly lastEventId: string
+  readonly origin: string
+}
+
+/**
+ * EventSource 配置选项
+ */
+export interface EventSourceInit {
+  withCredentials?: boolean
+}
+
+/**
+ * EventSource 构造函数类型
+ */
+export interface EventSourceConstructor {
+  new (url: string | URL, eventSourceInitDict?: EventSourceInit): EventSource
+  readonly CONNECTING: 0
+  readonly OPEN: 1
+  readonly CLOSED: 2
+}
+
+/**
+ * EventSource 实例接口
+ */
+export interface EventSource {
+  readonly url: string
+  readonly readyState: number
+  readonly withCredentials: boolean
+  
+  // 事件监听器
+  onopen: ((this: EventSource, ev: Event) => any) | null
+  onmessage: ((this: EventSource, ev: MessageEvent) => any) | null
+  onerror: ((this: EventSource, ev: Event) => any) | null
+  
+  // 方法
+  close(): void
+  addEventListener<K extends keyof EventSourceEventMap>(
+    type: K,
+    listener: (this: EventSource, ev: EventSourceEventMap[K]) => any,
+    options?: boolean | AddEventListenerOptions
+  ): void
+  addEventListener(
+    type: string,
+    listener: (this: EventSource, ev: MessageEvent) => any,
+    options?: boolean | AddEventListenerOptions
+  ): void
+  removeEventListener<K extends keyof EventSourceEventMap>(
+    type: K,
+    listener: (this: EventSource, ev: EventSourceEventMap[K]) => any,
+    options?: boolean | EventListenerOptions
+  ): void
+  removeEventListener(
+    type: string,
+    listener: (this: EventSource, ev: MessageEvent) => any,
+    options?: boolean | EventListenerOptions
+  ): void
+}
+
+/**
+ * 事件监听器选项
+ */
+export interface AddEventListenerOptions {
+  capture?: boolean
+  once?: boolean
+  passive?: boolean
+  signal?: AbortSignal
+}
+
+export interface EventListenerOptions {
+  capture?: boolean
+}
+
+/**
+ * 中止信号
+ */
+export interface AbortSignal {
+  readonly aborted: boolean
+  onabort: ((this: AbortSignal, ev: Event) => any) | null
+}
+
+/**
+ * 事件基础接口
+ */
+export interface Event {
+  readonly type: string
+  readonly target: any
+  readonly currentTarget: any
+  readonly bubbles: boolean
+  readonly cancelable: boolean
+  readonly defaultPrevented: boolean
+  readonly timeStamp: number
+  preventDefault(): void
+  stopPropagation(): void
+  stopImmediatePropagation(): void
+}
+

package/references/websocket.d.ts

@@ -0,0 +1,121 @@
+// WebSocket 类型声明
+
+/**
+ * WebSocket 连接状态
+ */
+export enum WebSocketReadyState {
+  CONNECTING = 0,
+  OPEN = 1,
+  CLOSING = 2,
+  CLOSED = 3
+}
+
+/**
+ * WebSocket 事件接口
+ */
+export interface WebSocketEventMap {
+  close: CloseEvent
+  error: Event
+  message: MessageEvent
+  open: Event
+}
+
+/**
+ * WebSocket 关闭事件
+ */
+export interface CloseEvent extends Event {
+  readonly code: number
+  readonly reason: string
+  readonly wasClean: boolean
+}
+
+/**
+ * WebSocket 消息事件
+ */
+export interface MessageEvent extends Event {
+  readonly data: any
+  readonly origin: string
+  readonly lastEventId: string
+}
+
+/**
+ * WebSocket 构造函数类型
+ */
+export interface WebSocketConstructor {
+  new (url: string | URL, protocols?: string | string[]): WebSocket
+  readonly CONNECTING: 0
+  readonly OPEN: 1
+  readonly CLOSING: 2
+  readonly CLOSED: 3
+}
+
+/**
+ * WebSocket 实例接口
+ */
+export interface WebSocket {
+  readonly url: string
+  readonly readyState: number
+  readonly bufferedAmount: number
+  readonly extensions: string
+  readonly protocol: string
+  binaryType: 'blob' | 'arraybuffer'
+  
+  // 事件监听器
+  onopen: ((this: WebSocket, ev: Event) => any) | null
+  onmessage: ((this: WebSocket, ev: MessageEvent) => any) | null
+  onerror: ((this: WebSocket, ev: Event) => any) | null
+  onclose: ((this: WebSocket, ev: CloseEvent) => any) | null
+  
+  // 方法
+  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void
+  close(code?: number, reason?: string): void
+  addEventListener<K extends keyof WebSocketEventMap>(
+    type: K,
+    listener: (this: WebSocket, ev: WebSocketEventMap[K]) => any,
+    options?: boolean | AddEventListenerOptions
+  ): void
+  removeEventListener<K extends keyof WebSocketEventMap>(
+    type: K,
+    listener: (this: WebSocket, ev: WebSocketEventMap[K]) => any,
+    options?: boolean | EventListenerOptions
+  ): void
+}
+
+/**
+ * 事件监听器选项
+ */
+export interface AddEventListenerOptions {
+  capture?: boolean
+  once?: boolean
+  passive?: boolean
+  signal?: AbortSignal
+}
+
+export interface EventListenerOptions {
+  capture?: boolean
+}
+
+/**
+ * 中止信号
+ */
+export interface AbortSignal {
+  readonly aborted: boolean
+  onabort: ((this: AbortSignal, ev: Event) => any) | null
+}
+
+/**
+ * 事件基础接口
+ */
+export interface Event {
+  readonly type: string
+  readonly target: any
+  readonly currentTarget: any
+  readonly bubbles: boolean
+  readonly cancelable: boolean
+  readonly defaultPrevented: boolean
+  readonly timeStamp: number
+  preventDefault(): void
+  stopPropagation(): void
+  stopImmediatePropagation(): void
+}
+

package/types/placement.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 基础定位方向类型
+ */
+export type BasePlacement = 'top' | 'right' | 'bottom' | 'left'
+
+/**
+ * 对齐方式类型
+ */
+export type Alignment = 'start' | 'end'
+
+/**
+ * 弹出层位置类型
+ */
+export type Placement = BasePlacement | `${BasePlacement}-${Alignment}`
+