fielddocs

type Field struct {
	// Name 是相对所属结构体的键名，也是 manifest 里的字段名。
	Name string
	// Type 是该字段的 Go 类型，数组和指针保留书写形式。
	Type string
	// Doc 是去掉字段名前缀后的说明文本。
	Doc string
	// Optional 表示该字段的 json tag 带 omitempty，未设置时为零值即不输出。
	Optional bool
}

type Schema struct {
	// Root 是根结构体名。
	Root string
	// Types 是全部结构体说明。
	Types []TypeDoc
	// Recursive 列出被多处引用的结构体名，它们只展开一次。
	Recursive []string
}

type TypeDoc struct {
	// Name 是 Go 结构体名，例如 Item。
	Name string
	// Doc 是结构体自身的说明。
	Doc string
	// Path 是从 manifest 根首次到达该结构体的路径，根结构体为空串，例如
	// pages[].items[].fill_color.radial。字段的完整路径是在本路径后追加字段名，
	// 结构体字段还要追加 "[]"（如 pages[].items[]）。
	Path string
	// Fields 是该结构体的直接字段。
	Fields []Field
}