Add TypeSpec Definition for APIView TreeStyle Parser

[chidozieononiwu]

• TypeSpec Definition for APIView TreeStyle Parser

[tjprescott]

I'm confused. I was expecting this PR to contain two things: 1) the TypeSpec definition for APIView and 2) the generated JSON schema of the same.

This seems to be an outline of a TypeSpec library for APIView, but I don't understand why, or what it is doing?

[tjprescott]

Overall this is a great step forward. Two things I would like to see:

1. a script of some kind (though preferably not Powershell) that would allow you to evaluate a provided tokenfile against the generated JSON schema. Every inner-loop dev will need to do that, so that should live here.
2. Some kind of automated test that would compare test tokenfiles against both the JSON schema and the server parsing logic. This will help ensure that if the server logic changes, that the TypeSpec and JSON schema and likewise updated.

[tjprescott]

Overall this is a great step forward. Two things I would like to see:

1. a script of some kind (though preferably not Powershell) that would allow you to evaluate a provided tokenfile against the generated JSON schema. Every inner-loop dev will need to do that, so that should live here.

@chidozieononiwu the JSON registry that Jonathan was mentioning will probably suffice for this, which is great. It will also simplify ask 2.

[lmazuel]

Approving to work in a more incremental way, but @tjprescott point about incorporating the TypeSpec and schema into automation should be taken into account seriously
CC @maririos @weshaggard

[chidozieononiwu]

Approving to work in a more incremental way, but @tjprescott point about incorporating the TypeSpec and schema into automation should be taken into account seriously CC @maririos @weshaggard

I have updated the tracking issue
#8517