@alloy-js/csharp 0.18.0-dev.22 → 0.18.0-dev.24

package/temp/api.json

@@ -325,6 +325,434 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@alloy-js/csharp!Attribute:var",
+          "docComment": "/**\n * Render a csharp attribute.\n *\n * @example\n * ```tsx\n * <Attribute name=\"Test\" /><hbr/>\n * <Attribute name=\"Test\" args={[\"arg1\", \"arg2\"]} />\n * ```\n *\n *\n * will render:\n * ```csharp\n * [Test]\n * [Test(\"arg1\", \"arg2\")]\n * ```\n *\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "Attribute: "
+            },
+            {
+              "kind": "Content",
+              "text": "import(\"@alloy-js/core\")."
+            },
+            {
+              "kind": "Reference",
+              "text": "Component",
+              "canonicalReference": "@alloy-js/core!Component:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "AttributeProps",
+              "canonicalReference": "@alloy-js/csharp!AttributeProps:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "> & "
+            },
+            {
+              "kind": "Reference",
+              "text": "Required",
+              "canonicalReference": "!Required:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "Pick",
+              "canonicalReference": "!Pick:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<import(\"@alloy-js/core\")."
+            },
+            {
+              "kind": "Reference",
+              "text": "Component",
+              "canonicalReference": "@alloy-js/core!Component:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "AttributeProps",
+              "canonicalReference": "@alloy-js/csharp!AttributeProps:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">, \"tag\">>"
+            }
+          ],
+          "fileUrlPath": "src/components/attributes/attributes.tsx",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "Attribute",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 14
+          }
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@alloy-js/csharp!AttributeItem:interface",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface AttributeItem "
+            }
+          ],
+          "fileUrlPath": "src/components/attributes/attributes.tsx",
+          "releaseTag": "Public",
+          "name": "AttributeItem",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!AttributeItem#args:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "args?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "args",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!AttributeItem#name:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "name: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "name",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/csharp!AttributeList:function(1)",
+          "docComment": "/**\n * Render each attributes in a new line.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function AttributeList(props: "
+            },
+            {
+              "kind": "Reference",
+              "text": "AttributeListProps",
+              "canonicalReference": "@alloy-js/csharp!AttributeListProps:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Children",
+              "canonicalReference": "@alloy-js/core!Children:type"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/components/attributes/attributes.tsx",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "props",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "AttributeList"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@alloy-js/csharp!AttributeListProps:interface",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface AttributeListProps "
+            }
+          ],
+          "fileUrlPath": "src/components/attributes/attributes.tsx",
+          "releaseTag": "Public",
+          "name": "AttributeListProps",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!AttributeListProps#attributes:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "attributes?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AttributesProp",
+                  "canonicalReference": "@alloy-js/csharp!AttributesProp:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "attributes",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!AttributeListProps#children:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "children?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Children",
+                  "canonicalReference": "@alloy-js/core!Children:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "children",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!AttributeListProps#endline:member",
+              "docComment": "/**\n * If the attribute list should finish with a hard line if there is any attribute\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "endline?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "endline",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@alloy-js/csharp!AttributeProps:interface",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface AttributeProps "
+            }
+          ],
+          "fileUrlPath": "src/components/attributes/attributes.tsx",
+          "releaseTag": "Public",
+          "name": "AttributeProps",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!AttributeProps#args:member",
+              "docComment": "/**\n * Argument\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "args?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Children",
+                  "canonicalReference": "@alloy-js/core!Children:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "args",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!AttributeProps#name:member",
+              "docComment": "/**\n * Attribute name\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "name: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Children",
+                  "canonicalReference": "@alloy-js/core!Children:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "name",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@alloy-js/csharp!AttributesProp:type",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type AttributesProp = "
+            },
+            {
+              "kind": "Reference",
+              "text": "Array",
+              "canonicalReference": "!Array:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<string | "
+            },
+            {
+              "kind": "Reference",
+              "text": "AttributeProps",
+              "canonicalReference": "@alloy-js/csharp!AttributeProps:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " | "
+            },
+            {
+              "kind": "Reference",
+              "text": "Children",
+              "canonicalReference": "@alloy-js/core!Children:type"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/components/attributes/attributes.tsx",
+          "releaseTag": "Public",
+          "name": "AttributesProp",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 7
+          }
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/csharp!ClassConstructor:function(1)",
@@ -631,6 +1059,34 @@
           "name": "ClassDeclarationProps",
           "preserveMemberOrder": false,
           "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!ClassDeclarationProps#attributes:member",
+              "docComment": "/**\n * Define attributes to attach\n *\n * @example\n * ```tsx\n * <ClassDeclaration name=\"MyClass\" attributes={[\n *  <Attribute name=\"Test\" />\n *  <Attribute name=\"Test2\" args={[\"arg1\", \"arg2\"]} />\n * ]}>\n * ```\n *\n * This will produce:\n * ```csharp\n * [Test]\n * [Test2(\"arg1\", \"arg2\")]\n * public class MyClass\n * ```\n *\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "attributes?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AttributesProp",
+                  "canonicalReference": "@alloy-js/csharp!AttributesProp:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "attributes",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/csharp!ClassDeclarationProps#baseType:member",
@@ -1249,6 +1705,34 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!ClassMethodProps#attributes:member",
+              "docComment": "/**\n * Define attributes to attach\n *\n * @example\n * ```tsx\n * <ClassMethod name=\"MyMethod\" attributes={[\n *  <Attribute name=\"Test\" />\n *  <Attribute name=\"Test2\" args={[\"arg1\", \"arg2\"]} />\n * ]} />\n * ```\n *\n * This will produce:\n * ```csharp\n * [Test]\n * [Test2(\"arg1\", \"arg2\")]\n * public void MyMethod() { }\n * ```\n *\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "attributes?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AttributesProp",
+                  "canonicalReference": "@alloy-js/csharp!AttributesProp:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "attributes",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/csharp!ClassMethodProps#children:member",
@@ -4470,6 +4954,34 @@
           "name": "InterfaceDeclarationProps",
           "preserveMemberOrder": false,
           "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!InterfaceDeclarationProps#attributes:member",
+              "docComment": "/**\n * Define attributes to attach\n *\n * @example\n * ```tsx\n * <InterfaceDeclaration name=\"MyInterface\" attributes={[\n *  <Attribute name=\"Test\" />\n *  <Attribute name=\"Test2\" args={[\"arg1\", \"arg2\"]} />\n * ]} />\n * ```\n *\n * This will produce:\n * ```csharp\n * [Test]\n * [Test2(\"arg1\", \"arg2\")]\n * public interface MyInterface\n * ```\n *\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "attributes?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AttributesProp",
+                  "canonicalReference": "@alloy-js/csharp!AttributesProp:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "attributes",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/csharp!InterfaceDeclarationProps#doc:member",
@@ -4730,6 +5242,34 @@
           "name": "InterfaceMethodProps",
           "preserveMemberOrder": false,
           "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!InterfaceMethodProps#attributes:member",
+              "docComment": "/**\n * Define attributes to attach\n *\n * @example\n * ```tsx\n * <InterfaceMethod name=\"MyMethod\" attributes={[\n *  <Attribute name=\"Test\" />\n *  <Attribute name=\"Test2\" args={[\"arg1\", \"arg2\"]} />\n * ]} />\n * ```\n *\n * This will produce:\n * ```csharp\n * [Test]\n * [Test2(\"arg1\", \"arg2\")]\n * void MyMethod();\n * ```\n *\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "attributes?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AttributesProp",
+                  "canonicalReference": "@alloy-js/csharp!AttributesProp:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "attributes",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/csharp!InterfaceMethodProps#children:member",
@@ -5128,6 +5668,34 @@
           "name": "InterfacePropertyProps",
           "preserveMemberOrder": false,
           "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!InterfacePropertyProps#attributes:member",
+              "docComment": "/**\n * Define attributes to attach\n *\n * @example\n * ```tsx\n * <InterfaceProperty name=\"MyProp\" attributes={[\n *  <Attribute name=\"Test\" />\n *  <Attribute name=\"Test2\" args={[\"arg1\", \"arg2\"]} />\n * ]} />\n * ```\n *\n * This will produce:\n * ```csharp\n * [Test]\n * [Test2(\"arg1\", \"arg2\")]\n * int MyProp { get; set; }\n * ```\n *\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "attributes?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AttributesProp",
+                  "canonicalReference": "@alloy-js/csharp!AttributesProp:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "attributes",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/csharp!InterfacePropertyProps#doc:member",
@@ -6626,6 +7194,34 @@
           "name": "PropertyProps",
           "preserveMemberOrder": false,
           "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!PropertyProps#attributes:member",
+              "docComment": "/**\n * Define attributes to attach\n *\n * @example\n * ```tsx\n * <Property name=\"MyProp\" attributes={[\n *  <Attribute name=\"Test\" />\n *  <Attribute name=\"Test2\" args={[\"arg1\", \"arg2\"]} />\n * ]} />\n * ```\n *\n * This will produce:\n * ```csharp\n * [Test]\n * [Test2(\"arg1\", \"arg2\")]\n * int MyProp { get; set; }\n * ```\n *\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "attributes?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AttributesProp",
+                  "canonicalReference": "@alloy-js/csharp!AttributesProp:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "attributes",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/csharp!PropertyProps#doc:member",

package/test/class-declaration.test.tsx

@@ -2,6 +2,7 @@ import * as core from "@alloy-js/core";
 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.jsx";
 import { TypeParameterProps } from "../src/components/type-parameters/type-parameter.jsx";
 import * as csharp from "../src/index.js";
 import {
@@ -416,3 +417,14 @@ it("supports class member doc comments", () => {
     }
   `);
 });
+
+it("specify attributes", () => {
+  expect(
+    <utils.TestNamespace>
+      <ClassDeclaration name="Test" attributes={[<Attribute name="Test" />]} />
+    </utils.TestNamespace>,
+  ).toRenderTo(`
+    [Test]
+    class Test;
+  `);
+});