@alloy-js/csharp 0.23.0-dev.10 → 0.23.0-dev.11

package/src/name-policy.ts

@@ -1,5 +1,7 @@
 import * as core from "@alloy-js/core";
 import * as changecase from "change-case";
+import { sanitizeCSharpIdentifier } from "./identifier-utils.js";
+import { isCSharpKeyword } from "./keywords.js";
 
 // the context in which the name policy should be applied
 export type CSharpElements =
@@ -20,10 +22,27 @@ export type CSharpElements =
   | "type-parameter"
   | "namespace";
 
-// creates the C# naming policy
+/**
+ * Prefixes the name with `@` if it is a C# keyword.
+ * This is the idiomatic C# way to use reserved words as identifiers.
+ * The check is case-sensitive, matching C# language semantics.
+ */
+function escapeIfKeyword(name: string): string {
+  return isCSharpKeyword(name) ? `@${name}` : name;
+}
+
+/**
+ * Creates the C# naming policy with case conversion and keyword escaping.
+ *
+ * After applying the appropriate case conversion for each element kind,
+ * the resulting name is checked against C# reserved and contextual keywords.
+ * If it matches (case-sensitively), the name is prefixed with `@`.
+ */
 export function createCSharpNamePolicy(): core.NamePolicy<CSharpElements> {
   return core.createNamePolicy((name, element) => {
+    let result: string;
     switch (element) {
+      case "namespace":
       case "class":
       case "struct":
       case "enum":
@@ -34,15 +53,20 @@ export function createCSharpNamePolicy(): core.NamePolicy<CSharpElements> {
       case "class-method":
       case "type-parameter":
       case "class-property":
-      case "namespace":
-        return changecase.pascalCase(name);
+        result = changecase.pascalCase(name);
+        break;
       case "constant":
-        return changecase.constantCase(name);
+        result = changecase.constantCase(name);
+        break;
       case "class-member-private":
-        return `_${changecase.camelCase(name)}`;
+        result = `_${changecase.camelCase(name)}`;
+        break;
       default:
-        return changecase.camelCase(name);
+        result = changecase.camelCase(name);
+        break;
     }
+
+    return escapeIfKeyword(sanitizeCSharpIdentifier(result));
   });
 }
 

package/temp/api.json

@@ -2560,7 +2560,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/csharp!createCSharpNamePolicy:function(1)",
-          "docComment": "",
+          "docComment": "/**\n * Creates the C# naming policy with case conversion and keyword escaping.\n *\n * After applying the appropriate case conversion for each element kind,\n * the resulting name is checked against C# reserved and contextual keywords.\n * If it matches (case-sensitively), the name is prefixed with `@`.\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -3624,6 +3624,34 @@
           },
           "implementsTokenRanges": []
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@alloy-js/csharp!csharpContextualKeywords:var",
+          "docComment": "/**\n * C# contextual keywords that are reserved in certain contexts.\n * While not always reserved, treating them as keywords in generated code\n * avoids subtle context-dependent issues.\n *\n * @see\n *\n *  https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/#contextual-keywords\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "csharpContextualKeywords: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ReadonlySet",
+              "canonicalReference": "!ReadonlySet:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<string>"
+            }
+          ],
+          "fileUrlPath": "src/keywords.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "csharpContextualKeywords",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 3
+          }
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@alloy-js/csharp!CSharpElements:type",
@@ -3731,6 +3759,34 @@
             "endIndex": 8
           }
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@alloy-js/csharp!csharpKeywords:var",
+          "docComment": "/**\n * C# reserved keywords that cannot be used as identifiers without `@` prefix.\n * These are case-sensitive in C#.\n *\n * @see\n *\n *  https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "csharpKeywords: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ReadonlySet",
+              "canonicalReference": "!ReadonlySet:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<string>"
+            }
+          ],
+          "fileUrlPath": "src/keywords.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "csharpKeywords",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 3
+          }
+        },
         {
           "kind": "Class",
           "canonicalReference": "@alloy-js/csharp!CSharpLexicalScope:class",
@@ -10556,6 +10612,141 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/csharp!isCSharpContextualKeyword:function(1)",
+          "docComment": "/**\n * Returns true if the given name is a C# contextual keyword.\n * Contextual keywords are only reserved in specific language contexts\n * and are generally valid as identifiers.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function isCSharpContextualKeyword(name: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/keywords.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "name",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "isCSharpContextualKeyword"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/csharp!isCSharpKeyword:function(1)",
+          "docComment": "/**\n * Returns true if the given name is a C# reserved keyword.\n * The check is case-sensitive, matching C# language semantics.\n *\n * Note: this only checks reserved keywords, not contextual keywords.\n * Contextual keywords are only reserved in specific language contexts\n * and are valid identifiers elsewhere (e.g., `value` is valid as a parameter name).\n * Use {@link isCSharpContextualKeyword} to check contextual keywords separately.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function isCSharpKeyword(name: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/keywords.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "name",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "isCSharpKeyword"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/csharp!isValidCSharpIdentifier:function(1)",
+          "docComment": "/**\n * Checks whether the provided name is a valid C# identifier (without `@` prefix).\n * Does not account for keyword conflicts — use {@link isCSharpKeyword} for that.\n *\n * @param name - The name to validate.\n *\n * @returns  true if the name matches C# identifier rules (letter or underscore start, word chars after).\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function isValidCSharpIdentifier(name: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/identifier-utils.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "name",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "isValidCSharpIdentifier"
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@alloy-js/csharp!LeixcalScopePropsWithScopeInfo:interface",
@@ -15613,6 +15804,51 @@
             "endIndex": 9
           }
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/csharp!sanitizeCSharpIdentifier:function(1)",
+          "docComment": "/**\n * Transforms an arbitrary string into a valid C# identifier by replacing\n * invalid characters. The result may still be a C# keyword — callers\n * should combine with keyword escaping if needed.\n *\n * - If the first character is not a letter or underscore, a `_` prefix is added.\n * - Subsequent non-word characters are replaced with `_`.\n * - Empty strings become `_`.\n *\n * @param name - The string to sanitize.\n *\n * @returns  A string that satisfies C# identifier character rules.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function sanitizeCSharpIdentifier(name: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/identifier-utils.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "name",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "sanitizeCSharpIdentifier"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/csharp!SourceFile:function(1)",