Add description to module name property for improved IntelliSense (#19310)

## Summary

This PR adds a human-readable description to the `name` property on
module/test declarations so that IntelliSense (hover info, completions)
surfaces helpful guidance about the deployment name constraints.

## Changes

In `src/Bicep.Core/LanguageConstants.cs`:
- Added a `nameDescription` string ("The deployment name. Must be 1-64
characters, and can contain alphanumerics, underscores, parentheses,
hyphens, and periods.") and passed it to the `NamedTypeProperty`
constructor for the module name property in both `CreateModuleType` and
the test/extension common properties.

This ensures that when users hover over or complete the `name` property
in a module or test block, they see the allowed pattern and length
constraints directly in the editor.

###### Microsoft Reviewers: [Open in
CodeFlow](https://microsoft.github.io/open-pr/?codeflow=https://github.com/Azure/bicep/pull/19310)
Co-authored-by: brendandburns <5751682+brendandburns@users.noreply.github.com>

Author: brendandburns

src/Bicep.Core.Samples/Files/baselines/InvalidModules_LF/Completions/moduleATopLevelProperties.json

@@ -41,7 +41,7 @@
     "detail": "name",
     "documentation": {
       "kind": "markdown",
-      "value": "Type: `string`  \n"
+      "value": "Type: `string`  \nThe deployment name. Must be 1-64 characters, and can contain alphanumerics, underscores, parentheses, hyphens, and periods.  \n"
     },
     "deprecated": false,
     "preselect": false,

src/Bicep.Core.Samples/Files/baselines/InvalidModules_LF/Completions/moduleATopLevelPropertyAccess.json

@@ -26,7 +26,7 @@
     "detail": "name",
     "documentation": {
       "kind": "markdown",
-      "value": "Type: `string`  \n"
+      "value": "Type: `string`  \nThe deployment name. Must be 1-64 characters, and can contain alphanumerics, underscores, parentheses, hyphens, and periods.  \n"
     },
     "deprecated": false,
     "preselect": false,

src/Bicep.Core.Samples/Files/baselines/InvalidModules_LF/Completions/moduleAWithConditionTopLevelProperties.json

@@ -41,7 +41,7 @@
     "detail": "name",
     "documentation": {
       "kind": "markdown",
-      "value": "Type: `string`  \n"
+      "value": "Type: `string`  \nThe deployment name. Must be 1-64 characters, and can contain alphanumerics, underscores, parentheses, hyphens, and periods.  \n"
     },
     "deprecated": false,
     "preselect": false,

src/Bicep.Core.Samples/Files/baselines/InvalidModules_LF/Completions/moduleAWithConditionTopLevelPropertyAccess.json

@@ -26,7 +26,7 @@
     "detail": "name",
     "documentation": {
       "kind": "markdown",
-      "value": "Type: `string`  \n"
+      "value": "Type: `string`  \nThe deployment name. Must be 1-64 characters, and can contain alphanumerics, underscores, parentheses, hyphens, and periods.  \n"
     },
     "deprecated": false,
     "preselect": false,

src/Bicep.Core/LanguageConstants.cs

@@ -377,10 +377,11 @@ public static TypeSymbol CreateModuleType(IFeatureProvider features, IEnumerable
             var nameRequirednessFlags = TypePropertyFlags.None;
             // Taken from the official REST specs for Microsoft.Resources/deployments
             var nameType = TypeFactory.CreateStringType(minLength: 1, maxLength: 64, pattern: @"^[-\w._()]+$");
+            var nameDescription = "The deployment name. Must be 1-64 characters, and can contain alphanumerics, underscores, parentheses, hyphens, and periods.";
 
             List<NamedTypeProperty> moduleProperties =
             [
-                new(ModuleNamePropertyName, nameType, nameRequirednessFlags | TypePropertyFlags.DeployTimeConstant | TypePropertyFlags.ReadableAtDeployTime | TypePropertyFlags.LoopVariant),
+                new(ModuleNamePropertyName, nameType, nameRequirednessFlags | TypePropertyFlags.DeployTimeConstant | TypePropertyFlags.ReadableAtDeployTime | TypePropertyFlags.LoopVariant, nameDescription),
                 new(ResourceScopePropertyName, CreateResourceScopeReference(moduleScope), scopePropertyFlags),
                 new(ModuleParamsPropertyName, paramsType, paramsRequiredFlag | TypePropertyFlags.WriteOnly),
                 new(ModuleOutputsPropertyName, outputsType, TypePropertyFlags.ReadOnly),
@@ -407,9 +408,11 @@ public static TypeSymbol CreateUsingConfigType()
             var optionalPropFlags = TypePropertyFlags.WriteOnly | TypePropertyFlags.DeployTimeConstant | TypePropertyFlags.ReadableAtDeployTime | TypePropertyFlags.DisallowAny;
             var requiredPropFlags = optionalPropFlags | TypePropertyFlags.Required;
 
+            var nameDescription = "The deployment name. Must be 1-64 characters, and can contain alphanumerics, underscores, parentheses, hyphens, and periods.";
+
             NamedTypeProperty[] commonProps = [
                 // Taken from the official REST specs for Microsoft.Resources/deployments
-                new(ModuleNamePropertyName, TypeFactory.CreateStringType(minLength: 1, maxLength: 64, pattern: @"^[-\w._()]+$"), optionalPropFlags),
+                new(ModuleNamePropertyName, TypeFactory.CreateStringType(minLength: 1, maxLength: 64, pattern: @"^[-\w._()]+$"), optionalPropFlags, nameDescription),
                 // TODO model this properly as a scope, rather than a string
                 new(ResourceScopePropertyName, LanguageConstants.String, requiredPropFlags),
             ];