zcw-shared 1.22.0 → 1.24.0

package/dist/reactive/useReactiveSSE.js

@@ -0,0 +1,212 @@
+export var SSEStatus;
+(function (SSEStatus) {
+    SSEStatus["CONNECTING"] = "CONNECTING";
+    SSEStatus["CONNECTED"] = "CONNECTED";
+    SSEStatus["DISCONNECTED"] = "DISCONNECTED";
+    SSEStatus["ERROR"] = "ERROR";
+})(SSEStatus || (SSEStatus = {}));
+export function useReactiveSSE(url, options = {}, deps) {
+    const defaultOptions = {
+        withCredentials: false,
+        immediate: true,
+        reconnect: {
+            enabled: true,
+            delay: 3000,
+            maxRetries: 5,
+            retryDelayMultiplier: 1.5
+        },
+        onConnected: () => { },
+        onDisconnected: () => { },
+        onError: () => { },
+        onMessage: () => { }
+    };
+    const config = { ...defaultOptions, ...options };
+    if (options.reconnect) {
+        config.reconnect = { ...defaultOptions.reconnect, ...options.reconnect };
+    }
+    const state = {
+        status: SSEStatus.DISCONNECTED,
+        data: null,
+        lastEventId: '',
+        error: null,
+        retryCount: 0,
+        es: null
+    };
+    const subscribers = new Set();
+    const notify = () => {
+        subscribers.forEach(listener => listener());
+    };
+    let reconnectTimer = null;
+    let isManualClose = false;
+    let isReconnecting = false;
+    const customListeners = new Map();
+    const clearReconnect = () => {
+        if (reconnectTimer !== null) {
+            deps.clearTimeout(reconnectTimer);
+            reconnectTimer = null;
+        }
+    };
+    const attemptReconnect = () => {
+        deps.log?.(`[SSE-重连] 尝试重连: enabled=${config.reconnect.enabled}, isManualClose=${isManualClose}, isReconnecting=${isReconnecting}`);
+        if (!config.reconnect.enabled || isManualClose || isReconnecting) {
+            deps.log?.('[SSE-重连] 跳过重连');
+            return;
+        }
+        const maxRetries = config.reconnect.maxRetries || 0;
+        if (maxRetries > 0 && state.retryCount >= maxRetries) {
+            deps.log?.(`[SSE-重连] 已达到最大重连次数 ${maxRetries}`);
+            state.status = SSEStatus.ERROR;
+            state.error = new Error(`重连失败：已达到最大重连次数 ${maxRetries}`);
+            notify();
+            isReconnecting = false;
+            return;
+        }
+        const delay = (config.reconnect.delay || 3000) * Math.pow(config.reconnect.retryDelayMultiplier || 1, state.retryCount);
+        deps.log?.(`[SSE-重连] 将在 ${delay}ms 后重连（第 ${state.retryCount + 1} 次）`);
+        isReconnecting = true;
+        clearReconnect();
+        state.status = SSEStatus.CONNECTING;
+        notify();
+        reconnectTimer = deps.setTimeout(() => {
+            state.retryCount++;
+            deps.log?.(`[SSE-重连] 开始第 ${state.retryCount} 次重连`);
+            try {
+                connect();
+            }
+            finally {
+                isReconnecting = false;
+            }
+        }, delay);
+    };
+    const connect = () => {
+        if (state.es && state.es.readyState !== deps.EventSource.CLOSED) {
+            deps.log?.('[SSE] 已有活跃连接，跳过');
+            return;
+        }
+        isManualClose = false;
+        state.status = SSEStatus.CONNECTING;
+        state.error = null;
+        notify();
+        try {
+            const eventSourceInit = config.withCredentials
+                ? { withCredentials: true }
+                : undefined;
+            const es = new deps.EventSource(url, eventSourceInit);
+            es.onopen = (event) => {
+                if (isManualClose) {
+                    deps.log?.('[SSE] 连接建立但已标记为手动关闭，忽略');
+                    es.close();
+                    return;
+                }
+                deps.log?.('[SSE] 连接成功');
+                state.status = SSEStatus.CONNECTED;
+                state.error = null;
+                state.retryCount = 0;
+                state.es = es;
+                customListeners.forEach((listeners, eventType) => {
+                    listeners.forEach(listener => {
+                        deps.log?.(`[SSE] 注册事件监听器: ${eventType}`);
+                        es.addEventListener(eventType, listener);
+                    });
+                });
+                notify();
+                config.onConnected(es);
+            };
+            es.onmessage = (event) => {
+                deps.log?.('[SSE] 收到消息:', event.data);
+                state.data = event.data;
+                state.lastEventId = event.lastEventId;
+                notify();
+                config.onMessage(es, event);
+            };
+            es.onerror = (event) => {
+                deps.log?.('[SSE] 连接错误');
+                state.error = new Error('SSE 连接错误');
+                notify();
+                config.onError(es, event);
+                if (es.readyState === deps.EventSource.CLOSED) {
+                    deps.log?.('[SSE] 连接已关闭');
+                    if (state.es === es) {
+                        state.status = SSEStatus.DISCONNECTED;
+                        state.es = null;
+                        notify();
+                    }
+                    config.onDisconnected(es, event);
+                    if (!isManualClose && !isReconnecting) {
+                        attemptReconnect();
+                    }
+                }
+            };
+        }
+        catch (error) {
+            deps.log?.('[SSE] 创建连接失败:', error);
+            state.status = SSEStatus.ERROR;
+            state.error = error instanceof Error ? error : new Error('SSE 创建失败');
+            notify();
+            attemptReconnect();
+        }
+    };
+    const disconnect = () => {
+        deps.log?.('[SSE] 手动断开连接');
+        isManualClose = true;
+        isReconnecting = false;
+        clearReconnect();
+        const es = state.es;
+        if (es) {
+            state.es = null;
+            try {
+                es.close();
+            }
+            catch (error) {
+                deps.log?.('[SSE] 关闭连接失败（忽略）:', error);
+            }
+        }
+        state.status = SSEStatus.DISCONNECTED;
+        state.retryCount = 0;
+        notify();
+    };
+    const addEventListener = (type, listener) => {
+        if (!customListeners.has(type)) {
+            customListeners.set(type, new Set());
+        }
+        customListeners.get(type).add(listener);
+        if (state.es) {
+            state.es.addEventListener(type, listener);
+        }
+        return () => {
+            const listeners = customListeners.get(type);
+            if (listeners) {
+                listeners.delete(listener);
+                if (listeners.size === 0) {
+                    customListeners.delete(type);
+                }
+            }
+            if (state.es) {
+                state.es.removeEventListener(type, listener);
+            }
+        };
+    };
+    const subscribe = (listener) => {
+        subscribers.add(listener);
+        return () => subscribers.delete(listener);
+    };
+    const dispose = () => {
+        disconnect();
+        subscribers.clear();
+        customListeners.clear();
+        isManualClose = false;
+        isReconnecting = false;
+    };
+    if (config.immediate) {
+        connect();
+    }
+    return {
+        state,
+        connect,
+        disconnect,
+        addEventListener,
+        subscribe,
+        dispose
+    };
+}
+//# sourceMappingURL=useReactiveSSE.js.map

package/dist/reactive/useReactiveSSE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReactiveSSE.js","sourceRoot":"","sources":["../../src/reactive/useReactiveSSE.ts"],"names":[],"mappings":"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"}

package/dist/reactive/useReactiveWebsocket.d.ts

@@ -0,0 +1,50 @@
+import type { WebSocketConstructor, WebSocket } from '../../references/websocket.d';
+import type { setTimeout, clearTimeout } from '../../references/timer.d';
+import type { Blob } from '../../references/blob.d';
+export type WebSocketMessage = string | ArrayBufferLike | Blob | ArrayBufferView;
+export declare enum WebSocketStatus {
+    CONNECTING = "CONNECTING",
+    CONNECTED = "CONNECTED",
+    DISCONNECTED = "DISCONNECTED",
+    ERROR = "ERROR"
+}
+export interface ReconnectOptions {
+    enabled?: boolean;
+    delay?: number;
+    maxRetries?: number;
+    retryDelayMultiplier?: number;
+}
+export interface UseReactiveWebsocketOptions {
+    protocols?: string | string[];
+    immediate?: boolean;
+    heartbeat?: number;
+    heartbeatMessage?: WebSocketMessage;
+    heartbeatTimeout?: number;
+    reconnect?: ReconnectOptions;
+    onConnected?: (ws: WebSocket) => void;
+    onDisconnected?: (ws: WebSocket, event: any) => void;
+    onError?: (ws: WebSocket, event: any) => void;
+    onMessage?: (ws: WebSocket, event: any) => void;
+}
+export interface ReactiveWebSocketState {
+    status: WebSocketStatus;
+    data: any;
+    error: Error | null;
+    retryCount: number;
+    ws: WebSocket | null;
+}
+export interface ReactiveWebSocketReturn {
+    state: ReactiveWebSocketState;
+    send: (data: WebSocketMessage) => boolean;
+    connect: () => void;
+    disconnect: (code?: number, reason?: string) => void;
+    subscribe: (listener: () => void) => () => void;
+    dispose: () => void;
+}
+export interface UseReactiveWebsocketDeps {
+    WebSocket: WebSocketConstructor;
+    setTimeout: typeof setTimeout;
+    clearTimeout: typeof clearTimeout;
+    log?: (...args: any[]) => void;
+}
+export declare function useReactiveWebsocket(url: string, options: UseReactiveWebsocketOptions | undefined, deps: UseReactiveWebsocketDeps): ReactiveWebSocketReturn;

package/dist/reactive/useReactiveWebsocket.js

@@ -0,0 +1,250 @@
+export var WebSocketStatus;
+(function (WebSocketStatus) {
+    WebSocketStatus["CONNECTING"] = "CONNECTING";
+    WebSocketStatus["CONNECTED"] = "CONNECTED";
+    WebSocketStatus["DISCONNECTED"] = "DISCONNECTED";
+    WebSocketStatus["ERROR"] = "ERROR";
+})(WebSocketStatus || (WebSocketStatus = {}));
+export function useReactiveWebsocket(url, options = {}, deps) {
+    const defaultOptions = {
+        protocols: [],
+        immediate: true,
+        heartbeat: 0,
+        heartbeatMessage: 'ping',
+        heartbeatTimeout: 5000,
+        reconnect: {
+            enabled: true,
+            delay: 3000,
+            maxRetries: 5,
+            retryDelayMultiplier: 1.5
+        },
+        onConnected: () => { },
+        onDisconnected: () => { },
+        onError: () => { },
+        onMessage: () => { }
+    };
+    const config = { ...defaultOptions, ...options };
+    if (options.reconnect) {
+        config.reconnect = { ...defaultOptions.reconnect, ...options.reconnect };
+    }
+    const state = {
+        status: WebSocketStatus.DISCONNECTED,
+        data: null,
+        error: null,
+        retryCount: 0,
+        ws: null
+    };
+    const subscribers = new Set();
+    const notify = () => {
+        subscribers.forEach(listener => listener());
+    };
+    let heartbeatTimer = null;
+    let reconnectTimer = null;
+    let isManualClose = false;
+    let isReconnecting = false;
+    let lastMessageTime = 0;
+    const clearHeartbeat = () => {
+        if (heartbeatTimer !== null) {
+            deps.clearTimeout(heartbeatTimer);
+            heartbeatTimer = null;
+        }
+    };
+    const clearReconnect = () => {
+        if (reconnectTimer !== null) {
+            deps.clearTimeout(reconnectTimer);
+            reconnectTimer = null;
+        }
+    };
+    const startHeartbeat = () => {
+        clearHeartbeat();
+        if (config.heartbeat <= 0 || !state.ws) {
+            return;
+        }
+        const checkHeartbeat = () => {
+            if (!state.ws || state.ws.readyState !== deps.WebSocket.OPEN) {
+                deps.log?.('[心跳] 连接未打开，停止心跳检测');
+                return;
+            }
+            const now = Date.now();
+            const timeSinceLastMessage = now - lastMessageTime;
+            const timeoutThreshold = config.heartbeat + config.heartbeatTimeout;
+            deps.log?.(`[心跳] 检查: 距上次消息 ${timeSinceLastMessage}ms, 超时阈值 ${timeoutThreshold}ms`);
+            if (timeSinceLastMessage > timeoutThreshold) {
+                deps.log?.('[心跳] ⚠️ 检测到超时，主动断开并重连');
+                clearHeartbeat();
+                const oldWs = state.ws;
+                state.ws = null;
+                state.status = WebSocketStatus.DISCONNECTED;
+                notify();
+                try {
+                    oldWs.close();
+                }
+                catch (error) {
+                    deps.log?.('[心跳] 关闭连接失败（忽略）:', error);
+                }
+                if (!isManualClose && !isReconnecting) {
+                    deps.log?.('[心跳] 开始重连流程');
+                    attemptReconnect();
+                }
+                return;
+            }
+            try {
+                deps.log?.('[心跳] 发送心跳消息');
+                state.ws.send(config.heartbeatMessage);
+            }
+            catch (error) {
+                deps.log?.('[心跳] 发送失败:', error);
+            }
+            heartbeatTimer = deps.setTimeout(checkHeartbeat, config.heartbeat);
+        };
+        heartbeatTimer = deps.setTimeout(checkHeartbeat, config.heartbeat);
+    };
+    const attemptReconnect = () => {
+        if (!config.reconnect.enabled || isManualClose || isReconnecting) {
+            return;
+        }
+        const maxRetries = config.reconnect.maxRetries || 0;
+        if (maxRetries > 0 && state.retryCount >= maxRetries) {
+            state.status = WebSocketStatus.ERROR;
+            state.error = new Error(`重连失败：已达到最大重连次数 ${maxRetries}`);
+            notify();
+            isReconnecting = false;
+            return;
+        }
+        const delay = (config.reconnect.delay || 3000) * Math.pow(config.reconnect.retryDelayMultiplier || 1, state.retryCount);
+        isReconnecting = true;
+        clearReconnect();
+        reconnectTimer = deps.setTimeout(() => {
+            state.retryCount++;
+            try {
+                connect();
+            }
+            finally {
+                isReconnecting = false;
+            }
+        }, delay);
+    };
+    const connect = () => {
+        if (state.ws && state.ws.readyState !== deps.WebSocket.CLOSED) {
+            deps.log?.('[连接] 已有活跃连接，跳过');
+            return;
+        }
+        isManualClose = false;
+        state.status = WebSocketStatus.CONNECTING;
+        state.error = null;
+        notify();
+        try {
+            const ws = new deps.WebSocket(url, config.protocols);
+            ws.onopen = (event) => {
+                if (isManualClose) {
+                    deps.log?.('[连接] 连接建立但已标记为手动关闭，忽略');
+                    ws.close();
+                    return;
+                }
+                state.status = WebSocketStatus.CONNECTED;
+                state.error = null;
+                state.retryCount = 0;
+                state.ws = ws;
+                notify();
+                lastMessageTime = Date.now();
+                deps.log?.('[连接] 连接成功，记录时间:', lastMessageTime);
+                if (config.heartbeat > 0) {
+                    deps.log?.(`[连接] 启动心跳检测: 间隔=${config.heartbeat}ms, 超时=${config.heartbeatTimeout}ms`);
+                }
+                startHeartbeat();
+                config.onConnected(ws);
+            };
+            ws.onmessage = (event) => {
+                state.data = event.data;
+                const oldTime = lastMessageTime;
+                lastMessageTime = Date.now();
+                deps.log?.(`[消息] 收到消息，更新时间: ${oldTime} -> ${lastMessageTime}`);
+                notify();
+                config.onMessage(ws, event);
+            };
+            ws.onerror = (event) => {
+                deps.log?.('[错误] WebSocket 错误');
+                state.error = new Error('WebSocket 连接错误');
+                notify();
+                config.onError(ws, event);
+            };
+            ws.onclose = (event) => {
+                clearHeartbeat();
+                deps.log?.(`[关闭] 连接关闭: code=${event.code}, wasClean=${event.wasClean}, isManualClose=${isManualClose}`);
+                if (state.ws === ws) {
+                    state.status = WebSocketStatus.DISCONNECTED;
+                    state.ws = null;
+                    notify();
+                }
+                config.onDisconnected(ws, event);
+                const shouldReconnect = !isManualClose && !event.wasClean && !isReconnecting;
+                deps.log?.(`[关闭] 是否重连: ${shouldReconnect}`);
+                if (shouldReconnect) {
+                    attemptReconnect();
+                }
+            };
+        }
+        catch (error) {
+            state.status = WebSocketStatus.ERROR;
+            state.error = error instanceof Error ? error : new Error('WebSocket 创建失败');
+            notify();
+            attemptReconnect();
+        }
+    };
+    const disconnect = (code, reason) => {
+        deps.log?.('[断开] 手动断开连接');
+        isManualClose = true;
+        isReconnecting = false;
+        clearHeartbeat();
+        clearReconnect();
+        const ws = state.ws;
+        if (ws) {
+            state.ws = null;
+            try {
+                ws.close(code, reason);
+            }
+            catch (error) {
+                deps.log?.('[断开] 关闭连接失败（忽略）:', error);
+            }
+        }
+        state.status = WebSocketStatus.DISCONNECTED;
+        state.retryCount = 0;
+        notify();
+    };
+    const send = (data) => {
+        if (!state.ws || state.ws.readyState !== deps.WebSocket.OPEN) {
+            return false;
+        }
+        try {
+            state.ws.send(data);
+            return true;
+        }
+        catch (error) {
+            state.error = error instanceof Error ? error : new Error('发送消息失败');
+            notify();
+            return false;
+        }
+    };
+    const subscribe = (listener) => {
+        subscribers.add(listener);
+        return () => subscribers.delete(listener);
+    };
+    const dispose = () => {
+        disconnect();
+        subscribers.clear();
+        isManualClose = false;
+        isReconnecting = false;
+    };
+    if (config.immediate) {
+        connect();
+    }
+    return {
+        state,
+        send,
+        connect,
+        disconnect,
+        subscribe,
+        dispose
+    };
+}
+//# sourceMappingURL=useReactiveWebsocket.js.map

package/dist/reactive/useReactiveWebsocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReactiveWebsocket.js","sourceRoot":"","sources":["../../src/reactive/useReactiveWebsocket.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcw-shared",
-  "version": "1.22.0",
+  "version": "1.24.0",
   "files": [
     "references",
     "dist",
@@ -23,15 +23,18 @@
     "publish:prerelease": "npx tsx scripts/publish.ts prerelease",
     "docs:dev": "vitepress dev docs",
     "docs:build": "NODE_OPTIONS=--max-old-space-size=4096 vitepress build docs",
-    "docs:preview": "vitepress preview docs"
+    "docs:preview": "vitepress preview docs",
+    "deploy:tcb": "npx tsx scripts/deploy-tcb.ts",
+    "deploy:cos": "npx tsx scripts/deploy-cos.ts"
   },
   "devDependencies": {
     "@cloudbase/manager-node": "^4.3.2",
+    "cos-nodejs-sdk-v5": "^2.14.4",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
     "vitepress": "^1.6.4",
     "vue": "^3.5.22",
-    "zcw-shared": "^1.20.0",
+    "zcw-shared": "^1.22.0",
     "zcw-vue-ui": "^1.11.3"
   },
   "exports": {
@@ -66,6 +69,7 @@
     "./functions/algorithm/threeSum": "./dist/functions/algorithm/threeSum.js",
     "./functions/algorithm/topologicalSort": "./dist/functions/algorithm/topologicalSort.js",
     "./functions/algorithm/trap": "./dist/functions/algorithm/trap.js",
+    "./functions/algorithm/visualizeGarbageCollection": "./dist/functions/algorithm/visualizeGarbageCollection.js",
     "./functions/android/buildProject": "./dist/functions/android/buildProject.js",
     "./functions/android/detectAndroidModules": "./dist/functions/android/detectAndroidModules.js",
     "./functions/android/modifyGradle": "./dist/functions/android/modifyGradle.js",
@@ -115,11 +119,19 @@
     "./functions/design-tokens/generateVariables": "./dist/functions/design-tokens/generateVariables.js",
     "./functions/design-tokens/mixColors": "./dist/functions/design-tokens/mixColors.js",
     "./functions/design-tokens/parseDesignTokens": "./dist/functions/design-tokens/parseDesignTokens.js",
+    "./functions/dom/computePosition": "./dist/functions/dom/computePosition.js",
+    "./functions/dom/createThrottledEventListener": "./dist/functions/dom/createThrottledEventListener.js",
     "./functions/dom/demonstrateResourceLoading": "./dist/functions/dom/demonstrateResourceLoading.js",
     "./functions/dom/detectOverflow": "./dist/functions/dom/detectOverflow.js",
+    "./functions/dom/getAlignment": "./dist/functions/dom/getAlignment.js",
+    "./functions/dom/getBasePlacement": "./dist/functions/dom/getBasePlacement.js",
+    "./functions/dom/getCrossAxisFlip": "./dist/functions/dom/getCrossAxisFlip.js",
     "./functions/dom/getElementRect": "./dist/functions/dom/getElementRect.js",
+    "./functions/dom/getFlipPlacements": "./dist/functions/dom/getFlipPlacements.js",
+    "./functions/dom/getMainAxisFlip": "./dist/functions/dom/getMainAxisFlip.js",
     "./functions/dom/getRelativePosition": "./dist/functions/dom/getRelativePosition.js",
     "./functions/dom/getViewportRect": "./dist/functions/dom/getViewportRect.js",
+    "./functions/dom/isValidPlacement": "./dist/functions/dom/isValidPlacement.js",
     "./functions/file/formatFileSize": "./dist/functions/file/formatFileSize.js",
     "./functions/file/getFileExtension": "./dist/functions/file/getFileExtension.js",
     "./functions/functional/compose": "./dist/functions/functional/compose.js",
@@ -188,6 +200,7 @@
     "./functions/string/palindrome": "./dist/functions/string/palindrome.js",
     "./functions/string/similarity": "./dist/functions/string/similarity.js",
     "./functions/string/template": "./dist/functions/string/template.js",
+    "./functions/string/testRegex": "./dist/functions/string/testRegex.js",
     "./functions/string/wordCount": "./dist/functions/string/wordCount.js",
     "./functions/tencent-cloud/deploy.tcb": "./dist/functions/tencent-cloud/deploy.tcb.js",
     "./functions/tencent-cloud/getSecret": "./dist/functions/tencent-cloud/getSecret.js",
@@ -234,6 +247,8 @@
     "./reactive/createReactivePermission": "./dist/reactive/createReactivePermission.js",
     "./reactive/createReactivePinia": "./dist/reactive/createReactivePinia.js",
     "./reactive/useReactiveCookie": "./dist/reactive/useReactiveCookie.js",
+    "./reactive/useReactiveSSE": "./dist/reactive/useReactiveSSE.js",
+    "./reactive/useReactiveWebsocket": "./dist/reactive/useReactiveWebsocket.js",
     "./vue-hooks/browser/useBattery": "./dist/vue-hooks/browser/useBattery.js",
     "./vue-hooks/browser/useBluetooth": "./dist/vue-hooks/browser/useBluetooth.js",
     "./vue-hooks/browser/useCamera": "./dist/vue-hooks/browser/useCamera.js",
@@ -277,6 +292,7 @@
     "./types/color": "./types/color.d.ts",
     "./types/design-system": "./types/design-system.d.ts",
     "./types/geometry": "./types/geometry.d.ts",
+    "./types/placement": "./types/placement.d.ts",
     "./types/platform": "./types/platform.d.ts",
     "./types/reactive": "./types/reactive.d.ts",
     "./types/semver": "./types/semver.d.ts",

package/references/browser.d.ts

@@ -111,6 +111,10 @@ export interface Window {
   // Navigator API
   navigator: Navigator
 
+  // 事件监听API
+  addEventListener(type: string, listener: EventListener, options?: boolean | AddEventListenerOptions): void
+  removeEventListener(type: string, listener: EventListener, options?: boolean | EventListenerOptions): void
+
   // 开发环境标识
   __DEV__?: boolean