zcw-shared 1.20.0 → 1.22.0

package/types/reactive.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 响应式依赖接口
+ * 定义响应式对象支持的订阅和通知方法
+ */
+export interface ReactiveDeps {
+  /** 订阅者管理：存储所有监听器 */
+  subscribers: Set<(...args: any[]) => void>
+
+  /** 通知所有订阅者 */
+  notify: () => void
+
+  /** 订阅变化监听器 */
+  subscribe: (listener: () => void) => () => void
+
+  /** 取消所有订阅 */
+  dispose: () => void
+}
+
+/**
+ * 响应式对象类型
+ * 扩展原始对象类型，添加响应式方法
+ */
+export type Reactive<T> = T & ReactiveDeps
+
+/**
+ * 创建响应式对象的函数类型
+ */
+export type CreateReactive = <T extends Record<string, any>>(
+  target: T,
+  deps: CreateReactiveDeps
+) => Reactive<T>
+
+/**
+ * 创建响应式对象的依赖接口
+ */
+export interface CreateReactiveDeps {
+  /** 订阅者管理：存储所有监听器 */
+  subscribers: Set<(...args: any[]) => void>
+
+  /** 通知所有订阅者 */
+  notify: () => void
+
+  /** 订阅变化监听器 */
+  subscribe: (listener: () => void) => () => void
+
+  /** 取消所有订阅 */
+  dispose: () => void
+
+  /** 创建代理对象 */
+  createProxy: <T extends Record<string, any>>(target: T, deps: ReactiveDeps) => T
+  /** 获取变化路径 */
+  getChangePath: (target: any, property: string | symbol) => string[]
+}
+
+/**
+ * 响应式状态更新事件
+ */
+export interface ReactiveChangeEvent {
+  /** 变化的属性路径 */
+  path: string[]
+  /** 旧值 */
+  oldValue: any
+  /** 新值 */
+  newValue: any
+  /** 变化类型 */
+  type: 'set' | 'delete'
+}

package/types/tencent-cloud.d.ts

@@ -33,4 +33,33 @@ export interface DeployResult {
   success: boolean
   message?: string
   error?: string
+}
+
+// COS 上传配置选项
+export interface UploadToCOSOptions {
+  /** 本地文件夹路径 */
+  localPath: string
+  /** COS 存储桶名称 */
+  bucket: string
+  /** COS 地域 */
+  region: string
+  /** 云端路径前缀 */
+  cloudPath?: string
+  /** 密钥类型 */
+  secretType: SecretType
+  /** 是否包含根文件夹 */
+  includeRootFolder?: boolean
+  /** 是否显示进度 */
+  showProgress?: boolean
+}
+
+// COS 上传结果
+export interface UploadToCOSResult {
+  success: boolean
+  message?: string
+  error?: string
+  /** 上传的文件数量 */
+  filesCount?: number
+  /** 失败的文件列表 */
+  failedFiles?: string[]
 }

package/types/vue.d.ts

@@ -1,4 +1,26 @@
 import type { ColorReference } from './design-system.d'
+import type { Ref, InjectionKey } from '../references/vue.d'
+
+/**
+ * Vue Composition API 通用接口
+ * 用于 Vue Hooks 的依赖注入，所有属性都是可选的
+ */
+export interface VueCompositionAPI {
+  /** 创建响应式引用 */
+  ref?: <T>(value: T) => Ref<T>
+  /** 创建浅响应式引用 */
+  shallowRef?: <T>(value: T) => Ref<T>
+  /** 组件挂载时的钩子 */
+  onMounted?: (fn: () => void) => void
+  /** 组件卸载时的钩子 */
+  onUnmounted?: (fn: () => void) => void
+  /** 提供依赖 */
+  provide?: <T>(key: InjectionKey<T> | string, value: T) => void
+  /** 注入依赖 */
+  inject?: <T>(key: InjectionKey<T> | string, defaultValue?: T) => T | undefined
+  /** 监听响应式数据变化 */
+  watch?: (source: any, callback: () => void, options?: { deep?: boolean; flush?: string }) => void
+}
 
 /**
  * Vue文件section类型