@alloy-js/csharp 0.19.0-dev.1 → 0.19.0-dev.4

package/dist/src/components/struct/declaration.js

@@ -0,0 +1,78 @@
+import { createComponent as _$createComponent, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import * as core from "@alloy-js/core";
+import { computeModifiersPrefix, getAccessModifier, 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 { AttributeList } from "../attributes/attributes.js";
+import { DocWhen } from "../doc/comment.js";
+import { Name } from "../Name.js";
+import { TypeParameterConstraints } from "../type-parameters/type-parameter-constraints.js";
+import { TypeParameters } from "../type-parameters/type-parameters.js";
+const getStructModifiers = makeModifiers(["new", "readonly", "ref", "partial"]);
+
+// properties for creating a class
+
+/**
+ * CSharp struct declaration.
+ * @example
+ * ```tsx
+ * <StructDeclaration public name="IMyStruct">
+ *   <StructMember public name="MyProperty" type="int" />
+ *   <StructMethod public name="MyMethod" returnType="void">
+ *     <Parameter name="value" type="int" />
+ *   </StructMethod>
+ * </StructDeclaration>
+ * ```
+ * This will produce:
+ * ```csharp
+ * public struct MyIface
+ * {
+ *   public int MyProperty { get; set; }
+ *   public void MyMethod(int value);
+ * }
+ * ```
+ */
+export function StructDeclaration(props) {
+  const name = useCSharpNamePolicy().getName(props.name, "struct");
+  const thisStructSymbol = new CSharpOutputSymbol(name, {
+    refkeys: props.refkey
+  });
+  const thisStructScope = new CSharpMemberScope("struct-decl", {
+    owner: thisStructSymbol
+  });
+  const modifiers = computeModifiersPrefix([getAccessModifier(props), getStructModifiers(props)]);
+  return _$createComponent(core.Declaration, {
+    symbol: thisStructSymbol,
+    get children() {
+      return [_$createComponent(DocWhen, {
+        get doc() {
+          return props.doc;
+        }
+      }), _$createComponent(AttributeList, {
+        get attributes() {
+          return props.attributes;
+        },
+        endline: true
+      }), modifiers, "struct ", _$createComponent(Name, {}), _$memo(() => _$memo(() => !!props.typeParameters)() && _$createComponent(TypeParameters, {
+        get parameters() {
+          return props.typeParameters;
+        }
+      })), _$memo(() => _$memo(() => !!props.typeParameters)() && _$createComponent(TypeParameterConstraints, {
+        get parameters() {
+          return props.typeParameters;
+        }
+      })), _$memo(() => _$memo(() => !!props.children)() ? _$createComponent(core.Block, {
+        newline: true,
+        get children() {
+          return _$createComponent(core.Scope, {
+            value: thisStructScope,
+            get children() {
+              return props.children;
+            }
+          });
+        }
+      }) : ";")];
+    }
+  });
+}

package/dist/src/components/struct/declaration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=declaration.test.d.ts.map

package/dist/src/components/struct/declaration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.test.d.ts","sourceRoot":"","sources":["../../../../src/components/struct/declaration.test.tsx"],"names":[],"mappings":""}

package/dist/src/components/struct/declaration.test.js

@@ -0,0 +1,211 @@
+import { createComponent as _$createComponent, mergeProps as _$mergeProps } from "@alloy-js/core/jsx-runtime";
+import { List, refkey } from "@alloy-js/core";
+import { describe, expect, it } from "vitest";
+import { TestNamespace } from "../../../test/utils.js";
+import { Attribute } from "../attributes/attributes.js";
+import { Constructor } from "../constructor/constructor.js";
+import { Method } from "../method/method.js";
+import { Property } from "../property/property.js";
+import { SourceFile } from "../SourceFile.js";
+import { StructDeclaration } from "./declaration.js";
+it("declares struct with no members", () => {
+  expect(_$createComponent(TestNamespace, {
+    get children() {
+      return _$createComponent(StructDeclaration, {
+        name: "Test"
+      });
+    }
+  })).toRenderTo(`
+      struct Test;
+  `);
+});
+describe("modifiers", () => {
+  it.each(["public", "private", "internal"])("%s", mod => {
+    expect(_$createComponent(TestNamespace, {
+      get children() {
+        return _$createComponent(StructDeclaration, _$mergeProps({
+          [mod]: true
+        }, {
+          name: "Test"
+        }));
+      }
+    })).toRenderTo(`
+        ${mod} struct Test;
+    `);
+  });
+  it.each(["partial"])("%s", mod => {
+    expect(_$createComponent(TestNamespace, {
+      get children() {
+        return _$createComponent(StructDeclaration, _$mergeProps({
+          [mod]: true
+        }, {
+          name: "Test"
+        }));
+      }
+    })).toRenderTo(`
+        ${mod} struct Test;
+    `);
+  });
+  it("combines modifiers", () => {
+    expect(_$createComponent(TestNamespace, {
+      get children() {
+        return _$createComponent(StructDeclaration, {
+          "public": true,
+          partial: true,
+          name: "Test"
+        });
+      }
+    })).toRenderTo(`
+        public partial struct Test;
+    `);
+  });
+});
+it("specify doc comment", () => {
+  expect(_$createComponent(TestNamespace, {
+    get children() {
+      return _$createComponent(StructDeclaration, {
+        name: "Test",
+        doc: "This is a test"
+      });
+    }
+  })).toRenderTo(`
+    /// This is a test
+    struct Test;
+  `);
+});
+describe("with type parameters", () => {
+  it("reference parameters", () => {
+    const typeParameters = [{
+      name: "T",
+      refkey: refkey()
+    }, {
+      name: "U",
+      refkey: refkey()
+    }];
+    expect(_$createComponent(TestNamespace, {
+      get children() {
+        return _$createComponent(SourceFile, {
+          path: "Test.cs",
+          get children() {
+            return _$createComponent(StructDeclaration, {
+              "public": true,
+              name: "Test",
+              typeParameters: typeParameters,
+              get children() {
+                return _$createComponent(List, {
+                  get children() {
+                    return [_$createComponent(Property, {
+                      name: "PropA",
+                      get type() {
+                        return typeParameters[0].refkey;
+                      },
+                      get: true,
+                      set: true
+                    }), _$createComponent(Property, {
+                      name: "PropB",
+                      get type() {
+                        return typeParameters[1].refkey;
+                      },
+                      get: true,
+                      set: true
+                    })];
+                  }
+                });
+              }
+            });
+          }
+        });
+      }
+    })).toRenderTo(`
+      namespace TestCode
+      {
+          public struct Test<T, U>
+          {
+              T PropA { get; set; }
+              U PropB { get; set; }
+          }
+      }
+    `);
+  });
+  it("defines with constraints", () => {
+    const typeParameters = [{
+      name: "T",
+      constraints: "IFoo"
+    }, {
+      name: "U",
+      constraints: "IBar"
+    }];
+    expect(_$createComponent(TestNamespace, {
+      get children() {
+        return _$createComponent(StructDeclaration, {
+          "public": true,
+          name: "Test",
+          typeParameters: typeParameters,
+          children: "// Body"
+        });
+      }
+    })).toRenderTo(`
+      public struct Test<T, U>
+        where T : IFoo
+        where U : IBar
+      {
+        // Body
+      }
+    `);
+  });
+});
+it("specify attributes", () => {
+  expect(_$createComponent(TestNamespace, {
+    get children() {
+      return _$createComponent(StructDeclaration, {
+        name: "Test",
+        get attributes() {
+          return [_$createComponent(Attribute, {
+            name: "Test"
+          })];
+        }
+      });
+    }
+  })).toRenderTo(`
+    [Test]
+    struct Test;
+  `);
+});
+it("define methods", () => {
+  expect(_$createComponent(TestNamespace, {
+    get children() {
+      return _$createComponent(StructDeclaration, {
+        name: "Test",
+        get children() {
+          return _$createComponent(Method, {
+            name: "MethodOne"
+          });
+        }
+      });
+    }
+  })).toRenderTo(`
+    struct Test
+    {
+      void MethodOne() {}
+    }
+  `);
+});
+it("define constructor", () => {
+  expect(_$createComponent(TestNamespace, {
+    get children() {
+      return _$createComponent(StructDeclaration, {
+        name: "Test",
+        get children() {
+          return _$createComponent(Constructor, {
+            "public": true
+          });
+        }
+      });
+    }
+  })).toRenderTo(`
+    struct Test
+    {
+      public Test() {}
+    }
+  `);
+});

package/dist/src/name-policy.d.ts

@@ -1,5 +1,5 @@
 import * as core from "@alloy-js/core";
-export type CSharpElements = "class" | "constant" | "variable" | "enum" | "enum-member" | "function" | "interface" | "record" | "class-member-private" | "class-member-public" | "class-method" | "class-property" | "parameter" | "type-parameter";
+export type CSharpElements = "class" | "constant" | "variable" | "struct" | "enum" | "enum-member" | "function" | "interface" | "record" | "class-member-private" | "class-member-public" | "class-method" | "class-property" | "parameter" | "type-parameter";
 export declare function createCSharpNamePolicy(): core.NamePolicy<CSharpElements>;
 export declare function useCSharpNamePolicy(): core.NamePolicy<CSharpElements>;
 //# sourceMappingURL=name-policy.d.ts.map

package/dist/src/name-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"name-policy.d.ts","sourceRoot":"","sources":["../../src/name-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAIvC,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,UAAU,GACV,UAAU,GACV,MAAM,GACN,aAAa,GACb,UAAU,GACV,WAAW,GACX,QAAQ,GACR,sBAAsB,GACtB,qBAAqB,GACrB,cAAc,GACd,gBAAgB,GAChB,WAAW,GACX,gBAAgB,CAAC;AAGrB,wBAAgB,sBAAsB,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAmBxE;AAGD,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAErE"}
+{"version":3,"file":"name-policy.d.ts","sourceRoot":"","sources":["../../src/name-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAIvC,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,UAAU,GACV,UAAU,GACV,QAAQ,GACR,MAAM,GACN,aAAa,GACb,UAAU,GACV,WAAW,GACX,QAAQ,GACR,sBAAsB,GACtB,qBAAqB,GACrB,cAAc,GACd,gBAAgB,GAChB,WAAW,GACX,gBAAgB,CAAC;AAGrB,wBAAgB,sBAAsB,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAoBxE;AAGD,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAErE"}

package/dist/src/name-policy.js

@@ -8,6 +8,7 @@ export function createCSharpNamePolicy() {
   return core.createNamePolicy((name, element) => {
     switch (element) {
       case "class":
+      case "struct":
       case "enum":
       case "enum-member":
       case "interface":

package/dist/test/class-declaration.test.js

@@ -4,6 +4,7 @@ import { List, refkey } from "@alloy-js/core";
 import * as coretest from "@alloy-js/core/testing";
 import { describe, expect, it } from "vitest";
 import { Attribute } from "../src/components/attributes/attributes.js";
+import { Constructor } from "../src/components/stc/index.js";
 import * as csharp from "../src/index.js";
 import { ClassDeclaration, ClassMember, Property, SourceFile } from "../src/index.js";
 import * as utils from "./utils.js";
@@ -137,10 +138,10 @@ it("declares class with some methods", () => {
     get children() {
       return _$createComponent(core.List, {
         get children() {
-          return [_$createComponent(csharp.ClassMethod, {
+          return [_$createComponent(csharp.Method, {
             "public": true,
             name: "MethodOne"
-          }), _$createComponent(csharp.ClassMethod, {
+          }), _$createComponent(csharp.Method, {
             "private": true,
             virtual: true,
             name: "MethodTwo"
@@ -215,7 +216,7 @@ it("uses refkeys for members, params, and return type", () => {
                     "private": true,
                     name: "MemberOne",
                     type: enumTypeRefkey
-                  }), ";", _$createIntrinsic("hbr", {}), _$createComponent(csharp.ClassMethod, {
+                  }), ";", _$createIntrinsic("hbr", {}), _$createComponent(csharp.Method, {
                     "public": true,
                     name: "MethodOne",
                     parameters: params,
@@ -353,7 +354,7 @@ it("declares class with constructor", () => {
     "public": true,
     name: "TestClass",
     get children() {
-      return _$createComponent(csharp.ClassConstructor, {
+      return _$createComponent(Constructor, {
         "public": true
       });
     }
@@ -396,7 +397,7 @@ it("declares class with constructor params and assigns values to fields", () =>
         name: "size",
         type: "int",
         refkey: thisSizeRefkey
-      }), ";", _$createIntrinsic("hbr", {}), _$createComponent(csharp.ClassConstructor, {
+      }), ";", _$createIntrinsic("hbr", {}), _$createComponent(Constructor, {
         "public": true,
         parameters: ctorParams,
         get children() {

package/dist/test/using.test.js

@@ -97,7 +97,7 @@ it("adds using statement across namespaces", () => {
                 "public": true,
                 name: "Client",
                 get children() {
-                  return _$createComponent(csharp.ClassMethod, {
+                  return _$createComponent(csharp.Method, {
                     "public": true,
                     name: "MethodOne",
                     parameters: params,