Valibot v1.0.0-rc.0 to-json-schema 版本深度解析

Valibot 是一个现代化的 TypeScript 数据验证库，它提供了一种声明式的方式来定义和验证数据结构。在即将发布的 v1.0.0-rc.0 版本中，to-json-schema 功能迎来了多项重要更新，这些改进显著增强了 Valibot 在 JSON Schema 转换方面的能力。

核心功能增强

本次版本更新在数据类型支持方面做了大量扩展，新增了对多种特殊格式的支持：

1. 基础数据类型增强：新增了 base64、isoTime、isoDateTime 等基础格式验证器，使得开发者能够更方便地验证特定格式的数据。

2. 字符串格式扩展：引入了 bic（银行识别代码）、cuid2、emoji、hex_color 等专业字符串格式验证，覆盖了更多业务场景需求。

3. 数字处理改进：新增 decimal（十进制）、digits（数字字符串）、hexadecimal（十六进制）等数字相关验证器，丰富了数值处理能力。

架构性改进

1. 可选属性处理：新增 exactOptional 和 undefinedable 支持，提供了更精细的可选属性控制机制。这使得开发者能够更精确地定义哪些属性可以缺失或为 undefined。

2. 错误处理模式：将原有的 force 参数重构为 errorMode，提供了更灵活的验证错误处理策略。开发者现在可以更细致地控制验证失败时的行为。

3. 对象属性处理：改进了 object 和 looseObject 的 additionalProperties 处理逻辑，使得对象结构的定义更加符合 JSON Schema 规范。

向后兼容性考虑

本次更新将 Valibot 的 peer dependency 升级到了 v1.0.0 版本，开发者需要注意依赖版本的同步更新。同时，对于 nullable、nullish 和 optional 等修饰符的默认值提取逻辑也进行了优化，这些变化可能会影响现有代码的行为，建议进行全面测试。

实际应用建议

对于正在使用 Valibot 的开发者，升级到新版本时需要注意：

1. 检查现有代码中是否使用了被修改的配置项（如 force 改为 errorMode）
2. 评估新增的验证器是否能替代现有的自定义验证逻辑
3. 测试对象结构的 JSON Schema 生成是否符合预期
4. 考虑新的可选属性处理机制是否能优化现有类型定义

Valibot 通过这些改进，进一步巩固了其作为现代化数据验证解决方案的地位，特别是在需要生成 JSON Schema 的场景下，提供了更强大、更灵活的功能支持。