zcw-shared 1.20.0 → 1.21.0

package/references/xlsx.d.ts

@@ -0,0 +1,51 @@
+/**
+ * XLSX 库类型声明
+ * 用于 Excel 文件读取和解析
+ * 与 import type { XLSXLibrary } from '...' 兼容
+ */
+
+export interface WorkBook {
+  /** 工作表名称数组 */
+  SheetNames: string[]
+  /** 工作表对象映射 */
+  Sheets: { [sheetName: string]: WorkSheet }
+}
+
+export interface WorkSheet {
+  [cellRef: string]: CellObject
+}
+
+export interface CellObject {
+  /** 单元格值 */
+  v?: string | number | boolean | Date
+  /** 值类型 */
+  t?: 's' | 'n' | 'b' | 'd'
+}
+
+export interface XLSXUtils {
+  /** 将工作表转换为 JSON 数组 */
+  sheet_to_json(sheet: WorkSheet, options?: { header: number }): any[][]
+}
+
+export interface XLSXLibrary {
+  /** 读取 Excel 文件 */
+  readFile(filePath: string): WorkBook
+  /** 读取文件缓冲区 */
+  read(buffer: Buffer, options?: any): WorkBook
+  /** 全局工具对象 */
+  utils: XLSXUtils
+}
+
+/**
+ * XLSX 库默认导出
+ * 兼容 import * as XLSX from 'xlsx' 的使用
+ */
+declare module 'xlsx' {
+  export = XLSXLibrary
+}
+
+/**
+ * 全局类型声明
+ * 兼容 import type { XLSXLibrary } from '../../../references/xlsx.d'
+ */
+export type XLSX = XLSXLibrary

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'
+}