@alloy-js/csharp 0.21.0-dev.19 → 0.21.0-dev.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alloy-js/csharp",
-  "version": "0.21.0-dev.19",
+  "version": "0.21.0-dev.20",
   "description": "Alloy components for CSharp language.",
   "exports": {
     ".": {
@@ -30,6 +30,7 @@
   "license": "MIT",
   "dependencies": {
     "@alloy-js/core": "~0.20.0 || >= 0.21.0-dev.8",
+    "@alloy-js/msbuild": "~0.20.0 || >= 0.20.1-dev.1",
     "change-case": "^5.4.4",
     "marked": "^16.1.1",
     "pathe": "^2.0.3"

package/src/components/csproj-file/csproj-file.test.tsx

@@ -0,0 +1,19 @@
+import { expect, it } from "vitest";
+import { CsprojFile } from "./csproj-file.jsx";
+
+it("create empty .csproj file", () => {
+  expect(<CsprojFile path={"foo.csproj"}>{"<!-- content -->"}</CsprojFile>)
+    .toRenderTo(`
+    <Project Sdk="Microsoft.NET.Sdk"><!-- content --></Project>
+  `);
+});
+
+it("set different sdk", () => {
+  expect(
+    <CsprojFile path={"foo.csproj"} sdk="Microsoft.NET.Sdk.Web">
+      {"<!-- content -->"}
+    </CsprojFile>,
+  ).toRenderTo(`
+    <Project Sdk="Microsoft.NET.Sdk.Web"><!-- content --></Project>
+  `);
+});

package/src/components/csproj-file/csproj-file.tsx

@@ -0,0 +1,32 @@
+import { Children, SourceFile } from "@alloy-js/core";
+import { Project } from "@alloy-js/msbuild/components";
+
+export type CSharpProjectSdk =
+  | "Microsoft.NET.Sdk"
+  | "Microsoft.NET.Sdk.Web"
+  | "Microsoft.NET.Sdk.Worker"
+  | "Microsoft.NET.Sdk.Razor"
+  | "Microsoft.NET.Sdk.BlazorWebAssembly"
+  | "Aspire.AppHost.Sdk"
+  | "MSTest.Sdk";
+
+export interface CsprojProps {
+  path: `${string}.csproj`;
+  /**
+   * Project SDK https://learn.microsoft.com/en-us/dotnet/core/project-sdk/overview
+   * @default "Microsoft.NET.Sdk"
+   */
+  sdk?: CSharpProjectSdk;
+
+  /** Content inside <project> */
+  children?: Children;
+}
+
+/** Create a .csproj file */
+export function CsprojFile(props: CsprojProps) {
+  return (
+    <SourceFile path={props.path} filetype="xml" tabWidth={4}>
+      <Project Sdk={props.sdk ?? "Microsoft.NET.Sdk"}>{props.children}</Project>
+    </SourceFile>
+  );
+}

package/src/components/index.ts

@@ -2,6 +2,7 @@ export * from "./access-expression/access-expression.jsx";
 export * from "./attributes/attributes.jsx";
 export * from "./class/declaration.jsx";
 export * from "./constructor/constructor.jsx";
+export * from "./csproj-file/csproj-file.jsx";
 export * from "./Declaration.js";
 export * from "./doc/comment.jsx";
 export * from "./doc/from-markdown.jsx";
@@ -19,7 +20,6 @@ export * from "./method/method.jsx";
 export * from "./Name.js";
 export { Namespace, type NamespaceProps } from "./namespace/namespace.jsx";
 export * from "./parameters/parameters.jsx";
-export * from "./ProjectDirectory.js";
 export * from "./property/property.jsx";
 export * from "./record/declaration.js";
 export * from "./Reference.js";

package/src/components/stc/index.ts

@@ -9,6 +9,5 @@ export const EnumDeclaration = core.stc(base.EnumDeclaration);
 export const EnumMember = core.stc(base.EnumMember);
 export const Parameter = core.stc(base.Parameter);
 export const Parameters = core.stc(base.Parameters);
-export const ProjectDirectory = core.stc(base.ProjectDirectory);
 export const UsingDirective = core.stc(base.Usings);
 export const StructDeclaration = core.stc(base.StructDeclaration);

package/temp/api.json

@@ -115,48 +115,14 @@
           "syntaxKind": "modifier"
         },
         {
-          "tagName": "@betaDocumentation",
+          "tagName": "@reactive",
           "syntaxKind": "modifier"
         },
         {
-          "tagName": "@internalRemarks",
+          "tagName": "@default",
           "syntaxKind": "block"
-        },
-        {
-          "tagName": "@preapproved",
-          "syntaxKind": "modifier"
         }
       ],
-      "supportForTags": {
-        "@alpha": true,
-        "@beta": true,
-        "@defaultValue": true,
-        "@decorator": true,
-        "@deprecated": true,
-        "@eventProperty": true,
-        "@example": true,
-        "@experimental": true,
-        "@inheritDoc": true,
-        "@internal": true,
-        "@label": true,
-        "@link": true,
-        "@override": true,
-        "@packageDocumentation": true,
-        "@param": true,
-        "@privateRemarks": true,
-        "@public": true,
-        "@readonly": true,
-        "@remarks": true,
-        "@returns": true,
-        "@sealed": true,
-        "@see": true,
-        "@throws": true,
-        "@typeParam": true,
-        "@virtual": true,
-        "@betaDocumentation": true,
-        "@internalRemarks": true,
-        "@preapproved": true
-      },
       "reportUnsupportedHtmlElements": false
     }
   },
@@ -4558,6 +4524,32 @@
           },
           "implementsTokenRanges": []
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@alloy-js/csharp!CSharpProjectSdk:type",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type CSharpProjectSdk = "
+            },
+            {
+              "kind": "Content",
+              "text": "\"Microsoft.NET.Sdk\" | \"Microsoft.NET.Sdk.Web\" | \"Microsoft.NET.Sdk.Worker\" | \"Microsoft.NET.Sdk.Razor\" | \"Microsoft.NET.Sdk.BlazorWebAssembly\" | \"Aspire.AppHost.Sdk\" | \"MSTest.Sdk\""
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/components/csproj-file/csproj-file.tsx",
+          "releaseTag": "Public",
+          "name": "CSharpProjectSdk",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "Class",
           "canonicalReference": "@alloy-js/csharp!CSharpScope:class",
@@ -5795,6 +5787,154 @@
             }
           ]
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/csharp!CsprojFile:function(1)",
+          "docComment": "/**\n * Create a .csproj file\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function CsprojFile(props: "
+            },
+            {
+              "kind": "Reference",
+              "text": "CsprojProps",
+              "canonicalReference": "@alloy-js/csharp!CsprojProps:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Children",
+              "canonicalReference": "@alloy-js/core!Children:type"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/components/csproj-file/csproj-file.tsx",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "props",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "CsprojFile"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@alloy-js/csharp!CsprojProps:interface",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface CsprojProps "
+            }
+          ],
+          "fileUrlPath": "src/components/csproj-file/csproj-file.tsx",
+          "releaseTag": "Public",
+          "name": "CsprojProps",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!CsprojProps#children:member",
+              "docComment": "/**\n * Content inside <project>\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "children?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Children",
+                  "canonicalReference": "@alloy-js/core!Children:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "children",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!CsprojProps#path:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "path: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "`${string}.csproj`"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "path",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/csharp!CsprojProps#sdk:member",
+              "docComment": "/**\n * Project SDK https://learn.microsoft.com/en-us/dotnet/core/project-sdk/overview\n *\n * @default\n *\n *  \"Microsoft.NET.Sdk\"\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "sdk?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CSharpProjectSdk",
+                  "canonicalReference": "@alloy-js/csharp!CSharpProjectSdk:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "sdk",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/csharp!Declaration:function(1)",
@@ -13972,261 +14112,6 @@
           ],
           "extendsTokenRanges": []
         },
-        {
-          "kind": "Function",
-          "canonicalReference": "@alloy-js/csharp!ProjectDirectory:function(1)",
-          "docComment": "",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export declare function ProjectDirectory(props: "
-            },
-            {
-              "kind": "Reference",
-              "text": "ProjectDirectoryProps",
-              "canonicalReference": "@alloy-js/csharp!ProjectDirectoryProps:interface"
-            },
-            {
-              "kind": "Content",
-              "text": "): "
-            },
-            {
-              "kind": "Reference",
-              "text": "core.Children",
-              "canonicalReference": "@alloy-js/core!Children:type"
-            },
-            {
-              "kind": "Content",
-              "text": ";"
-            }
-          ],
-          "fileUrlPath": "src/components/ProjectDirectory.tsx",
-          "returnTypeTokenRange": {
-            "startIndex": 3,
-            "endIndex": 4
-          },
-          "releaseTag": "Public",
-          "overloadIndex": 1,
-          "parameters": [
-            {
-              "parameterName": "props",
-              "parameterTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isOptional": false
-            }
-          ],
-          "name": "ProjectDirectory"
-        },
-        {
-          "kind": "Interface",
-          "canonicalReference": "@alloy-js/csharp!ProjectDirectoryProps:interface",
-          "docComment": "",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export interface ProjectDirectoryProps "
-            }
-          ],
-          "fileUrlPath": "src/components/ProjectDirectory.tsx",
-          "releaseTag": "Public",
-          "name": "ProjectDirectoryProps",
-          "preserveMemberOrder": false,
-          "members": [
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/csharp!ProjectDirectoryProps#children:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "children?: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "core.Children",
-                  "canonicalReference": "@alloy-js/core!Children:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Public",
-              "name": "children",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/csharp!ProjectDirectoryProps#description:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "description: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "description",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/csharp!ProjectDirectoryProps#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
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/csharp!ProjectDirectoryProps#path:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "path: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "path",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/csharp!ProjectDirectoryProps#srcDir:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "srcDir?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Public",
-              "name": "srcDir",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/csharp!ProjectDirectoryProps#targetFrameworkMoniker:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "targetFrameworkMoniker?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Public",
-              "name": "targetFrameworkMoniker",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/csharp!ProjectDirectoryProps#version:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "version: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "version",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            }
-          ],
-          "extendsTokenRanges": []
-        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/csharp!Property:function(1)",

package/tsdoc.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",
+  "extends": ["../../tsdoc.base.json"]
+}

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

@@ -1,12 +0,0 @@
-import * as core from "@alloy-js/core";
-export interface ProjectDirectoryProps {
-    name: string;
-    version: string;
-    description: string;
-    path: string;
-    srcDir?: string;
-    targetFrameworkMoniker?: string;
-    children?: core.Children;
-}
-export declare function ProjectDirectory(props: ProjectDirectoryProps): core.Children;
-//# sourceMappingURL=ProjectDirectory.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ProjectDirectory.d.ts","sourceRoot":"","sources":["../../../src/components/ProjectDirectory.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAIvC,MAAM,WAAW,qBAAqB;IAEpC,IAAI,EAAE,MAAM,CAAC;IAGb,OAAO,EAAE,MAAM,CAAC;IAGhB,WAAW,EAAE,MAAM,CAAC;IAGpB,IAAI,EAAE,MAAM,CAAC;IAGb,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAGhC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;CAC1B;AAGD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,iBA2B5D"}

package/dist/src/components/ProjectDirectory.js

@@ -1,47 +0,0 @@
-import { memo as _$memo, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
-import * as core from "@alloy-js/core";
-import { join } from "pathe";
-
-// properties for creating the project directory
-
-// the top-level C# project directory. includes a csproj file
-export function ProjectDirectory(props) {
-  if (!props.srcDir) {
-    props.srcDir = "src";
-  }
-  if (!props.targetFrameworkMoniker) {
-    props.targetFrameworkMoniker = "net8.0";
-  }
-  return _$createComponent(core.SourceDirectory, {
-    get path() {
-      return join(props.path, props.name);
-    },
-    get children() {
-      return [_$createComponent(core.SourceFile, {
-        get path() {
-          return props.name + ".csproj";
-        },
-        filetype: "xml",
-        get children() {
-          return core.code`
-        <Project Sdk="Microsoft.NET.Sdk">
-          <PropertyGroup>
-            <Version>${props.version}</Version>
-            <Description>${props.description}</Description>
-            <TargetFramework>${props.targetFrameworkMoniker}</TargetFramework>
-          </PropertyGroup>
-        </Project>
-      `;
-        }
-      }), _$createComponent(core.SourceDirectory, {
-        get path() {
-          return props.srcDir;
-        },
-        get children() {
-          return props.children;
-        }
-      })];
-    }
-  });
-}
-//# sourceMappingURL=ProjectDirectory.js.map

package/dist/src/components/ProjectDirectory.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["core","join","ProjectDirectory","props","srcDir","targetFrameworkMoniker","_$createComponent","SourceDirectory","path","name","children","SourceFile","filetype","code","version","description"],"sources":["../../../src/components/ProjectDirectory.tsx"],"sourcesContent":[null],"mappings":";AAAA,OAAO,KAAKA,IAAI,MAAM,gBAAgB;AACtC,SAASC,IAAI,QAAQ,OAAO;;AAE5B;;AAwBA;AACA,OAAO,SAASC,gBAAgBA,CAACC,KAA4B,EAAE;EAC7D,IAAI,CAACA,KAAK,CAACC,MAAM,EAAE;IACjBD,KAAK,CAACC,MAAM,GAAG,KAAK;EACtB;EAEA,IAAI,CAACD,KAAK,CAACE,sBAAsB,EAAE;IACjCF,KAAK,CAACE,sBAAsB,GAAG,QAAQ;EACzC;EAEA,OAAAC,iBAAA,CACGN,IAAI,CAACO,eAAe;IAAA,IAACC,IAAIA,CAAA;MAAA,OAAEP,IAAI,CAACE,KAAK,CAACK,IAAI,EAAEL,KAAK,CAACM,IAAI,CAAC;IAAA;IAAA,IAAAC,SAAA;MAAA,QAAAJ,iBAAA,CACrDN,IAAI,CAACW,UAAU;QAAA,IAACH,IAAIA,CAAA;UAAA,OAAEL,KAAK,CAACM,IAAI,GAAG,SAAS;QAAA;QAAEG,QAAQ;QAAA,IAAAF,SAAA;UAAA,OACpDV,IAAI,CAACa,IAAI;AAClB;AACA;AACA,uBAAuBV,KAAK,CAACW,OAAO;AACpC,2BAA2BX,KAAK,CAACY,WAAW;AAC5C,+BAA+BZ,KAAK,CAACE,sBAAsB;AAC3D;AACA;AACA,OAAO;QAAA;MAAA,IAAAC,iBAAA,CAEAN,IAAI,CAACO,eAAe;QAAA,IAACC,IAAIA,CAAA;UAAA,OAAEL,KAAK,CAACC,MAAM;QAAA;QAAA,IAAAM,SAAA;UAAA,OACrCP,KAAK,CAACO,QAAQ;QAAA;MAAA;IAAA;EAAA;AAIvB","ignoreList":[]}

package/dist/test/project-directory.test.d.ts

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

package/dist/test/project-directory.test.d.ts.map

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