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

package/docs/api/types/InterfacePropertyModifiers.md

@@ -0,0 +1,9 @@
+# InterfacePropertyModifiers
+
+Method modifiers. Can only be one.
+
+## Members
+
+|     |                  |   |
+| --- | ---------------- | - |
+| new | optional boolean |   |

package/docs/api/types/LexicalScopeProps.md

@@ -0,0 +1,5 @@
+# LexicalScopeProps
+
+```ts
+type LexicalScopeProps = LexicalScopePropsWithScopeValue | LeixcalScopePropsWithScopeInfo;
+```

package/docs/api/types/LibraryFrom.md

@@ -0,0 +1,7 @@
+# LibraryFrom
+
+```ts
+type LibraryFrom<T> = {
+    [K in keyof T]: ResolveDescriptor<T[K]>;
+} & LibrarySymbolReference;
+```

package/docs/api/types/MemberDescriptor.md

@@ -0,0 +1,16 @@
+# MemberDescriptor
+
+## Members
+
+|            |                                                                                                                                                                 |   |
+| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
+| isAbstract | optional boolean                                                                                                                                                |   |
+| isExtern   | optional boolean                                                                                                                                                |   |
+| isNullable | optional boolean                                                                                                                                                |   |
+| isOverride | optional boolean                                                                                                                                                |   |
+| isReadOnly | optional boolean                                                                                                                                                |   |
+| isSealed   | optional boolean                                                                                                                                                |   |
+| isStatic   | optional boolean                                                                                                                                                |   |
+| isVirtual  | optional boolean                                                                                                                                                |   |
+| kind       | string                                                                                                                                                          |   |
+| type       | optional [LibrarySymbolReference](../../../core/types/librarysymbolreference/) \| (() => [LibrarySymbolReference](../../../core/types/librarysymbolreference/)) |   |

package/docs/api/types/MethodDescriptor.md

@@ -0,0 +1,10 @@
+# MethodDescriptor
+
+## Members
+
+Extends [MemberDescriptor](../memberdescriptor/)
+
+|            |                                |   |
+| ---------- | ------------------------------ | - |
+| kind       | ”method”                       |   |
+| methodKind | [MethodKinds](../methodkinds/) |   |

package/docs/api/types/MethodKinds.md

@@ -0,0 +1,5 @@
+# MethodKinds
+
+```ts
+type MethodKinds = "ordinary" | "constructor";
+```

package/docs/api/types/MethodModifiers.md

@@ -0,0 +1,15 @@
+# MethodModifiers
+
+Method modifiers. Can only be one.
+
+## Members
+
+|          |                  |   |
+| -------- | ---------------- | - |
+| abstract | optional boolean |   |
+| extern   | optional boolean |   |
+| override | optional boolean |   |
+| readonly | optional boolean |   |
+| sealed   | optional boolean |   |
+| static   | optional boolean |   |
+| virtual  | optional boolean |   |

package/docs/api/types/MethodScopeProps.md

@@ -0,0 +1,5 @@
+# MethodScopeProps
+
+```ts
+type MethodScopeProps = MethodScopePropsWithScopeValue | MethodScopePropsWithScopeInfo;
+```

package/docs/api/types/MethodSymbol.md

@@ -0,0 +1,13 @@
+# MethodSymbol
+
+A symbol for a method or constructor of a class, interface, or struct.
+
+## Members
+
+Extends [CSharpSymbol](../csharpsymbol/)
+
+|             |                                                                                                              |                                                       |
+| ----------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------- |
+| constructor | (name: string \| Namekey, spaces: OutputSpace \| undefined, kind: MethodKinds, options: CSharpSymbolOptions) | Constructs a new instance of the [`MethodSymbol`](MethodSymbol.md) class |
+| methodKind  | [MethodKinds](../methodkinds/)                                                                               |                                                       |
+| symbolKind  |                                                                                                              |                                                       |

package/docs/api/types/NamedTypeDescriptor.md

@@ -0,0 +1,11 @@
+# NamedTypeDescriptor
+
+## Members
+
+|            |                  |   |
+| ---------- | ---------------- | - |
+| isAbstract | optional boolean |   |
+| isSealed   | optional boolean |   |
+| isStatic   | optional boolean |   |
+| kind       | string           |   |
+| members    | M                |   |

package/docs/api/types/NamedTypeSymbol.md

@@ -0,0 +1,17 @@
+# NamedTypeSymbol
+
+A symbol for a named type in C# such as a class, interface, enum, and so forth. Named types are generally defined in a namespace, and can have members of their own.
+
+## Members
+
+Extends [CSharpSymbol](../csharpsymbol/)
+
+|              |                                                                                                                                      |                                                          |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- |
+| constructor  | (name: string \| Namekey, spaces: OutputSpace\[] \| OutputSpace \| undefined, kind: NamedTypeTypeKind, options: CSharpSymbolOptions) | Constructs a new instance of the [`NamedTypeSymbol`](NamedTypeSymbol.md) class |
+| copy         | () => NamedTypeSymbol                                                                                                                |                                                          |
+| debugInfo    | Record\<string, unknown>                                                                                                             |                                                          |
+| members      | import(“@alloy-js/core”).[OutputMemberSpace](../../../core/types/outputmemberspace/)                                                 |                                                          |
+| memberSpaces | string\[]                                                                                                                            |                                                          |
+| symbolKind   | [NamedTypeSymbolKind](../namedtypesymbolkind/)                                                                                       |                                                          |
+| typeKind     | [NamedTypeTypeKind](../namedtypetypekind/)                                                                                           |                                                          |

package/docs/api/types/NamedTypeSymbolKind.md

@@ -0,0 +1,5 @@
+# NamedTypeSymbolKind
+
+```ts
+type NamedTypeSymbolKind = "named-type" | "namespace";
+```

package/docs/api/types/NamedTypeTypeKind.md

@@ -0,0 +1,5 @@
+# NamedTypeTypeKind
+
+```ts
+type NamedTypeTypeKind = "class" | "interface" | "enum" | "namespace" | "struct" | "record";
+```

package/docs/api/types/NamespaceDescriptor.md

@@ -0,0 +1,8 @@
+# NamespaceDescriptor
+
+## Members
+
+|         |             |   |
+| ------- | ----------- | - |
+| kind    | ”namespace” |   |
+| members | M           |   |

package/docs/api/types/NamespaceSymbol.md

@@ -0,0 +1,16 @@
+# NamespaceSymbol
+
+A symbol for a namespace in C#.
+
+## Members
+
+Extends [NamedTypeSymbol](../namedtypesymbol/)
+
+|                       |                                                                                              |                                                          |
+| --------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| constructor           | (name: string \| Namekey, parentNamespace: NamespaceSymbol, options: NamespaceSymbolOptions) | Constructs a new instance of the [`NamespaceSymbol`](NamespaceSymbol.md) class |
+| copy                  | () => NamespaceSymbol                                                                        |                                                          |
+| debugInfo             | Record\<string, unknown>                                                                     |                                                          |
+| getFullyQualifiedName | (options: { omitGlobal?: boolean; }) => string                                               |                                                          |
+| isGlobal              | boolean                                                                                      | Whether this symbol is the global namespace symbol.      |
+| symbolKind            |                                                                                              |                                                          |

package/docs/api/types/NamespaceSymbolOptions.md

@@ -0,0 +1,9 @@
+# NamespaceSymbolOptions
+
+## Members
+
+Extends [OutputSymbolOptions](../../../core/types/outputsymboloptions/)
+
+|          |                  |   |
+| -------- | ---------------- | - |
+| isGlobal | optional boolean |   |

package/docs/api/types/NonAccessModifiers.md

@@ -0,0 +1,13 @@
+# NonAccessModifiers
+
+## Members
+
+|          |                  |   |
+| -------- | ---------------- | - |
+| abstract | optional boolean |   |
+| extern   | optional boolean |   |
+| override | optional boolean |   |
+| readOnly | optional boolean |   |
+| sealed   | optional boolean |   |
+| static   | optional boolean |   |
+| virtual  | optional boolean |   |

package/docs/api/types/PropertyDescriptor_2.md

@@ -0,0 +1,9 @@
+# PropertyDescriptor_2
+
+## Members
+
+Extends [MemberDescriptor](../memberdescriptor/)
+
+|      |            |   |
+| ---- | ---------- | - |
+| kind | ”property” |   |

package/docs/api/types/PropertyModifiers.md

@@ -0,0 +1,17 @@
+# PropertyModifiers
+
+Property modifiers.
+
+## Members
+
+|          |                  |                                                                                                                          |
+| -------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| abstract | optional boolean |                                                                                                                          |
+| extern   | optional boolean |                                                                                                                          |
+| new      | optional boolean |                                                                                                                          |
+| override | optional boolean |                                                                                                                          |
+| readonly | optional boolean |                                                                                                                          |
+| required | optional boolean | Set required modifier on property <https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/required> |
+| sealed   | optional boolean |                                                                                                                          |
+| static   | optional boolean |                                                                                                                          |
+| virtual  | optional boolean |                                                                                                                          |

package/docs/api/types/RecordDescriptor.md

@@ -0,0 +1,9 @@
+# RecordDescriptor
+
+## Members
+
+Extends [NamedTypeDescriptor](../namedtypedescriptor/)\<M>
+
+|      |          |   |
+| ---- | -------- | - |
+| kind | ”record” |   |

package/docs/api/types/RecordModifiers.md

@@ -0,0 +1,7 @@
+# RecordModifiers
+
+## Members
+
+|         |                  |   |
+| ------- | ---------------- | - |
+| partial | optional boolean |   |

package/docs/api/types/ResolveDescriptor.md

@@ -0,0 +1,7 @@
+# ResolveDescriptor
+
+```ts
+type ResolveDescriptor<D> = D extends NamedTypeDescriptor<infer M> ? LibrarySymbolReference & {
+    [K in keyof M]: ResolveDescriptor<M[K]>;
+} : LibrarySymbolReference;
+```

package/docs/api/types/StructDescriptor.md

@@ -0,0 +1,9 @@
+# StructDescriptor
+
+## Members
+
+Extends [NamedTypeDescriptor](../namedtypedescriptor/)\<M>
+
+|      |          |   |
+| ---- | -------- | - |
+| kind | ”struct” |   |

package/docs/api/types/StructModifiers.md

@@ -0,0 +1,10 @@
+# StructModifiers
+
+## Members
+
+|          |                  |   |
+| -------- | ---------------- | - |
+| new      | optional boolean |   |
+| partial  | optional boolean |   |
+| readonly | optional boolean |   |
+| ref      | optional boolean |   |

package/docs/api/types/TypeParameterProps.md

@@ -0,0 +1,11 @@
+# TypeParameterProps
+
+Information for a TypeScript generic type parameter.
+
+## Members
+
+|             |                                                                                                    |                                                       |
+| ----------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
+| constraints | optional [Children](../../../core/types/children/) \| [Children](../../../core/types/children/)\[] | The parameter constraint                              |
+| name        | string \| [Namekey](../../../core/types/namekey/)                                                  | The name of the type parameter.                       |
+| refkey      | optional [Refkey](../../../core/types/refkey/) \| [Refkey](../../../core/types/refkey/)\[]         | A refkey or array of refkeys for this type parameter. |

package/docs/api/types/VarModifiers.md

@@ -0,0 +1,8 @@
+# VarModifiers
+
+## Members
+
+|       |                  |                                              |
+| ----- | ---------------- | -------------------------------------------- |
+| const | optional boolean | Constant variable. Add the const modifier.   |
+| using | optional boolean | Disposable variable. Add the using modifier. |

package/docs/api/types/index.md

@@ -0,0 +1,62 @@
+# csharp — types
+
+- [AccessExpressionBuilder](AccessExpressionBuilder.md)
+- [AccessExpressionPartProps](AccessExpressionPartProps.md)
+- [AccessModifiers](AccessModifiers.md) — Access modifiers.
+- [AttributeProps](AttributeProps.md)
+- [AttributesProp](AttributesProp.md) — type AttributesProp = Array<string | AttributeProps | Children>;
+- [ClassDescriptor](ClassDescriptor.md) — Extends [NamedTypeDescriptor](../namedtypedescriptor/)\<M>
+- [ClassModifiers](ClassModifiers.md)
+- [CreateMethodSymbolOptions](CreateMethodSymbolOptions.md) — Extends [CSharpSymbolOptions](../csharpsymboloptions/)
+- [CreateTypeParameterSymbolOptions](CreateTypeParameterSymbolOptions.md) — Extends [CSharpSymbolOptions](../csharpsymboloptions/)
+- [CSharpClassScope](CSharpClassScope.md) — Extends [CSharpNamedTypeScope](../csharpnamedtypescope/)
+- [CSharpElements](CSharpElements.md) — type CSharpElements = "class" | "constant" | "variable" | "struct" | "enum" | "enum-member" | "function" | "interface" |
+- [CSharpFormatOptions](CSharpFormatOptions.md) — Extends [CommonFormatOptions](../../../core/types/commonformatoptions/)
+- [CSharpFormatOptions](CSharpFormatOptions.md) — CSharpFormatOptions: import("@alloy-js/core").ComponentDefinition<import("@alloy-js/core").ContextProviderProps<CSharpFo
+- [CSharpLexicalScope](CSharpLexicalScope.md) — Extends [CSharpScope](../csharpscope/)
+- [CSharpMethodScope](CSharpMethodScope.md) — Extends [CSharpLexicalScope](../csharplexicalscope/)
+- [CSharpNamedTypeScope](CSharpNamedTypeScope.md) — This scope contains NamedTypeSymbols for types that are declared in containers like namespaces.
+- [CSharpNamespaceScope](CSharpNamespaceScope.md) — Extends [CSharpNamedTypeScope](../csharpnamedtypescope/)
+- [CSharpProjectSdk](CSharpProjectSdk.md) — type CSharpProjectSdk = "Microsoft.NET.Sdk" | "Microsoft.NET.Sdk.Web" | "Microsoft.NET.Sdk.Worker" | "Microsoft.NET.Sdk.
+- [CSharpScope](CSharpScope.md) — Extends [OutputScope](../../../core/types/outputscope/)
+- [CSharpSourceFileScope](CSharpSourceFileScope.md) — Extends [CSharpLexicalScope](../csharplexicalscope/)
+- [CSharpSymbol](CSharpSymbol.md) — This is the base type for all symbols in C#.
+- [CSharpSymbolKinds](CSharpSymbolKinds.md) — type CSharpSymbolKinds = "symbol" | "named-type" | "method" | "field" | "property" | "namespace" | "event";
+- [CSharpSymbolOptions](CSharpSymbolOptions.md) — Extends [OutputSymbolOptions](../../../core/types/outputsymboloptions/)
+- [DeclarationModifiers](DeclarationModifiers.md) — Extends [AccessModifiers](../accessmodifiers/),[NonAccessModifiers](../nonaccessmodifiers/)
+- [DeclaredAccessibility](DeclaredAccessibility.md) — type DeclaredAccessibility = "private" | "protected" | "internal" | "public";
+- [Descriptor](Descriptor.md) — type Descriptor = FieldDescriptor | MethodDescriptor | PropertyDescriptor | NamespaceDescriptor<any> | ClassDescriptor<a
+- [DocCommentTagProps](DocCommentTagProps.md)
+- [EnumDescriptor](EnumDescriptor.md) — Extends [NamedTypeDescriptor](../namedtypedescriptor/)\<M>
+- [FieldDescriptor](FieldDescriptor.md) — Extends [MemberDescriptor](../memberdescriptor/)
+- [FieldModifiers](FieldModifiers.md) — Field modifiers.
+- [GenericDescriptor](GenericDescriptor.md)
+- [InterfaceDescriptor](InterfaceDescriptor.md) — Extends [NamedTypeDescriptor](../namedtypedescriptor/)\<M>
+- [InterfaceMethodModifiers](InterfaceMethodModifiers.md) — Method modifiers.
+- [InterfaceModifiers](InterfaceModifiers.md)
+- [InterfacePropertyModifiers](InterfacePropertyModifiers.md) — Method modifiers.
+- [LexicalScopeProps](LexicalScopeProps.md) — type LexicalScopeProps = LexicalScopePropsWithScopeValue | LeixcalScopePropsWithScopeInfo;
+- [LibraryFrom](LibraryFrom.md) — type LibraryFrom<T> = {
+- [MemberDescriptor](MemberDescriptor.md)
+- [MethodDescriptor](MethodDescriptor.md) — Extends [MemberDescriptor](../memberdescriptor/)
+- [MethodKinds](MethodKinds.md) — type MethodKinds = "ordinary" | "constructor";
+- [MethodModifiers](MethodModifiers.md) — Method modifiers.
+- [MethodScopeProps](MethodScopeProps.md) — type MethodScopeProps = MethodScopePropsWithScopeValue | MethodScopePropsWithScopeInfo;
+- [MethodSymbol](MethodSymbol.md) — A symbol for a method or constructor of a class, interface, or struct.
+- [NamedTypeDescriptor](NamedTypeDescriptor.md)
+- [NamedTypeSymbol](NamedTypeSymbol.md) — A symbol for a named type in C# such as a class, interface, enum, and so forth.
+- [NamedTypeSymbolKind](NamedTypeSymbolKind.md) — type NamedTypeSymbolKind = "named-type" | "namespace";
+- [NamedTypeTypeKind](NamedTypeTypeKind.md) — type NamedTypeTypeKind = "class" | "interface" | "enum" | "namespace" | "struct" | "record";
+- [NamespaceDescriptor](NamespaceDescriptor.md)
+- [NamespaceSymbol](NamespaceSymbol.md) — A symbol for a namespace in C#.
+- [NamespaceSymbolOptions](NamespaceSymbolOptions.md) — Extends [OutputSymbolOptions](../../../core/types/outputsymboloptions/)
+- [NonAccessModifiers](NonAccessModifiers.md)
+- [PropertyDescriptor_2](PropertyDescriptor_2.md) — Extends [MemberDescriptor](../memberdescriptor/)
+- [PropertyModifiers](PropertyModifiers.md) — Property modifiers.
+- [RecordDescriptor](RecordDescriptor.md) — Extends [NamedTypeDescriptor](../namedtypedescriptor/)\<M>
+- [RecordModifiers](RecordModifiers.md)
+- [ResolveDescriptor](ResolveDescriptor.md) — type ResolveDescriptor<D> = D extends NamedTypeDescriptor<infer M> ?
+- [StructDescriptor](StructDescriptor.md) — Extends [NamedTypeDescriptor](../namedtypedescriptor/)\<M>
+- [StructModifiers](StructModifiers.md)
+- [TypeParameterProps](TypeParameterProps.md) — Information for a TypeScript generic type parameter.
+- [VarModifiers](VarModifiers.md)

package/docs/api/variables/Attribute.md

@@ -0,0 +1,21 @@
+# Attribute
+
+Render a csharp attribute.
+
+```ts
+Attribute: import("@alloy-js/core").Component<AttributeProps> & Required<Pick<import("@alloy-js/core").Component<AttributeProps>, "tag">>
+```
+
+## Example
+
+```tsx
+<Attribute name="Test" /><hbr/>
+<Attribute name="Test" args={["arg1", "arg2"]} />
+```
+
+will render:
+
+```csharp
+[Test]
+[Test("arg1", "arg2")]
+```

package/docs/api/variables/index.md

@@ -0,0 +1,3 @@
+# csharp — variables
+
+- [Attribute](Attribute.md) — Render a csharp attribute.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alloy-js/csharp",
-  "version": "0.23.0-dev.6",
+  "version": "0.23.0-dev.8",
   "description": "Alloy components for CSharp language.",
   "repository": {
     "type": "git",
@@ -43,16 +43,16 @@
   "author": "jhendrix@microsoft.com",
   "license": "MIT",
   "dependencies": {
-    "@alloy-js/core": "~0.22.0 || >= 0.23.0-dev.12",
+    "@alloy-js/core": "~0.22.0 || >= 0.23.0-dev.16",
     "@alloy-js/msbuild": "~0.22.0 || >= 0.23.0-dev.2",
     "change-case": "^5.4.4",
     "marked": "^16.1.1",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@alloy-js/cli": "~0.22.0 || >= 0.23.0-dev.4",
-    "@alloy-js/rollup-plugin": "~0.1.0 || >= 0.1.1-dev.1",
-    "@alloy-js/typescript": "~0.22.0 || >= 0.23.0-dev.7",
+    "@alloy-js/cli": "~0.22.0 || >= 0.23.0-dev.6",
+    "@alloy-js/rollup-plugin": "~0.1.0 || >= 0.1.1-dev.2",
+    "@alloy-js/typescript": "~0.22.0 || >= 0.23.0-dev.9",
     "@microsoft/api-extractor": "~7.52.8",
     "@rollup/plugin-typescript": "^12.1.2",
     "@types/js-yaml": "^4.0.9",

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

@@ -2,6 +2,7 @@ import { refkey } from "@alloy-js/core";
 import { expect, it } from "vitest";
 import { TestNamespace } from "../../../test/utils.jsx";
 import { ClassDeclaration } from "../class/declaration.jsx";
+import { DocSummary } from "../doc/comment.jsx";
 import { Constructor } from "./constructor.jsx";
 
 it("reference constructor parameters in body", () => {
@@ -33,3 +34,93 @@ it("reference constructor parameters in body", () => {
     }
   `);
 });
+
+it("renders doc comment", () => {
+  expect(
+    <TestNamespace>
+      <ClassDeclaration public name="TestClass">
+        <Constructor
+          public
+          doc={<DocSummary>Creates a new instance</DocSummary>}
+        >
+          // body
+        </Constructor>
+      </ClassDeclaration>
+    </TestNamespace>,
+  ).toRenderTo(`
+    public class TestClass
+    {
+        /// <summary>
+        /// Creates a new instance
+        /// </summary>
+        public TestClass()
+        {
+            // body
+        }
+    }
+  `);
+});
+
+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
+        }
+    }
+  `);
+});