refactor: rename TextField -> TextBox for WinUI parity (#387)

* refactor: rename TextField -> TextBox for WinUI parity

Renames the record TextFieldElement to TextBoxElement and introduces
TextBox(...) as the canonical DSL factory. TextField(...) remains as a
[Obsolete(error: false)] forwarding alias and will be removed in a
follow-up PR. Updates analyzers, the loc scanner, samples, tests, doc
templates, and the regenerated docs/guide output. MaskedTextField is
intentionally deferred.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix: align textbox-config snippet id with new naming

The bulk markdown rename used PowerShell's case-insensitive -replace,
which mangled the lowercase snippet id forms/textfield-config into
forms/TextBox-config in the template but left the App.cs snippet
marker untouched. Align both ends to lowercase forms/textbox-config
and rename the class to TextBoxConfigDemo.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* review: clear stale Header/Description, scan header positional, tidy test

- Reconciler.Update: clear TextBox.Header/Description via ClearValue when
  the new element transitions them to null. Previously the value stayed
  stuck on the control across re-renders.
- LocalizableStringScanner: also extract the positional header argument
  (TextBox/TextField index 3); previously only the placeholder at
  index 2 was scanned, so positional header strings silently lost
  localization coverage.
- UseFocusTests: drop the unused `var el =` assignment flagged by
  github-code-quality; the chained call still runs and registers.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(test): adjust analyzer span for TextBox length

The FormFieldLabelAnalyzer test pinned the diagnostic span to columns
9..25 (16 chars, the length of TextField(value)). After the
TextField → TextBox rename, the call site is TextBox(value) — 14
chars — so the diagnostic now ends at column 23. Update the expected
span accordingly.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: codemonkeychris

CHANGELOG.md

@@ -29,6 +29,18 @@ to land under these conventions; subsequent specs follow this shape.
 
 ### Changed
 
+- **`TextField` → `TextBox` rename.** The record type
+  `TextFieldElement` is renamed to `TextBoxElement` for parity with
+  WinUI's `Microsoft.UI.Xaml.Controls.TextBox`. The `TextField(...)`
+  factory remains as a non-erroring `[Obsolete]` forwarding alias for
+  one release; call sites should migrate to `TextBox(...)`. The
+  alias will be removed in a future release.
+
+### Deprecated
+
+- **`Factories.TextField(...)`** — use `Factories.TextBox(...)` instead.
+  Emits `CS0618` warning; will be removed in a future release.
+
 - **Spec 045 Phase 2 — §2.29 ready for human review gate.**
   Every Phase-2 implementation item in
   `docs/specs/tasks/045-docking-windows-implementation.md` is now

SKILL.md

@@ -394,7 +394,7 @@ Grid(columns: [GridSize.Star(), GridSize.Px(200)],
 TitleBar("App") with { Subtitle = "Home", Content = ..., RightHeader = ... }
 
 // Controls
-Button("Click", () => ...)      TextField(value, setValue, placeholder)
+Button("Click", () => ...)      TextBox(value, setValue, placeholder)
 CheckBox(isChecked, setChecked) ToggleSwitch(on, setOn)
 Slider(v, 0, 100, setV)         ComboBox(items, index, setIndex)
 
@@ -544,7 +544,7 @@ release you depend on.
 | `<div>` | `FlexColumn() / FlexRow() / Border()` (prefer over `VStack`/`HStack`) |
 | `<span>text</span>` | `TextBlock("text")` |
 | `<button onClick={fn}>` | `Button("label", fn)` |
-| `<input value={v} onChange={fn}>` | `TextField(v, fn)` |
+| `<input value={v} onChange={fn}>` | `TextBox(v, fn)` |
 | `{cond && <X/>}` | `cond ? X() : null` |
 | `{items.map(i => <X/>)}` | `items.Select(i => X()).ToArray()` |
 | `<Component />` | `Component<MyComponent>()` |

docs/_pipeline/apps/accessibility/App.cs

@@ -23,7 +23,7 @@ public override Element Render()
             TextBlock("Profile")
                 .FontSize(18).SemiBold()
                 .HeadingLevel(AutomationHeadingLevel.Level2),
-            TextField("", _ => { }, placeholder: "Display name")
+            TextBox("", _ => { }, placeholder: "Display name")
                 .AutomationName("Display name")
                 .TabIndex(1)
                 .AccessKey("N"),
@@ -42,7 +42,7 @@ class Tier2Demo : Component
     public override Element Render()
     {
         return VStack(12,
-            TextField("", _ => { }, placeholder: "Search...")
+            TextBox("", _ => { }, placeholder: "Search...")
                 .AutomationName("Search products")
                 .HelpText("Type a product name or SKU to filter results")
                 .Width(300),
@@ -75,9 +75,9 @@ public override Element Render()
         return VStack(12,
             TextBlock("Create Account").FontSize(24).Bold()
                 .HeadingLevel(AutomationHeadingLevel.Level1),
-            TextField(name, setName, header: "Full Name")
+            TextBox(name, setName, header: "Full Name")
                 .AutomationName("Full name").Required().TabIndex(1),
-            TextField(email, setEmail, header: "Email")
+            TextBox(email, setEmail, header: "Email")
                 .AutomationName("Email address").Required().TabIndex(2)
                 .HelpText("We'll send a verification link"),
             CheckBox(agree, setAgree, label: "I accept the terms")
@@ -110,7 +110,7 @@ public override Element Render()
             ).Landmark(AutomationLandmarkType.Main)
              .AutomationName("Main content"),
 
-            TextField("", _ => { }, placeholder: "Search...")
+            TextBox("", _ => { }, placeholder: "Search...")
                 .AutomationName("Site search")
                 .Landmark(AutomationLandmarkType.Search)
         ).Padding(24);
@@ -159,7 +159,7 @@ public override Element Render()
                     VStack(12,
                         TextBlock("Modal Dialog").FontSize(18).Bold(),
                         TextBlock("Tab/Shift+Tab stays inside this panel."),
-                        TextField("", _ => { }, placeholder: "Name")
+                        TextBox("", _ => { }, placeholder: "Name")
                             .TabIndex(0),
                         Button("Close", () => setShowModal(false))
                             .TabIndex(1)

docs/_pipeline/apps/advanced/App.cs

@@ -141,7 +141,7 @@ public override Element Render()
 
         return VStack(12,
             SubHeading("UseObservableTree"),
-            TextField(vm.UserName, v => vm.UserName = v,
+            TextBox(vm.UserName, v => vm.UserName = v,
                 header: "User Name"),
             ToggleSwitch(vm.DarkMode, v => vm.DarkMode = v,
                 header: "Dark Mode"),
@@ -167,7 +167,7 @@ public override Element Render()
         return VStack(12,
             SubHeading("UseCollection"),
             HStack(8,
-                TextField(input, setInput, placeholder: "New task")
+                TextBox(input, setInput, placeholder: "New task")
                     .Width(200),
                 Button("Add", () => {
                     if (!string.IsNullOrWhiteSpace(input))
@@ -196,7 +196,7 @@ public override Element Render()
 
         return VStack(12,
             SubHeading("Imperative focus via ElementRef<T>"),
-            TextField(name, setName, placeholder: "Name").Ref(fieldRef),
+            TextBox(name, setName, placeholder: "Name").Ref(fieldRef),
             Button("Focus the field", () =>
                 fieldRef.Current?.Focus(FocusState.Programmatic))
         ).Padding(24);

docs/_pipeline/apps/collections/App.cs

@@ -130,7 +130,7 @@ public override Element Render()
         return VStack(12,
             SubHeading("VirtualListRef — Imperative Scroll"),
             HStack(8,
-                TextField(targetIndex, setTargetIndex,
+                TextBox(targetIndex, setTargetIndex,
                     placeholder: "Index"),
                 Button("Scroll To", () =>
                 {
@@ -219,7 +219,7 @@ public override Element Render()
         return VStack(12,
             SubHeading("Stable Identity with WithKey"),
             HStack(8,
-                TextField(newItem, setNewItem, placeholder: "New item"),
+                TextBox(newItem, setNewItem, placeholder: "New item"),
                 Button("Add", () => {
                     if (!string.IsNullOrWhiteSpace(newItem)) {
                         updateItems(l => [.. l, newItem.Trim()]);

docs/_pipeline/apps/commanding/App.cs

@@ -28,7 +28,7 @@ public override Element Render()
         };
 
         return VStack(12,
-            TextField(text, v => { setText(v); setSaved(false); })
+            TextBox(text, v => { setText(v); setSaved(false); })
                 .Width(400),
             HStack(8,
                 Button(saveCmd),
@@ -114,7 +114,7 @@ public override Element Render()
                 secondaryCommands: new[] {
                     AppBarButton(delete) }
             ),
-            TextField(text, setText).Margin(16)
+            TextBox(text, setText).Margin(16)
         );
     }
 }

docs/_pipeline/apps/components/App.cs

@@ -18,7 +18,7 @@ public override Element Render()
 
         return VStack(12,
             TextBlock($"Hello, {name}!").FontSize(20).Bold(),
-            TextField(name, setName, placeholder: "Your name")
+            TextBox(name, setName, placeholder: "Your name")
                 .Width(200)
         ).Padding(16);
     }

docs/_pipeline/apps/controls/App.cs

@@ -39,7 +39,7 @@ public override Element Render()
         var (volume, setVolume) = UseState(60.0);
 
         return VStack(8,
-            TextField(name, setName, placeholder: "Name").Width(200),
+            TextBox(name, setName, placeholder: "Name").Width(200),
             CheckBox(agree, setAgree, label: "I agree"),
             Slider(volume, 0, 100, setVolume).Width(200),
             Button("Submit", () => { })

docs/_pipeline/apps/dev-tooling/App.cs

@@ -24,7 +24,7 @@ public override Element Render()
                 Button("Click me", () => setCount(count + 1)),
                 TextBlock($"Clicked {count} times").SemiBold()
             ),
-            TextField(message, setMessage, placeholder: "Type something")
+            TextBox(message, setMessage, placeholder: "Type something")
                 .Width(300)
         ).Padding(24);
     }
@@ -68,7 +68,7 @@ public override Element Render()
             Heading("Iteration Cycle Demo"),
             TextBlock("Add items, then edit this code and save to see hot reload."),
             HStack(8,
-                TextField(input, setInput, placeholder: "New item")
+                TextBox(input, setInput, placeholder: "New item")
                     .Width(200),
                 Button("Add", () =>
                 {

docs/_pipeline/apps/dialogs-and-flyouts/App.cs

@@ -82,7 +82,7 @@ public override Element Render()
                 "Rename file",
                 VStack(8,
                     TextBlock("New filename:"),
-                    TextField(name, setName, placeholder: "untitled.txt")
+                    TextBox(name, setName, placeholder: "untitled.txt")
                         .Width(280)),
                 primaryButtonText: "Rename") with
             {