# Recipe Build-Verification Ledger

**Current closure:** All **41 / 41** governed recipes are `Build-verified`. All five repository-owned consumer batches completed their Windows runtime smoke on 2026-07-10, and the Render Verification snapshot route passed separately. See [Documentation Recipes Windows PASS](../quality-proof/documentation-recipes-windows-pass-2026-07-10.md).

This ledger controls the transition from `Source-verified` recipes to `Build-verified` recipes.

A successful project quality run is important, but it does not automatically prove every documentation snippet. A recipe becomes `Build-verified` only when the exact snippet or an equivalent consumer-project copy compiles on Windows/.NET Framework 4.8 through a clean consumer build or SDK harness.

## Verification rules

| Rule | Meaning |
|---|---|
| Public API only | Recipes must compile from a package/consumer point of view, not by using `Friend`, internal, test-only, proof-only, or Showcase-only helpers. |
| Exact snippet or equivalent | The compiled code must match the documented usage pattern closely enough that the docs can be trusted by a user. |
| Clean consumer context | Prefer a package consumer or minimal external app over project-reference-only proof. |
| No silent status promotion | Do not change `Source-verified` to `Build-verified` because the main project builds. Compile the recipe path itself. |
| Showcase follows later | `Showcase-ready` requires `Build-verified` plus a real live Showcase scene and matching code panel. |

## Recommended verification batches

| Batch | Recipes | Reason |
|---:|---|---|
| 1 | Application, first window, layout page, labels/buttons/text inputs | These are the first experience for a new user and the safest Showcase foundation. |
| 2 | Feedback, split button, combo/slider inputs, navigation, surfaces, DataGrid basic rows | These make the Showcase feel like a real application and prove common controls. |
| 3 | Theme/surface material, Localization/RTL, Output capability routes, DataGrid large-data boundary | These prove product identity, internationalization, official export boundaries, and data-scale discipline. |
| 4 | Product controls | These are high-value controls but should be verified after the core application path is stable. |
| 5 | Render Verification and advanced proof dashboards | These are useful for evaluators/maintainers but should not distract beginner docs. |


## Batch 1 prepared compile host

Batch 1 now has a repository-owned public consumer sample:

```text
samples/RecipeVerification.Batch1/Nexamas.UI.RecipeVerification.Batch1.vbproj
```

Run from the repository root on Windows:

```powershell
msbuild .\samples\RecipeVerification.Batch1\Nexamas.UI.RecipeVerification.Batch1.vbproj /t:Restore,Build /p:Configuration=Release /p:Platform=x64
```

Prepared proof note: [Recipe build-verification Batch 1 preparation — 2026-07-08](../quality-proof/archive/recipe-build-verification-batch1-prep-2026-07-08.md).

Initial status rule: sample preparation alone did not promote recipes to `Build-verified`. The successful Windows build result is recorded below and now controls the current status.



## Batch 2 prepared compile host

Batch 2 now has a repository-owned public consumer sample:

```text
samples/RecipeVerification.Batch2/Nexamas.UI.RecipeVerification.Batch2.vbproj
```

Run from the repository root on Windows:

```powershell
msbuild .\samples\RecipeVerification.Batch2\Nexamas.UI.RecipeVerification.Batch2.vbproj /t:Restore,Build /p:Configuration=Release /p:Platform=x64
```

Prepared proof note: [Recipe build-verification Batch 2 preparation — 2026-07-08](../quality-proof/archive/recipe-build-verification-batch2-prep-2026-07-08.md).

Initial status rule: sample preparation alone did not promote recipes to `Build-verified`. The successful Windows build result is recorded below and now controls the current status.


## Batch 3 prepared compile host

Batch 3 now has a repository-owned public consumer sample:

```text
samples/RecipeVerification.Batch3/Nexamas.UI.RecipeVerification.Batch3.vbproj
```

Run from the repository root on Windows:

```powershell
msbuild .\samples\RecipeVerification.Batch3\Nexamas.UI.RecipeVerification.Batch3.vbproj /t:Restore,Build /p:Configuration=Release /p:Platform=x64
```

Prepared proof note: [Recipe build-verification Batch 3 preparation — 2026-07-08](../quality-proof/archive/recipe-build-verification-batch3-prep-2026-07-08.md).

Initial status rule: sample preparation alone did not promote recipes to `Build-verified`. The successful Windows build result is recorded below and now controls the current status.


## Batch 4 prepared compile host

Batch 4 now has a public-consumer compile and runtime-smoke host:

```text
samples/RecipeVerification.Batch4/Nexamas.UI.RecipeVerification.Batch4.vbproj
```

It covers the eight `Product.*.Basic` recipes and supports `--smoke`. The accepted Windows run on 2026-07-10 promoted all eight recipes to `Build-verified`.

## Batch 5 prepared compile host

Batch 5 now has a public-consumer compile and runtime-smoke host:

```text
samples/RecipeVerification.Batch5/Nexamas.UI.RecipeVerification.Batch5.vbproj
```

It covers `Verification.RenderSnapshot`, the public dashboard attachment route, `--smoke`, and `--snapshot-smoke`. The accepted Windows run on 2026-07-10 promoted the recipe to `Build-verified`, and the direct snapshot smoke also passed.

Preparation proof: [Recipe build-verification Batch 4 + Batch 5 preparation — 2026-07-10](../quality-proof/recipe-build-verification-batch4-batch5-prep-2026-07-10.md).

## Unified documentation snippet proof

Run all five compile hosts and their lifecycle smoke modes on Windows:

```powershell
.\eng\tests\Run-NexamasUIDocumentationSnippetProof.ps1
```

Use `-IncludeSnapshotSmoke` when the full Render Verification artifact route should also execute, or run `eng/tests/Run-NexamasUIRenderSnapshotSmoke.ps1` separately. Generated reports are written under `.artifacts/documentation-snippet-proof/`; durable accepted proof is normalized under `docs/_inventory/windows-proof/`.

## Windows build-verification result — 2026-07-08

The maintainer reported the Windows recipe verification build result after Batch 1 and Batch 2 preparation:

| Item | Result |
|---|---|
| Recipe sample build | `196 Warning(s), 0 Error(s)` |
| Full quality gate | `Passed: 15, Skipped: 0, Failed: 0` |
| Verification date | 2026-07-08 |
| Consumer style | Repository-owned project-reference consumer samples |
| Status effect | Batch 1 and Batch 2 covered recipes are promoted from `Source-verified` to `Build-verified`. |
| Showcase effect | No recipe is promoted to `Showcase-ready` until it also has a live Showcase scene and matching code panel. |

Proof note: [Recipe build-verification Batch 1 + Batch 2 Windows PASS — 2026-07-08](../quality-proof/recipe-build-verification-batch1-batch2-pass-2026-07-08.md).

## Batch 3 Windows build-verification result — 2026-07-08

The maintainer reported the Windows Batch 3 recipe verification sequence completed and the full quality gate passed after cleanup:

| Item | Result |
|---|---|
| Recipe sample build | Maintainer-reported PASS; no blocking build error reported for Batch 3. |
| Full quality gate | `Passed: 15, Skipped: 0, Failed: 0` |
| Verification date | 2026-07-08 |
| Consumer style | Repository-owned project-reference consumer sample |
| Status effect | Batch 3 covered recipes are promoted from `Source-verified` to `Build-verified`. |
| Showcase effect | No recipe is promoted to `Showcase-ready` until it also has a live Showcase scene and matching code panel. |

Proof note: [Recipe build-verification Batch 3 Windows PASS — 2026-07-08](../quality-proof/recipe-build-verification-batch3-pass-2026-07-08.md).


## Windows build/runtime closure — 2026-07-10

| Item | Result |
|---|---|
| Five recipe projects | Build PASS |
| Governed recipes | `41 / 41` Build-verified |
| Normal runtime smokes | `5 / 5` PASS |
| Render Verification snapshot | PASS, exit code `0` |
| Durable proof | `docs/_inventory/windows-proof/` |

Proof note: [Documentation Recipes Windows PASS — 2026-07-10](../quality-proof/documentation-recipes-windows-pass-2026-07-10.md).

## Current recipe verification table

| Recipe ID | Current status | Build-verification target | Notes |
|---|---|---|---|
| `Application.Window.Attach` | Build-verified | Minimal consumer first-window compile | Batch 1 project-reference consumer build PASS: `AttachWindowRecipeForm`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Application.Window.ExplicitLifetime` | Build-verified | Minimal consumer lifetime/dispose compile | Batch 1 project-reference consumer build PASS: `ExplicitLifetimeRecipeForm`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Layout.Page.Basic` | Build-verified | Minimal consumer page layout compile | Batch 1 project-reference consumer build PASS: `BuildCustomerPage`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Controls.BasicSet` | Build-verified | Compile AddButton/AddLabel/AddTextBox sample | Batch 1 project-reference consumer build PASS: `BuildControls`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Button.Primary.Basic` | Build-verified | Compile basic button recipe | Batch 1 project-reference consumer build PASS: `BuildSaveAction`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Button.Group.SaveCancel` | Build-verified | Compile action group recipe or equivalent | Batch 1 project-reference consumer build PASS: `BuildSaveCancelActions`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Button.Split.Basic` | Build-verified | Compile split button recipe | Batch 2 project-reference consumer build PASS: `BuildSplitAction`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Input.Text.Basic` | Build-verified | Compile TextBox recipe | Batch 1 project-reference consumer build PASS: `BuildTextInput`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Input.ComboBox.Basic` | Build-verified | Compile ComboBox recipe | Batch 2 project-reference consumer build PASS: `BuildComboBox`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Input.Search.Basic` | Build-verified | Compile SearchTextBox recipe | Batch 1 project-reference consumer build PASS: `BuildSearchInput`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Input.Slider.Basic` | Build-verified | Compile Slider recipe | Batch 2 project-reference consumer build PASS: `BuildSlider`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Feedback.StatusBanner` | Build-verified | Compile banner recipe | Batch 2 project-reference consumer build PASS: `BuildStatusBanner`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Feedback.ValidationMessage` | Build-verified | Compile validation message recipe | Batch 2 project-reference consumer build PASS: `BuildValidationMessage`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Feedback.EmptyState` | Build-verified | Compile empty-state recipe | Batch 2 project-reference consumer build PASS: `BuildEmptyState`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Feedback.Progress` | Build-verified | Compile progress box recipe | Batch 2 project-reference consumer build PASS: `BuildProgress`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Surface.GroupBox.Basic` | Build-verified | Compile GroupBox recipe | Batch 2 project-reference consumer build PASS: `BuildGroupBox`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Surface.Expander.Basic` | Build-verified | Compile Expander recipe | Batch 2 project-reference consumer build PASS: `BuildExpander`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Surface.Accordion.Basic` | Build-verified | Compile Accordion recipe | Batch 2 project-reference consumer build PASS: `BuildAccordion`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Surface.TileBox.Basic` | Build-verified | Compile TileBox recipe | Batch 2 project-reference consumer build PASS: `BuildTileBox`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Card.Basic` | Planned | Do not compile yet | Requires official/public hosting route decision before recipe promotion. |
| `Navigation.Tabs.Basic` | Build-verified | Compile TabControl recipe | Batch 2 project-reference consumer build PASS: `BuildTabs`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Navigation.Breadcrumb.Basic` | Build-verified | Compile Breadcrumb recipe | Batch 2 project-reference consumer build PASS: `BuildBreadcrumb`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Navigation.Pagination.Basic` | Build-verified | Compile Pagination recipe | Batch 2 project-reference consumer build PASS: `BuildPagination`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `Navigation.CommandBar.Basic` | Build-verified | Compile CommandBar/Toolbar recipe | Batch 2 project-reference consumer build PASS: `BuildCommandBar`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `DataGrid.BasicRows` | Build-verified | Compile DataGrid/DataView small rows recipe | Batch 2 project-reference consumer build PASS: `BuildCustomerGrid`; Windows result reported 2026-07-08: 196 warnings, 0 errors; quality proof PASS 15/15. |
| `DataGrid.LargeData.Boundary` | Build-verified | Compile DataView boundary pattern | Batch 3 project-reference consumer build PASS: `BuildLargeCustomerGrid`; Windows result reported 2026-07-08; quality proof PASS 15/15. |
| `Theme.Surface.Apply` | Build-verified | Compile theme/material apply recipe | Batch 3 project-reference consumer build PASS: `ApplyThemeAndSurface`; Windows result reported 2026-07-08; quality proof PASS 15/15. |
| `Theme.Surface.Options` | Build-verified | Compile selectable materials recipe | Batch 3 project-reference consumer build PASS: `GetSurfaceMaterialDisplayNames`; Windows result reported 2026-07-08; quality proof PASS 15/15. |
| `Localization.Rtl.AttachPage` | Build-verified | Compile AttachPage(window) recipe | Batch 3 project-reference consumer build PASS: `AttachLocalizationPage`; Windows result reported 2026-07-08; quality proof PASS 15/15. |
| `Localization.Rtl.AttachSection` | Build-verified | Compile AttachPage(window, page) recipe | Batch 3 project-reference consumer build PASS: `AddLocalizationSection`; Windows result reported 2026-07-08; quality proof PASS 15/15. |
| `Output.VisualCapture` | Build-verified | Compile visual capture output recipe | Batch 3 project-reference consumer build PASS: `ExportVisualCapture`; Windows result reported 2026-07-08; quality proof PASS 15/15. |
| `Output.CapabilityCatalog` | Build-verified | Compile CanExport recipe | Batch 3 project-reference consumer build PASS: `CanExportPdf`; Windows result reported 2026-07-08; quality proof PASS 15/15. |
| `Output.Manifest` | Build-verified | Compile manifest export recipe | Batch 3 project-reference consumer build PASS: `ExportOutputCatalog`; Windows result reported 2026-07-08; quality proof PASS 15/15. |
| `Verification.RenderSnapshot` | Build-verified | Compile MASRenderVerification snapshot/dashboard recipe | Batch 5 Windows build/runtime smoke PASS on 2026-07-10; direct `--snapshot-smoke` PASS with exit code 0. |
| `Product.TreeGrid.Basic` | Build-verified | Compile TreeGrid recipe | Batch 4 Windows build/runtime smoke PASS on 2026-07-10. |
| `Product.Kanban.Basic` | Build-verified | Compile KanbanBoard recipe | Batch 4 Windows build/runtime smoke PASS on 2026-07-10. |
| `Product.PivotTable.Basic` | Build-verified | Compile PivotTable recipe | Batch 4 Windows build/runtime smoke PASS on 2026-07-10. |
| `Product.Agenda.Basic` | Build-verified | Compile AgendaView recipe | Batch 4 Windows build/runtime smoke PASS on 2026-07-10. |
| `Product.Dashboard.Basic` | Build-verified | Compile DashboardGrid recipe | Batch 4 Windows build/runtime smoke PASS on 2026-07-10. |
| `Product.MasterDetail.Basic` | Build-verified | Compile MasterDetailView recipe | Batch 4 Windows build/runtime smoke PASS on 2026-07-10. |
| `Product.AppLayout.Basic` | Build-verified | Compile AppLayout recipe | Batch 4 Windows build/runtime smoke PASS on 2026-07-10. |
| `Product.SplitView.Basic` | Build-verified | Compile SplitView recipe | Batch 4 Windows build/runtime smoke PASS on 2026-07-10. |

## Batch acceptance checklist

Before marking any future batch item `Build-verified`, record:

- Windows date of the run.
- Exact command used.
- Consumer project path or harness name.
- Whether the consumer used package reference or project reference.
- Build result.
- Any warnings that matter for documentation.
- The recipe IDs covered by the run.

## Relationship to Showcase

The Showcase must not invent a parallel usage pattern. For each Showcase code panel:

1. Start from the recipe ID in [showcase-snippet-map.md](showcase-snippet-map.md).
2. Confirm the recipe is `Build-verified`.
3. Add the live scene.
4. Add the code panel.
5. Promote the recipe status to `Showcase-ready` only after both compile and live scene are true.