# Batch 1 — Application Facade API Reference

This page documents the compiled consumer-visible type surface in `Nexamas.UI.Application`. Source evidence is retained for explicitly declared types, while compiler-generated nested event delegates are identified separately.

## Batch status

| Item | Value |
|---|---|
| Explicitly source-declared types | `71` |
| Compiler-generated public nested delegates | `6` |
| Consumer-visible CLR types in namespace | `77` |
| Stable types | `68` |
| Evidence types | `3` |
| V1-approved types | `68` |
| Verification | Member tables reconciled with compiled `Nexamas.UI.dll`; public API hash `524051808614E868B41630A66A13D7B2CDE430FBC27275BF7E8668B29AF7FC84`. |

## How to use this page

Use the Application facade first: `MASApplication.Create()`, `CreateWindow(...)`, `window.Controls`, `window.Services`, `window.Theme`, `window.Sizing`, and the documented layout builders. Direct access to internal root-host, rendering, or layout owner types remains outside the consumer API route.

## Primary consumer flow

```vb
Dim app = MASApplication.Create()
Using window = app.CreateWindow(ownerForm)
    window.Controls.AddButton("Save")
    window.Setup()
End Using
```

## Classes and DTOs

### `MASApplication`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplication.vb:19` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Creates and owns the top-level Nexamas UI application facade, theme/sizing/output services, and tracked windows.

**When to use it.** Start here for every consumer application that uses the official window-owned SDK route.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `AttachWindow` | Function | `Public Shared Function AttachWindow(owner As Form, Optional dockStyle As DockStyle = DockStyle.Fill, Optional autoHookPointerInput As Boolean = True, Optional setupImmediately As Boolean = True, Optional rebuildCallback As Action = Nothing, Optional configure As Action(Of MASApplicationWindow) = Nothing) As MASApplicationWindow` |
| `ConfigureRuntime` | Sub | `Public Shared Sub ConfigureRuntime(Optional writeArchitectureReportsOnStartup As Boolean = False, Optional writeDeepArchitectureReportsOnStartup As Boolean = False, Optional registerDefaultIconCatalogOnStartup As Boolean = True, Optional enableDiagnosticsDiskLogging As Boolean = False, Optional throwOnSwallowedException As Boolean = False, Optional throwOnLifecycleBreakingException As Boolean = False, Optional traceRepeatedBoundaryExceptions As Boolean = False, Optional failFastOnContractlessControlConstruction As Boolean = False)` |
| `CreateWindow` | Function | `Public Function CreateWindow(owner As Form, Optional dockStyle As DockStyle = DockStyle.Fill, Optional autoHookPointerInput As Boolean = True, Optional setupImmediately As Boolean = True, Optional rebuildCallback As Action = Nothing) As MASApplicationWindow` |
| `Create` | Function | `Public Shared Function Create() As MASApplication` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `Refresh` | Sub | `Public Sub Refresh()` |
| `Diagnostics` | Property | `Public Shared ReadOnly Property Diagnostics As MASApplicationDiagnostics` |
| `IsDisposed` | Property | `Public ReadOnly Property IsDisposed As Boolean` |
| `Output` | Property | `Public ReadOnly Property Output As MASApplicationOutput` |
| `Sizing` | Property | `Public ReadOnly Property Sizing As MASApplicationSizing` |
| `Theme` | Property | `Public ReadOnly Property Theme As MASApplicationTheme` |
| `WindowCount` | Property | `Public ReadOnly Property WindowCount As Integer` |

**Minimal usage shape.**

```vb
Dim app = MASApplication.Create()
Using window = app.CreateWindow(ownerForm)
    window.Setup()
End Using
```

### `MASApplicationActionGroupLayoutBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationControlsActionGroupLayout.vb:26` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Provides a fluent builder for an Application-owned layout or surface composition route.

**When to use it.** Use it inside `window.Controls.LayoutPage(...)` or another documented Application layout gateway.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Add` | Function | `Public Function Add(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationActionGroupLayoutBuilder` |
| `AlignCenter` | Function | `Public Function AlignCenter() As MASApplicationActionGroupLayoutBuilder` |
| `AlignEnd` | Function | `Public Function AlignEnd() As MASApplicationActionGroupLayoutBuilder` |
| `AlignStart` | Function | `Public Function AlignStart() As MASApplicationActionGroupLayoutBuilder` |
| `Align` | Function | `Public Function Align(alignment As MASApplicationActionGroupAlignment) As MASApplicationActionGroupLayoutBuilder` |
| `EqualItemSize` | Function | `Public Function EqualItemSize() As MASApplicationActionGroupLayoutBuilder` |
| `EqualItemWidth` | Function | `Public Function EqualItemWidth() As MASApplicationActionGroupLayoutBuilder` |
| `Gap` | Function | `Public Function Gap(value As MASLayoutSpacing) As MASApplicationActionGroupLayoutBuilder` |
| `IntrinsicItemSize` | Function | `Public Function IntrinsicItemSize() As MASApplicationActionGroupLayoutBuilder` |
| `Padding` | Function | `Public Function Padding(value As MASLayoutSpacing) As MASApplicationActionGroupLayoutBuilder` |
| `Spacing` | Function | `Public Function Spacing(value As MASLayoutSpacing) As MASApplicationActionGroupLayoutBuilder` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationClosedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationClosedEventArgs.vb:12` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Carries typed data for an Application facade operation, result, option set, or notification.

**When to use it.** Use it with the owning Application/window service instead of building an unrelated custom DTO.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CloseReason` | Property | `Public ReadOnly Property CloseReason As MASApplicationCloseReason` |
| `Failed` | Property | `Public ReadOnly Property Failed As Boolean` |
| `Handle` | Property | `Public ReadOnly Property Handle As MASApplicationSurfaceHandle` |
| `OwnerKey` | Property | `Public ReadOnly Property OwnerKey As String` |
| `Result` | Property | `Public ReadOnly Property Result As MASApplicationResult` |
| `SurfaceKey` | Property | `Public ReadOnly Property SurfaceKey As String` |
| `WasAccepted` | Property | `Public ReadOnly Property WasAccepted As Boolean` |
| `WasCancelled` | Property | `Public ReadOnly Property WasCancelled As Boolean` |
| `WasDismissed` | Property | `Public ReadOnly Property WasDismissed As Boolean` |

**Minimal usage shape.**

```vb
' This type is normally received from, or passed into, the owning Application facade.
' Prefer the documented window/app service instead of standalone construction.
```

### `MASApplicationDiagnostics`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Evidence` |
| V1 approval | `Not V1-approved` |
| Evidence | `MASSystem/Application/Facade/MASApplicationDiagnostics.vb:18` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Part of the Application namespace public surface recorded in the source-derived API manifests.

**When to use it.** Use it only through the owning Application/window workflow documented by the related recipes.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `GetSnapshot` | Function | `Public Function GetSnapshot(Optional maxRecentFaults As Integer = 32) As MASApplicationDiagnosticsSnapshot` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

**Boundary.** This type is classified as `Evidence`. Do not present it as beginner-stable V1 API unless the approval manifest is updated.

### `MASApplicationDiagnosticsFaultSummary`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Evidence` |
| V1 approval | `Not V1-approved` |
| Evidence | `MASSystem/Application/Facade/MASApplicationDiagnosticsFaultSummary.vb:16` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Carries typed data for an Application facade operation, result, option set, or notification.

**When to use it.** Use it with the owning Application/window service instead of building an unrelated custom DTO.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Category` | Property | `Public ReadOnly Property Category As String` |
| `Context` | Property | `Public ReadOnly Property Context As String` |
| `ExceptionTypeName` | Property | `Public ReadOnly Property ExceptionTypeName As String` |
| `IsFirstOccurrence` | Property | `Public ReadOnly Property IsFirstOccurrence As Boolean` |
| `Message` | Property | `Public ReadOnly Property Message As String` |
| `OccurrenceCount` | Property | `Public ReadOnly Property OccurrenceCount As Integer` |
| `Severity` | Property | `Public ReadOnly Property Severity As String` |
| `TimestampUtc` | Property | `Public ReadOnly Property TimestampUtc As System.DateTimeOffset` |

**Minimal usage shape.**

```vb
' This type is normally received from, or passed into, the owning Application facade.
' Prefer the documented window/app service instead of standalone construction.
```

**Boundary.** This type is classified as `Evidence`. Do not present it as beginner-stable V1 API unless the approval manifest is updated.

### `MASApplicationDiagnosticsSnapshot`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Evidence` |
| V1 approval | `Not V1-approved` |
| Evidence | `MASSystem/Application/Facade/MASApplicationDiagnosticsSnapshot.vb:17` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Carries typed data for an Application facade operation, result, option set, or notification.

**When to use it.** Use it with the owning Application/window service instead of building an unrelated custom DTO.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `BoundaryFailureCount` | Property | `Public ReadOnly Property BoundaryFailureCount As Integer` |
| `CapturedUtc` | Property | `Public ReadOnly Property CapturedUtc As System.DateTimeOffset` |
| `ClipboardBoundaryCount` | Property | `Public ReadOnly Property ClipboardBoundaryCount As Integer` |
| `CriticalStateTransitionCount` | Property | `Public ReadOnly Property CriticalStateTransitionCount As Integer` |
| `DiagnosticOnlyCount` | Property | `Public ReadOnly Property DiagnosticOnlyCount As Integer` |
| `DiagnosticsDiskLoggingEnabled` | Property | `Public ReadOnly Property DiagnosticsDiskLoggingEnabled As Boolean` |
| `DisposeCleanupCount` | Property | `Public ReadOnly Property DisposeCleanupCount As Integer` |
| `FileSystemBoundaryCount` | Property | `Public ReadOnly Property FileSystemBoundaryCount As Integer` |
| `HasFaults` | Property | `Public ReadOnly Property HasFaults As Boolean` |
| `InputBoundaryCount` | Property | `Public ReadOnly Property InputBoundaryCount As Integer` |
| `IsReadOnlySnapshot` | Property | `Public ReadOnly Property IsReadOnlySnapshot As Boolean` |
| `LifecycleBreakingCount` | Property | `Public ReadOnly Property LifecycleBreakingCount As Integer` |
| `MostRecentFault` | Property | `Public ReadOnly Property MostRecentFault As MASApplicationDiagnosticsFaultSummary` |
| `NativeInteropCount` | Property | `Public ReadOnly Property NativeInteropCount As Integer` |
| `RecentFaults` | Property | `Public ReadOnly Property RecentFaults As IReadOnlyList(Of MASApplicationDiagnosticsFaultSummary)` |
| `RecoverableCount` | Property | `Public ReadOnly Property RecoverableCount As Integer` |
| `RenderFallbackCount` | Property | `Public ReadOnly Property RenderFallbackCount As Integer` |
| `RetainedFaultCount` | Property | `Public ReadOnly Property RetainedFaultCount As Integer` |
| `TextShapingFallbackCount` | Property | `Public ReadOnly Property TextShapingFallbackCount As Integer` |
| `ThrowOnLifecycleBreakingException` | Property | `Public ReadOnly Property ThrowOnLifecycleBreakingException As Boolean` |
| `ThrowOnSwallowedException` | Property | `Public ReadOnly Property ThrowOnSwallowedException As Boolean` |
| `TraceRepeatedBoundaryExceptions` | Property | `Public ReadOnly Property TraceRepeatedBoundaryExceptions As Boolean` |

**Minimal usage shape.**

```vb
' This type is normally received from, or passed into, the owning Application facade.
' Prefer the documented window/app service instead of standalone construction.
```

**Boundary.** This type is classified as `Evidence`. Do not present it as beginner-stable V1 API unless the approval manifest is updated.

### `MASApplicationDialogShieldOptions`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationDialogShieldOptions.vb:12` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Carries typed data for an Application facade operation, result, option set, or notification.

**When to use it.** Use it with the owning Application/window service instead of building an unrelated custom DTO.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(mode As MASApplicationDialogShieldMode)` |
| `Clone` | Function | `Public Function Clone() As MASApplicationDialogShieldOptions` |
| `AllowCancel` | Property | `Public Property AllowCancel As Boolean` |
| `AllowCloseAll` | Property | `Public Property AllowCloseAll As Boolean` |
| `AllowEscape` | Property | `Public Property AllowEscape As Boolean` |
| `AllowOutsideDismiss` | Property | `Public Property AllowOutsideDismiss As Boolean` |
| `AllowReplace` | Property | `Public Property AllowReplace As Boolean` |
| `BlockHigherLayer` | Property | `Public Property BlockHigherLayer As Boolean` |
| `Mode` | Property | `Public Property Mode As MASApplicationDialogShieldMode` |
| `None` | Property | `Public Shared ReadOnly Property None As MASApplicationDialogShieldOptions` |
| `Reason` | Property | `Public Property Reason As MASApplicationDialogShieldReason` |

**Minimal usage shape.**

```vb
Dim options As New MASApplicationDialogShieldOptions()
options.Mode = MASApplicationDialogShieldMode.Modal
' Pass options into the documented dialog route that owns the operation.
```

### `MASApplicationFileExplorerOptions`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationFileExplorerOptions.vb:14` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Carries typed data for an Application facade operation, result, option set, or notification.

**When to use it.** Use it with the owning Application/window service instead of building an unrelated custom DTO.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Clone` | Function | `Public Function Clone() As MASApplicationFileExplorerOptions` |
| `AcceptOnItemActivated` | Property | `Public Property AcceptOnItemActivated As Boolean` |
| `ConfigureExplorer` | Property | `Public Property ConfigureExplorer As Action(Of MASFileExplorerView)` |
| `InitialFolder` | Property | `Public Property InitialFolder As MASFileExplorerItem` |
| `InitialViewMode` | Property | `Public Property InitialViewMode As MASListViewMode` |
| `Root` | Property | `Public Property Root As MASFileExplorerItem` |
| `SearchPlaceholder` | Property | `Public Property SearchPlaceholder As String` |
| `ShowCloseButton` | Property | `Public Property ShowCloseButton As Boolean` |
| `UseDefaultComputerRoot` | Property | `Public Property UseDefaultComputerRoot As Boolean` |

**Minimal usage shape.**

```vb
' This type is normally received from, or passed into, the owning Application facade.
' Prefer the documented window/app service instead of standalone construction.
```

### `MASApplicationFileExplorerResult`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationFileExplorerResult.vb:13` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Carries typed data for an Application facade operation, result, option set, or notification.

**When to use it.** Use it with the owning Application/window service instead of building an unrelated custom DTO.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CurrentDisplayPath` | Property | `Public ReadOnly Property CurrentDisplayPath As String` |
| `CurrentFolder` | Property | `Public ReadOnly Property CurrentFolder As MASFileExplorerItem` |
| `CurrentPath` | Property | `Public ReadOnly Property CurrentPath As String` |
| `SelectedItems` | Property | `Public ReadOnly Property SelectedItems As IReadOnlyList(Of MASFileExplorerItem)` |
| `SelectedItem` | Property | `Public ReadOnly Property SelectedItem As MASFileExplorerItem` |

**Minimal usage shape.**

```vb
' This type is normally received from, or passed into, the owning Application facade.
' Prefer the documented window/app service instead of standalone construction.
```

### `MASApplicationFilterBarLayoutBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationControlsFilterFormLayout.vb:38` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Provides a fluent builder for an Application-owned layout or surface composition route.

**When to use it.** Use it inside `window.Controls.LayoutPage(...)` or another documented Application layout gateway.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Add` | Function | `Public Function Add(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationFilterBarLayoutBuilder` |
| `AlignCenter` | Function | `Public Function AlignCenter() As MASApplicationFilterBarLayoutBuilder` |
| `AlignEnd` | Function | `Public Function AlignEnd() As MASApplicationFilterBarLayoutBuilder` |
| `AlignStart` | Function | `Public Function AlignStart() As MASApplicationFilterBarLayoutBuilder` |
| `Align` | Function | `Public Function Align(alignment As MASApplicationFilterBarAlignment) As MASApplicationFilterBarLayoutBuilder` |
| `ApplyAction` | Function | `Public Function ApplyAction(Optional text As String = Nothing, Optional action As Action(Of MASButton) = Nothing, Optional configure As Action(Of MASButton) = Nothing, Optional sizeIntent As MASSize = Nothing) As MASApplicationFilterBarLayoutBuilder` |
| `CenterItems` | Function | `Public Function CenterItems() As MASApplicationFilterBarLayoutBuilder` |
| `ClearAction` | Function | `Public Function ClearAction(Optional text As String = Nothing, Optional action As Action(Of MASButton) = Nothing, Optional configure As Action(Of MASButton) = Nothing, Optional sizeIntent As MASSize = Nothing) As MASApplicationFilterBarLayoutBuilder` |
| `ComboBox` | Function | `Public Function ComboBox(Optional items As IEnumerable(Of String) = Nothing, Optional selectedIndex As Integer = -1, Optional configure As Action(Of MASComboBox) = Nothing, Optional sizeIntent As MASSize = Nothing) As MASApplicationFilterBarLayoutBuilder` |
| `DatePicker` | Function | `Public Function DatePicker(Optional selectedDate As System.Nullable(Of Date) = Nothing, Optional configure As Action(Of MASDatePicker) = Nothing, Optional sizeIntent As MASSize = Nothing) As MASApplicationFilterBarLayoutBuilder` |
| `Direction` | Function | `Public Function Direction(value As MASApplicationFilterBarDirection) As MASApplicationFilterBarLayoutBuilder` |
| `EqualFieldSize` | Function | `Public Function EqualFieldSize() As MASApplicationFilterBarLayoutBuilder` |
| `EqualFieldWidth` | Function | `Public Function EqualFieldWidth() As MASApplicationFilterBarLayoutBuilder` |
| `Field` | Function | `Public Function Field(labelControl As MASControlBase, inputControl As MASControlBase, Optional inputSizeIntent As MASSize = Nothing) As MASApplicationFilterBarLayoutBuilder` |
| `FormRow` | Function | `Public Function FormRow(buildAction As Action(Of MASApplicationFormRowLayoutBuilder)) As MASApplicationFilterBarLayoutBuilder` |
| `FullWidth` | Function | `Public Function FullWidth(control As MASControlBase) As MASApplicationFilterBarLayoutBuilder` |
| `Gap` | Function | `Public Function Gap(value As MASLayoutSpacing) As MASApplicationFilterBarLayoutBuilder` |
| `Horizontal` | Function | `Public Function Horizontal() As MASApplicationFilterBarLayoutBuilder` |
| `HugContent` | Function | `Public Function HugContent() As MASApplicationFilterBarLayoutBuilder` |
| `IntrinsicFieldSize` | Function | `Public Function IntrinsicFieldSize() As MASApplicationFilterBarLayoutBuilder` |
| `Padding` | Function | `Public Function Padding(value As MASLayoutSpacing) As MASApplicationFilterBarLayoutBuilder` |
| `SearchBox` | Function | `Public Function SearchBox(Optional placeholder As String = Nothing, Optional configure As Action(Of MASSearchTextBox) = Nothing, Optional sizeIntent As MASSize = Nothing) As MASApplicationFilterBarLayoutBuilder` |
| `Spacing` | Function | `Public Function Spacing(value As MASLayoutSpacing) As MASApplicationFilterBarLayoutBuilder` |
| `Stretch` | Function | `Public Function Stretch() As MASApplicationFilterBarLayoutBuilder` |
| `Vertical` | Function | `Public Function Vertical() As MASApplicationFilterBarLayoutBuilder` |
| `Wrap` | Function | `Public Function Wrap() As MASApplicationFilterBarLayoutBuilder` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationFormRowLayoutBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationControlsFilterFormLayout.vb:440` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Provides a fluent builder for an Application-owned layout or surface composition route.

**When to use it.** Use it inside `window.Controls.LayoutPage(...)` or another documented Application layout gateway.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Add` | Function | `Public Function Add(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationFormRowLayoutBuilder` |
| `AlignCenter` | Function | `Public Function AlignCenter() As MASApplicationFormRowLayoutBuilder` |
| `AlignEnd` | Function | `Public Function AlignEnd() As MASApplicationFormRowLayoutBuilder` |
| `AlignStart` | Function | `Public Function AlignStart() As MASApplicationFormRowLayoutBuilder` |
| `CenterItems` | Function | `Public Function CenterItems() As MASApplicationFormRowLayoutBuilder` |
| `EqualFieldWidth` | Function | `Public Function EqualFieldWidth() As MASApplicationFormRowLayoutBuilder` |
| `Gap` | Function | `Public Function Gap(value As MASLayoutSpacing) As MASApplicationFormRowLayoutBuilder` |
| `Input` | Function | `Public Function Input(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationFormRowLayoutBuilder` |
| `IntrinsicFieldSize` | Function | `Public Function IntrinsicFieldSize() As MASApplicationFormRowLayoutBuilder` |
| `Label` | Function | `Public Function Label(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationFormRowLayoutBuilder` |
| `Padding` | Function | `Public Function Padding(value As MASLayoutSpacing) As MASApplicationFormRowLayoutBuilder` |
| `Spacing` | Function | `Public Function Spacing(value As MASLayoutSpacing) As MASApplicationFormRowLayoutBuilder` |
| `Stretch` | Function | `Public Function Stretch() As MASApplicationFormRowLayoutBuilder` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationGalleryLayoutBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationControlsGalleryLayout.vb:39` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Provides a fluent builder for an Application-owned layout or surface composition route.

**When to use it.** Use it inside `window.Controls.LayoutPage(...)` or another documented Application layout gateway.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `AddRange` | Function | `Public Function AddRange(controls As MASControlBase()) As MASApplicationGalleryLayoutBuilder` |
| `Add` | Function | `Public Function Add(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationGalleryLayoutBuilder` |
| `AlignCenter` | Function | `Public Function AlignCenter() As MASApplicationGalleryLayoutBuilder` |
| `AlignEnd` | Function | `Public Function AlignEnd() As MASApplicationGalleryLayoutBuilder` |
| `AlignStart` | Function | `Public Function AlignStart() As MASApplicationGalleryLayoutBuilder` |
| `Align` | Function | `Public Function Align(value As MASApplicationGalleryAlignment) As MASApplicationGalleryLayoutBuilder` |
| `Columns` | Function | `Public Function Columns(value As Integer) As MASApplicationGalleryLayoutBuilder` |
| `CompactTiles` | Function | `Public Function CompactTiles() As MASApplicationGalleryLayoutBuilder` |
| `DefaultTiles` | Function | `Public Function DefaultTiles() As MASApplicationGalleryLayoutBuilder` |
| `Gap` | Function | `Public Function Gap(value As MASLayoutSpacing) As MASApplicationGalleryLayoutBuilder` |
| `HeroTiles` | Function | `Public Function HeroTiles() As MASApplicationGalleryLayoutBuilder` |
| `LargeTiles` | Function | `Public Function LargeTiles() As MASApplicationGalleryLayoutBuilder` |
| `MaxColumns` | Function | `Public Function MaxColumns(value As Integer) As MASApplicationGalleryLayoutBuilder` |
| `MinColumns` | Function | `Public Function MinColumns(value As Integer) As MASApplicationGalleryLayoutBuilder` |
| `Padding` | Function | `Public Function Padding(value As MASLayoutSpacing) As MASApplicationGalleryLayoutBuilder` |
| `PreviewTiles` | Function | `Public Function PreviewTiles() As MASApplicationGalleryLayoutBuilder` |
| `Spacing` | Function | `Public Function Spacing(value As MASLayoutSpacing) As MASApplicationGalleryLayoutBuilder` |
| `TileSize` | Function | `Public Function TileSize(value As MASApplicationGalleryTileSize) As MASApplicationGalleryLayoutBuilder` |
| `Wrap` | Function | `Public Function Wrap() As MASApplicationGalleryLayoutBuilder` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationLayoutFlowBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationLayoutFlowBuilder.vb:18` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Provides a fluent builder for an Application-owned layout or surface composition route.

**When to use it.** Use it inside `window.Controls.LayoutPage(...)` or another documented Application layout gateway.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Add` | Function | `Public Function Add(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationLayoutFlowBuilder` |
| `EqualItemSize` | Function | `Public Function EqualItemSize() As MASApplicationLayoutFlowBuilder` |
| `EqualItemWidth` | Function | `Public Function EqualItemWidth() As MASApplicationLayoutFlowBuilder` |
| `Gap` | Function | `Public Function Gap(value As MASLayoutSpacing) As MASApplicationLayoutFlowBuilder` |
| `IntrinsicItemSize` | Function | `Public Function IntrinsicItemSize() As MASApplicationLayoutFlowBuilder` |
| `Padding` | Function | `Public Function Padding(value As MASLayoutSpacing) As MASApplicationLayoutFlowBuilder` |
| `Spacing` | Function | `Public Function Spacing(value As MASLayoutSpacing) As MASApplicationLayoutFlowBuilder` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationLayoutGridBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationLayoutGridBuilder.vb:19` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Provides a fluent builder for an Application-owned layout or surface composition route.

**When to use it.** Use it inside `window.Controls.LayoutPage(...)` or another documented Application layout gateway.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Add` | Function | `Public Function Add(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationLayoutGridBuilder` |
| `EqualItemSize` | Function | `Public Function EqualItemSize() As MASApplicationLayoutGridBuilder` |
| `EqualItemWidth` | Function | `Public Function EqualItemWidth() As MASApplicationLayoutGridBuilder` |
| `Gap` | Function | `Public Function Gap(value As MASLayoutSpacing) As MASApplicationLayoutGridBuilder` |
| `IntrinsicItemSize` | Function | `Public Function IntrinsicItemSize() As MASApplicationLayoutGridBuilder` |
| `Padding` | Function | `Public Function Padding(value As MASLayoutSpacing) As MASApplicationLayoutGridBuilder` |
| `Spacing` | Function | `Public Function Spacing(value As MASLayoutSpacing) As MASApplicationLayoutGridBuilder` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationLayoutPageBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:20` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Provides a fluent builder for an Application-owned layout or surface composition route.

**When to use it.** Use it inside `window.Controls.LayoutPage(...)` or another documented Application layout gateway.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ActionGroup` | Function | `Public Function ActionGroup() As MASApplicationActionGroupLayoutBuilder` |
| `ActionGroup` | Function | `Public Function ActionGroup(buildAction As Action(Of MASApplicationActionGroupLayoutBuilder)) As MASApplicationLayoutPageBuilder` |
| `Add` | Function | `Public Function Add(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationLayoutPageBuilder` |
| `ApplicationPage` | Function | `Public Function ApplicationPage(kind As MASApplicationPageLayoutKind, shell As MASApplicationWindowShell) As MASApplicationLayoutPageBuilder` |
| `FilterBar` | Function | `Public Function FilterBar() As MASApplicationFilterBarLayoutBuilder` |
| `FilterBar` | Function | `Public Function FilterBar(buildAction As Action(Of MASApplicationFilterBarLayoutBuilder)) As MASApplicationLayoutPageBuilder` |
| `Flow` | Function | `Public Function Flow() As MASApplicationLayoutFlowBuilder` |
| `FormRow` | Function | `Public Function FormRow() As MASApplicationFormRowLayoutBuilder` |
| `FormRow` | Function | `Public Function FormRow(buildAction As Action(Of MASApplicationFormRowLayoutBuilder)) As MASApplicationLayoutPageBuilder` |
| `FullWidth` | Function | `Public Function FullWidth(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationLayoutPageBuilder` |
| `Gallery` | Function | `Public Function Gallery() As MASApplicationGalleryLayoutBuilder` |
| `Gallery` | Function | `Public Function Gallery(buildAction As Action(Of MASApplicationGalleryLayoutBuilder)) As MASApplicationLayoutPageBuilder` |
| `Grid` | Function | `Public Function Grid(columns As Integer) As MASApplicationLayoutGridBuilder` |
| `Padding` | Function | `Public Function Padding(value As MASLayoutSpacing) As MASApplicationLayoutPageBuilder` |
| `Section` | Function | `Public Function Section(controls As MASControlBase()) As MASApplicationLayoutPageBuilder` |
| `Spacing` | Function | `Public Function Spacing(value As MASLayoutSpacing) As MASApplicationLayoutPageBuilder` |
| `SplitPane` | Function | `Public Function SplitPane(buildAction As Action(Of MASApplicationSplitPaneLayoutBuilder)) As MASApplicationLayoutPageBuilder` |
| `SplitPane` | Function | `Public Function SplitPane() As MASApplicationSplitPaneLayoutBuilder` |
| `StackHorizontal` | Function | `Public Function StackHorizontal() As MASApplicationLayoutStackBuilder` |
| `StackVertical` | Function | `Public Function StackVertical() As MASApplicationLayoutStackBuilder` |

**Minimal usage shape.**

```vb
window.Controls.LayoutPage(Sub(page)
    page.Title("Customers")
    page.Section("Main", Sub(section)
        section.Add(window.Controls.AddLabel("Ready"))
    End Sub)
End Sub)
```

### `MASApplicationLayoutStackBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationLayoutStackBuilder.vb:18` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Provides a fluent builder for an Application-owned layout or surface composition route.

**When to use it.** Use it inside `window.Controls.LayoutPage(...)` or another documented Application layout gateway.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Add` | Function | `Public Function Add(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationLayoutStackBuilder` |
| `EqualItemSize` | Function | `Public Function EqualItemSize() As MASApplicationLayoutStackBuilder` |
| `EqualItemWidth` | Function | `Public Function EqualItemWidth() As MASApplicationLayoutStackBuilder` |
| `HugContent` | Function | `Public Function HugContent() As MASApplicationLayoutStackBuilder` |
| `IntrinsicItemSize` | Function | `Public Function IntrinsicItemSize() As MASApplicationLayoutStackBuilder` |
| `Padding` | Function | `Public Function Padding(value As MASLayoutSpacing) As MASApplicationLayoutStackBuilder` |
| `Spacing` | Function | `Public Function Spacing(value As MASLayoutSpacing) As MASApplicationLayoutStackBuilder` |
| `Stretch` | Function | `Public Function Stretch() As MASApplicationLayoutStackBuilder` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationOpenedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationOpenedEventArgs.vb:12` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Carries typed data for an Application facade operation, result, option set, or notification.

**When to use it.** Use it with the owning Application/window service instead of building an unrelated custom DTO.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Handle` | Property | `Public ReadOnly Property Handle As MASApplicationSurfaceHandle` |
| `OwnerKey` | Property | `Public ReadOnly Property OwnerKey As String` |
| `SurfaceKey` | Property | `Public ReadOnly Property SurfaceKey As String` |

**Minimal usage shape.**

```vb
' This type is normally received from, or passed into, the owning Application facade.
' Prefer the documented window/app service instead of standalone construction.
```

### `MASApplicationOutput`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/Output/MASApplicationOutput.vb:14` |
| Related recipes | [output](../../recipes/output.md) |

**What it does.** Exposes public Output actions for reports, manifests, catalogs, captures, or evidence-oriented exports.

**When to use it.** Use it when a consumer application needs documented output artifacts rather than ad-hoc file generation.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CanExport` | Function | `Public Function CanExport(artifactKind As MASOutputArtifactKind, format As MASOutputFormat) As Boolean` |
| `ExportCapabilityCatalogManifest` | Function | `Public Function ExportCapabilityCatalogManifest(format As MASOutputFormat, Optional target As MASOutputTarget = Nothing, Optional options As MASOutputOptions = Nothing) As MASOutputResult` |
| `ExportChartFoundationManifest` | Function | `Public Function ExportChartFoundationManifest(format As MASOutputFormat, Optional target As MASOutputTarget = Nothing, Optional options As MASOutputOptions = Nothing) As MASOutputResult` |
| `ExportReadinessManifest` | Function | `Public Function ExportReadinessManifest(format As MASOutputFormat, Optional target As MASOutputTarget = Nothing, Optional options As MASOutputOptions = Nothing) As MASOutputResult` |
| `ExportReportPreviewManifest` | Function | `Public Function ExportReportPreviewManifest(format As MASOutputFormat, Optional target As MASOutputTarget = Nothing, Optional options As MASOutputOptions = Nothing) As MASOutputResult` |
| `ExportVisualCapturePng` | Function | `Public Function ExportVisualCapturePng(Optional target As MASOutputTarget = Nothing, Optional options As MASOutputOptions = Nothing) As MASOutputResult` |
| `Export` | Function | `Public Function Export(request As MASOutputRequest) As MASOutputResult` |
| `GetCapabilities` | Function | `Public Function GetCapabilities() As IReadOnlyList(Of MASOutputCapability)` |
| `GetCapabilityCatalog` | Function | `Public Function GetCapabilityCatalog() As MASOutputCapabilityCatalog` |
| `GetDefaultArtifactFileName` | Function | `Public Function GetDefaultArtifactFileName(artifactKind As MASOutputArtifactKind, format As MASOutputFormat) As String` |
| `GetReadinessSnapshot` | Function | `Public Function GetReadinessSnapshot() As MASOutputReadinessSnapshot` |

**Minimal usage shape.**

```vb
Dim target = MASOutputTarget.Directory(outputDirectory)
Dim result = app.Output.ExportCapabilityCatalogManifest(MASOutputFormat.Json, target)
If Not result.Succeeded Then
    Throw New InvalidOperationException(result.Summary)
End If
```

### `MASApplicationPageHost`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationPageHost.vb:17` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Part of the Application namespace public surface recorded in the source-derived API manifests.

**When to use it.** Use it only through the owning Application/window workflow documented by the related recipes.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CurrentPageChanged` | Event | `Public Event CurrentPageChanged As EventHandler` |
| `BindNavigationRail` | Function | `Public Function BindNavigationRail(rail As MASNavigationRail) As MASApplicationPageHost` |
| `ClearPages` | Function | `Public Function ClearPages() As MASApplicationPageHost` |
| `ContainsPage` | Function | `Public Function ContainsPage(pageId As String) As Boolean` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `NavigateTo` | Function | `Public Function NavigateTo(pageId As String) As Boolean` |
| `Refresh` | Function | `Public Function Refresh() As Boolean` |
| `RegisterPage` | Function | `Public Function RegisterPage(pageId As String, title As String, buildPage As Action(Of MASApplicationLayoutPageBuilder), Optional groupName As String = Nothing, Optional description As String = Nothing) As MASApplicationPageHost` |
| `Show` | Function | `Public Function Show() As Boolean` |
| `WithBreadcrumbRootText` | Function | `Public Function WithBreadcrumbRootText(rootText As String) As MASApplicationPageHost` |
| `WithBreadcrumbVisible` | Function | `Public Function WithBreadcrumbVisible(visible As Boolean) As MASApplicationPageHost` |
| `WithNavigationSize` | Function | `Public Function WithNavigationSize(size As MASApplicationSurfaceSideSize) As MASApplicationPageHost` |
| `WithNavigationVisible` | Function | `Public Function WithNavigationVisible(visible As Boolean) As MASApplicationPageHost` |
| `WithRegionBackgrounds` | Function | `Public Function WithRegionBackgrounds(visible As Boolean) As MASApplicationPageHost` |
| `WithRhythm` | Function | `Public Function WithRhythm(rhythm As MASApplicationSurfaceRhythm) As MASApplicationPageHost` |
| `CurrentPageDescription` | Property | `Public ReadOnly Property CurrentPageDescription As String` |
| `CurrentPageId` | Property | `Public ReadOnly Property CurrentPageId As String` |
| `CurrentPageTitle` | Property | `Public ReadOnly Property CurrentPageTitle As String` |
| `IsShown` | Property | `Public ReadOnly Property IsShown As Boolean` |
| `PageCount` | Property | `Public ReadOnly Property PageCount As Integer` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationProgressHandle`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationProgressHandle.vb:15` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Part of the Application namespace public surface recorded in the source-derived API manifests.

**When to use it.** Use it only through the owning Application/window workflow documented by the related recipes.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Close` | Sub | `Public Sub Close()` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `Update` | Sub | `Public Sub Update(statusText As String, percent As Double)` |
| `Update` | Sub | `Public Sub Update(titleText As String, statusText As String, percent As Double)` |
| `IsOpen` | Property | `Public ReadOnly Property IsOpen As Boolean` |

**Minimal usage shape.**

```vb
Using progress = window.Services.Progress.ShowOperation("Working", "Starting", 0)
    progress.Update("Half done", 50)
End Using
```

### `MASApplicationResult`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationResult.vb:11` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Carries typed data for an Application facade operation, result, option set, or notification.

**When to use it.** Use it with the owning Application/window service instead of building an unrelated custom DTO.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Accepted` | Function | `Public Shared Function Accepted(value As Object) As MASApplicationResult` |
| `Cancelled` | Function | `Public Shared Function Cancelled() As MASApplicationResult` |
| `Dismissed` | Function | `Public Shared Function Dismissed() As MASApplicationResult` |
| `Failed` | Function | `Public Shared Function Failed(errorMessage As String) As MASApplicationResult` |
| `ErrorMessage` | Property | `Public ReadOnly Property ErrorMessage As String` |
| `None` | Property | `Public Shared ReadOnly Property None As MASApplicationResult` |
| `Status` | Property | `Public ReadOnly Property Status As MASApplicationResultStatus` |
| `Value` | Property | `Public ReadOnly Property Value As Object` |

**Minimal usage shape.**

```vb
' This type is normally received from, or passed into, the owning Application facade.
' Prefer the documented window/app service instead of standalone construction.
```

### `MASApplicationSizing`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSizing.vb:15` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Part of the Application namespace public surface recorded in the source-derived API manifests.

**When to use it.** Use it only through the owning Application/window workflow documented by the related recipes.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CurrentChanged` | Event | `Public Event CurrentChanged As EventHandler(Of MASSizeProfileChangedEventArgs)` |
| `ApplyAndSave` | Sub | `Public Sub ApplyAndSave(kind As MASSizeProfileKind)` |
| `ApplyAndSave` | Sub | `Public Sub ApplyAndSave(profile As MASSizeProfile)` |
| `GetAll` | Function | `Public Function GetAll() As IReadOnlyList(Of MASSizeProfile)` |
| `Reset` | Sub | `Public Sub Reset()` |
| `SaveCurrent` | Function | `Public Function SaveCurrent() As Boolean` |
| `TryApplyAndSave` | Function | `Public Function TryApplyAndSave(kind As MASSizeProfileKind) As Boolean` |
| `TryApplyAndSave` | Function | `Public Function TryApplyAndSave(profile As MASSizeProfile) As Boolean` |
| `TryUse` | Function | `Public Function TryUse(kind As MASSizeProfileKind) As Boolean` |
| `TryUse` | Function | `Public Function TryUse(profile As MASSizeProfile) As Boolean` |
| `Use` | Sub | `Public Sub Use(kind As MASSizeProfileKind)` |
| `Use` | Sub | `Public Sub Use(profile As MASSizeProfile)` |
| `CurrentKind` | Property | `Public ReadOnly Property CurrentKind As MASSizeProfileKind` |
| `Current` | Property | `Public ReadOnly Property Current As MASSizeProfile` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationSplitPaneLayoutBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSplitPaneLayoutBuilder.vb:21` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Provides a fluent builder for an Application-owned layout or surface composition route.

**When to use it.** Use it inside `window.Controls.LayoutPage(...)` or another documented Application layout gateway.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `AddNarrative` | Function | `Public Function AddNarrative(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationSplitPaneLayoutBuilder` |
| `AddSurface` | Function | `Public Function AddSurface(control As MASControlBase, Optional sizeIntent As MASSize = Nothing) As MASApplicationSplitPaneLayoutBuilder` |
| `Gap` | Function | `Public Function Gap(value As MASLayoutSpacing) As MASApplicationSplitPaneLayoutBuilder` |
| `Spacing` | Function | `Public Function Spacing(value As MASLayoutSpacing) As MASApplicationSplitPaneLayoutBuilder` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationSurfaceHandle`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSurfaceHandle.vb:13` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Part of the Application namespace public surface recorded in the source-derived API manifests.

**When to use it.** Use it only through the owning Application/window workflow documented by the related recipes.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Close` | Function | `Public Function Close(Optional reason As MASApplicationCloseReason = MASApplicationCloseReason.Programmatic) As Boolean` |
| `ToString` | Function | `Public Function ToString() As String` |
| `Id` | Property | `Public ReadOnly Property Id As Long` |
| `IsClosed` | Property | `Public ReadOnly Property IsClosed As Boolean` |
| `IsClosing` | Property | `Public ReadOnly Property IsClosing As Boolean` |
| `IsOpen` | Property | `Public ReadOnly Property IsOpen As Boolean` |
| `OwnerKey` | Property | `Public ReadOnly Property OwnerKey As String` |
| `State` | Property | `Public ReadOnly Property State As MASApplicationSurfaceState` |
| `SurfaceKey` | Property | `Public ReadOnly Property SurfaceKey As String` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationSurfaceLayoutBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Backgrounds.vb:16`<br>`MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:16`<br>`MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Helpers.vb:16`<br>`MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.LayoutModel.vb:16`<br>`MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:16`<br>`MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:16`<br>`MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.vb:23` |
| Related recipes | [theme-surface](../../recipes/theme-surface.md), [layout](../../recipes/layout.md) |

**What it does.** Provides a fluent builder for an Application-owned layout or surface composition route.

**When to use it.** Use it inside `window.Controls.LayoutPage(...)` or another documented Application layout gateway.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `ApplicationChrome` | Function | `Public Function ApplicationChrome(shell As MASApplicationWindowShell) As MASApplicationSurfaceLayoutBuilder` |
| `BodyFooterGap` | Function | `Public Function BodyFooterGap(value As MASLayoutSpacing) As MASApplicationSurfaceLayoutBuilder` |
| `ColumnGap` | Function | `Public Function ColumnGap(value As MASLayoutSpacing) As MASApplicationSurfaceLayoutBuilder` |
| `ComfortableRhythm` | Function | `Public Function ComfortableRhythm() As MASApplicationSurfaceLayoutBuilder` |
| `CommandBarFullApplicationSurfaceTop` | Function | `Public Function CommandBarFullApplicationSurfaceTop() As MASApplicationSurfaceLayoutBuilder` |
| `CommandBarMainAreaTop` | Function | `Public Function CommandBarMainAreaTop() As MASApplicationSurfaceLayoutBuilder` |
| `CommandBarPlacement` | Function | `Public Function CommandBarPlacement(placement As MASApplicationSurfaceCommandBarPlacement) As MASApplicationSurfaceLayoutBuilder` |
| `CommandBarSize` | Function | `Public Function CommandBarSize(size As MASApplicationSurfaceBarSize) As MASApplicationSurfaceLayoutBuilder` |
| `CommandBar` | Function | `Public Function CommandBar(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `CommandBodyGap` | Function | `Public Function CommandBodyGap(value As MASLayoutSpacing) As MASApplicationSurfaceLayoutBuilder` |
| `CompactRhythm` | Function | `Public Function CompactRhythm() As MASApplicationSurfaceLayoutBuilder` |
| `Content` | Function | `Public Function Content(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `FooterFullApplicationSurfaceBottom` | Function | `Public Function FooterFullApplicationSurfaceBottom() As MASApplicationSurfaceLayoutBuilder` |
| `FooterMainAreaBottom` | Function | `Public Function FooterMainAreaBottom() As MASApplicationSurfaceLayoutBuilder` |
| `FooterPlacement` | Function | `Public Function FooterPlacement(placement As MASApplicationSurfaceFooterPlacement) As MASApplicationSurfaceLayoutBuilder` |
| `FooterSize` | Function | `Public Function FooterSize(size As MASApplicationSurfaceBarSize) As MASApplicationSurfaceLayoutBuilder` |
| `Footer` | Function | `Public Function Footer(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `Gap` | Function | `Public Function Gap(value As MASLayoutSpacing) As MASApplicationSurfaceLayoutBuilder` |
| `InspectorSize` | Function | `Public Function InspectorSize(size As MASApplicationSurfaceSideSize) As MASApplicationSurfaceLayoutBuilder` |
| `Inspector` | Function | `Public Function Inspector(size As MASApplicationSurfaceSideSize, buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `Inspector` | Function | `Public Function Inspector(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `LeftSide` | Function | `Public Function LeftSide(size As MASApplicationSurfaceSideSize, buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `LeftSide` | Function | `Public Function LeftSide(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `MainContent` | Function | `Public Function MainContent(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `Navigation` | Function | `Public Function Navigation(size As MASApplicationSurfaceSideSize, buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `Navigation` | Function | `Public Function Navigation(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `Padding` | Function | `Public Function Padding(value As MASLayoutSpacing) As MASApplicationSurfaceLayoutBuilder` |
| `ReserveStandardTopBar` | Function | `Public Function ReserveStandardTopBar(shell As MASApplicationWindowShell) As MASApplicationSurfaceLayoutBuilder` |
| `Rhythm` | Function | `Public Function Rhythm(value As MASApplicationSurfaceRhythm) As MASApplicationSurfaceLayoutBuilder` |
| `RightSide` | Function | `Public Function RightSide(size As MASApplicationSurfaceSideSize, buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `RightSide` | Function | `Public Function RightSide(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `ShowCommandBackground` | Function | `Public Function ShowCommandBackground(visible As Boolean) As MASApplicationSurfaceLayoutBuilder` |
| `ShowRegionBackgrounds` | Function | `Public Function ShowRegionBackgrounds(visible As Boolean) As MASApplicationSurfaceLayoutBuilder` |
| `SidebarFooterGap` | Function | `Public Function SidebarFooterGap(value As MASLayoutSpacing) As MASApplicationSurfaceLayoutBuilder` |
| `SidebarFooterSize` | Function | `Public Function SidebarFooterSize(size As MASApplicationSurfaceBarSize) As MASApplicationSurfaceLayoutBuilder` |
| `SidebarFooter` | Function | `Public Function SidebarFooter(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `SidebarSize` | Function | `Public Function SidebarSize(size As MASApplicationSurfaceSideSize) As MASApplicationSurfaceLayoutBuilder` |
| `Sidebar` | Function | `Public Function Sidebar(size As MASApplicationSurfaceSideSize, buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `Sidebar` | Function | `Public Function Sidebar(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |
| `SpaciousRhythm` | Function | `Public Function SpaciousRhythm() As MASApplicationSurfaceLayoutBuilder` |
| `WithCommandBackgroundSurfaceMaterial` | Function | `Public Function WithCommandBackgroundSurfaceMaterial(materialKey As String) As MASApplicationSurfaceLayoutBuilder` |
| `WithRegionBackgroundSurfaceMaterial` | Function | `Public Function WithRegionBackgroundSurfaceMaterial(materialKey As String) As MASApplicationSurfaceLayoutBuilder` |
| `Workspace` | Function | `Public Function Workspace(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As MASApplicationSurfaceLayoutBuilder` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationSurfaceMaterialGateway`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/SurfaceMaterials/MASApplicationSurfaceMaterialGateway.vb:15` |
| Related recipes | [theme-surface](../../recipes/theme-surface.md) |

**What it does.** Exposes selectable Application surface-material options and scoped material application.

**When to use it.** Use it to apply documented surface material choices to application chrome and registered controls.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CreateScope` | Function | `Public Shared Function CreateScope(window As MASApplicationWindow) As MASApplicationSurfaceMaterialScope` |
| `GetSelectableMaterials` | Function | `Public Shared Function GetSelectableMaterials() As MASApplicationSurfaceMaterialOption()` |
| `IsAutoMaterialKey` | Function | `Public Shared Function IsAutoMaterialKey(materialKey As String) As Boolean` |
| `NormalizeMaterialKey` | Function | `Public Shared Function NormalizeMaterialKey(materialKey As String) As String` |

**Minimal usage shape.**

```vb
Dim scope = MASApplicationSurfaceMaterialGateway.CreateScope(window)
scope.Apply("SoftMist")
```

### `MASApplicationSurfaceMaterialOption`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/SurfaceMaterials/MASApplicationSurfaceMaterialOption.vb:13` |
| Related recipes | [theme-surface](../../recipes/theme-surface.md) |

**What it does.** Exposes selectable Application surface-material options and scoped material application.

**When to use it.** Use it to apply documented surface material choices to application chrome and registered controls.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(key As String, displayName As String)` |
| `ToString` | Function | `Public Function ToString() As String` |
| `DisplayName` | Property | `Public ReadOnly Property DisplayName As String` |
| `Key` | Property | `Public ReadOnly Property Key As String` |

**Minimal usage shape.**

```vb
Dim scope = MASApplicationSurfaceMaterialGateway.CreateScope(window)
scope.Apply("SoftMist")
```

### `MASApplicationSurfaceMaterialScope`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/SurfaceMaterials/MASApplicationSurfaceMaterialScope.vb:19` |
| Related recipes | [theme-surface](../../recipes/theme-surface.md) |

**What it does.** Exposes selectable Application surface-material options and scoped material application.

**When to use it.** Use it to apply documented surface material choices to application chrome and registered controls.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Apply` | Function | `Public Function Apply(materialKey As String) As MASApplicationSurfaceMaterialScope` |
| `CreateToastOptions` | Function | `Public Function CreateToastOptions(message As String, Optional title As String = Nothing) As MASToastOptions` |
| `RegisterCard` | Function | `Public Function RegisterCard(card As MASCard) As MASApplicationSurfaceMaterialScope` |
| `RegisterGroupBox` | Function | `Public Function RegisterGroupBox(groupBox As MASGroupBox) As MASApplicationSurfaceMaterialScope` |
| `RegisterOperationProgressBox` | Function | `Public Function RegisterOperationProgressBox(progressBox As MASOperationProgressBox) As MASApplicationSurfaceMaterialScope` |
| `RegisterProgressBar` | Function | `Public Function RegisterProgressBar(progressBar As MASProgressBar) As MASApplicationSurfaceMaterialScope` |
| `RegisterToolbar` | Function | `Public Function RegisterToolbar(toolbar As MASToolbar) As MASApplicationSurfaceMaterialScope` |
| `RegisterTopBar` | Function | `Public Function RegisterTopBar(topBar As MASTopBarComponent) As MASApplicationSurfaceMaterialScope` |
| `CurrentMaterialKey` | Property | `Public ReadOnly Property CurrentMaterialKey As String` |

**Minimal usage shape.**

```vb
Dim scope = MASApplicationSurfaceMaterialGateway.CreateScope(window)
scope.Apply("SoftMist")
```

### `MASApplicationSurfaceShowResult`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSurfaceShowResult.vb:16` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Carries typed data for an Application facade operation, result, option set, or notification.

**When to use it.** Use it with the owning Application/window service instead of building an unrelated custom DTO.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Opened` | Function | `Public Shared Function Opened(handle As MASApplicationSurfaceHandle) As MASApplicationSurfaceShowResult` |
| `Queued` | Function | `Public Shared Function Queued(Optional reason As String = "Queued by surface policy.") As MASApplicationSurfaceShowResult` |
| `Rejected` | Function | `Public Shared Function Rejected(reason As String) As MASApplicationSurfaceShowResult` |
| `Reused` | Function | `Public Shared Function Reused(handle As MASApplicationSurfaceHandle) As MASApplicationSurfaceShowResult` |
| `ToString` | Function | `Public Function ToString() As String` |
| `Handle` | Property | `Public ReadOnly Property Handle As MASApplicationSurfaceHandle` |
| `HasHandle` | Property | `Public ReadOnly Property HasHandle As Boolean` |
| `IsAccepted` | Property | `Public ReadOnly Property IsAccepted As Boolean` |
| `Reason` | Property | `Public ReadOnly Property Reason As String` |
| `Status` | Property | `Public ReadOnly Property Status As MASApplicationSurfaceShowStatus` |

**Minimal usage shape.**

```vb
' This type is normally received from, or passed into, the owning Application facade.
' Prefer the documented window/app service instead of standalone construction.
```

### `MASApplicationTheme`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationTheme.vb:31` |
| Related recipes | [theme-surface](../../recipes/theme-surface.md) |

**What it does.** Exposes public theme selection or theme-change information for the Application facade.

**When to use it.** Use it to inspect or change the registered Nexamas UI theme through official gateways.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CurrentChanged` | Event | `Public Event CurrentChanged As Action(Of IMASAppTheme)` |
| `CurrentThemeChanged` | Event | `Public Event CurrentThemeChanged As EventHandler(Of NexamasUIChangedEventArgs)` |
| `GetAll` | Function | `Public Function GetAll() As IReadOnlyList(Of IMASAppTheme)` |
| `GetById` | Function | `Public Function GetById(id As String) As IMASAppTheme` |
| `TryUse` | Function | `Public Function TryUse(id As String) As Boolean` |
| `Use` | Sub | `Public Sub Use(id As String)` |
| `CurrentDisplayName` | Property | `Public ReadOnly Property CurrentDisplayName As String` |
| `CurrentId` | Property | `Public ReadOnly Property CurrentId As String` |
| `Current` | Property | `Public ReadOnly Property Current As IMASAppTheme` |

**Minimal usage shape.**

```vb
Dim applied = app.Theme.TryUse("premium-office-mas-signature")
If Not applied Then
    app.Theme.Use("premium-office-mas-signature")
End If
```

### `MASApplicationTooltipTarget`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationTooltipTarget.vb:13` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Part of the Application namespace public surface recorded in the source-derived API manifests.

**When to use it.** Use it only through the owning Application/window workflow documented by the related recipes.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Dispose` | Sub | `Public Sub Dispose()` |
| `Remove` | Sub | `Public Sub Remove()` |
| `IsRegistered` | Property | `Public ReadOnly Property IsRegistered As Boolean` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationWindow`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindow.vb:17` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Represents a WinForms-owned Nexamas UI window facade with services, controls, layout, shell, theme, sizing, and lifecycle gateways.

**When to use it.** Use it after `MASApplication.Create().CreateWindow(...)` to build and host a real application screen.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Disposed` | Event | `Public Event Disposed As EventHandler` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `RefreshNow` | Sub | `Public Sub RefreshNow()` |
| `Refresh` | Sub | `Public Sub Refresh()` |
| `Setup` | Sub | `Public Sub Setup()` |
| `WithSurfaceMaterial` | Function | `Public Function WithSurfaceMaterial(materialKey As String) As MASApplicationWindow` |
| `Chrome` | Property | `Public ReadOnly Property Chrome As MASApplicationWindowChrome` |
| `Controls` | Property | `Public ReadOnly Property Controls As MASApplicationWindowControls` |
| `Dpi` | Property | `Public ReadOnly Property Dpi As Single` |
| `Geometry` | Property | `Public ReadOnly Property Geometry As MASApplicationWindowGeometry` |
| `Input` | Property | `Public ReadOnly Property Input As MASApplicationWindowInput` |
| `IsDisposed` | Property | `Public ReadOnly Property IsDisposed As Boolean` |
| `Pages` | Property | `Public ReadOnly Property Pages As MASApplicationPageHost` |
| `Presentation` | Property | `Public ReadOnly Property Presentation As MASApplicationWindowPresentation` |
| `Services` | Property | `Public ReadOnly Property Services As MASApplicationWindowServices` |
| `Shell` | Property | `Public ReadOnly Property Shell As MASApplicationWindowShell` |
| `Sizing` | Property | `Public ReadOnly Property Sizing As MASApplicationWindowSizing` |
| `SurfaceMaterial` | Property | `Public Property SurfaceMaterial As String` |
| `SurfaceSizePx` | Property | `Public ReadOnly Property SurfaceSizePx As SKSizeI` |
| `Theme` | Property | `Public ReadOnly Property Theme As MASApplicationWindowTheme` |

**Minimal usage shape.**

```vb
Dim app = MASApplication.Create()
Dim window = app.CreateWindow(ownerForm)
window.Controls.AddButton("Save")
window.Setup()
```

### `MASApplicationWindowChrome`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowChrome.vb:14` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Apply` | Sub | `Public Sub Apply()` |
| `Clear` | Sub | `Public Sub Clear()` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `UseSoftShadow` | Function | `Public Function UseSoftShadow(Optional mode As MASWindowShadowMode = MASWindowShadowMode.PopupSafe, Optional applyDelayMs As Integer = 0, Optional usePulseFix As Boolean = False) As MASApplicationWindowChrome` |
| `HasShadow` | Property | `Public ReadOnly Property HasShadow As Boolean` |
| `IsDisposed` | Property | `Public ReadOnly Property IsDisposed As Boolean` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationWindowContextMenus`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowContextMenus.vb:17` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Clear` | Sub | `Public Sub Clear()` |
| `Close` | Sub | `Public Sub Close()` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `OnCommand` | Function | `Public Function OnCommand(handler As Action(Of String)) As MASApplicationWindowContextMenus` |
| `Register` | Function | `Public Function Register(key As String, regionLogical As SKRect, buildMenu As Action(Of MASDropDownMenuBuilder)) As MASApplicationWindowContextMenus` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationWindowControls`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowControls.ApplicationSurface.vb:16`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Buttons.vb:18`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Containers.vb:18`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Data.vb:18`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Feedback.vb:18`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Inputs.vb:18`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Media.vb:18`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.Navigation.vb:18`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.ControlFactory.vb:18`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.FocusAndSnapshot.vb:16`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.LayoutDiagnostics.vb:9`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.LayoutOwnership.vb:16`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.LayoutPage.vb:16`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.LayoutRegions.vb:16`<br>`MASSystem/Application/Facade/MASApplicationWindowControls.vb:23` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `LayoutRefreshFailed` | Event | `Public Event LayoutRefreshFailed As EventHandler` |
| `AddAccordion` | Function | `Public Function AddAccordion(Optional allowMultipleExpanded As Boolean = False, Optional configure As Action(Of MASAccordion) = Nothing) As MASAccordion` |
| `AddAgendaView` | Function | `Public Function AddAgendaView(Optional title As String = Nothing, Optional day As System.Nullable(Of Date) = Nothing, Optional configure As Action(Of MASAgendaView) = Nothing) As MASAgendaView` |
| `AddAppLayout` | Function | `Public Function AddAppLayout(Optional title As String = Nothing, Optional configure As Action(Of MASAppLayout) = Nothing) As MASAppLayout` |
| `AddAppliedFiltersBar` | Function | `Public Function AddAppliedFiltersBar(Optional title As String = Nothing, Optional savedViewName As String = Nothing, Optional configure As Action(Of MASAppliedFiltersBar) = Nothing) As MASAppliedFiltersBar` |
| `AddAvatarGroup` | Function | `Public Function AddAvatarGroup(Optional avatars As IEnumerable(Of MASAvatar) = Nothing, Optional configure As Action(Of MASAvatarGroup) = Nothing) As MASAvatarGroup` |
| `AddAvatar` | Function | `Public Function AddAvatar(Optional displayName As String = Nothing, Optional initials As String = Nothing, Optional configure As Action(Of MASAvatar) = Nothing) As MASAvatar` |
| `AddBadge` | Function | `Public Function AddBadge(Optional text As String = Nothing, Optional tone As MASToastTone = MASToastTone.Neutral, Optional configure As Action(Of MASBadge) = Nothing) As MASBadge` |
| `AddBreadcrumb` | Function | `Public Function AddBreadcrumb(Optional items As IEnumerable(Of String) = Nothing, Optional configure As Action(Of MASBreadcrumb) = Nothing) As MASBreadcrumb` |
| `AddButton` | Function | `Public Function AddButton(Optional text As String = Nothing, Optional configure As Action(Of MASButton) = Nothing) As MASButton` |
| `AddCalendarView` | Function | `Public Function AddCalendarView(Optional selectedDate As System.Nullable(Of Date) = Nothing, Optional displayMonth As System.Nullable(Of Date) = Nothing, Optional configure As Action(Of MASCalendarView) = Nothing) As MASCalendarView` |
| `AddCallout` | Function | `Public Function AddCallout(Optional title As String = Nothing, Optional text As String = Nothing, Optional configure As Action(Of MASCallout) = Nothing) As MASCallout` |
| `AddChartLegend` | Function | `Public Function AddChartLegend(Optional title As String = Nothing, Optional configure As Action(Of MASChartLegend) = Nothing) As MASChartLegend` |
| `AddChart` | Function | `Public Function AddChart(Optional configure As Action(Of MASChart) = Nothing) As MASChart` |
| `AddCheckBox` | Function | `Public Function AddCheckBox(Optional text As String = Nothing, Optional checked As Boolean = False, Optional configure As Action(Of MASCheckBox) = Nothing) As MASCheckBox` |
| `AddColorPicker` | Function | `Public Function AddColorPicker(Optional configure As Action(Of MASColorPicker) = Nothing) As MASColorPicker` |
| `AddComboBox` | Function | `Public Function AddComboBox(Optional items As IEnumerable(Of String) = Nothing, Optional selectedIndex As Integer = -1, Optional configure As Action(Of MASComboBox) = Nothing) As MASComboBox` |
| `AddCommandBar` | Function | `Public Function AddCommandBar(Optional configure As Action(Of MASToolbar) = Nothing) As MASToolbar` |
| `AddCommandPalette` | Function | `Public Function AddCommandPalette(Optional title As String = Nothing, Optional configure As Action(Of MASCommandPalette) = Nothing) As MASCommandPalette` |
| `AddContentCarousel` | Function | `Public Function AddContentCarousel(Optional title As String = Nothing, Optional configure As Action(Of MASContentCarousel) = Nothing) As MASContentCarousel` |
| `AddControl` | Function | `Public Function AddControl(Of TControl)(control As TControl, Optional configure As Action(Of TControl) = Nothing) As TControl` |
| `AddDashboardGrid` | Function | `Public Function AddDashboardGrid(Optional title As String = Nothing, Optional configure As Action(Of MASDashboardGrid) = Nothing) As MASDashboardGrid` |
| `AddDataForm` | Function | `Public Function AddDataForm(Optional configure As Action(Of MASFormBuilder) = Nothing, Optional configureControl As Action(Of MASDataForm) = Nothing) As MASDataForm` |
| `AddDataGrid` | Function | `Public Function AddDataGrid(Optional configure As Action(Of MASDataGrid) = Nothing) As MASDataGrid` |
| `AddDatePicker` | Function | `Public Function AddDatePicker(Optional selectedDate As System.Nullable(Of Date) = Nothing, Optional configure As Action(Of MASDatePicker) = Nothing) As MASDatePicker` |
| `AddDateRangePicker` | Function | `Public Function AddDateRangePicker(Optional startDate As System.Nullable(Of Date) = Nothing, Optional endDate As System.Nullable(Of Date) = Nothing, Optional configure As Action(Of MASDateRangePicker) = Nothing) As MASDateRangePicker` |
| `AddEmptyState` | Function | `Public Function AddEmptyState(Optional title As String = Nothing, Optional description As String = Nothing, Optional configure As Action(Of MASEmptyState) = Nothing) As MASEmptyState` |
| `AddExpander` | Function | `Public Function AddExpander(Optional title As String = Nothing, Optional expanded As Boolean = True, Optional configure As Action(Of MASExpander) = Nothing) As MASExpander` |
| `AddFileDropZone` | Function | `Public Function AddFileDropZone(Optional title As String = Nothing, Optional description As String = Nothing, Optional configure As Action(Of MASFileDropZone) = Nothing) As MASFileDropZone` |
| `AddFileExplorerView` | Function | `Public Function AddFileExplorerView(Optional configure As Action(Of MASFileExplorerView) = Nothing) As MASFileExplorerView` |
| `AddFilePickerControl` | Function | `Public Function AddFilePickerControl(Optional configure As Action(Of MASFilePickerControl) = Nothing) As MASFilePickerControl` |
| `AddFilterBuilder` | Function | `Public Function AddFilterBuilder(Optional rules As IEnumerable(Of MASFilterRule) = Nothing, Optional configure As Action(Of MASFilterBuilder) = Nothing) As MASFilterBuilder` |
| `AddFormValidationSummary` | Function | `Public Function AddFormValidationSummary(Optional title As String = Nothing, Optional configure As Action(Of MASFormValidationSummary) = Nothing) As MASFormValidationSummary` |
| `AddGroupBox` | Function | `Public Function AddGroupBox(Optional title As String = Nothing, Optional configure As Action(Of MASGroupBox) = Nothing) As MASGroupBox` |
| `AddImageViewer` | Function | `Public Function AddImageViewer(Optional title As String = Nothing, Optional subtitle As String = Nothing, Optional configure As Action(Of MASImageViewer) = Nothing) As MASImageViewer` |
| `AddKanbanBoard` | Function | `Public Function AddKanbanBoard(Optional title As String = Nothing, Optional configure As Action(Of MASKanbanBoard) = Nothing) As MASKanbanBoard` |
| `AddLabel` | Function | `Public Function AddLabel(Optional text As String = Nothing, Optional configure As Action(Of MASLabel) = Nothing) As MASLabel` |
| `AddListBox` | Function | `Public Function AddListBox(Optional items As IEnumerable(Of String) = Nothing, Optional configure As Action(Of MASListBox) = Nothing) As MASListBox` |
| `AddListView` | Function | `Public Function AddListView(Optional textItems As IEnumerable(Of String) = Nothing, Optional configure As Action(Of MASListView) = Nothing) As MASListView` |
| `AddLoadingSkeleton` | Function | `Public Function AddLoadingSkeleton(Optional rowCount As Integer = 4, Optional configure As Action(Of MASLoadingSkeleton) = Nothing) As MASLoadingSkeleton` |
| `AddMasterDetailView` | Function | `Public Function AddMasterDetailView(Optional title As String = Nothing, Optional configure As Action(Of MASMasterDetailView) = Nothing) As MASMasterDetailView` |
| `AddMenuBar` | Function | `Public Function AddMenuBar(Optional configure As Action(Of MASMenuBar) = Nothing) As MASMenuBar` |
| `AddMetricCard` | Function | `Public Function AddMetricCard(Optional title As String = Nothing, Optional valueText As String = Nothing, Optional configure As Action(Of MASMetricCard) = Nothing) As MASMetricCard` |
| `AddMultilineTextBox` | Function | `Public Function AddMultilineTextBox(Optional text As String = Nothing, Optional configure As Action(Of MASMultilineTextBox) = Nothing) As MASMultilineTextBox` |
| `AddNavigationRail` | Function | `Public Function AddNavigationRail(Optional title As String = Nothing, Optional configure As Action(Of MASNavigationRail) = Nothing) As MASNavigationRail` |
| `AddNotificationPanel` | Function | `Public Function AddNotificationPanel(Optional title As String = Nothing, Optional configure As Action(Of MASNotificationPanel) = Nothing) As MASNotificationPanel` |
| `AddNumericTextBox` | Function | `Public Function AddNumericTextBox(Optional configure As Action(Of MASNumericTextBox) = Nothing) As MASNumericTextBox` |
| `AddOperationProgressBox` | Function | `Public Function AddOperationProgressBox(Optional titleText As String = Nothing, Optional statusText As String = Nothing, Optional configure As Action(Of MASOperationProgressBox) = Nothing) As MASOperationProgressBox` |
| `AddPagination` | Function | `Public Function AddPagination(Optional currentPage As Integer = 1, Optional totalPages As Integer = 1, Optional configure As Action(Of MASPagination) = Nothing) As MASPagination` |
| `AddPasswordTextBox` | Function | `Public Function AddPasswordTextBox(Optional text As String = Nothing, Optional configure As Action(Of MASPasswordTextBox) = Nothing) As MASPasswordTextBox` |
| `AddPathTextBox` | Function | `Public Function AddPathTextBox(Optional path As String = Nothing, Optional configure As Action(Of MASPathTextBox) = Nothing) As MASPathTextBox` |
| `AddPivotTable` | Function | `Public Function AddPivotTable(Optional title As String = Nothing, Optional configure As Action(Of MASPivotTable) = Nothing) As MASPivotTable` |
| `AddProgressBar` | Function | `Public Function AddProgressBar(Optional configure As Action(Of MASProgressBar) = Nothing) As MASProgressBar` |
| `AddPropertyGrid` | Function | `Public Function AddPropertyGrid(Optional source As Object = Nothing, Optional configure As Action(Of MASPropertyGrid) = Nothing) As MASPropertyGrid` |
| `AddRadioButton` | Function | `Public Function AddRadioButton(Optional text As String = Nothing, Optional groupName As String = Nothing, Optional checked As Boolean = False, Optional configure As Action(Of MASRadioButton) = Nothing) As MASRadioButton` |
| `AddRating` | Function | `Public Function AddRating(Optional value As Double = 0.0, Optional maximum As Integer = 5, Optional configure As Action(Of MASRating) = Nothing) As MASRating` |
| `AddSearchTextBox` | Function | `Public Function AddSearchTextBox(Optional text As String = Nothing, Optional configure As Action(Of MASSearchTextBox) = Nothing) As MASSearchTextBox` |
| `AddSegmentedControl` | Function | `Public Function AddSegmentedControl(Optional segments As IEnumerable(Of MASSegmentEntry) = Nothing, Optional configure As Action(Of MASSegmentedControl) = Nothing) As MASSegmentedControl` |
| `AddSelectorItemList` | Function | `Public Function AddSelectorItemList(Optional items As IEnumerable(Of MASSelectorItemEntry) = Nothing, Optional configure As Action(Of MASSelectorItemControl) = Nothing) As MASSelectorItemControl` |
| `AddSlider` | Function | `Public Function AddSlider(Optional minimum As Double = 0.0, Optional maximum As Double = 100.0, Optional value As Double = 0.0, Optional configure As Action(Of MASSlider) = Nothing) As MASSlider` |
| `AddSplitButton` | Function | `Public Function AddSplitButton(Optional text As String = Nothing, Optional configure As Action(Of MASSplitButton) = Nothing) As MASSplitButton` |
| `AddSplitView` | Function | `Public Function AddSplitView(Optional title As String = Nothing, Optional configure As Action(Of MASSplitView) = Nothing) As MASSplitView` |
| `AddStatusBanner` | Function | `Public Function AddStatusBanner(Optional title As String = Nothing, Optional message As String = Nothing, Optional tone As MASToastTone = MASToastTone.Info, Optional configure As Action(Of MASStatusBanner) = Nothing) As MASStatusBanner` |
| `AddStepper` | Function | `Public Function AddStepper(Optional orientation As MASStepperOrientation = MASStepperOrientation.Horizontal, Optional configure As Action(Of MASStepper) = Nothing) As MASStepper` |
| `AddTabControl` | Function | `Public Function AddTabControl(Optional configure As Action(Of MASTabControl) = Nothing) As MASTabControl` |
| `AddTagInput` | Function | `Public Function AddTagInput(Optional tags As IEnumerable(Of String) = Nothing, Optional configure As Action(Of MASTagInput) = Nothing) As MASTagInput` |
| `AddTextBox` | Function | `Public Function AddTextBox(Optional text As String = Nothing, Optional configure As Action(Of MASTextBox) = Nothing) As MASTextBox` |
| `AddTileBox` | Function | `Public Function AddTileBox(Optional configure As Action(Of MASTileBox) = Nothing) As MASTileBox` |
| `AddTimePicker` | Function | `Public Function AddTimePicker(Optional selectedTime As System.Nullable(Of System.TimeSpan) = Nothing, Optional configure As Action(Of MASTimePicker) = Nothing) As MASTimePicker` |
| `AddTimeline` | Function | `Public Function AddTimeline(Optional title As String = Nothing, Optional description As String = Nothing, Optional configure As Action(Of MASTimeline) = Nothing) As MASTimeline` |
| `AddTitle` | Function | `Public Function AddTitle(text As String, Optional configure As Action(Of MASTitle) = Nothing) As MASTitle` |
| `AddToggleSwitch` | Function | `Public Function AddToggleSwitch(Optional text As String = Nothing, Optional checked As Boolean = False, Optional configure As Action(Of MASToggleSwitch) = Nothing) As MASToggleSwitch` |
| `AddToolbar` | Function | `Public Function AddToolbar(Optional configure As Action(Of MASToolbar) = Nothing) As MASToolbar` |
| `AddTransferList` | Function | `Public Function AddTransferList(Optional availableItems As IEnumerable(Of String) = Nothing, Optional selectedItems As IEnumerable(Of String) = Nothing, Optional configure As Action(Of MASTransferList) = Nothing) As MASTransferList` |
| `AddTreeGrid` | Function | `Public Function AddTreeGrid(Optional title As String = Nothing, Optional configure As Action(Of MASTreeGrid) = Nothing) As MASTreeGrid` |
| `AddTreeView` | Function | `Public Function AddTreeView(Optional configure As Action(Of MASTreeView) = Nothing) As MASTreeView` |
| `AddValidationMessage` | Function | `Public Function AddValidationMessage(Optional text As String = Nothing, Optional state As MASTextValidationState = MASTextValidationState.Information, Optional configure As Action(Of MASValidationMessage) = Nothing) As MASValidationMessage` |
| `AddWizard` | Function | `Public Function AddWizard(Optional orientation As MASStepperOrientation = MASStepperOrientation.Horizontal, Optional configure As Action(Of MASWizard) = Nothing) As MASWizard` |
| `Add` | Sub | `Public Sub Add(control As MASControlBase)` |
| `BringToFront` | Sub | `Public Sub BringToFront(control As MASControlBase)` |
| `ClearAndDisposeCreatedControls` | Sub | `Public Sub ClearAndDisposeCreatedControls()` |
| `Clear` | Sub | `Public Sub Clear()` |
| `Contains` | Function | `Public Function Contains(control As MASControlBase) As Boolean` |
| `CreateDrawer` | Function | `Public Function CreateDrawer(Optional title As String = Nothing, Optional side As MASDrawerSide = MASDrawerSide.Right, Optional configure As Action(Of MASDrawer) = Nothing) As MASDrawer` |
| `CreatePopover` | Function | `Public Function CreatePopover(Optional title As String = Nothing, Optional text As String = Nothing, Optional configure As Action(Of MASPopover) = Nothing) As MASPopover` |
| `Focus` | Sub | `Public Sub Focus(control As MASControlBase)` |
| `LayoutApplicationSurface` | Function | `Public Function LayoutApplicationSurface(buildAction As Action(Of MASApplicationSurfaceLayoutBuilder), density As MASControlDensity) As Boolean` |
| `LayoutApplicationSurface` | Function | `Public Function LayoutApplicationSurface(buildAction As Action(Of MASApplicationSurfaceLayoutBuilder), sizeProfile As MASSizeProfile) As Boolean` |
| `LayoutApplicationSurface` | Function | `Public Function LayoutApplicationSurface(buildAction As Action(Of MASApplicationSurfaceLayoutBuilder)) As Boolean` |
| `LayoutPage` | Function | `Public Function LayoutPage(buildAction As Action(Of MASApplicationLayoutPageBuilder), density As MASControlDensity) As Boolean` |
| `LayoutPage` | Function | `Public Function LayoutPage(buildAction As Action(Of MASApplicationLayoutPageBuilder), sizeProfile As MASSizeProfile) As Boolean` |
| `LayoutPage` | Function | `Public Function LayoutPage(buildAction As Action(Of MASApplicationLayoutPageBuilder)) As Boolean` |
| `PerformUpdate` | Sub | `Public Sub PerformUpdate(updateAction As Action(Of MASApplicationWindowControls))` |
| `RemoveAndDispose` | Sub | `Public Sub RemoveAndDispose(control As MASControlBase)` |
| `Remove` | Sub | `Public Sub Remove(control As MASControlBase)` |
| `RequestFocus` | Sub | `Public Sub RequestFocus(control As MASControlBase)` |
| `Count` | Property | `Public ReadOnly Property Count As Integer` |
| `HasLastLayoutRefreshFailure` | Property | `Public ReadOnly Property HasLastLayoutRefreshFailure As Boolean` |
| `LastLayoutRefreshFailureCode` | Property | `Public ReadOnly Property LastLayoutRefreshFailureCode As String` |
| `LastLayoutRefreshFailureDetail` | Property | `Public ReadOnly Property LastLayoutRefreshFailureDetail As String` |
| `LastLayoutRefreshFailureExceptionType` | Property | `Public ReadOnly Property LastLayoutRefreshFailureExceptionType As String` |
| `LastLayoutRefreshFailureMessage` | Property | `Public ReadOnly Property LastLayoutRefreshFailureMessage As String` |
| `LastLayoutRefreshFailureReason` | Property | `Public ReadOnly Property LastLayoutRefreshFailureReason As String` |
| `LastLayoutRefreshFailureScope` | Property | `Public ReadOnly Property LastLayoutRefreshFailureScope As String` |
| `LastLayoutRefreshFailureStage` | Property | `Public ReadOnly Property LastLayoutRefreshFailureStage As String` |
| `LastLayoutRefreshFailureUtc` | Property | `Public ReadOnly Property LastLayoutRefreshFailureUtc As Date` |

**Minimal usage shape.**

```vb
window.Controls.PerformUpdate(Sub()
    window.Controls.AddLabel("Customer")
    window.Controls.AddButton("Save")
End Sub)
```

### `MASApplicationWindowDialogs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowDialogs.vb:21` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `ConfirmAction` | Function | `Public Function ConfirmAction(title As String, message As String, Optional detail As String = "", Optional ownerKey As String = "MAS.Application.Dialogs", Optional onAccepted As Action = Nothing, Optional onCancelled As Action = Nothing, Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing) As MASApplicationSurfaceHandle` |
| `Confirm` | Function | `Public Function Confirm(title As String, message As String, Optional detail As String = "", Optional ownerKey As String = "MAS.Application.Dialogs", Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing) As MASApplicationSurfaceHandle` |
| `DeleteConfirmAction` | Function | `Public Function DeleteConfirmAction(title As String, message As String, Optional detail As String = "", Optional confirmText As String = "Delete", Optional cancelText As String = "Cancel", Optional ownerKey As String = "MAS.Application.Dialogs", Optional onAccepted As Action = Nothing, Optional onCancelled As Action = Nothing, Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing) As MASApplicationSurfaceHandle` |
| `Error` | Function | `Public Function Error(message As String, Optional title As String = "Error", Optional detail As String = "", Optional ownerKey As String = "MAS.Application.Dialogs", Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing) As MASApplicationSurfaceHandle` |
| `Information` | Function | `Public Function Information(message As String, Optional title As String = "Information", Optional detail As String = "", Optional ownerKey As String = "MAS.Application.Dialogs", Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing) As MASApplicationSurfaceHandle` |
| `Question` | Function | `Public Function Question(title As String, message As String, Optional detail As String = "", Optional ownerKey As String = "MAS.Application.Dialogs", Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing) As MASApplicationSurfaceHandle` |
| `Success` | Function | `Public Function Success(message As String, Optional title As String = "Success", Optional detail As String = "", Optional ownerKey As String = "MAS.Application.Dialogs", Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing) As MASApplicationSurfaceHandle` |
| `Warning` | Function | `Public Function Warning(message As String, Optional title As String = "Warning", Optional detail As String = "", Optional ownerKey As String = "MAS.Application.Dialogs", Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing) As MASApplicationSurfaceHandle` |

**Minimal usage shape.**

```vb
Dim options As New MASApplicationDialogShieldOptions()
options.Mode = MASApplicationDialogShieldMode.Modal
' Pass options into the documented dialog route that owns the operation.
```

### `MASApplicationWindowFileExplorer`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowFileExplorer.vb:15` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CloseByOwner` | Sub | `Public Sub CloseByOwner(ownerKey As String, Optional reason As MASApplicationCloseReason = MASApplicationCloseReason.Programmatic)` |
| `Close` | Sub | `Public Sub Close(handle As MASApplicationSurfaceHandle, Optional reason As MASApplicationCloseReason = MASApplicationCloseReason.Programmatic)` |
| `IsOpen` | Function | `Public Function IsOpen(handle As MASApplicationSurfaceHandle) As Boolean` |
| `ShowComputer` | Function | `Public Function ShowComputer(ownerKey As String, options As MASApplicationFileExplorerOptions, Optional onOpened As Action(Of MASApplicationOpenedEventArgs) = Nothing, Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing, Optional onAccepted As Action(Of MASApplicationFileExplorerResult) = Nothing, Optional onCancelled As Action = Nothing) As MASApplicationSurfaceHandle` |
| `ShowComputer` | Function | `Public Function ShowComputer(Optional ownerKey As String = "MAS.FileExplorer.Service", Optional onClosed As Action = Nothing, Optional onAccepted As Action(Of MASApplicationFileExplorerResult) = Nothing, Optional onCancelled As Action = Nothing) As MASApplicationSurfaceHandle` |
| `ShowExplorer` | Function | `Public Function ShowExplorer(explorer As MASFileExplorerView, Optional ownerKey As String = "MAS.FileExplorer.Service", Optional onClosed As Action = Nothing) As MASApplicationSurfaceHandle` |
| `Show` | Function | `Public Function Show(options As MASApplicationFileExplorerOptions, Optional ownerKey As String = "MAS.FileExplorer.Service", Optional onClosed As Action = Nothing, Optional onAccepted As Action(Of MASApplicationFileExplorerResult) = Nothing, Optional onCancelled As Action = Nothing) As MASApplicationSurfaceHandle` |
| `Show` | Function | `Public Function Show(ownerKey As String, options As MASApplicationFileExplorerOptions, Optional onOpened As Action(Of MASApplicationOpenedEventArgs) = Nothing, Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing, Optional onAccepted As Action(Of MASApplicationFileExplorerResult) = Nothing, Optional onCancelled As Action = Nothing) As MASApplicationSurfaceHandle` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationWindowFilePicker`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowFilePicker.vb:16` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CloseByOwner` | Sub | `Public Sub CloseByOwner(ownerKey As String, Optional reason As MASApplicationCloseReason = MASApplicationCloseReason.Programmatic)` |
| `Close` | Sub | `Public Sub Close(handle As MASApplicationSurfaceHandle, Optional reason As MASApplicationCloseReason = MASApplicationCloseReason.Programmatic)` |
| `IsOpen` | Function | `Public Function IsOpen(handle As MASApplicationSurfaceHandle) As Boolean` |
| `ShowOpenFile` | Function | `Public Function ShowOpenFile(Optional ownerKey As String = "MAS.FilePicker.Service", Optional title As String = "Open File", Optional initialPath As String = "", Optional filter As String = "*.*", Optional showHidden As Boolean = False, Optional allowMultiSelect As Boolean = False, Optional footerText As String = "", Optional primaryButtonText As String = "", Optional onOpened As Action(Of MASApplicationOpenedEventArgs) = Nothing, Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing, Optional onAccepted As Action(Of MASFilePickerResult) = Nothing, Optional onCancelled As Action = Nothing) As MASApplicationSurfaceHandle` |
| `ShowPickDrive` | Function | `Public Function ShowPickDrive(Optional ownerKey As String = "MAS.FilePicker.Service", Optional title As String = "Select Drive", Optional initialPath As String = "", Optional showHidden As Boolean = False, Optional allowMultiSelect As Boolean = False, Optional primaryButtonText As String = "", Optional footerText As String = "", Optional onOpened As Action(Of MASApplicationOpenedEventArgs) = Nothing, Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing, Optional onAccepted As Action(Of MASFilePickerResult) = Nothing, Optional onCancelled As Action = Nothing) As MASApplicationSurfaceHandle` |
| `ShowPickFolderOrDrive` | Function | `Public Function ShowPickFolderOrDrive(Optional ownerKey As String = "MAS.FilePicker.Service", Optional title As String = "Select Targets", Optional initialPath As String = "", Optional showHidden As Boolean = False, Optional allowMultiSelect As Boolean = True, Optional primaryButtonText As String = "", Optional acceptCurrentPathWhenNoSelection As Boolean = False, Optional footerText As String = "", Optional onOpened As Action(Of MASApplicationOpenedEventArgs) = Nothing, Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing, Optional onAccepted As Action(Of MASFilePickerResult) = Nothing, Optional onCancelled As Action = Nothing) As MASApplicationSurfaceHandle` |
| `ShowPickFolders` | Function | `Public Function ShowPickFolders(Optional ownerKey As String = "MAS.FilePicker.Service", Optional title As String = "Select Folders", Optional initialPath As String = "", Optional showHidden As Boolean = False, Optional primaryButtonText As String = "", Optional acceptCurrentPathWhenNoSelection As Boolean = False, Optional footerText As String = "", Optional onOpened As Action(Of MASApplicationOpenedEventArgs) = Nothing, Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing, Optional onAccepted As Action(Of MASFilePickerResult) = Nothing, Optional onCancelled As Action = Nothing) As MASApplicationSurfaceHandle` |
| `ShowPickFolder` | Function | `Public Function ShowPickFolder(Optional ownerKey As String = "MAS.FilePicker.Service", Optional title As String = "Select Folder", Optional initialPath As String = "", Optional showHidden As Boolean = False, Optional primaryButtonText As String = "", Optional acceptCurrentPathWhenNoSelection As Boolean = False, Optional footerText As String = "", Optional onOpened As Action(Of MASApplicationOpenedEventArgs) = Nothing, Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing, Optional onAccepted As Action(Of MASFilePickerResult) = Nothing, Optional onCancelled As Action = Nothing) As MASApplicationSurfaceHandle` |
| `ShowPickTargets` | Function | `Public Function ShowPickTargets(ownerKey As String, targetKinds As MASFileSystemSelectionKinds, Optional title As String = "Select Targets", Optional initialPath As String = "", Optional showHidden As Boolean = False, Optional allowMultiSelect As Boolean = False, Optional primaryButtonText As String = "", Optional acceptCurrentPathWhenNoSelection As Boolean = False, Optional footerText As String = "", Optional onOpened As Action(Of MASApplicationOpenedEventArgs) = Nothing, Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing, Optional onAccepted As Action(Of MASFilePickerResult) = Nothing, Optional onCancelled As Action = Nothing) As MASApplicationSurfaceHandle` |
| `ShowSaveFile` | Function | `Public Function ShowSaveFile(Optional ownerKey As String = "MAS.FilePicker.Service", Optional title As String = "Save File", Optional initialPath As String = "", Optional filter As String = "*.*", Optional fileName As String = "", Optional confirmOverwrite As Boolean = True, Optional showHidden As Boolean = False, Optional primaryButtonText As String = "", Optional footerText As String = "", Optional onOpened As Action(Of MASApplicationOpenedEventArgs) = Nothing, Optional onClosed As Action(Of MASApplicationClosedEventArgs) = Nothing, Optional onAccepted As Action(Of MASFilePickerResult) = Nothing, Optional onCancelled As Action = Nothing) As MASApplicationSurfaceHandle` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationWindowGeometry`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowGeometry.vb:16` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `AnchorLogicalToPx` | Function | `Public Function AnchorLogicalToPx(anchorRectLogical As SKRect) As SKRect` |
| `ControlAnchorPx` | Function | `Public Function ControlAnchorPx(control As MASControlBase) As SKRect` |
| `ControlContentBoundsLogical` | Function | `Public Function ControlContentBoundsLogical(control As MASControlBase) As SKRect` |
| `ControlContentBoundsPx` | Function | `Public Function ControlContentBoundsPx(control As MASControlBase) As SKRect` |
| `ControlFloatAnchorBoundsLogical` | Function | `Public Function ControlFloatAnchorBoundsLogical(control As MASControlBase) As SKRect` |
| `ControlFloatAnchorBoundsPx` | Function | `Public Function ControlFloatAnchorBoundsPx(control As MASControlBase) As SKRect` |
| `ControlFocusBoundsLogical` | Function | `Public Function ControlFocusBoundsLogical(control As MASControlBase) As SKRect` |
| `ControlFocusBoundsPx` | Function | `Public Function ControlFocusBoundsPx(control As MASControlBase) As SKRect` |
| `ControlHitBoundsLogical` | Function | `Public Function ControlHitBoundsLogical(control As MASControlBase) As SKRect` |
| `ControlHitBoundsPx` | Function | `Public Function ControlHitBoundsPx(control As MASControlBase) As SKRect` |
| `ControlOuterBoundsLogical` | Function | `Public Function ControlOuterBoundsLogical(control As MASControlBase) As SKRect` |
| `ControlOuterBoundsPx` | Function | `Public Function ControlOuterBoundsPx(control As MASControlBase) As SKRect` |
| `ControlVisualBoundsLogical` | Function | `Public Function ControlVisualBoundsLogical(control As MASControlBase) As SKRect` |
| `ControlVisualBoundsPx` | Function | `Public Function ControlVisualBoundsPx(control As MASControlBase) As SKRect` |
| `IsUsable` | Function | `Public Function IsUsable(bounds As SKRect, Optional minWidth As Single = 1.0, Optional minHeight As Single = 1.0) As Boolean` |
| `LogicalToPx` | Function | `Public Function LogicalToPx(boundsLogical As SKRect) As SKRect` |
| `PxToLogical` | Function | `Public Function PxToLogical(boundsPx As SKRect) As SKRect` |
| `SurfaceViewportPx` | Function | `Public Function SurfaceViewportPx(Optional topInsetLogical As Single = 0.0) As SKRect` |
| `TryGetSurfaceViewportPx` | Function | `Public Function TryGetSurfaceViewportPx(ByRef viewportPx As SKRect, Optional topInsetLogical As Single = 0.0) As Boolean` |
| `Dpi` | Property | `Public ReadOnly Property Dpi As Single` |
| `SurfaceSizePx` | Property | `Public ReadOnly Property SurfaceSizePx As SKSizeI` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationWindowInput`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowInput.vb:14` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `HostFocusLost` | Event | `Public Event HostFocusLost As MASApplicationWindowInput.HostFocusLostEventHandler` |
| `PointerDown` | Event | `Public Event PointerDown As MASApplicationWindowInput.PointerDownEventHandler` |
| `PointerLeft` | Event | `Public Event PointerLeft As MASApplicationWindowInput.PointerLeftEventHandler` |
| `PointerMoved` | Event | `Public Event PointerMoved As MASApplicationWindowInput.PointerMovedEventHandler` |
| `PointerUp` | Event | `Public Event PointerUp As MASApplicationWindowInput.PointerUpEventHandler` |
| `PointerWheel` | Event | `Public Event PointerWheel As MASApplicationWindowInput.PointerWheelEventHandler` |
| `AttachNativeInput` | Sub | `Public Sub AttachNativeInput()` |
| `DetachNativeInput` | Sub | `Public Sub DetachNativeInput()` |
| `ReleasePointerCapture` | Sub | `Public Sub ReleasePointerCapture()` |
| `SyncPointerFromCursor` | Sub | `Public Sub SyncPointerFromCursor()` |
| `HasTopBar` | Property | `Public ReadOnly Property HasTopBar As Boolean` |
| `IsNativeInputAttached` | Property | `Public ReadOnly Property IsNativeInputAttached As Boolean` |
| `UseMouseCaptureForTopBar` | Property | `Public Property UseMouseCaptureForTopBar As Boolean` |
| `UseSmartTopBarMove` | Property | `Public Property UseSmartTopBarMove As Boolean` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationWindowPresentation`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Presentation/MASApplicationWindowPresentation.vb:17` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `ApplyAndSave` | Function | `Public Function ApplyAndSave(profileKind As MASWindowPresentationProfileKind, persistenceKey As String) As MASApplicationWindowPresentation` |
| `Apply` | Function | `Public Function Apply(profileKind As MASWindowPresentationProfileKind, startupPlacement As MASWindowStartupPlacement) As MASApplicationWindowPresentation` |
| `Apply` | Function | `Public Function Apply(profileKind As MASWindowPresentationProfileKind) As MASApplicationWindowPresentation` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `GetAllProfileKinds` | Function | `Public Function GetAllProfileKinds() As IReadOnlyList(Of MASWindowPresentationProfileKind)` |
| `SaveCurrent` | Function | `Public Function SaveCurrent(persistenceKey As String) As Boolean` |
| `SaveCurrent` | Function | `Public Function SaveCurrent() As Boolean` |
| `UseCompact` | Function | `Public Function UseCompact() As MASApplicationWindowPresentation` |
| `UseImmersive` | Function | `Public Function UseImmersive() As MASApplicationWindowPresentation` |
| `UseProductive` | Function | `Public Function UseProductive() As MASApplicationWindowPresentation` |
| `UseSpacious` | Function | `Public Function UseSpacious() As MASApplicationWindowPresentation` |
| `UseStandard` | Function | `Public Function UseStandard() As MASApplicationWindowPresentation` |
| `UseUserPreferences` | Function | `Public Function UseUserPreferences(persistenceKey As String, Optional profileKind As MASWindowPresentationProfileKind = MASWindowPresentationProfileKind.Standard) As MASApplicationWindowPresentation` |
| `UseUtility` | Function | `Public Function UseUtility() As MASApplicationWindowPresentation` |
| `CurrentProfileKind` | Property | `Public ReadOnly Property CurrentProfileKind As MASWindowPresentationProfileKind` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationWindowProgress`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowProgress.vb:17` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `ShowOperation` | Function | `Public Function ShowOperation(titleText As String, statusText As String, Optional percent As Double = 0.0, Optional ownerKey As String = "MAS.Application.Progress") As MASApplicationProgressHandle` |

**Minimal usage shape.**

```vb
Using progress = window.Services.Progress.ShowOperation("Working", "Starting", 0)
    progress.Update("Half done", 50)
End Using
```

### `MASApplicationWindowServices`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowServices.vb:16` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Dispose` | Sub | `Public Sub Dispose()` |
| `ContextMenus` | Property | `Public ReadOnly Property ContextMenus As MASApplicationWindowContextMenus` |
| `Dialogs` | Property | `Public ReadOnly Property Dialogs As MASApplicationWindowDialogs` |
| `FileExplorer` | Property | `Public ReadOnly Property FileExplorer As MASApplicationWindowFileExplorer` |
| `FilePicker` | Property | `Public ReadOnly Property FilePicker As MASApplicationWindowFilePicker` |
| `IsDisposed` | Property | `Public ReadOnly Property IsDisposed As Boolean` |
| `Progress` | Property | `Public ReadOnly Property Progress As MASApplicationWindowProgress` |
| `Toasts` | Property | `Public ReadOnly Property Toasts As MASApplicationWindowToasts` |
| `Tooltips` | Property | `Public ReadOnly Property Tooltips As MASApplicationWindowTooltips` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationWindowShell`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowShell.vb:20` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `AttachStandardTopBar` | Function | `Public Function AttachStandardTopBar(Optional title As String = Nothing, Optional configureMenu As Action(Of MASDropDownMenuBuilder) = Nothing, Optional commandHandler As Action(Of String) = Nothing, Optional showLogo As Boolean = False, Optional attachWindow As Boolean = True) As MASTopBarComponent` |
| `AttachTopBar` | Sub | `Public Sub AttachTopBar(topBar As MASTopBarComponent, getTopBarLogicalRect As Func(Of SKRect), Optional attachWindow As Boolean = True)` |
| `BindMenuButton` | Function | `Public Function BindMenuButton(button As MASMenuButton) As MASMenuButton` |
| `CreateMenuButton` | Function | `Public Function CreateMenuButton(Optional text As String = "Menu", Optional buildMenu As Action(Of MASDropDownMenuBuilder) = Nothing, Optional commandHandler As Action(Of String) = Nothing) As MASMenuButton` |
| `CreateStandardMenuBarLogicalRect` | Function | `Public Function CreateStandardMenuBarLogicalRect() As SKRect` |
| `CreateStandardTopBarLogicalRect` | Function | `Public Function CreateStandardTopBarLogicalRect() As SKRect` |
| `DetachTopBar` | Sub | `Public Sub DetachTopBar()` |
| `ShowDropDownMenuForControl` | Sub | `Public Sub ShowDropDownMenuForControl(control As MASControlBase, configure As Action(Of MASDropDownMenuBuilder), Optional commandHandler As Action(Of String) = Nothing, Optional viewportProvider As Func(Of SKRect) = Nothing)` |
| `HasStandardMenuBar` | Property | `Public ReadOnly Property HasStandardMenuBar As Boolean` |
| `MainMenuBar` | Property | `Public ReadOnly Property MainMenuBar As MASMenuBar` |
| `StandardContentTopLogical` | Property | `Public ReadOnly Property StandardContentTopLogical As Single` |
| `StandardMenuBarHeightLogical` | Property | `Public ReadOnly Property StandardMenuBarHeightLogical As Single` |
| `StandardTopBarContentTopLogical` | Property | `Public ReadOnly Property StandardTopBarContentTopLogical As Single` |
| `StandardTopBarHeightLogical` | Property | `Public ReadOnly Property StandardTopBarHeightLogical As Single` |
| `TopBar` | Property | `Public ReadOnly Property TopBar As MASTopBarComponent` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationWindowSizing`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowSizing.vb:15` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CurrentChanged` | Event | `Public Event CurrentChanged As EventHandler(Of MASSizeProfileChangedEventArgs)` |
| `ApplyAndSave` | Sub | `Public Sub ApplyAndSave(kind As MASSizeProfileKind)` |
| `ApplyAndSave` | Sub | `Public Sub ApplyAndSave(profile As MASSizeProfile)` |
| `GetAll` | Function | `Public Function GetAll() As IReadOnlyList(Of MASSizeProfile)` |
| `Refresh` | Sub | `Public Sub Refresh()` |
| `Reset` | Sub | `Public Sub Reset()` |
| `SaveCurrent` | Function | `Public Function SaveCurrent() As Boolean` |
| `TryApplyAndSave` | Function | `Public Function TryApplyAndSave(kind As MASSizeProfileKind) As Boolean` |
| `TryApplyAndSave` | Function | `Public Function TryApplyAndSave(profile As MASSizeProfile) As Boolean` |
| `TryUse` | Function | `Public Function TryUse(kind As MASSizeProfileKind) As Boolean` |
| `TryUse` | Function | `Public Function TryUse(profile As MASSizeProfile) As Boolean` |
| `Use` | Sub | `Public Sub Use(kind As MASSizeProfileKind)` |
| `Use` | Sub | `Public Sub Use(profile As MASSizeProfile)` |
| `CurrentKind` | Property | `Public ReadOnly Property CurrentKind As MASSizeProfileKind` |
| `Current` | Property | `Public ReadOnly Property Current As MASSizeProfile` |
| `IsGlobalApplicationSizeProfile` | Property | `Public ReadOnly Property IsGlobalApplicationSizeProfile As Boolean` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `MASApplicationWindowTheme`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowTheme.vb:16` |
| Related recipes | [theme-surface](../../recipes/theme-surface.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `GetAll` | Function | `Public Function GetAll() As IReadOnlyList(Of IMASAppTheme)` |
| `GetById` | Function | `Public Function GetById(id As String) As IMASAppTheme` |
| `Refresh` | Sub | `Public Sub Refresh()` |
| `TryUseGlobally` | Function | `Public Function TryUseGlobally(id As String) As Boolean` |
| `TryUse` | Function | `Public Function TryUse(id As String) As Boolean` |
| `UseGlobally` | Sub | `Public Sub UseGlobally(id As String)` |
| `Use` | Sub | `Public Sub Use(id As String)` |
| `CurrentDisplayName` | Property | `Public ReadOnly Property CurrentDisplayName As String` |
| `CurrentId` | Property | `Public ReadOnly Property CurrentId As String` |
| `Current` | Property | `Public ReadOnly Property Current As IMASAppTheme` |
| `IsGlobalApplicationTheme` | Property | `Public ReadOnly Property IsGlobalApplicationTheme As Boolean` |
| `Scope` | Property | `Public ReadOnly Property Scope As MASApplicationThemeScope` |

**Minimal usage shape.**

```vb
Dim applied = app.Theme.TryUse("premium-office-mas-signature")
If Not applied Then
    app.Theme.Use("premium-office-mas-signature")
End If
```

### `MASApplicationWindowToasts`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowToasts.vb:14` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `ClearAll` | Sub | `Public Sub ClearAll()` |
| `Danger` | Function | `Public Function Danger(message As String, Optional title As String = "") As Integer` |
| `Dismiss` | Function | `Public Function Dismiss(toastId As Integer) As Boolean` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `Error` | Function | `Public Function Error(message As String, Optional title As String = "") As Integer` |
| `Failure` | Function | `Public Function Failure(message As String, Optional title As String = "") As Integer` |
| `Info` | Function | `Public Function Info(message As String, Optional title As String = "") As Integer` |
| `Show` | Function | `Public Function Show(options As MASToastOptions) As Integer` |
| `Success` | Function | `Public Function Success(message As String, Optional title As String = "") As Integer` |
| `Warning` | Function | `Public Function Warning(message As String, Optional title As String = "") As Integer` |
| `HasAnyToast` | Property | `Public ReadOnly Property HasAnyToast As Boolean` |

**Minimal usage shape.**

```vb
Dim options As New MASToastOptions("Saved")
window.Services.Toasts.Show(options)
```

### `MASApplicationWindowTooltips`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationWindowTooltips.vb:16` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Exposes one focused capability group of `MASApplicationWindow` without exposing internal host objects.

**When to use it.** Use it through the `window.<Capability>` property rather than through internal rendering/layout/root-host types.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Clear` | Sub | `Public Sub Clear()` |
| `Register` | Function | `Public Function Register(control As MASControlBase) As MASApplicationTooltipTarget` |
| `Remove` | Sub | `Public Sub Remove(target As MASApplicationTooltipTarget)` |
| `WithSurfaceMaterial` | Function | `Public Function WithSurfaceMaterial(materialKey As String) As MASApplicationWindowTooltips` |
| `SurfaceMaterial` | Property | `Public Property SurfaceMaterial As String` |

**Minimal usage shape.**

```vb
' Use through MASApplication / MASApplicationWindow documented owner APIs.
' See related recipes for a build-verified consumer path.
```

### `NexamasUIChangedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationTheme.vb:13` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Carries typed data for an Application facade operation, result, option set, or notification.

**When to use it.** Use it with the owning Application/window service instead of building an unrelated custom DTO.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `NewTheme` | Property | `Public ReadOnly Property NewTheme As IMASAppTheme` |
| `OldTheme` | Property | `Public ReadOnly Property OldTheme As IMASAppTheme` |

**Minimal usage shape.**

```vb
' This type is normally received from, or passed into, the owning Application facade.
' Prefer the documented window/app service instead of standalone construction.
```

## Enums

### `MASApplicationActionGroupAlignment`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationControlsActionGroupLayout.vb:15` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application ActionGroupAlignment` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Center` | Enum value | `Center = 1` |
| `End` | Enum value | `End = 2` |
| `Start` | Enum value | `Start = 0` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationActionGroupAlignment
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationCloseReason`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationCloseReason.vb:10` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application CloseReason` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Accepted` | Enum value | `Accepted = 1` |
| `Cancelled` | Enum value | `Cancelled = 2` |
| `CloseAll` | Enum value | `CloseAll = 7` |
| `EscapeKey` | Enum value | `EscapeKey = 3` |
| `Failed` | Enum value | `Failed = 9` |
| `OutsidePointer` | Enum value | `OutsidePointer = 4` |
| `OwnerDisposed` | Enum value | `OwnerDisposed = 6` |
| `Programmatic` | Enum value | `Programmatic = 0` |
| `Replaced` | Enum value | `Replaced = 5` |
| `SystemShutdown` | Enum value | `SystemShutdown = 8` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationCloseReason
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationDialogShieldMode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationDialogShieldMode.vb:9` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application DialogShieldMode` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `DecisionRequired` | Enum value | `DecisionRequired = 2` |
| `None` | Enum value | `None = 0` |
| `Soft` | Enum value | `Soft = 1` |
| `SystemLocked` | Enum value | `SystemLocked = 3` |

**Minimal usage shape.**

```vb
Dim options As New MASApplicationDialogShieldOptions()
options.Mode = MASApplicationDialogShieldMode.Modal
' Pass options into the documented dialog route that owns the operation.
```

### `MASApplicationDialogShieldReason`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationDialogShieldReason.vb:9` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application DialogShieldReason` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CriticalConfirmation` | Enum value | `CriticalConfirmation = 2` |
| `InProgressOperation` | Enum value | `InProgressOperation = 3` |
| `None` | Enum value | `None = 0` |
| `OwnedModalFlow` | Enum value | `OwnedModalFlow = 5` |
| `PreventDataLoss` | Enum value | `PreventDataLoss = 4` |
| `RequiresUserDecision` | Enum value | `RequiresUserDecision = 1` |

**Minimal usage shape.**

```vb
Dim options As New MASApplicationDialogShieldOptions()
options.Mode = MASApplicationDialogShieldMode.Modal
' Pass options into the documented dialog route that owns the operation.
```

### `MASApplicationDialogShowPolicy`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationDialogShowPolicy.vb:10` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application DialogShowPolicy` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CloseSameOwnerThenShow` | Enum value | `CloseSameOwnerThenShow = 3` |
| `FailIfOccupied` | Enum value | `FailIfOccupied = 0` |
| `QueueAfterCurrentClosed` | Enum value | `QueueAfterCurrentClosed = 2` |
| `ReplaceCurrent` | Enum value | `ReplaceCurrent = 1` |
| `ReuseIfSameOwner` | Enum value | `ReuseIfSameOwner = 4` |

**Minimal usage shape.**

```vb
Dim options As New MASApplicationDialogShieldOptions()
options.Mode = MASApplicationDialogShieldMode.Modal
' Pass options into the documented dialog route that owns the operation.
```

### `MASApplicationFilterBarAlignment`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationControlsFilterFormLayout.vb:27` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application FilterBarAlignment` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Center` | Enum value | `Center = 1` |
| `End` | Enum value | `End = 2` |
| `Start` | Enum value | `Start = 0` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationFilterBarAlignment
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationFilterBarDirection`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationControlsFilterFormLayout.vb:17` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application FilterBarDirection` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Horizontal` | Enum value | `Horizontal = 1` |
| `Vertical` | Enum value | `Vertical = 2` |
| `Wrap` | Enum value | `Wrap = 0` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationFilterBarDirection
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationGalleryAlignment`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationControlsGalleryLayout.vb:28` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application GalleryAlignment` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Center` | Enum value | `Center = 1` |
| `End` | Enum value | `End = 2` |
| `Start` | Enum value | `Start = 0` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationGalleryAlignment
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationGalleryTileSize`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationControlsGalleryLayout.vb:16` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application GalleryTileSize` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Compact` | Enum value | `Compact = 0` |
| `Default` | Enum value | `Default = 1` |
| `Hero` | Enum value | `Hero = 4` |
| `Large` | Enum value | `Large = 2` |
| `Preview` | Enum value | `Preview = 3` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationGalleryTileSize
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationPageLayoutKind`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationLayoutPolicy.vb:15` |
| Related recipes | [layout](../../recipes/layout.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application PageLayoutKind` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Dashboard` | Enum value | `Dashboard = 1` |
| `DenseData` | Enum value | `DenseData = 2` |
| `Editor` | Enum value | `Editor = 3` |
| `Standard` | Enum value | `Standard = 0` |
| `Surface` | Enum value | `Surface = 4` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationPageLayoutKind
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationResultStatus`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationResultStatus.vb:9` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application ResultStatus` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Accepted` | Enum value | `Accepted = 1` |
| `Cancelled` | Enum value | `Cancelled = 2` |
| `Dismissed` | Enum value | `Dismissed = 3` |
| `Failed` | Enum value | `Failed = 4` |
| `None` | Enum value | `None = 0` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationResultStatus
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationSurfaceBarSize`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutEnums.vb:32` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application SurfaceBarSize` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Compact` | Enum value | `Compact = 0` |
| `Default` | Enum value | `Default = 1` |
| `Large` | Enum value | `Large = 2` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationSurfaceBarSize
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationSurfaceCommandBarPlacement`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutEnums.vb:44` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application SurfaceCommandBarPlacement` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Auto` | Enum value | `Auto = 0` |
| `FullApplicationSurfaceTop` | Enum value | `FullApplicationSurfaceTop = 1` |
| `MainAreaTop` | Enum value | `MainAreaTop = 2` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationSurfaceCommandBarPlacement
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationSurfaceFooterPlacement`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutEnums.vb:56` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application SurfaceFooterPlacement` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `FullApplicationSurfaceBottom` | Enum value | `FullApplicationSurfaceBottom = 0` |
| `MainAreaBottom` | Enum value | `MainAreaBottom = 1` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationSurfaceFooterPlacement
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationSurfaceRhythm`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutEnums.vb:68` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application SurfaceRhythm` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Comfortable` | Enum value | `Comfortable = 1` |
| `Compact` | Enum value | `Compact = 0` |
| `Spacious` | Enum value | `Spacious = 2` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationSurfaceRhythm
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationSurfaceShowStatus`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSurfaceShowStatus.vb:9` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application SurfaceShowStatus` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Opened` | Enum value | `Opened = 1` |
| `Queued` | Enum value | `Queued = 2` |
| `Rejected` | Enum value | `Rejected = 0` |
| `Reused` | Enum value | `Reused = 3` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationSurfaceShowStatus
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationSurfaceSideSize`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutEnums.vb:21` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application SurfaceSideSize` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Compact` | Enum value | `Compact = 0` |
| `Default` | Enum value | `Default = 1` |
| `Wide` | Enum value | `Wide = 2` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationSurfaceSideSize
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationSurfaceState`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationSurfaceState.vb:9` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application SurfaceState` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Closed` | Enum value | `Closed = 4` |
| `Closing` | Enum value | `Closing = 3` |
| `Disposed` | Enum value | `Disposed = 5` |
| `Opening` | Enum value | `Opening = 1` |
| `Open` | Enum value | `Open = 2` |
| `Requested` | Enum value | `Requested = 0` |

**Minimal usage shape.**

```vb
Dim value As MASApplicationSurfaceState
' Use this value with the owning Application/window option or result API.
```

### `MASApplicationThemeScope`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASApplicationThemeScope.vb:9` |
| Related recipes | [theme-surface](../../recipes/theme-surface.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `application ThemeScope` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `GlobalApplication` | Enum value | `GlobalApplication = 0` |

**Minimal usage shape.**

```vb
Dim applied = app.Theme.TryUse("premium-office-mas-signature")
If Not applied Then
    app.Theme.Use("premium-office-mas-signature")
End If
```

### `MASWindowPresentationProfileKind`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Presentation/MASWindowPresentationProfileKind.vb:10` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `window PresentationProfileKind` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Compact` | Enum value | `Compact = 0` |
| `Immersive` | Enum value | `Immersive = 4` |
| `Productive` | Enum value | `Productive = 3` |
| `Spacious` | Enum value | `Spacious = 2` |
| `Standard` | Enum value | `Standard = 1` |
| `Utility` | Enum value | `Utility = 5` |

**Minimal usage shape.**

```vb
Dim value As MASWindowPresentationProfileKind
' Use this value with the owning Application/window option or result API.
```

### `MASWindowShadowMode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Facade/MASWindowShadowMode.vb:10` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `window ShadowMode` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Classic` | Enum value | `Classic = 1` |
| `PopupSafe` | Enum value | `PopupSafe = 2` |
| `SystemDwm` | Enum value | `SystemDwm = 0` |

**Minimal usage shape.**

```vb
Dim value As MASWindowShadowMode
' Use this value with the owning Application/window option or result API.
```

### `MASWindowStartupPlacement`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Application/Presentation/MASWindowStartupPlacement.vb:10` |
| Related recipes | [application](../../recipes/application.md) |

**What it does.** Defines the public vocabulary used by the Application facade for `window StartupPlacement` choices.

**When to use it.** Use it when setting options, interpreting result state, or reacting to Application/window facade return values.

**Public members verified in the compiled assembly.**

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Auto` | Enum value | `Auto = 0` |
| `CenterOnScreen` | Enum value | `CenterOnScreen = 1` |
| `Maximized` | Enum value | `Maximized = 4` |
| `PreserveCurrent` | Enum value | `PreserveCurrent = 3` |
| `RestoreUserChoice` | Enum value | `RestoreUserChoice = 2` |

**Minimal usage shape.**

```vb
Dim value As MASWindowStartupPlacement
' Use this value with the owning Application/window option or result API.
```


## Compiler-generated nested event delegates

Visual Basic emits these public nested delegate types for parameterized events declared by `MASApplicationWindowInput`. Subscribe to the events normally; application code does not need to construct these delegate types explicitly. They are listed here because they are part of the compiled CLR-visible surface.

### `MASApplicationWindowInput.HostFocusLostEventHandler`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| CLR identity | `Nexamas.UI.Application.MASApplicationWindowInput.HostFocusLostEventHandler` |
| Kind | `Delegate` |
| Category | `UnclassifiedGenerated` |

**Delegate signature verified in the compiled assembly.**

```vb
Public Delegate Sub HostFocusLostEventHandler()
```

### `MASApplicationWindowInput.PointerDownEventHandler`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| CLR identity | `Nexamas.UI.Application.MASApplicationWindowInput.PointerDownEventHandler` |
| Kind | `Delegate` |
| Category | `UnclassifiedGenerated` |

**Delegate signature verified in the compiled assembly.**

```vb
Public Delegate Sub PointerDownEventHandler(clientX As Single, clientY As Single, button As MouseButtons)
```

### `MASApplicationWindowInput.PointerLeftEventHandler`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| CLR identity | `Nexamas.UI.Application.MASApplicationWindowInput.PointerLeftEventHandler` |
| Kind | `Delegate` |
| Category | `UnclassifiedGenerated` |

**Delegate signature verified in the compiled assembly.**

```vb
Public Delegate Sub PointerLeftEventHandler()
```

### `MASApplicationWindowInput.PointerMovedEventHandler`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| CLR identity | `Nexamas.UI.Application.MASApplicationWindowInput.PointerMovedEventHandler` |
| Kind | `Delegate` |
| Category | `UnclassifiedGenerated` |

**Delegate signature verified in the compiled assembly.**

```vb
Public Delegate Sub PointerMovedEventHandler(clientX As Single, clientY As Single)
```

### `MASApplicationWindowInput.PointerUpEventHandler`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| CLR identity | `Nexamas.UI.Application.MASApplicationWindowInput.PointerUpEventHandler` |
| Kind | `Delegate` |
| Category | `UnclassifiedGenerated` |

**Delegate signature verified in the compiled assembly.**

```vb
Public Delegate Sub PointerUpEventHandler(clientX As Single, clientY As Single, button As MouseButtons)
```

### `MASApplicationWindowInput.PointerWheelEventHandler`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Application` |
| CLR identity | `Nexamas.UI.Application.MASApplicationWindowInput.PointerWheelEventHandler` |
| Kind | `Delegate` |
| Category | `UnclassifiedGenerated` |

**Delegate signature verified in the compiled assembly.**

```vb
Public Delegate Sub PointerWheelEventHandler(clientX As Single, clientY As Single, delta As Integer)
```