@typespec/emitter-framework 0.9.0-dev.6 → 0.9.0-dev.8

package/src/csharp/components/enum/declaration.test.tsx

@@ -0,0 +1,267 @@
+import { Tester } from "#test/test-host.js";
+import { type Children } from "@alloy-js/core";
+import { createCSharpNamePolicy, Namespace, SourceFile } from "@alloy-js/csharp";
+import { t, type TesterInstance } from "@typespec/compiler/testing";
+import { beforeEach, expect, it } from "vitest";
+import { Output } from "../../../core/index.js";
+import { EnumDeclaration } from "../../index.js";
+
+let runner: TesterInstance;
+
+beforeEach(async () => {
+  runner = await Tester.createInstance();
+});
+
+function Wrapper(props: { children: Children }) {
+  const policy = createCSharpNamePolicy();
+  return (
+    <Output program={runner.program} namePolicy={policy}>
+      <Namespace name="TestNamespace">
+        <SourceFile path="test.cs">{props.children}</SourceFile>
+      </Namespace>
+    </Output>
+  );
+}
+
+it("renders a basic enum declaration", async () => {
+  const { TestEnum } = await runner.compile(t.code`
+    @test enum ${t.enum("TestEnum")} {
+      Value1;
+      Value2;
+      Value3;
+    }
+  `);
+
+  expect(
+    <Wrapper>
+      <EnumDeclaration type={TestEnum} />
+    </Wrapper>,
+  ).toRenderTo(`
+    namespace TestNamespace
+    {
+        enum TestEnum
+        {
+            Value1,
+            Value2,
+            Value3
+        }
+    }
+  `);
+});
+
+it("renders an empty enum declaration", async () => {
+  const { TestEnum } = await runner.compile(t.code`
+    @test enum ${t.enum("TestEnum")} {}
+  `);
+
+  expect(
+    <Wrapper>
+      <EnumDeclaration type={TestEnum} />
+    </Wrapper>,
+  ).toRenderTo(`
+    namespace TestNamespace
+    {
+        enum TestEnum
+        {
+
+        }
+    }
+  `);
+});
+
+it("can override enum name", async () => {
+  const { TestEnum } = await runner.compile(t.code`
+    @test enum ${t.enum("TestEnum")} {
+      Value1;
+      Value2;
+    }
+  `);
+
+  expect(
+    <Wrapper>
+      <EnumDeclaration type={TestEnum} name="CustomEnumName" />
+    </Wrapper>,
+  ).toRenderTo(`
+    namespace TestNamespace
+    {
+        enum CustomEnumName
+        {
+            Value1,
+            Value2
+        }
+    }
+  `);
+});
+
+it("renders an enum with access modifiers", async () => {
+  const { TestEnum } = await runner.compile(t.code`
+    @test enum ${t.enum("TestEnum")} {
+      Value1;
+      Value2;
+    }
+  `);
+
+  expect(
+    <Wrapper>
+      <EnumDeclaration type={TestEnum} internal />
+    </Wrapper>,
+  ).toRenderTo(`
+    namespace TestNamespace
+    {
+        internal enum TestEnum
+        {
+            Value1,
+            Value2
+        }
+    }
+  `);
+});
+
+it("renders enum with C# naming conventions", async () => {
+  const { TestEnum } = await runner.compile(t.code`
+    @test enum ${t.enum("TestEnum")} {
+      value_one;
+      value_two;
+      value_three;
+    }
+  `);
+
+  expect(
+    <Output program={runner.program} namePolicy={createCSharpNamePolicy()}>
+      <Namespace name="TestNamespace">
+        <SourceFile path="test.cs">
+          <EnumDeclaration type={TestEnum} />
+        </SourceFile>
+      </Namespace>
+    </Output>,
+  ).toRenderTo(`
+    namespace TestNamespace
+    {
+        enum TestEnum
+        {
+            ValueOne,
+            ValueTwo,
+            ValueThree
+        }
+    }
+  `);
+});
+
+it("renders enum with single value", async () => {
+  const { TestEnum } = await runner.compile(t.code`
+    @test enum ${t.enum("TestEnum")} {
+      OnlyValue;
+    }
+  `);
+
+  expect(
+    <Wrapper>
+      <EnumDeclaration type={TestEnum} />
+    </Wrapper>,
+  ).toRenderTo(`
+    namespace TestNamespace
+    {
+        enum TestEnum
+        {
+            OnlyValue
+        }
+    }
+  `);
+});
+
+it("renders enum with numeric-like member names", async () => {
+  const { TestEnum } = await runner.compile(t.code`
+    @test enum ${t.enum("TestEnum")} {
+      Value0;
+      Value1;
+      Value10;
+      Value100;
+    }
+  `);
+
+  expect(
+    <Wrapper>
+      <EnumDeclaration type={TestEnum} />
+    </Wrapper>,
+  ).toRenderTo(`
+    namespace TestNamespace
+    {
+        enum TestEnum
+        {
+            Value0,
+            Value1,
+            Value10,
+            Value100
+        }
+    }
+  `);
+});
+
+it("renders multiple enums in the same namespace", async () => {
+  const { TestEnum1, TestEnum2 } = await runner.compile(t.code`
+    @test enum ${t.enum("TestEnum1")} {
+      Value1;
+      Value2;
+    }
+    @test enum ${t.enum("TestEnum2")} {
+      OptionA;
+      OptionB;
+      OptionC;
+    }
+  `);
+
+  expect(
+    <Wrapper>
+      <EnumDeclaration type={TestEnum1} />
+      <hbr />
+      <EnumDeclaration type={TestEnum2} />
+    </Wrapper>,
+  ).toRenderTo(`
+    namespace TestNamespace
+    {
+        enum TestEnum1
+        {
+            Value1,
+            Value2
+        }
+        enum TestEnum2
+        {
+            OptionA,
+            OptionB,
+            OptionC
+        }
+    }
+  `);
+});
+
+it("renders an enum with doc comments", async () => {
+  const { TestEnum } = await runner.compile(t.code`
+    @test enum ${t.enum("TestEnum")} {
+      @doc("This is value one")
+      Value1;
+      /** This is value two */
+      Value2;
+    }
+  `);
+
+  expect(
+    <Wrapper>
+      <EnumDeclaration type={TestEnum} />
+    </Wrapper>,
+  ).toRenderTo(`
+    namespace TestNamespace
+    {
+        enum TestEnum
+        {
+            /// <summary>
+            /// This is value one
+            /// </summary>
+            Value1,
+            /// <summary>
+            /// This is value two
+            /// </summary>
+            Value2
+        }
+    }
+  `);
+});

package/src/csharp/components/{enum-declaration.tsx → enum/declaration.tsx}

@@ -1,17 +1,17 @@
-import * as ay from "@alloy-js/core";
+import { useTsp } from "#core/context/tsp-context.js";
+import { type Children, For } from "@alloy-js/core";
 import * as cs from "@alloy-js/csharp";
-import { Enum, Union } from "@typespec/compiler";
-import { useTsp } from "../../core/index.js";
-import { reportDiagnostic } from "../../lib.js";
-import { getDocComments } from "./utils/doc-comments.jsx";
-import { declarationRefkeys, efRefkey } from "./utils/refkey.js";
+import type { Enum, Union } from "@typespec/compiler";
+import { reportDiagnostic } from "../../../lib.js";
+import { getDocComments } from "../utils/doc-comments.jsx";
+import { declarationRefkeys, efRefkey } from "../utils/refkey.js";
 
 export interface EnumDeclarationProps extends Omit<cs.EnumDeclarationProps, "name"> {
   name?: string;
   type: Union | Enum;
 }
 
-export function EnumDeclaration(props: EnumDeclarationProps): ay.Children {
+export function EnumDeclaration(props: EnumDeclarationProps): Children {
   const { $ } = useTsp();
   let type: Enum;
   if ($.union.is(props.type)) {
@@ -33,7 +33,7 @@ export function EnumDeclaration(props: EnumDeclarationProps): ay.Children {
   return (
     <>
       <cs.EnumDeclaration name={name} refkey={refkeys} {...props}>
-        <ay.For each={members} joiner={",\n"}>
+        <For each={members} joiner={",\n"}>
           {([key, value]) => {
             return (
               <>
@@ -49,7 +49,7 @@ export function EnumDeclaration(props: EnumDeclarationProps): ay.Children {
               </>
             );
           }}
-        </ay.For>
+        </For>
       </cs.EnumDeclaration>
     </>
   );

package/src/csharp/components/index.ts

@@ -1,4 +1,4 @@
 export * from "./class/declaration.js";
-export * from "./enum-declaration.jsx";
+export * from "./enum/declaration.jsx";
 export * from "./property/property.jsx";
 export * from "./type-expression.jsx";

package/src/csharp/components/property/property.test.tsx

@@ -1,7 +1,7 @@
 import { Tester } from "#test/test-host.js";
-import { Children } from "@alloy-js/core";
+import { type Children } from "@alloy-js/core";
 import { ClassDeclaration, createCSharpNamePolicy, Namespace, SourceFile } from "@alloy-js/csharp";
-import { t, TesterInstance } from "@typespec/compiler/testing";
+import { t, type TesterInstance } from "@typespec/compiler/testing";
 import { beforeEach, describe, expect, it } from "vitest";
 import { Output } from "../../../core/components/output.jsx";
 import { Property } from "./property.jsx";
@@ -39,10 +39,10 @@ it("maps prop: string | null to nullable property", async () => {
   ).toRenderTo(`
       namespace TestNamespace
       {
-        class Test
-        {
-          public required string? Prop1 { get; set; }
-        }
+          class Test
+          {
+              public required string? Prop1 { get; set; }
+          }
       }
   `);
 });
@@ -62,11 +62,11 @@ describe("jsonAttributes", () => {
     ).toRenderTo(`
       namespace TestNamespace
       {
-        class Test
-        {
-          [System.Text.Json.JsonPropertyName("prop1")]
-          public required string Prop1 { get; set; }
-        }
+          class Test
+          {
+              [System.Text.Json.JsonPropertyName("prop1")]
+              public required string Prop1 { get; set; }
+          }
       }
   `);
   });
@@ -86,11 +86,11 @@ describe("jsonAttributes", () => {
     ).toRenderTo(`
       namespace TestNamespace
       {
-        class Test
-        {
-          [System.Text.Json.JsonPropertyName("prop_1")]
-          public required string Prop1 { get; set; }
-        }
+          class Test
+          {
+              [System.Text.Json.JsonPropertyName("prop_1")]
+              public required string Prop1 { get; set; }
+          }
       }
   `);
   });

package/src/csharp/components/property/property.tsx

@@ -1,7 +1,7 @@
-import { Children } from "@alloy-js/core";
+import { type Children } from "@alloy-js/core";
 import * as cs from "@alloy-js/csharp";
 import { Attribute } from "@alloy-js/csharp";
-import { ModelProperty, resolveEncodedName, Type } from "@typespec/compiler";
+import { type ModelProperty, resolveEncodedName, type Type } from "@typespec/compiler";
 import { useTsp } from "../../../core/index.js";
 import { TypeExpression } from "../type-expression.jsx";
 import { getDocComments } from "../utils/doc-comments.jsx";

package/src/csharp/components/type-expression.test.tsx

@@ -1,8 +1,8 @@
-import { Children, render } from "@alloy-js/core";
+import { type Children, render } from "@alloy-js/core";
 import { d } from "@alloy-js/core/testing";
 import { Namespace, SourceFile } from "@alloy-js/csharp";
-import { Model, ModelProperty } from "@typespec/compiler";
-import { BasicTestRunner } from "@typespec/compiler/testing";
+import type { Model, ModelProperty } from "@typespec/compiler";
+import type { BasicTestRunner } from "@typespec/compiler/testing";
 import { beforeEach, describe, it } from "vitest";
 import { createEmitterFrameworkTestRunner } from "../../../test/typescript/test-host.js";
 import { assertFileContents } from "../../../test/utils.js";

package/src/csharp/components/type-expression.tsx

@@ -1,7 +1,7 @@
-import { Children, code } from "@alloy-js/core";
+import { type Children, code } from "@alloy-js/core";
 import { Reference } from "@alloy-js/csharp";
-import { getTypeName, IntrinsicType, Scalar, Type } from "@typespec/compiler";
-import { Typekit } from "@typespec/compiler/typekit";
+import { getTypeName, type IntrinsicType, type Scalar, type Type } from "@typespec/compiler";
+import type { Typekit } from "@typespec/compiler/typekit";
 import { useTsp } from "../../core/index.js";
 import { reportTypescriptDiagnostic } from "../../typescript/lib.js";
 import { efRefkey } from "./utils/refkey.js";

package/src/csharp/components/utils/doc-comments.tsx

@@ -1,7 +1,7 @@
-import * as ay from "@alloy-js/core";
+import { type Children, List } from "@alloy-js/core";
 import * as cs from "@alloy-js/csharp";
-import { getReturnsDoc, Type } from "@typespec/compiler";
-import { Typekit } from "@typespec/compiler/typekit";
+import { getReturnsDoc, type Type } from "@typespec/compiler";
+import type { Typekit } from "@typespec/compiler/typekit";
 
 /**
  * Helper to render a doc string for a given TypeSpec type.
@@ -12,13 +12,13 @@ import { Typekit } from "@typespec/compiler/typekit";
  * @param type The TypeSpec type to generate documentation for
  * @returns A DocSummary component containing the rendered doc string, or undefined if no doc is available.
  */
-export function getDocComments($: Typekit, type: Type): ay.Children {
+export function getDocComments($: Typekit, type: Type): Children {
   const typeDoc = $.type.getDoc(type);
   if (!typeDoc) {
     return undefined;
   }
 
-  const docElements: ay.Children[] = [];
+  const docElements: Children[] = [];
 
   // Add main type documentation
   docElements.push(
@@ -54,5 +54,5 @@ export function getDocComments($: Typekit, type: Type): ay.Children {
     }
   }
 
-  return <ay.List doubleHardline>{docElements}</ay.List>;
+  return <List doubleHardline>{docElements}</List>;
 }

package/src/testing/index.ts

@@ -1,5 +1,5 @@
 import { resolvePath } from "@typespec/compiler";
-import { createTestLibrary, TypeSpecTestLibrary } from "@typespec/compiler/testing";
+import { createTestLibrary, type TypeSpecTestLibrary } from "@typespec/compiler/testing";
 import { fileURLToPath } from "url";
 
 export const EmitterFrameworkTestLibrary: TypeSpecTestLibrary = createTestLibrary({

package/src/testing/scenario-test/harness.ts

@@ -1,11 +1,11 @@
 import { normalizePath } from "@typespec/compiler";
-import { TypeSpecTestLibrary } from "@typespec/compiler/testing";
+import type { TypeSpecTestLibrary } from "@typespec/compiler/testing";
 import { readdirSync, readFileSync, statSync, writeFileSync } from "fs";
 import minimist from "minimist";
 import path from "path";
 import { format } from "prettier";
 import { afterAll, describe, expect, it } from "vitest";
-import { LanguageConfiguration, SnippetExtractor } from "./snippet-extractor.js";
+import type { LanguageConfiguration, SnippetExtractor } from "./snippet-extractor.js";
 import { emitWithDiagnostics } from "./test-host.js";
 
 const rawArgs = process.env.TEST_ARGS ? process.env.TEST_ARGS.split(" ") : [];

package/src/testing/scenario-test/test-host.ts

@@ -1,10 +1,10 @@
-import { CompilerOptions, Diagnostic } from "@typespec/compiler";
+import type { CompilerOptions, Diagnostic } from "@typespec/compiler";
 import {
-  BasicTestRunner,
+  type BasicTestRunner,
   createTestHost,
   createTestWrapper,
-  TestHostConfig,
-  TypeSpecTestLibrary,
+  type TestHostConfig,
+  type TypeSpecTestLibrary,
 } from "@typespec/compiler/testing";
 import { HttpTestLibrary } from "@typespec/http/testing";
 import { RestTestLibrary } from "@typespec/rest/testing";

package/src/typescript/components/array-expression.tsx

@@ -1,5 +1,5 @@
-import * as ay from "@alloy-js/core";
-import { Type } from "@typespec/compiler";
+import { code } from "@alloy-js/core";
+import type { Type } from "@typespec/compiler";
 import { TypeExpression } from "./type-expression.js";
 
 export interface ArrayExpressionProps {
@@ -7,5 +7,5 @@ export interface ArrayExpressionProps {
 }
 
 export function ArrayExpression({ elementType }: ArrayExpressionProps) {
-  return ay.code`Array<${(<TypeExpression type={elementType} />)}>`;
+  return code`Array<${(<TypeExpression type={elementType} />)}>`;
 }

package/src/typescript/components/arrow-function.tsx

@@ -1,6 +1,6 @@
 import { splitProps } from "@alloy-js/core";
 import * as ts from "@alloy-js/typescript";
-import { Operation } from "@typespec/compiler";
+import type { Operation } from "@typespec/compiler";
 import { buildParameterDescriptors, getReturnType } from "../utils/operation.js";
 import { TypeExpression } from "./type-expression.jsx";
 

package/src/typescript/components/class-method.tsx

@@ -1,5 +1,5 @@
 import * as ts from "@alloy-js/typescript";
-import { Operation } from "@typespec/compiler";
+import type { Operation } from "@typespec/compiler";
 import { buildParameterDescriptors, getReturnType } from "../utils/operation.js";
 import { TypeExpression } from "./type-expression.jsx";
 

package/src/typescript/components/enum-declaration.tsx

@@ -1,6 +1,6 @@
-import * as ay from "@alloy-js/core";
+import { type Children, For, type Refkey } from "@alloy-js/core";
 import * as ts from "@alloy-js/typescript";
-import { Enum, EnumMember as TspEnumMember, Union } from "@typespec/compiler";
+import type { Enum, EnumMember as TspEnumMember, Union } from "@typespec/compiler";
 import { useTsp } from "../../core/context/tsp-context.js";
 import { reportDiagnostic } from "../../lib.js";
 import { declarationRefkeys, efRefkey } from "../utils/refkey.js";
@@ -38,7 +38,7 @@ export function EnumDeclaration(props: EnumDeclarationProps) {
       default={props.default}
       export={props.export}
     >
-      <ay.For each={members} joiner={",\n"}>
+      <For each={members} joiner={",\n"}>
         {([key, value]) => {
           const memberDoc = $.type.getDoc(value);
           return (
@@ -51,15 +51,15 @@ export function EnumDeclaration(props: EnumDeclarationProps) {
             />
           );
         }}
-      </ay.For>
+      </For>
     </ts.EnumDeclaration>
   );
 }
 
 export interface EnumMemberProps {
   type: TspEnumMember;
-  doc?: ay.Children;
-  refkey?: ay.Refkey;
+  doc?: Children;
+  refkey?: Refkey;
 }
 
 export function EnumMember(props: EnumMemberProps) {

package/src/typescript/components/function-declaration.tsx

@@ -1,5 +1,5 @@
 import * as ts from "@alloy-js/typescript";
-import { Model, Operation } from "@typespec/compiler";
+import type { Model, Operation } from "@typespec/compiler";
 import { useTsp } from "../../core/index.js";
 import { buildParameterDescriptors, getReturnType } from "../utils/operation.js";
 import { declarationRefkeys } from "../utils/refkey.js";

package/src/typescript/components/function-expression.tsx

@@ -1,6 +1,6 @@
 import { splitProps } from "@alloy-js/core";
 import * as ts from "@alloy-js/typescript";
-import { Operation } from "@typespec/compiler";
+import type { Operation } from "@typespec/compiler";
 import { buildParameterDescriptors, getReturnType } from "../utils/operation.js";
 import { TypeExpression } from "./type-expression.jsx";
 

package/src/typescript/components/function-type.tsx

@@ -1,6 +1,6 @@
 import { splitProps } from "@alloy-js/core";
 import * as ts from "@alloy-js/typescript";
-import { Operation } from "@typespec/compiler";
+import type { Operation } from "@typespec/compiler";
 import { buildParameterDescriptors, getReturnType } from "../utils/operation.js";
 import { TypeExpression } from "./type-expression.jsx";
 

package/src/typescript/components/interface-declaration.tsx

@@ -1,15 +1,14 @@
-import * as ay from "@alloy-js/core";
-import { Children, mapJoin } from "@alloy-js/core";
+import { Block, type Children, For, mapJoin } from "@alloy-js/core";
 import * as ts from "@alloy-js/typescript";
 import {
-  Interface,
+  type Interface,
   isNeverType,
-  Model,
-  ModelProperty,
-  Operation,
-  RekeyableMap,
+  type Model,
+  type ModelProperty,
+  type Operation,
+  type RekeyableMap,
 } from "@typespec/compiler";
-import { Typekit } from "@typespec/compiler/typekit";
+import type { Typekit } from "@typespec/compiler/typekit";
 import { createRekeyableMap } from "@typespec/compiler/utils";
 import { useTsp } from "../../core/context/tsp-context.js";
 import { reportDiagnostic } from "../../lib.js";
@@ -74,9 +73,9 @@ export interface InterfaceExpressionProps extends ts.InterfaceExpressionProps {
 
 export function InterfaceExpression(props: InterfaceExpressionProps) {
   return (
-    <ay.Block>
+    <Block>
       <InterfaceBody {...props} />
-    </ay.Block>
+    </Block>
   );
 }
 
@@ -156,11 +155,11 @@ function InterfaceBody(props: TypedInterfaceDeclarationProps): Children {
 
   return (
     <>
-      <ay.For each={validTypeMembers} semicolon line {...enderProp}>
+      <For each={validTypeMembers} semicolon line {...enderProp}>
         {(typeMember) => {
           return <InterfaceMember type={typeMember} />;
         }}
-      </ay.For>
+      </For>
       {props.children}
     </>
   );

package/src/typescript/components/interface-member.tsx

@@ -1,6 +1,6 @@
-import { Children } from "@alloy-js/core";
+import { type Children } from "@alloy-js/core";
 import * as ts from "@alloy-js/typescript";
-import { isNeverType, ModelProperty, Operation } from "@typespec/compiler";
+import { isNeverType, type ModelProperty, type Operation } from "@typespec/compiler";
 import { getHttpPart } from "@typespec/http";
 import { useTsp } from "../../core/context/tsp-context.js";
 import { InterfaceMethod } from "./interface-method.jsx";

package/src/typescript/components/interface-method.tsx

@@ -1,6 +1,6 @@
-import { Children, splitProps } from "@alloy-js/core";
+import { type Children, splitProps } from "@alloy-js/core";
 import * as ts from "@alloy-js/typescript";
-import { Operation } from "@typespec/compiler";
+import type { Operation } from "@typespec/compiler";
 import { useTsp } from "../../core/index.js";
 import { buildParameterDescriptors, getReturnType } from "../utils/operation.js";
 import { TypeExpression } from "./type-expression.jsx";

package/src/typescript/components/record-expression.tsx

@@ -1,5 +1,5 @@
 import { code } from "@alloy-js/core";
-import { Type } from "@typespec/compiler";
+import type { Type } from "@typespec/compiler";
 import { TypeExpression } from "./type-expression.js";
 
 export interface RecordExpressionProps {

package/src/typescript/components/type-alias-declaration.tsx

@@ -1,5 +1,5 @@
 import * as ts from "@alloy-js/typescript";
-import { Type } from "@typespec/compiler";
+import type { Type } from "@typespec/compiler";
 import { useTsp } from "../../core/context/tsp-context.js";
 import { reportDiagnostic } from "../../lib.js";
 import { declarationRefkeys } from "../utils/refkey.js";