用这份快照了解当前可以尝试什么,以及哪些路径仍需要结合 diagnostics 判断。
当前可运行路径
3
Source formats
3
已记录路径
3
对比当前支持的路径、部分支持的路径,以及运行转换前需要了解的限制。
从 typed source model 开始
TypeScript 目前是最清晰的一条 source 路径,适合先走通到结构化 schema 输出。
TypeScript -> JSON Schema
当前最强的一条路径,object shape 表现较好,但高级 TypeScript 语义仍有边界。
Alpha✓已支持TypeScriptJSON Schema
TypeScript -> JSON Schema
当前最强的一条路径,object shape 表现较好,但高级 TypeScript 语义仍有边界。
这是当前最成熟的一条路径,适合把 interface 风格模型转成可移植的 schema 输出。
当前表现较好的部分
Interfaces 和 object shapes
Primitive fields 与 arrays
Optional properties
当前限制
更复杂的 TypeScript 语义仍会收敛成更简单的 schema 结构。
遇到不支持的构造时需要结合 diagnostics 一起看。
从 schema 定义回到类型模型
JSON Schema 已经是一条真实可用的集成路径,但部分语义仍需要结合 diagnostics 细看。
JSON Schema -> TypeScript
这条 schema 双向路径已经可用,但复杂 schema 语义仍需要结合 diagnostics 审查。
Alpha✓已支持JSON SchemaTypeScript
JSON Schema -> TypeScript
这条 schema 双向路径已经可用,但复杂 schema 语义仍需要结合 diagnostics 审查。
适合把 schema 定义重新转回面向 TypeScript 的模型视图。
当前表现较好的部分
Object properties 和 required fields
Primitive schema types
基础 title 与 model name
当前限制
某些 schema construct 会退化成更宽泛的 TypeScript 输出。
pattern 驱动或高度动态的 schema 场景需要额外审查。
从真实 payload 样例推断
Raw JSON 输入更适合快速探索,而不是承诺完整语义保持的正式工作流。
JSON -> TypeScript
适合快速探索式推断,但结果质量完全依赖 sample payload 的代表性。
Beta◐部分支持JSONTypeScript
JSON -> TypeScript
适合快速探索式推断,但结果质量完全依赖 sample payload 的代表性。
适合基于一段代表性 payload 快速推断出一个 typed model。
当前表现较好的部分
Primitive values
Nested objects
基于 sample payload 的 array inference
当前限制
只能转换当前观察到的 sample shape。
输入覆盖度完全取决于样例是否足够有代表性。
这条路径最适合作为第一条重点 Playground context,因为它最能代表当前产品阶段下最强的一条工作流,也最符合用户直觉。
当前表现最好的部分
Interfaces 和 object shapes
Primitive fields 与 arrays
Optional properties
当前 caveats
更复杂的 TypeScript 语义仍会收敛成更简单的 schema 结构。
遇到不支持的构造时需要结合 diagnostics 一起看。
选择一条已记录的路径,先查看支持信号,再在准备好后打开对应的 Playground 流程。
先用这个页面理解路径成熟度,再进入 Playground 或后续更深入的路径说明。