Index the gallery's sample pages so other tools can consume them

.github/copilot-instructions.md

@@ -73,6 +73,13 @@ Pages use the `ControlExample` custom control to show interactive demos:
 2. Create a folder `Samples/{UniqueId}/` and add `{ControlName}Page.xaml` and `.xaml.cs` using the `ControlExample` pattern above. The folder name **must** match the `UniqueId` exactly.
 3. The source generator auto-maps the `UniqueId` to the page type — no manual registration needed.
 4. Add any code snippets as `.txt` files in the same `Samples/{UniqueId}/` folder. They are automatically included in the build as content.
+5. Regenerate the sample index and commit the result:
+
+```powershell
+dotnet run --project tools/CatalogExporter -- generate
+```
+
+`catalog/windows-samples.json` is a checked-in file that other tools consume, and CI fails if it does not match the current samples. Run this whenever you add, rename, remove, or edit a control page or a snippet `.txt`.
 
 ## Accessibility
 

.pipelines/azure-pipelines.yml

@@ -24,6 +24,12 @@ steps:
         feedsToUse: 'config'
         nugetConfigPath: '$(System.DefaultWorkingDirectory)\nuget.config'
 
+    - task: DotNetCoreCLI@2
+      displayName: Verify catalog/windows-samples.json is up to date
+      inputs:
+        command: 'test'
+        projects: 'tests/WinUIGallery.CatalogExporter.Tests/WinUIGallery.CatalogExporter.Tests.csproj'
+
     - task: PowerShell@2
       displayName: Generate Test Signing Certificate
       inputs:

WinUIGallery.slnx

@@ -48,6 +48,24 @@
       <Deploy Solution="Debug|ARM64EC" />
       <Deploy Solution="Release|ARM64EC" />
     </Project>
+    <Project Path="tests/WinUIGallery.CatalogExporter.Tests/WinUIGallery.CatalogExporter.Tests.csproj">
+      <BuildType Solution="Debug-Unpackaged|*" Project="Debug" />
+      <BuildType Solution="Preview|*" Project="Release" />
+      <BuildType Solution="Release-Unpackaged|*" Project="Release" />
+      <BuildType Solution="Sideload|*" Project="Debug" />
+      <BuildType Solution="Stable|*" Project="Release" />
+      <BuildType Solution="Store|*" Project="Debug" />
+    </Project>
+  </Folder>
+  <Folder Name="/tools/">
+    <Project Path="tools/CatalogExporter/CatalogExporter.csproj">
+      <BuildType Solution="Debug-Unpackaged|*" Project="Debug" />
+      <BuildType Solution="Preview|*" Project="Release" />
+      <BuildType Solution="Release-Unpackaged|*" Project="Release" />
+      <BuildType Solution="Sideload|*" Project="Debug" />
+      <BuildType Solution="Stable|*" Project="Release" />
+      <BuildType Solution="Store|*" Project="Debug" />
+    </Project>
   </Folder>
   <Project Path="WinUIGallery.SourceGenerator/WinUIGallery.SourceGenerator.csproj">
     <BuildType Solution="Debug-Unpackaged|*" Project="Debug" />

WinUIGallery/SampleSupport/Data/ControlInfoData.json

@@ -236,7 +236,13 @@
               "Title": "XamlReader - API",
               "Uri": "https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.markup.xamlreader"
             }
-          ]
+          ],
+          "Catalog": {
+            "Aliases": [
+              "repl",
+              "live xaml preview"
+            ]
+          }
         }
       ]
     },
@@ -1383,7 +1389,13 @@
             "RepeatButton",
             "HyperlinkButton",
             "AppBarButton"
-          ]
+          ],
+          "Catalog": {
+            "Aliases": [
+              "cta",
+              "call to action"
+            ]
+          }
         },
         {
           "UniqueId": "DropDownButton",
@@ -2606,8 +2618,6 @@
             }
           ],
           "RelatedControls": [
-            "Panel",
-            "StackLayout",
             "ItemsRepeater"
           ]
         },

WinUIGallery/SampleSupport/Data/ControlInfoDataSchema.json

@@ -103,6 +103,31 @@
                                     },
                                     "description": "Additional keywords used purely for search. If a search query matches one of these tags, this sample will be surfaced in the results even when the tag does not appear in the Title."
                                 },
+                                "Catalog": {
+                                    "type": "object",
+                                    "description": "Optional, opt-in overrides consumed only by tools/CatalogExporter when generating catalog/windows-samples.json. Everything here is additive/derivable metadata that the running gallery app itself never reads; omit this block entirely unless a sample genuinely needs to diverge from what the exporter can derive automatically from the fields above and the on-disk sample folder.",
+                                    "properties": {
+                                        "Exclude": {
+                                            "type": "boolean",
+                                            "default": false,
+                                            "description": "When true, this item is left out of the generated catalog manifest entirely (for example, a developer utility page rather than a genuine, documentable sample)."
+                                        },
+                                        "Aliases": {
+                                            "type": "array",
+                                            "items": {
+                                                "type": "string"
+                                            },
+                                            "description": "Additional search aliases that are useful for an external catalog/agent but too broad or noisy for the in-app search experience (which already uses Tags)."
+                                        },
+                                        "RelatedSamples": {
+                                            "type": "array",
+                                            "items": {
+                                                "type": "string"
+                                            },
+                                            "description": "Extra related-sample references that point outside this repository, formatted as '{owner}/{repo}#{uniqueId}'. Used to extend (not replace) RelatedControls, which can only reference other items in this same file."
+                                        }
+                                    }
+                                }
                             },
                             "required": [ "UniqueId", "Title"]
                         }

WinUIGallery/Samples/AccessibilityKeyboard/AccessibilityKeyboardAccelerators.txt

@@ -0,0 +1,58 @@
+--- xaml
+<Grid ColumnSpacing="8" RowSpacing="8">
+<Grid.RowDefinitions>
+	<RowDefinition Height="Auto" />
+	<RowDefinition Height="Auto" />
+</Grid.RowDefinitions>
+
+<Grid.ColumnDefinitions>
+	<ColumnDefinition Width="Auto"/>
+	<ColumnDefinition Width="Auto"/>
+	<ColumnDefinition Width="Auto"/>
+</Grid.ColumnDefinitions>
+
+<Rectangle x:Name="ColorRectangle" Fill="Red"
+	Height="30" RadiusX="4" RadiusY="4"
+	Grid.ColumnSpan="3"/>
+
+<Button Click="MakeRedButton_Click" Content="Red" Grid.Row="1"
+	ToolTipService.ToolTip="Shortcut: Ctrl+R">
+	<Button.KeyboardAccelerators>
+		<KeyboardAccelerator Modifiers="Control" Key="R" />
+	</Button.KeyboardAccelerators>
+</Button>
+
+<Button Click="MakeBlueButton_Click" Content="Blue"
+	Grid.Row="1" Grid.Column="1"
+	ToolTipService.ToolTip="Shortcut: Ctrl+B">
+	<Button.KeyboardAccelerators>
+		<KeyboardAccelerator Modifiers="Control" Key="B" />
+	</Button.KeyboardAccelerators>
+</Button>
+
+<!--
+    Chartreuse is an uncommon color, so we explain it in the tooltip.
+    This replaces the auto-generated tooltip, so we manually mention
+    the hotkey in the custom tooltip.
+-->
+<Button Click="MakeChartreuseButton_Click" Content="Chartreuse"
+	Grid.Row="1" Grid.Column="1"
+	ToolTipService.ToolTip="A greenish yellow (Ctrl+G)">
+	<Button.KeyboardAccelerators>
+		<KeyboardAccelerator Modifiers="Control" Key="G" />
+	</Button.KeyboardAccelerators>
+</Button>
+</Grid>
+--- c#
+private void MakeRedButton_Click(object sender, RoutedEventArgs e)
+{
+    ColorRectangle.Fill = new SolidColorBrush(Colors.Red);
+}
+private void MakeBlueButton_Click(object sender, RoutedEventArgs e)
+{
+    ColorRectangle.Fill = new SolidColorBrush(Colors.Blue);
+}
+private void MakeChartreuseButton_Click(object sender, RoutedEventArgs e)
+{
+    ColorRectangle.Fill = new SolidColorBrush(Colors.Chartreuse);
+}

WinUIGallery/Samples/AccessibilityKeyboard/AccessibilityKeyboardAccessKeys.txt

@@ -0,0 +1,20 @@
+--- xaml
+<MenuBar>
+    <MenuBarItem Title="File" AccessKey="F">
+        <MenuFlyoutItem Text="New" AccessKey="N" />
+        <MenuFlyoutItem Text="Open..." AccessKey="O" />
+        <MenuFlyoutItem Text="Save" AccessKey="S" />
+        <MenuFlyoutItem Text="Exit" AccessKey="E" />
+    </MenuBarItem>
+
+    <MenuBarItem Title="Edit" AccessKey="E">
+        <MenuFlyoutItem Text="Undo" AccessKey="U" />
+        <MenuFlyoutItem Text="Cut" AccessKey="X" />
+        <MenuFlyoutItem Text="Copy" AccessKey="C" />
+        <MenuFlyoutItem Text="Paste" AccessKey="V" />
+    </MenuBarItem>
+
+    <MenuBarItem Title="Help" AccessKey="H">
+        <MenuFlyoutItem Text="About" AccessKey="A" />
+    </MenuBarItem>
+</MenuBar>

WinUIGallery/Samples/AccessibilityKeyboard/AccessibilityKeyboardAutomaticArrowKeys.txt

@@ -0,0 +1,10 @@
+--- xaml
+<!-- ListViews fully support arrow keys, for example -->
+<ListView
+    Width="300"
+    AutomationProperties.Name="Colors">
+    <ListViewItem>Red</ListViewItem>
+    <ListViewItem>Blue</ListViewItem>
+    <ListViewItem>Green</ListViewItem>
+    <ListViewItem>Yellow</ListViewItem>
+</ListView>

WinUIGallery/Samples/AccessibilityKeyboard/AccessibilityKeyboardAutomaticTabOrder.txt

@@ -0,0 +1,10 @@
+--- xaml
+<StackPanel Spacing="4">
+    <Button Content="First" />
+    <!-- Non-interactive controls should not be in the tab order -->
+    <TextBlock Text="(not present)" />
+    <Button Content="Second" />
+    <!-- Disabled controls should not be in the tab order -->
+    <Button Content="(not present)" IsEnabled="False" />
+    <Button Content="Third" />
+</StackPanel>

WinUIGallery/Samples/AccessibilityKeyboard/AccessibilityKeyboardManualArrowKeys.txt

@@ -0,0 +1,32 @@
+--- xaml
+<StackPanel
+    Background="{ThemeResource CardBackgroundFillColorSecondaryBrush}"
+    BorderBrush="{ThemeResource SurfaceStrokeColorDefaultBrush}"
+    AutomationProperties.Name="Potatoes?"
+    BorderThickness="1"
+    Spacing="8"
+    Padding="8"
+    CornerRadius="4">
+    <TextBlock
+        Style="{ThemeResource BodyStrongTextBlockStyle}"
+        Text="Potatoes?" />
+    <!--
+        XYFocusKeyboardNavigation enables arrow keys between the buttons.
+
+        Note that:
+
+            - The buttons are still tabbable by default
+            - Home/End and PgUp/PgDn do not work
+            - Screen readers do not read PositionInSet/SizeOfSet ("1 of 3")
+
+        All of that would require custom work.
+    -->
+    <StackPanel
+        Spacing="4"
+        Orientation="Horizontal"
+        XYFocusKeyboardNavigation="Enabled">
+        <Button Content="Boil 'em"  />
+        <Button Content="Mash 'em" />
+        <Button Content="Stick 'em in a stew" />
+    </StackPanel>
+</StackPanel>

WinUIGallery/Samples/AccessibilityKeyboard/AccessibilityKeyboardManualTabOrder.txt

@@ -0,0 +1,29 @@
+--- xaml
+<Grid RowSpacing="8" ColumnSpacing="8">
+    <Grid.RowDefinitions>
+	    <RowDefinition Height="Auto"/>
+	    <RowDefinition Height="Auto"/>
+	    <RowDefinition Height="Auto"/>
+    </Grid.RowDefinitions>
+    <Grid.ColumnDefinitions>
+	    <ColumnDefinition Width="Auto"/>
+	    <ColumnDefinition Width="Auto"/>
+	    <ColumnDefinition Width="Auto"/>
+    </Grid.ColumnDefinitions>
+
+    <TextBlock Grid.Column="1" HorizontalAlignment="Center" Text="Column 1"/>
+    <TextBlock Grid.Column="2" HorizontalAlignment="Center" Text="Column 2"/>
+
+    <!--
+        This example is a bit contrived, since you could fix the
+        tab order by reordering the elements in the XAML, but
+        sometimes that is not easy to do.
+    -->
+    <TextBlock Grid.Row="1" VerticalAlignment="Center" Text="Row 1"/>
+    <Button Grid.Column="1" Grid.Row="1" Content="First stop" TabIndex="1" HorizontalAlignment="Stretch"/>
+    <Button Grid.Column="2" Grid.Row="1" Content="Third stop" TabIndex="3" HorizontalAlignment="Stretch"/>
+
+    <TextBlock Grid.Row="2" VerticalAlignment="Center" Text="Row 2"/>
+    <Button Grid.Column="1" Grid.Row="2" Content="Second stop" TabIndex="2" HorizontalAlignment="Stretch"/>
+    <Button Grid.Column="2" Grid.Row="2" Content="Not a stop" IsTabStop="False" HorizontalAlignment="Stretch"/>
+</Grid>