cast/CHANGELOG.md

CHANGELOG

[v1.2.1] - 2026-05-04

Added

• Encoder 元数据缓存: 引入 encoderStructDescriptor 缓存，大幅减少结构体序列化时的反射开销。
• time.Time 全局支持:
  • Encoder/Decoder 原生支持 time.Time 类型。
  • 默认使用格式 2006-01-02 15:04:05.000。
  • 支持通过 Struct Tag 指定格式（如 json:"format=2006-01-02"）。
• 零分配摩擦匹配: 重构 Decoder 匹配逻辑，实现 normalizeEqual 算法，在忽略大小写/下划线匹配时彻底消除内存分配。

Optimized

• Encoder 性能:
  • 采用 MapRange 代替 MapKeys 遍历 Map，减少中间切片分配。
  • 延迟 Path 路径计算，仅在开启脱敏字典时计算路径。
  • 重写 writeString，支持批量写入与高效查表转义。
• Decoder 性能:
  • 优化 decodeArray 扩容策略，优先尊重并使用用户预设的 Capacity。
• 移除 Map 排序: 序列化 Map 时不再进行 Key 排序，显著提升大规模 Map 的处理速度。

[v1.2.0] - 2026-05-04

Added

• 零摩擦 API: 核心 API To[T], ToJSON, FromJSON, ToMap, ToSlice 全部重构为不返回错误，遇错静默返回零值。
• As 包装器: 原 Quiet 更名为 As，用于一键消除传统 (value, error) 函数的摩擦。

Removed

• YAML 支持: 移除 gopkg.in/yaml.v3 依赖。
• Must/As[T] 系列: 移除 Must 及所有特殊的 AsXxx 系列函数，统一通过 To[T] 或 As 包装实现。
• 冗余 API: 移除 PrettyToJSONBytes 和 ToJSONDesensitize，保留对应的 PrettyToJSON 和 ToJSONDesensitizeBytes。

[v1.1.2] - 2026-05-04

Added

• 新增 ToMap 和 ToSlice: 侧重于原地填充/追加，支持 Struct 继承拍平、KV 序列化与自动类型转换。
• 新增 MakeMap, MakeSlice, FromJSON, FromYAML 系列: 泛型构建新对象的零摩擦 API。
• 增强 UnmarshalJSON / UnmarshalYAML: 重构为副作用模式（返回 error），支持多种输入类型。

Removed

• 移除 Ints 和 Strings: 由更通用的 MakeSlice 替代，保持 API 简洁。

[v1.1.1] - 2026-04-12

• 修复: 解决 FastEncoder 在编码结构体时忽略匿名嵌入（Embedded）字段的问题，确保组合对象的完整序列化。

[v1.1.0] - 2026-05-02

• 功能: 新增 FastEncoder，实现单路径 JSON 编码，大幅提升性能并减少内存分配。
• 功能: 新增 ToJSONDesensitize 和 ToJSONDesensitizeBytes，支持原生字段脱敏。
• 功能: 新增 FastDecoder，实现单路径流式 JSON 解析，支持“零摩擦” Key 匹配（大小写不敏感、归一化映射）。
• 优化: 完善 null 值处理逻辑，区分 nil 指针与空 slice/map。
• 重构: 移除旧版 makeJSONType 等冗余逻辑，代码结构更简洁高效。

[v1.0.4] - 2026-04-30

• 优化: 重构 UniqueAppend，改用 Map 查重，性能提升至 $O(n)$。
• 优化: 提升 If 函数参数描述性，符合工程规范。
• 优化: 精简 parseInt/parseUint 逻辑，减少冗余字符串扫描。
• 优化: 优化 FixUpperCase 内部字符处理，引入位运算提升效率。