@alloy-js/csharp 0.23.0-dev.7 → 0.23.0-dev.8

package/docs/api/components/Constructor.md

@@ -9,6 +9,7 @@ Properties for [Constructor](../constructor/) component.
 
 
   <Constructor
+    baseConstructor={Children[]}
     doc={Children}
     file
     internal
@@ -17,6 +18,7 @@ Properties for [Constructor](../constructor/) component.
     protected
     public
     refkey={Refkey}
+    thisConstructor={Children[]}
   >
     {children}
   </Constructor>
@@ -29,6 +31,7 @@ Properties for [Constructor](../constructor/) component.
 
 
   Constructor({
+    baseConstructor: Children[],
     doc: Children,
     file: boolean,
     internal: boolean,
@@ -37,19 +40,22 @@ Properties for [Constructor](../constructor/) component.
     protected: boolean,
     public: boolean,
     refkey: Refkey,
+    thisConstructor: Children[],
   }).children(children)
   ```
 
 ## Props
 
-|            |                                                    |                        |
-| ---------- | -------------------------------------------------- | ---------------------- |
-| children   | optional [Children](../../../core/types/children/) | Constructor body       |
-| doc        | optional [Children](../../../core/types/children/) | Doc comment            |
-| file       | optional boolean                                   |                        |
-| internal   | optional boolean                                   |                        |
-| parameters | optional [ParameterProps](../parameter/)\[]        | Constructor parameters |
-| private    | optional boolean                                   |                        |
-| protected  | optional boolean                                   |                        |
-| public     | optional boolean                                   |                        |
-| refkey     | optional [Refkey](../../../core/types/refkey/)     | Refkey                 |
+|                 |                                                       |                                                                                                                     |
+| --------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| baseConstructor | optional [Children](../../../core/types/children/)\[] | Arguments to pass to the base class constructor. Renders `: base(args)` between parameter list and body.            |
+| children        | optional [Children](../../../core/types/children/)    | Constructor body                                                                                                    |
+| doc             | optional [Children](../../../core/types/children/)    | Doc comment                                                                                                         |
+| file            | optional boolean                                      |                                                                                                                     |
+| internal        | optional boolean                                      |                                                                                                                     |
+| parameters      | optional [ParameterProps](../parameter/)\[]           | Constructor parameters                                                                                              |
+| private         | optional boolean                                      |                                                                                                                     |
+| protected       | optional boolean                                      |                                                                                                                     |
+| public          | optional boolean                                      |                                                                                                                     |
+| refkey          | optional [Refkey](../../../core/types/refkey/)        | Refkey                                                                                                              |
+| thisConstructor | optional [Children](../../../core/types/children/)\[] | Arguments to pass to another constructor in the same class. Renders `: this(args)` between parameter list and body. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alloy-js/csharp",
-  "version": "0.23.0-dev.7",
+  "version": "0.23.0-dev.8",
   "description": "Alloy components for CSharp language.",
   "repository": {
     "type": "git",

package/src/components/constructor/constructor.test.tsx

@@ -60,3 +60,67 @@ it("renders doc comment", () => {
     }
   `);
 });
+
+it("renders : base() initializer", () => {
+  expect(
+    <TestNamespace>
+      <ClassDeclaration public name="DerivedClass" baseType="BaseClass">
+        <Constructor
+          public
+          parameters={[{ name: "name", type: "string" }]}
+          baseConstructor={["name"]}
+        >
+          // body
+        </Constructor>
+      </ClassDeclaration>
+    </TestNamespace>,
+  ).toRenderTo(`
+    public class DerivedClass : BaseClass
+    {
+        public DerivedClass(string name) : base(name)
+        {
+            // body
+        }
+    }
+  `);
+});
+
+it("renders : this() initializer", () => {
+  expect(
+    <TestNamespace>
+      <ClassDeclaration public name="MyClass">
+        <Constructor public thisConstructor={["0", "0"]}>
+          // body
+        </Constructor>
+      </ClassDeclaration>
+    </TestNamespace>,
+  ).toRenderTo(`
+    public class MyClass
+    {
+        public MyClass() : this(0, 0)
+        {
+            // body
+        }
+    }
+  `);
+});
+
+it("renders : base() with no arguments", () => {
+  expect(
+    <TestNamespace>
+      <ClassDeclaration public name="DerivedClass" baseType="BaseClass">
+        <Constructor public baseConstructor={[]}>
+          // body
+        </Constructor>
+      </ClassDeclaration>
+    </TestNamespace>,
+  ).toRenderTo(`
+    public class DerivedClass : BaseClass
+    {
+        public DerivedClass() : base()
+        {
+            // body
+        }
+    }
+  `);
+});

package/src/components/constructor/constructor.tsx

@@ -1,5 +1,12 @@
 import { MethodScope } from "#components/method-scope.jsx";
-import { Block, MemberDeclaration, MemberName, Refkey } from "@alloy-js/core";
+import {
+  Block,
+  For,
+  Indent,
+  MemberDeclaration,
+  MemberName,
+  Refkey,
+} from "@alloy-js/core";
 import { Children } from "@alloy-js/core/jsx-runtime";
 import {
   AccessModifiers,
@@ -24,11 +31,51 @@ export interface ConstructorProps extends AccessModifiers {
   /** Refkey */
   refkey?: Refkey;
 
+  /**
+   * Arguments to pass to the base class constructor.
+   * Renders `: base(args)` between parameter list and body.
+   *
+   * @example
+   * ```tsx
+   * <Constructor public baseConstructor={["name", "42"]}>
+   * ```
+   * This will produce:
+   * ```csharp
+   * public MyClass(...) : base(name, 42)
+   * {
+   * }
+   * ```
+   */
+  baseConstructor?: Children[];
+
+  /**
+   * Arguments to pass to another constructor in the same class.
+   * Renders `: this(args)` between parameter list and body.
+   *
+   * @example
+   * ```tsx
+   * <Constructor public thisConstructor={["0", "0"]}>
+   * ```
+   * This will produce:
+   * ```csharp
+   * public MyClass() : this(0, 0)
+   * {
+   * }
+   * ```
+   */
+  thisConstructor?: Children[];
+
   /** Constructor body */
   children?: Children;
 }
 
 export function Constructor(props: ConstructorProps) {
+  if (props.baseConstructor && props.thisConstructor) {
+    throw new Error(
+      "Cannot use both 'baseConstructor' and 'thisConstructor' on the same constructor",
+    );
+  }
+
   const scope = useNamedTypeScope();
 
   const name = scope.ownerSymbol.name;
@@ -39,6 +86,13 @@ export function Constructor(props: ConstructorProps) {
 
   const modifiers = computeModifiersPrefix([getAccessModifier(props)]);
 
+  const initializer =
+    props.baseConstructor ?
+      <ConstructorInitializer keyword="base" args={props.baseConstructor} />
+    : props.thisConstructor ?
+      <ConstructorInitializer keyword="this" args={props.thisConstructor} />
+    : null;
+
   return (
     <MemberDeclaration symbol={ctorSymbol}>
       <MethodScope>
@@ -46,8 +100,34 @@ export function Constructor(props: ConstructorProps) {
         {modifiers}
         <MemberName />
         <Parameters parameters={props.parameters} />
+        {initializer}
         <Block newline>{props.children}</Block>
       </MethodScope>
     </MemberDeclaration>
   );
 }
+
+interface ConstructorInitializerProps {
+  keyword: "base" | "this";
+  args: Children[];
+}
+
+function ConstructorInitializer(props: ConstructorInitializerProps) {
+  return (
+    <group>
+      {" : "}
+      {props.keyword}(
+      <Indent nobreak>
+        <For each={props.args} joiner={", "}>
+          {(arg) => (
+            <>
+              <softline />
+              {arg}
+            </>
+          )}
+        </For>
+      </Indent>
+      <softline />)
+    </group>
+  );
+}

package/temp/api.json

@@ -2305,6 +2305,38 @@
           "name": "ConstructorProps",
           "preserveMemberOrder": false,
           "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!ConstructorProps#baseConstructor:member",
+              "docComment": "/**\n * Arguments to pass to the base class constructor.\n * Renders `: base(args)` between parameter list and body.\n *\n * @example\n * ```tsx\n * <Constructor public baseConstructor={[\"name\", \"42\"]}>\n * ```\n *\n * This will produce:\n * ```csharp\n * public MyClass(...) : base(name, 42)\n * {\n * }\n * ```\n *\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "baseConstructor?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Children",
+                  "canonicalReference": "@alloy-js/core!Children:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "baseConstructor",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/csharp!ConstructorProps#children:member",
@@ -2420,6 +2452,38 @@
                 "startIndex": 1,
                 "endIndex": 2
               }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!ConstructorProps#thisConstructor:member",
+              "docComment": "/**\n * Arguments to pass to another constructor in the same class.\n * Renders `: this(args)` between parameter list and body.\n *\n * @example\n * ```tsx\n * <Constructor public thisConstructor={[\"0\", \"0\"]}>\n * ```\n *\n * This will produce:\n * ```csharp\n * public MyClass() : this(0, 0)\n * {\n * }\n * ```\n *\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "thisConstructor?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Children",
+                  "canonicalReference": "@alloy-js/core!Children:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "thisConstructor",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
             }
           ],
           "extendsTokenRanges": [