✨ Root resource and OpenAPI emit

Adds the `Root` resource. Installs http, rest, and openapi TypeSpec
packages. Emits Open API document.

.gitignore

@@ -1 +1,2 @@
+dist/
 node_modules/

main.tsp

@@ -1,2 +1,26 @@
-@service
-namespace SWAPI;
+import "@typespec/http";
+import "@typespec/rest";
+
+using TypeSpec.Http;
+using TypeSpec.Rest;
+
+@service({
+	title: "SWAPI: The Star Wars API",
+	version: "v1",
+})
+@server("https://swapi.dev/api/", "SWAPI server")
+namespace SWAPI {
+	@route("/")
+	@get
+	op root(): Root;
+
+	// https://swapi.dev/documentation#root
+	model Root {
+		films: string;
+		people: string;
+		planets: string;
+		species: string;
+		starships: string;
+		vehicles: string;
+	}
+}

package.json

@@ -5,17 +5,20 @@
 	"type": "module",
 	"scripts": {
 		"build": "tsp compile .",
-		"format": "prettier -l '**/*.{json,md,tsp}'",
+		"format": "prettier -l '**/*.{json,md,tsp,yaml}'",
 		"format:fix": "npm run format -- -w",
 		"prepare": "is-ci || husky install",
 		"release": "npm run build && npm run format"
 	},
 	"lint-staged": {
-		"**/*.{json,md,tsp}": "prettier -w"
+		"**/*.{json,md,tsp,yaml}": "prettier -w"
 	},
 	"devDependencies": {
 		"@typespec/compiler": "~0.47.1",
-		"@typespec/prettier-plugin-typespec": "^0.47.0",
+		"@typespec/http": "~0.47.0",
+		"@typespec/openapi3": "~0.47.0",
+		"@typespec/prettier-plugin-typespec": "~0.47.0",
+		"@typespec/rest": "~0.47.0",
 		"husky": "^8.0.3",
 		"is-ci": "^3.0.1",
 		"lint-staged": "^14.0.1",

tspconfig.yaml

@@ -0,0 +1,7 @@
+emit:
+  - "@typespec/openapi3"
+options:
+  "@typespec/openapi3":
+    emitter-output-dir: "{project-root}/dist"
+    omit-unreachable-types: true
+    output-file: "swapi.openapi.yaml"