TypeSpec: new parser

Author: iaalm

Units/parser-typespec.r/simple-typespec.d/args.ctags

@@ -0,0 +1 @@
+--sort=no

Units/parser-typespec.r/simple-typespec.d/expected.tags

@@ -0,0 +1,11 @@
+Name.Space	input.tsp	/^namespace Name.Space;$/;"	n
+Versions	input.tsp	/^enum Versions {$/;"	g
+OpA	input.tsp	/^op OpA<T extends TypeSpec.Reflection.Model> is OpB<$/;"	o
+InterfaceA	input.tsp	/^interface InterfaceA extends InterfaceB {$/;"	i
+opA	input.tsp	/^  opA is OpA<{$/;"	p	interface:InterfaceA
+opB	input.tsp	/^    opB: url;$/;"	p	interface:InterfaceA
+UnionA	input.tsp	/^union UnionA {$/;"	u
+ModelA	input.tsp	/^model ModelA {$/;"	m
+contentA	input.tsp	/^  contentA: ModelB;$/;"	p	model:ModelA
+contentB	input.tsp	/^  contentB?: boolean;$/;"	p	model:ModelA
+AliasA	input.tsp	/^alias AliasA<$/;"	a

Units/parser-typespec.r/simple-typespec.d/input.tsp

@@ -0,0 +1,83 @@
+import "@typespec/http";
+import "./common.tsp";
+
+using TypeSpec;
+using TypeSpec.Rest;
+
+@armProviderNamespace
+@service(#{ title: "Name.Space" })
+@versioned(Versions)
+@armCommonTypesVersion(CommonTypes.Versions.v3)
+namespace Name.Space;
+
+@doc("API Versions")
+enum Versions {
+  @doc("May 01, 2024 Preview API Version")
+  v2024_05_01_preview: "2024-05-01-preview",
+}
+
+@summary("Example operation summary for demonstration purposes.")
+@doc("""
+  Example
+  multi-line
+  documentation.
+  """)
+@returnsDoc("Example return documentation")
+@post
+op OpA<T extends TypeSpec.Reflection.Model> is OpB<
+  T & ModelA,
+  ModelB<ModelA[]>
+>;
+
+interface InterfaceA extends InterfaceB {
+  opA is OpA<{
+    @doc("The format of the HTTP payload.")
+    @header
+    contentType: "application/json";
+
+    @clientName("uri", "csharp")
+    @doc("Example URL parameter.")
+    opB: url;
+  }>;
+
+  /**
+   * Example operation description
+   */
+  opB is OpB<
+    ModelA,
+    {
+      ...ModelB
+    }
+  >;
+}
+
+@doc("Example union type description.")
+union UnionA {
+  string,
+
+  @doc("Example option A description with some technical details that would be typical for this kind of documentation.")
+  "unionA",
+
+  @doc("Example option B description with additional technical context that would be common in API documentation.")
+  "unionB",
+}
+
+@doc("Example model description.")
+model ModelA {
+  @doc("Example property description.")
+  contentA: ModelB;
+
+  @removed(Versions.v1_2)
+  @doc("Example boolean property with typical documentation about its purpose and default behavior.")
+  contentB?: boolean;
+
+  ...ModelX;
+}
+
+
+alias AliasA<
+  TParamA extends ModelX,
+  TParamB,
+  TParamC extends ModelX = {},
+  TError = Error
+> = ModelB<TParamA, TParamB, TParamC, TError>;

main/parsers_p.h

@@ -188,6 +188,7 @@
 	TTCNParser, \
 	Txt2tagsParser, \
 	TypeScriptParser, \
+	TypeSpecParser, \
 	VParser, \
 	VeraParser, \
 	VerilogParser, \