fix: sync library, CLI, tests, and docs from main to resolve PR FritzAndFriends#552 CI failures

The -X ours merge strategy kept dev's older versions of source files while
other files referenced features only in main (from PR FritzAndFriends#547 squash). This
created inconsistent state causing CS0506 (FindControl not virtual) and
CS0117 (missing CascadingParameterName) errors.

Restored main's versions of:
- Core library: BaseWebFormsComponent, WebFormsPageBase, GridView, CheckBox, etc.
- CLI project: all transforms, pipeline, scaffolding files
- Tests: all CLI test files and test data
- Docs: mkdocs.yml, CLI docs, migration guides

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: csharpfritz

docs/Migration/FindControl-Migration.md

@@ -344,6 +344,31 @@ public class BaseWebFormsComponent : ComponentBase
 
 **What it does:** Searches the current component's child controls and all descendants recursively for one with the matching ID. This mirrors the deep-search behavior that migrated Web Forms code typically expects.
 
+### GridViewRow.FindControl — Data Row Controls
+
+For data controls like `GridView`, `FindControl` also works on individual rows. `GridViewRow<T>` and the non-generic `GridViewRow` shim both support `FindControl(string id)`:
+
+```csharp
+// This Web Forms pattern compiles and works unchanged in BWFC:
+GridViewRow row = CartList.Rows[i];  // implicit operator from GridViewRow<T>
+TextBox qty = (TextBox)row.FindControl("PurchaseQuantity");
+CheckBox remove = (CheckBox)row.FindControl("chkRemove");
+```
+
+In SSR mode, `FindControl` returns proxy `TextBox` and `CheckBox` instances whose `Text` and `Checked` properties are populated from the form POST data. This means migrated code that reads control values inside a postback handler works without modification.
+
+**Key compatibility features:**
+
+| Feature | Description |
+|---------|-------------|
+| `Rows[i]` typed indexer | Returns `GridViewRow<T>`, not `IRow<T>` |
+| Implicit conversion | `GridViewRow<T>` converts to non-generic `GridViewRow` automatically |
+| `FindControl` on rows | Returns proxy controls populated from form POST data |
+| `Cells` collection | `DataControlFieldCellCollection` with `ContainingField.ExtractValuesFromCell()` |
+| `RowState` | `DataControlRowState` flags enum (Normal, Alternate, Edit, Selected) |
+
+See [GridView — GridViewRow Compatibility](../DataControls/GridView.md#gridviewrow-compatibility) for full details and code examples.
+
 ---
 
 ## Complete DepartmentPortal Migration Examples

docs/cli/index.md

@@ -21,7 +21,8 @@ This tool **reduces manual migration effort** by:
 - Extracting code patterns and flagging them with TODO comments for Copilot L2 automation
 - Quarantining risky legacy bootstrap/source artifacts out of the generated SSR compile surface
 - Scaffolding a new .NET 10 Blazor SSR project structure with shims, services, and relaxed code-style build enforcement for copied legacy files
-- Detecting common runtime needs from the source app (DbContext classes, session usage, Account pages, and Global.asax startup hooks) and wiring matching `Program.cs` services/middleware automatically, including static-file serving and antiforgery middleware for SSR form posts
+- Detecting common runtime needs from the source app (DbContext classes, session usage, Account pages, and Global.asax startup hooks) and wiring matching `Program.cs` services/middleware automatically, including static-file serving, antiforgery middleware for SSR form posts, and generated account login/register/logout endpoints when Identity is detected
+- Modernizing legacy `AttachDbFilename=|DataDirectory|\*.mdf` connection strings to use `Initial Catalog=...` so migrated apps do not depend on missing local MDF files at runtime
 
 The tool processes `.aspx`, `.ascx`, and `.master` files in a fixed sequence, then applies a bounded semantic pattern catalog so each higher-level rewrite builds on a normalized page shape.
 
@@ -93,7 +94,7 @@ webforms-to-blazor migrate \
 **Output:**
 - Converted `.razor` files
 - Quarantined manual code-behind and risky legacy source artifacts under `migration-artifacts\`, including a `quarantine-manifest.json` inventory for deferred page migration work
-- Generated `Program.cs` with shim registration for static SSR on .NET 10 plus detected runtime wiring for EF Core, session state, identity, and legacy `Application_Start` review notes
+- Generated `Program.cs` with shim registration for static SSR on .NET 10 plus detected runtime wiring for EF Core, session state, identity, generated account auth endpoints, and legacy `Application_Start` review notes
 - Migration report (`migration-report.json`)
 
 ### `convert` — File-Level Transformation
@@ -117,8 +118,8 @@ webforms-to-blazor convert \
 The tool applies an ordered transform pipeline and then a semantic pattern catalog:
 
 1. **Directives** (5) — Page, Master, Control, Register, Import directives
-2. **Markup** (21) — Controls, expressions, master-page script cleanup, display-expression cleanup, templates, validator typing, typed GridView columns, data binding
-3. **Code-Behind** (27) — Using statements, cart session-key stabilization, HttpUtility/EF modernization, base classes, lifecycle, event handlers, compile-surface stubs, markup-driven safety stubs
+2. **Markup** (21) — Controls, expressions, master-page script cleanup, display-expression cleanup, templates, validator typing, typed GridView columns (including `CommandField`), and CRUD model-binding attributes
+3. **Code-Behind** (29) — Using statements, cart session-key stabilization, HttpUtility/EF modernization, IQueryable SelectMethod materialization, WebMethod TODO annotation, base classes, lifecycle, event handlers, compile-surface stubs, markup-driven safety stubs
 
 See **[Transform Reference](transforms.md)** for the flat transform list and **[Semantic Pattern Catalog](semantic-pattern-catalog.md)** for the bounded semantic pass that runs afterward.
 

docs/cli/transforms.md

@@ -20,14 +20,15 @@ This page documents the flat markup and code-behind transforms applied by the `w
 | 500 | ExpressionTransform | Markup | Markup | Convert `<%: %>`, `<%= %>`, and inline data expressions to Razor |
 | 510 | ServerCodeBlockTransform | Markup | Markup | Convert `<% ... %>` statement blocks to Razor control flow |
 | 510 | LoginViewTransform | Markup | Markup | Convert `<asp:LoginView>` → `<AuthorizeView>` |
-| 520 | SelectMethodTransform | Markup | Markup | Flag SelectMethod/InsertMethod/etc. |
+| 520 | SelectMethodTransform | Markup | Markup | Preserve SelectMethod / InsertMethod / UpdateMethod / DeleteMethod model-binding attributes |
+| 550 | WebMethodAnnotationTransform | Code-Behind | Code-Behind | Flag legacy static WebMethod endpoints and normalize `Page_PreRenderComplete` for lifecycle conversion |
 | 600 | AjaxToolkitPrefixTransform | Markup | Markup | Remove `ajaxToolkit:` prefixes |
 | 610 | AspPrefixTransform | Markup | Markup | Remove `asp:` prefixes from controls |
 | 615 | DataBindingAttributeTransform | Markup | Markup | Convert `<%# ... %>` and `<%= ... %>` attribute values to `@(...)` |
 | 615 | ValidatorGenericTypeTransform | Markup | Markup | Add explicit `Type="string"` / `InputType="string"` defaults for generic BWFC validators |
 | 620 | TemplateFieldChildComponentsTransform | Markup | Markup | Wrap TemplateField style children in `<ChildComponents>` |
 | 700 | AttributeStripTransform | Markup | Markup | Remove `runat="server"`, preserve BWFC `ItemType`, add generic fallbacks |
-| 705 | GridViewColumnItemTypeTransform | Markup | Markup | Propagate typed `GridView ItemType` values to `BoundField` / `TemplateField` child columns |
+| 705 | GridViewColumnItemTypeTransform | Markup | Markup | Propagate typed `GridView ItemType` values to `BoundField` / `TemplateField` / `ButtonField` / `CommandField` child columns |
 | 710 | EventWiringTransform | Markup | Markup | Convert `OnClick="X"` → `OnClick="@X"` |
 | 720 | UrlReferenceTransform | Markup | Markup | Convert `~/` paths to `/` |
 | 750 | ComponentRefMarkupTransform | Markup | Markup | Convert control IDs to `@ref`-compatible component references |
@@ -50,6 +51,8 @@ This page documents the flat markup and code-behind transforms applied by the `w
 | 50 | UrlCleanupTransform | Code-Behind | Code-Behind | Clean URL literals in code |
 | 104 | HttpUtilityRewriteTransform | Code-Behind | Code-Behind | Rewrite `HttpUtility.*` calls to `WebUtility.*` and add `using System.Net;` |
 | 106 | EfContextConstructorTransform | Code-Behind | Code-Behind | Rewrite EF6 `base("name")` DbContext constructors to EF Core `DbContextOptions<TContext>` constructors |
+| 107 | DbContextInstantiationTransform | Code-Behind | Code-Behind | Replace inline `new XxxContext()` usage with injected DbContext references |
+| 108 | SelectMethodMaterializeTransform | Code-Behind | Code-Behind | Materialize IQueryable SelectMethod results before methods exit after `CreateDbContext()` usage |
 | 850 | CompileSurfaceStubTransform | Code-Behind | Code-Behind | Quarantine identity/payment/mobile/admin/compile-blocked pages with build-safe stubs while preserving transformed originals in `migration-artifacts\codebehind\` and tracking them in `migration-artifacts\quarantine-manifest.json` |
 | 900 | MarkupReferencedMemberStubTransform | Code-Behind | Code-Behind | Add fallback fields, render-method stubs, and event handlers for markup references still missing from emitted partial classes |
 
@@ -1021,7 +1024,41 @@ string imageUrl = "/images/logo.png";
 
 ---
 
-### 32. CompileSurfaceStubTransform (Order: 850)
+### 32. SelectMethodMaterializeTransform (Order: 108)
+
+**Materializes `IQueryable` SelectMethod results before the scoped DbContext goes out of scope.**
+
+**Before:**
+```csharp
+public IQueryable<Product> GetProducts(int maxRows, int startRowIndex, string sortByExpression, out int totalRowCount)
+{
+    using var db = DbFactory.CreateDbContext();
+    var query = db.Products.OrderBy(p => p.ProductName);
+    totalRowCount = query.Count();
+    return query;
+}
+```
+
+**After:**
+```csharp
+public IQueryable<Product> GetProducts(int maxRows, int startRowIndex, string sortByExpression, out int totalRowCount)
+{
+    var db = DbFactory.CreateDbContext();
+    var query = db.Products.OrderBy(p => p.ProductName);
+    totalRowCount = query.Count();
+    return query.ToList().AsQueryable();
+}
+```
+
+**Details:**
+- Only applies to methods whose signature returns `IQueryable<...>`
+- Removes `using` from `using var db = ...CreateDbContext()` so the query can be materialized before the method exits
+- Rewrites simple `return query;` patterns to `return query.ToList().AsQueryable();`
+- Leaves non-`IQueryable` methods untouched
+
+---
+
+### 33. CompileSurfaceStubTransform (Order: 850)
 
 **Quarantines non-migratable pages behind build-safe placeholders.**
 
@@ -1035,7 +1072,7 @@ string imageUrl = "/images/logo.png";
 
 ---
 
-### 33. MarkupReferencedMemberStubTransform (Order: 900)
+### 34. MarkupReferencedMemberStubTransform (Order: 900)
 
 **Adds compile-safe fallback members for identifiers that remain referenced from markup.**
 

mkdocs.yml

@@ -215,6 +215,7 @@ nav:
           - Migration Strategies: Migration/Strategies.md
           - .NET Standard to the Rescue: Migration/NET-Standard.md
           - Automated Migration Guide: Migration/AutomatedMigration.md
+          - Automated Migration with Copilot: Migration/AutomatedMigrationWithCopilot.md
           - Roslyn Analyzers: Migration/Analyzers.md
       - Guides:
           - ClientScript Migration: Migration/ClientScriptMigrationGuide.md

src/BlazorWebFormsComponents.Cli/BlazorWebFormsComponents.Cli.csproj

@@ -25,6 +25,10 @@
     <RepositoryType>GitHub</RepositoryType>
   </PropertyGroup>
 
+  <ItemGroup>
+    <InternalsVisibleTo Include="BlazorWebFormsComponents.Cli.Tests" />
+  </ItemGroup>
+
   <ItemGroup>
     <PackageReference Include="System.CommandLine" Version="2.0.0-beta4.22272.1" />
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="9.0.0" />

src/BlazorWebFormsComponents.Cli/Config/WebConfigTransformer.cs

@@ -1,4 +1,5 @@
 using System.Text.Json;
+using System.Text.RegularExpressions;
 using System.Xml.Linq;
 using BlazorWebFormsComponents.Cli.Io;
 
@@ -68,7 +69,7 @@ public class WebConfigTransformer
             {
                 if (!BuiltInConnectionNames.Contains(name))
                 {
-                    connectionStrings[name] = connStr;
+                    connectionStrings[name] = NormalizeConnectionString(connStr);
                 }
             }
         }
@@ -123,6 +124,109 @@ public class WebConfigTransformer
         };
     }
 
+    private static string NormalizeConnectionString(string connStr)
+    {
+        // EF6 metadata connection strings wrap the real SQL connection string inside
+        // a provider connection string parameter. Unwrap it first.
+        connStr = UnwrapEf6ConnectionString(connStr);
+
+        if (!connStr.Contains("AttachDbFilename=|DataDirectory|", StringComparison.OrdinalIgnoreCase))
+            return connStr;
+
+        var segments = connStr.Split(';', StringSplitOptions.RemoveEmptyEntries)
+            .Select(segment => segment.Trim())
+            .ToList();
+
+        string? databaseName = null;
+        var normalizedSegments = new List<string>();
+
+        foreach (var segment in segments)
+        {
+            var separatorIndex = segment.IndexOf('=');
+            if (separatorIndex < 0)
+            {
+                normalizedSegments.Add(segment);
+                continue;
+            }
+
+            var key = segment[..separatorIndex].Trim();
+            var value = segment[(separatorIndex + 1)..].Trim();
+
+            if (key.Equals("AttachDbFilename", StringComparison.OrdinalIgnoreCase) &&
+                value.StartsWith("|DataDirectory|", StringComparison.OrdinalIgnoreCase))
+            {
+                var fileName = Path.GetFileNameWithoutExtension(value.Replace("|DataDirectory|\\", string.Empty, StringComparison.OrdinalIgnoreCase)
+                    .Replace("|DataDirectory|/", string.Empty, StringComparison.OrdinalIgnoreCase));
+
+                if (!string.IsNullOrWhiteSpace(fileName))
+                    databaseName ??= NormalizeDatabaseName(fileName);
+
+                continue;
+            }
+
+            normalizedSegments.Add(segment);
+        }
+
+        if (string.IsNullOrWhiteSpace(databaseName))
+            return connStr;
+
+        if (!normalizedSegments.Any(segment => segment.StartsWith("Initial Catalog=", StringComparison.OrdinalIgnoreCase)))
+        {
+            var insertIndex = normalizedSegments.FindIndex(segment => segment.StartsWith("Data Source=", StringComparison.OrdinalIgnoreCase));
+            var catalogSegment = $"Initial Catalog={databaseName}";
+            if (insertIndex >= 0)
+                normalizedSegments.Insert(insertIndex + 1, catalogSegment);
+            else
+                normalizedSegments.Add(catalogSegment);
+        }
+
+        return string.Join(';', normalizedSegments);
+    }
+
+    private static string NormalizeDatabaseName(string fileName)
+    {
+        return fileName.ToLowerInvariant() switch
+        {
+            "wingtiptoys" => "WingtipToys",
+            "contosouniversity" => "ContosoUniversity",
+            "departmentportal" => "DepartmentPortal",
+            _ => string.Concat(fileName
+                .Split(['-', '_', ' '], StringSplitOptions.RemoveEmptyEntries)
+                .Select(segment => char.ToUpperInvariant(segment[0]) + segment[1..].ToLowerInvariant()))
+        };
+    }
+
+    // Matches EF6 metadata connection strings:
+    //   metadata=res://*/...;provider=System.Data.SqlClient;provider connection string="actual conn string"
+    private static readonly Regex Ef6MetadataRegex = new(
+        @"^\s*metadata\s*=\s*res://",
+        RegexOptions.Compiled | RegexOptions.IgnoreCase);
+
+    private static readonly Regex Ef6ProviderConnectionStringRegex = new(
+        @"provider\s+connection\s+string\s*=\s*""(?<inner>[^""]*)""",
+        RegexOptions.Compiled | RegexOptions.IgnoreCase);
+
+    /// <summary>
+    /// Unwraps EF6 metadata connection strings to extract the inner SQL connection string.
+    /// EF6 format: metadata=res://*/...;provider=System.Data.SqlClient;provider connection string="Data Source=...;Initial Catalog=..."
+    /// Returns the inner provider connection string, or the original if not EF6 format.
+    /// </summary>
+    private static string UnwrapEf6ConnectionString(string connStr)
+    {
+        if (!Ef6MetadataRegex.IsMatch(connStr))
+            return connStr;
+
+        var match = Ef6ProviderConnectionStringRegex.Match(connStr);
+        if (match.Success)
+        {
+            var inner = match.Groups["inner"].Value;
+            // The inner string may use &quot; for quotes (from XML) — unescape
+            return inner.Replace("&quot;", "\"");
+        }
+
+        return connStr;
+    }
+
     private static string? FindWebConfig(string sourcePath)
     {
         var path1 = Path.Combine(sourcePath, "Web.config");