testing-tool/src/types/README.md

types/

全局共享的 TypeScript 类型声明文件目录。

文件说明

storage.d.ts

核心类型定义文件，包含：

页面类型：

• PageType — 所有页面类型的联合类型（含 dashboard、timestamp、storageCleaner、testDataGenerator 等）
• JsonToolsPageMode — JSON 工具子模式（diff | format | yaml | toml | minify）
• Base64ConverterPageMode — Base64 子模式（text | file | image）
• Base64ConvertDirection — 编解码方向（encode | decode）

存储 Schema：

• StorageSchema — Chrome Storage 完整数据结构定义，所有存储键必须在此声明
  • 键名使用 kebab-case 格式（如 app/currentRoute）
  • 包含路由、主题、工具偏好、搜索历史等所有持久化数据

其他类型：

• FormMapEntry — 表单映射条目定义
• ContextMenuPendingData — 右键菜单待处理数据
• StorageCleanerPreferences / StorageCleanerOptions — 存储清理偏好
• CleaningResult / StorageCleanResult — 清理结果类型

qrious.d.ts

qrious 库的类型声明，定义 QR 码生成选项和 QRious 类。

testDataGenerator.ts

测试数据生成器共享类型，包含：

• FieldConfig — 字段配置（字段名、生成器、参数、必填、空值率、唯一性）
• DataRule — 可保存/导入/导出的字段规则
• GeneratorDefinition / GeneratorParam — 内置生成器定义和参数 Schema
• GenerateResult / GenerateProgress — Worker 生成结果与进度
• WorkerRequestMessage / WorkerResponseMessage — Worker 消息协议；每条响应携带 generationId，用于忽略过期任务（取消或快速重试时）
• WorkerMessage — 已废弃，请使用上述两种消息类型
• ExportFile — JSON/CSV 导出文件描述

修改 StorageSchema 的注意事项

修改 StorageSchema 时，必须：

1. 在 utils/chromeStorage.ts 添加版本迁移函数
2. 在测试中覆盖迁移场景