Reorganize test files by feature instead of origin

Dissolve design-doc-examples.test.ts, coverage-gaps.test.ts,
emitter.test.ts, and diagnostics.test.ts — distribute their tests
into feature-focused files. Create new files for unions, enums,
arrays, deprecation, circular references, and doc comments.

197 tests across 17 files (was 197 across 15).

Author: FionaBronwen

packages/graphql/test/arrays.test.ts

@@ -0,0 +1,72 @@
+import { strictEqual } from "node:assert";
+import { describe, it } from "vitest";
+import { emitSingleSchema } from "./test-host.js";
+
+describe("arrays", () => {
+  it("supports array types", async () => {
+    const code = `
+      @schema
+      namespace TestNamespace {
+        model Tag {
+          name: string;
+          color: string;
+        }
+
+        model Article {
+          id: string;
+          title: string;
+          tags: Tag[];
+          categories: string[];
+        }
+
+        @query
+        op getArticle(id: string): Article;
+
+        @query
+        op listArticles(): Article[];
+      }
+    `;
+
+    const result = await emitSingleSchema(code, {});
+
+    strictEqual(result.includes("tags: [Tag!]!"), true);
+    strictEqual(result.includes("categories: [String!]!"), true);
+    strictEqual(result.includes("listArticles: [Article!]"), true);
+  });
+
+  it("emits list types for array properties", async () => {
+    const code = `
+      @schema
+      namespace TestNamespace {
+        model User {
+          id: string;
+          tags: string[];
+        }
+
+        @query
+        op getUser(): User;
+      }
+    `;
+
+    const result = await emitSingleSchema(code, {});
+    strictEqual(result.includes("tags: [String!]!"), true);
+  });
+
+  it("emits nullable list items for optional element types", async () => {
+    const code = `
+      @schema
+      namespace TestNamespace {
+        model User {
+          id: string;
+          tags: (string | null)[];
+        }
+
+        @query
+        op getUser(): User;
+      }
+    `;
+
+    const result = await emitSingleSchema(code, {});
+    strictEqual(result.includes("tags: [String]!"), true);
+  });
+});

packages/graphql/test/circular-references.test.ts

@@ -0,0 +1,47 @@
+import { strictEqual } from "node:assert";
+import { describe, it } from "vitest";
+import { emitSingleSchema } from "./test-host.js";
+
+describe("circular references", () => {
+  it("handles circular references between models", async () => {
+    const code = `
+      @schema
+      namespace TestNamespace {
+        model User {
+          id: string;
+          name: string;
+          posts: Post[];
+        }
+
+        model Post {
+          id: string;
+          title: string;
+          author: User;
+          comments: Comment[];
+        }
+
+        model Comment {
+          id: string;
+          text: string;
+          author: User;
+          post: Post;
+        }
+
+        @query
+        op getUser(id: string): User;
+
+        @query
+        op getPost(id: string): Post;
+      }
+    `;
+
+    const result = await emitSingleSchema(code, {});
+
+    strictEqual(result.includes("type User {"), true);
+    strictEqual(result.includes("posts: [Post!]!"), true);
+    strictEqual(result.includes("type Post {"), true);
+    strictEqual(result.includes("author: User!"), true);
+    strictEqual(result.includes("comments: [Comment!]!"), true);
+    strictEqual(result.includes("type Comment {"), true);
+  });
+});

packages/graphql/test/coverage-gaps.test.ts

@@ -0,0 +1,31 @@
+import { strictEqual } from "node:assert";
+import { describe, it } from "vitest";
+import { emitSingleSchema } from "./test-host.js";
+
+describe("deprecation", () => {
+  it("supports @deprecated directive", async () => {
+    const code = `
+      @schema
+      namespace TestNamespace {
+        model User {
+          id: string;
+          name: string;
+          #deprecated "Use email instead"
+          username: string;
+        }
+
+        @query
+        op getUser(id: string): User;
+
+        #deprecated "Use getUserById instead"
+        @query
+        op findUser(id: string): User;
+      }
+    `;
+
+    const result = await emitSingleSchema(code, {});
+
+    strictEqual(result.includes('@deprecated(reason: "Use email instead")'), true);
+    strictEqual(result.includes('@deprecated(reason: "Use getUserById instead")'), true);
+  });
+});