@alloy-js/csharp 0.20.0-dev.1 → 0.20.0-dev.10

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

@@ -0,0 +1,93 @@
+import { Namespace } from "#components/namespace.jsx";
+import { SourceFile } from "#components/source-file/source-file.jsx";
+import { Output, refkey } from "@alloy-js/core";
+import { d } from "@alloy-js/core/testing";
+import { expect, it } from "vitest";
+import { EnumDeclaration } from "./declaration.jsx";
+import { EnumMember } from "./member.jsx";
+
+it("can reference things by refkey", () => {
+  const enumRK = refkey();
+  const twoRK = refkey();
+
+  const tree = (
+    <Output>
+      <Namespace name="TestCode">
+        <SourceFile path="Test.cs">
+          <EnumDeclaration public name="TestEnum" refkey={enumRK}>
+            <EnumMember name="One" />,<hbr />
+            <EnumMember name="Two" refkey={twoRK} />
+          </EnumDeclaration>
+          <hbr />
+          {enumRK};<hbr />
+          {twoRK};
+        </SourceFile>
+      </Namespace>
+    </Output>
+  );
+  expect(tree).toRenderTo(d`
+    namespace TestCode;
+
+    public enum TestEnum
+    {
+        One,
+        Two
+    }
+    TestEnum;
+    TestEnum.Two;
+  `);
+});
+
+it("can reference things by refkey across files", () => {
+  const enumRK = refkey();
+  const barRK = refkey();
+
+  const tree = (
+    <Output>
+      <Namespace name="TestCode">
+        <SourceFile path="Test.cs">
+          <EnumDeclaration public name="TestEnum">
+            <EnumMember name="One" />,<hbr />
+            <EnumMember name="Two" />
+          </EnumDeclaration>
+          <hbr />
+          {enumRK};<hbr />
+          {barRK};
+        </SourceFile>
+        <SourceFile path="Other.cs">
+          <EnumDeclaration public name="OtherEnum" refkey={enumRK}>
+            <EnumMember name="Foo" />,<hbr />
+            <EnumMember name="Bar" refkey={barRK} />
+          </EnumDeclaration>
+          <hbr />
+          {enumRK};<hbr />
+          {barRK};
+        </SourceFile>
+      </Namespace>
+    </Output>
+  );
+  expect(tree).toRenderTo({
+    "Test.cs": d`
+      namespace TestCode;
+
+      public enum TestEnum
+      {
+          One,
+          Two
+      }
+      OtherEnum;
+      OtherEnum.Bar;
+    `,
+    "Other.cs": d`
+      namespace TestCode;
+
+      public enum OtherEnum
+      {
+          Foo,
+          Bar
+      }
+      OtherEnum;
+      OtherEnum.Bar;
+    `,
+  });
+});

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

@@ -0,0 +1,34 @@
+import { toSourceText } from "#test/utils.jsx";
+import { d } from "@alloy-js/core/testing";
+import { expect, it } from "vitest";
+import { EnumDeclaration } from "./declaration.jsx";
+import { EnumMember } from "./member.jsx";
+
+it("declares enum with no members", () => {
+  const res = toSourceText(<EnumDeclaration public name="TestEnum" />);
+
+  expect(res).toBe(d`
+    namespace TestCode;
+
+    public enum TestEnum;
+  `);
+});
+
+it("applies naming policy to enum and members", () => {
+  const res = toSourceText(
+    <EnumDeclaration public name="testEnum">
+      <EnumMember name="one" />,<hbr />
+      <EnumMember name="two" />
+    </EnumDeclaration>,
+  );
+
+  expect(res).toBe(d`
+    namespace TestCode;
+
+    public enum TestEnum
+    {
+        One,
+        Two
+    }
+  `);
+});

package/src/components/enum/declaration.tsx

@@ -0,0 +1,65 @@
+import {
+  Block,
+  Children,
+  Declaration,
+  MemberScope,
+  Refkey,
+} from "@alloy-js/core";
+import {
+  AccessModifiers,
+  computeModifiersPrefix,
+  getAccessModifier,
+} from "../../modifiers.js";
+import { useCSharpNamePolicy } from "../../name-policy.js";
+import { createNamedTypeScope } from "../../scopes/factories.js";
+import { createNamedTypeSymbol } from "../../symbols/factories.js";
+import { Name } from "../Name.jsx";
+
+// properties for creating an enum
+export interface EnumDeclarationProps extends AccessModifiers {
+  name: string;
+  refkey?: Refkey | Refkey[];
+  children?: Children;
+}
+
+/**
+ * A C# enum declaration
+ * @example
+ * ```tsx
+ * <EnumDeclaration public name="Color">
+ *   <EnumMember name="Red" />
+ *   <EnumMember name="Green" />
+ *   <EnumMember name="Blue" />
+ * </EnumDeclaration>
+ * ```
+ * This will produce:
+ * ```csharp
+ * public enum Color
+ * {
+ *   Red,
+ *   Green,
+ *   Blue
+ * }
+ * ```
+ */
+export function EnumDeclaration(props: EnumDeclarationProps) {
+  const name = useCSharpNamePolicy().getName(props.name!, "enum");
+  const symbol = createNamedTypeSymbol(name, "enum", {
+    refkeys: props.refkey,
+  });
+  const scope = createNamedTypeScope(symbol);
+
+  const modifiers = computeModifiersPrefix([getAccessModifier(props)]);
+
+  return (
+    <Declaration symbol={symbol}>
+      {modifiers}enum <Name />
+      {!props.children && ";"}
+      {props.children && (
+        <MemberScope value={scope}>
+          <Block newline>{props.children}</Block>
+        </MemberScope>
+      )}
+    </Declaration>
+  );
+}

package/src/components/enum/member.test.tsx

@@ -0,0 +1,24 @@
+import { toSourceText } from "#test/utils.jsx";
+import { d } from "@alloy-js/core/testing";
+import { expect, it } from "vitest";
+import { EnumDeclaration } from "./declaration.jsx";
+import { EnumMember } from "./member.jsx";
+
+it("declares enum with members", () => {
+  const res = toSourceText(
+    <EnumDeclaration public name="TestEnum">
+      <EnumMember name="One" />,<hbr />
+      <EnumMember name="Two" />
+    </EnumDeclaration>,
+  );
+
+  expect(res).toBe(d`
+    namespace TestCode;
+
+    public enum TestEnum
+    {
+        One,
+        Two
+    }
+  `);
+});

package/src/components/enum/member.tsx

@@ -0,0 +1,36 @@
+import { MemberDeclaration, MemberName, Refkey } from "@alloy-js/core";
+import { useCSharpNamePolicy } from "../../name-policy.js";
+import { useNamedTypeScope } from "../../scopes/contexts.js";
+import { CSharpSymbol } from "../../symbols/csharp.js";
+
+// properties for creating a C# enum member
+export interface EnumMemberProps {
+  name: string;
+  refkey?: Refkey;
+}
+
+// a member within a C# enum
+export function EnumMember(props: EnumMemberProps) {
+  const scope = useNamedTypeScope();
+
+  if (!scope) {
+    throw new Error("EnumMember must be used within an EnumDeclaration.");
+  }
+
+  const symbol = scope.ownerSymbol;
+
+  if (symbol.typeKind !== "enum") {
+    throw new Error("EnumMember must be used within an EnumDeclaration.");
+  }
+
+  const name = useCSharpNamePolicy().getName(props.name, "enum-member");
+  const thisEnumValueSymbol = new CSharpSymbol(name, symbol.members, {
+    refkeys: props.refkey,
+  });
+
+  return (
+    <MemberDeclaration symbol={thisEnumValueSymbol}>
+      <MemberName />
+    </MemberDeclaration>
+  );
+}

package/src/components/field/field.test.tsx

@@ -24,8 +24,8 @@ it("declares multiple fields", () => {
   ).toRenderTo(`
     public class TestClass
     {
-      public string MemberOne;
-      public int MemberTwo;
+        public string MemberOne;
+        public int MemberTwo;
     }
   `);
 });
@@ -46,7 +46,7 @@ describe("modifiers", () => {
         ).toRenderTo(`
         public class TestClass
         {
-          ${accessModifier} string ${accessModifier === "private" ? "_testProp" : "TestProp"};
+            ${accessModifier} string ${accessModifier === "private" ? "_testProp" : "TestProp"};
         }
       `);
       },
@@ -68,7 +68,7 @@ describe("modifiers", () => {
         ).toRenderTo(`
         public class TestClass
         {
-          ${methodModifier} string _testField;
+            ${methodModifier} string _testField;
         }
       `);
       },
@@ -83,7 +83,7 @@ describe("modifiers", () => {
     ).toRenderTo(`
         public class TestClass
         {
-          public new string TestField;
+            public new string TestField;
         }
       `);
   });
@@ -100,7 +100,7 @@ describe("naming", () => {
     ).toRenderTo(`
       public class TestClass
       {
-        public string MemberOne;
+          public string MemberOne;
       }
     `);
   });
@@ -115,7 +115,7 @@ describe("naming", () => {
     ).toRenderTo(`
     public class TestClass
     {
-      private string _memberOne;
+        private string _memberOne;
     }
   `);
   });

package/src/components/field/field.tsx

@@ -1,13 +1,15 @@
-import { Children, Declaration, Name, refkey, Refkey } from "@alloy-js/core";
+import { Children, Declaration, Name, Refkey } from "@alloy-js/core";
 import {
   AccessModifiers,
   computeModifiersPrefix,
   getAccessModifier,
   makeModifiers,
 } from "../../modifiers.js";
-import { CSharpElements, useCSharpNamePolicy } from "../../name-policy.js";
-import { CSharpOutputSymbol } from "../../symbols/csharp-output-symbol.js";
-import { useCSharpScope } from "../../symbols/scopes.js";
+import {
+  accessibilityFromProps,
+  nonAccessibilityFromProps,
+} from "../../symbols/csharp.js";
+import { createFieldSymbol } from "../../symbols/factories.js";
 import { DocWhen } from "../doc/comment.jsx";
 
 /** Field modifiers. */
@@ -35,25 +37,13 @@ export interface FieldProps extends AccessModifiers, FieldModifiers {
 
 /** Render a c# field */
 export function Field(props: FieldProps) {
-  let nameElement: CSharpElements = "class-member-private";
-  if (props.public || props.protected || props.internal) {
-    nameElement = "class-member-public";
-  }
-  const name = useCSharpNamePolicy().getName(props.name, nameElement);
-  const scope = useCSharpScope();
-  if (
-    scope.kind !== "member" ||
-    (scope.name !== "class-decl" && scope.name !== "struct-decl")
-  ) {
-    throw new Error(
-      "can't define a class member outside of a class or struct scope",
-    );
-  }
+  const options = {
+    accessibility: accessibilityFromProps(props),
+    refkeys: props.refkey,
+    ...nonAccessibilityFromProps(props),
+  };
 
-  const memberSymbol = new CSharpOutputSymbol(name, {
-    scope,
-    refkeys: props.refkey ?? refkey(props.name),
-  });
+  const memberSymbol = createFieldSymbol(props.name, options);
 
   const modifiers = computeModifiersPrefix([
     getAccessModifier(props),

package/src/components/index.ts

@@ -4,20 +4,24 @@ export * from "./constructor/constructor.jsx";
 export * from "./Declaration.js";
 export * from "./doc/comment.jsx";
 export * from "./doc/from-markdown.jsx";
-export * from "./EnumDeclaration.jsx";
+export * from "./enum/declaration.jsx";
+export * from "./enum/member.jsx";
 export * from "./field/field.jsx";
 export * from "./interface/declaration.js";
 export * from "./interface/method.js";
 export * from "./interface/property.js";
+export * from "./invocation-expression/invocation-expression.jsx";
+export * from "./lexical-scope.jsx";
+export * from "./method-scope.jsx";
 export * from "./method/method.jsx";
 export * from "./Name.js";
-export * from "./Namespace.js";
+export * from "./namespace.js";
 export * from "./parameters/parameters.jsx";
 export * from "./ProjectDirectory.js";
 export * from "./property/property.jsx";
 export * from "./record/declaration.js";
 export * from "./Reference.js";
-export * from "./SourceFile.js";
+export * from "./source-file/source-file.jsx";
 export * from "./struct/declaration.jsx";
 export type { TypeParameterProps } from "./type-parameters/type-parameter.jsx";
 export * from "./UsingDirective.js";

package/src/components/interface/declaration.test.tsx

@@ -2,7 +2,6 @@ import { List, refkey } from "@alloy-js/core";
 import { describe, expect, it } from "vitest";
 import { TestNamespace } from "../../../test/utils.jsx";
 import { Attribute } from "../attributes/attributes.jsx";
-import { SourceFile } from "../SourceFile.jsx";
 import { TypeParameterProps } from "../type-parameters/type-parameter.jsx";
 import { InterfaceDeclaration } from "./declaration.jsx";
 import { InterfaceProperty } from "./property.jsx";
@@ -75,37 +74,32 @@ describe("with type parameters", () => {
 
     expect(
       <TestNamespace>
-        <SourceFile path="Test.cs">
-          <InterfaceDeclaration
-            public
-            name="Test"
-            typeParameters={typeParameters}
-          >
-            <List>
-              <InterfaceProperty
-                name="PropA"
-                type={typeParameters[0].refkey}
-                get
-                set
-              />
-              <InterfaceProperty
-                name="PropB"
-                type={typeParameters[1].refkey}
-                get
-                set
-              />
-            </List>
-          </InterfaceDeclaration>
-        </SourceFile>
+        <InterfaceDeclaration
+          public
+          name="Test"
+          typeParameters={typeParameters}
+        >
+          <List>
+            <InterfaceProperty
+              name="PropA"
+              type={typeParameters[0].refkey}
+              get
+              set
+            />
+            <InterfaceProperty
+              name="PropB"
+              type={typeParameters[1].refkey}
+              get
+              set
+            />
+          </List>
+        </InterfaceDeclaration>
       </TestNamespace>,
     ).toRenderTo(`
-      namespace TestCode
+      public interface Test<T, U>
       {
-          public interface Test<T, U>
-          {
-              T PropA { get; set; }
-              U PropB { get; set; }
-          }
+          T PropA { get; set; }
+          U PropB { get; set; }
       }
     `);
   });
@@ -134,10 +128,10 @@ describe("with type parameters", () => {
       </TestNamespace>,
     ).toRenderTo(`
       public interface Test<T, U>
-        where T : IFoo
-        where U : IBar
+          where T : IFoo
+          where U : IBar
       {
-        // Body
+          // Body
       }
     `);
   });

package/src/components/interface/declaration.tsx

@@ -6,8 +6,8 @@ import {
   makeModifiers,
 } from "../../modifiers.js";
 import { useCSharpNamePolicy } from "../../name-policy.js";
-import { CSharpOutputSymbol } from "../../symbols/csharp-output-symbol.js";
-import { CSharpMemberScope } from "../../symbols/scopes.js";
+import { createNamedTypeScope } from "../../scopes/factories.js";
+import { createNamedTypeSymbol } from "../../symbols/factories.js";
 import { AttributeList, AttributesProp } from "../attributes/attributes.jsx";
 import { DocWhen } from "../doc/comment.jsx";
 import { Name } from "../Name.jsx";
@@ -88,7 +88,7 @@ export interface InterfaceDeclarationProps
 export function InterfaceDeclaration(props: InterfaceDeclarationProps) {
   const name = useCSharpNamePolicy().getName(props.name!, "interface");
 
-  const thisInterfaceSymbol = new CSharpOutputSymbol(name, {
+  const symbol = createNamedTypeSymbol(name, "interface", {
     refkeys: props.refkey,
   });
 
@@ -96,30 +96,28 @@ export function InterfaceDeclaration(props: InterfaceDeclarationProps) {
   // members will automatically "inherit" this scope so
   // that refkeys to them will produce the fully-qualified
   // name e.g. Foo.Bar.
-  const thisInterfaceScope = new CSharpMemberScope("interface-decl", {
-    owner: thisInterfaceSymbol,
-  });
+  const thisInterfaceScope = createNamedTypeScope(symbol);
 
   const modifiers = computeModifiersPrefix([
     getAccessModifier(props),
     getInterfaceModifiers(props),
   ]);
   return (
-    <core.Declaration symbol={thisInterfaceSymbol}>
+    <core.Declaration symbol={symbol}>
       <DocWhen doc={props.doc} />
       <AttributeList attributes={props.attributes} endline />
       {modifiers}interface <Name />
-      {props.typeParameters && (
-        <TypeParameters parameters={props.typeParameters} />
-      )}
-      {props.typeParameters && (
-        <TypeParameterConstraints parameters={props.typeParameters} />
-      )}
-      {props.children ?
-        <core.Block newline>
-          <core.Scope value={thisInterfaceScope}>{props.children}</core.Scope>
-        </core.Block>
-      : ";"}
+      <core.Scope value={thisInterfaceScope}>
+        {props.typeParameters && (
+          <TypeParameters parameters={props.typeParameters} />
+        )}
+        {props.typeParameters && (
+          <TypeParameterConstraints parameters={props.typeParameters} />
+        )}
+        {props.children ?
+          <core.Block newline>{props.children}</core.Block>
+        : ";"}
+      </core.Scope>
     </core.Declaration>
   );
 }