@alloy-js/csharp 0.18.0-dev.8 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog - @alloy-js/csharp
 
+## 0.18.0
+
+### Bug Fixes
+
+- [#205](https://github.com/alloy-framework/alloy/pull/205) Add doc support to class members
+- [#182](https://github.com/alloy-framework/alloy/pull/182) Fix abstract class method rendering with a body `{}`
+- [#201](https://github.com/alloy-framework/alloy/pull/201) Add support for csharp doc comments with various `<Doc*>` components
+
+### Features
+
+- [#228](https://github.com/alloy-framework/alloy/pull/228) Add `<Attribute />` and `<AttributeList />` components to support c# attributes
+- [#212](https://github.com/alloy-framework/alloy/pull/212) Add support for class base type(s)
+- [#182](https://github.com/alloy-framework/alloy/pull/182) Add support for `async` class methods
+- [#193](https://github.com/alloy-framework/alloy/pull/193) Add support for class modifiers `abstract`, `partial`, `sealed` and `static`
+- [#209](https://github.com/alloy-framework/alloy/pull/209) Add `<ClassProperty />` component
+- [#227](https://github.com/alloy-framework/alloy/pull/227) CSharp SourceFile use 120 lines split by default
+- [#191](https://github.com/alloy-framework/alloy/pull/191) Access and method modifiers have been converted to flags `<Class public />` instead of `<Class accessModifier="public" />`
+- [#220](https://github.com/alloy-framework/alloy/pull/220) Add `<VarDeclaration />` component to render variables
+- [#198](https://github.com/alloy-framework/alloy/pull/198) Add `<InterfaceDeclaration />`, `<InterfaceMethod />` and `<InterfaceProperty />` components
+- [#213](https://github.com/alloy-framework/alloy/pull/213) Add support for optional parameters
+- [#202](https://github.com/alloy-framework/alloy/pull/202) Add `<DocFromMarkdown>` component allowing conversion from markdown to csharp doc comment syntax
+- [#225](https://github.com/alloy-framework/alloy/pull/225) Parameter improved formatting when using multi lines
+- [#216](https://github.com/alloy-framework/alloy/pull/216) Add support for `init` properties
+- [#215](https://github.com/alloy-framework/alloy/pull/215) Add support for `record` with `<RecordDeclaration>` component
+- [#222](https://github.com/alloy-framework/alloy/pull/222) Support for type parameters for interface, class methods, interface methods
+
+### Breaking Changes
+
+- [#192](https://github.com/alloy-framework/alloy/pull/192) Rename `Class` -> `ClassDeclaration` and `Enum` -> `EnumDeclaration`
+
+
 ## 0.17.0
 
 No changes, version bump only.

package/dist/src/components/ClassDeclaration.d.ts

@@ -1,6 +1,8 @@
 import * as core from "@alloy-js/core";
 import { AccessModifiers } from "../modifiers.js";
-import { ParameterProps } from "./Parameters.jsx";
+import { AttributesProp } from "./attributes/attributes.jsx";
+import { ParameterProps } from "./parameters/parameters.jsx";
+import { TypeParameterProps } from "./type-parameters/type-parameter.jsx";
 export interface ClassModifiers {
     readonly abstract?: boolean;
     readonly partial?: boolean;
@@ -12,7 +14,40 @@ export interface ClassDeclarationProps extends Omit<core.DeclarationProps, "name
     /** Doc comment */
     doc?: core.Children;
     refkey?: core.Refkey;
-    typeParameters?: Record<string, core.Refkey>;
+    /**
+     * Type parameters for the class
+     *
+     * @example
+     * ```tsx
+     * <ClassDeclaration name="MyClass" typeParameters={["T"]} />
+     * ```
+     * This will produce:
+     * ```csharp
+     * public class MyClass<T>
+     * ```
+     */
+    typeParameters?: (string | TypeParameterProps)[];
+    /** Base class that this class extends */
+    baseType?: core.Children;
+    /** Interfaces this class implements */
+    interfaceTypes?: core.Children[];
+    /**
+     * Define attributes to attach
+     * @example
+     * ```tsx
+     * <ClassDeclaration name="MyClass" attributes={[
+     *  <Attribute name="Test" />
+     *  <Attribute name="Test2" args={["arg1", "arg2"]} />
+     * ]}>
+     * ```
+     * This will produce:
+     * ```csharp
+     * [Test]
+     * [Test2("arg1", "arg2")]
+     * public class MyClass
+     * ```
+     */
+    attributes?: AttributesProp;
 }
 /**
  * CSharp class declaration.
@@ -50,6 +85,8 @@ export interface ClassMemberProps extends AccessModifiers {
     name: string;
     type: core.Children;
     refkey?: core.Refkey;
+    /** Doc comment */
+    doc?: core.Children;
 }
 export declare function ClassMember(props: ClassMemberProps): core.Children;
 //# sourceMappingURL=ClassDeclaration.d.ts.map

package/dist/src/components/ClassDeclaration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClassDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/ClassDeclaration.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,EACL,eAAe,EAIhB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAAE,cAAc,EAAc,MAAM,kBAAkB,CAAC;AAG9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAUD,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,EAC7C,eAAe,EACf,cAAc;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,iBAyD5D;AAED,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,UAAU,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC;IAC3B,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;CAC1B;AAGD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,iBAkC5D;AAGD,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC;CACtB;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,iBAyBlD"}
+{"version":3,"file":"ClassDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/ClassDeclaration.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EACL,eAAe,EAIhB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAiB,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAc,MAAM,6BAA6B,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAG1E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAUD,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,EAC7C,eAAe,EACf,cAAc;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC;IAErB;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,GAAG,kBAAkB,CAAC,EAAE,CAAC;IAEjD,yCAAyC;IACzC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;IAEzB,uCAAuC;IACvC,cAAc,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IAEjC;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,iBA6C5D;AAED,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,UAAU,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC;IAC3B,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;CAC1B;AAGD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,iBAiC5D;AAGD,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC;IACrB,kBAAkB;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;CACrB;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,iBA0BlD"}

package/dist/src/components/ClassDeclaration.js

@@ -1,12 +1,16 @@
-import { createComponent as _$createComponent, createIntrinsic as _$createIntrinsic, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import { memo as _$memo, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
 import * as core from "@alloy-js/core";
+import { join } 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, useCSharpScope } from "../symbols/scopes.js";
-import { Name } from "./Name.js";
-import { Parameters } from "./Parameters.js";
+import { AttributeList } from "./attributes/attributes.js";
 import { DocWhen } from "./doc/comment.js";
+import { Name } from "./Name.js";
+import { Parameters } from "./parameters/parameters.js";
+import { TypeParameterConstraints } from "./type-parameters/type-parameter-constraints.js";
+import { TypeParameters } from "./type-parameters/type-parameters.js";
 const getClassModifiers = makeModifiers(["abstract", "partial", "sealed", "static"]);
 
 // properties for creating a class
@@ -48,29 +52,10 @@ export function ClassDeclaration(props) {
   const thisClassScope = new CSharpMemberScope("class-decl", {
     owner: thisClassSymbol
   });
-  let typeParams;
-  if (props.typeParameters) {
-    const typeParamNames = new Array();
-    for (const entry of Object.entries(props.typeParameters)) {
-      typeParamNames.push(useCSharpNamePolicy().getName(entry[0], "type-parameter"));
-      // create a symbol for each type param so its
-      // refkey resolves to the type param's name
-      new CSharpOutputSymbol(entry[0], {
-        scope: thisClassScope,
-        refkeys: entry[1]
-      });
-    }
-    typeParams = _$createIntrinsic("group", {
-      get children() {
-        return ["<", _$createComponent(core.For, {
-          each: typeParamNames,
-          comma: true,
-          line: true,
-          children: name => name
-        }), ">"];
-      }
-    });
-  }
+  const bases = [...(props.baseType ? [props.baseType] : []), ...(props.interfaceTypes || [])];
+  const base = bases.length > 0 ? [" : ", _$memo(() => join(bases, {
+    joiner: ", "
+  }))] : null;
   const modifiers = computeModifiersPrefix([getAccessModifier(props), getClassModifiers(props)]);
   return _$createComponent(core.Declaration, {
     symbol: thisClassSymbol,
@@ -79,7 +64,20 @@ export function ClassDeclaration(props) {
         get doc() {
           return props.doc;
         }
-      }), modifiers, "class ", _$createComponent(Name, {}), typeParams, _$memo(() => !props.children && ";"), _$memo(() => _$memo(() => !!props.children)() && _$createComponent(core.Block, {
+      }), _$createComponent(AttributeList, {
+        get attributes() {
+          return props.attributes;
+        },
+        endline: true
+      }), modifiers, "class ", _$createComponent(Name, {}), _$memo(() => _$memo(() => !!props.typeParameters)() && _$createComponent(TypeParameters, {
+        get parameters() {
+          return props.typeParameters;
+        }
+      })), base, _$memo(() => _$memo(() => !!props.typeParameters)() && _$createComponent(TypeParameterConstraints, {
+        get parameters() {
+          return props.typeParameters;
+        }
+      })), _$memo(() => !props.children && ";"), _$memo(() => _$memo(() => !!props.children)() && _$createComponent(core.Block, {
         newline: true,
         get children() {
           return _$createComponent(core.Scope, {
@@ -112,11 +110,6 @@ export function ClassConstructor(props) {
     owner: ctorSymbol
   });
   const modifiers = computeModifiersPrefix([getAccessModifier(props)]);
-  const params = props.parameters ? _$createComponent(Parameters, {
-    get parameters() {
-      return props.parameters;
-    }
-  }) : "";
 
   // note that scope wraps the ctor decl so that the params get the correct scope
   return _$createComponent(core.Declaration, {
@@ -125,7 +118,11 @@ export function ClassConstructor(props) {
       return _$createComponent(core.Scope, {
         value: ctorDeclScope,
         get children() {
-          return [modifiers, _$createComponent(Name, {}), "(", params, ")", _$createComponent(core.Block, {
+          return [modifiers, _$createComponent(Name, {}), _$createComponent(Parameters, {
+            get parameters() {
+              return props.parameters;
+            }
+          }), _$createComponent(core.Block, {
             newline: true,
             get children() {
               return props.children;
@@ -158,7 +155,11 @@ export function ClassMember(props) {
   return _$createComponent(core.Declaration, {
     symbol: memberSymbol,
     get children() {
-      return [modifiers, _$memo(() => props.type), " ", _$createComponent(Name, {})];
+      return [_$createComponent(DocWhen, {
+        get doc() {
+          return props.doc;
+        }
+      }), modifiers, _$memo(() => props.type), " ", _$createComponent(Name, {})];
     }
   });
 }

package/dist/src/components/ClassMethod.d.ts

@@ -1,6 +1,8 @@
 import { Children, Refkey } from "@alloy-js/core";
 import { AccessModifiers } from "../modifiers.js";
-import { ParameterProps } from "./Parameters.jsx";
+import { AttributesProp } from "./attributes/attributes.jsx";
+import { ParameterProps } from "./parameters/parameters.jsx";
+import { TypeParameterProps } from "./type-parameters/type-parameter.jsx";
 /** Method modifiers. Can only be one. */
 export interface ClassMethodModifiers {
     readonly abstract?: boolean;
@@ -20,6 +22,36 @@ export interface ClassMethodProps extends AccessModifiers, ClassMethodModifiers
     async?: boolean;
     /** Doc comment */
     doc?: Children;
+    /**
+     * Type parameters for the method
+     *
+     * @example
+     * ```tsx
+     * <InterfaceMethod name="Test" typeParameters={["T"]} />
+     * ```
+     * This will produce:
+     * ```csharp
+     * public void Test<T>()
+     * ```
+     */
+    typeParameters?: (TypeParameterProps | string)[];
+    /**
+     * Define attributes to attach
+     * @example
+     * ```tsx
+     * <ClassMethod name="MyMethod" attributes={[
+     *  <Attribute name="Test" />
+     *  <Attribute name="Test2" args={["arg1", "arg2"]} />
+     * ]} />
+     * ```
+     * This will produce:
+     * ```csharp
+     * [Test]
+     * [Test2("arg1", "arg2")]
+     * public void MyMethod() { }
+     * ```
+     */
+    attributes?: AttributesProp;
 }
 export declare function ClassMethod(props: ClassMethodProps): Children;
 //# sourceMappingURL=ClassMethod.d.ts.map

package/dist/src/components/ClassMethod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClassMethod.d.ts","sourceRoot":"","sources":["../../../src/components/ClassMethod.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAGR,MAAM,EAEP,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,eAAe,EAKhB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,cAAc,EAAc,MAAM,kBAAkB,CAAC;AAG9D,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAUD,MAAM,WAAW,gBACf,SAAQ,eAAe,EACrB,oBAAoB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,kBAAkB;IAClB,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,YAqClD"}
+{"version":3,"file":"ClassMethod.d.ts","sourceRoot":"","sources":["../../../src/components/ClassMethod.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAGR,MAAM,EAEP,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,eAAe,EAKhB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAiB,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAc,MAAM,6BAA6B,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAG1E,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAUD,MAAM,WAAW,gBACf,SAAQ,eAAe,EACrB,oBAAoB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,kBAAkB;IAClB,GAAG,CAAC,EAAE,QAAQ,CAAC;IAEf;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,CAAC,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC;IAEjD;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,YA2ClD"}

package/dist/src/components/ClassMethod.js

@@ -4,8 +4,11 @@ import { computeModifiersPrefix, getAccessModifier, getAsyncModifier, makeModifi
 import { useCSharpNamePolicy } from "../name-policy.js";
 import { CSharpOutputSymbol } from "../symbols/csharp-output-symbol.js";
 import { CSharpMemberScope, useCSharpScope } from "../symbols/scopes.js";
-import { Parameters } from "./Parameters.js";
+import { AttributeList } from "./attributes/attributes.js";
 import { DocWhen } from "./doc/comment.js";
+import { Parameters } from "./parameters/parameters.js";
+import { TypeParameterConstraints } from "./type-parameters/type-parameter-constraints.js";
+import { TypeParameters } from "./type-parameters/type-parameters.js";
 
 /** Method modifiers. Can only be one. */
 
@@ -29,11 +32,6 @@ export function ClassMethod(props) {
   const methodScope = new CSharpMemberScope("method-decl", {
     owner: methodSymbol
   });
-  const params = props.parameters ? _$createComponent(Parameters, {
-    get parameters() {
-      return props.parameters;
-    }
-  }) : "";
   const returns = props.returns ?? (props.async ? "Task" : "void");
   const modifiers = computeModifiersPrefix([getAccessModifier(props), getMethodModifier(props), getAsyncModifier(props.async)]);
   // note that scope wraps the method decl so that the params get the correct scope
@@ -47,7 +45,24 @@ export function ClassMethod(props) {
             get doc() {
               return props.doc;
             }
-          }), modifiers, returns, " ", name, "(", params, ")", _$memo(() => _$memo(() => !!props.abstract)() ? ";" : _$createComponent(Block, {
+          }), _$createComponent(AttributeList, {
+            get attributes() {
+              return props.attributes;
+            },
+            endline: true
+          }), modifiers, returns, " ", name, _$memo(() => _$memo(() => !!props.typeParameters)() && _$createComponent(TypeParameters, {
+            get parameters() {
+              return props.typeParameters;
+            }
+          })), _$createComponent(Parameters, {
+            get parameters() {
+              return props.parameters;
+            }
+          }), _$memo(() => _$memo(() => !!props.typeParameters)() && _$createComponent(TypeParameterConstraints, {
+            get parameters() {
+              return props.typeParameters;
+            }
+          })), _$memo(() => _$memo(() => !!props.abstract)() ? ";" : _$createComponent(Block, {
             newline: true,
             get children() {
               return props.children;

package/dist/src/components/SourceFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SourceFile.d.ts","sourceRoot":"","sources":["../../../src/components/SourceFile.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAMvC,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAKD,wBAAgB,aAAa,IAAI,iBAAiB,GAAG,SAAS,CAE7D;AAED,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEtB,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;CAC1B;AAID,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,iBA8ChD"}
+{"version":3,"file":"SourceFile.d.ts","sourceRoot":"","sources":["../../../src/components/SourceFile.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAMvC,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAKD,wBAAgB,aAAa,IAAI,iBAAiB,GAAG,SAAS,CAE7D;AAED,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEtB,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;CAC1B;AAID,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,iBA+ChD"}

package/dist/src/components/SourceFile.js

@@ -41,6 +41,7 @@ export function SourceFile(props) {
     filetype: "cs",
     reference: Reference,
     tabWidth: 4,
+    printWidth: 120,
     get children() {
       return _$createComponent(SourceFileContext.Provider, {
         value: sourceFileCtx,

package/dist/src/components/attributes/attributes.d.ts

@@ -0,0 +1,39 @@
+import { Children } from "@alloy-js/core";
+export interface AttributeItem {
+    name: string;
+    args?: string[];
+}
+export type AttributesProp = Array<string | AttributeProps | Children>;
+export interface AttributeListProps {
+    /** If the attribute list should finish with a hard line if there is any attribute */
+    endline?: boolean;
+    attributes?: AttributesProp;
+    children?: Children[];
+}
+/**
+ * Render each attributes in a new line.
+ */
+export declare function AttributeList(props: AttributeListProps): Children;
+export interface AttributeProps {
+    /** Attribute name */
+    name: Children;
+    /** Argument */
+    args?: Children[];
+}
+/**
+ * Render a csharp attribute.
+ *
+ * @example
+ * ```tsx
+ * <Attribute name="Test" /><hbr/>
+ * <Attribute name="Test" args={["arg1", "arg2"]} />
+ * ```
+ *
+ * will render:
+ * ```csharp
+ * [Test]
+ * [Test("arg1", "arg2")]
+ * ```
+ */
+export declare const Attribute: import("@alloy-js/core").Component<AttributeProps> & Required<Pick<import("@alloy-js/core").Component<AttributeProps>, "tag">>;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/src/components/attributes/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../../src/components/attributes/attributes.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAKT,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,cAAc,GAAG,QAAQ,CAAC,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,YAiBtD;AAYD,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,IAAI,EAAE,QAAQ,CAAC;IAEf,eAAe;IACf,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;CACnB;AAGD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,gIAqBrB,CAAC"}

package/dist/src/components/attributes/attributes.js

@@ -0,0 +1,62 @@
+import { createComponent as _$createComponent, memo as _$memo, createIntrinsic as _$createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { findKeyedChildren, For, Indent, taggedComponent } from "@alloy-js/core";
+/**
+ * Render each attributes in a new line.
+ */
+export function AttributeList(props) {
+  const attributes = props.attributes ?? (props.children && findKeyedChildren(props.children, Attribute.tag));
+  if (!attributes) {
+    return null;
+  }
+  return [_$createComponent(For, {
+    each: attributes,
+    line: true,
+    children: arg => renderAttribute(arg)
+  }), _$memo(() => _$memo(() => !!(props.endline && attributes.length > 0))() && _$createIntrinsic("hbr", {}))];
+}
+function renderAttribute(attr) {
+  if (typeof attr === "string") {
+    return _$createComponent(Attribute, {
+      name: attr
+    });
+  } else if (typeof attr === "object" && attr && "name" in attr) {
+    return _$createComponent(Attribute, attr);
+  } else {
+    return attr;
+  }
+}
+const AttributeTag = Symbol("AttributeTag");
+/**
+ * Render a csharp attribute.
+ *
+ * @example
+ * ```tsx
+ * <Attribute name="Test" /><hbr/>
+ * <Attribute name="Test" args={["arg1", "arg2"]} />
+ * ```
+ *
+ * will render:
+ * ```csharp
+ * [Test]
+ * [Test("arg1", "arg2")]
+ * ```
+ */
+export const Attribute = taggedComponent(AttributeTag, props => {
+  return _$createIntrinsic("group", {
+    get children() {
+      return ["[", _$memo(() => props.name), _$memo(() => _$memo(() => !!(props.args && props.args.length > 0))() && ["(", _$createComponent(Indent, {
+        softline: true,
+        get children() {
+          return _$createComponent(For, {
+            get each() {
+              return props.args ?? [];
+            },
+            comma: true,
+            line: true,
+            children: arg => arg
+          });
+        }
+      }), ")"]), "]"];
+    }
+  });
+});

package/dist/src/components/attributes/attributes.test.d.ts

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

package/dist/src/components/attributes/attributes.test.d.ts.map

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

package/dist/src/components/attributes/attributes.test.js

@@ -0,0 +1,75 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { expect, it } from "vitest";
+import { Attribute, AttributeList } from "./attributes.js";
+it("define attribute", () => {
+  expect(_$createComponent(Attribute, {
+    name: "Test"
+  })).toRenderTo(`
+      [Test]
+  `);
+});
+it("define attribute with single arg", () => {
+  expect(_$createComponent(Attribute, {
+    name: "Test",
+    args: [`"abc"`]
+  })).toRenderTo(`
+      [Test("abc")]
+  `);
+});
+it("define attribute with multiple arg", () => {
+  expect(_$createComponent(Attribute, {
+    name: "Test",
+    args: [`"abc"`, `"def"`]
+  })).toRenderTo(`
+      [Test("abc", "def")]
+  `);
+});
+it("define attribute list with Attribute components", () => {
+  expect(_$createComponent(AttributeList, {
+    get attributes() {
+      return [_$createComponent(Attribute, {
+        name: "TestA"
+      }), _$createComponent(Attribute, {
+        name: "TestB"
+      })];
+    }
+  })).toRenderTo(`
+      [TestA]
+      [TestB]
+  `);
+});
+it("define attribute list with attribute names", () => {
+  expect(_$createComponent(AttributeList, {
+    attributes: ["TestA", "TestB"]
+  })).toRenderTo(`
+      [TestA]
+      [TestB]
+  `);
+});
+it("define attribute list with attribute props", () => {
+  expect(_$createComponent(AttributeList, {
+    attributes: [{
+      name: "TestA"
+    }, {
+      name: "TestB",
+      args: [`"test"`]
+    }]
+  })).toRenderTo(`
+      [TestA]
+      [TestB("test")]
+  `);
+});
+it("define attribute list with children", () => {
+  expect(_$createComponent(AttributeList, {
+    get children() {
+      return [_$createComponent(Attribute, {
+        name: "TestA"
+      }), _$createComponent(Attribute, {
+        name: "TestB"
+      })];
+    }
+  })).toRenderTo(`
+      [TestA]
+      [TestB]
+  `);
+});

package/dist/src/components/doc/comment.d.ts

@@ -15,7 +15,7 @@ export declare function makeDocCommentTag(name: string): (props: DocCommentProps
 export declare function makeInlineDocCommentTag(name: string): (props: DocCommentProps) => string;
 export declare const DocSummary: (props: DocCommentProps) => Children;
 export declare const DocCode: (props: DocCommentProps) => Children;
-export declare const DocC: (props: DocCommentProps) => Children;
+export declare const DocC: (props: DocCommentProps) => string;
 export declare const DocExample: (props: DocCommentProps) => Children;
 export declare const DocException: (props: DocCommentProps) => Children;
 export interface DocIncludeProps {
@@ -39,25 +39,21 @@ export declare const DocReturns: (props: DocCommentProps) => Children;
 export declare const DocRemarks: (props: DocCommentProps) => Children;
 export declare const DocValue: (props: DocCommentProps) => Children;
 export declare const DocPermission: (props: DocCommentProps) => Children;
-export declare const DocResponse: (props: DocCommentProps) => Children;
-export declare const DocCompletionList: (props: DocCommentProps) => Children;
-export declare const DocList: (props: DocCommentProps) => Children;
-export declare const DocItem: (props: DocCommentProps) => Children;
-export declare const DocTerm: (props: DocCommentProps) => Children;
 export declare const DocDescription: (props: DocCommentProps) => Children;
 export declare const DocPara: (props: DocCommentProps) => Children;
 export interface DocSeeProps {
-    cref: string;
+    cref?: string;
+    href?: string;
     langword?: string;
     children?: Children;
 }
-export declare const DocSee: (props: DocSeeProps) => string;
+export declare const DocSee: (props: DocSeeProps) => Children;
 export interface DocSeeAlsoProps {
-    cref: string;
-    langword?: string;
+    cref?: string;
+    href?: string;
     children?: Children;
 }
-export declare const DocSeeAlso: (props: DocSeeAlsoProps) => string;
+export declare const DocSeeAlso: (props: DocSeeAlsoProps) => Children;
 export interface DocParamRefProps {
     name: string;
 }
@@ -66,4 +62,9 @@ export interface DocTypeParamRefProps {
     name: string;
 }
 export declare const DocTypeParamRef: (props: DocTypeParamRefProps) => string;
+export interface DocListProps {
+    type?: "bullet" | "number";
+    items: Children[];
+}
+export declare function DocList(props: DocListProps): Children;
 //# sourceMappingURL=comment.d.ts.map

package/dist/src/components/doc/comment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../../../src/components/doc/comment.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../../../src/components/doc/comment.tsx"],"names":[],"mappings":"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"}

package/dist/src/components/doc/comment.js

@@ -1,5 +1,5 @@
 import { createComponent as _$createComponent, createIntrinsic as _$createIntrinsic, memo as _$memo } from "@alloy-js/core/jsx-runtime";
-import { code, List, Prose, Show } from "@alloy-js/core";
+import { code, For, Indent, List, Prose, Show } from "@alloy-js/core";
 export function DocComment(props) {
   return ["/// ", _$createIntrinsic("align", {
     string: "/// ",
@@ -46,7 +46,7 @@ export function makeInlineDocCommentTag(name) {
 }
 export const DocSummary = makeDocCommentTag("summary");
 export const DocCode = makeDocCommentTag("code");
-export const DocC = makeDocCommentTag("c");
+export const DocC = makeInlineDocCommentTag("c");
 export const DocExample = makeDocCommentTag("example");
 export const DocException = makeDocCommentTag("exception");
 export const DocInclude = props => {
@@ -58,14 +58,31 @@ export const DocReturns = makeDocCommentTag("returns");
 export const DocRemarks = makeDocCommentTag("remarks");
 export const DocValue = makeDocCommentTag("value");
 export const DocPermission = makeDocCommentTag("permission");
-export const DocResponse = makeDocCommentTag("response");
-export const DocCompletionList = makeDocCommentTag("completionlist");
-export const DocList = makeDocCommentTag("list");
-export const DocItem = makeDocCommentTag("item");
-export const DocTerm = makeDocCommentTag("term");
 export const DocDescription = makeDocCommentTag("description");
 export const DocPara = makeDocCommentTag("para");
-export const DocSee = props => `<see cref="${props.cref}"${props.langword ? ` langword="${props.langword}"` : ""}${props.children ? `>${props.children}</see>` : " />"}`;
-export const DocSeeAlso = props => `<seealso cref="${props.cref}"${props.langword ? ` langword="${props.langword}"` : ""}${props.children ? `>${props.children}</seealso>` : " />"}`;
+export const DocSee = props => {
+  const attributes = [props.cref ? `cref="${props.cref}"` : undefined, props.href ? `href="${props.href}"` : undefined, props.langword ? `langword="${props.langword}"` : undefined].filter(Boolean).join(" ");
+  return code`<see ${attributes}${props.children ? code`>${props.children}</see>` : " />"}`;
+};
+export const DocSeeAlso = props => {
+  const attributes = [props.cref ? `cref="${props.cref}"` : undefined, props.href ? `href="${props.href}"` : undefined].filter(Boolean).join(" ");
+  return code`<seealso ${attributes}${props.children ? code`>${props.children}</seealso>` : " />"}`;
+};
 export const DocParamRef = props => `<paramref name="${props.name}" />`;
-export const DocTypeParamRef = props => `<typeparamref name="${props.name}" />`;
+export const DocTypeParamRef = props => `<typeparamref name="${props.name}" />`;
+export function DocList(props) {
+  return _$createComponent(Prose, {
+    get children() {
+      return [_$memo(() => `<list type="${props.type ?? "bullet"}">`), _$createComponent(Indent, {
+        get children() {
+          return _$createComponent(For, {
+            get each() {
+              return props.items;
+            },
+            children: item => code`<item><description>${item}</description></item>`
+          });
+        }
+      }), _$createIntrinsic("hbr", {}), `</list>`];
+    }
+  });
+}