这个页面的目标,是让开发者先判断单一格式本身是否足够可用,再决定是否继续看某一条转换路径。
已展示格式
3
可作为 parser 输入
3
可作为 generator 输出
2
每一种格式都应该回答一个很实际的问题:它现在作为输入 parser、输出 generator,还是两者兼具,到底有多可信?
JSONJSON
Parser 很强、暂不支持 generator,最适合快速推断。
BetaParser 支持
✓已支持Generator 支持
—不支持
JSON
Parser 很强、暂不支持 generator,最适合快速推断。
Parser 支持
✓已支持Generator 支持
—不支持JSON 目前最适合作为轻量 source format,用来做 sample-driven inference 和快速探索。
当前表现较好的部分
适合快速接入 sample
适合探索式类型推断
可以顺畅进入 TypeScript inference
当前限制
在当前公开 Playground 流程里,JSON 还不是输出 target。
样例覆盖度完全取决于输入 payload 是否足够有代表性。
相关转换路径
JSON SchemaJSON Schema
当前已具备双向支持,但复杂 schema 语义仍需谨慎审查。
AlphaParser 支持
✓已支持Generator 支持
✓已支持
JSON Schema
当前已具备双向支持,但复杂 schema 语义仍需谨慎审查。
Parser 支持
✓已支持Generator 支持
✓已支持JSON Schema 已经是一条真实的双向集成 surface,但更复杂的 construct 仍需要结合 diagnostics 一起判断。
当前表现较好的部分
parser 和 generator 都已具备现实价值
适合作为交换契约格式
和当前 TypeScript 相关路径配合较好
当前限制
高度动态的 schema pattern 可能退化成更宽泛的输出。
部分语义仍需要通过 diagnostics 理解 loss。
TypeScriptTypeScript
当前最强的建模入口,也最适合配合 JSON Schema 生成。
AlphaParser 支持
✓已支持Generator 支持
✓已支持
TypeScript
当前最强的建模入口,也最适合配合 JSON Schema 生成。
Parser 支持
✓已支持Generator 支持
✓已支持TypeScript 目前是最清晰、最容易让开发者快速理解价值的一种 developer-facing source format。
当前表现较好的部分
当前最强的建模体验
适合查看 typed model
和 JSON Schema generation 配合最好
当前限制
更高级的 TypeScript 语义可能会收敛成更简单的下游结构。
generator 侧输出的精度仍受当前 schema 模型支持边界影响。
从格式概览出发,查看对应的 parser、generator 和转换路径,再进入共享 Playground 验证实际结果。