# Quality / Verification Surface Reference

This reference lists the source-verified public and internal quality surfaces observed during Phase 8.

## Public namespace surface

Namespace: `Nexamas.UI.Verification`

| Type | Public role | Evidence |
|---|---|---|
| `MASRenderVerification` | Public static gateway for product-proof snapshots and dashboard attachment. | `MASSystem/Quality/RenderVerificationSystem/Gateway/MASRenderVerification.vb` |
| `MASRenderVerificationSnapshot` | Immutable snapshot containing output directories, counts, entry list, and aggregate status. | `MASSystem/Quality/RenderVerificationSystem/Gateway/MASRenderVerificationSnapshot.vb` |
| `MASRenderVerificationEntry` | Immutable entry for one scenario, with target/scenario identity, dimensions, outcome, diff facts, and image paths. | `MASSystem/Quality/RenderVerificationSystem/Gateway/MASRenderVerificationEntry.vb` |
| `MASRenderVerificationProgressInfo` | Progress report contract for snapshot generation. | `MASSystem/Quality/RenderVerificationSystem/Gateway/MASRenderVerificationProgressInfo.vb` |
| `MASRenderVerificationOutcome` | Scenario outcome enum: `Passed`, `BaselineSeeded`, `Failed`, `Invalid`. | `MASSystem/Quality/RenderVerificationSystem/Contracts/MASRenderVerificationOutcome.vb` |

## `MASRenderVerification` public members

| Member | Meaning |
|---|---|
| `CreateSnapshot(Optional outputDirectory As String = Nothing, Optional progress As IProgress(Of MASRenderVerificationProgressInfo) = Nothing, Optional themeId As String = Nothing) As MASRenderVerificationSnapshot` | Creates product-proof output assets and returns the immutable snapshot model. |
| `AttachDashboard(window As MASApplicationWindow, Optional outputDirectory As String = Nothing, Optional themeId As String = Nothing) As IDisposable` | Builds and attaches the official Render Verification dashboard to a MAS application window. |
| `AttachDashboard(window As MASApplicationWindow, page As MASApplicationLayoutPageBuilder, Optional outputDirectory As String = Nothing, Optional themeId As String = Nothing) As IDisposable` | Builds dashboard content inside an existing Application page-builder scope. |

## Snapshot data available to consumers

`MASRenderVerificationSnapshot` exposes:

- output, baseline, current, and difference directories,
- capture timestamp,
- entries,
- entry, passed, seeded, failed, invalid, and review counts,
- `RequiresApproval`, `Passed`, and `HasPreviewImages` aggregate facts.

`MASRenderVerificationEntry` exposes:

- target/scenario/display identity,
- component/state/theme keys,
- DPI and pixel dimensions,
- outcome,
- pixel and diff facts,
- message,
- baseline/current/difference image paths,
- convenience booleans for pass/review/invalid/image availability,
- bitmap loading helpers for baseline/current/difference images.

## Internal surfaces not documented as consumer APIs

The following are source-visible but `Friend`/internal and must not be documented as public consumer API:

- `MASRenderVerificationRunner`
- `MASRenderVerificationRunResult`
- `MASRenderVerificationOptions`
- `MASRenderVerificationTarget`
- `MASRenderVerificationScenario`
- `MASRenderVerificationTargetCatalog`
- `MASRenderVerificationCaptureSceneRegistry`
- `MASRenderVerificationShowcaseCapture`
- `MASRenderBaselineStore`
- `MASRenderImageComparer`
- `MASRenderDifferenceImageWriter`
- `MASRenderVerificationGate`
- `MASQualityOrchestrator`
- `MASQualityReport`
- `MASQualityGateResult`
- `NexamasUICertification`
- `MASDiagnosticsDashboard`
- `MASPerformanceSystem`

## Quality scripts

Quality scripts are source-distribution assets, not binary public APIs:

- `tools/quality/Run-NexamasUIQuality.ps1`
- `eng/ci/Invoke-NexamasUICommercialGate.ps1`
- `eng/tests/Run-NexamasUITestSuite.ps1`
- `eng/tests/Run-NexamasUISdkHarness.ps1`
- `eng/benchmarks/Run-NexamasUIStartupProbe.ps1`
- `eng/benchmarks/Run-NexamasUIPerformanceSmoke.ps1`
- `eng/tests/Run-NexamasUISampleProof.ps1`
- `eng/ci/Pack-Nexamas.UI.ps1`
- `eng/ci/Test-NexamasUIPackedConsumer.ps1`