@azure-typespec/http-client-csharp-mgmt 1.0.0-alpha.20260601.1 → 1.0.0-alpha.20260604.1

package/dist/generator/Azure.Generator.Management.deps.json

@@ -6,7 +6,7 @@
   "compilationOptions": {},
   "targets": {
     ".NETCoreApp,Version=v10.0": {
-      "Azure.Generator.Management/1.0.0-alpha.20260601.1": {
+      "Azure.Generator.Management/1.0.0-alpha.20260604.1": {
         "dependencies": {
           "Azure.Core": "1.57.0",
           "Azure.Generator": "1.0.0-alpha.20260516.2",
@@ -729,7 +729,7 @@
     }
   },
   "libraries": {
-    "Azure.Generator.Management/1.0.0-alpha.20260601.1": {
+    "Azure.Generator.Management/1.0.0-alpha.20260604.1": {
       "type": "project",
       "serviceable": false,
       "sha512": ""

package/dist/generator/Azure.Generator.Management.xml

@@ -800,21 +800,9 @@
             This uses a simpler TypeProvider-based implementation without inheriting from CollectionResultDefinition.
             </summary>
         </member>
-        <member name="P:Azure.Generator.Management.Providers.InheritableSystemObjectModelProvider.IsSystemBase">
+        <member name="T:Azure.Generator.Management.Providers.ManagementModelProvider">
             <summary>
-            True when this provider represents the system base type itself (e.g., TrackedResourceData).
-            False when it represents a derived model whose base type is a system type.
-            </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Providers.InheritableSystemObjectModelProvider.CreateSystemBase(System.Type,Microsoft.TypeSpec.Generator.Input.InputModelType)">
-            <summary>
-            Creates a provider representing the system base type itself (e.g., TrackedResource → TrackedResourceData).
-            </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Providers.InheritableSystemObjectModelProvider.CreateDerived(Microsoft.TypeSpec.Generator.Input.InputModelType,Microsoft.TypeSpec.Generator.Primitives.CSharpType)">
-            <summary>
-            Creates a provider for a model that extends an inheritable system type.
-            Overrides BuildBaseType() to return the correct framework CSharpType.
+            ModelProvider used for non-resource management-plane models.
             </summary>
         </member>
         <member name="M:Azure.Generator.Management.Providers.MockableArmClientProvider.TryCreate(System.Collections.Generic.IReadOnlyList{Azure.Generator.Management.Providers.ResourceClientProvider},System.Collections.Generic.IReadOnlyList{Azure.Generator.Management.Models.NonResourceMethod})">
@@ -901,6 +889,23 @@
             <returns></returns>
             <exception cref="T:System.NotSupportedException"></exception>
         </member>
+        <member name="T:Azure.Generator.Management.Providers.ResourceDataModelProvider">
+            <summary>
+            ModelProvider used for Azure resource data classes.
+            </summary>
+            <remarks>
+            Overrides identity-shaping members (<see cref="M:Azure.Generator.Management.Providers.ResourceDataModelProvider.BuildName"/>, <see cref="M:Azure.Generator.Management.Providers.ResourceDataModelProvider.BuildNamespace"/>,
+            <see cref="M:Azure.Generator.Management.Providers.ResourceDataModelProvider.BuildRelativeFilePath"/>) so that resource data classes are constructed with the
+            final name, namespace, and file path from the very first <c>Type</c> access.
+            <para>
+            In particular, overriding <see cref="M:Azure.Generator.Management.Providers.ResourceDataModelProvider.BuildName"/> to append <c>"Data"</c> is the only way to
+            prevent a user's resource-client customization partial (e.g.
+            <c>partial class FooResource : ArmResource</c>) from polluting <c>CustomCodeView.BaseType</c>:
+            once <c>Type</c> is constructed, the base type is captured into the immutable
+            <c>CSharpType._baseType</c>, and no subsequent visitor-driven rename can rewrite it.
+            </para>
+            </remarks>
+        </member>
         <member name="M:Azure.Generator.Management.Providers.ResourceSerializationProvider.GetInstantiableDataType">
             <summary>
             Gets the concrete type to use for instantiating the DataDeserializationInstance.
@@ -945,6 +950,34 @@
             <param name="id"></param>
             <returns></returns>
         </member>
+        <member name="T:Azure.Generator.Management.Snippets.JsonResponseDeserialization">
+            <summary>
+            Builds AOT-safe inline JSON deserialization for framework collection response types
+            (e.g. <c>IDictionary&lt;string, BinaryData&gt;</c> produced from a TypeSpec <c>Record&lt;unknown&gt;</c>).
+            These types do not implement <see cref="T:System.ClientModel.Primitives.IPersistableModel`1"/>, so
+            <c>ModelReaderWriter.Read&lt;T&gt;</c> cannot be used; instead the JSON payload is parsed and the
+            collection is constructed with explicit <c>foreach</c> loops.
+            </summary>
+        </member>
+        <member name="M:Azure.Generator.Management.Snippets.JsonResponseDeserialization.IsInlineJsonDeserializable(Microsoft.TypeSpec.Generator.Primitives.CSharpType)">
+            <summary>
+            Returns <c>true</c> when <paramref name="type"/> is a framework collection (dictionary or list)
+            that must be deserialized with inline JSON rather than <c>ModelReaderWriter.Read&lt;T&gt;</c>.
+            </summary>
+        </member>
+        <member name="M:Azure.Generator.Management.Snippets.JsonResponseDeserialization.BuildDeserializeFromContent(Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Expressions.ValueExpression,System.String,Microsoft.TypeSpec.Generator.Expressions.ValueExpression@)">
+            <summary>
+            Builds statements that parse <paramref name="content"/> (a <see cref="T:System.BinaryData"/> such as
+            <c>result.Content</c>) into a value of <paramref name="type"/>, exposing the result via
+            <paramref name="valueVariable"/>.
+            </summary>
+        </member>
+        <member name="M:Azure.Generator.Management.Snippets.JsonResponseDeserialization.BuildDeserializeFromRootElement(Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Expressions.ValueExpression,System.String,Microsoft.TypeSpec.Generator.Expressions.ValueExpression@)">
+            <summary>
+            Builds statements that deserialize <paramref name="rootElement"/> (a <see cref="T:System.Text.Json.JsonElement"/>)
+            into a value of <paramref name="type"/>, guarding against a top-level JSON <c>null</c> body.
+            </summary>
+        </member>
         <member name="M:Azure.Generator.Management.Utilities.ArmResourceMetadataExtensions.CreateClientInfosMap(Azure.Generator.Management.Models.ArmResourceMetadata,Microsoft.TypeSpec.Generator.Providers.TypeProvider,System.Collections.Generic.IEnumerable{Azure.Generator.Management.Models.ResourceMethod})">
             <inheritdoc cref="M:Azure.Generator.Management.Utilities.ArmResourceMetadataExtensions.&lt;G&gt;$3BBD617C8A31A7C0E10A06384A9D1FA5.CreateClientInfosMap(Microsoft.TypeSpec.Generator.Providers.TypeProvider,System.Collections.Generic.IEnumerable{Azure.Generator.Management.Models.ResourceMethod})"/>
         </member>
@@ -1144,48 +1177,12 @@
             <param name="targetInternalProperty">The internal property to look for in the chain</param>
             <returns>True if the internal property is in the flattening chain</returns>
         </member>
-        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.FixSerializationReturnTypes(Microsoft.TypeSpec.Generator.Providers.ModelProvider)">
-             <summary>
-             Fixes the return type of serialization override methods (PersistableModelCreateCore,
-             JsonModelCreateCore) to use the system base type (e.g., ResourceData) instead of the
-             immediate parent type. Without this, the framework generates overrides with
-             model.Type.BaseType as the return type, which can produce a covariant return type
-             (e.g., returning CustomPatchBase instead of ResourceData). Covariant returns are not
-             supported on .NET Framework.
-            
-             Also fixes the explicit interface implementations (IJsonModel&lt;T&gt;.Create,
-             IPersistableModel&lt;T&gt;.Create) that call these methods, adding a cast to the
-             model type when the return type was changed. Without this cast, the implicit
-             conversion from ResourceData to the model type would fail to compile.
-             </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.FixExplicitInterfaceCreateMethods(Microsoft.TypeSpec.Generator.ClientModel.Providers.MrwSerializationTypeDefinition)">
-            <summary>
-            Ensures the explicit interface Create methods (IJsonModel&lt;T&gt;.Create,
-            IPersistableModel&lt;T&gt;.Create) cast the result of *Core to the method's declared
-            return type T (the discriminated base, e.g., PolyDeviceData). MTG may emit no cast
-            or an incorrect cast to the containing class (e.g., (UnknownPolyDevice)); the latter
-            throws InvalidCastException at runtime when the discriminator dispatch returns a
-            different concrete subtype.
-            </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.FindSystemBaseType(Microsoft.TypeSpec.Generator.Providers.ModelProvider)">
+        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.EnsureFrameworkTypeRegistered(Microsoft.TypeSpec.Generator.Providers.SystemObjectModelProvider)">
             <summary>
-            Walks up the model hierarchy to find the system base type (e.g., ResourceData)
-            that the virtual serialization methods use as their return type.
-            </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.RemoveDuplicatePropertiesAndStripVirtual(Microsoft.TypeSpec.Generator.Providers.ModelProvider,Microsoft.TypeSpec.Generator.Providers.ModelProvider,System.Collections.Generic.HashSet{System.String})">
-            <summary>
-            Removes properties with 'new' modifier or matching base property names from the model,
-            and strips orphaned virtual modifiers from corresponding base properties.
-            </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.StripOrphanedVirtualModifiers(Microsoft.TypeSpec.Generator.Providers.ModelProvider,System.Collections.Generic.HashSet{System.String})">
-            <summary>
-            Strips the virtual modifier from base model properties whose names match removed derived properties.
-            When derived properties with new/override modifiers are removed, the corresponding base virtual
-            modifier becomes orphaned and should be removed.
+            Registers the framework CSharpType (from KnownManagementTypes) as an alias in the CSharpTypeMap.
+            This allows BuildBaseModelProvider() to find SystemObjectModelProvider when custom code
+            uses a Roslyn-resolved framework CSharpType (which differs from the non-framework CSharpType
+            created by SystemObjectModelProvider).
             </summary>
         </member>
         <member name="T:Azure.Generator.Management.Visitors.ManagedIdentityV3Visitor">
@@ -1197,7 +1194,7 @@
         </member>
         <member name="T:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper">
             <summary>
-            Repairs hidden model factory compatibility overloads after flattening changes the current model factory shape.
+            Repairs model factory constructor calls after visitors change the current model shape.
             Used from <see cref="M:Azure.Generator.Management.ManagementClientGenerator.GetWriter(Microsoft.TypeSpec.Generator.Providers.TypeProvider)"/> because some compatibility overloads are
             synthesized from LastContractView after normal visitors have finished.
             </summary>
@@ -1271,7 +1268,7 @@
             Used by <see cref="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.TryBuildCompatibilityArgument(Microsoft.TypeSpec.Generator.Providers.MethodProvider,Microsoft.TypeSpec.Generator.Providers.ParameterProvider,System.Collections.Generic.IReadOnlySet{System.String},Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.CompatibilityArgument@)"/> while reconstructing flattened nested model instances.
             </summary>
         </member>
-        <member name="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.TryGetMethodParameter(Microsoft.TypeSpec.Generator.Providers.MethodProvider,System.String,Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Providers.ParameterProvider@)">
+        <member name="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.TryGetMethodParameter(Microsoft.TypeSpec.Generator.Providers.MethodProvider,System.String,Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Providers.PropertyProvider,Microsoft.TypeSpec.Generator.Providers.ParameterProvider@)">
             <summary>
             Finds an old overload parameter by name and compatible type.
             Inputs are the old method, expected parameter name, and expected type; output is the matching parameter.
@@ -1282,7 +1279,7 @@
             <summary>
             Determines whether an old parameter can be used for a current constructor parameter.
             Inputs are old and expected types; output is whether direct assignment or helper conversion can make them compatible.
-            Used by <see cref="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.TryGetMethodParameter(Microsoft.TypeSpec.Generator.Providers.MethodProvider,System.String,Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Providers.ParameterProvider@)"/> to allow nullable/value and list-interface shape differences.
+            Used by <see cref="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.TryGetMethodParameter(Microsoft.TypeSpec.Generator.Providers.MethodProvider,System.String,Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Providers.PropertyProvider,Microsoft.TypeSpec.Generator.Providers.ParameterProvider@)"/> to allow nullable/value and list-interface shape differences.
             </summary>
         </member>
         <member name="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.AreCompatibleListTypes(Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Primitives.CSharpType)">
@@ -1338,6 +1335,9 @@
         <member name="M:Azure.Generator.Management.Visitors.RestClientVisitor.VisitType(Microsoft.TypeSpec.Generator.Providers.TypeProvider)">
             <inheritdoc/>
         </member>
+        <member name="M:Azure.Generator.Management.Visitors.SerializationVisitor.VisitType(Microsoft.TypeSpec.Generator.Providers.TypeProvider)">
+            <inheritdoc/>
+        </member>
         <member name="M:Azure.Generator.Management.Visitors.SerializationVisitor.VisitMethod(Microsoft.TypeSpec.Generator.Providers.MethodProvider)">
             <inheritdoc/>
         </member>

package/dist/generator/net10.0/Azure.Generator.Management.deps.json

@@ -6,7 +6,7 @@
   "compilationOptions": {},
   "targets": {
     ".NETCoreApp,Version=v10.0": {
-      "Azure.Generator.Management/1.0.0-alpha.20260601.1": {
+      "Azure.Generator.Management/1.0.0-alpha.20260604.1": {
         "dependencies": {
           "Azure.Core": "1.57.0",
           "Azure.Generator": "1.0.0-alpha.20260516.2",
@@ -729,7 +729,7 @@
     }
   },
   "libraries": {
-    "Azure.Generator.Management/1.0.0-alpha.20260601.1": {
+    "Azure.Generator.Management/1.0.0-alpha.20260604.1": {
       "type": "project",
       "serviceable": false,
       "sha512": ""

package/dist/generator/net10.0/Azure.Generator.Management.xml

@@ -800,21 +800,9 @@
             This uses a simpler TypeProvider-based implementation without inheriting from CollectionResultDefinition.
             </summary>
         </member>
-        <member name="P:Azure.Generator.Management.Providers.InheritableSystemObjectModelProvider.IsSystemBase">
+        <member name="T:Azure.Generator.Management.Providers.ManagementModelProvider">
             <summary>
-            True when this provider represents the system base type itself (e.g., TrackedResourceData).
-            False when it represents a derived model whose base type is a system type.
-            </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Providers.InheritableSystemObjectModelProvider.CreateSystemBase(System.Type,Microsoft.TypeSpec.Generator.Input.InputModelType)">
-            <summary>
-            Creates a provider representing the system base type itself (e.g., TrackedResource → TrackedResourceData).
-            </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Providers.InheritableSystemObjectModelProvider.CreateDerived(Microsoft.TypeSpec.Generator.Input.InputModelType,Microsoft.TypeSpec.Generator.Primitives.CSharpType)">
-            <summary>
-            Creates a provider for a model that extends an inheritable system type.
-            Overrides BuildBaseType() to return the correct framework CSharpType.
+            ModelProvider used for non-resource management-plane models.
             </summary>
         </member>
         <member name="M:Azure.Generator.Management.Providers.MockableArmClientProvider.TryCreate(System.Collections.Generic.IReadOnlyList{Azure.Generator.Management.Providers.ResourceClientProvider},System.Collections.Generic.IReadOnlyList{Azure.Generator.Management.Models.NonResourceMethod})">
@@ -901,6 +889,23 @@
             <returns></returns>
             <exception cref="T:System.NotSupportedException"></exception>
         </member>
+        <member name="T:Azure.Generator.Management.Providers.ResourceDataModelProvider">
+            <summary>
+            ModelProvider used for Azure resource data classes.
+            </summary>
+            <remarks>
+            Overrides identity-shaping members (<see cref="M:Azure.Generator.Management.Providers.ResourceDataModelProvider.BuildName"/>, <see cref="M:Azure.Generator.Management.Providers.ResourceDataModelProvider.BuildNamespace"/>,
+            <see cref="M:Azure.Generator.Management.Providers.ResourceDataModelProvider.BuildRelativeFilePath"/>) so that resource data classes are constructed with the
+            final name, namespace, and file path from the very first <c>Type</c> access.
+            <para>
+            In particular, overriding <see cref="M:Azure.Generator.Management.Providers.ResourceDataModelProvider.BuildName"/> to append <c>"Data"</c> is the only way to
+            prevent a user's resource-client customization partial (e.g.
+            <c>partial class FooResource : ArmResource</c>) from polluting <c>CustomCodeView.BaseType</c>:
+            once <c>Type</c> is constructed, the base type is captured into the immutable
+            <c>CSharpType._baseType</c>, and no subsequent visitor-driven rename can rewrite it.
+            </para>
+            </remarks>
+        </member>
         <member name="M:Azure.Generator.Management.Providers.ResourceSerializationProvider.GetInstantiableDataType">
             <summary>
             Gets the concrete type to use for instantiating the DataDeserializationInstance.
@@ -945,6 +950,34 @@
             <param name="id"></param>
             <returns></returns>
         </member>
+        <member name="T:Azure.Generator.Management.Snippets.JsonResponseDeserialization">
+            <summary>
+            Builds AOT-safe inline JSON deserialization for framework collection response types
+            (e.g. <c>IDictionary&lt;string, BinaryData&gt;</c> produced from a TypeSpec <c>Record&lt;unknown&gt;</c>).
+            These types do not implement <see cref="T:System.ClientModel.Primitives.IPersistableModel`1"/>, so
+            <c>ModelReaderWriter.Read&lt;T&gt;</c> cannot be used; instead the JSON payload is parsed and the
+            collection is constructed with explicit <c>foreach</c> loops.
+            </summary>
+        </member>
+        <member name="M:Azure.Generator.Management.Snippets.JsonResponseDeserialization.IsInlineJsonDeserializable(Microsoft.TypeSpec.Generator.Primitives.CSharpType)">
+            <summary>
+            Returns <c>true</c> when <paramref name="type"/> is a framework collection (dictionary or list)
+            that must be deserialized with inline JSON rather than <c>ModelReaderWriter.Read&lt;T&gt;</c>.
+            </summary>
+        </member>
+        <member name="M:Azure.Generator.Management.Snippets.JsonResponseDeserialization.BuildDeserializeFromContent(Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Expressions.ValueExpression,System.String,Microsoft.TypeSpec.Generator.Expressions.ValueExpression@)">
+            <summary>
+            Builds statements that parse <paramref name="content"/> (a <see cref="T:System.BinaryData"/> such as
+            <c>result.Content</c>) into a value of <paramref name="type"/>, exposing the result via
+            <paramref name="valueVariable"/>.
+            </summary>
+        </member>
+        <member name="M:Azure.Generator.Management.Snippets.JsonResponseDeserialization.BuildDeserializeFromRootElement(Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Expressions.ValueExpression,System.String,Microsoft.TypeSpec.Generator.Expressions.ValueExpression@)">
+            <summary>
+            Builds statements that deserialize <paramref name="rootElement"/> (a <see cref="T:System.Text.Json.JsonElement"/>)
+            into a value of <paramref name="type"/>, guarding against a top-level JSON <c>null</c> body.
+            </summary>
+        </member>
         <member name="M:Azure.Generator.Management.Utilities.ArmResourceMetadataExtensions.CreateClientInfosMap(Azure.Generator.Management.Models.ArmResourceMetadata,Microsoft.TypeSpec.Generator.Providers.TypeProvider,System.Collections.Generic.IEnumerable{Azure.Generator.Management.Models.ResourceMethod})">
             <inheritdoc cref="M:Azure.Generator.Management.Utilities.ArmResourceMetadataExtensions.&lt;G&gt;$3BBD617C8A31A7C0E10A06384A9D1FA5.CreateClientInfosMap(Microsoft.TypeSpec.Generator.Providers.TypeProvider,System.Collections.Generic.IEnumerable{Azure.Generator.Management.Models.ResourceMethod})"/>
         </member>
@@ -1144,48 +1177,12 @@
             <param name="targetInternalProperty">The internal property to look for in the chain</param>
             <returns>True if the internal property is in the flattening chain</returns>
         </member>
-        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.FixSerializationReturnTypes(Microsoft.TypeSpec.Generator.Providers.ModelProvider)">
-             <summary>
-             Fixes the return type of serialization override methods (PersistableModelCreateCore,
-             JsonModelCreateCore) to use the system base type (e.g., ResourceData) instead of the
-             immediate parent type. Without this, the framework generates overrides with
-             model.Type.BaseType as the return type, which can produce a covariant return type
-             (e.g., returning CustomPatchBase instead of ResourceData). Covariant returns are not
-             supported on .NET Framework.
-            
-             Also fixes the explicit interface implementations (IJsonModel&lt;T&gt;.Create,
-             IPersistableModel&lt;T&gt;.Create) that call these methods, adding a cast to the
-             model type when the return type was changed. Without this cast, the implicit
-             conversion from ResourceData to the model type would fail to compile.
-             </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.FixExplicitInterfaceCreateMethods(Microsoft.TypeSpec.Generator.ClientModel.Providers.MrwSerializationTypeDefinition)">
-            <summary>
-            Ensures the explicit interface Create methods (IJsonModel&lt;T&gt;.Create,
-            IPersistableModel&lt;T&gt;.Create) cast the result of *Core to the method's declared
-            return type T (the discriminated base, e.g., PolyDeviceData). MTG may emit no cast
-            or an incorrect cast to the containing class (e.g., (UnknownPolyDevice)); the latter
-            throws InvalidCastException at runtime when the discriminator dispatch returns a
-            different concrete subtype.
-            </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.FindSystemBaseType(Microsoft.TypeSpec.Generator.Providers.ModelProvider)">
+        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.EnsureFrameworkTypeRegistered(Microsoft.TypeSpec.Generator.Providers.SystemObjectModelProvider)">
             <summary>
-            Walks up the model hierarchy to find the system base type (e.g., ResourceData)
-            that the virtual serialization methods use as their return type.
-            </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.RemoveDuplicatePropertiesAndStripVirtual(Microsoft.TypeSpec.Generator.Providers.ModelProvider,Microsoft.TypeSpec.Generator.Providers.ModelProvider,System.Collections.Generic.HashSet{System.String})">
-            <summary>
-            Removes properties with 'new' modifier or matching base property names from the model,
-            and strips orphaned virtual modifiers from corresponding base properties.
-            </summary>
-        </member>
-        <member name="M:Azure.Generator.Management.Visitors.InheritableSystemObjectModelVisitor.StripOrphanedVirtualModifiers(Microsoft.TypeSpec.Generator.Providers.ModelProvider,System.Collections.Generic.HashSet{System.String})">
-            <summary>
-            Strips the virtual modifier from base model properties whose names match removed derived properties.
-            When derived properties with new/override modifiers are removed, the corresponding base virtual
-            modifier becomes orphaned and should be removed.
+            Registers the framework CSharpType (from KnownManagementTypes) as an alias in the CSharpTypeMap.
+            This allows BuildBaseModelProvider() to find SystemObjectModelProvider when custom code
+            uses a Roslyn-resolved framework CSharpType (which differs from the non-framework CSharpType
+            created by SystemObjectModelProvider).
             </summary>
         </member>
         <member name="T:Azure.Generator.Management.Visitors.ManagedIdentityV3Visitor">
@@ -1197,7 +1194,7 @@
         </member>
         <member name="T:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper">
             <summary>
-            Repairs hidden model factory compatibility overloads after flattening changes the current model factory shape.
+            Repairs model factory constructor calls after visitors change the current model shape.
             Used from <see cref="M:Azure.Generator.Management.ManagementClientGenerator.GetWriter(Microsoft.TypeSpec.Generator.Providers.TypeProvider)"/> because some compatibility overloads are
             synthesized from LastContractView after normal visitors have finished.
             </summary>
@@ -1271,7 +1268,7 @@
             Used by <see cref="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.TryBuildCompatibilityArgument(Microsoft.TypeSpec.Generator.Providers.MethodProvider,Microsoft.TypeSpec.Generator.Providers.ParameterProvider,System.Collections.Generic.IReadOnlySet{System.String},Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.CompatibilityArgument@)"/> while reconstructing flattened nested model instances.
             </summary>
         </member>
-        <member name="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.TryGetMethodParameter(Microsoft.TypeSpec.Generator.Providers.MethodProvider,System.String,Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Providers.ParameterProvider@)">
+        <member name="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.TryGetMethodParameter(Microsoft.TypeSpec.Generator.Providers.MethodProvider,System.String,Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Providers.PropertyProvider,Microsoft.TypeSpec.Generator.Providers.ParameterProvider@)">
             <summary>
             Finds an old overload parameter by name and compatible type.
             Inputs are the old method, expected parameter name, and expected type; output is the matching parameter.
@@ -1282,7 +1279,7 @@
             <summary>
             Determines whether an old parameter can be used for a current constructor parameter.
             Inputs are old and expected types; output is whether direct assignment or helper conversion can make them compatible.
-            Used by <see cref="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.TryGetMethodParameter(Microsoft.TypeSpec.Generator.Providers.MethodProvider,System.String,Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Providers.ParameterProvider@)"/> to allow nullable/value and list-interface shape differences.
+            Used by <see cref="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.TryGetMethodParameter(Microsoft.TypeSpec.Generator.Providers.MethodProvider,System.String,Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Providers.PropertyProvider,Microsoft.TypeSpec.Generator.Providers.ParameterProvider@)"/> to allow nullable/value and list-interface shape differences.
             </summary>
         </member>
         <member name="M:Azure.Generator.Management.Visitors.ModelFactoryBackwardCompatHelper.AreCompatibleListTypes(Microsoft.TypeSpec.Generator.Primitives.CSharpType,Microsoft.TypeSpec.Generator.Primitives.CSharpType)">
@@ -1338,6 +1335,9 @@
         <member name="M:Azure.Generator.Management.Visitors.RestClientVisitor.VisitType(Microsoft.TypeSpec.Generator.Providers.TypeProvider)">
             <inheritdoc/>
         </member>
+        <member name="M:Azure.Generator.Management.Visitors.SerializationVisitor.VisitType(Microsoft.TypeSpec.Generator.Providers.TypeProvider)">
+            <inheritdoc/>
+        </member>
         <member name="M:Azure.Generator.Management.Visitors.SerializationVisitor.VisitMethod(Microsoft.TypeSpec.Generator.Providers.MethodProvider)">
             <inheritdoc/>
         </member>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-typespec/http-client-csharp-mgmt",
-  "version": "1.0.0-alpha.20260601.1",
+  "version": "1.0.0-alpha.20260604.1",
   "author": "Microsoft Corporation",
   "description": "TypeSpec library for emitting Azure management libraries for C#.",
   "readme": "https://github.com/Azure/azure-sdk-for-net/blob/main/eng/packages/http-client-csharp-mgmt/README.md",