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

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",
@@ -14622,7 +14813,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/csharp!PropertyProps#get:member",
-              "docComment": "/**\n * If property should have a getter\n */\n",
+              "docComment": "/**\n * If property should have a getter. Pass `true` for an auto-property getter (`get;`),\n * or pass children for a getter with a body.\n *\n * @example\n *\n *  auto-property\n * ```tsx\n * <Property name=\"Name\" type=\"string\" get set />\n * ```\n *\n * Produces: `string Name { get; set; }`\n *\n * @example\n *\n *  with body\n * ```tsx\n * <Property name=\"Name\" type=\"string\" get={<>return _name;</>} set />\n * ```\n *\n * Produces:\n * ```csharp\n * string Name\n * {\n *     get { return _name; }\n *     set;\n * }\n * ```\n *\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -14630,7 +14821,12 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "boolean"
+                  "text": "boolean | "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Children",
+                  "canonicalReference": "@alloy-js/core!Children:type"
                 },
                 {
                   "kind": "Content",
@@ -14643,7 +14839,7 @@
               "name": "get",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 3
               }
             },
             {
@@ -14791,7 +14987,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/csharp!PropertyProps#set:member",
-              "docComment": "/**\n * If property should have a setter\n */\n",
+              "docComment": "/**\n * If property should have a setter. Pass `true` for an auto-property setter (`set;`),\n * or pass children for a setter with a body.\n *\n * @example\n *\n *  with body\n * ```tsx\n * <Property name=\"Value\" type=\"int\" get set={<>_value = value;</>} />\n * ```\n *\n * Produces:\n * ```csharp\n * int Value\n * {\n *     get;\n *     set { _value = value; }\n * }\n * ```\n *\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -14799,7 +14995,12 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "boolean"
+                  "text": "boolean | "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Children",
+                  "canonicalReference": "@alloy-js/core!Children:type"
                 },
                 {
                   "kind": "Content",
@@ -14812,7 +15013,7 @@
               "name": "set",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 3
               }
             },
             {
@@ -15603,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)",