SvelteKit-SuperForms v2.26.0 版本发布：Zod 4 适配与功能增强

SvelteKit-SuperForms 是一个专为 SvelteKit 框架设计的高效表单处理库，它简化了表单验证、状态管理和数据提交的流程。该库支持多种流行的验证库，如 Zod、Valibot 等，并提供了丰富的功能来提升开发体验。

主要更新内容

Zod 4 适配器正式加入

本次版本最重要的更新是新增了对 Zod 4 的支持。Zod 作为 TypeScript 生态中最受欢迎的运行时类型检查库之一，在 4.0 版本中对 JSON Schema 表示方式进行了重大调整。SuperForms 现在提供了 zod4 和 zod4Client 两个适配器，能够完美兼容 Zod 4 的全量版和 Mini 版。

值得注意的是，Zod 4 在枚举处理等方面存在一些破坏性变更。开发者在迁移时需要特别注意这些变化，建议仔细检查迁移指南，并报告遇到的任何问题。

表单污染状态增强

taintedMessage 功能得到了增强，现在能够传递 BeforeNavigate 对象到回调函数中。这一改进使得开发者能够更精细地控制当用户尝试离开包含未保存更改的表单页面时的行为，提供更流畅的用户体验。

SuperDebug Runes 版本

调试工具 SuperDebug 现在提供了 Runes 版本。Runes 是 Svelte 5 引入的新特性，这一更新意味着开发者可以在最新的 Svelte 环境中更方便地调试表单状态和数据流。

Valibot 客户端配置扩展

Valibot 客户端适配器 valibotClient 现在支持与服务器端 valibot 适配器相同的配置选项，为开发者提供更一致的配置体验。这一变化恰逢 Valibot 1.0.0 稳定版的发布，标志着该验证库的成熟。

依赖项更新

为了保持与生态系统的同步，本次版本对部分依赖项的要求进行了调整：

• 将 Zod 的最低兼容版本提升至 3.25.0，以确保与 Zod 4 的兼容性
• 将 Valibot 的最低版本要求提升至 1.0.0，与其稳定版发布保持同步

技术建议

对于正在使用 Zod 3 的项目，升级到 Zod 4 需要特别注意枚举处理等破坏性变更。建议先在开发环境进行充分测试，确保表单验证逻辑仍然按预期工作。对于新项目，可以直接采用 Zod 4 和对应的适配器，享受最新的特性和性能优化。

Valibot 用户现在可以放心使用 1.0.0 稳定版，客户端和服务器端的配置一致性将简化开发流程。SuperDebug 的 Runes 支持则为采用 Svelte 5 的项目提供了更好的调试体验。

总的来说，v2.26.0 版本进一步巩固了 SvelteKit-SuperForms 作为 SvelteKit 生态中表单处理首选解决方案的地位，通过持续跟进主流验证库的更新并提供更多实用功能，帮助开发者构建更健壮、更易维护的表单应用。