# Nexamas UI Documentation Claim Ledger

Every consumer/commercial claim must be backed by this ledger or by a more specific inventory created during later documentation phases.

| ID | Claim | Status | Evidence | Documented in / target | Notes |
|---|---|---|---|---|---|
| PKG-001 | Nexamas UI is packaged as a .NET Framework 4.8 library/SDK. | Verified | Nexamas.UI.vbproj; Nexamas.UI.nuspec | docs/_inventory/project-package-inventory.md; docs/adoption/package-and-delivery-model.md | Use as packaging fact, not as runtime quality proof. |
| PKG-002 | The declared binary NuGet payload is small and does not include docs/eng/samples/tools. | Verified | Nexamas.UI.nuspec | docs/_inventory/project-package-inventory.md; docs/adoption/package-and-delivery-model.md | Existing docs/QUALITY.md also describes allowlist policy. |
| SRC-001 | Active Nexamas UI source roots are MASSystem, Component, and My Project. | Verified | Nexamas.UI.vbproj compile includes; source tree | docs/_inventory/system-inventory.md | samples/MinimalConsumerApp is external sample, not compiled into SDK assembly. |
| BRAND-001 | Nexamas UI is the product name and `Nexamas.UI` is the package/assembly/namespace identity. | Verified/Product Identity | `Nexamas.UI.nuspec`; `Nexamas.UI.vbproj`; `README.md` | `docs/product/brand-and-api-identity.md`; `docs/product/platform-overview.md` | Use this as the commercial/product identity. |
| BRAND-002 | `MAS*` public identifiers are the stable Nexamas UI API/control family, part of the official Nexamas UI naming model. | Verified/Public Consumer Surface | Public types under `Nexamas.UI.*`, including `MASApplication`, `MASApplicationWindow`, `MASButton`, `MASDataGrid`, `IMASAppTheme`, and `MASSize`; `MASSystem/`; `Component/` | `docs/product/brand-and-api-identity.md`; `docs/adoption/public-surface-policy.md`; `docs/developer/quickstart-copy-paste.md` | Do not rename or hide current `MAS*` API names as part of product identity cleanup. |
| APP-001 | MASApplication is the public beginner application entry point. | Verified/Public Consumer Surface | MASSystem/Application/Facade/MASApplication.vb | docs/adoption/public-surface-policy.md; docs/product/platform-overview.md | Document Create/CreateWindow/AttachWindow only through official public API. |
| APP-002 | MASApplication exposes application-owned Theme, Sizing, and Output facades. | Verified/Public Consumer Surface | MASSystem/Application/Facade/MASApplication.vb; MASApplicationTheme.vb; MASApplicationSizing.vb; MASApplicationOutput.vb | docs/adoption/public-surface-policy.md | Do not route consumers directly to internal theme/output runtimes. |
| CTRL-001 | MASApplicationWindowControls exposes public Add* factory methods for multiple control categories. | Verified/Public Consumer Surface needs per-control review | MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory*.vb | docs/_inventory/component-factory-inventory.md | Detailed per-control docs must wait for each control verification phase. |
| LAY-001 | Nexamas UI includes a SizeLayoutSystem with public size profile, density, spacing, and inset types. | Verified/System capability | MASSystem/Layout/SizeLayoutSystem/Sizing/MASSizeSystem.vb; MASLayoutSpacingSystem.vb | docs/product/layout-system.md | Do not claim every component is fully verified until per-control audit is complete. |
| THEME-001 | MASApplication exposes a public application-owned theme facade. | Verified/Public Consumer Surface | MASSystem/Application/Facade/MASApplicationTheme.vb | docs/adoption/public-surface-policy.md | Theme Studio gateway files are Friend/internal and must not be documented as public consumer API. |
| LOC-001 | Nexamas UI contains Localization/RTL infrastructure; the broad MASLocalization gateway is Friend/internal. | Verified/Internal infrastructure | MASSystem/Localization/LocalizationSystem/Gateway/MASLocalization.vb; MASSystem/Localization | docs/product/localization-rtl-system.md | Document internal readiness separately from public RTL page attachment. |
| LOC-002 | MASLocalizationRtl exposes public page attachment methods. | Verified/Public gateway | MASSystem/Localization/LocalizationSystem/Gateway/MASLocalizationRtl.vb | docs/_inventory/official-gateway-inventory.md | Needs behavior docs only after localization/RTL phase review. |
| OUT-001 | MASApplication.Output is the public Output facade and exposes readiness, capability catalog, manifest exports, and visual capture PNG; product evidence bundles are release-evidence pipeline artifacts. | Verified/Public Consumer Surface | MASSystem/Application/Facade/Output/MASApplicationOutput.vb; docs/output/OUTPUT_PRODUCT_API.md | docs/output/OUTPUT_PRODUCT_API.md | Existing output docs honestly mark PDF/Print unavailable. |
| QUAL-001 | The official quality runner is tools/quality/Run-NexamasUIQuality.ps1. | Verified/Quality asset | docs/QUALITY.md; tools/quality/Run-NexamasUIQuality.ps1 | docs/QUALITY.md; docs/quality-proof/quality-overview.md | Build execution was not performed in this Linux sandbox. |
| RV-001 | Nexamas UI includes a Render Verification system with public snapshot/dashboard gateway types. | Verified/Public gateway + internal verification system | MASSystem/Quality/RenderVerificationSystem; MASSystem/Quality/RenderVerificationSystem/Gateway/MASRenderVerification.vb | docs/quality-proof/render-verification.md | Avoid claiming SaaS-style visual testing; describe as Nexamas UI verification infrastructure. |
| DATA-001 | MASApplicationWindowControls exposes public AddDataGrid and related data/navigation visualization factories. | Verified/Public Consumer Surface needs per-control review | MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Data.vb; Component/Data | docs/product/data-grid-virtualization-system.md | Do not claim full enterprise data platform until data phase verifies behavior. |
| SURF-001 | Surface material routing is an explicit documented product concept in README and Application facade has a surface material gateway. | Verified/System capability | README.md; MASSystem/Application/Facade/SurfaceMaterials/MASApplicationSurfaceMaterialGateway.vb; MASSystem/Visual/Surface | docs/product/theme-surface-system.md | Do not expose internal material registries as consumer API. |
| APP-003 | MASApplicationWindow is the public owner facade for one MAS window host over a WinForms owner form. | Verified/Public Consumer Surface | MASSystem/Application/Facade/MASApplicationWindow.vb | docs/product/application-window-model.md; docs/reference/application-facade-surface.md | Document typed facades; do not expose AdvancedRootHost or Friend host internals. |
| APP-004 | MASApplicationWindow exposes typed public facades for services, shell, geometry, controls, pages, input, theme, sizing, chrome, presentation, and surface material. | Verified/Public Consumer Surface | MASSystem/Application/Facade/MASApplicationWindow.vb; MASSystem/Application/Facade/MASApplicationWindow*.vb; MASSystem/Application/Presentation/MASApplicationWindowPresentation.vb | docs/_inventory/application-composition-inventory.md; docs/adoption/application-composition-model.md | Rendering/Layout/Page/Screen remain Friend/internal. |
| APP-005 | MASApplicationWindow.Controls exposes retained public layout gateways through LayoutPage and LayoutApplicationSurface. | Verified/Public Consumer Surface | MASSystem/Application/Facade/MASApplicationWindowControls.LayoutPage.vb; MASSystem/Application/Facade/MASApplicationWindowControls.ApplicationSurface.vb; MASSystem/Application/Facade/MASApplicationWindowControls.LayoutOwnership.vb | docs/adoption/application-composition-model.md; docs/developer/application-getting-started.md | LayoutRegions is Friend/internal and excluded from consumer docs. |
| APP-006 | MASApplicationPageHost is a public same-window page host for page registration/navigation over the Application surface. | Verified/Public Consumer Surface | MASSystem/Application/Facade/MASApplicationPageHost.vb; MASSystem/Application/Facade/MASApplicationPageRegistration.vb | docs/product/application-window-model.md; docs/reference/application-facade-surface.md | Describe as same-window Application page host, not as browser/router framework. |
| APP-007 | MASApplicationWindowPresentation is a public host-window presentation facade for Form size/placement/profile behavior. | Verified/Public Consumer Surface | MASSystem/Application/Presentation/MASApplicationWindowPresentation.vb; MASSystem/Application/Presentation/MASWindowPresentationProfileKind.vb | docs/reference/application-facade-surface.md | Child-control layout remains owned by MASSize/MASLayout; do not describe Presentation as content layout. |
| APP-008 | All 245 `MASSystem/Application/**/*.vb` source files are included by the project and no Application compile include points to a missing file in this static pass. | Verified/Static Project Integrity | Nexamas.UI.vbproj; MASSystem/Application source tree | docs/_inventory/application-composition-inventory.md | Static inspection only; full Windows build not executed in sandbox. |
| COMP-001 | `Component/` contains 1,305 VB source files and all are included by `Nexamas.UI.vbproj` in this static pass. | Verified/Static Project Integrity | `Component/`; `Nexamas.UI.vbproj` | `docs/_inventory/component-system-inventory.md`; `docs/product/component-system.md` | Static inspection only; no Windows build executed in sandbox. |
| COMP-002 | Nexamas UI has an Application-owned public component factory surface through `MASApplicationWindow.Controls.Add*` methods. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory*.vb` | `docs/reference/component-factory-surface.md`; `docs/developer/controls-overview.md` | This is the primary documented route for adding retained controls. |
| COMP-003 | The current public factory surface exposes 76 typed public `AddXxx` component factory methods returning 75 unique component/control types, plus generic `AddControl` and `Add` routes. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory*.vb`; `docs/_inventory/component-system-inventory.md` | `docs/product/component-system.md`; `docs/reference/component-factory-surface.md` | `AddCommandBar` and `AddToolbar` both return `MASToolbar`; `AddControl` is the generic retained route and is tracked separately. |
| COMP-004 | Built-in component architecture registration is manifest-driven through `MASArchitectureProviderManifest` and explicit provider classes. | Verified/Internal Architecture Infrastructure | `Component/Architecture/MASArchitectureProviderManifest.vb`; `Component/Architecture/MASComponent*ArchitectureProvider*.vb` | `docs/_inventory/component-system-inventory.md`; `docs/adoption/component-adoption-boundary.md` | Provider classes are Friend/internal; document as proof infrastructure, not as consumer extension API. |
| COMP-005 | Every public `Add*` component factory return type is represented by a built-in `MASComponentDescriptor` in this static pass. | Verified/Cross-check | `MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory*.vb`; `Component/Architecture/MASComponent*ArchitectureProvider*.vb` | `docs/_inventory/component-system-inventory.md`; `docs/product/component-system.md` | This does not prove per-control behavior; it proves factory/architecture registration alignment. |
| COMP-006 | Component relation declarations are split by ownership family and aggregated through `MASArchitectureProviderManifest`. | Verified/Internal Architecture Infrastructure | `Component/Architecture/MAS*RelationProvider.vb`; `Component/Architecture/MASArchitectureProviderManifest.vb` | `docs/_inventory/component-system-inventory.md`; `docs/adoption/component-adoption-boundary.md` | Relation declarations are not standalone customer-facing features. |
| LAY-002 | `MASSystem/Layout/` contains 195 VB source files and all are included by `Nexamas.UI.vbproj` in this static pass. | Verified/Static Project Integrity | `MASSystem/Layout/`; `Nexamas.UI.vbproj` | `docs/_inventory/layout-size-responsive-inventory.md`; `docs/product/layout-system.md` | Static inspection only; no Windows build executed in sandbox. |
| LAY-003 | Nexamas UI exposes a public semantic size-intent vocabulary through `MASSize`, `MASSizeIntentKind`, `MASSizeProfile`, `MASSizeProfileKind`, `MASControlDensity`, `MASLayoutSpacing`, and `MASLayoutInset`. | Verified/Public Consumer Surface | `MASSystem/Layout/SizeLayoutSystem/Sizing/MASSizeSystem.vb`; `MASLayoutSpacingSystem.vb` | `docs/reference/layout-size-surface.md`; `docs/developer/layout-and-sizing.md` | Document as consumer vocabulary; do not expose internal resolvers. |
| LAY-004 | `MASApplication.Sizing` and `MASApplicationWindow.Sizing` are public facades over the single runtime size profile owner. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/MASApplicationSizing.vb`; `MASApplicationWindowSizing.vb`; `MASRuntimeSizeProfileService.vb` | `docs/product/layout-system.md`; `docs/reference/layout-size-surface.md` | Runtime owner is `Friend`; consumers use facades. |
| LAY-005 | `MASApplicationWindow.Controls.LayoutPage(...)` is a public retained page layout gateway. | Verified/Public Consumer Surface | `MASApplicationWindowControls.LayoutPage.vb`; `MASApplicationControlsLayoutSession.vb` | `docs/product/layout-system.md`; `docs/developer/layout-and-sizing.md` | Retained session re-applies on surface measure / size-layout refresh. |
| LAY-006 | `MASApplicationWindow.Controls.LayoutApplicationSurface(...)` is a public retained semantic application-surface layout gateway. | Verified/Public Consumer Surface | `MASApplicationWindowControls.ApplicationSurface.vb`; `MASApplicationControlsApplicationSurfaceLayoutSession.vb`; `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder*.vb` | `docs/product/layout-system.md`; `docs/developer/layout-and-sizing.md` | Document command/sidebar/navigation/workspace/content/inspector/footer intent, not raw region math. |
| LAY-007 | `LayoutRegions(...)` exists but is `Friend` and should not be documented as normal public consumer API. | Verified/Internal Boundary | `MASApplicationWindowControls.LayoutRegions.vb`; `MASApplicationLayoutRegionsBuilder.vb` | `docs/adoption/layout-size-adoption-boundary.md`; `docs/reference/layout-size-surface.md` | Can be mentioned as excluded internal/advanced route only. |
| LAY-008 | `MASApplicationWindow.Geometry` exposes public DPI, viewport conversion, and layout-owned control bounds gateways. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/MASApplicationWindowGeometry.vb`; `MASLayoutSlotBoundsContracts.vb` | `docs/reference/layout-size-surface.md`; `docs/developer/layout-and-sizing.md` | Geometry roles include outer, visual, content, hit, focus, and float-anchor. |
| LAY-009 | Layout engine, responsive resolver/profile, token resolvers, and Size/Layout diagnostics are internal/Friend infrastructure rather than direct consumer API. | Verified/Internal Boundary | `MASSystem/Layout/SizeLayoutSystem/Layouting/`; `Responsive/`; `Diagnostics/`; `Integration/` | `docs/adoption/layout-size-adoption-boundary.md`; `docs/quality-proof/layout-size-contracts.md` | Use for proof and architecture docs, not as customer extension surface. |
| LAY-010 | The source tree contains internal Size/Layout audit infrastructure for lockdown, source contracts, responsive consumption, weak/bypass path detection, runtime verification, render/hit-bounds closure, and surface boundaries. | Verified/Internal Proof Infrastructure | `MASSystem/Layout/SizeLayoutSystem/Diagnostics/`; `MASLayoutSurfaceBoundaryAudit.vb` | `docs/quality-proof/layout-size-contracts.md` | This static pass confirms source existence, not gate execution results. |
| LAY-011 | Static component scan found 79 component files with public `WithSize(MASSize)`, 119 component files with intrinsic-size contract participation, and 72 component files referencing responsive layout resolver/profile infrastructure. | Verified/Static Source Signal | `Component/**/*.vb` scan | `docs/_inventory/layout-size-responsive-inventory.md` | Source signal only; not full per-control behavior proof. |
| THEME-002 | Nexamas UI exposes public theme selection through `MASApplication.Theme` and `MASApplicationWindow.Theme`. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/MASApplicationTheme.vb`; `MASApplicationWindowTheme.vb` | `docs/_inventory/theme-surface-visual-inventory.md`; `docs/product/theme-surface-system.md`; `docs/reference/theme-surface-surface.md` | Theme scope is global application in this snapshot. |
| THEME-003 | The public app theme identity contract is intentionally small: `IMASAppTheme.Id`, `DisplayName`, and `Version`. | Verified/Public Consumer Surface | `MASSystem/Visual/ThemeSystem/App/IMASAppTheme.vb` | `docs/reference/theme-surface-surface.md`; `docs/developer/theme-and-surfaces.md` | Deep foundation/family recipes remain Friend/internal. |
| THEME-004 | `ThemeManager` registers three built-in MASSignature application themes and defaults to `premium-office-mas-signature`. | Verified/Internal Registry + Public Themes | `MASSystem/Visual/ThemeSystem/App/ThemeManager.vb`; `MASSystem/Visual/ThemeSystem/ReadyThemes/MASSignature/App/*.vb` | `docs/_inventory/theme-surface-visual-inventory.md`; `docs/product/theme-surface-system.md` | Document themes by id/display name; do not invent additional theme packs. |
| THEME-005 | Theme foundation/family composition and component recipe derivation are internal Nexamas UI-owned contracts. | Verified/Internal Boundary | `IMASThemeFoundation.vb`; `IMASThemeFamilies.vb`; `MASAppThemeContracts.vb`; `ComponentsRecipeFactory/` | `docs/adoption/theme-surface-adoption-boundary.md`; `docs/quality-proof/theme-surface-governance.md` | Do not document deep recipes as normal public API. |
| SURF-002 | `MASApplicationSurfaceMaterialGateway` exposes public selectable material options and scope creation. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/SurfaceMaterials/MASApplicationSurfaceMaterialGateway.vb`; `MASApplicationSurfaceMaterialOption.vb`; `MASApplicationSurfaceMaterialScope.vb` | `docs/product/theme-surface-system.md`; `docs/reference/theme-surface-surface.md`; `docs/developer/theme-and-surfaces.md` | Consumers should obtain keys from the gateway, not internal constants. |
| SURF-003 | `MASSurfaceMaterialRegistry` registers 14 public-selectable material definitions in this source snapshot. | Verified/Internal Registry with Public Projection | `MASSystem/Visual/Surface/Material/Registry/MASSurfaceMaterialRegistry.vb` | `docs/_inventory/theme-surface-visual-inventory.md`; `docs/reference/theme-surface-surface.md` | Registry remains Friend/internal; public projection is through Application gateway. |
| SURF-004 | `MASPublicSurfaceMaterialGatewayManifest` records limited public surface-material gateways and explicitly keeps registry/renderer/frame/proof APIs internal. | Verified/Internal Policy pending Windows gate | `MASSystem/Visual/Surface/Policy/MASPublicSurfaceMaterialGatewayManifest.vb`; `MASSystem/Quality/CommercialReadiness/MASPublicSurfaceMaterialGatewayManifestGate.vb` | `docs/adoption/theme-surface-adoption-boundary.md`; `docs/quality-proof/theme-surface-governance.md` | DG-07 source update removes the stale 23-vs-20 count mismatch by deriving the expected count from manifest entries and adding a reflection-backed gate; final claim still depends on the normal quality run. |
| VIS-001 | Theme Studio and Surface Designer gateways exist but are `Friend` internal diagnostics/projection gateways, not public consumer API. | Verified/Internal Infrastructure | `MASSystem/Visual/ThemeStudioSystem/Gateway/MASThemeStudio.vb`; `MASSurfaceDesigner.vb` | `docs/_inventory/theme-surface-visual-inventory.md`; `docs/product/theme-surface-system.md`; `docs/quality-proof/theme-surface-governance.md` | Safe as product proof infrastructure, not direct subscription API. |
| VIS-002 | Nexamas UI contains visual/theme/surface governance and audit infrastructure in source. | Verified/Internal Proof Infrastructure | `MASSystem/Visual/Governance/`; `MASSystem/Visual/Surface/Governance/` | `docs/quality-proof/theme-surface-governance.md` | Source existence only; no gate execution in this Linux sandbox. |
| LOC-003 | `MASSystem/Localization/` contains 23 VB source files and all are included by `Nexamas.UI.vbproj` in this static pass. | Verified/Static Project Integrity | `MASSystem/Localization/`; `Nexamas.UI.vbproj` | `docs/_inventory/localization-rtl-inventory.md`; `docs/product/localization-rtl-system.md` | Static inspection only; no Windows build executed in sandbox. |
| LOC-004 | `MASLocalizationRtl` is the only public Localization namespace type in this source pass and exposes two public `AttachPage` overloads. | Verified/Public Consumer Surface | `MASSystem/Localization/LocalizationSystem/Gateway/MASLocalizationRtl.vb`; public type scan | `docs/reference/localization-rtl-surface.md`; `docs/developer/localization-and-rtl.md` | Document as page attachment gateway, not as translation API. |
| LOC-005 | The broad Localization foundation gateway `MASLocalization` is `Friend` and owns snapshots, culture facts, string resolution, current RTL facts, and readiness evaluation internally. | Verified/Internal Boundary | `MASSystem/Localization/LocalizationSystem/Gateway/MASLocalization.vb` | `docs/adoption/localization-rtl-adoption-boundary.md`; `docs/reference/localization-rtl-surface.md` | Do not document internal snapshot/catalog/report types as customer API. |
| LOC-006 | The deterministic product culture catalog includes `en-US`, `de-DE`, and `ar-SY`, with Arabic/Syrian marked as right-to-left and mirrored layout. | Verified/Internal Product Facts | `MASSystem/Localization/LocalizationSystem/Internal/MASLocalizationCultureCatalog.vb`; `MASLocalizationTextDirection.vb`; `MASLocalizationLayoutFlow.vb` | `docs/_inventory/localization-rtl-inventory.md`; `docs/product/localization-rtl-system.md` | Safe to describe as product profiles, not full world-culture coverage. |
| LOC-007 | The deterministic product string catalog contains 5 English/German/Arabic sample keys and generates expansion samples for German and Arabic targets. | Verified/Internal Product Facts | `MASSystem/Localization/LocalizationSystem/Internal/MASLocalizationStringCatalog.vb`; `MASLocalizationExpansionSample.vb` | `docs/_inventory/localization-rtl-inventory.md`; `docs/product/localization-rtl-system.md` | Product-layer samples only; not a public resource database. |
| LOC-008 | Localization / RTL readiness and runtime ownership proof infrastructure exists in source through `MASLocalizationReadinessGate` and `MASLocalizationRuntimeOwnershipAudit`. | Verified/Internal Proof Infrastructure | `MASSystem/Localization/LocalizationSystem/Gate/MASLocalizationReadinessGate.vb`; `MASLocalizationRuntimeOwnershipAudit.vb` | `docs/quality-proof/localization-rtl-readiness.md` | Source existence and encoded checks confirmed; gate execution not performed in this Linux sandbox. |
| LOC-009 | Render Verification inventory/target/capture code references Localization / RTL facts and `MASLocalizationRtl` as proof/integration signals. | Verified/Internal Integration Signal | `MASRenderVerificationTargetCatalog.vb`; `MASRenderVerificationInventorySnapshotBuilder.vb`; `MASRenderVerificationShowcaseCapture.BasicScenes.vb` | `docs/_inventory/localization-rtl-inventory.md`; `docs/quality-proof/localization-rtl-readiness.md` | Not consumer API; use as quality/proof context only. |
| DATA-002 | `MASSystem/Data/` contains 33 VB source files and all are included by `Nexamas.UI.vbproj` in this static pass. | Verified/Static Project Integrity | `MASSystem/Data/`; `Nexamas.UI.vbproj` | `docs/_inventory/data-virtualization-inventory.md` | All observed declarations in this root are `Friend`; do not document it as a public data API. |
| DATA-003 | `Component/Data/` contains 165 VB source files and all are included by `Nexamas.UI.vbproj` in this static pass. | Verified/Static Project Integrity | `Component/Data/`; `Nexamas.UI.vbproj` | `docs/_inventory/data-virtualization-inventory.md`; `docs/product/data-grid-virtualization-system.md` | Static inspection only; no Windows build executed in sandbox. |
| DATA-004 | `MASApplicationWindowControls.ControlFactory.Data.vb` exposes 15 public data/navigation visualization factory methods. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Data.vb` | `docs/reference/data-component-surface.md`; `docs/developer/data-grid-and-data-view.md` | Every return type has an architecture descriptor in this static pass. |
| DATA-005 | `MASDataGrid` exposes public DataGrid control capabilities for columns, rows, filtering, sorting, selection, clipboard text, editing, and DataView replacement. | Verified/Public Consumer Surface | `Component/Data/DataGrid/Control/*.vb`; `Component/Data/DataGrid/Model/*.vb` | `docs/product/data-grid-virtualization-system.md`; `docs/reference/data-component-surface.md`; `docs/developer/data-grid-and-data-view.md` | Public surface verified by source declarations, not by runtime behavior execution here. |
| DATA-006 | `MASDataView` is a public model/projection type with columns, rows, visible projection, filtering, sorting, deferred refresh, and change notification. | Verified/Public Consumer Surface | `Component/Data/DataGrid/Model/MASDataView.vb` | `docs/reference/data-component-surface.md`; `docs/developer/data-grid-and-data-view.md` | Do not extend this claim to database/ORM behavior. |
| VIRT-001 | `MASSystem/Layout/VirtualizationSystem/` contains 42 VB source files and all are included by `Nexamas.UI.vbproj` in this static pass. | Verified/Static Project Integrity | `MASSystem/Layout/VirtualizationSystem/`; `Nexamas.UI.vbproj` | `docs/_inventory/data-virtualization-inventory.md`; `docs/quality-proof/data-virtualization-readiness.md` | Static inspection only; no Windows build executed in sandbox. |
| VIRT-002 | The VirtualizationSystem declarations observed in this pass are `Friend`, making virtualization an internal Nexamas UI-owned infrastructure rather than public customer API. | Verified/Internal Boundary | `MASSystem/Layout/VirtualizationSystem/**/*.vb` public/Friend scan | `docs/adoption/data-virtualization-adoption-boundary.md`; `docs/reference/data-component-surface.md` | Document virtualization as proof/scale infrastructure, not as external SDK surface. |
| VIRT-003 | The internal virtualization consumer catalog links current consumers including `MASListBox`, `MASListView`, `MASDataGrid`, `MASTreeView`, `MASTileBox`, `MASDropDownListFloatContent`, and composed `MASFileExplorerView`. | Verified/Internal Integration Signal | `MASVirtualizationConsumerCatalog.vb`; `MASFileExplorerVirtualizationCompositionAudit.vb` | `docs/_inventory/data-virtualization-inventory.md`; `docs/product/data-grid-virtualization-system.md` | Catalog evidence only; not public API. |
| VIRT-004 | DataGrid uses a `Friend` coordinator to consume the shared virtualization controller for row realization/scroll calculations. | Verified/Internal Integration Signal | `MASDataGrid.Virtualization.vb`; `MASDataGridVirtualizationCoordinator.vb`; `MASVirtualizedItemsController.vb` | `docs/_inventory/data-virtualization-inventory.md`; `docs/quality-proof/data-virtualization-readiness.md` | Consumer should use DataGrid APIs, not virtualization classes. |
| DATA-007 | DataGrid and Virtualization readiness/proof infrastructure exists in source through internal gates, manifests, and verification catalog contribution classes. | Verified/Internal Proof Infrastructure | `MASDataGridReadinessGate.vb`; `MASDataGridCommercialRuntimeClosureManifest.vb`; `MASVirtualizationProfessionalReadinessGate.vb`; `MASVirtualizationCommercialProofGate.vb` | `docs/quality-proof/data-virtualization-readiness.md` | Source existence and encoded checks confirmed; gates were not executed in Linux sandbox. |
| OUT-002 | `MASSystem/Output` contains 38 VB source files and all are included by `Nexamas.UI.vbproj` in this static pass. | Verified/Static Project Integrity | `MASSystem/Output`; `Nexamas.UI.vbproj`; `docs/_inventory/output-system-inventory.md` | `docs/_inventory/output-system-inventory.md`; `docs/product/output-system.md` | Static inspection only; no Windows build executed in sandbox. |
| OUT-003 | `MASApplication.Output` exposes a public Application-owned Output facade with 13 public methods. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/Output/MASApplicationOutput.vb` | `docs/reference/output-surface.md`; `docs/developer/output.md` | Consumers should use this facade rather than internal runtime or foundation classes. |
| OUT-004 | The public Output product contracts expose request, result, target, options, capability, catalog, readiness, status, format, artifact, and failure reason types. | Verified/Public Consumer Surface | `MASSystem/Output/ProductSystem/Contracts/*.vb` | `docs/reference/output-surface.md`; `docs/developer/output.md` | Contract surface is public; runtime implementation remains Friend. |
| OUT-005 | The Output capability catalog declares 10 supported capabilities and 2 deliberately `NotAvailable` capabilities for PDF and printer routes. | Verified/Product Capability Catalog | `MASSystem/Output/ProductSystem/Runtime/MASOutputProductRuntime.vb` | `docs/product/output-system.md`; `docs/adoption/output-adoption-boundary.md`; `docs/reference/output-surface.md` | Do not claim production PDF or OS printing. |
| OUT-006 | Output supports memory, direct file, and directory targets with stable product file names for directory targets. | Verified/Public Consumer Surface | `MASOutputTarget.vb`; `MASOutputProductRuntime.vb` | `docs/_inventory/output-system-inventory.md`; `docs/developer/output.md` | Directory naming is stable by artifact kind/format. |
| OUT-007 | Output has an internal product evidence bundle route that can materialize capability, readiness, chart, report, visual capture, and bundle manifest artifacts for directory targets. | Verified/Release Evidence Surface | `MASApplicationOutput.vb`; `MASOutputProductRuntime.vb` | `docs/product/output-system.md`; `docs/developer/output.md` | Document as internal release evidence, not as arbitrary packaging/export framework. |
| OUT-008 | Output route governance exists as Friend/internal proof infrastructure. | Verified/Internal Quality Infrastructure | `MASSystem/Output/Governance/MASOutputApplicationRouteAudit.vb` | `docs/quality-proof/output-route-readiness.md` | Source-confirmed only; gate not executed in this Linux sandbox. |
| QUAL-002 | `MASSystem/Quality` contains 127 VB source files and all are included by `Nexamas.UI.vbproj` in this static pass. | Verified/Static Project Integrity | `MASSystem/Quality`; `Nexamas.UI.vbproj` | `docs/_inventory/quality-verification-inventory.md`; `docs/product/quality-verification-system.md` | Static inspection only; no Windows build executed in sandbox. |
| QUAL-003 | `tools/quality/Run-NexamasUIQuality.ps1` is the official commercial quality runner and references source-contract, build, runtime, startup, performance, sample, pack, and packed-consumer proof scripts. | Verified/Quality asset | `docs/QUALITY.md`; `tools/quality/Run-NexamasUIQuality.ps1`; `eng/ci`; `eng/tests`; `eng/benchmarks` | `docs/quality-proof/quality-overview.md`; `docs/quality-proof/commercial-gate.md` | Script existence was verified; execution was not performed in this Linux sandbox. |
| QUAL-004 | `eng/tests/Nexamas.UI.QualityManifest.json` declares 15 required assets and 17 orchestrated quality gates, with 0 required assets missing in this static pass. | Verified/Quality manifest | `eng/tests/Nexamas.UI.QualityManifest.json` | `docs/_inventory/quality-verification-inventory.md`; `docs/quality-proof/certification-orchestrator.md` | Manifest presence is not the same as gate execution. |
| QUAL-005 | `MASQualityOrchestrator` is an internal read-only certification/evidence aggregator, not a public consumer API. | Verified/Internal Quality Infrastructure | `MASSystem/Quality/CertificationSystem/Orchestration/MASQualityOrchestrator.vb`; `MASQualityReport.vb`; `MASQualityGateResult.vb` | `docs/quality-proof/certification-orchestrator.md`; `docs/adoption/quality-commercial-proof-boundary.md` | Document as internal proof infrastructure only. |
| RV-002 | The public Render Verification surface is limited to `MASRenderVerification`, `MASRenderVerificationSnapshot`, `MASRenderVerificationEntry`, `MASRenderVerificationProgressInfo`, and `MASRenderVerificationOutcome`. | Verified/Public Consumer Surface | `MASSystem/Quality/RenderVerificationSystem/Gateway`; `MASRenderVerificationOutcome.vb` | `docs/reference/quality-verification-surface.md`; `docs/developer/render-verification.md` | Runner/catalog/baseline/capture/diff internals remain Friend. |
| RV-003 | Render Verification contains an internal target catalog with 11 target groups, 35 explicitly declared static scenarios, and descriptor-generated scenarios from `MASComponentRegistry`. | Verified/Internal Quality Infrastructure | `MASRenderVerificationTargetCatalog.vb`; `MASRenderVerificationDescriptorScenarioPlanner`; `MASComponentRegistry` | `docs/_inventory/quality-verification-inventory.md`; `docs/quality-proof/render-verification.md` | Do not describe the catalog as a public visual-testing API. |
| PERF-001 | Nexamas UI contains internal performance proof infrastructure and a commercial performance smoke script, but performance telemetry/system types are not public consumer APIs. | Verified/Internal Quality Infrastructure | `MASSystem/Quality/PerformanceSystem`; `eng/benchmarks/Run-NexamasUIPerformanceSmoke.ps1`; `MASPerformanceSystem.vb` | `docs/product/quality-verification-system.md`; `docs/adoption/quality-commercial-proof-boundary.md` | Performance smoke was not executed in this Linux sandbox. |
| COM-001 | Nexamas UI has repository-level proprietary commercial SDK license terms and separate third-party notices. | Verified/Commercial Asset | `LICENSE.md`; `THIRD_PARTY_NOTICES.md` | `docs/commercial/licensing-and-delivery-boundary.md`; `docs/commercial/what-is-included.md` | This documents repository assets, not legal advice. Customer-specific terms still require a written order form/agreement. |
| COM-002 | Nexamas UI version `1.0.0-rc.1` is packaged as a `.NET Framework 4.8` Windows Forms/SkiaSharp desktop SDK with a small declared binary NuGet payload. | Verified/Package Contract | `Nexamas.UI.nuspec`; `package.version`; `buildTransitive/Nexamas.UI.targets`; `docs/_inventory/project-package-inventory.md` | `docs/commercial/product-brief.md`; `docs/commercial/what-is-included.md`; `docs/commercial/company-evaluation-guide.md` | Do not claim cross-platform/.NET 6+/x86 support from this snapshot. |
| COM-003 | `buildTransitive/Nexamas.UI.targets` records and enforces the supported framework envelope for consuming projects. | Verified/Package Guard | `buildTransitive/Nexamas.UI.targets` | `docs/_inventory/commercial-adoption-inventory.md`; `docs/commercial/company-evaluation-guide.md`; `docs/commercial/stability-and-roadmap-boundary.md` | Safe to document as compatibility guard evidence. |
| COM-004 | Nexamas UI can be offered under subscription/recurring-license terms at the contract/delivery level, but no runtime billing, online activation, or license-server system is documented from code in this snapshot. | Verified/Commercial Boundary | `LICENSE.md` sections 6 and 11; static source search for subscription/billing/activation/license-key terms | `docs/commercial/subscription-readiness.md` | Subscription is a business/order-form model here, not a runtime SDK feature. |
| COM-005 | Commercial product documentation may safely present Nexamas UI as a proprietary Windows desktop UI SDK with verified Application, component, layout, theme/surface, localization/RTL, data, output, and quality/proof pillars. | Verified/Commercial Summary | Phase 1-8 inventories under `docs/_inventory/` | `docs/commercial/product-brief.md`; `docs/commercial/commercial-adoption-guide.md` | Each pillar must keep its system-specific exclusions and public/internal boundaries. |
| COM-006 | Nexamas UI defines a seven-day non-production evaluation term as a legal/commercial policy, while this source snapshot does not implement runtime activation or automatic expiration. | Verified/Commercial Boundary | `LICENSE.md` section 2; `docs/commercial/pricing-and-evaluation.md`; static source search for activation/license-server terms | `docs/commercial/pricing-and-evaluation.md`; `docs/commercial/licensing-and-delivery-boundary.md`; `docs/commercial/subscription-readiness.md` | Evaluation is contract-defined; do not claim automatic seven-day runtime enforcement from this snapshot. |
| DOC-001 | Nexamas UI includes a static documentation governance gate for code-first documentation consistency. | Verified/Documentation Governance Asset | `tools/docs/Invoke-NexamasUIDocumentationGate.ps1`; `docs/_inventory/documentation-governance-inventory.md` | `docs/quality-proof/documentation-governance.md`; `docs/reference/documentation-gate.md` | This gate validates documentation structure and evidence references; it does not compile or validate runtime behavior. |
| DOC-002 | Nexamas UI documentation files are product/repository assets and must not be included as `Compile` items in `Nexamas.UI.vbproj`. | Verified/Documentation Compile Boundary | `Nexamas.UI.vbproj`; `tools/docs/Invoke-NexamasUIDocumentationGate.ps1`; static project inspection | `docs/_inventory/documentation-governance-inventory.md`; `docs/developer/maintaining-documentation.md`; `docs/quality-proof/documentation-governance.md` | Documentation may be tracked in source control, optionally included as `None`, or selectively packaged through `.nuspec`; it must not compile into `Nexamas.UI.dll`. |
| DOC-003 | Nexamas UI now has a Documentation Center index and audience-specific entry pages for customer, company adoption, developer, quality proof, and reference readers. | Verified/Documentation Packaging Asset | `docs/index.md`; `docs/customer-guide.md`; `docs/company-adoption-guide.md`; `docs/developer-guide.md`; `docs/quality-proof-guide.md`; `docs/reference-guide.md` | `docs/index.md`; `docs/_inventory/release-documentation-pack.md`; `docs/_inventory/documentation-status.md` | This is navigation/packaging documentation only; it adds no product capability claim. |
| DOC-004 | Nexamas UI includes a curated `release-docs/` commercial reading pack derived from the code-first documentation center. | Verified/Documentation Packaging Asset | `release-docs/README.md`; `release-docs/NexamasUI_Product_Brief.md`; `release-docs/NexamasUI_Adoption_Guide.md`; `release-docs/NexamasUI_Quality_Proof.md`; `release-docs/NexamasUI_Documentation_Pack_Manifest.md` | `docs/_inventory/release-documentation-pack.md`; `docs/_inventory/package-documentation-boundary.md` | `release-docs/` is not the source of truth and is not included in the current NuGet nuspec payload. |
| DOC-005 | The current documentation packaging policy separates repository docs, curated release docs, and NuGet/package docs, with Markdown excluded from compilation. | Verified/Documentation Package Boundary | `Nexamas.UI.nuspec`; `Nexamas.UI.vbproj`; `docs/_inventory/package-documentation-boundary.md`; `tools/docs/Invoke-NexamasUIDocumentationGate.ps1` | `docs/_inventory/package-documentation-boundary.md`; `docs/reference/documentation-gate.md`; `docs/developer/maintaining-documentation.md` | Full docs may remain source-controlled; selective package inclusion is a deliberate commercial decision. |
| EX-001 | Nexamas UI documentation includes public copy-paste examples for the application/window entry path. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/MASApplication.vb`; `MASSystem/Application/Facade/MASApplicationWindow.vb`; `samples/MinimalConsumerApp/MainForm.vb` | `docs/_inventory/developer-examples-inventory.md`; `docs/examples/application-window-quickstart.md`; `docs/developer/quickstart-copy-paste.md` | Examples use `MASApplication` and `MASApplicationWindow`, not raw host internals. |
| EX-002 | Nexamas UI documentation includes public layout examples using `LayoutPage` and `LayoutApplicationSurface`. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/MASApplicationWindowControls.LayoutPage.vb`; `MASSystem/Application/Facade/MASApplicationWindowControls.ApplicationSurface.vb`; `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb`; `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder*.vb` | `docs/examples/layout-page-example.md`; `docs/examples/application-surface-example.md`; `docs/developer/common-consumer-patterns.md` | Examples avoid consumer-owned manual coordinate systems. |
| EX-003 | Nexamas UI documentation includes public theme and surface-material examples. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/MASApplicationTheme.vb`; `MASSystem/Application/Facade/MASApplicationWindowTheme.vb`; `MASSystem/Application/Facade/SurfaceMaterials/MASApplicationSurfaceMaterialGateway.vb`; `MASSystem/Application/Facade/SurfaceMaterials/MASApplicationSurfaceMaterialScope.vb` | `docs/examples/theme-surface-example.md`; `docs/developer/common-consumer-patterns.md` | Theme Studio and Surface Designer remain excluded as Friend/internal. |
| EX-004 | Nexamas UI documentation includes a public DataGrid/DataView example. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Data.vb`; `Component/Data/DataGrid/Control/MASDataGrid.vb`; `Component/Data/DataGrid/Model/MASDataView.vb` | `docs/examples/datagrid-example.md`; `docs/developer/quickstart-copy-paste.md` | Shared virtualization internals remain excluded. |
| EX-005 | Nexamas UI documentation includes public Output examples and explicitly preserves the PDF/print unsupported boundary. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/Output/MASApplicationOutput.vb`; `MASSystem/Output/ProductSystem/Contracts/MASOutputRequest.vb`; `MASSystem/Output/ProductSystem/Contracts/MASOutputResult.vb` | `docs/examples/output-example.md`; `docs/developer/consumer-do-and-dont.md` | Output examples instruct capability checks before presenting export UI. |
| EX-006 | Nexamas UI documentation includes public Render Verification examples through the official gateway. | Verified/Public Consumer Surface | `MASSystem/Quality/RenderVerificationSystem/Gateway/MASRenderVerification.vb`; `MASSystem/Quality/RenderVerificationSystem/Gateway/MASRenderVerificationSnapshot.vb` | `docs/examples/render-verification-example.md`; `docs/developer/common-consumer-patterns.md` | Capture handlers, baseline stores, runners, and target catalogs remain internal. |
| EX-007 | Nexamas UI documentation includes a public Localization / RTL page attachment example. | Verified/Public Consumer Surface | `MASSystem/Localization/LocalizationSystem/Gateway/MASLocalizationRtl.vb` | `docs/examples/localization-rtl-page-example.md`; `docs/developer/common-consumer-patterns.md` | This is page attachment, not a public translation/resource engine. |
| EX-008 | Nexamas UI documentation now defines consumer example do/don't rules. | Verified/Documentation Governance | `docs/_inventory/developer-examples-inventory.md`; `docs/developer/consumer-do-and-dont.md` | `docs/developer/consumer-do-and-dont.md`; `docs/examples/README.md` | New examples must remain public API only and source-evidence backed. |
| VAL-001 | Nexamas UI includes a maintainer-facing Windows validation runner that coordinates documentation validation and existing quality validation modes. | Verified/Validation Tooling Asset | `tools/validation/Invoke-NexamasUIWindowsValidation.ps1`; `tools/docs/Invoke-NexamasUIDocumentationGate.ps1`; `tools/quality/Run-NexamasUIQuality.ps1` | `docs/_inventory/windows-validation-inventory.md`; `docs/developer/windows-validation-runbook.md`; `docs/reference/windows-validation-runner.md` | This is a release/maintainer tool, not a public runtime SDK API. |
| VAL-002 | Full release validation for this project must be executed on Windows because the SDK targets .NET Framework 4.8/WinForms and build/runtime/package gates require that environment. | Verified/Validation Boundary | `Nexamas.UI.nuspec`; `buildTransitive/Nexamas.UI.targets`; `tools/quality/Run-NexamasUIQuality.ps1`; `docs/_inventory/commercial-adoption-inventory.md` | `docs/quality-proof/windows-validation.md`; `docs/developer/windows-validation-runbook.md` | This Linux sandbox cannot produce a real Windows build PASS claim. |
| VAL-003 | The phase 13 source snapshot removes local/generated artifacts rejected by the commercial gate: `Nexamas.UI.vbproj.user`, sample `bin/`, and sample `obj/`. | Verified/Source Distribution Cleanup | `eng/ci/Invoke-NexamasUICommercialGate.ps1`; static project snapshot inspection | `docs/_inventory/windows-validation-inventory.md`; `docs/developer/windows-validation-runbook.md` | Commercial gate still must be run on Windows for release proof. |
| DOC-006 | Nexamas UI documents the eight product-size controls with explicit CompactPreview / ProductionReady stage boundaries. | Verified/Documentation Governance Asset | `docs/product/product-controls/README.md`; `MASSystem/Quality/CommercialReadiness/MASDocumentationSampleEvidenceGate.vb` | `docs/product/product-controls/README.md`; `docs/quality-proof/product-controls-evidence-pack.md` | This adds documentation/evidence governance and preserves the targeted DashboardGrid/MasterDetailView/AppLayout/SplitView ProductionReady promotions declared by the readiness matrix. |
| EX-009 | Nexamas UI includes consumer-safe sample pages for the eight product-size controls using public add gateways only. | Verified/Public Consumer Surface | `MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Data.vb`; `MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Containers.vb`; `docs/examples/product-controls/README.md` | `docs/examples/product-controls/README.md` | Friend/internal source, window, and proof APIs remain excluded from consumer samples. |
| QUAL-006 | Commercial readiness now includes a documentation/sample evidence gate for the eight product-size controls. | Verified/Quality Governance Asset | `MASSystem/Quality/CommercialReadiness/MASDocumentationSampleEvidenceGate.vb`; `MASSystem/Quality/CommercialReadiness/MASDocumentationSampleEvidenceManifest.vb`; `MASSystem/Quality/CommercialReadiness/MASCommercialReadinessGate.vb`; `MASSystem/Quality/CommercialReadiness/MASProductionPromotionRuleGate.vb` | `docs/quality-proof/product-controls-evidence-pack.md`; `docs/reference/documentation-gate.md` | This gate validates governance claims and boundaries; measured runtime benchmarks remain a separate stage. |
| DOC-007 | Nexamas UI includes a practical Core Documentation section that connects the public application, layout, controls, theme, data, localization, motion, diagnostics, and packaging routes into a v1 consumer reading path. | Verified/Documentation Packaging Asset | `docs/core/README.md`; `docs/core/application-and-window-lifetime.md`; `docs/core/layout-and-composition.md`; `docs/core/controls-and-component-factories.md`; `docs/core/theme-and-surface-materials.md`; `docs/core/datagrid-and-dataview.md`; `docs/core/localization-and-rtl.md`; `docs/core/motion-behavior.md`; `docs/core/diagnostics-and-quality-proof.md`; `docs/core/packaging-and-external-consumer-use.md` | `docs/core/README.md`; `docs/index.md`; `docs/developer-guide.md` | This is a documentation integration layer over already verified public surfaces; it does not add runtime API or make Friend/internal systems public. |
| DOC-008 | The assembly-reconciled Nexamas UI user documentation covers all 302 consumer-visible CLR types and is frozen against a 4,482-member public surface hash. | Verified/Documentation Closure | `docs/_inventory/assembly-api/public-api-assembly.json`; `docs/_inventory/public-api-documentation-coverage.csv`; `tools/docs/Verify-NexamasUIDocumentationClosure.py` | `docs/_inventory/phase6-user-documentation-closure.md`; `docs/reference/public-api-v1.md` | This is type/member surface and contextual coverage proof, not exhaustive behavior proof for every state. |
| DOC-009 | All 41 governed documentation recipes built and completed their normal runtime smoke on Windows, and the Render Verification snapshot smoke passed separately. | Verified/Windows Consumer Proof | `docs/_inventory/windows-proof/documentation-snippet-proof-2026-07-10.json`; `docs/_inventory/windows-proof/render-snapshot-smoke-proof-2026-07-10.json`; `eng/tests/Run-NexamasUIDocumentationSnippetProof.ps1`; `eng/tests/Run-NexamasUIRenderSnapshotSmoke.ps1` | `docs/quality-proof/documentation-recipes-windows-pass-2026-07-10.md`; `docs/recipes/build-verification-ledger.md`; `docs/_inventory/phase5-documentation-build-runtime-audit.md` | Build/runtime smoke proof applies to the governed recipes and does not imply Showcase-ready status. |