# Nexamas UI API Reference Coverage

This folder is the assembly-reconciled API Reference track for the public Nexamas UI surface. It is based on the compiled `Nexamas.UI.dll`, source/classification manifests, and public evidence—not on Showcase behavior.

The current compiled surface contains **302 consumer-visible CLR types**: 296 explicitly source-declared public type records plus 6 VB compiler-generated nested event delegates.
## Detailed control references

- [Buttons — source-verified reference](../controls/buttons.md)
- [Core inputs — source-verified reference](../controls/inputs.md)
- [Containers and tile surfaces — source-verified reference](../controls/containers-and-tiles.md)

## Source of truth
| Asset | Role |
|---|---|
| `eng/tests/Nexamas.UI.PublicSurfaceTypeBaseline.json` | Source-derived public type baseline. |
| `eng/tests/Nexamas.UI.PublicApiClassificationBaseline.json` | Stability category for every public type. |
| `eng/tests/Nexamas.UI.ApprovedV1PublicSurface.json` | Explicit V1-stable approval list. |
| `docs/_inventory/public-surface-inventory.md` | Human-readable public type inventory. |

## Current coverage result

| Batch | Scope | Explicit source records | Generated CLR types | Consumer-visible total | Status |
|---|---|---:|---:|---:|---|
| Batch 1 | Application facade and app-owned evidence | 71 | 6 | 77 | Assembly-reconciled |
| Batch 2 | Controls, components, and component models | 172 | 0 | 172 | Assembly-reconciled |
| Batch 3 | Data, layout, theming, localization, output, verification, compatibility | 53 | 0 | 53 | Assembly-reconciled |
| **Total** | Full public surface | **296** | **6** | **302** | **PASS** |

The reverse Phase 4 audit also confirms that all 302 types have contextual user guidance outside the generated API tables. See the [public API documentation coverage report](../../_inventory/public-api-documentation-coverage.md).

## Stability category counts
| Category | Count | Documentation meaning |
|---|---:|---|
| Stable | 117 | Approved beginner SDK candidate; V1Stable when present in the approval manifest. |
| Evidence | 10 | Diagnostics, proof, or verification-oriented public surface. |
| Advanced | 159 | Public advanced surface; document with stronger ownership boundaries. |
| Preview | 9 | Public preview surface; not a stable beginner contract. |
| Compat | 1 | Compatibility surface; do not promote as the primary adoption route. |
| Compiler-generated event delegates | 6 | Nested CLR event contracts owned by `MASApplicationWindowInput`; documented with the owner rather than independently classified. |

## Pages
- [All public types index](all-public-types-index.md)
- [Batch 1: Application facade API](application-api.md)
- [Batch 2: Controls, components, and component models API](controls-components-api.md)
- [Batch 3: Systems, evidence, and compatibility API](systems-evidence-compat-api.md)
- [Reverse public API documentation coverage](../../_inventory/public-api-documentation-coverage.md)

## Documentation rule
A type can be present in this reference without being beginner-stable. The `Category` and `V1 approval` rows must remain visible so commercial readers can distinguish stable beginner APIs from advanced, evidence, preview, and compatibility surfaces.

## Source-verified control guides

- [Navigation and command controls](../controls/navigation-and-commands.md)
- [List and tree views](../controls/list-and-tree-views.md)
- [Icon resolution surface](../icon-resolution-surface.md)
- [Data grid and list box](../controls/data-grid-and-list-box.md)
- [Media and color editing](../controls/media-and-color-editing.md)
- [Callouts, popovers, empty states, and loading skeletons](../controls/callouts-empty-states-and-loading.md)