格式目录

格式

浏览当前单格式支持面,比较 parser 和 generator 的准备程度,并判断每种格式现在已经可靠到什么程度。

支持概览

这个页面的目标,是让开发者先判断单一格式本身是否足够可用,再决定是否继续看某一条转换路径。

已展示格式

3

可作为 parser 输入

3

可作为 generator 输出

2

浏览当前格式支持情况

每一种格式都应该回答一个很实际的问题:它现在作为输入 parser、输出 generator,还是两者兼具,到底有多可信?

JSON

JSON

Parser 很强、暂不支持 generator,最适合快速推断。

Beta

Parser 支持

已支持

Generator 支持

不支持

JSON 目前最适合作为轻量 source format,用来做 sample-driven inference 和快速探索。

当前表现较好的部分

适合快速接入 sample

适合探索式类型推断

可以顺畅进入 TypeScript inference

当前限制

在当前公开 Playground 流程里,JSON 还不是输出 target。

样例覆盖度完全取决于输入 payload 是否足够有代表性。

相关转换路径

JSON Schema

JSON Schema

当前已具备双向支持,但复杂 schema 语义仍需谨慎审查。

Alpha

Parser 支持

已支持

Generator 支持

已支持

JSON Schema 已经是一条真实的双向集成 surface,但更复杂的 construct 仍需要结合 diagnostics 一起判断。

当前表现较好的部分

parser 和 generator 都已具备现实价值

适合作为交换契约格式

和当前 TypeScript 相关路径配合较好

当前限制

高度动态的 schema pattern 可能退化成更宽泛的输出。

部分语义仍需要通过 diagnostics 理解 loss。

TypeScript

TypeScript

当前最强的建模入口,也最适合配合 JSON Schema 生成。

Alpha

Parser 支持

已支持

Generator 支持

已支持

TypeScript 目前是最清晰、最容易让开发者快速理解价值的一种 developer-facing source format。

当前表现较好的部分

当前最强的建模体验

适合查看 typed model

和 JSON Schema generation 配合最好

当前限制

更高级的 TypeScript 语义可能会收敛成更简单的下游结构。

generator 侧输出的精度仍受当前 schema 模型支持边界影响。

从格式支持到实际转换

从格式概览出发,查看对应的 parser、generator 和转换路径,再进入共享 Playground 验证实际结果。