zcw-shared 1.16.2 → 1.18.0

package/README.md

@@ -330,6 +330,12 @@ npx tsx tests/*.test.ts
 
 2. **编译依赖**：改动了函数以后，因为playground中引用的是编译后的shared包，所以需要先编译shared包（`npm run build`），test中才能用到最新的代码。
 
+3. **文档同步更新**：每次新增新功能或修改现有功能后，**必须**同步更新VitePress文档：
+   - 在 `docs/api/` 目录下更新或创建对应的API文档
+   - 在 `docs/examples/` 目录下添加使用示例
+   - 确保文档中的TypeScript泛型语法使用反引号包裹（如 `Promise<\`File\`>`）以避免Vue编译错误
+   - 运行 `npm run docs:dev` 验证文档编译无误
+
 ### 1. 添加新函数
 
 ```bash
@@ -342,7 +348,14 @@ types/category.d.ts
 # 3. 创建测试
 playground/tests/newFunction.test.ts
 
-# 4. 构建和导出
+# 4. 更新VitePress文档
+docs/api/category.md          # API文档
+docs/examples/category.md     # 使用示例
+
+# 5. 验证文档编译
+npm run docs:dev
+
+# 6. 构建和导出
 npm run build
 ```
 
@@ -374,6 +387,9 @@ export function newFunction(
 # 类型检查
 npx tsc --noEmit
 
+# 验证文档编译
+npm run docs:build
+
 # 构建项目
 npm run build
 
@@ -409,6 +425,11 @@ npm run publish:major  # 主要版本
 1. **JSDoc注释**：详细的函数说明和参数描述
 2. **使用示例**：在测试文件中提供实际使用案例
 3. **类型导出**：确保所有相关类型都可以导入
+4. **VitePress文档**：
+   - **API文档**：在 `docs/api/` 目录下为每个模块创建详细的API文档
+   - **示例文档**：在 `docs/examples/` 目录下提供实际使用示例
+   - **语法规范**：TypeScript泛型语法必须用反引号包裹（如 `Promise<\`File\`>`）
+   - **编译验证**：确保文档能够正常编译，无Vue语法错误
 
 ---
 

package/dist/hooks/useDraggable.d.ts

@@ -0,0 +1,34 @@
+import type { Ref } from 'vue';
+import type { HTMLElement, Document, MouseEvent, TouchEvent } from '../../references/dom.d';
+import type { Window } from '../../references/browser.d';
+export interface Position {
+    x: number;
+    y: number;
+}
+export interface DraggableEnvironment {
+    document: Document;
+    window: Window;
+}
+export interface UseDraggableOptions {
+    initialPosition?: Position;
+    enabled?: boolean;
+    onDragStart?: (position: Position, event: MouseEvent | TouchEvent) => void;
+    onDrag?: (position: Position, event: MouseEvent | TouchEvent) => void;
+    onDragEnd?: (position: Position, event: MouseEvent | TouchEvent) => void;
+    boundary?: {
+        minX?: number;
+        maxX?: number;
+        minY?: number;
+        maxY?: number;
+    };
+    useAbsolutePosition?: boolean;
+    useTransform?: boolean;
+}
+export declare function useDraggable(targetRef: Ref<HTMLElement | null>, options: UseDraggableOptions | undefined, env: DraggableEnvironment): {
+    position: Ref<Position, Position>;
+    isDragging: Ref<boolean, boolean>;
+    style: Ref<Record<string, string>, Record<string, string>>;
+    reset: () => void;
+    cleanup: () => void;
+};
+export default useDraggable;

package/dist/hooks/useDraggable.js

@@ -0,0 +1,183 @@
+import { ref, onMounted, onUnmounted } from 'vue';
+export function useDraggable(targetRef, options = {}, env) {
+    const { initialPosition = { x: 0, y: 0 }, enabled = true, onDragStart, onDrag, onDragEnd, boundary, useAbsolutePosition = true, useTransform = false } = options;
+    const position = ref({ ...initialPosition });
+    const isDragging = ref(false);
+    let startX = 0;
+    let startY = 0;
+    let initialX = initialPosition.x;
+    let initialY = initialPosition.y;
+    let positionInitialized = false;
+    const applyBoundary = (pos) => {
+        if (!boundary)
+            return pos;
+        const { minX, maxX, minY, maxY } = boundary;
+        let { x, y } = pos;
+        if (minX !== undefined)
+            x = Math.max(minX, x);
+        if (maxX !== undefined)
+            x = Math.min(maxX, x);
+        if (minY !== undefined)
+            y = Math.max(minY, y);
+        if (maxY !== undefined)
+            y = Math.min(maxY, y);
+        return { x, y };
+    };
+    const style = ref({});
+    const updateStyle = () => {
+        if (!useAbsolutePosition && !useTransform)
+            return;
+        if (useAbsolutePosition) {
+            style.value = {
+                position: 'absolute',
+                top: `${position.value.y}px`,
+                left: `${position.value.x}px`,
+                ...(useTransform ? {} : { transform: 'none' })
+            };
+        }
+        else if (useTransform) {
+            style.value = {
+                transform: `translate(${position.value.x}px, ${position.value.y}px)`
+            };
+        }
+    };
+    const updatePosition = (newPosition) => {
+        position.value = applyBoundary(newPosition);
+        updateStyle();
+    };
+    const onMouseDown = (e) => {
+        if (!enabled || !targetRef.value)
+            return;
+        e.stopPropagation();
+        e.preventDefault();
+        if (!positionInitialized && targetRef.value) {
+            const rect = targetRef.value.getBoundingClientRect();
+            if (!initialPosition.x && !initialPosition.y) {
+                initialX = rect.left;
+                initialY = rect.top;
+                position.value = { x: initialX, y: initialY };
+            }
+            positionInitialized = true;
+        }
+        isDragging.value = true;
+        startX = e.clientX - position.value.x;
+        startY = e.clientY - position.value.y;
+        if (onDragStart) {
+            onDragStart({ ...position.value }, e);
+        }
+        env.document.addEventListener('mousemove', onMouseMove, { passive: false });
+        env.document.addEventListener('mouseup', onMouseUp);
+    };
+    const onMouseMove = (e) => {
+        if (!isDragging.value)
+            return;
+        e.preventDefault();
+        env.window.requestAnimationFrame(() => {
+            const newPosition = {
+                x: e.clientX - startX,
+                y: e.clientY - startY
+            };
+            updatePosition(newPosition);
+            if (onDrag) {
+                onDrag({ ...position.value }, e);
+            }
+        });
+    };
+    const onMouseUp = (e) => {
+        if (!isDragging.value)
+            return;
+        isDragging.value = false;
+        if (onDragEnd) {
+            onDragEnd({ ...position.value }, e);
+        }
+        env.document.removeEventListener('mousemove', onMouseMove);
+        env.document.removeEventListener('mouseup', onMouseUp);
+    };
+    const onTouchStart = (e) => {
+        if (!enabled || !targetRef.value || e.touches.length !== 1)
+            return;
+        e.stopPropagation();
+        if (!positionInitialized && targetRef.value) {
+            const rect = targetRef.value.getBoundingClientRect();
+            if (!initialPosition.x && !initialPosition.y) {
+                initialX = rect.left;
+                initialY = rect.top;
+                position.value = { x: initialX, y: initialY };
+            }
+            positionInitialized = true;
+        }
+        isDragging.value = true;
+        const touch = e.touches[0];
+        startX = touch.clientX - position.value.x;
+        startY = touch.clientY - position.value.y;
+        if (onDragStart) {
+            onDragStart({ ...position.value }, e);
+        }
+        env.document.addEventListener('touchmove', onTouchMove, { passive: false });
+        env.document.addEventListener('touchend', onTouchEnd);
+        env.document.addEventListener('touchcancel', onTouchEnd);
+    };
+    const onTouchMove = (e) => {
+        if (!isDragging.value || e.touches.length !== 1)
+            return;
+        e.preventDefault();
+        env.window.requestAnimationFrame(() => {
+            const touch = e.touches[0];
+            const newPosition = {
+                x: touch.clientX - startX,
+                y: touch.clientY - startY
+            };
+            updatePosition(newPosition);
+            if (onDrag) {
+                onDrag({ ...position.value }, e);
+            }
+        });
+    };
+    const onTouchEnd = (e) => {
+        if (!isDragging.value)
+            return;
+        isDragging.value = false;
+        if (onDragEnd) {
+            onDragEnd({ ...position.value }, e);
+        }
+        env.document.removeEventListener('touchmove', onTouchMove);
+        env.document.removeEventListener('touchend', onTouchEnd);
+        env.document.removeEventListener('touchcancel', onTouchEnd);
+    };
+    const reset = () => {
+        updatePosition({ ...initialPosition });
+        positionInitialized = false;
+    };
+    const cleanup = () => {
+        env.document.removeEventListener('mousemove', onMouseMove);
+        env.document.removeEventListener('mouseup', onMouseUp);
+        env.document.removeEventListener('touchmove', onTouchMove);
+        env.document.removeEventListener('touchend', onTouchEnd);
+        env.document.removeEventListener('touchcancel', onTouchEnd);
+    };
+    onMounted(() => {
+        const element = targetRef.value;
+        if (!element)
+            return;
+        updateStyle();
+        element.addEventListener('mousedown', onMouseDown);
+        element.addEventListener('touchstart', onTouchStart);
+    });
+    onUnmounted(() => {
+        const element = targetRef.value;
+        if (!element)
+            return;
+        element.removeEventListener('mousedown', onMouseDown);
+        element.removeEventListener('touchstart', onTouchStart);
+        cleanup();
+    });
+    return {
+        position,
+        isDragging,
+        style,
+        reset,
+        cleanup
+    };
+}
+export default useDraggable;
+//# sourceMappingURL=useDraggable.js.map

package/dist/hooks/useDraggable.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcw-shared",
-  "version": "1.16.2",
+  "version": "1.18.0",
   "files": [
     "references",
     "dist",
@@ -111,6 +111,7 @@
     "./functions/xml/modifyXml": "./dist/functions/xml/modifyXml.js",
     "./hooks/useAltool": "./dist/hooks/useAltool.js",
     "./hooks/useCache": "./dist/hooks/useCache.js",
+    "./hooks/useDraggable": "./dist/hooks/useDraggable.js",
     "./hooks/useLocalStorage": "./dist/hooks/useLocalStorage.js",
     "./hooks/usePluginSystem": "./dist/hooks/usePluginSystem.js",
     "./hooks/useSessionStorage": "./dist/hooks/useSessionStorage.js",

package/references/blob.d.ts

@@ -2,14 +2,28 @@
 import type { BufferSource } from './arraybuffer.d'
 
 // Stream 相关类型（基础依赖）
-export interface ReadableStreamReader<T> {
+export interface ReadableStreamBYOBReader {
+  read<T extends ArrayBufferView>(view: T): Promise<{ done: boolean; value: T }>
+  releaseLock(): void
+  cancel(reason?: any): Promise<void>
+}
+
+export interface ReadableStreamDefaultReader<T> {
   read(): Promise<{ done: boolean; value: T }>
   releaseLock(): void
   cancel(reason?: any): Promise<void>
 }
 
+export type ReadableStreamReader<T> = ReadableStreamDefaultReader<T> | ReadableStreamBYOBReader
+
+export interface ReadableStreamGetReaderOptions {
+  mode?: 'byob'
+}
+
 export interface ReadableStream<T> {
-  getReader(): ReadableStreamReader<T>
+  getReader(): ReadableStreamDefaultReader<Uint8Array>
+  getReader(options: { mode: 'byob' }): ReadableStreamBYOBReader
+  getReader(options?: ReadableStreamGetReaderOptions): ReadableStreamReader<T>
   cancel(reason?: any): Promise<void>
   locked: boolean
 }

package/references/browser.d.ts

@@ -85,6 +85,10 @@ export interface Window {
   Uint8Array: Uint8ArrayConstructor
   DataView: DataViewConstructor
   
+  // 动画API
+  requestAnimationFrame: (callback: (time: number) => void) => number
+  cancelAnimationFrame: (id: number) => void
+  
   // 开发环境标识
   __DEV__?: boolean
   

package/references/dom.d.ts

@@ -1,4 +1,5 @@
 // DOM 相关类型声明
+import type { Blob } from './blob.d'
 
 // DOM 元素接口 - 按继承关系组织
 export interface Element {
@@ -16,6 +17,8 @@ export interface HTMLElement extends Element {
     right: number
     bottom: number
   }
+  addEventListener(event: string, handler: (e: any) => void, options?: any): void
+  removeEventListener(event: string, handler: (e: any) => void, options?: any): void
 }
 
 export interface HTMLImageElement extends HTMLElement {
@@ -44,11 +47,29 @@ export interface Document {
     clientWidth: number
     clientHeight: number
   }
+  addEventListener(event: string, handler: (e: any) => void, options?: any): void
+  removeEventListener(event: string, handler: (e: any) => void, options?: any): void
 }
 
 // DOM 事件相关
 export interface Event {
   target?: any
+  stopPropagation(): void
+  preventDefault(): void
+}
+
+export interface MouseEvent extends Event {
+  clientX: number
+  clientY: number
+}
+
+export interface Touch {
+  clientX: number
+  clientY: number
+}
+
+export interface TouchEvent extends Event {
+  touches: Touch[]
 }
 
 export interface DOMException {