# Nexamas UI Documentation Source of Truth

Nexamas UI documentation is derived from Nexamas UI itself, not from the Showcase.

## Evidence order

1. `Nexamas.UI.vbproj` compile entries and project settings.
2. `Nexamas.UI.nuspec`, `packages.config`, `buildTransitive/`, and release/package scripts.
3. Public and `Friend` boundaries in compiled source under `MASSystem/`, `Component/`, and `My Project/`.
4. Official application facades and gateway classes.
5. Quality, verification, test, and packaging assets under `tools/quality/`, `eng/ci/`, `eng/tests/`, and `MASSystem/Quality/`.
6. Existing documentation that is already backed by the above.
7. Showcase pages only as optional demonstration references, never as the defining source.

## Documentation pipeline

```text
Read source → build inventory → classify claim → write documentation → cross-check claim against evidence
```

## Current static evidence snapshot

- Project file: `Nexamas.UI.vbproj`
- Assembly name: `Nexamas.UI`
- Target framework: `.NET Framework 4.8`
- Active compiled source roots: `MASSystem/`, `Component/`, `My Project/`
- Package contract: `Nexamas.UI.nuspec`
- Official quality entry point documented in existing docs: `tools/quality/Run-NexamasUIQuality.ps1`

This snapshot is maintained from the current Nexamas UI source tree and must remain aligned with the checked-in project, packaging, and quality assets.

## Frozen user-documentation baseline

The Phase 6 closure baseline is machine-checkable:

- compiled VB source entries: `2,864`;
- consumer-visible CLR types: `302`;
- consumer-visible members: `4,482`;
- public API hash: `524051808614E868B41630A66A13D7B2CDE430FBC27275BF7E8668B29AF7FC84`;
- governed recipes: `41`;
- Windows build/runtime-smoke proof: `5 / 5` batches PASS;
- Render Verification snapshot smoke: PASS.

Run `tools/docs/Verify-NexamasUIDocumentationClosure.py` after any public API or documentation change. After a Windows build, `tools/docs/Invoke-NexamasUIPublicApiDrift.ps1` extracts the freshly built `Nexamas.UI.dll` metadata and fails if its hash, type count, member count, source alignment, or freshness differs from the approved baseline. Run `tools/docs/Invoke-NexamasUIDocumentationClosure.ps1 -BuildRecipes` to combine fresh recipe compilation with that assembly drift proof, or use `-RunRecipeSmokes -RunSnapshotSmoke` for full release proof. The metadata gate requires Python 3 and the pinned dependency in `tools/docs/requirements.txt`.